silvermoon 0.1.0 → 0.1.1

package/docs/npm-package-releases.md

@@ -92,13 +92,24 @@ The [`publish-npm.yml`](../.github/workflows/publish-npm.yml) workflow then:
 1. verifies the tagged commit is reachable from refreshed `origin/main`;
 2. installs the frozen pnpm dependencies;
 3. runs the allowlisted release planner and confirms the version is absent
-   from npm;
+   from npm, or records that an exact-version rerun must skip publication;
 4. runs `pnpm test:unit`, `pnpm test:contract`, `pnpm test:integration`, and
    `pnpm check:skills`;
-5. runs the selected package's `npm run pack:check` and
-   `npm run test:e2e`; and
-6. publishes only the selected directory with provenance and the derived npm
-   dist-tag.
+5. creates an isolated `git archive` staging tree and generates commit-pinned
+   English and Chinese package READMEs without changing the tagged checkout;
+6. creates one tarball, records its path, SHA-256, npm shasum, registry
+   integrity, and complete file list, then passes that same file to
+   `npm run pack:check` and `npm run test:e2e`;
+7. publishes that exact tarball with provenance and the derived npm dist-tag
+   when the version was absent; and
+8. runs `verify-npm-release.mjs` until the registry is consistent or the
+   bounded retry window expires.
+
+The post-publication verifier requires the exact version and dist-tag, registry
+integrity and tarball bytes, package-level README, both tarball READMEs, npm
+publish and SLSA provenance attestations, tagged Git commit, and commit-pinned
+jsDelivr SVG responses to match the candidate. A successful run prints
+`VERIFY_NPM_RELEASE_OK` with the verified identities.
 
 Release runs are serialized within this repository. The registry preflight and
 `npm publish` cannot form one cross-system transaction, so an external
@@ -110,13 +121,20 @@ duplicate publication without replacing the existing version.
 Publication stops before `npm publish` when the tag is malformed, the release
 key is unknown, the package is private, the package name or version differs
 from the mapping and tag, the npm publish configuration is not public npmjs,
-the commit is outside `origin/main`, the version already exists, registry state
-cannot be verified, or validation fails.
+the commit is outside `origin/main`, registry state cannot be observed, or
+validation fails. If the exact version already exists during a workflow rerun,
+the publish step is skipped and the verifier must prove that registry content
+is byte-identical to the rebuilt candidate and carries the expected provenance.
+Any mismatch is a hard failure.
 
 For a transient GitHub or registry failure before publication, rerun the same
 workflow run. Do not move or recreate the tag. For a source, manifest, or
 validation failure, make a new commit on `main`, choose a new version, and push
 a new tag after the fix is merged. npm versions and release tags are immutable.
+For a transient verification failure after publication, rerun only the failed
+workflow job when GitHub offers that option; the planner recognizes the
+existing version, skips `npm publish`, and performs the same complete
+verification again.
 
 ## Add another package
 

package/docs/operations.md

@@ -9,6 +9,7 @@ publishing Silvermoon ideas.
 npx silvermoon whats-next
 npx silvermoon whats-next 01M36QGPNTXEPP61DA4KP4AVZF
 npx silvermoon whats-next publish-documentation --json
