silvermoon 0.3.0-rc.2 → 0.4.0

package/package.json

@@ -1,51 +1,72 @@
 {
   "name": "silvermoon",
-  "version": "0.3.0-rc.2",
+  "version": "0.4.0",
   "description": "The project spirit that checks repository state and answers what's next.",
   "packageManager": "pnpm@11.22.0",
   "type": "module",
+  "types": "./dist/src/index.d.ts",
   "bin": {
-    "silvermoon": "bin/silvermoon.js"
+    "silvermoon": "dist/bin/silvermoon.js",
+    "silvermoon-migrate-v1-to-v2": "dist/bin/migrate-v1-to-v2.js"
   },
   "exports": {
-    ".": "./src/index.js"
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./agents/copilot": {
+      "types": "./dist/src/business/agent-copilot.d.ts",
+      "default": "./dist/src/business/agent-copilot.js"
+    },
+    "./agents/project-runtime": {
+      "types": "./dist/src/business/agent-project-runtime.d.ts",
+      "default": "./dist/src/business/agent-project-runtime.js"
+    }
   },
   "files": [
-    "bin",
+    "dist",
     "docs",
     "skills/silvermoon",
-    "src",
     "LICENSE",
     "README.md",
     "README.zh-CN.md",
     "schema"
   ],
   "scripts": {
-    "check": "node scripts/run-checks.mjs",
-    "check:sanity": "node scripts/run-checks.mjs --tier sanity",
-    "check:commit": "node scripts/run-checks.mjs --tier commit",
-    "check:release": "node scripts/run-checks.mjs --tier release",
-    "check:syntax": "node --check bin/silvermoon.js",
-    "check:staged": "node bin/silvermoon.js check --staged --audience agent",
+    "silvermoon": "node bin/silvermoon.js",
+    "clean": "node tools/clean.ts",
+    "typecheck": "tsc -p tsconfig.json",
+    "build": "npm run clean && tsc -p tsconfig.build.json && node tools/write-cli-shim.ts",
+    "check": "node bin/run-checks.ts",
+    "check:sanity": "node bin/run-checks.ts --tier sanity",
+    "check:commit": "node bin/run-checks.ts --tier commit",
+    "check:release": "node bin/run-checks.ts --tier release",
+    "check:syntax": "node --check bin/silvermoon.ts",
+    "check:pure": "node bin/pure-check.ts",
+    "check:staged": "node bin/silvermoon.ts check --staged --audience agent",
     "check:diff": "git diff --check && git diff --cached --check",
-    "check:quick": "node --check bin/silvermoon.js && npm test",
+    "check:quick": "npm run check:syntax && npm test",
     "check:skills": "npm run check:skills:local && npm run check:skills:discover",
-    "check:skills:local": "node scripts/sync-skills.mjs --check",
+    "check:skills:local": "node bin/sync-skills.ts --check",
     "check:skills:discover": "npx skills add . --list",
     "lint:markdown": "markdownlint-cli2",
-    "pack:check": "node scripts/check-pack.js",
-    "prepare:npm-release": "node scripts/prepare-npm-release.mjs",
-    "sync:skills": "node scripts/sync-skills.mjs",
+    "pack:check": "npm run build && npm run pack:check:built",
+    "pack:check:built": "node bin/check-pack.ts",
+    "prepare:npm-release": "node bin/prepare-npm-release.ts",
+    "sync:skills": "node bin/sync-skills.ts",
     "test": "npm run test:unit && npm run test:contract",
-    "test:contract": "node --test \"test/contract/*.test.*\"",
-    "test:e2e": "node --test \"test/e2e/*.test.*\"",
-    "test:integration": "node --test \"test/integration/*.test.*\"",
-    "test:sanity": "node --import ./test/helpers/sanity-guard.mjs --test \"test/unit/*.test.*\" test/contract/schema-v1.test.js test/contract/package-api.test.js",
-    "test:smoke": "node --test test/runtime/adoption.test.js test/runtime/cli-v1.test.js",
-    "test:unit": "node --test \"test/unit/*.test.*\" \"test/runtime/*.test.*\""
+    "test:contract": "npm run build && npm run test:contract:built",
+    "test:contract:built": "node --test \"test/contract/*.test.ts\"",
+    "test:e2e": "npm run build && npm run test:e2e:built",
+    "test:e2e:built": "node --test \"test/e2e/*.test.ts\"",
+    "test:integration": "npm run build && npm run test:integration:built",
+    "test:integration:built": "node --test \"test/integration/*.test.ts\"",
+    "test:sanity": "node --import ./test/helpers/sanity-guard.ts --test \"test/unit/*.test.ts\" test/contract/schema-v1.test.ts test/contract/schema-v2.test.ts test/contract/package-api.test.ts",
+    "test:smoke": "node --test test/runtime/adoption.test.ts test/runtime/cli-v1.test.ts",
+    "test:unit": "node --test \"test/unit/*.test.ts\" \"test/runtime/*.test.ts\""
   },
   "engines": {
-    "node": ">=22"
+    "node": ">=22.12.0"
   },
   "keywords": [
     "agent-skills",
@@ -85,15 +106,20 @@
     }
   ],
   "devDependencies": {
+    "@types/node": "^22.20.5",
+    "@types/react": "^19.3.0",
+    "@types/semver": "^7.8.0",
+    "@types/ws": "^8.18.2",
     "ajv": "^8.20.0",
     "markdownlint-cli2": "^0.23.3",
     "semver": "^7.8.5",
-    "silvermoon": "^0.2.2"
+    "typescript": "^5.9.3"
   },
   "dependencies": {
+    "@github/copilot-sdk": "1.0.16",
     "@opentui/core": "npm:@jitl/opentui-core@0.4.0",
     "@opentui/react": "npm:@jitl/opentui-react@0.4.0",
-    "commander": "^14.0.3",
+    "commander": "^15.0.0",
     "marked": "^18.0.13",
     "mdast-util-from-markdown": "^2.0.3",
     "mdast-util-to-markdown": "^2.1.2",
@@ -104,7 +130,7 @@
     "ws": "^8.22.0",
     "yaml": "^2.9.1"
   },
