npm - silvermoon - Versions diffs - 0.2.0-rc.1 → 0.2.0 - Mend

silvermoon 0.2.0-rc.1 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -2,7 +2,7 @@
 <p align="center">
   <!-- markdownlint-disable-next-line MD013 -->
-  <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/assets/silvermoon.svg" width="960" alt="Silvermoon, the artifact spirit of the project">
+  <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@27700c428509c3152d5eb96e90a8e1a4a150c6cb/assets/silvermoon.svg" width="960" alt="Silvermoon, the artifact spirit of the project">
 </p>
 <p align="center">
@@ -17,7 +17,7 @@
 </p>
 <p align="center">
-  English | <a href="https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/README.zh-CN.md">简体中文</a>
+  English | <a href="https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/README.zh-CN.md">简体中文</a>
 </p>
 # Silvermoon
@@ -77,7 +77,7 @@ silvermoon whats-next <idea> --language zh-CN
 Describe the desired world in the generated `Idea.md`, review it, and approve
 that exact revision. From then on, Silvermoon keeps the goal, implementation,
 repository state, and real-world result connected. See
-[Getting Started](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/getting-started.md) for the complete first workflow.
+[Getting Started](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/getting-started.md) for the complete first workflow.
 Every command processes one ordered, versioned domain-message stream. Add
 `--json` when a programmatic consumer needs its four deterministic projections:
 `intention`, `observation`, `actions`, and `response`. Actions are side effects
@@ -86,7 +86,7 @@ Markdown renders only the self-contained response instead of exposing the
 internal projections. For pre-commit validation, run
 `silvermoon check --staged`: unlike the default `check` (committed `HEAD`), it
 checks the index and exits `0` only when the project snapshot is valid. See the
-[Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/reference.md) for validation targets and exit
+[Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/reference.md) for validation targets and exit
 codes.
 Add `--trace <file.trace.jsonl>` to any command to write one schema-versioned
@@ -105,7 +105,7 @@ actionable phase's snapshot-bound, repository-owned Markdown in
 `response.guidance`; `observation.guidance` carries its provenance without
 content. `create-idea` can return preparing guidance. This guidance is
 additive, never a fourth contract or decision fact, and `check` validates the
-complete fixed directory. See [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/core-concepts.md).
+complete fixed directory. See [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/core-concepts.md).
 ## Why Silvermoon
@@ -135,7 +135,7 @@ sessions, Agents, and hosting platforms.
   <tr>
     <td width="160" align="center" valign="top">
       <!-- markdownlint-disable-next-line MD013 -->
-      <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/assets/silvermoon-avatar.svg" width="128" alt="Line portrait of Silvermoon, the project's artifact spirit">
+      <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@27700c428509c3152d5eb96e90a8e1a4a150c6cb/assets/silvermoon-avatar.svg" width="128" alt="Line portrait of Silvermoon, the project's artifact spirit">
     </td>
     <td valign="top">
       Silvermoon is named after a character in <em>A Record of a Mortal's
@@ -183,13 +183,13 @@ the project, not to a fleeting conversation.
 ## Further Reading
-- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/getting-started.md) — installation, configuration,
+- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/getting-started.md) — installation, configuration,
   and the first idea.
-- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/core-concepts.md) — project ownership, the three
+- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/core-concepts.md) — project ownership, the three
   worlds, revisions, and decision boundaries.
-- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/operations.md) — navigation, creation,
+- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/operations.md) — navigation, creation,
   publication, hygiene, and continuation.
-- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/reference.md) — storage, derived state, CLI
+- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/reference.md) — storage, derived state, CLI
   reports, validation targets, and schemas.
-- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/maintaining.md) — development checks,
+- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/maintaining.md) — development checks,
   documentation ownership, and release guidance.

package/README.zh-CN.md CHANGED Viewed

@@ -2,11 +2,11 @@
 <p align="center">
   <!-- markdownlint-disable-next-line MD013 -->
-  <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/assets/silvermoon.svg" width="960" alt="Silvermoon，项目的器灵">
+  <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@27700c428509c3152d5eb96e90a8e1a4a150c6cb/assets/silvermoon.svg" width="960" alt="Silvermoon，项目的器灵">
 </p>
 <p align="center">
-  <a href="https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/README.md">English</a> | 简体中文
+  <a href="https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/README.md">English</a> | 简体中文
 </p>
 # Silvermoon（银月）