+npx silvermoon whats-next publish-documentation --language zh-CN
 ```
 
 Without a selector, Silvermoon asks for a choice among multiple active ideas,
@@ -17,10 +18,13 @@ one, or many active ideas: only a selector chooses work. Completed and abandoned
 ideas are excluded from default candidates. A selector is either a canonical
 uppercase ULID or an exact, unique, case-sensitive alias.
 
-The shared observation includes a resolved non-empty `preferredLanguage`.
-Instructions use it for world entries, same-world supporting artifacts, the
-ledger, and user-facing explanations. Commands, identifiers, schema fields,
-protocol markers, and verbatim tool output retain their original form.
+The shared observation exposes the resolved content preference as
+`configuration.preferredLanguage` and the built-in rendering locale as
+`outputLanguage`. Instructions use the content preference for world entries,
+same-world supporting artifacts, and the ledger. A caller may use
+`--language en-US|zh-CN` to override only Silvermoon-owned output for one
+`whats-next` invocation. Commands, identifiers, schema fields, protocol
+markers, and verbatim tool output retain their original form.
 
 Every invocation follows three strict layers. It first checks Git,
 configuration compatibility, and `.agents/skills/silvermoon`. It then checks
@@ -48,10 +52,12 @@ require local HEAD to be aligned with the remote tip. Its preparation reports
 omit the active-idea inventory because existing work does not replace explicit
 creation intent.
 
-`--language` is the only command-level language override. It normalizes a valid
-BCP 47 tag and writes it to the new idea's `status.yaml`. Without the option,
-creation writes no language field and the idea dynamically inherits project,
-user, or `en-US` defaults. `whats-next` and `check` do not accept the option.
+For `create-idea`, `--language` normalizes any valid BCP 47 tag and writes it
+to the new idea's `status.yaml` as a persistent content-language preference.
+Without the option, creation writes no language field and the idea dynamically
+inherits project, user, or `en-US` defaults. This is distinct from the
+non-persistent `en-US|zh-CN` output override accepted by `whats-next` and
+`check`.
 
 The generated files remain untracked for review. Complete `Idea.md`, optionally
 add a concise unique alias, inspect every path, and publish the initial idea
@@ -79,7 +85,8 @@ diff. Preserve unknown and concurrent work. Never force-push, use
 `reset --hard`, broadly clean the worktree, or silently rewrite history.
 
 After an observable change, run `whats-next` again. Do not poll an unchanged
-observation.
+observation. When the invocation used `--language`, every generated retry
+command preserves the same canonical output-language option.
 
 ## Author World Contracts
 
@@ -115,6 +122,7 @@ Validate the complete candidate:
 
 ```sh
 silvermoon check --worktree
+silvermoon check --worktree --language zh-CN
 git add .silvermoon/ideas/<ULID>/status.yaml
 silvermoon check --staged
 ```
@@ -129,6 +137,10 @@ means the chosen project snapshot is valid; `1` means invalid or unavailable
 and must block the commit; `2` means invalid CLI usage. Do not treat the
 existence of a report as permission to commit.
 
+`check --language en-US|zh-CN` changes only Silvermoon-owned report framing.
+It is orthogonal to every check target and never changes the selected snapshot,
+validation conclusion, problems, or exit status.
+
 `check` does not infer that a status field was newly written, prove who
 authorized it, compare it with a commit parent, or search history for its
 origin. Those are workflow responsibilities: match an explicit human decision

package/docs/reference.md

@@ -67,13 +67,21 @@ world revision and does not change lifecycle decisions. Explicit
 `abandoned: false`, derived state, criteria mirrors, source locators, unknown
 keys, YAML aliases or anchors, comments, and noncanonical YAML are rejected.
 
-Effective language resolves as `idea language > project preferredLanguage >
-user preferredLanguage > en-US`. Every complete observation exposes the
-resolved non-empty tag as `configuration.preferredLanguage`. Missing idea
-language remains dynamically inherited and is never written back. Dialogue
-project status presents this effective value as `interaction language`
-(`交互语言`), meaning the language Silvermoon should use to interact with the
-user rather than a programming language used by the project.
+Effective content language resolves as `idea language > project
+preferredLanguage > user preferredLanguage > en-US`. Every complete
+observation exposes the resolved non-empty tag as
+`configuration.preferredLanguage`. Missing idea language remains dynamically
+inherited and is never written back. Dialogue project status presents this
+effective value as `content language` (`内容语言`).
+
+Every command observation also exposes an independent `outputLanguage`.
+Silvermoon's built-in output locales are exactly `en-US` and `zh-CN`.
+`whats-next --language <tag>` and `check --language <tag>` normalize casing
+before enforcing that allowlist, apply only to the current invocation, and
+take display precedence over content language. Without an explicit output
+override, content tags beginning with `zh` select `zh-CN`; every other content
+tag selects `en-US`. Output selection never writes configuration or idea
+status.
 
 State is derived in order:
 
@@ -88,9 +96,9 @@ State is derived in order:
 ## Public Commands
 
 ```sh
-silvermoon whats-next [idea] [--trace <file.trace.jsonl>]
+silvermoon whats-next [idea] [--language <en-US|zh-CN>] [--trace <file.trace.jsonl>]
 silvermoon create-idea [--language <tag>] [--trace <file.trace.jsonl>]