-  "gitHead": "84860fea52d1af6cdf4968b403f337844779cb21",
-  "readme": "<!-- markdownlint-disable-file MD041 -->\n\n<p align=\"center\">\n  <!-- markdownlint-disable-next-line MD013 -->\n  <img src=\"https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@84860fea52d1af6cdf4968b403f337844779cb21/assets/silvermoon.svg\" width=\"960\" alt=\"Silvermoon, the artifact spirit of the project\">\n</p>\n\n<p align=\"center\">\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://npmx.dev/package/silvermoon\"><img src=\"https://img.shields.io/npm/v/silvermoon?style=flat-square\" alt=\"npm version\"></a>\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://npmx.dev/package/silvermoon\"><img src=\"https://img.shields.io/node/v/silvermoon?style=flat-square\" alt=\"Node.js version\"></a>\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://npmx.dev/package/silvermoon\"><img src=\"https://img.shields.io/npm/dm/silvermoon?style=flat-square\" alt=\"monthly npm downloads\"></a>\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/LICENSE\"><img src=\"https://img.shields.io/github/license/shazhou-ww/silvermoon?style=flat-square\" alt=\"MIT license\"></a>\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://github.com/shazhou-ww/silvermoon/actions/workflows/ci.yml?query=branch%3Amain\"><img src=\"https://img.shields.io/github/actions/workflow/status/shazhou-ww/silvermoon/ci.yml?branch=main&style=flat-square&label=CI\" alt=\"CI status\"></a>\n</p>\n\n<p align=\"center\">\n  English | <a href=\"https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/README.zh-CN.md\">简体中文</a>\n</p>\n\n# Silvermoon\n\n> Fellow cultivator, you wouldn't want your lifebound project to be without an\n> artifact spirit, would you?\n\n## Quick Start\n\n### Setup\n\nSilvermoon requires Node.js 22 or later, along with Git access to the\nrepository's primary branch.\n\nFrom the project directory, send this prompt to your coding agent:\n\n```text\nIn this project, run:\n`npx silvermoon whats-next --audience agent`\n\nFollow its highest-priority instruction and preserve existing work.\nAfter each observable change, run it again until it reports: `navigation-ready`\n```\n\n### Talk to Silvermoon\n\nUse the Silvermoon skill in your coding agent:\n\n```text\n/silvermoon\nWhat should I work on next in this project?\n```\n\nOr continue an idea directly:\n\n```text\n/silvermoon\nContinue working on `<idea-alias>` in this project.\nFollow the `whats-next` guidance.\nKeep going until you need a decision from me.\n```\n\nOr start a new idea:\n\n```text\n/silvermoon\nI have an idea:\nAdd an optional cultivation-style copy mode,\nindependent of the selected language.\n```\n\nOr run Silvermoon straight from a terminal:\n\n```sh\nnpx silvermoon whats-next\nnpx silvermoon whats-next <ULID-or-alias>\nnpx silvermoon create-idea\nnpx silvermoon list-ideas\n```\n\n> **Note:** We recommend `npx silvermoon` over a global install. It avoids\n> maintaining a separate global version; in Node.js projects, the lockfile keeps\n> the project-installed version consistent.\n\nFor workflows, see [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/docs/operations.md); for command\ndetails, see the [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/docs/reference.md).\n\n## Why Silvermoon\n\nLong-running Agent work tends to make people carry too much invisible state.\nSomeone has to remember what was originally intended, whether the code still\nmatches the task, and which conversation or machine holds the latest truth.\nSilvermoon moves those concerns into the project itself.\n\nIt lets people step away from continuous supervision and return only for the\ndecisions that are theirs: approving the intended outcome, accepting the\nimplementation, and accepting that the result holds in the outside world.\nBetween those boundaries, an Agent can inspect repository facts and carry on\nwith the highest-priority safe action.\n\nIt also refuses to let a detached task card declare success. State is derived\njointly from current artifacts and explicit decisions, so once a goal or an\nimplementation changes, conclusions that rested on the older revision are\ninvalidated as a matter of course. And because those facts live in Git, work\ncontinues across devices, sessions, Agents, and hosting platforms.\n\n## The Project's Artifact Spirit\n\n<table>\n  <tr>\n    <td width=\"160\" align=\"center\" valign=\"top\">\n      <!-- markdownlint-disable-next-line MD013 -->\n      <img src=\"https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@84860fea52d1af6cdf4968b403f337844779cb21/assets/silvermoon-mascot.png\" width=\"160\" alt=\"Full-body portrait of Silvermoon, the project's artifact spirit\">\n    </td>\n    <td valign=\"top\">\n      Silvermoon is named after a character in <em>A Record of a Mortal's\n      Journey to Immortality</em>. She comes from the Silvermoon Wolf Clan in\n      the Spirit Realm, and is one of the two souls split from Ling Long.\n      Adrift in the human realm, she became the artifact spirit of a\n      wolf-headed jade scepter — and in that long service lost part of her\n      memory, taking the name Silvermoon. She later became the artifact spirit\n      of Han Li's Bamboo Cloudswarm Swords.\n      <br><br>\n      That image suits this project: Silvermoon belongs to no single operator\n      and no single chat. It lives alongside the project's artifacts,\n      understands their state, and helps every companion see what comes next.\n      The backstory is inspiration, not a prerequisite for using the tool.\n    </td>\n  </tr>\n</table>\n\nWatch *A Record of a Mortal's Journey to Immortality*:\n\n<!-- markdownlint-disable-next-line MD013 -->\n- YouTube: [Episode 150: Overseas Turmoil 26](https://www.youtube.com/watch?v=GJgezoCBIHM \"A Record of a Mortal's Journey to Immortality — Episode 150: Overseas Turmoil 26\")\n<!-- markdownlint-disable-next-line MD013 -->\n- Bilibili: [Episode 150: Overseas Turmoil 26](https://www.bilibili.com/bangumi/play/ep1231558 \"A Record of a Mortal's Journey to Immortality — Episode 150: Overseas Turmoil 26\")\n\n## From Ideal to Real\n\nA project is more than a task list or a transcript. It is an ideal becoming\nreal across three nested worlds.\n\n**Ideal World (道心)** is the world of ideals, **Inner World (内景)** the\nsubjective world, and **Outer World (现世)** the world of reality.\n\n> 道心立志，内景化形，现世求真。\n\nThe worlds nest from the inside out: the subjective world contains the ideal it\nserves, and is itself part of the real world — just as a person holds ideals yet\nmust live in reality.\n\nSo the ideal is first argued out in the Ideal World, then given form in the\nInner World, and finally deployed into the Outer World. That is consciousness\nacting back upon matter.\n\nHumans own approval and acceptance. Agents own continuation: they read the\ncontracts, the ledger, and the facts in Git; preserve concurrent work; carry\nout one safe action; and re-observe only once something has changed. Context\nbelongs to the project, not to a fleeting conversation.\n\n## Further Reading\n\n- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/docs/getting-started.md) — installation, configuration,\n  and the first idea.\n- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/docs/core-concepts.md) — project ownership, the three\n  worlds, revisions, and decision boundaries.\n- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/docs/operations.md) — navigation, creation,\n  publication, hygiene, and continuation.\n- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/docs/reference.md) — storage, derived state, CLI\n  reports, validation targets, and schemas.\n- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/docs/maintaining.md) — development checks,\n  documentation ownership, and release guidance.\n\n## Community\n\n- [Contributing](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/CONTRIBUTING.md)\n- [Code of Conduct](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/CODE_OF_CONDUCT.md)\n- [Security Policy](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/SECURITY.md)\n- [Support](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/SUPPORT.md)\n- [Changelog](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/CHANGELOG.md)\n- [MIT License](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/LICENSE)\n\n## Image Copyright Disclaimer\n\nThe Silvermoon character images in this project are AI-generated derivative\nworks based on the animated adaptation of *A Record of a Mortal's Journey to\nImmortality*. Rights in the original character and animation belong to their\nrespective holders, and these images fall outside this project's\n[MIT License](https://github.com/shazhou-ww/silvermoon/blob/84860fea52d1af6cdf4968b403f337844779cb21/LICENSE). If any rights holder believes an image infringes\ntheir rights, please contact the author and the image will be replaced.\n",
+  "gitHead": "191e74387e2566645f4fdaf74e1c20ec38ad0d02",
+  "readme": "<!-- markdownlint-disable-file MD041 -->\n\n<p align=\"center\">\n  <!-- markdownlint-disable-next-line MD013 -->\n  <img src=\"https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@191e74387e2566645f4fdaf74e1c20ec38ad0d02/assets/silvermoon.svg\" width=\"960\" alt=\"Silvermoon, the artifact spirit of the project\">\n</p>\n\n<p align=\"center\">\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://npmx.dev/package/silvermoon\"><img src=\"https://img.shields.io/npm/v/silvermoon?style=flat-square\" alt=\"npm version\"></a>\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://npmx.dev/package/silvermoon\"><img src=\"https://img.shields.io/node/v/silvermoon?style=flat-square\" alt=\"Node.js version\"></a>\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://npmx.dev/package/silvermoon\"><img src=\"https://img.shields.io/npm/dm/silvermoon?style=flat-square\" alt=\"monthly npm downloads\"></a>\n  <!-- markdownlint-disable-next-line MD013 -->\n  <a href=\"https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/LICENSE\"><img src=\"https://img.shields.io/github/license/shazhou-ww/silvermoon?style=flat-square\" alt=\"MIT license\"></a>\n</p>\n\n<p align=\"center\">\n  English | <a href=\"https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/README.zh-CN.md\">简体中文</a>\n</p>\n\n# Silvermoon\n\n> Fellow cultivator, you wouldn't want your lifebound project to be without an\n> artifact spirit, would you?\n\n## Quick Start\n\n### Setup\n\nSilvermoon requires Node.js 22 or later, along with Git access to the\nrepository's primary branch.\n\nFrom the project directory, send this prompt to your coding agent:\n\n```text\nIn this project, run:\n`silvermoon whats-next --audience agent`\n\nFollow its highest-priority instruction and preserve existing work.\nAfter each observable change, run it again until it reports: `navigation-ready`\n```\n\n### Talk to Silvermoon\n\nUse the Silvermoon skill in your coding agent:\n\n```text\n/silvermoon\nWhat should I work on next in this project?\n```\n\nOr continue an idea directly:\n\n```text\n/silvermoon\nContinue working on `<idea-alias>` in this project.\nFollow the `whats-next` guidance.\nKeep going until you need a decision from me.\n```\n\nOr start a new idea:\n\n```text\n/silvermoon\nI have an idea:\nAdd an optional cultivation-style copy mode,\nindependent of the selected language.\n```\n\nOr run Silvermoon straight from a terminal:\n\n```sh\nsilvermoon whats-next\nsilvermoon whats-next <ULID-or-alias>\nsilvermoon create-idea\nsilvermoon list-ideas\n```\n\n> **Note:** Install and update one global Silvermoon runtime for the device or\n> Agent host. Dialogue commands report cached latest-runtime and personal-skill\n> health as device advisories. Target repositories do not pin Silvermoon or\n> store its skill. Since `0.4.0`, project compatibility is determined by the\n> runtime-owned per-file schema capability and migration graph.\n\nFor workflows, see [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/docs/operations.md); for command\ndetails, see the [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/docs/reference.md).\n\n## Why Silvermoon\n\nLong-running Agent work tends to make people carry too much invisible state.\nSomeone has to remember what was originally intended, whether the code still\nmatches the task, and which conversation or machine holds the latest truth.\nSilvermoon moves those concerns into the project itself.\n\nIt lets people step away from continuous supervision and return only for the\ndecisions that are theirs: approving the intended outcome, accepting the\nimplementation, and accepting that the result holds in the outside world.\nBetween those boundaries, an Agent can inspect repository facts and carry on\nwith the highest-priority safe action.\n\nIt also refuses to let a detached task card declare success. State is derived\njointly from current artifacts and explicit decisions, so once a goal or an\nimplementation changes, conclusions that rested on the older revision are\ninvalidated as a matter of course. And because those facts live in Git, work\ncontinues across devices, sessions, Agents, and hosting platforms.\n\n## The Project's Artifact Spirit\n\n<table>\n  <tr>\n    <td width=\"160\" align=\"center\" valign=\"top\">\n      <!-- markdownlint-disable-next-line MD013 -->\n      <img src=\"https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@191e74387e2566645f4fdaf74e1c20ec38ad0d02/assets/silvermoon-mascot.png\" width=\"160\" alt=\"Full-body portrait of Silvermoon, the project's artifact spirit\">\n    </td>\n    <td valign=\"top\">\n      Silvermoon is named after a character in <em>A Record of a Mortal's\n      Journey to Immortality</em>. She comes from the Silvermoon Wolf Clan in\n      the Spirit Realm, and is one of the two souls split from Ling Long.\n      Adrift in the human realm, she became the artifact spirit of a\n      wolf-headed jade scepter — and in that long service lost part of her\n      memory, taking the name Silvermoon. She later became the artifact spirit\n      of Han Li's Bamboo Cloudswarm Swords.\n      <br><br>\n      That image suits this project: Silvermoon belongs to no single operator\n      and no single chat. It lives alongside the project's artifacts,\n      understands their state, and helps every companion see what comes next.\n      The backstory is inspiration, not a prerequisite for using the tool.\n    </td>\n  </tr>\n</table>\n\nWatch *A Record of a Mortal's Journey to Immortality*:\n\n<!-- markdownlint-disable-next-line MD013 -->\n- YouTube: [Episode 150: Overseas Turmoil 26](https://www.youtube.com/watch?v=GJgezoCBIHM \"A Record of a Mortal's Journey to Immortality — Episode 150: Overseas Turmoil 26\")\n<!-- markdownlint-disable-next-line MD013 -->\n- Bilibili: [Episode 150: Overseas Turmoil 26](https://www.bilibili.com/bangumi/play/ep1231558 \"A Record of a Mortal's Journey to Immortality — Episode 150: Overseas Turmoil 26\")\n\n## From Ideal to Real\n\nA project is more than a task list or a transcript. It is an ideal becoming\nreal across three nested worlds.\n\n**Ideal World (道心)** is the world of ideals, **Inner World (内景)** the\nsubjective world, and **Outer World (现世)** the world of reality.\n\n> 道心立志，内景化形，现世求真。\n\nThe worlds nest from the inside out: the subjective world contains the ideal it\nserves, and is itself part of the real world — just as a person holds ideals yet\nmust live in reality.\n\nSo the ideal is first argued out in the Ideal World, then given form in the\nInner World, and finally deployed into the Outer World. That is consciousness\nacting back upon matter.\n\nHumans own approval and acceptance. Agents own continuation: they read the\ncontracts, the ledger, and the facts in Git; preserve concurrent work; carry\nout one safe action; and re-observe only once something has changed. Context\nbelongs to the project, not to a fleeting conversation.\n\n## Further Reading\n\n- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/docs/getting-started.md) — installation, configuration,\n  and the first idea.\n- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/docs/core-concepts.md) — project ownership, the three\n  worlds, revisions, and decision boundaries.\n- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/docs/operations.md) — navigation, creation,\n  publication, hygiene, and continuation.\n- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/docs/reference.md) — storage, derived state, CLI\n  reports, validation targets, and schemas.\n- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/docs/maintaining.md) — development checks,\n  documentation ownership, and release guidance.\n\n## Community\n\n- [Contributing](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/CONTRIBUTING.md)\n- [Code of Conduct](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/CODE_OF_CONDUCT.md)\n- [Security Policy](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/SECURITY.md)\n- [Support](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/SUPPORT.md)\n- [Changelog](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/CHANGELOG.md)\n- [MIT License](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/LICENSE)\n\n## Image Copyright Disclaimer\n\nThe Silvermoon character images in this project are AI-generated derivative\nworks based on the animated adaptation of *A Record of a Mortal's Journey to\nImmortality*. Rights in the original character and animation belong to their\nrespective holders, and these images fall outside this project's\n[MIT License](https://github.com/shazhou-ww/silvermoon/blob/191e74387e2566645f4fdaf74e1c20ec38ad0d02/LICENSE). If any rights holder believes an image infringes\ntheir rights, please contact the author and the image will be replaced.\n",
   "readmeFilename": "README.md"
 }

