@nimiplatform/nimi-coding 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (186) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +348 -0
  3. package/adapters/README.md +25 -0
  4. package/adapters/claude/README.md +89 -0
  5. package/adapters/claude/profile.yaml +70 -0
  6. package/adapters/codex/README.md +53 -0
  7. package/adapters/codex/profile.yaml +78 -0
  8. package/adapters/oh-my-codex/README.md +185 -0
  9. package/adapters/oh-my-codex/profile.yaml +46 -0
  10. package/bin/nimicoding.mjs +6 -0
  11. package/cli/commands/admit-high-risk-decision.mjs +108 -0
  12. package/cli/commands/audit-sweep.mjs +341 -0
  13. package/cli/commands/blueprint-audit.mjs +91 -0
  14. package/cli/commands/clear.mjs +168 -0
  15. package/cli/commands/closeout.mjs +183 -0
  16. package/cli/commands/decide-high-risk-execution.mjs +124 -0
  17. package/cli/commands/doctor.mjs +53 -0
  18. package/cli/commands/generate-spec-derived-docs.mjs +131 -0
  19. package/cli/commands/handoff.mjs +123 -0
  20. package/cli/commands/ingest-high-risk-execution.mjs +95 -0
  21. package/cli/commands/review-high-risk-execution.mjs +95 -0
  22. package/cli/commands/start.mjs +717 -0
  23. package/cli/commands/topic-formatters.mjs +382 -0
  24. package/cli/commands/topic-goal.mjs +33 -0
  25. package/cli/commands/topic-options-shared.mjs +27 -0
  26. package/cli/commands/topic-options-workflow.mjs +767 -0
  27. package/cli/commands/topic-options.mjs +626 -0
  28. package/cli/commands/topic-runner.mjs +169 -0
  29. package/cli/commands/topic.mjs +795 -0
  30. package/cli/commands/validate-acceptance.mjs +5 -0
  31. package/cli/commands/validate-ai-governance.mjs +214 -0
  32. package/cli/commands/validate-execution-packet.mjs +5 -0
  33. package/cli/commands/validate-orchestration-state.mjs +5 -0
  34. package/cli/commands/validate-prompt.mjs +5 -0
  35. package/cli/commands/validate-spec-audit.mjs +27 -0
  36. package/cli/commands/validate-spec-governance.mjs +124 -0
  37. package/cli/commands/validate-spec-tree.mjs +27 -0
  38. package/cli/commands/validate-worker-output.mjs +5 -0
  39. package/cli/constants.mjs +489 -0
  40. package/cli/help.mjs +134 -0
  41. package/cli/index.mjs +103 -0
  42. package/cli/lib/adapter-profiles.mjs +403 -0
  43. package/cli/lib/audit-execution.mjs +52 -0
  44. package/cli/lib/audit-sweep-runtime/admissions.mjs +381 -0
  45. package/cli/lib/audit-sweep-runtime/audit-validity.mjs +333 -0
  46. package/cli/lib/audit-sweep-runtime/chunks.mjs +697 -0
  47. package/cli/lib/audit-sweep-runtime/closeout.mjs +144 -0
  48. package/cli/lib/audit-sweep-runtime/codex-auditor-evidence.mjs +639 -0
  49. package/cli/lib/audit-sweep-runtime/codex-auditor.mjs +515 -0
  50. package/cli/lib/audit-sweep-runtime/common.mjs +329 -0
  51. package/cli/lib/audit-sweep-runtime/coverage-quality.mjs +172 -0
  52. package/cli/lib/audit-sweep-runtime/evidence-assignment.mjs +152 -0
  53. package/cli/lib/audit-sweep-runtime/format.mjs +57 -0
  54. package/cli/lib/audit-sweep-runtime/ingest.mjs +486 -0
  55. package/cli/lib/audit-sweep-runtime/inventory-spec-chunks.mjs +198 -0
  56. package/cli/lib/audit-sweep-runtime/inventory.mjs +728 -0
  57. package/cli/lib/audit-sweep-runtime/ledger.mjs +315 -0
  58. package/cli/lib/audit-sweep-runtime/p0p1-profile.mjs +101 -0
  59. package/cli/lib/audit-sweep-runtime/remediation.mjs +349 -0
  60. package/cli/lib/audit-sweep-runtime/rerun.mjs +129 -0
  61. package/cli/lib/audit-sweep-runtime/risk-budget.mjs +300 -0
  62. package/cli/lib/audit-sweep-runtime/status.mjs +62 -0
  63. package/cli/lib/audit-sweep-runtime/validators-ledger.mjs +215 -0
  64. package/cli/lib/audit-sweep-runtime/validators.mjs +758 -0
  65. package/cli/lib/audit-sweep.mjs +18 -0
  66. package/cli/lib/authority-convergence.mjs +309 -0
  67. package/cli/lib/blueprint-audit.mjs +370 -0
  68. package/cli/lib/bootstrap.mjs +228 -0
  69. package/cli/lib/closeout.mjs +623 -0
  70. package/cli/lib/codex-sdk-runner.mjs +76 -0
  71. package/cli/lib/contracts.mjs +180 -0
  72. package/cli/lib/doctor.mjs +18 -0
  73. package/cli/lib/entrypoints.mjs +274 -0
  74. package/cli/lib/external-execution.mjs +101 -0
  75. package/cli/lib/fs-helpers.mjs +33 -0
  76. package/cli/lib/handoff.mjs +785 -0
  77. package/cli/lib/high-risk-admission.mjs +442 -0
  78. package/cli/lib/high-risk-decision.mjs +324 -0
  79. package/cli/lib/high-risk-ingest.mjs +317 -0
  80. package/cli/lib/high-risk-review.mjs +263 -0
  81. package/cli/lib/internal/contracts-loaders.mjs +132 -0
  82. package/cli/lib/internal/contracts-parse-high-risk.mjs +131 -0
  83. package/cli/lib/internal/contracts-parse.mjs +457 -0
  84. package/cli/lib/internal/contracts-validators.mjs +398 -0
  85. package/cli/lib/internal/doctor-bootstrap-surface.mjs +359 -0
  86. package/cli/lib/internal/doctor-delegated-surface.mjs +256 -0
  87. package/cli/lib/internal/doctor-finalize.mjs +385 -0
  88. package/cli/lib/internal/doctor-format.mjs +286 -0
  89. package/cli/lib/internal/doctor-inspectors.mjs +294 -0
  90. package/cli/lib/internal/doctor-state.mjs +205 -0
  91. package/cli/lib/internal/governance/ai/ai-context-budget-core.mjs +315 -0
  92. package/cli/lib/internal/governance/ai/ai-structure-budget-core.mjs +358 -0
  93. package/cli/lib/internal/governance/ai/check-agents-freshness.mjs +155 -0
  94. package/cli/lib/internal/governance/ai/check-high-risk-doc-metadata-core.mjs +173 -0
  95. package/cli/lib/internal/governance/config.mjs +150 -0
  96. package/cli/lib/internal/governance/runner.mjs +35 -0
  97. package/cli/lib/internal/governance/shared/read-yaml-with-fragments.mjs +49 -0
  98. package/cli/lib/internal/validators-artifacts.mjs +515 -0
  99. package/cli/lib/internal/validators-shared.mjs +28 -0
  100. package/cli/lib/internal/validators-spec-helpers.mjs +186 -0
  101. package/cli/lib/internal/validators-spec.mjs +410 -0
  102. package/cli/lib/shared.mjs +83 -0
  103. package/cli/lib/topic-draft-packets.mjs +48 -0
  104. package/cli/lib/topic-goal.mjs +361 -0
  105. package/cli/lib/topic-runner.mjs +772 -0
  106. package/cli/lib/topic.mjs +93 -0
  107. package/cli/lib/ui.mjs +178 -0
  108. package/cli/lib/validators.mjs +78 -0
  109. package/cli/lib/value-helpers.mjs +24 -0
  110. package/cli/lib/yaml-helpers.mjs +133 -0
  111. package/cli/nimicoding.mjs +1 -0
  112. package/cli/seeds/bootstrap.mjs +47 -0
  113. package/config/audit-execution-artifacts.yaml +20 -0
  114. package/config/bootstrap.yaml +6 -0
  115. package/config/external-execution-artifacts.yaml +16 -0
  116. package/config/host-adapter.yaml +30 -0
  117. package/config/host-profile.yaml +29 -0
  118. package/config/installer-evidence.yaml +31 -0
  119. package/config/skill-installer.yaml +23 -0
  120. package/config/skill-manifest.yaml +46 -0
  121. package/config/skills.yaml +30 -0
  122. package/config/spec-generation-inputs.yaml +25 -0
  123. package/contracts/acceptance.schema.yaml +16 -0
  124. package/contracts/admission-checklist.schema.yaml +15 -0
  125. package/contracts/audit-chunk.schema.yaml +110 -0
  126. package/contracts/audit-closeout.schema.yaml +51 -0
  127. package/contracts/audit-finding.schema.yaml +61 -0
  128. package/contracts/audit-ledger.schema.yaml +138 -0
  129. package/contracts/audit-plan.schema.yaml +123 -0
  130. package/contracts/audit-remediation-map.schema.yaml +51 -0
  131. package/contracts/audit-rerun.schema.yaml +31 -0
  132. package/contracts/audit-sweep-result.yaml +49 -0
  133. package/contracts/authority-convergence-audit.schema.yaml +19 -0
  134. package/contracts/closeout.schema.yaml +25 -0
  135. package/contracts/decision-review.schema.yaml +16 -0
  136. package/contracts/doc-spec-audit-result.yaml +19 -0
  137. package/contracts/execution-packet.schema.yaml +49 -0
  138. package/contracts/external-host-compatibility.yaml +22 -0
  139. package/contracts/forbidden-shortcuts.catalog.yaml +23 -0
  140. package/contracts/high-risk-admission.schema.yaml +23 -0
  141. package/contracts/high-risk-execution-result.yaml +20 -0
  142. package/contracts/orchestration-state.schema.yaml +41 -0
  143. package/contracts/overflow-continuation.schema.yaml +12 -0
  144. package/contracts/packet.schema.yaml +30 -0
  145. package/contracts/pending-note.schema.yaml +17 -0
  146. package/contracts/prompt.schema.yaml +12 -0
  147. package/contracts/remediation.schema.yaml +16 -0
  148. package/contracts/result.schema.yaml +24 -0
  149. package/contracts/spec-generation-audit.schema.yaml +31 -0
  150. package/contracts/spec-generation-inputs.schema.yaml +39 -0
  151. package/contracts/spec-reconstruction-result.yaml +37 -0
  152. package/contracts/topic-goal.schema.yaml +78 -0
  153. package/contracts/topic-run-ledger.schema.yaml +72 -0
  154. package/contracts/topic-step-decision.schema.yaml +45 -0
  155. package/contracts/topic.schema.yaml +65 -0
  156. package/contracts/true-close.schema.yaml +15 -0
  157. package/contracts/wave.schema.yaml +29 -0
  158. package/contracts/worker-output.schema.yaml +15 -0
  159. package/methodology/audit-sweep-p0p1-recall.yaml +45 -0
  160. package/methodology/authority-convergence-policy.yaml +42 -0
  161. package/methodology/core.yaml +25 -0
  162. package/methodology/four-closure-policy.yaml +28 -0
  163. package/methodology/overflow-continuation-policy.yaml +14 -0
  164. package/methodology/role-separation-policy.yaml +28 -0
  165. package/methodology/skill-exchange-projection.yaml +114 -0
  166. package/methodology/skill-handoff.yaml +34 -0
  167. package/methodology/skill-installer-result.yaml +27 -0
  168. package/methodology/skill-installer-summary-projection.yaml +181 -0
  169. package/methodology/skill-runtime.yaml +23 -0
  170. package/methodology/spec-reconstruction.yaml +63 -0
  171. package/methodology/spec-target-truth-profile.yaml +53 -0
  172. package/methodology/topic-lifecycle-report.yaml +144 -0
  173. package/methodology/topic-lifecycle.yaml +37 -0
  174. package/methodology/topic-naming-ontology.yaml +21 -0
  175. package/methodology/topic-ontology.yaml +38 -0
  176. package/methodology/topic-validation-policy.yaml +9 -0
  177. package/methodology/wave-dag-policy.yaml +14 -0
  178. package/package.json +50 -0
  179. package/spec/_meta/command-gating-matrix.yaml +110 -0
  180. package/spec/_meta/generate-drift-migration-checklist.yaml +155 -0
  181. package/spec/_meta/governance-routing-cutover-checklist.yaml +35 -0
  182. package/spec/_meta/phase2-impacted-surface-matrix.yaml +44 -0
  183. package/spec/_meta/spec-authority-cutover-readiness.yaml +104 -0
  184. package/spec/_meta/spec-tree-model.yaml +72 -0
  185. package/spec/bootstrap-state.yaml +99 -0
  186. package/spec/product-scope.yaml +56 -0
