@nimiplatform/nimi-coding 0.2.8 → 0.3.0

package/cli/commands/handoff.mjs

@@ -1,123 +0,0 @@
-import {
-  buildHandoffPayload,
-  formatHandoffPayload,
-  writeHandoffPromptArtifacts,
-} from "../lib/shared.mjs";
-import {
-  localize,
-  styleCommand,
-  styleHeading,
-  styleLabel,
-} from "../lib/ui.mjs";
-
-function parseHandoffOptions(args) {
-  const options = {
-    json: false,
-    prompt: false,
-    skill: null,
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-
-    if (arg === "--json") {
-      options.json = true;
-      continue;
-    }
-
-    if (arg === "--prompt") {
-      options.prompt = true;
-      continue;
-    }
-
-    if (arg === "--skill") {
-      const next = args[index + 1];
-      if (!next || next.startsWith("--")) {
-        return {
-          ok: false,
-          error: localize(
-            "nimicoding handoff refused: --skill requires a skill id.\n",
-            "nimicoding handoff 拒绝执行：--skill 需要一个 skill id。\n",
-          ),
-        };
-      }
-      options.skill = next;
-      index += 1;
-      continue;
-    }
-
-    return {
-      ok: false,
-      error: localize(
-        `nimicoding handoff refused: unknown option ${arg}.\n`,
-        `nimicoding handoff 拒绝执行：未知选项 ${arg}。\n`,
-      ),
-    };
-  }
-
-  if (!options.skill) {
-    return {
-      ok: false,
-      error: localize(
-        "nimicoding handoff refused: explicit --skill is required.\n",
-        "nimicoding handoff 拒绝执行：必须显式提供 --skill。\n",
-      ),
-    };
-  }
-
-  if (options.json && options.prompt) {
-    return {
-      ok: false,
-      error: localize(
-        "nimicoding handoff refused: --json and --prompt are mutually exclusive.\n",
-        "nimicoding handoff 拒绝执行：--json 与 --prompt 不能同时使用。\n",
-      ),
-    };
-  }
-
-  return {
-    ok: true,
-    options,
-  };
-}
-
-export async function runHandoff(args) {
-  const parsed = parseHandoffOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(parsed.error);
-    return 2;
-  }
-
-  const payload = await buildHandoffPayload(process.cwd(), parsed.options.skill);
-  if (parsed.options.json) {
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-  } else if (parsed.options.prompt) {
-    if (!payload.ok) {
-      process.stderr.write(`${localize(payload.nextAction, payload.nextAction
-        .replace("Bootstrap or handoff validation is failing; repair doctor errors before exporting handoff payloads", "bootstrap 或 handoff 校验失败；请先修复 doctor 报错，再导出 handoff payload")
-        .replace("Projects may delegate spec reconstruction to an external AI host when lifecycle repair or reconstruction work is needed", "当需要 lifecycle repair 或 reconstruction 工作时，项目可以将 spec reconstruction 委托给外部 AI host")
-        .replace("This skill requires the canonical tree under `.nimi/spec` before handoff", "该 skill 在 handoff 前需要 `.nimi/spec` 下的 canonical tree")
-        .replace("Skill prerequisites are satisfied by the current project-local truth", "当前项目本地 truth 已满足该 skill 的前置条件"))}\n`);
-      return payload.exitCode;
-    }
-
-    const refs = await writeHandoffPromptArtifacts(process.cwd(), payload);
-    process.stdout.write(`${styleHeading(localize(`Prepared local handoff refs for ${payload.skill.id}`, `已为 ${payload.skill.id} 准备本地 handoff ref`))}
-
-${styleLabel(localize("Created:", "已创建："))}
-  - ${refs.jsonRef}
-  - ${refs.promptRef}
-
-${styleLabel(localize("Use:", "使用方式："))}
-  - ${localize(`Treat ${refs.jsonRef} as the authoritative machine contract`, `将 ${refs.jsonRef} 作为权威机器契约`)}
-  - ${localize(`Paste the contents of ${refs.promptRef} into the external AI host when needed`, `需要时将 ${refs.promptRef} 的内容粘贴给外部 AI host`)}
-  - ${localize("Optional command preview:", "可选命令预览：")} ${styleCommand(`nimicoding handoff --skill ${payload.skill.id} --json`)}
-`);
-  } else {
-    process.stdout.write(formatHandoffPayload(payload));
-  }
-
-  return payload.exitCode;
-}
-
-export { parseHandoffOptions };