package/schema/capabilities.json

@@ -0,0 +1,95 @@
+{
+  "$schema": "./capability-manifest.schema.json",
+  "manifestVersion": 1,
+  "releaseBoundary": "0.4.0",
+  "families": {
+    "project-config": {
+      "scope": "project",
+      "pathPatterns": [".silvermoon/config.yaml"],
+      "targetVersion": 2,
+      "readVersions": [1, 2],
+      "schemas": {
+        "1": "schema/v1/config.schema.json",
+        "2": "schema/v2/config.schema.json"
+      },
+      "migrations": ["project-v1-to-v2"]
+    },
+    "idea-state": {
+      "scope": "project",
+      "pathPatterns": [
+        ".silvermoon/ideas/<ULID>/status.yaml",
+        ".silvermoon/ideas/<ULID>/events.jsonl"
+      ],
+      "targetVersion": 2,
+      "readVersions": [1, 2],
+      "schemas": {
+        "1": "schema/v1/idea-status.schema.json",
+        "2": "schema/v2/idea-event.schema.json"
+      },
+      "migrations": ["project-v1-to-v2"]
+    },
+    "user-config": {
+      "scope": "device",
+      "pathPatterns": ["~/.config/silvermoon/config.yaml"],
+      "targetVersion": 1,
+      "readVersions": [1],
+      "schemas": {
+        "1": "schema/v1/user-config.schema.json"
+      },
+      "migrations": []
+    },
+    "command-report": {
+      "scope": "runtime",
+      "pathPatterns": ["runtime://command-report"],
+      "targetVersion": 1,
+      "readVersions": [1],
+      "schemas": {
+        "1": "schema/v1/command-report.schema.json"
+      },
+      "migrations": []
+    },
+    "domain-message": {
+      "scope": "runtime",
+      "pathPatterns": ["runtime://domain-message"],
+      "targetVersion": 1,
+      "readVersions": [1],
+      "schemas": {
+        "1": "schema/v1/domain-message.schema.json"
+      },
+      "migrations": []
+    },
+    "trace-event": {
+      "scope": "runtime",
+      "pathPatterns": ["runtime://trace-event"],
+      "targetVersion": 2,
+      "readVersions": [2],
+      "schemas": {
+        "2": "schema/v2/trace-event.schema.json"
+      },
+      "migrations": []
+    }
+  },
+  "migrations": {
+    "project-v1-to-v2": {
+      "kind": "schema",
+      "fromVersions": {
+        "project-config": 1,
+        "idea-state": 1
+      },
+      "toVersions": {
+        "project-config": 2,
+        "idea-state": 2
+      },
+      "entrypoint": "dist/bin/migrate-v1-to-v2.js",
+      "sourceEntrypoint": "bin/migrate-v1-to-v2.ts",
+      "executable": "silvermoon-migrate-v1-to-v2",
+      "guarantees": [
+        "read-only-plan",
+        "exact-digest-apply",
+        "resume",
+        "rollback",
+        "semantic-projection-equivalence"
+      ]
+    }
+  }
+}