@@ -60,14 +60,14 @@ silvermoon whats-next <idea> --language zh-CN
 在生成的 `Idea.md` 中描述想要抵达的世界，审阅并批准这个精确 revision。此后，
 Silvermoon 会让目标、实现、仓库状态与现实结果始终相连。完整的首次工作流见英文
-[Getting Started](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/getting-started.md)。
+[Getting Started](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/getting-started.md)。
 每个命令都处理一条有序且带版本的 domain-message stream。程序消费者可使用
 `--json` 获取四个确定性 projection：`intention`、`observation`、`actions` 与
 `response`。`actions` 只记录已经尝试的副作用，未来工作只位于
 `response.nextSteps`。默认 Markdown 只渲染自足的 response，不暴露内部
 projection。提交前使用 `silvermoon check --staged` 验证 index；无参数 `check`
 只验证已提交的 `HEAD`，不能替代提交前检查。只有项目快照有效时检查才以退出码
-`0` 放行，详见英文 [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/reference.md)。
+`0` 放行，详见英文 [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/reference.md)。
 任何命令都可以添加 `--trace <file.trace.jsonl>`，写出一条 schema-versioned
 JSONL timeline。`domain` channel 保存经过 allowlist 的 message 摘要，
@@ -82,7 +82,7 @@ repository 内的 `*.trace.jsonl` 会被忽略。trace 文件采用缓冲写入
 与 snapshot 绑定的 repository-owned Markdown；`observation.guidance` 仅保留
 provenance。`create-idea` 可返回 preparing guidance。这些 guidance 只能追加
 约束，不是第四份 contract 或 decision fact；`check` 会验证完整的固定目录。详见英文
-[Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/core-concepts.md)。
+[Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/core-concepts.md)。
 ## 为什么需要 Silvermoon
@@ -105,7 +105,7 @@ provenance。`create-idea` 可返回 preparing guidance。这些 guidance 只能
   <tr>
     <td width="160" align="center" valign="top">
       <!-- markdownlint-disable-next-line MD013 -->
-      <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/assets/silvermoon-avatar.svg" width="128" alt="项目器灵银月的线稿头像">
+      <img src="https://cdn.jsdelivr.net/gh/shazhou-ww/silvermoon@27700c428509c3152d5eb96e90a8e1a4a150c6cb/assets/silvermoon-avatar.svg" width="128" alt="项目器灵银月的线稿头像">
     </td>
     <td valign="top">
       Silvermoon 得名于《凡人修仙传》中的银月。她来自灵界的银月狼族，是玲珑公主分裂出的
@@ -145,8 +145,8 @@ provenance。`create-idea` 可返回 preparing guidance。这些 guidance 只能
 ## 延伸阅读
-- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/getting-started.md) — 安装、配置与第一个 idea。
-- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/core-concepts.md) — 项目归属、三重世界、revision 与决策边界。
-- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/operations.md) — 导航、创建、发布、仓库卫生与持续推进。
-- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/reference.md) — 存储、派生状态、CLI report、验证 target 与 schema。
-- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/maintaining.md) — 开发检查、文档职责与发布指南。
+- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/getting-started.md) — 安装、配置与第一个 idea。
+- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/core-concepts.md) — 项目归属、三重世界、revision 与决策边界。
+- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/operations.md) — 导航、创建、发布、仓库卫生与持续推进。
+- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/reference.md) — 存储、派生状态、CLI report、验证 target 与 schema。
+- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/maintaining.md) — 开发检查、文档职责与发布指南。

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "silvermoon",
-  "version": "0.2.0-rc.1",
+  "version": "0.2.0",
   "description": "The project spirit that checks repository state and answers what's next.",
   "packageManager": "pnpm@11.22.0",
   "type": "module",
@@ -66,7 +66,7 @@
     "mdast-util-to-markdown": "^2.1.2",
     "yaml": "^2.9.1"
   },
