Publish server settings schema with release versions

.github/workflows/release.yml

@@ -126,7 +126,7 @@ jobs:
         run: bun install --frozen-lockfile
 
       - name: Align package versions to release version
-        run: node scripts/update-release-package-versions.ts "${{ needs.preflight.outputs.version }}"
+        run: bun scripts/update-release-package-versions.ts "${{ needs.preflight.outputs.version }}"
 
       - name: Build desktop artifact
         shell: bash
@@ -248,7 +248,7 @@ jobs:
         run: bun install --frozen-lockfile
 
       - name: Align package versions to release version
-        run: node scripts/update-release-package-versions.ts "${{ needs.preflight.outputs.version }}"
+        run: bun scripts/update-release-package-versions.ts "${{ needs.preflight.outputs.version }}"
 
       - name: Build CLI package
         run: bun run build --filter=@t3tools/web --filter=t3
@@ -348,7 +348,7 @@ jobs:
         name: Update version strings
         env:
           RELEASE_VERSION: ${{ needs.preflight.outputs.version }}
-        run: node scripts/update-release-package-versions.ts "$RELEASE_VERSION" --github-output
+        run: bun scripts/update-release-package-versions.ts "$RELEASE_VERSION" --github-output
 
       - name: Format package.json files
         if: steps.update_versions.outputs.changed == 'true'
@@ -364,14 +364,14 @@ jobs:
         env:
           RELEASE_TAG: ${{ needs.preflight.outputs.tag }}
         run: |
-          if git diff --quiet -- apps/server/package.json apps/desktop/package.json apps/web/package.json packages/contracts/package.json bun.lock; then
+          if git diff --quiet -- apps/server/package.json apps/desktop/package.json apps/web/package.json packages/contracts/package.json apps/marketing/public/schemas bun.lock; then
             echo "No version changes to commit."
             exit 0
           fi
 
           git config user.name "${{ steps.app_bot.outputs.name }}"
           git config user.email "${{ steps.app_bot.outputs.email }}"
 
-          git add apps/server/package.json apps/desktop/package.json apps/web/package.json packages/contracts/package.json bun.lock
+          git add apps/server/package.json apps/desktop/package.json apps/web/package.json packages/contracts/package.json apps/marketing/public/schemas bun.lock
           git commit -m "chore(release): prepare $RELEASE_TAG"
           git push origin HEAD:main

KEYBINDINGS.md

@@ -15,6 +15,29 @@ The file must be a JSON array of rules:
 
 See the full schema for more details: [`packages/contracts/src/keybindings.ts`](packages/contracts/src/keybindings.ts)
 
+## Editor Schema Support
+
+`keybindings.json` is intentionally a top-level JSON array, so it cannot carry an inline `$schema` property the way `settings.json` can.
+
+To get autocomplete and hover docs in editors like VS Code, associate the file externally with the published schema:
+
+```json
+{
+  "json.schemas": [
+    {
+      "fileMatch": ["**/.t3/keybindings.json", "**/keybindings.json"],
+      "url": "https://t3.codes/schemas/keybindings.json"
+    }
+  ]
+}
+```
+
+If you want a pinned schema instead of the latest stable one, use a versioned URL such as:
+
+```text
+https://t3.codes/schemas/keybindings/0.0.15.json
+```
+
 ## Defaults
 
 ```json

apps/marketing/public/schemas/keybindings.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "T3 Code Keybindings",
+  "description": "Ordered list of custom keybinding rules persisted in `keybindings.json`.",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "properties": {
+      "key": {
+        "type": "string",
+        "description": "Keyboard shortcut to listen for."
+      },
+      "command": {
+        "anyOf": [
+          {
+            "type": "string",
+            "enum": [
+              "terminal.toggle",
+              "terminal.split",
+              "terminal.new",
+              "terminal.close",
+              "diff.toggle",
+              "chat.new",
+              "chat.newLocal",
+              "editor.openFavorite",
+              "thread.previous",
+              "thread.next",
+              "thread.jump.1",
+              "thread.jump.2",
+              "thread.jump.3",
+              "thread.jump.4",
+              "thread.jump.5",
+              "thread.jump.6",
+              "thread.jump.7",
+              "thread.jump.8",
+              "thread.jump.9"
+            ]
+          },
+          {
+            "type": "string",
+            "pattern": "^script\\.[\\s\\S]*?\\.run$",
+            "description": "Command identifier for running a project script, formatted as `script.<id>.run`."
+          }
+        ],
+        "description": "Command to execute when the shortcut matches."
+      },
+      "when": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional expression limiting when the shortcut is active."
+      }
+    },
+    "required": ["key", "command"],
+    "additionalProperties": false,
+    "description": "Single keybinding rule entry in `keybindings.json`."
+  },
+  "allOf": [
+    {
+      "maxItems": 256,
+      "description": "Ordered list of custom keybinding rules persisted in `keybindings.json`."
+    }
+  ]
+}

apps/marketing/public/schemas/keybindings/0.0.15.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "T3 Code Keybindings",
+  "description": "Ordered list of custom keybinding rules persisted in `keybindings.json`.",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "properties": {
+      "key": {
+        "type": "string",
+        "description": "Keyboard shortcut to listen for."
+      },
+      "command": {
+        "anyOf": [
+          {
+            "type": "string",
+            "enum": [
+              "terminal.toggle",
+              "terminal.split",
+              "terminal.new",
+              "terminal.close",
+              "diff.toggle",
+              "chat.new",
+              "chat.newLocal",
+              "editor.openFavorite",
+              "thread.previous",
+              "thread.next",
+              "thread.jump.1",
+              "thread.jump.2",
+              "thread.jump.3",
+              "thread.jump.4",
+              "thread.jump.5",
+              "thread.jump.6",
+              "thread.jump.7",
+              "thread.jump.8",
+              "thread.jump.9"
+            ]
+          },
+          {
+            "type": "string",
+            "pattern": "^script\\.[\\s\\S]*?\\.run$",
+            "description": "Command identifier for running a project script, formatted as `script.<id>.run`."
+          }
+        ],
+        "description": "Command to execute when the shortcut matches."
+      },
+      "when": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Optional expression limiting when the shortcut is active."
+      }
+    },
+    "required": ["key", "command"],
+    "additionalProperties": false,
+    "description": "Single keybinding rule entry in `keybindings.json`."
+  },
+  "allOf": [
+    {
+      "maxItems": 256,
+      "description": "Ordered list of custom keybinding rules persisted in `keybindings.json`."
+    }
+  ]
+}