package/schema/capability-manifest.schema.json

@@ -0,0 +1,139 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/shazhou-ww/silvermoon/raw/refs/heads/main/schema/capability-manifest.schema.json",
+  "title": "Silvermoon schema capability manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["manifestVersion", "releaseBoundary", "families", "migrations"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "manifestVersion": { "const": 1 },
+    "releaseBoundary": {
+      "type": "string",
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)$"
+    },
+    "families": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "$ref": "#/$defs/family" }
+    },
+    "migrations": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/$defs/migration" }
+    }
+  },
+  "$defs": {
+    "family": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "scope",
+        "pathPatterns",
+        "targetVersion",
+        "readVersions",
+        "schemas",
+        "migrations"
+      ],
+      "properties": {
+        "scope": { "enum": ["project", "device", "runtime"] },
+        "pathPatterns": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "targetVersion": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        },
+        "readVersions": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 9007199254740991
+          }
+        },
+        "schemas": {
+          "type": "object",
+          "minProperties": 1,
+          "patternProperties": {
+            "^[1-9][0-9]*$": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "migrations": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+          }
+        }
+      }
+    },
+    "migration": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "fromVersions",
+        "toVersions",
+        "entrypoint",
+        "sourceEntrypoint",
+        "executable",
+        "guarantees"
+      ],
+      "properties": {
+        "kind": { "const": "schema" },
+        "fromVersions": { "$ref": "#/$defs/versionSet" },
+        "toVersions": { "$ref": "#/$defs/versionSet" },
+        "entrypoint": { "type": "string", "minLength": 1 },
+        "sourceEntrypoint": { "type": "string", "minLength": 1 },
+        "executable": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "guarantees": {
+          "type": "array",
+          "uniqueItems": true,
+          "contains": { "const": "read-only-plan" },
+          "allOf": [
+            { "contains": { "const": "exact-digest-apply" } },
+            { "contains": { "const": "resume" } },
+            { "contains": { "const": "rollback" } },
+            {
+              "contains": {
+                "const": "semantic-projection-equivalence"
+              }
+            }
+          ],
+          "items": {
+            "enum": [
+              "read-only-plan",
+              "exact-digest-apply",
+              "resume",
+              "rollback",
+              "semantic-projection-equivalence"
+            ]
+          }
+        }
+      }
+    },
+    "versionSet": {
+      "type": "object",
+      "minProperties": 1,
+      "patternProperties": {
+        "^[a-z0-9]+(?:-[a-z0-9]+)*$": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 9007199254740991
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema/v1/command-report.schema.json

@@ -25,7 +25,8 @@
             "whats-next",
             "create-idea",
             "check",
-            "list-ideas"
+            "list-ideas",
+            "event"
           ]
         },
         "args": {
@@ -138,7 +139,8 @@
             "idea-created",
             "idea-list",
             "next-steps",
-            "validation-result"
+            "validation-result",
+            "event-result"
           ]
         },
         "language": {

package/schema/v1/domain-message.schema.json

@@ -40,7 +40,8 @@
             "whats-next",
             "create-idea",
             "check",
-            "list-ideas"
+            "list-ideas",
+            "event"
           ]
         },
         "args": {

package/schema/v2/config.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/shazhou-ww/silvermoon/raw/refs/heads/main/schema/v2/config.schema.json",
+  "title": "Silvermoon event project configuration v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "primaryRepository", "primaryBranch"],
+  "properties": {
+    "version": { "const": 2 },
+    "primaryRepository": { "$ref": "../v1/definitions.schema.json#/$defs/repository" },
+    "primaryBranch": { "$ref": "../v1/definitions.schema.json#/$defs/branch" },
+    "preferredLanguage": { "$ref": "../v1/definitions.schema.json#/$defs/languageTag" }
+  }
+}

