[INFRA] Publish schema to Javascript Registry (https://jsr.io/@bids/schema) on changes and releases

[effigies]

This PR adds a GitHub action that will push dev versions and release versions to https://jsr.io/@bids/schema.

I have been testing this for use in the BIDS validator. Currently we are able to load the schema from the registry via:

import { default as schema } from 'jsr:@bids/[email protected]/schema' with { type: 'json' }

We are also able to load the type of the schema with:

import type { Metaschema } from 'jsr:@bids/[email protected]/metaschema'
import type { Context }  from 'jsr:@bids/[email protected]/context'

The version scheme will be {schema.schema_version} if the version is a full release (X.Y.Z), and {schema.schema_version}.{serial}+{hash} for development versions.

The serial number is purely to ensure that development versions of the schema can be ordered, and is derived by parsing the previous version. The purpose of the hash is to help make clear when the content of the schema changes. It currently uses sha256sum schema.json | head -c 7, but I think a more useful hash would probably be the latest commit to touch the schema: git log -n 1 --pretty=%h src/schema/.

---

This PR incidentally changes the name of the Metaschema type to just Schema, so schema will have type Schema.

[effigies]

Before merging, I would patch in:

diff --git a/.github/workflows/publish_schema.yml b/.github/workflows/publish_schema.yml
index d50ba7f3..b2895664 100644
--- a/.github/workflows/publish_schema.yml
+++ b/.github/workflows/publish_schema.yml
@@ -4,7 +4,6 @@ on:
   push:
     branches:
       - "master"
-      - "jsr/*"
     tags:
       - "schema-*"
 
@@ -22,6 +21,10 @@ env:
   GIT_COMMITTER_NAME: BIDS CI
   GIT_COMMITTER_EMAIL: [email protected]
 
+permissions:
+  contents: write
+  id-token: write
+
 jobs:
   publish:
     runs-on: ubuntu-latest
@@ -76,8 +79,9 @@ jobs:
             jq ".version = \"$VERSION\"" jsr.json > tmp.json && mv tmp.json jsr.json
             git add jsr.json schema.json context.ts metaschema.ts
             git commit -m "Update schema JSR distribution"
+            git push
           fi
       - name: Publish to JSR
         if: success()
         run: |
-          npx jsr publish --dry-run
+          npx jsr publish

[codecov]

Codecov Report

Attention: Patch coverage is 0% with 14 lines in your changes missing coverage. Please review.

Project coverage is 87.23%. Comparing base (9377b20) to head (bd45643).

Files	Patch %	Lines
tools/schemacode/bidsschematools/__main__.py	0.00%	14 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1899      +/-   ##
==========================================
- Coverage   88.10%   87.23%   -0.88%     
==========================================
  Files          16       16              
  Lines        1396     1410      +14     
==========================================
  Hits         1230     1230              
- Misses        166      180      +14     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[effigies]

 Simulating publish of @bids/[email protected]+e5db69d6 with files:
   file:///home/runner/work/bids-specification/bids-specification/LICENSE (18.25KB)
   file:///home/runner/work/bids-specification/bids-specification/context.ts (8.46KB)
   file:///home/runner/work/bids-specification/bids-specification/jsr.json (191B)
   file:///home/runner/work/bids-specification/bids-specification/metaschema.ts (20.11KB)
   file:///home/runner/work/bids-specification/bids-specification/schema.json (450.74KB)