package/cli/commands/ingest-high-risk-execution.mjs

@@ -1,95 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-import {
-  buildHighRiskIngestPayload,
-  formatHighRiskIngestPayload,
-} from "../lib/high-risk-ingest.mjs";
-import { localize } from "../lib/ui.mjs";
-
-function parseIngestHighRiskExecutionOptions(args) {
-  const options = {
-    fromPath: null,
-    json: false,
-    writeLocal: false,
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-
-    if (arg === "--json") {
-      options.json = true;
-      continue;
-    }
-
-    if (arg === "--write-local") {
-      options.writeLocal = true;
-      continue;
-    }
-
-    if (arg === "--from") {
-      const next = args[index + 1];
-      if (!next || next.startsWith("--")) {
-        return {
-          ok: false,
-          error: `${localize(
-            "nimicoding ingest-high-risk-execution refused: --from requires a value.",
-            "nimicoding ingest-high-risk-execution 已拒绝：`--from` 需要一个值。",
-          )}\n`,
-        };
-      }
-      options.fromPath = next;
-      index += 1;
-      continue;
-    }
-
-    return {
-      ok: false,
-      error: `${localize(
-        `nimicoding ingest-high-risk-execution refused: unknown option ${arg}.`,
-        `nimicoding ingest-high-risk-execution 已拒绝：未知选项 ${arg}。`,
-      )}\n`,
-    };
-  }
-
-  if (!options.fromPath) {
-    return {
-      ok: false,
-      error: `${localize(
-        "nimicoding ingest-high-risk-execution refused: explicit --from is required.",
-        "nimicoding ingest-high-risk-execution 已拒绝：必须显式提供 `--from`。",
-      )}\n`,
-    };
-  }
-
-  return { ok: true, options };
-}
-
-export async function runIngestHighRiskExecution(args) {
-  const parsed = parseIngestHighRiskExecutionOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(parsed.error);
-    return 2;
-  }
-
-  const payload = await buildHighRiskIngestPayload(process.cwd(), parsed.options.fromPath, parsed.options);
-  if (payload.inputError) {
-    process.stderr.write(payload.error);
-    return payload.exitCode;
-  }
-
-  if (parsed.options.writeLocal && payload.ok) {
-    await mkdir(path.dirname(payload.artifactPath), { recursive: true });
-    await writeFile(payload.artifactPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
-  }
-
-  if (parsed.options.json) {
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-  } else {
-    process.stdout.write(formatHighRiskIngestPayload(payload));
-  }
-
-  return payload.exitCode;
-}
-
-export { parseIngestHighRiskExecutionOptions };

package/cli/commands/review-high-risk-execution.mjs

