feat: add JSON schema generation from Zod

Author: Hweinstock

package.json

@@ -46,6 +46,7 @@
   "scripts": {
     "postinstall": "node scripts/check-old-cli.mjs",
     "build": "npm run build:lib && npm run build:cli && npm run build:assets",
+    "build:schema": "node scripts/generate-schema.mjs && prettier --write schemas/",
     "build:lib": "tsc -p tsconfig.build.json",
     "build:cli": "node esbuild.config.mjs",
     "build:assets": "node scripts/copy-assets.mjs",

schemas/README.md

@@ -0,0 +1,23 @@
+# JSON Schema
+
+This directory contains the JSON Schema for `agentcore.json`, generated from the Zod schemas in `src/schema/`.
+
+## Updating the schema
+
+```bash
+npm run build:lib
+npm run build:schema
+```
+
+This regenerates `schemas/schema.v1.json` from the compiled Zod schemas. Commit the updated file.
+
+## Versioning
+
+- `schema.v1.json` — backwards-compatible updates only (new optional fields)
+- Create `schema.v2.json` only for breaking changes (removed/renamed fields)
+
+### Creating a new major version
+
+1. Update `SCHEMA_VERSION` in `scripts/generate-schema.mjs`
+2. Run `npm run build:lib && npm run build:schema`
+3. Commit the new schema file — keep the old version for existing projects