@nimiplatform/nimi-coding 0.2.8 → 0.3.0

package/cli/commands/topic-formatters.mjs

@@ -1,382 +0,0 @@
-import { localize, styleHeading, styleLabel, styleMuted } from "../lib/ui.mjs";
-
-export function buildJsonReport(command, report) {
-  return {
-    contract: "nimicoding.topic-command-result.v1",
-    command,
-    ...report,
-  };
-}
-export function writeJson(report) {
-  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-}
-export function formatTopicGoalRefusal(report) {
-  const blockingChecks = report.readiness?.checks?.filter((entry) => entry.status === "fail") ?? [];
-  const lines = [
-    "nimicoding topic goal refused: topic is not goal-ready.",
-    "",
-    `Topic: ${report.topic_id ?? "unknown"}`,
-    `State: ${report.topic_state ?? "unknown"}`,
-    `Selected Next Target: ${report.selected_next_target ?? "none"}`,
-    "",
-    "Blocking checks:",
-    ...blockingChecks.map((entry) => `- ${entry.id}: ${entry.message}`),
-    "",
-    "Fix the topic admission artifacts first, then rerun:",
-    `pnpm exec nimicoding topic goal ${report.topic_id ?? "<topic-id>"}`,
-  ];
-  return `${lines.join("\n")}\n`;
-}
-export function formatTopicStatus(report) {
-  const lines = [
-    styleHeading(`nimicoding topic status: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("State", "状态"))}: ${report.state}`,
-    `${styleLabel(localize("Schema", "Schema"))}: ${report.schemaMode}`,
-    `${styleLabel(localize("Title", "标题"))}: ${report.title ?? localize("none", "无")}`,
-    `${styleLabel(localize("Selected Next Target", "当前下一目标"))}: ${report.selectedNextTarget ?? localize("none", "无")}`,
-    `${styleLabel(localize("True-Close", "True-Close"))}: ${report.currentTrueCloseStatus ?? localize("none", "无")}`,
-    `${styleLabel(localize("Pending Note", "Pending Note"))}: ${report.pendingNoteStatus ?? localize("none", "无")}`,
-    `${styleLabel(localize("Migration Posture", "迁移姿态"))}: ${report.migrationPosture ?? localize("none", "无")}`,
-    `${styleLabel(localize("Validation Disposition", "校验姿态"))}: ${report.validationDisposition ?? "strict"}`,
-    `${styleLabel(localize("Canonical Validated", "Canonical 校验"))}: ${report.canonicalValidated ? "true" : "false"}`,
-    `${styleLabel(localize("Ignored By Policy", "策略忽略"))}: ${report.ignoredByPolicy ? "true" : "false"}`,
-  ];
-  if (report.ignoredByPolicy && report.ignorePolicyReason) {
-    lines.push(`${styleLabel(localize("Ignore Reason", "忽略原因"))}: ${report.ignorePolicyReason}`);
-  }
-  if (report.artifactSummary) {
-    lines.push(
-      "",
-      styleLabel(localize("Artifacts", "Artifacts")),
-      `- files=${report.artifactSummary.files} packets=${report.artifactSummary.packets} results=${report.artifactSummary.results} closeouts=${report.artifactSummary.closeouts}`,
-      `- decision_reviews=${report.artifactSummary.decision_reviews} remediations=${report.artifactSummary.remediations} overflow_continuations=${report.artifactSummary.overflow_continuations}`,
-      `- exec_packs=${report.artifactSummary.exec_packs} true_close_artifacts=${report.artifactSummary.true_close_artifacts}`,
-    );
-  }
-  if (report.featureFlags) {
-    lines.push(
-      "",
-      styleLabel(localize("Feature Flags", "Feature Flags")),
-      ...Object.entries(report.featureFlags).map(([key, value]) => `- ${key}: ${value ? "true" : "false"}`),
-    );
-  }
-  if (Array.isArray(report.observedWaves) && report.observedWaves.length > 0) {
-    lines.push(
-      "",
-      styleLabel(localize("Observed Waves", "Observed Waves")),
-      ...report.observedWaves.slice(0, 8).map((entry) => (
-        `- ${entry.wave_id}: ${entry.observed_lineage} packets=${entry.packets} results=${entry.results} closeouts=${entry.closeouts} exec_packs=${entry.exec_packs}`
-      )),
-    );
-    if (report.observedWaves.length > 8) {
-      lines.push(styleMuted(`- ... ${report.observedWaves.length - 8} more wave observations`));
-    }
-  }
-  if (report.warnings.length > 0) {
-    lines.push(
-      "",
-      styleLabel(localize("Warnings", "警告")),
-      ...report.warnings.map((entry) => styleMuted(`- ${entry}`)),
-    );
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatTopicValidate(report) {
-  const lines = [
-    styleHeading(`nimicoding topic validate: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("State", "状态"))}: ${report.state}`,
-    `${styleLabel(localize("Schema", "Schema"))}: ${report.schemaMode}`,
-    `${styleLabel(localize("Result", "结果"))}: ${report.ok ? localize("ok", "通过") : localize("failed", "失败")}`,
-    `${styleLabel(localize("Pending Note", "Pending Note"))}: ${report.pendingNoteStatus ?? localize("none", "无")}`,
-    `${styleLabel(localize("Migration Posture", "迁移姿态"))}: ${report.migrationPosture ?? localize("none", "无")}`,
-    `${styleLabel(localize("Validation Disposition", "校验姿态"))}: ${report.validationDisposition ?? "strict"}`,
-    `${styleLabel(localize("Canonical Validated", "Canonical 校验"))}: ${report.canonicalValidated ? "true" : "false"}`,
-    `${styleLabel(localize("Ignored By Policy", "策略忽略"))}: ${report.ignoredByPolicy ? "true" : "false"}`,
-    "",
-    styleLabel(localize("Checks", "检查项")),
-    ...report.checks.map((entry) => `- [${entry.ok ? "ok" : "fail"}] ${entry.id}: ${entry.reason}`),
-  ];
-  if (report.ignoredByPolicy && report.ignorePolicyReason) {
-    lines.push(`${styleLabel(localize("Ignore Reason", "忽略原因"))}: ${report.ignorePolicyReason}`);
-  }
-  if (report.artifactSummary) {
-    lines.push(
-      "",
-      styleLabel(localize("Artifacts", "Artifacts")),
-      `- files=${report.artifactSummary.files} packets=${report.artifactSummary.packets} results=${report.artifactSummary.results} closeouts=${report.artifactSummary.closeouts}`,
-      `- decision_reviews=${report.artifactSummary.decision_reviews} remediations=${report.artifactSummary.remediations} overflow_continuations=${report.artifactSummary.overflow_continuations}`,
-      `- exec_packs=${report.artifactSummary.exec_packs} true_close_artifacts=${report.artifactSummary.true_close_artifacts}`,
-    );
-  }
-  if (report.featureFlags) {
-    lines.push(
-      "",
-      styleLabel(localize("Feature Flags", "Feature Flags")),
-      ...Object.entries(report.featureFlags).map(([key, value]) => `- ${key}: ${value ? "true" : "false"}`),
-    );
-  }
-  if (Array.isArray(report.observedWaves) && report.observedWaves.length > 0) {
-    lines.push(
-      "",
-      styleLabel(localize("Observed Waves", "Observed Waves")),
-      ...report.observedWaves.slice(0, 8).map((entry) => (
-        `- ${entry.wave_id}: ${entry.observed_lineage} packets=${entry.packets} results=${entry.results} closeouts=${entry.closeouts} exec_packs=${entry.exec_packs}`
-      )),
-    );
-    if (report.observedWaves.length > 8) {
-      lines.push(styleMuted(`- ... ${report.observedWaves.length - 8} more wave observations`));
-    }
-  }
-  if (report.warnings.length > 0) {
-    lines.push(
-      "",
-      styleLabel(localize("Warnings", "警告")),
-      ...report.warnings.map((entry) => styleMuted(`- ${entry}`)),
-    );
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatNextStep(report) {
-  const decision = report.decision;
-  const lines = [
-    styleHeading(`nimicoding topic run-next-step: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Stop Class", "Stop Class"))}: ${decision.stop_class}`,
-    `${styleLabel(localize("Action", "Action"))}: ${decision.recommended_action}`,
-    `${styleLabel(localize("Reason", "Reason"))}: ${decision.reason_code}`,
-    `${styleLabel(localize("Human Confirmation", "Human Confirmation"))}: ${decision.requires_human_confirmation ? "true" : "false"}`,
-    `${styleLabel(localize("Recommendation", "Recommendation"))}: ${decision.recommended_decision}`,
-    `${styleLabel(localize("Rationale", "Rationale"))}: ${decision.recommendation_rationale}`,
-  ];
-  if (decision.next_command_ref) {
-    lines.push(`${styleLabel(localize("Next Command", "Next Command"))}: ${decision.next_command_ref}`);
-  }
-  if (Array.isArray(decision.expected_artifacts) && decision.expected_artifacts.length > 0) {
-    lines.push("", styleLabel(localize("Expected Artifacts", "Expected Artifacts")));
-    lines.push(...decision.expected_artifacts.map((entry) => `- ${entry}`));
-  }
-  if (Array.isArray(decision.blocking_checks) && decision.blocking_checks.length > 0) {
-    lines.push("", styleLabel(localize("Blocking Checks", "Blocking Checks")));
-    lines.push(...decision.blocking_checks.map((entry) => `- [${entry.ok ? "ok" : "fail"}] ${entry.id}: ${entry.reason}`));
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatRunLedger(report, action) {
-  const ledger = report.ledger ?? {};
-  const lines = [
-    styleHeading(`nimicoding topic run-ledger ${action}: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Run", "Run"))}: ${report.runId}`,
-    `${styleLabel(localize("Ledger", "Ledger"))}: ${report.ledgerRef}`,
-    `${styleLabel(localize("Status", "Status"))}: ${report.runStatus ?? ledger.run_status}`,
-    `${styleLabel(localize("Events", "Events"))}: ${report.eventCount ?? ledger.event_count ?? 0}`,
-  ];
-  if (report.eventRef) {
-    lines.push(`${styleLabel(localize("Event", "Event"))}: ${report.eventRef}`);
-  }
-  if (ledger.current_human_gate) {
-    lines.push(`${styleLabel(localize("Human Gate", "Human Gate"))}: ${ledger.current_human_gate.summary}`);
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatGraphValidate(report) {
-  const lines = [
-    styleHeading(`nimicoding topic validate graph: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Wave Count", "Wave 数量"))}: ${report.waveCount ?? 0}`,
-    `${styleLabel(localize("Result", "结果"))}: ${report.ok ? localize("ok", "通过") : localize("failed", "失败")}`,
-    "",
-    styleLabel(localize("Checks", "检查项")),
-    ...report.checks.map((entry) => `- [${entry.ok ? "ok" : "fail"}] ${entry.id}: ${entry.reason}`),
-  ];
-  if (report.warnings.length > 0) {
-    lines.push("", styleLabel(localize("Warnings", "警告")), ...report.warnings.map((entry) => styleMuted(`- ${entry}`)));
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatAdmissionValidate(report, waveId) {
-  const lines = [
-    styleHeading(`nimicoding topic validate admission: ${report.topicId} / ${waveId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Result", "结果"))}: ${report.ok ? localize("ok", "通过") : localize("failed", "失败")}`,
-    "",
-    styleLabel(localize("Checks", "检查项")),
-    ...report.checks.map((entry) => `- [${entry.ok ? "ok" : "fail"}] ${entry.id}: ${entry.reason}`),
-  ];
-  if (report.warnings.length > 0) {
-    lines.push("", styleLabel(localize("Warnings", "警告")), ...report.warnings.map((entry) => styleMuted(`- ${entry}`)));
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatClosureValidate(report, waveId) {
-  const lines = [
-    styleHeading(`nimicoding topic validate closure: ${report.topicId} / ${waveId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Result", "结果"))}: ${report.ok ? localize("ok", "通过") : localize("failed", "失败")}`,
-    "",
-    styleLabel(localize("Checks", "检查项")),
-    ...report.checks.map((entry) => `- [${entry.ok ? "ok" : "fail"}] ${entry.id}: ${entry.reason}`),
-  ];
-  if (report.closeoutRef) {
-    lines.push("", `${styleLabel(localize("Closeout Ref", "Closeout 路径"))}: ${report.closeoutRef}`);
-  }
-  if (report.warnings.length > 0) {
-    lines.push("", styleLabel(localize("Warnings", "警告")), ...report.warnings.map((entry) => styleMuted(`- ${entry}`)));
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatWaveMutation(report, action) {
-  const lines = [
-    styleHeading(`nimicoding topic ${action}: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Wave", "Wave"))}: ${report.waveId}`,
-  ];
-  if (report.waveState) {
-    lines.push(`${styleLabel(localize("Wave State", "Wave 状态"))}: ${report.waveState}`);
-  }
-  if (report.selectedNextTarget) {
-    lines.push(`${styleLabel(localize("Selected Next Target", "当前下一目标"))}: ${report.selectedNextTarget}`);
-  }
-  if (report.state) {
-    lines.push(`${styleLabel(localize("Topic State", "Topic 状态"))}: ${report.state}`);
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatPacketFreeze(report) {
-  return `${styleHeading(`nimicoding topic packet freeze: ${report.topicId}`)}
-${styleLabel(localize("Path", "路径"))}: ${report.topicRef}
-${styleLabel(localize("Packet", "Packet"))}: ${report.packetId}
-${styleLabel(localize("Wave", "Wave"))}: ${report.waveId}
-${styleLabel(localize("Packet Ref", "Packet 路径"))}: ${report.packetRef}
-${styleLabel(localize("Status", "状态"))}: ${report.status}
-`;
-}
-export function formatDispatch(report) {
-  return `${styleHeading(`nimicoding topic ${report.role} dispatch: ${report.topicId}`)}
-${styleLabel(localize("Path", "路径"))}: ${report.topicRef}
-${styleLabel(localize("Packet", "Packet"))}: ${report.packetId}
-${styleLabel(localize("Wave", "Wave"))}: ${report.waveId}
-${styleLabel(localize("Packet Ref", "Packet 路径"))}: ${report.packetRef}
-${styleLabel(localize("Prompt Ref", "Prompt 路径"))}: ${report.promptRef}
-${styleLabel(localize("Wave State", "Wave 状态"))}: ${report.waveState}
-`;
-}
-export function formatResultRecord(report) {
-  return `${styleHeading(`nimicoding topic result record: ${report.topicId}`)}
-${styleLabel(localize("Path", "路径"))}: ${report.topicRef}
-${styleLabel(localize("Result", "Result"))}: ${report.resultId}
-${styleLabel(localize("Wave", "Wave"))}: ${report.waveId}
-${styleLabel(localize("Kind", "类别"))}: ${report.resultKind}
-${styleLabel(localize("Verdict", "结论"))}: ${report.verdict}
-${styleLabel(localize("Result Ref", "Result 路径"))}: ${report.resultRef}
-${styleLabel(localize("Wave State", "Wave 状态"))}: ${report.waveState}
-`;
-}
-export function formatDecisionReview(report) {
-  const lines = [
-    styleHeading(`nimicoding topic decision-review: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Decision Review", "Decision Review"))}: ${report.decisionReviewId}`,
-    `${styleLabel(localize("Disposition", "Disposition"))}: ${report.disposition}`,
-    `${styleLabel(localize("Review Ref", "Review 路径"))}: ${report.decisionReviewRef}`,
-  ];
-  if (report.targetWaveId) {
-    lines.push(`${styleLabel(localize("Target Wave", "目标 Wave"))}: ${report.targetWaveId}`);
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatRemediation(report) {
-  return `${styleHeading(`nimicoding topic remediation open: ${report.topicId}`)}
-${styleLabel(localize("Path", "路径"))}: ${report.topicRef}
-${styleLabel(localize("Remediation", "Remediation"))}: ${report.remediationId}
-${styleLabel(localize("Wave", "Wave"))}: ${report.waveId}
-${styleLabel(localize("Kind", "类别"))}: ${report.kind}
-${styleLabel(localize("Reason", "原因"))}: ${report.reason}
-${styleLabel(localize("Remediation Ref", "Remediation 路径"))}: ${report.remediationRef}
-${styleLabel(localize("Wave State", "Wave 状态"))}: ${report.waveState}
-`;
-}
-export function formatOverflowContinuation(report) {
-  return `${styleHeading(`nimicoding topic overflow continue: ${report.topicId}`)}
-${styleLabel(localize("Path", "路径"))}: ${report.topicRef}
-${styleLabel(localize("Wave", "Wave"))}: ${report.waveId}
-${styleLabel(localize("Overflowed Packet", "Overflowed Packet"))}: ${report.overflowedPacketId}
-${styleLabel(localize("Continuation Packet", "Continuation Packet"))}: ${report.continuationPacketId}
-${styleLabel(localize("Continuation Ref", "Continuation 路径"))}: ${report.continuationRef}
-${styleLabel(localize("Wave State", "Wave 状态"))}: ${report.waveState}
-`;
-}
-export function formatPendingTransition(report, action) {
-  const lines = [
-    styleHeading(`nimicoding topic ${action}: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Topic State", "Topic 状态"))}: ${report.state}`,
-    `${styleLabel(localize("Pending Note Ref", "Pending Note 路径"))}: ${report.pendingNoteRef}`,
-  ];
-  if (report.reason) {
-    lines.push(`${styleLabel(localize("Reason", "原因"))}: ${report.reason}`);
-  }
-  if (report.criteriaMet) {
-    lines.push(`${styleLabel(localize("Criteria Met", "条件满足"))}: ${report.criteriaMet}`);
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatCloseout(report, scope) {
-  const lines = [
-    styleHeading(`nimicoding topic closeout ${scope}: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Closeout Ref", "Closeout 路径"))}: ${report.closeoutRef}`,
-  ];
-  if (report.waveId) {
-    lines.push(`${styleLabel(localize("Wave", "Wave"))}: ${report.waveId}`);
-    lines.push(`${styleLabel(localize("Wave State", "Wave 状态"))}: ${report.waveState}`);
-  }
-  if (report.state) {
-    lines.push(`${styleLabel(localize("Topic State", "Topic 状态"))}: ${report.state}`);
-  }
-  if (report.currentTrueCloseStatus) {
-    lines.push(`${styleLabel(localize("True-Close", "True-Close"))}: ${report.currentTrueCloseStatus}`);
-  }
-  if (report.trueCloseRef) {
-    lines.push(`${styleLabel(localize("True-Close Ref", "True-Close 路径"))}: ${report.trueCloseRef}`);
-  }
-  return `${lines.join("\n")}\n`;
-}
-export function formatTrueCloseAudit(report) {
-  const lines = [
-    styleHeading(`nimicoding topic true-close-audit: ${report.topicId}`),
-    "",
-    `${styleLabel(localize("Path", "路径"))}: ${report.topicRef}`,
-    `${styleLabel(localize("Status", "状态"))}: ${report.status}`,
-    `${styleLabel(localize("Audit Ref", "Audit 路径"))}: ${report.auditRef}`,
-    `${styleLabel(localize("Judgement Ref", "Judgement 路径"))}: ${report.judgementRef}`,
-    "",
-    styleLabel(localize("Checks", "检查项")),
-    ...report.checks.map((entry) => `- [${entry.ok ? "ok" : "fail"}] ${entry.id}: ${entry.reason}`),
-  ];
-  return `${lines.join("\n")}\n`;
-}
-export function formatTopicCreate(report) {
-  return `${styleHeading(`nimicoding topic create: ${report.topicId}`)}
-${styleLabel(localize("Created", "已创建"))}: ${report.topicRef}
-${styleLabel(localize("State", "状态"))}: ${report.state}
-${styleLabel(localize("Title", "标题"))}: ${report.title}
-${styleMuted(localize(
-    "Next step: freeze the first bounded wave before admitted execution.",
-    "下一步：在 admitted execution 之前冻结第一个 bounded wave。",
-  ))}
-`;
-}

package/cli/commands/topic-goal.mjs

@@ -1,33 +0,0 @@
-import process from "node:process";
-
-import { buildTopicGoal } from "../lib/topic-goal.mjs";
-import { resolveTopicProjectRoot } from "../lib/topic.mjs";
-import { formatTopicGoalRefusal, writeJson } from "./topic-formatters.mjs";
-import { parseTopicGoalOptions } from "./topic-options.mjs";
-
-export async function runTopicGoal(args) {
-  const parsed = parseTopicGoalOptions(args);
-  if (!parsed.ok) {
-    process.stderr.write(parsed.error);
-    return 3;
-  }
-  try {
-    const projectRoot = await resolveTopicProjectRoot(process.cwd());
-    const report = await buildTopicGoal(projectRoot, parsed.options);
-    if (report.inputError) {
-      process.stderr.write(`${report.error}\n`);
-      return 3;
-    }
-    if (parsed.options.format === "json") {
-      writeJson(report);
-    } else if (report.ok) {
-      process.stdout.write(`${report.goal_command}\n`);
-    } else {
-      process.stderr.write(formatTopicGoalRefusal(report));
-    }
-    return report.ok ? 0 : 2;
-  } catch (error) {
-    process.stderr.write(`nimicoding topic goal failed: ${error?.message ?? String(error)}\n`);
-    return 1;
-  }
-}

package/cli/commands/topic-options-shared.mjs

@@ -1,27 +0,0 @@
-import { localize } from "../lib/ui.mjs";
-
-export function requireOptionValue(name, next, errorPrefix) {
-  if (!next || next.startsWith("--")) {
-    return {
-      ok: false,
-      error: `${localize(
-        `${errorPrefix}: ${name} requires a value.`,
-        `${errorPrefix}：${name} 需要一个值。`,
-      )}\n`,
-    };
-  }
-  return { ok: true };
-}
-
-export function validateEnumOption(name, value, allowed, errorPrefix) {
-  if (!allowed.includes(value)) {
-    return {
-      ok: false,
-      error: `${localize(
-        `${errorPrefix}: unsupported ${name} value ${value}.`,
-        `${errorPrefix}：不支持的 ${name} 值 ${value}。`,
-      )}\n`,
-    };
-  }
-  return { ok: true };
-}