package/schema/v2/idea-event.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/shazhou-ww/silvermoon/raw/refs/heads/main/schema/v2/idea-event.schema.json",
+  "title": "Silvermoon idea state event v2",
+  "description": "One canonical UTF-8 JSONL record in an idea's events.jsonl file, with LF and at most 1048576 bytes including LF. The file may be empty; otherwise every record ends with LF and sequence starts at 1 and remains consecutive. Runtime also enforces canonical byte encoding, a regular-file layout, nonempty transitions and the abandoned boundary.",
+  "type": "object",
+  "required": ["sequence", "type"],
+  "properties": {
+    "sequence": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
+    "type": { "type": "string" }
+  },
+  "oneOf": [
+    {
+      "properties": {
+        "type": { "const": "setAlias" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["alias"],
+          "properties": { "alias": { "anyOf": [
+            { "$ref": "../v1/idea-status.schema.json#/properties/alias" }, { "type": "null" }
+          ] } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "setLanguage" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["language"],
+          "properties": { "language": { "anyOf": [
+            { "$ref": "../v1/definitions.schema.json#/$defs/languageTag" }, { "type": "null" }
+          ] } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "submitIdeal" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["idealRevision"],
+          "properties": { "idealRevision": { "$ref": "../v1/definitions.schema.json#/$defs/objectId" } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "submitInner" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["implementationRevision"],
+          "properties": { "implementationRevision": { "$ref": "../v1/definitions.schema.json#/$defs/objectId" } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "submitOuter" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["deploymentRevision"],
+          "properties": { "deploymentRevision": { "$ref": "../v1/definitions.schema.json#/$defs/objectId" } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "acceptIdeal" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["idealRevision"],
+          "properties": { "idealRevision": { "$ref": "../v1/definitions.schema.json#/$defs/objectId" } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "acceptInner" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["implementationRevision"],
+          "properties": { "implementationRevision": { "$ref": "../v1/definitions.schema.json#/$defs/objectId" } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "acceptOuter" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["deploymentRevision"],
+          "properties": { "deploymentRevision": { "$ref": "../v1/definitions.schema.json#/$defs/objectId" } }
+        }
+      },
+      "required": ["payload"]
+    },
+    { "properties": { "type": { "const": "abandon" } } },
+    { "properties": { "type": { "const": "resume" } } },
+    {
+      "properties": {
+        "type": { "const": "ping" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["message"],
+          "properties": { "message": { "type": "string", "pattern": "\\S" } }
+        }
+      },
+      "required": ["payload"]
+    },
+    {
+      "properties": {
+        "type": { "const": "pong" },
+        "payload": {
+          "type": "object", "additionalProperties": false, "required": ["message"],
+          "properties": { "message": { "type": "string", "pattern": "\\S" } }
+        }
+      },
+      "required": ["payload"]
+    }
+  ],
+  "unevaluatedProperties": false
+}