-  "gitHead": "fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400",
-  "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@fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/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/unpacked-size/silvermoon?style=flat-square\" alt=\"npm unpacked size\"></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/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/README.zh-CN.md\">简体中文</a>\n</p>\n\n# Silvermoon\n\n**The artifact spirit of the project.**\n\n## Quick Start\n\nSilvermoon needs Node.js 22 or newer and Git access to the repository's primary\nbranch.\n\n```sh\nnpm install --global silvermoon\nsilvermoon whats-next\nsilvermoon list-ideas\n```\n\nSilvermoon is ecosystem-neutral: the target repository does not need\n`package.json`, a package manager, a Silvermoon dependency, or `node_modules`.\nThe first report lists every applicable setup step in order, including the\nexact `npx skills add ... --agent universal` command that registers the\ncanonical skill at `.agents/skills/silvermoon`.\n\nCreate `.silvermoon/config.yaml`:\n\n```yaml\nversion: 1\nprimaryRepository: https://github.com/example/repository.git\nprimaryBranch: main\npreferredLanguage: en\n```\n\n`preferredLanguage` is optional. A specific idea can override it with\n`language` in `status.yaml`, and `create-idea --language <tag>` can set that\noverride when the idea is created. Otherwise Silvermoon checks\n`~/.config/silvermoon/config.yaml` and finally defaults to `en-US`.\nThese stored values choose the language for project-owned content. To change\nonly one command's built-in output, use `whats-next --language en-US|zh-CN` or\n`check --language en-US|zh-CN`; the temporary override is never persisted.\n\nUse `list-ideas` when you only need the current local inventory. It defaults to\nactive ideas and supports repeatable `--state`, `--all`, literal `--query`,\nRFC 3339 `--created-since` / `--created-before`, `--sort`, and `--limit`.\nUnlike lifecycle navigation, this read-only query uses the valid worktree\nsnapshot without checking branch, upstream, cleanliness, network, or primary\nsynchronization.\n\nThen create an idea and let the registered Silvermoon skill guide one safe\nnext action at a time:\n\n```sh\nsilvermoon create-idea\nsilvermoon whats-next <idea>\nsilvermoon whats-next <idea> --language zh-CN\n```\n\nDescribe the desired world in the generated `Idea.md`, review it, and approve\nthat exact revision. From then on, Silvermoon keeps the goal, implementation,\nrepository state, and real-world result connected. See\n[Getting Started](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/getting-started.md) for the complete first workflow.\nEvery command processes one ordered, versioned domain-message stream. Add\n`--json` when a programmatic consumer needs its four deterministic projections:\n`intention`, `observation`, `actions`, and `response`. Actions are side effects\nalready attempted; future work belongs only to `response.nextSteps`. Default\nMarkdown renders only the self-contained response instead of exposing the\ninternal projections. For pre-commit validation, run\n`silvermoon check --staged`: unlike the default `check` (committed `HEAD`), it\nchecks the index and exits `0` only when the project snapshot is valid. See the\n[Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/reference.md) for validation targets and exit\ncodes.\n\nAdd `--trace <file.trace.jsonl>` to any command to write one schema-versioned\nJSONL timeline. Its `domain` channel contains allowlisted message summaries,\nand its `telemetry` channel contains paired performance spans; both share one\ntrace ID and global sequence. Trace output never includes guidance or file\ncontent, Git arguments/output, environment data, or credentials. If the\nargument does not end with the exact lowercase `.trace.jsonl` suffix,\nSilvermoon appends it. Repository-local `*.trace.jsonl` files are ignored.\nTrace files are buffered, created only after command work completes, and never\noverwrite an existing file.\n\nProjects may optionally add `.silvermoon/guidance/preparing.md`,\n`implementing.md`, and `deploying.md`. Silvermoon returns only the current\nactionable phase's snapshot-bound, repository-owned Markdown in\n`response.guidance`; `observation.guidance` carries its provenance without\ncontent. `create-idea` can return preparing guidance. This guidance is\nadditive, never a fourth contract or decision fact, and `check` validates the\ncomplete fixed directory. See [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/core-concepts.md).\n\n## Why Silvermoon\n\nLong-running Agent work usually asks people to carry too much invisible state.\nSomeone must remember what was intended, whether the code still matches the\ntask, and which conversation or machine knows the latest truth. Silvermoon\nmakes those concerns part of the project instead.\n\nIt lets people step back from continuous supervision and return at the\ndecisions that belong to them: approving the intended outcome, accepting the\nimplementation, and accepting that the result is true in the outside world.\nBetween those boundaries, an Agent can inspect repository facts and continue\nthe highest-priority safe action.\n\nIt also refuses to let a detached task card declare success. Current artifacts\nand explicit decisions jointly determine state, so a changed goal or\nimplementation naturally invalidates conclusions that depended on the older\nrevision. Because those facts live in Git, work can continue across devices,\nsessions, Agents, and hosting platforms.\n\n## The Project's Artifact Spirit\n\n> Fellow Daoist, you wouldn't want your lifebound project to be without an\n> artifact spirit, would you?\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@fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/assets/silvermoon-avatar.svg\" width=\"128\" alt=\"Line 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 split souls of Ling Long. After losing\n      part of her memory in the human realm, she lives as an artifact spirit\n      first in a wolf-headed jade scepter and later in Han Li's Bamboo\n      Cloudswarm Swords.\n      <br><br>\n      That image fits this project: Silvermoon does not belong to one operator\n      or one chat. It lives with the project's artifacts, understands their\n      state, and helps each companion find what comes next. The biography is\n      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 through three nested worlds.\n\n**Ideal World (道心)** names the outcome worth pursuing. **Inner World (内景)**\ngives that intent shape in repository artifacts. **Outer World (现世)** asks\nwhether the shaped work is true where it must actually operate.\n\n> 道心立意，内景成形，现世验真。\n\nThe worlds nest from the inside out. Implementation contains the ideal it\nserves, and deployment contains both. This is an engineering relationship, not\njust a metaphor: when an inner world changes, conclusions from an outer world\nno longer have the same foundation and must be proven again.\n\nHumans own approval and acceptance. Agents own continuation: they read the\ncontracts, the ledger, and Git facts; preserve concurrent work; execute one\nsafe action; and reobserve only after something changes. The context belongs to\nthe project, not to a fleeting conversation.\n\n## Further Reading\n\n- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/getting-started.md) — installation, configuration,\n  and the first idea.\n- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/core-concepts.md) — project ownership, the three\n  worlds, revisions, and decision boundaries.\n- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/operations.md) — navigation, creation,\n  publication, hygiene, and continuation.\n- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/reference.md) — storage, derived state, CLI\n  reports, validation targets, and schemas.\n- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/fcc881a6a5e7b7f2aad283f3b151a4c15fd6f400/docs/maintaining.md) — development checks,\n  documentation ownership, and release guidance.\n",
+  "gitHead": "27700c428509c3152d5eb96e90a8e1a4a150c6cb",
+  "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@27700c428509c3152d5eb96e90a8e1a4a150c6cb/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/unpacked-size/silvermoon?style=flat-square\" alt=\"npm unpacked size\"></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/27700c428509c3152d5eb96e90a8e1a4a150c6cb/README.zh-CN.md\">简体中文</a>\n</p>\n\n# Silvermoon\n\n**The artifact spirit of the project.**\n\n## Quick Start\n\nSilvermoon needs Node.js 22 or newer and Git access to the repository's primary\nbranch.\n\n```sh\nnpm install --global silvermoon\nsilvermoon whats-next\nsilvermoon list-ideas\n```\n\nSilvermoon is ecosystem-neutral: the target repository does not need\n`package.json`, a package manager, a Silvermoon dependency, or `node_modules`.\nThe first report lists every applicable setup step in order, including the\nexact `npx skills add ... --agent universal` command that registers the\ncanonical skill at `.agents/skills/silvermoon`.\n\nCreate `.silvermoon/config.yaml`:\n\n```yaml\nversion: 1\nprimaryRepository: https://github.com/example/repository.git\nprimaryBranch: main\npreferredLanguage: en\n```\n\n`preferredLanguage` is optional. A specific idea can override it with\n`language` in `status.yaml`, and `create-idea --language <tag>` can set that\noverride when the idea is created. Otherwise Silvermoon checks\n`~/.config/silvermoon/config.yaml` and finally defaults to `en-US`.\nThese stored values choose the language for project-owned content. To change\nonly one command's built-in output, use `whats-next --language en-US|zh-CN` or\n`check --language en-US|zh-CN`; the temporary override is never persisted.\n\nUse `list-ideas` when you only need the current local inventory. It defaults to\nactive ideas and supports repeatable `--state`, `--all`, literal `--query`,\nRFC 3339 `--created-since` / `--created-before`, `--sort`, and `--limit`.\nUnlike lifecycle navigation, this read-only query uses the valid worktree\nsnapshot without checking branch, upstream, cleanliness, network, or primary\nsynchronization.\n\nThen create an idea and let the registered Silvermoon skill guide one safe\nnext action at a time:\n\n```sh\nsilvermoon create-idea\nsilvermoon whats-next <idea>\nsilvermoon whats-next <idea> --language zh-CN\n```\n\nDescribe the desired world in the generated `Idea.md`, review it, and approve\nthat exact revision. From then on, Silvermoon keeps the goal, implementation,\nrepository state, and real-world result connected. See\n[Getting Started](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/getting-started.md) for the complete first workflow.\nEvery command processes one ordered, versioned domain-message stream. Add\n`--json` when a programmatic consumer needs its four deterministic projections:\n`intention`, `observation`, `actions`, and `response`. Actions are side effects\nalready attempted; future work belongs only to `response.nextSteps`. Default\nMarkdown renders only the self-contained response instead of exposing the\ninternal projections. For pre-commit validation, run\n`silvermoon check --staged`: unlike the default `check` (committed `HEAD`), it\nchecks the index and exits `0` only when the project snapshot is valid. See the\n[Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/reference.md) for validation targets and exit\ncodes.\n\nAdd `--trace <file.trace.jsonl>` to any command to write one schema-versioned\nJSONL timeline. Its `domain` channel contains allowlisted message summaries,\nand its `telemetry` channel contains paired performance spans; both share one\ntrace ID and global sequence. Trace output never includes guidance or file\ncontent, Git arguments/output, environment data, or credentials. If the\nargument does not end with the exact lowercase `.trace.jsonl` suffix,\nSilvermoon appends it. Repository-local `*.trace.jsonl` files are ignored.\nTrace files are buffered, created only after command work completes, and never\noverwrite an existing file.\n\nProjects may optionally add `.silvermoon/guidance/preparing.md`,\n`implementing.md`, and `deploying.md`. Silvermoon returns only the current\nactionable phase's snapshot-bound, repository-owned Markdown in\n`response.guidance`; `observation.guidance` carries its provenance without\ncontent. `create-idea` can return preparing guidance. This guidance is\nadditive, never a fourth contract or decision fact, and `check` validates the\ncomplete fixed directory. See [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/core-concepts.md).\n\n## Why Silvermoon\n\nLong-running Agent work usually asks people to carry too much invisible state.\nSomeone must remember what was intended, whether the code still matches the\ntask, and which conversation or machine knows the latest truth. Silvermoon\nmakes those concerns part of the project instead.\n\nIt lets people step back from continuous supervision and return at the\ndecisions that belong to them: approving the intended outcome, accepting the\nimplementation, and accepting that the result is true in the outside world.\nBetween those boundaries, an Agent can inspect repository facts and continue\nthe highest-priority safe action.\n\nIt also refuses to let a detached task card declare success. Current artifacts\nand explicit decisions jointly determine state, so a changed goal or\nimplementation naturally invalidates conclusions that depended on the older\nrevision. Because those facts live in Git, work can continue across devices,\nsessions, Agents, and hosting platforms.\n\n## The Project's Artifact Spirit\n\n> Fellow Daoist, you wouldn't want your lifebound project to be without an\n> artifact spirit, would you?\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@27700c428509c3152d5eb96e90a8e1a4a150c6cb/assets/silvermoon-avatar.svg\" width=\"128\" alt=\"Line 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 split souls of Ling Long. After losing\n      part of her memory in the human realm, she lives as an artifact spirit\n      first in a wolf-headed jade scepter and later in Han Li's Bamboo\n      Cloudswarm Swords.\n      <br><br>\n      That image fits this project: Silvermoon does not belong to one operator\n      or one chat. It lives with the project's artifacts, understands their\n      state, and helps each companion find what comes next. The biography is\n      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 through three nested worlds.\n\n**Ideal World (道心)** names the outcome worth pursuing. **Inner World (内景)**\ngives that intent shape in repository artifacts. **Outer World (现世)** asks\nwhether the shaped work is true where it must actually operate.\n\n> 道心立意，内景成形，现世验真。\n\nThe worlds nest from the inside out. Implementation contains the ideal it\nserves, and deployment contains both. This is an engineering relationship, not\njust a metaphor: when an inner world changes, conclusions from an outer world\nno longer have the same foundation and must be proven again.\n\nHumans own approval and acceptance. Agents own continuation: they read the\ncontracts, the ledger, and Git facts; preserve concurrent work; execute one\nsafe action; and reobserve only after something changes. The context belongs to\nthe project, not to a fleeting conversation.\n\n## Further Reading\n\n- [Getting Started](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/getting-started.md) — installation, configuration,\n  and the first idea.\n- [Core Concepts](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/core-concepts.md) — project ownership, the three\n  worlds, revisions, and decision boundaries.\n- [Operating Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/operations.md) — navigation, creation,\n  publication, hygiene, and continuation.\n- [Technical Reference](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/reference.md) — storage, derived state, CLI\n  reports, validation targets, and schemas.\n- [Maintaining Silvermoon](https://github.com/shazhou-ww/silvermoon/blob/27700c428509c3152d5eb96e90a8e1a4a150c6cb/docs/maintaining.md) — development checks,\n  documentation ownership, and release guidance.\n",
   "readmeFilename": "README.md"
 }