@@ -0,0 +1,169 @@
1
+ import process from "node:process";
2
+
3
+ import { runTopicRunner, runTopicRunnerStep } from "../lib/topic-runner.mjs";
4
+ import { resolveTopicProjectRoot } from "../lib/topic.mjs";
5
+ import {
6
+ localize,
7
+ styleHeading,
8
+ styleLabel,
9
+ } from "../lib/ui.mjs";
10
+
11
+ const ADAPTER_IDS = ["codex", "oh_my_codex", "claude"];
12
+
13
+ function requireOptionValue(name, next) {
14
+ if (!next || next.startsWith("--")) {
15
+ return {
16
+ ok: false,
17
+ error: `nimicoding topic-runner refused: ${name} requires a value.\n`,
18
+ };
19
+ }
20
+ return { ok: true };
21
+ }
22
+
23
+ function parseTopicRunnerOptions(args) {
24
+ const [mode, topicInput, ...rest] = args;
25
+ if (!["step", "run"].includes(mode) || !topicInput) {
26
+ return {
27
+ ok: false,
28
+ error: localize(
29
+ "nimicoding topic-runner refused: expected <step|run> <topic-id> --run-id <id> --adapter <codex|oh_my_codex|claude>.\n",
30
+ "nimicoding topic-runner 已拒绝:需要 <step|run> <topic-id> --run-id <id> --adapter <codex|oh_my_codex|claude>。\n",
31
+ ),
32
+ };
33
+ }
34
+
35
+ const options = {
36
+ mode,
37
+ topicInput,
38
+ runId: null,
39
+ adapter: null,
40
+ executeHost: false,
41
+ threadId: null,
42
+ maxSteps: 20,
43
+ verifiedAt: null,
44
+ json: false,
45
+ };
46
+
47
+ for (let index = 0; index < rest.length; index += 1) {
48
+ const arg = rest[index];
49
+ const next = rest[index + 1];
50
+ if (arg === "--json") {
51
+ options.json = true;
52
+ continue;
53
+ }
54
+ if (arg === "--execute-host") {
55
+ options.executeHost = true;
56
+ continue;
57
+ }
58
+ if (arg === "--run-id") {
59
+ const check = requireOptionValue("--run-id", next);
60
+ if (!check.ok) return check;
61
+ options.runId = next;
62
+ index += 1;
63
+ continue;
64
+ }
65
+ if (arg === "--adapter") {
66
+ const check = requireOptionValue("--adapter", next);
67
+ if (!check.ok) return check;
68
+ options.adapter = next;
69
+ index += 1;
70
+ continue;
71
+ }
72
+ if (arg === "--thread-id") {
73
+ const check = requireOptionValue("--thread-id", next);
74
+ if (!check.ok) return check;
75
+ options.threadId = next;
76
+ index += 1;
77
+ continue;
78
+ }
79
+ if (arg === "--max-steps") {
80
+ const check = requireOptionValue("--max-steps", next);
81
+ if (!check.ok) return check;
82
+ options.maxSteps = Number(next);
83
+ index += 1;
84
+ continue;
85
+ }
86
+ if (arg === "--verified-at") {
87
+ const check = requireOptionValue("--verified-at", next);
88
+ if (!check.ok) return check;
89
+ options.verifiedAt = next;
90
+ index += 1;
91
+ continue;
92
+ }
93
+ return {
94
+ ok: false,
95
+ error: `nimicoding topic-runner refused: unknown option ${arg}.\n`,
96
+ };
97
+ }
98
+
99
+ if (!options.runId || !options.adapter) {
100
+ return {
101
+ ok: false,
102
+ error: "nimicoding topic-runner refused: --run-id and --adapter are required.\n",
103
+ };
104
+ }
105
+ if (!ADAPTER_IDS.includes(options.adapter)) {
106
+ return {
107
+ ok: false,
108
+ error: `nimicoding topic-runner refused: --adapter must be one of ${ADAPTER_IDS.join(", ")}.\n`,
109
+ };
110
+ }
111
+ if (!Number.isInteger(options.maxSteps) || options.maxSteps <= 0) {
112
+ return {
113
+ ok: false,
114
+ error: "nimicoding topic-runner refused: --max-steps must be a positive integer.\n",
115
+ };
116
+ }
117
+
118
+ return { ok: true, options };
119
+ }
120
+
121
+ function writeJson(command, payload) {
122
+ process.stdout.write(`${JSON.stringify({
123
+ contract: "nimicoding.topic-runner-result.v1",
124
+ command,
125
+ ...payload,
126
+ }, null, 2)}\n`);
127
+ }
128
+
129
+ function formatRunnerResult(payload) {
130
+ return `${styleHeading(`nimicoding topic-runner: ${payload.topicId ?? "unknown"}`)}
131
+
132
+ ${styleLabel(localize("Run", "Run"))}: ${payload.runId ?? "unknown"}
133
+ ${styleLabel(localize("Adapter", "Adapter"))}: ${payload.adapter ?? "unknown"}
134
+ ${styleLabel(localize("Status", "状态"))}: ${payload.runnerStatus ?? (payload.ok ? "ok" : "failed")}
135
+ ${styleLabel(localize("Stop Class", "Stop Class"))}: ${payload.stopClass ?? "none"}
136
+ ${styleLabel(localize("Action", "动作"))}: ${payload.recommendedAction ?? "none"}
137
+ ${styleLabel(localize("Ledger", "Ledger"))}: ${payload.ledgerRef ?? "none"}
138
+ `;
139
+ }
140
+
141
+ export async function runTopicRunnerCommand(args) {
142
+ const parsed = parseTopicRunnerOptions(args);
143
+ if (!parsed.ok) {
144
+ process.stderr.write(parsed.error);
145
+ return 2;
146
+ }
147
+
148
+ const projectRoot = await resolveTopicProjectRoot(process.cwd());
149
+ const { options } = parsed;
150
+ const payload = options.mode === "step"
151
+ ? await runTopicRunnerStep(projectRoot, options)
152
+ : await runTopicRunner(projectRoot, options);
153
+
154
+ if (!payload.ok) {
155
+ if (options.json) {
156
+ writeJson(`topic-runner.${options.mode}`, payload);
157
+ } else {
158
+ process.stderr.write(`${payload.error}\n`);
159
+ }
160
+ return 1;
161
+ }
162
+
163
+ if (options.json) {
164
+ writeJson(`topic-runner.${options.mode}`, payload);
165
+ } else {
166
+ process.stdout.write(formatRunnerResult(payload));
167
+ }
168
+ return 0;
169
+ }