@@ -1,95 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import path from "node:path";
-
-import {
-  buildHighRiskReviewPayload,
-  formatHighRiskReviewPayload,
-} from "../lib/high-risk-review.mjs";
-import { localize } from "../lib/ui.mjs";
-
-function parseReviewHighRiskExecutionOptions(args) {
-  const options = {
-    fromPath: null,
-    json: false,
-    writeLocal: false,
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-
-    if (arg === "--json") {
-      options.json = true;
-      continue;
-    }
-
-    if (arg === "--write-local") {
-      options.writeLocal = true;
-      continue;
-    }
-
-    if (arg === "--from") {
-      const next = args[index + 1];
-      if (!next || next.startsWith("--")) {
-        return {
-          ok: false,
-          error: `${localize(
-            "nimicoding review-high-risk-execution refused: --from requires a value.",
-            "nimicoding review-high-risk-execution 已拒绝：`--from` 需要一个值。",
-          )}\n`,
-        };
-      }
-      options.fromPath = next;
-      index += 1;
-      continue;
-    }
-
-    return {
-      ok: false,
-      error: `${localize(
-        `nimicoding review-high-risk-execution refused: unknown option ${arg}.`,
-        `nimicoding review-high-risk-execution 已拒绝：未知选项 ${arg}。`,
-      )}\n`,
-    };
-  }
-
-  if (!options.fromPath) {
-    return {
-      ok: false,
-      error: `${localize(
-        "nimicoding review-high-risk-execution refused: explicit --from is required.",
-        "nimicoding review-high-risk-execution 已拒绝：必须显式提供 `--from`。",
-      )}\n`,
-    };
-  }
-
-  return { ok: true, options };
-}
-
-export async function runReviewHighRiskExecution(args) {
-  const parsed = parseReviewHighRiskExecutionOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(parsed.error);
-    return 2;
-  }
-
-  const payload = await buildHighRiskReviewPayload(process.cwd(), parsed.options.fromPath, parsed.options);
-  if (payload.inputError) {
-    process.stderr.write(payload.error);
-    return payload.exitCode;
-  }
-
-  if (parsed.options.writeLocal && payload.ok) {
-    await mkdir(path.dirname(payload.artifactPath), { recursive: true });
-    await writeFile(payload.artifactPath, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
-  }
-
-  if (parsed.options.json) {
-    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
-  } else {
-    process.stdout.write(formatHighRiskReviewPayload(payload));
-  }
-
-  return payload.exitCode;
-}
-
-export { parseReviewHighRiskExecutionOptions };

package/cli/commands/sweep-design.mjs