-silvermoon check [--remote | --commit <revision> | --staged | --worktree] [--trace <file.trace.jsonl>]
+silvermoon check [--remote | --commit <revision> | --staged | --worktree] [--language <en-US|zh-CN>] [--trace <file.trace.jsonl>]
 ```
 
 `whats-next` and `create-idea` build one dialogue envelope:
@@ -100,19 +108,24 @@ silvermoon check [--remote | --commit <revision> | --staged | --worktree] [--tra
   "intention": {
     "command": "whats-next",
     "args": {
-      "idea": null
+      "idea": null,
+      "language": null
     }
   },
-  "observation": {},
+  "observation": {
+    "outputLanguage": "en-US"
+  },
   "outcomes": [],
   "instructions": ""
 }
 ```
 
-- `intention` contains the command and normalized business arguments. Output
-  format is not part of the intention.
+- `intention` contains the command and normalized business arguments. For
+  `whats-next` and `check`, `args.language` is the canonical temporary output
+  override or `null`. Output format is not part of the intention.
 - `observation` describes the reliable facts for the requested command and
-  intent, not a mandatory global idea inventory.
+  intent, not a mandatory global idea inventory. `outputLanguage` is present
+  even when Git, configuration, or a requested snapshot is unavailable.
 - `outcomes` records only high-level repository side effects actually
   attempted by this invocation. Each item has `type`, `status` (`success` or
   `failure`), and `summary`. An empty array means no side effect was attempted.
@@ -150,7 +163,11 @@ stdout, or stderr. The path is relative to the caller's working directory when
 not absolute. Events are buffered so a trace inside the repository cannot
 affect that invocation's worktree observation. The file is written after the
 measured command work finishes and uses exclusive creation, so an existing
-normalized target is never overwritten.
+normalized target is never overwritten. The top command span records the
+canonical output-language override or `null` for `whats-next` and `check`.
+
+Unsupported output locales, empty values, and invalid BCP 47 tags are usage
+errors with exit status `2`, before repository inspection or fetch.
 
 Observations are discriminated by command intent and `state`:
 
@@ -198,9 +215,9 @@ to discuss and run `create-idea`.
 `create-idea` requires the configured primary branch and upstream plus a clean
 worktree, then creates one canonical scaffold. It does not fetch, compare
 remote ancestry, or require local HEAD to match the remote tip. Its optional
-language override is normalized before preflight and is the only command
-override; without it the status remains dynamically inherited. It does not
-stage, commit, push, or record approval.
+content-language choice accepts any canonical BCP 47 tag, is normalized before
+preflight, and is persisted to the new idea; without it the status remains
+dynamically inherited. It does not stage, commit, push, or record approval.
 
 ## Validation Targets
 
