silvermoon 0.3.0-rc.2 → 0.4.0

package/dist/bin/run-checks.js

@@ -0,0 +1,149 @@
+import { spawn } from "node:child_process";
+import { performance } from "node:perf_hooks";
+import { resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+export const CHECK_SCRIPTS = Object.freeze([
+    "typecheck",
+    "build",
+    "lint:markdown",
+    "check:pure",
+    "check:quick",
+    "test:integration:built",
+    "pack:check:built",
+    "test:e2e:built",
+    "check:skills",
+]);
+export const CHECK_TIERS = Object.freeze({
+    sanity: Object.freeze(["typecheck", "build", "check:syntax", "check:pure", "test:sanity"]),
+    commit: Object.freeze([
+        "check:sanity",
+        "test:contract:built",
+        "lint:markdown",
+        "check:skills:local",
+        "test:smoke",
+        "check:staged",
+        "check:diff",
+    ]),
+    release: CHECK_SCRIPTS,
+});
+function isCheckTier(value) {
+    return value === "sanity" || value === "commit" || value === "release";
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function selectChecks(args) {
+    if (args.length === 0)
+        return CHECK_TIERS.release;
+    const tier = args[1];
+    if (args.length !== 2 || args[0] !== "--tier" || !tier || !isCheckTier(tier)) {
+        throw new Error("Usage: node bin/run-checks.ts [--tier sanity|commit|release]");
+    }
+    return CHECK_TIERS[tier];
+}
+export const COMMIT_SCOPE = "COMMIT_SCOPE: Tests validate the WORKTREE, not staged code. " +
+    "silvermoon check --staged validates only staged Silvermoon metadata. " +
+    "Partial staging is NOT exact-candidate test evidence; align index and worktree " +
+    "and rerun checks before claiming the staged code passed. No files are staged or changed.\n";
+const repositoryRoot = fileURLToPath(new URL("..", import.meta.url));
+export function packageManagerCommand(script, { env = process.env, execPath = process.execPath, platform = process.platform, } = {}) {
+    if (env.npm_execpath) {
+        if (platform === "win32" && /\.exe$/i.test(env.npm_execpath)) {
+            return {
+                command: env.npm_execpath,
+                args: ["run", script],
+            };
+        }
+        return {
+            command: execPath,
+            args: [env.npm_execpath, "run", script],
+        };
+    }
+    if (platform === "win32") {
+        return {
+            command: env.ComSpec ?? "cmd.exe",
+            args: ["/d", "/s", "/c", `npm run ${script}`],
+        };
+    }
+    return { command: "npm", args: ["run", script] };
+}
+export function runCheckScript(script, { cwd = repositoryRoot, env = process.env, spawnImpl = spawn, } = {}) {
+    const { command, args } = packageManagerCommand(script, { env });
+    return new Promise((resolve, reject) => {
+        process.stdout.write(`CHECK_START ${script}\n`);
+        const child = spawnImpl(command, args, {
+            cwd,
+            env,
+            stdio: "inherit",
+            windowsHide: true,
+        });
+        child.once("error", (error) => {
+            reject(new Error(`${script} could not start: ${error.message}`));
+        });
+        child.once("close", (code, signal) => {
+            if (code === 0) {
+                process.stdout.write(`CHECK_OK ${script}\n`);
+                resolve();
+                return;
+            }
+            const result = signal ? `signal ${signal}` : `exit code ${code}`;
+            reject(new Error(`${script} failed with ${result}`));
+        });
+    });
+}
+export async function runChecks({ scripts = CHECK_SCRIPTS, runScript = runCheckScript, now = () => performance.now(), writeOutput = (message) => process.stdout.write(message), } = {}) {
+    if (!Array.isArray(scripts) || scripts.length === 0
+        || scripts.some((script) => typeof script !== "string" || !script.trim())) {
+        throw new Error("Checks require a non-empty list of script names");
+    }
+    const totalStartedAt = now();
+    const runTimed = async (script) => {
+        const scriptStartedAt = now();
+        try {
+            await runScript(script);
+        }
+        finally {
+            const elapsedMs = Math.round(now() - scriptStartedAt);
+            writeOutput(`CHECK_DURATION ${script} ${elapsedMs}ms\n`);
+        }
+    };
+    const prerequisiteNames = new Set(["typecheck", "build"]);
+    const prerequisites = scripts.filter((script) => prerequisiteNames.has(script));
+    const parallel = scripts.filter((script) => !prerequisiteNames.has(script));
+    const entries = [];
+    for (const script of prerequisites) {
+        const [result] = await Promise.allSettled([runTimed(script)]);
+        if (result)
+            entries.push([script, result]);
+    }
+    const parallelResults = await Promise.allSettled(parallel.map((script) => runTimed(script)));
+    entries.push(...parallel.map((script, index) => [
+        script,
+        parallelResults[index],
+    ]));
+    const totalElapsedMs = Math.round(now() - totalStartedAt);
+    writeOutput(`CHECK_TOTAL ${totalElapsedMs}ms\n`);
+    const failures = entries.flatMap(([script, result]) => result.status === "rejected"
+        ? [`${script}: ${errorMessage(result.reason)}`]
+        : []);
+    if (failures.length > 0) {
+        throw new Error(`Checks failed:\n- ${failures.join("\n- ")}`);
+    }
+}
+export function isMain(importMetaUrl, argv = process.argv) {
+    return Boolean(argv[1] && importMetaUrl === pathToFileURL(resolve(argv[1])).href);
+}
+if (isMain(import.meta.url)) {
+    try {
+        const args = process.argv.slice(2);
+        const scripts = selectChecks(args);
+        if (args[1] === "commit")
+            process.stdout.write(COMMIT_SCOPE);
+        await runChecks({ scripts });
+    }
+    catch (error) {
+        process.stderr.write(`${errorMessage(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=run-checks.js.map

package/dist/bin/run-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-checks.js","sourceRoot":"","sources":["../../bin/run-checks.ts"],"names":[],"mappings":"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"}

package/dist/bin/silvermoon.d.ts

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { renderResponse } from "../src/foundation/renderer/index.ts";
+type Io = {
+    log: (message: unknown) => unknown;
+    error: (message: unknown) => unknown;
+};
+type Terminal = {
+    stdin: {
+        isTTY?: boolean;
+    };
+    stdout: {
+        isTTY?: boolean;
+    };
+};
+type CliOptions = {
+    afterDigest?: string;
+    afterLength?: number;
+    all?: boolean;
+    audience?: string;
+    commit?: string;
+    confirmDecision?: boolean;
+    createdBefore?: string;
+    createdSince?: string;
+    expectedDigest?: string;
+    expectedLength?: number;
+    expectedPrimary?: string;
+    fullHistory?: boolean;
+    input?: string;
+    json?: boolean;
+    language?: string;
+    limit?: string;
+    query?: string;
+    remote?: boolean;
+    root: string;
+    sort?: string;
+    staged?: boolean;
+    state?: string[];
+    trace?: string;
+    worktree?: boolean;
+};
+type Runtime = {
+    bootstrapStartedAt?: bigint;
+    renderTui?: (content: string, terminal: Terminal) => Promise<void>;
+    terminal?: Terminal;
+};
+type CommandReport = {
+    observation: {
+        state: string;
+        receipt?: {
+            reduction?: {
+                ok?: boolean;
+            };
+            format?: {
+                ok?: boolean;
+            };
+        };
+    };
+    response: Parameters<typeof renderResponse>[0];
+};
+export declare function normalizeTraceFileName(value: string): string;
+export declare function selectOutputRenderer({ audience, json, stdinIsTTY, stdoutIsTTY, }: {
+    audience?: string;
+    json?: boolean;
+    stdinIsTTY?: boolean;
+    stdoutIsTTY?: boolean;
+}): "json" | "markdown" | "tui";
+export declare function render(report: CommandReport, { audience, json }?: Pick<CliOptions, "audience" | "json">, io?: Io, { renderTui, terminal, }?: Runtime): Promise<void>;
+export declare function createProgram(io?: Io, runtime?: Runtime): Command;
+export declare function runCli(args: readonly string[], io?: Io, runtime?: Runtime): Promise<number>;
+export declare function isMain(importMetaUrl: string, argv?: readonly string[], { platform, realpath }?: {
+    platform?: NodeJS.Platform;
+    realpath?: (path: string) => string;
+}): boolean;
+export {};
+//# sourceMappingURL=silvermoon.d.ts.map

package/dist/bin/silvermoon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"silvermoon.d.ts","sourceRoot":"","sources":["../../bin/silvermoon.ts"],"names":[],"mappings":";AAIA,OAAO,EACL,OAAO,EAIR,MAAM,WAAW,CAAC;AAWnB,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAKrE,KAAK,EAAE,GAAG;IAAE,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAA;CAAE,CAAC;AACvF,KAAK,QAAQ,GAAG;IACd,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7B,CAAC;AACF,KAAK,UAAU,GAAG;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AACF,KAAK,OAAO,GAAG;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AACF,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE;YACR,SAAS,CAAC,EAAE;gBAAE,EAAE,CAAC,EAAE,OAAO,CAAA;aAAE,CAAC;YAC7B,MAAM,CAAC,EAAE;gBAAE,EAAE,CAAC,EAAE,OAAO,CAAA;aAAE,CAAC;SAC3B,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;CAChD,CAAC;AAmDF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI5D;AAqBD,wBAAgB,oBAAoB,CAAC,EACnC,QAAkB,EAClB,IAAY,EACZ,UAAkB,EAClB,WAAmB,GACpB,EAAE;IACD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAI9B;AAOD,wBAAsB,MAAM,CAC1B,MAAM,EAAE,aAAa,EACrB,EAAE,QAAkB,EAAE,IAAY,EAAE,GAAE,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAM,EAChF,EAAE,GAAE,EAAY,EAChB,EACE,SAA8B,EAC9B,QAA2D,GAC5D,GAAE,OAAY,GACd,OAAO,CAAC,IAAI,CAAC,CAkBf;AAoFD,wBAAgB,aAAa,CAAC,EAAE,GAAE,EAAY,EAAE,OAAO,GAAE,OAAY,GAAG,OAAO,CAwP9E;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,GAAE,EAAY,EAChB,OAAO,GAAE,OAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED,wBAAgB,MAAM,CACpB,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,SAAS,MAAM,EAAiB,EACtC,EAAE,QAA2B,EAAE,QAA8B,EAAE,GAAE;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC,GACL,OAAO,CAWT"}

package/dist/bin/silvermoon.js

@@ -0,0 +1,401 @@
+#!/usr/bin/env node
+import { readFileSync, realpathSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command, CommanderError, InvalidArgumentError, Option, } from "commander";
+import { canonicalizeLanguageTag, canonicalizeOutputLanguage, } from "../src/foundation/language/index.js";
+import { normalizeIdeaQuery } from "../src/foundation/idea-query/index.js";
+import { listIdeas } from "../src/business/index.js";
+import { checkRepository } from "../src/business/index.js";
+import { createIdea } from "../src/business/index.js";
+import { eventCommand } from "../src/business/index.js";
+import { renderResponse } from "../src/foundation/renderer/index.js";
+import { traceAsync, withTraceFile } from "../src/foundation/trace/index.js";
+import { writeTerminalLine } from "../src/foundation/terminal/index.js";
+import { whatsNext } from "../src/business/index.js";
+function listIdeasFromCli(options, sort) {
+    // The business annotation still names legacy sort values, but its runtime
+    // delegates to the foundation normalizer that produced this canonical value.
+    if (!Reflect.set(options, "sort", sort)) {
+        throw new Error("Could not configure the normalized idea sort order.");
+    }
+    return listIdeas(options);
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isCommandReport(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const observation = Reflect.get(value, "observation");
+    const response = Reflect.get(value, "response");
+    return typeof observation === "object" && observation !== null
+        && typeof Reflect.get(observation, "state") === "string"
+        && typeof response === "object" && response !== null;
+}
+const packageJsonUrl = new URL(import.meta.url.endsWith(".ts") ? "../package.json" : "../../package.json", import.meta.url);
+const manifest = JSON.parse(readFileSync(packageJsonUrl, "utf8"));
+const VERSION = typeof manifest === "object" && manifest !== null
+    ? Reflect.get(manifest, "version") : undefined;
+if (typeof VERSION !== "string") {
+    throw new Error("package.json version must be a string.");
+}
+const TRACE_FILE_SUFFIX = ".trace.jsonl";
+const AUDIENCES = ["human", "agent"];
+export function normalizeTraceFileName(value) {
+    return value.endsWith(TRACE_FILE_SUFFIX)
+        ? value
+        : `${value}${TRACE_FILE_SUFFIX}`;
+}
+function addCommonOptions(command) {
+    return command
+        .option("--json", "serialize all four command projections as JSON")
+        .addOption(new Option("--audience <audience>", "select human TUI or agent Markdown output (default: human)")
+        .choices(AUDIENCES)
+        .conflicts("json"))
+        .option("--trace <file.trace.jsonl>", "write domain and timing events as JSONL (suffix is appended when omitted)", normalizeTraceFileName)
+        .option("-r, --root <path>", "repository root", process.cwd());
+}
+export function selectOutputRenderer({ audience = "human", json = false, stdinIsTTY = false, stdoutIsTTY = false, }) {
+    if (json)
+        return "json";
+    if (audience === "human" && stdinIsTTY && stdoutIsTTY)
+        return "tui";
+    return "markdown";
+}
+async function defaultTuiRenderer(content, terminal) {
+    const { renderTuiMarkdown } = await import("../src/foundation/tui/index.js");
+    await Reflect.apply(renderTuiMarkdown, undefined, [content, terminal]);
+}
+export async function render(report, { audience = "human", json = false } = {}, io = console, { renderTui = defaultTuiRenderer, terminal = { stdin: process.stdin, stdout: process.stdout }, } = {}) {
+    const renderer = selectOutputRenderer({
+        audience,
+        json,
+        stdinIsTTY: terminal.stdin.isTTY === true,
+        stdoutIsTTY: terminal.stdout.isTTY === true,
+    });
+    if (renderer === "json") {
+        io.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    const markdown = renderResponse(report.response);
+    if (renderer === "tui") {
+        await renderTui(markdown, terminal);
+        return;
+    }
+    io.log(markdown);
+}
+function outputRenderer(options, runtime) {
+    const terminal = runtime.terminal ?? {
+        stdin: process.stdin,
+        stdout: process.stdout,
+    };
+    return selectOutputRenderer({
+        ...(options.audience === undefined ? {} : { audience: options.audience }),
+        ...(options.json === undefined ? {} : { json: options.json }),
+        stdinIsTTY: terminal.stdin.isTTY === true,
+        stdoutIsTTY: terminal.stdout.isTTY === true,
+    });
+}
+function bootstrapDuration(runtime) {
+    if (typeof runtime.bootstrapStartedAt !== "bigint")
+        return {};
+    const elapsed = process.hrtime.bigint() - runtime.bootstrapStartedAt;
+    return {
+        bootstrapDurationMs: Math.round(Number(elapsed) / 1_000) / 1_000,
+    };
+}
+async function runCommand({ attributes, execute, name, options, }, io, runtime) {
+    const renderer = outputRenderer(options, runtime);
+    const traceAttributes = {
+        ...attributes,
+        outputRenderer: renderer,
+        ...bootstrapDuration(runtime),
+    };
+    if (renderer === "tui") {
+        const report = await Reflect.apply(withTraceFile, undefined, [
+            options.trace, name, traceAttributes, execute,
+        ]);
+        if (!isCommandReport(report))
+            throw new Error(`${name} returned an invalid report.`);
+        await render(report, options, io, runtime);
+        return report;
+    }
+    const report = await Reflect.apply(withTraceFile, undefined, [
+        options.trace, name, traceAttributes, async () => {
+            const report = await execute();
+            if (!isCommandReport(report))
+                throw new Error(`${name} returned an invalid report.`);
+            await Reflect.apply(traceAsync, undefined, [
+                "output.render",
+                { renderer },
+                () => render(report, options, io, runtime),
+            ]);
+            return report;
+        },
+    ]);
+    if (!isCommandReport(report))
+        throw new Error(`${name} returned an invalid report.`);
+    return report;
+}
+function contentLanguageArgument(value) {
+    try {
+        return canonicalizeLanguageTag(value);
+    }
+    catch (caught) {
+        throw new InvalidArgumentError(errorMessage(caught));
+    }
+}
+function outputLanguageArgument(value) {
+    try {
+        return canonicalizeOutputLanguage(value);
+    }
+    catch (caught) {
+        throw new InvalidArgumentError(errorMessage(caught));
+    }
+}
+function collectOption(value, previous = []) {
+    return [...previous, value];
+}
+export function createProgram(io = console, runtime = {}) {
+    const program = new Command();
+    program
+        .name("silvermoon")
+        .description("Derive and validate repository-owned idea state.")
+        .version(VERSION, "-v, --version", "display the installed version")
+        .addHelpCommand(false)
+        .showHelpAfterError("(run with --help for usage)")
+        .showSuggestionAfterError()
+        .configureHelp({ sortOptions: true, sortSubcommands: true })
+        .configureOutput({
+        outputError: (value, output) => output(value),
+        writeErr: (value) => writeTerminalLine(io.error, value),
+        writeOut: (value) => writeTerminalLine(io.log, value),
+    })
+        .exitOverride()
+        .addHelpText("after", `
+Examples:
+  $ silvermoon list-ideas
+  $ silvermoon list-ideas --language zh-CN
+  $ silvermoon list-ideas --state completed --sort oldest --limit 10
+  $ silvermoon whats-next
+  $ silvermoon whats-next <idea>
+  $ silvermoon whats-next <idea> --language zh-CN
+  $ silvermoon whats-next <idea> --audience agent
+  $ 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
+  $ silvermoon check --remote`);
+    addCommonOptions(program
+        .command("list-ideas")
+        .description("query the current local idea inventory")
+        .option("--language <tag>", "use a built-in output language (en, en-US, zh, or zh-CN) for this invocation", outputLanguageArgument)
+        .option("--state <state>", "include a lifecycle state or active (repeatable)", collectOption)
+        .option("--all", "include all five lifecycle states")
+        .option("--query <text>", "match ID, alias, or title literally")
+        .option("--created-since <timestamp>", "include ideas created at or after an RFC 3339 timestamp")
+        .option("--created-before <timestamp>", "include ideas created before an RFC 3339 timestamp")
+        .option("--sort <order>", "sort by creation time: newest or oldest")
+        .option("--limit <count>", "return at most this positive number of ideas")).action(async (options) => {
+        const query = normalizeIdeaQuery({
+            all: options.all,
+            createdBefore: options.createdBefore,
+            createdSince: options.createdSince,
+            limit: options.limit,
+            query: options.query,
+            sort: options.sort,
+            states: options.state,
+        });
+        const report = await runCommand({
+            name: "command.list-ideas",
+            options,
+            attributes: {
+                command: "list-ideas",
+                hasQuery: query.query !== null,
+                outputLanguage: options.language ?? null,
+                stateCount: query.states.length,
+            },
+            execute: () => listIdeasFromCli({
+                ...(query.createdBefore === null
+                    ? {}
+                    : { createdBefore: query.createdBefore }),
+                ...(query.createdSince === null
+                    ? {}
+                    : { createdSince: query.createdSince }),
+                ...(options.language === undefined
+                    ? {}
+                    : { language: options.language }),
+                limit: query.limit,
+                ...(query.query === null ? {} : { query: query.query }),
+                root: options.root,
+                states: query.states,
+            }, query.sort),
+        }, io, runtime);
+        program.setOptionValue("resultCode", report.observation.state === "ideas-listed" ? 0 : 1);
+    });
+    addCommonOptions(program
+        .command("whats-next [idea]")
+        .description("observe project, repository, and idea readiness")
+        .option("--language <tag>", "use a built-in output language (en, en-US, zh, or zh-CN) for this invocation", outputLanguageArgument)).action(async (idea, options) => {
+        const report = await runCommand({
+            name: "command.whats-next",
+            options,
+            attributes: {
+                command: "whats-next",
+                outputLanguage: options.language ?? null,
+            },
+            execute: () => whatsNext({
+                ...(idea === undefined ? {} : { idea }),
+                ...(options.language === undefined
+                    ? {}
+                    : { language: options.language }),
+                root: options.root,
+            }),
+        }, io, runtime);
+        program.setOptionValue("resultCode", 0);
+    });
+    addCommonOptions(program
+        .command("create-idea")
+        .description("create one structured idea scaffold after readiness checks")
+        .option("--language <tag>", "persist a canonical content language override on the new idea", contentLanguageArgument)).action(async (options) => {
+        const report = await runCommand({
+            name: "command.create-idea",
+            options,
+            attributes: {
+                command: "create-idea",
+                contentLanguage: options.language ?? null,
+            },
+            execute: () => createIdea({
+                ...(options.language === undefined
+                    ? {}
+                    : { language: options.language }),
+                root: options.root,
+            }),
+        }, io, runtime);
+        program.setOptionValue("resultCode", 0);
+    });
+    addCommonOptions(program
+        .command("check")
+        .description("validate Silvermoon configuration and idea state")
+        .option("--language <tag>", "use a built-in output language (en, en-US, zh, 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"]))
+        .addOption(new Option("--worktree", "validate HEAD plus staged, unstaged, and untracked changes").conflicts(["remote", "commit", "staged"]))).action(async (options) => {
+        const report = await runCommand({
+            name: "command.check",
+            options,
+            attributes: {
+                command: "check",
+                outputLanguage: options.language ?? null,
+            },
+            execute: () => checkRepository({
+                ...(options.commit === undefined ? {} : { commit: options.commit }),
+                ...(options.language === undefined
+                    ? {}
+                    : { language: options.language }),
+                ...(options.remote === undefined ? {} : { remote: options.remote }),
+                root: options.root,
+                ...(options.staged === undefined ? {} : { staged: options.staged }),
+                ...(options.worktree === undefined
+                    ? {}
+                    : { worktree: options.worktree }),
+            }),
+        }, io, runtime);
+        program.setOptionValue("resultCode", report.observation.state === "project-ready" ? 0 : 1);
+    });
+    addCommonOptions(program.command("event <operation> [idea]")
+        .description("replay or append v2 idea events")
+        .option("--language <tag>", "use a built-in output language for this invocation", outputLanguageArgument)
+        .option("--input <file>", "JSON business request for append")
+        .option("--expected-length <bytes>", "observed log byte length", (value) => {
+        if (!/^(0|[1-9][0-9]*)$/.test(value) || !Number.isSafeInteger(Number(value))) {
+            throw new InvalidArgumentError("expected length must be a nonnegative safe integer");
+        }
+        return Number(value);
+    })
+        .option("--expected-digest <oid>", "observed canonical events-folder digest")
+        .option("--after-length <bytes>", "return only events after this observed byte cursor", (value) => {
+        if (!/^(0|[1-9][0-9]*)$/.test(value) || !Number.isSafeInteger(Number(value))) {
+            throw new InvalidArgumentError("after length must be a nonnegative safe integer");
+        }
+        return Number(value);
+    })
+        .option("--after-digest <oid>", "exact observed prefix folder digest for incremental replay")
+        .option("--full-history", "include complete historical reductions in an append receipt instead of the default summary")
+        .option("--expected-primary <commit>", "observed primary commit (never stored in events)")
+        .option("--confirm-decision", "assert an explicit human decision for this exact request")).action(async (operation, idea, options) => {
+        if (!["replay", "append"].includes(operation)
+            || !idea
+            || (operation === "append" && !options.input)
+            || (operation === "replay" && options.input)
+            || (operation !== "append" && options.fullHistory)
+            || ((options.afterLength !== undefined || options.afterDigest !== undefined)
+                && (operation !== "replay" || options.afterLength === undefined || options.afterDigest === undefined))
+            || (operation === "replay" && [
+                options.expectedLength, options.expectedDigest, options.expectedPrimary, options.confirmDecision,
+            ].some((value) => value !== undefined))) {
+            throw Object.assign(new Error("Use event replay|append <idea>; append requires --input."), { exitCode: 2 });
+        }
+        let input;
+        if (options.input) {
+            try {
+                input = JSON.parse(readFileSync(options.input, "utf8"));
+            }
+            catch (cause) {
+                throw Object.assign(new Error(`Cannot read business request: ${errorMessage(cause)}`), { exitCode: 2 });
+            }
+        }
+        const report = await runCommand({
+            name: "command.event", options, attributes: { command: "event", operation },
+            execute: () => eventCommand({ ...options, operation, idea, input }),
+        }, io, runtime);
+        const receipt = report.observation.receipt;
+        program.setOptionValue("resultCode", report.observation.state === "event-result"
+            && receipt !== undefined
+            && receipt.reduction?.ok !== false
+            && receipt.format?.ok !== false ? 0 : 1);
+    });
+    return program;
+}
+export async function runCli(args, io = console, runtime = {}) {
+    const program = createProgram(io, runtime);
+    try {
+        await program.parseAsync(args.length === 0 ? ["--help"] : args, { from: "user" });
+    }
+    catch (caught) {
+        if (caught instanceof CommanderError)
+            return caught.exitCode === 0 ? 0 : 2;
+        if (typeof caught === "object" && caught !== null && Reflect.get(caught, "exitCode") === 2) {
+            io.error(`ERROR usage: ${errorMessage(caught)}`);
+            return 2;
+        }
+        io.error(`ERROR command.failed: ${errorMessage(caught)}`);
+        return 1;
+    }
+    return program.getOptionValue("resultCode") ?? 0;
+}
+export function isMain(importMetaUrl, argv = process.argv, { platform = process.platform, realpath = realpathSync.native } = {}) {
+    if (!argv[1])
+        return false;
+    const canonical = (path) => {
+        try {
+            path = realpath(resolve(path));
+        }
+        catch {
+            path = resolve(path);
+        }
+        return platform === "win32" ? path.toLowerCase() : path;
+    };
+    return canonical(fileURLToPath(importMetaUrl)) === canonical(argv[1]);
+}
+if (isMain(import.meta.url)) {
+    const bootstrapStartedAt = process.hrtime.bigint();
+    process.exitCode = await runCli(process.argv.slice(2), console, { bootstrapStartedAt });
+}
+//# sourceMappingURL=silvermoon.js.map