@@ -1,295 +0,0 @@
-import {
-  runAuditorPrompt,
-  runFinalize,
-  runFixTopic,
-  runIntake,
-  runLedgerValidate,
-  runPacketBuild,
-  runPacketBuildBatch,
-  runResultIngest,
-  runWavePlan,
-} from "../lib/sweep-design.mjs";
-import { localize } from "../lib/ui.mjs";
-
-function readRequiredValue(args, index, optionName, commandName) {
-  const next = args[index + 1];
-  if (!next || next.startsWith("--")) {
-    return {
-      ok: false,
-      error: `${localize(
-        `nimicoding sweep design ${commandName} refused: ${optionName} requires a value.`,
-        `nimicoding sweep design ${commandName} 已拒绝：${optionName} 需要一个值。`,
-      )}\n`,
-    };
-  }
-  return { ok: true, value: next };
-}
-
-function unknownOption(commandName, arg) {
-  return {
-    ok: false,
-    error: `${localize(
-      `nimicoding sweep design ${commandName} refused: unknown option ${arg}.`,
-      `nimicoding sweep design ${commandName} 已拒绝：未知选项 ${arg}。`,
-    )}\n`,
-  };
-}
-
-function parseOptions(args, commandName, spec) {
-  const options = Object.fromEntries(Object.entries(spec).map(([name, config]) => [name, config.default ?? null]));
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
-    if (arg === "--json") {
-      options.json = true;
-      continue;
-    }
-    const entry = Object.entries(spec).find(([, config]) => config.flag === arg);
-    if (!entry) {
-      return unknownOption(commandName, arg);
-    }
-    const [name] = entry;
-    if (entry[1].type === "boolean") {
-      options[name] = true;
-      continue;
-    }
-    const value = readRequiredValue(args, index, arg, commandName);
-    if (!value.ok) return value;
-    options[name] = value.value;
-    index += 1;
-  }
-  const missing = Object.entries(spec)
-    .filter(([, config]) => config.required)
-    .filter(([name]) => !options[name])
-    .map(([, config]) => config.flag);
-  if (missing.length > 0) {
-    return {
-      ok: false,
-      error: `${localize(
-        `nimicoding sweep design ${commandName} refused: missing required options: ${missing.join(", ")}.`,
-        `nimicoding sweep design ${commandName} 已拒绝：缺少必填选项：${missing.join(", ")}。`,
-      )}\n`,
-    };
-  }
-  return { ok: true, options };
-}
-
-function parseSweepDesignOptions(args) {
-  const [phase] = args;
-  if (phase === "intake") {
-    return {
-      ok: true,
-      action: "intake",
-      parsed: parseOptions(args.slice(1), "intake", {
-        sweepId: { flag: "--sweep-id", required: true },
-        runId: { flag: "--run-id" },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "packet-build") {
-    return {
-      ok: true,
-      action: "packet-build",
-      parsed: parseOptions(args.slice(1), "packet-build", {
-        runId: { flag: "--run-id", required: true },
-        packetId: { flag: "--packet-id", required: true },
-        findingId: { flag: "--finding-id" },
-        findingIds: { flag: "--finding-ids" },
-        explicitQuestion: { flag: "--explicit-question" },
-        explicitQuestions: { flag: "--explicit-questions" },
-        priorDesignStateRefs: { flag: "--prior-design-state-refs" },
-        priorDesignStateMarker: { flag: "--prior-design-state-marker" },
-        currentClusterRefs: { flag: "--current-cluster-refs" },
-        currentWaveRefs: { flag: "--current-wave-refs" },
-        authorityOnly: { flag: "--authority-only", type: "boolean", default: false },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "packet-build-batch") {
-    return {
-      ok: true,
-      action: "packet-build-batch",
-      parsed: parseOptions(args.slice(1), "packet-build-batch", {
-        runId: { flag: "--run-id", required: true },
-        batchSize: { flag: "--batch-size", required: true },
-        findingIds: { flag: "--finding-ids" },
-        packetPrefix: { flag: "--packet-prefix" },
-        manifestId: { flag: "--manifest-id" },
-        explicitQuestion: { flag: "--explicit-question" },
-        explicitQuestions: { flag: "--explicit-questions" },
-        priorDesignStateRefs: { flag: "--prior-design-state-refs" },
-        priorDesignStateMarker: { flag: "--prior-design-state-marker" },
-        currentClusterRefs: { flag: "--current-cluster-refs" },
-        currentWaveRefs: { flag: "--current-wave-refs" },
-        authorityOnly: { flag: "--authority-only", type: "boolean", default: false },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "result-ingest") {
-    return {
-      ok: true,
-      action: "result-ingest",
-      parsed: parseOptions(args.slice(1), "result-ingest", {
-        runId: { flag: "--run-id", required: true },
-        from: { flag: "--from", required: true },
-        mode: { flag: "--mode", default: "focused" },
-        allowSyntheticTrial: { flag: "--allow-synthetic-trial", type: "boolean", default: false },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "auditor-prompt") {
-    return {
-      ok: true,
-      action: "auditor-prompt",
-      parsed: parseOptions(args.slice(1), "auditor-prompt", {
-        runId: { flag: "--run-id", required: true },
-        packetId: { flag: "--packet-id", required: true },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "finalize") {
-    return {
-      ok: true,
-      action: "finalize",
-      parsed: parseOptions(args.slice(1), "finalize", {
-        runId: { flag: "--run-id", required: true },
-        allowSyntheticCloseout: { flag: "--allow-synthetic-closeout", type: "boolean", default: false },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "ledger-validate") {
-    return {
-      ok: true,
-      action: "ledger-validate",
-      parsed: parseOptions(args.slice(1), "ledger-validate", {
-        runId: { flag: "--run-id", required: true },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "wave-plan") {
-    return {
-      ok: true,
-      action: "wave-plan",
-      parsed: parseOptions(args.slice(1), "wave-plan", {
-        runId: { flag: "--run-id", required: true },
-        topicId: { flag: "--topic-id", required: true },
-        allowSyntheticTrial: { flag: "--allow-synthetic-trial", type: "boolean", default: false },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  if (phase === "fix-topic") {
-    return {
-      ok: true,
-      action: "fix-topic",
-      parsed: parseOptions(args.slice(1), "fix-topic", {
-        runId: { flag: "--run-id", required: true },
-        slug: { flag: "--slug" },
-        title: { flag: "--title" },
-        admitFirstWave: { flag: "--admit-first-wave", type: "boolean", default: false },
-        admitWaveId: { flag: "--admit-wave-id" },
-        verifiedAt: { flag: "--verified-at" },
-        json: { default: false },
-      }),
-    };
-  }
-  return {
-    ok: false,
-    error: `${localize(
-      "nimicoding sweep design refused: expected intake, packet-build, packet-build-batch, auditor-prompt, result-ingest, ledger-validate, finalize, wave-plan, or fix-topic.",
-      "nimicoding sweep design 已拒绝：需要 intake、packet-build、packet-build-batch、auditor-prompt、result-ingest、ledger-validate、finalize、wave-plan 或 fix-topic。",
-    )}\n`,
-  };
-}
-
-function emitResult(result, json) {
-  if (result.inputError) {
-    process.stderr.write(result.error);
-    return result.exitCode ?? 2;
-  }
-  if (!result.ok) {
-    process.stderr.write(result.error ?? "nimicoding sweep design failed.\n");
-    return result.exitCode ?? 1;
-  }
-  if (json) {
-    process.stdout.write(`${JSON.stringify({ command: "sweep.design", ...result }, null, 2)}\n`);
-  } else {
-    const lines = ["sweep design result"];
-    for (const [label, value] of [
-      ["run", result.runId],
-      ["inventory", result.inventoryRef],
-      ["ledger", result.ledgerRef],
-      ["packet", result.packetRef],
-      ["auditor prompt", result.promptRef],
-      ["auditor result", result.resultRef],
-      ["decision queue", result.decisionQueueRef],
-      ["final state report", result.finalStateReportRef],
-      ["wave plan", result.wavePlanRef],
-      ["topic", result.topicRef],
-      ["sweep fix source", result.sourceRef],
-      ["wave catalog", result.waveCatalogRef],
-    ]) {
-      if (value !== undefined && value !== null) {
-        lines.push(`${label}: ${value}`);
-      }
-    }
-    for (const [label, value] of [
-      ["findings", result.findingCount],
-      ["finding outcomes", result.findingOutcomeCount],
-      ["revision entries", result.revisionEntryCount],
-      ["total findings", result.totalFindingCount],
-      ["final findings", result.finalFindingCount],
-      ["transient findings", result.transientFindingCount],
-      ["waves", result.waveCount],
-      ["admitted wave", result.admittedWaveId],
-      ["stop class", result.stopClass],
-      ["stop reason", result.stopReason],
-    ]) {
-      if (value !== undefined && value !== null) {
-        lines.push(`${label}: ${value}`);
-      }
-    }
-    process.stdout.write(`${lines.join("\n")}\n`);
-  }
-  return result.exitCode ?? 0;
-}
-
-export async function runSweepDesign(args) {
-  const parsedAction = parseSweepDesignOptions(args);
-  if (!parsedAction.ok) {
-    process.stderr.write(parsedAction.error);
-    return 2;
-  }
-  if (!parsedAction.parsed.ok) {
-    process.stderr.write(parsedAction.parsed.error);
-    return 2;
-  }
-  const options = parsedAction.parsed.options;
-  const projectRoot = process.cwd();
-  const actions = {
-    intake: runIntake,
-    "packet-build": runPacketBuild,
-    "packet-build-batch": runPacketBuildBatch,
-    "auditor-prompt": runAuditorPrompt,
-    "result-ingest": runResultIngest,
-    "ledger-validate": runLedgerValidate,
-    finalize: runFinalize,
-    "wave-plan": runWavePlan,
-    "fix-topic": runFixTopic,
-  };
-  return emitResult(await actions[parsedAction.action](projectRoot, options), options.json);
-}

package/cli/commands/sweep.mjs

@@ -1,22 +0,0 @@
-import { runAuditSweep } from "./audit-sweep.mjs";
-import { runSweepDesign } from "./sweep-design.mjs";
-import { localize } from "../lib/ui.mjs";
-
-export async function runSweep(args) {
-  const [command] = args;
-  const rest = args.slice(1);
-
-  if (command === "audit") {
-    return runAuditSweep(rest);
-  }
-
-  if (command === "design") {
-    return runSweepDesign(rest);
-  }
-
-  process.stderr.write(localize(
-    "nimicoding sweep refused: expected `audit` or `design`.\n",
-    "nimicoding sweep 已拒绝：需要使用 `audit` 或 `design`。\n",
-  ));
-  return 2;
-}