@@ -233,12 +250,16 @@ Unlike dialogue commands, `check --json` contains **only** `intention` and
 {
   "intention": {
     "command": "check",
-    "args": { "target": { "type": "staged" } }
+    "args": {
+      "target": { "type": "staged" },
+      "language": null
+    }
   },
   "observation": {
     "state": "project-ready",
     "root": "D:\\Code\\silvermoon",
     "version": { "type": "staged" },
+    "outputLanguage": "en-US",
     "configuration": {
       "primaryRepository": "https://example.com/owner/repository.git",
       "primaryBranch": "main",
@@ -267,6 +288,10 @@ Unlike dialogue commands, `check --json` contains **only** `intention` and
 reports `commit: null` and a problem. Staged and worktree versions only
 contain `type`.
 
+`--language en-US|zh-CN` is orthogonal to every target. It changes only
+Silvermoon-owned natural-language framing and leaves the target, snapshot,
+validation state, problems, and exit status unchanged.
+
 The `check` observation has its own discriminated states:
 
 - `project-ready` has root, version, resolved configuration, idea summary,

package/docs/repository-tasks.md

@@ -11,8 +11,10 @@ optional transport and are not protocol state.
 
 ```sh
 silvermoon whats-next [idea]
+silvermoon whats-next [idea] --language zh-CN
 silvermoon create-idea
 silvermoon check
+silvermoon check --language en-US
 silvermoon check --worktree
 silvermoon check --staged
 silvermoon check --commit HEAD
@@ -33,6 +35,13 @@ HEAD to match the remote tip. If hygiene blocks explicit creation, perform only
 that blocking action and then retry `create-idea` so active-idea selection
 cannot replace the pending create intent.
 
+Use `--language en-US|zh-CN` with `whats-next` or `check` only when the user
+explicitly requests a temporary output locale. Preserve the canonical option
+on every hygiene retry. It never changes the content language recorded in
+project, user, or idea configuration. `create-idea --language <tag>` remains a
+separate persistent content-language choice and accepts any canonical BCP 47
+tag.
+
 ## Decisions And Publication
 
 `whats-next` may fetch after local readiness passes, but it does not move the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "silvermoon",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "The project spirit that checks repository state and answers what's next.",
   "packageManager": "pnpm@11.22.0",
   "type": "module",

package/skills/silvermoon/SKILL.md

@@ -19,6 +19,10 @@ repository or external actions with ordinary tools and Git.
 - Bare `whats-next` lists active ideas and offers creation, even when exactly one idea is active.
   Never infer selection; require an explicit ULID or alias.
 - Use `--json` only when a programmatic consumer needs the envelope.
+- Use `--language en-US|zh-CN` with `whats-next` or `check` only when the user
+  explicitly requests a temporary output locale. Preserve the same canonical
+  option in every hygiene retry. It changes Silvermoon-owned rendering for
+  that invocation only, never project or idea content language.
 - Treat each command's `intention`, `observation`, `outcomes`, and `instructions`
   as one report. Read every problem and all ordered instructions; never combine
   reports.
@@ -73,8 +77,9 @@ review; never ask for approval of unpublished content. Publication is not
 approval and must not change `status.yaml`.
 
 An Agent may derive a concise, unique alias; do not ask for a name solely for
-the alias. Pass `--language <tag>` only when the user explicitly requests a
-stable language override. Do not use that option with `whats-next` or `check`.
+the alias. Pass `create-idea --language <tag>` only when the user explicitly
+requests a stable content-language override. Unlike the temporary output
+override, creation accepts any canonical BCP 47 tag and persists it.
 
 ## Continue The Selected Idea
 

package/src/cli.js

@@ -6,7 +6,10 @@ import {
   Option,
 } from "commander";
 
-import { canonicalizeLanguageTag } from "./language.js";
+import {
+  canonicalizeLanguageTag,
+  canonicalizeOutputLanguage,
+} from "./language.js";
 import { renderCheck, renderDialogue } from "./dialogue.js";
 import { checkRepository } from "./index.js";
 import { createIdea } from "./create-idea.js";
@@ -51,7 +54,7 @@ export function render(report, json, io) {
   );
 }
 
-function languageArgument(value) {
+function contentLanguageArgument(value) {
   try {
     return canonicalizeLanguageTag(value);
   } catch (caught) {
@@ -59,6 +62,14 @@ function languageArgument(value) {
   }
 }
 
+function outputLanguageArgument(value) {
+  try {
+    return canonicalizeOutputLanguage(value);
+  } catch (caught) {
+    throw new InvalidArgumentError(caught.message);
+  }
+}
+
 export function createProgram(io = console) {
   const program = new Command();
   program
@@ -79,10 +90,12 @@ export function createProgram(io = console) {
 Examples:
   $ silvermoon whats-next
   $ silvermoon whats-next <idea>
+  $ silvermoon whats-next <idea> --language zh-CN
   $ silvermoon whats-next <idea> --json
   $ silvermoon whats-next <idea> --trace whats-next.trace.jsonl
   $ silvermoon create-idea
   $ silvermoon check
+  $ silvermoon check --language en-US
   $ silvermoon check --worktree
   $ silvermoon check --staged
   $ silvermoon check --commit HEAD
@@ -91,13 +104,26 @@ Examples:
   addCommonOptions(
     program
       .command("whats-next [idea]")
-      .description("observe project, repository, and idea readiness"),
+      .description("observe project, repository, and idea readiness")
+      .option(
+        "--language <tag>",
+        "use a built-in output language (en-US or zh-CN) for this invocation",
+        outputLanguageArgument,
+      ),
   ).action(async (idea, options) => {
     const report = await withTraceFile(
       options.trace,
       "command.whats-next",
-      { command: "whats-next", processId: process.pid },
-      () => whatsNext({ idea, root: options.root }),
+      {
+        command: "whats-next",
+        outputLanguage: options.language ?? null,
+        processId: process.pid,
+      },
+      () => whatsNext({
+        idea,
+        language: options.language,
+        root: options.root,
+      }),
     );
     render(report, options.json, io);
     program.setOptionValue("resultCode", 0);
@@ -109,14 +135,18 @@ Examples:
       .description("create one structured idea scaffold after readiness checks")
       .option(
         "--language <tag>",
-        "persist a canonical language override on the new idea",
-        languageArgument,
+        "persist a canonical content language override on the new idea",
+        contentLanguageArgument,
       ),
   ).action(async (options) => {
     const report = await withTraceFile(
       options.trace,
       "command.create-idea",
-      { command: "create-idea", processId: process.pid },
+      {
+        command: "create-idea",
+        contentLanguage: options.language ?? null,
+        processId: process.pid,
+      },
       () => createIdea({
         language: options.language,
         root: options.root,
@@ -130,6 +160,11 @@ Examples:
     program
       .command("check")
       .description("validate Silvermoon configuration and idea state")
+      .option(
+        "--language <tag>",
+        "use a built-in output language (en-US or zh-CN) for this invocation",
+        outputLanguageArgument,
+      )
       .addOption(new Option("--remote", "fetch and validate the configured primary tip").conflicts(["commit", "staged", "worktree"]))
       .addOption(new Option("--commit <revision>", "validate one local commit snapshot").conflicts(["remote", "staged", "worktree"]))
       .addOption(new Option("--staged", "validate the index snapshot").conflicts(["remote", "commit", "worktree"]))
@@ -138,9 +173,14 @@ Examples:
     const report = await withTraceFile(
       options.trace,
       "command.check",
-      { command: "check", processId: process.pid },
+      {
+        command: "check",
+        outputLanguage: options.language ?? null,
+        processId: process.pid,
+      },
       () => checkRepository({
         commit: options.commit,
+        language: options.language,
         remote: options.remote,
         root: options.root,
         staged: options.staged,

package/src/create-idea.js

@@ -194,7 +194,7 @@ export async function createIdea({
       projectInstructions(
         observed,
         observed.observation.root,
-        observed.language,
+        observed.outputLanguage,
         recheckCommand,
       ),
     );
@@ -243,7 +243,7 @@ export async function createIdea({
       observation: readiness.observation,
       outcomes,
       cleanup: caught.cleanup,
-      language: observed.language,
+      language: observed.outputLanguage,
     });
   }
 
@@ -270,7 +270,7 @@ export async function createIdea({
         observation: readiness.observation,
         outcomes,
         cleanup,
-        language: observed.language,
+        language: observed.outputLanguage,
       });
     }
 
@@ -318,7 +318,7 @@ export async function createIdea({
         "create-idea-scaffold",
         "success",
         localize(
-          observed.language,
+          observed.outputLanguage,
           `Created idea ${id} at ${paths.ideaPath}.`,
           `已在 ${paths.ideaPath} 创建 idea ${id}。`,
         ),
@@ -330,9 +330,9 @@ export async function createIdea({
         }),
         outcomes,
         localize(
-          observed.language,
-          `Use ${observed.language} for natural-language content while describing the requested Ideal World in ${paths.ideaDocumentPath}; keep the stable IDs and placeholders in ${paths.implementationDocumentPath}, ${paths.deploymentDocumentPath}, and ${paths.ledgerPath} synchronized.`,
-          `使用 ${observed.language} 在 ${paths.ideaDocumentPath} 中描述请求的理想契约，并保持 ${paths.implementationDocumentPath}、${paths.deploymentDocumentPath} 与 ${paths.ledgerPath} 中的稳定 ID 和占位同步。`,
+          observed.outputLanguage,
+          `Use ${observed.contentLanguage} for natural-language content while describing the requested Ideal World in ${paths.ideaDocumentPath}; keep the stable IDs and placeholders in ${paths.implementationDocumentPath}, ${paths.deploymentDocumentPath}, and ${paths.ledgerPath} synchronized.`,
+          `使用 ${observed.contentLanguage} 在 ${paths.ideaDocumentPath} 中描述请求的理想契约，并保持 ${paths.implementationDocumentPath}、${paths.deploymentDocumentPath} 与 ${paths.ledgerPath} 中的稳定 ID 和占位同步。`,
         ),
       );
     } catch (caught) {
@@ -365,7 +365,7 @@ export async function createIdea({
         observation: readiness.observation,
         outcomes,
         cleanup,
-        language: observed.language,
+        language: observed.outputLanguage,
       });
     }
   }
@@ -379,6 +379,6 @@ export async function createIdea({
     observation: readiness.observation,
     outcomes,
     cleanup,
-    language: observed.language,
+    language: observed.outputLanguage,
   });
 }

package/src/dialogue.js

@@ -1,3 +1,8 @@
+import {
+  DEFAULT_LANGUAGE,
+  resolveOutputLanguage,
+} from "./language.js";
+
 const ACTIVE_STATES = new Set(["preparing", "implementing", "deploying"]);
 const IDEA_STATES = [
   "preparing",
@@ -71,11 +76,19 @@ export function createEnvelope(intention, observation, outcomes, instructions) {
 }
 
 export function dialogueReadyObservation(observation, state, details = {}) {
-  const { root, version, configuration, problems } = observation;
-  return { state, root, version, configuration, problems, ...details };
+  const { root, version, configuration, outputLanguage, problems } = observation;
+  return {
+    state,
+    root,
+    version,
+    configuration,
+    outputLanguage,
+    problems,
+    ...details,
+  };
 }
 
-function renderIntention(intention, language) {
+function renderIntention(intention, language, contentLanguage) {
   if (intention.command === "whats-next") {
     return intention.args.idea === null
       ? localize(
@@ -93,8 +106,8 @@ function renderIntention(intention, language) {
     return intention.args.language === null
       ? localize(
         language,
-        `Create one new idea and use ${language} for natural-language content.`,
-        `创建一个新 idea，并使用 ${language} 撰写自然语言内容。`,
+        `Create one new idea and use ${contentLanguage} for natural-language content.`,
+        `创建一个新 idea，并使用 ${contentLanguage} 撰写自然语言内容。`,
       )
       : localize(
         language,
@@ -198,7 +211,7 @@ function renderObservation(observation, language) {
       `- ${localize(language, "primary", "主仓库")}: ${codeSpan(`${observation.configuration.primaryRepository}#${observation.configuration.primaryBranch}`)}`,
     );
     lines.push(
-      `- ${localize(language, "interaction language", "交互语言")}: ${observation.configuration.preferredLanguage}`,
+      `- ${localize(language, "content language", "内容语言")}: ${observation.configuration.preferredLanguage}`,
     );
   }
   if (observation.ideas) {
@@ -240,9 +253,16 @@ function renderOutcomes(outcomes, language) {
 }
 
 export function renderDialogue(report) {
-  const language =
+  const contentLanguage =
     report.observation.configuration?.preferredLanguage
-    ?? "en-US";
+    ?? DEFAULT_LANGUAGE;
+  const language = report.observation.outputLanguage
+    ?? resolveOutputLanguage({
+      content: contentLanguage,
+      override: report.intention.command === "whats-next"
+        ? report.intention.args.language ?? undefined
+        : undefined,
+    }).tag;
   const visibleOutcomes = report.outcomes.filter((item) =>
     !(item.type === "fetch-primary"
       && item.status === "success"
@@ -252,7 +272,7 @@ export function renderDialogue(report) {
   const sections = [
     [
       localize(language, "Current instruction", "本次指示"),
-      renderIntention(report.intention, language),
+      renderIntention(report.intention, language, contentLanguage),
     ],
     [
       localize(language, "Project status", "项目现状"),
@@ -273,7 +293,11 @@ export function renderDialogue(report) {
 }
 
 export function renderCheck(report) {
-  const language = report.observation.configuration?.preferredLanguage ?? "en-US";
+  const language = report.observation.outputLanguage
+    ?? resolveOutputLanguage({
+      content: report.observation.configuration?.preferredLanguage,
+      override: report.intention.args.language ?? undefined,
+    }).tag;
   const { target } = report.intention.args;
   const version = renderVersion(report.observation.version);
   const label = target.type === "commit"