@nimiplatform/nimi-coding 0.2.7 → 0.3.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 (207) hide show
  1. package/CHANGELOG.md +8 -80
  2. package/CONTRIBUTING.md +5 -34
  3. package/README.md +47 -350
  4. package/README.zh-CN.md +33 -287
  5. package/cli/commands/start.mjs +48 -688
  6. package/cli/commands/validate-spec-audit.mjs +1 -5
  7. package/cli/constants.mjs +9 -417
  8. package/cli/dev/run-cli-smoke.mjs +24 -0
  9. package/cli/dev/run-suite.mjs +17 -0
  10. package/cli/help.mjs +28 -145
  11. package/cli/index.mjs +5 -33
  12. package/cli/lib/blueprint-audit.mjs +5 -12
  13. package/cli/lib/bootstrap.mjs +0 -9
  14. package/cli/lib/contracts.mjs +0 -163
  15. package/cli/lib/doctor.mjs +155 -10
  16. package/cli/lib/entrypoints.mjs +63 -167
  17. package/cli/lib/internal/contracts-loaders.mjs +0 -85
  18. package/cli/lib/internal/contracts-parse.mjs +84 -520
  19. package/cli/lib/internal/governance/ai/check-agents-freshness.mjs +13 -8
  20. package/cli/lib/internal/surface-taxonomy-validators.mjs +316 -66
  21. package/cli/lib/internal/validators-shared.mjs +0 -16
  22. package/cli/lib/internal/validators-spec-helpers.mjs +7 -140
  23. package/cli/lib/internal/validators-spec.mjs +103 -342
  24. package/cli/lib/shared.mjs +1 -42
  25. package/cli/lib/validators.mjs +0 -48
  26. package/cli/seeds/seed-policy.yaml +0 -3
  27. package/config/bootstrap.yaml +4 -4
  28. package/config/spec-generation-inputs.yaml +6 -12
  29. package/contracts/domain-admission.schema.yaml +3 -3
  30. package/contracts/migration-inventory.schema.yaml +12 -75
  31. package/contracts/negative-fixtures.yaml +19 -99
  32. package/contracts/placement-contract.schema.yaml +49 -78
  33. package/contracts/projection-edge.schema.yaml +37 -121
  34. package/contracts/shared-enums.yaml +4 -8
  35. package/contracts/spec-generation-inputs.schema.yaml +15 -112
  36. package/contracts/spec-layout.schema.yaml +32 -0
  37. package/contracts/surface-taxonomy.schema.yaml +43 -94
  38. package/contracts/table-family.schema.yaml +1 -1
  39. package/contracts/tracked-output-admission.schema.yaml +13 -66
  40. package/methodology/core.yaml +33 -25
  41. package/methodology/four-closure-policy.yaml +18 -26
  42. package/methodology/role-separation-policy.yaml +21 -27
  43. package/methodology/spec-reconstruction.yaml +17 -34
  44. package/package.json +4 -6
  45. package/spec/_meta/spec-tree-model.yaml +5 -101
  46. package/spec/product-scope.yaml +25 -57
  47. package/adapters/README.md +0 -25
  48. package/adapters/claude/README.md +0 -89
  49. package/adapters/claude/profile.yaml +0 -70
  50. package/adapters/codex/README.md +0 -53
  51. package/adapters/codex/profile.yaml +0 -78
  52. package/adapters/oh-my-codex/README.md +0 -184
  53. package/adapters/oh-my-codex/profile.yaml +0 -46
  54. package/cli/commands/admit-high-risk-decision.mjs +0 -108
  55. package/cli/commands/audit-sweep.mjs +0 -364
  56. package/cli/commands/closeout.mjs +0 -186
  57. package/cli/commands/decide-high-risk-execution.mjs +0 -124
  58. package/cli/commands/handoff.mjs +0 -123
  59. package/cli/commands/ingest-high-risk-execution.mjs +0 -95
  60. package/cli/commands/review-high-risk-execution.mjs +0 -95
  61. package/cli/commands/sweep-design.mjs +0 -295
  62. package/cli/commands/sweep.mjs +0 -22
  63. package/cli/commands/topic-formatters.mjs +0 -382
  64. package/cli/commands/topic-goal.mjs +0 -33
  65. package/cli/commands/topic-options-shared.mjs +0 -27
  66. package/cli/commands/topic-options-workflow.mjs +0 -767
  67. package/cli/commands/topic-options.mjs +0 -626
  68. package/cli/commands/topic-runner.mjs +0 -169
  69. package/cli/commands/topic.mjs +0 -795
  70. package/cli/commands/validate-acceptance.mjs +0 -5
  71. package/cli/commands/validate-execution-packet.mjs +0 -5
  72. package/cli/commands/validate-orchestration-state.mjs +0 -5
  73. package/cli/commands/validate-prompt.mjs +0 -5
  74. package/cli/commands/validate-worker-output.mjs +0 -5
  75. package/cli/lib/adapter-profiles.mjs +0 -403
  76. package/cli/lib/audit-execution.mjs +0 -52
  77. package/cli/lib/audit-sweep-runtime/admissions.mjs +0 -508
  78. package/cli/lib/audit-sweep-runtime/audit-validity.mjs +0 -356
  79. package/cli/lib/audit-sweep-runtime/chunks.mjs +0 -697
  80. package/cli/lib/audit-sweep-runtime/claude-auditor.mjs +0 -647
  81. package/cli/lib/audit-sweep-runtime/closeout.mjs +0 -144
  82. package/cli/lib/audit-sweep-runtime/codex-auditor-evidence.mjs +0 -654
  83. package/cli/lib/audit-sweep-runtime/codex-auditor.mjs +0 -516
  84. package/cli/lib/audit-sweep-runtime/common.mjs +0 -341
  85. package/cli/lib/audit-sweep-runtime/coverage-quality.mjs +0 -172
  86. package/cli/lib/audit-sweep-runtime/evidence-assignment.mjs +0 -155
  87. package/cli/lib/audit-sweep-runtime/format.mjs +0 -57
  88. package/cli/lib/audit-sweep-runtime/ingest.mjs +0 -486
  89. package/cli/lib/audit-sweep-runtime/inventory-spec-chunks.mjs +0 -425
  90. package/cli/lib/audit-sweep-runtime/inventory.mjs +0 -798
  91. package/cli/lib/audit-sweep-runtime/ledger.mjs +0 -315
  92. package/cli/lib/audit-sweep-runtime/p0p1-profile.mjs +0 -101
  93. package/cli/lib/audit-sweep-runtime/remediation.mjs +0 -349
  94. package/cli/lib/audit-sweep-runtime/rerun.mjs +0 -129
  95. package/cli/lib/audit-sweep-runtime/risk-budget.mjs +0 -300
  96. package/cli/lib/audit-sweep-runtime/status.mjs +0 -62
  97. package/cli/lib/audit-sweep-runtime/validators-ledger.mjs +0 -215
  98. package/cli/lib/audit-sweep-runtime/validators.mjs +0 -797
  99. package/cli/lib/audit-sweep.mjs +0 -19
  100. package/cli/lib/authority-convergence.mjs +0 -704
  101. package/cli/lib/closeout.mjs +0 -732
  102. package/cli/lib/codex-sdk-runner.mjs +0 -76
  103. package/cli/lib/external-execution.mjs +0 -101
  104. package/cli/lib/handoff.mjs +0 -812
  105. package/cli/lib/high-risk-admission.mjs +0 -512
  106. package/cli/lib/high-risk-decision.mjs +0 -353
  107. package/cli/lib/high-risk-ingest.mjs +0 -321
  108. package/cli/lib/high-risk-review.mjs +0 -267
  109. package/cli/lib/internal/contracts-parse-high-risk.mjs +0 -131
  110. package/cli/lib/internal/contracts-validators.mjs +0 -399
  111. package/cli/lib/internal/doctor-bootstrap-surface.mjs +0 -406
  112. package/cli/lib/internal/doctor-delegated-surface.mjs +0 -256
  113. package/cli/lib/internal/doctor-finalize.mjs +0 -383
  114. package/cli/lib/internal/doctor-format.mjs +0 -286
  115. package/cli/lib/internal/doctor-inspectors.mjs +0 -327
  116. package/cli/lib/internal/doctor-state.mjs +0 -205
  117. package/cli/lib/internal/validators-artifacts.mjs +0 -515
  118. package/cli/lib/sweep-design-runtime/common.mjs +0 -246
  119. package/cli/lib/sweep-design-runtime/engine.mjs +0 -733
  120. package/cli/lib/sweep-design-runtime/fix-topic.mjs +0 -414
  121. package/cli/lib/sweep-design-runtime/lifecycle.mjs +0 -54
  122. package/cli/lib/sweep-design-runtime/results.mjs +0 -324
  123. package/cli/lib/sweep-design.mjs +0 -8
  124. package/cli/lib/topic-artifacts.mjs +0 -186
  125. package/cli/lib/topic-authority-coverage.mjs +0 -73
  126. package/cli/lib/topic-closeout.mjs +0 -560
  127. package/cli/lib/topic-common.mjs +0 -404
  128. package/cli/lib/topic-decisions.mjs +0 -332
  129. package/cli/lib/topic-draft-packets.mjs +0 -167
  130. package/cli/lib/topic-execution.mjs +0 -515
  131. package/cli/lib/topic-goal.mjs +0 -440
  132. package/cli/lib/topic-ledger.mjs +0 -281
  133. package/cli/lib/topic-lifecycle-artifacts.mjs +0 -173
  134. package/cli/lib/topic-root-validation.mjs +0 -288
  135. package/cli/lib/topic-runner-commands.mjs +0 -174
  136. package/cli/lib/topic-runner-deferral.mjs +0 -532
  137. package/cli/lib/topic-runner-stale-gates.mjs +0 -114
  138. package/cli/lib/topic-runner-validation.mjs +0 -138
  139. package/cli/lib/topic-runner.mjs +0 -727
  140. package/cli/lib/topic-scaffold.mjs +0 -252
  141. package/cli/lib/topic-waves.mjs +0 -403
  142. package/cli/lib/topic.mjs +0 -81
  143. package/config/audit-execution-artifacts.yaml +0 -20
  144. package/config/external-execution-artifacts.yaml +0 -16
  145. package/config/host-adapter.yaml +0 -30
  146. package/config/host-profile.yaml +0 -29
  147. package/config/installer-evidence.yaml +0 -31
  148. package/config/skill-installer.yaml +0 -23
  149. package/config/skill-manifest.yaml +0 -48
  150. package/config/skills.yaml +0 -30
  151. package/contracts/acceptance.schema.yaml +0 -16
  152. package/contracts/admission-checklist.schema.yaml +0 -15
  153. package/contracts/audit-chunk.schema.yaml +0 -123
  154. package/contracts/audit-closeout.schema.yaml +0 -51
  155. package/contracts/audit-finding.schema.yaml +0 -61
  156. package/contracts/audit-ledger.schema.yaml +0 -138
  157. package/contracts/audit-plan.schema.yaml +0 -138
  158. package/contracts/audit-remediation-map.schema.yaml +0 -52
  159. package/contracts/audit-rerun.schema.yaml +0 -31
  160. package/contracts/audit-sweep-result.yaml +0 -53
  161. package/contracts/authority-convergence-audit.schema.yaml +0 -19
  162. package/contracts/closeout.schema.yaml +0 -25
  163. package/contracts/decision-review.schema.yaml +0 -16
  164. package/contracts/doc-spec-audit-result.yaml +0 -19
  165. package/contracts/execution-packet.schema.yaml +0 -49
  166. package/contracts/external-host-compatibility.yaml +0 -22
  167. package/contracts/forbidden-shortcuts.catalog.yaml +0 -23
  168. package/contracts/high-risk-admission.schema.yaml +0 -23
  169. package/contracts/high-risk-execution-result.yaml +0 -20
  170. package/contracts/orchestration-state.schema.yaml +0 -41
  171. package/contracts/overflow-continuation.schema.yaml +0 -12
  172. package/contracts/packet.schema.yaml +0 -30
  173. package/contracts/pending-note.schema.yaml +0 -17
  174. package/contracts/prompt.schema.yaml +0 -12
  175. package/contracts/remediation.schema.yaml +0 -16
  176. package/contracts/result.schema.yaml +0 -24
  177. package/contracts/spec-reconstruction-result.yaml +0 -41
  178. package/contracts/sweep-design-result.yaml +0 -349
  179. package/contracts/topic-goal.schema.yaml +0 -87
  180. package/contracts/topic-run-ledger.schema.yaml +0 -72
  181. package/contracts/topic-step-decision.schema.yaml +0 -45
  182. package/contracts/topic.schema.yaml +0 -65
  183. package/contracts/true-close.schema.yaml +0 -15
  184. package/contracts/wave.schema.yaml +0 -29
  185. package/contracts/worker-output.schema.yaml +0 -15
  186. package/contracts/workflow-consumer.schema.yaml +0 -110
  187. package/methodology/audit-sweep-p0p1-recall.yaml +0 -45
  188. package/methodology/authority-convergence-policy.yaml +0 -42
  189. package/methodology/overflow-continuation-policy.yaml +0 -14
  190. package/methodology/skill-exchange-projection.yaml +0 -114
  191. package/methodology/skill-handoff.yaml +0 -34
  192. package/methodology/skill-installer-result.yaml +0 -27
  193. package/methodology/skill-installer-summary-projection.yaml +0 -181
  194. package/methodology/skill-runtime.yaml +0 -23
  195. package/methodology/spec-target-truth-profile.yaml +0 -46
  196. package/methodology/topic-lifecycle-report.yaml +0 -144
  197. package/methodology/topic-lifecycle.yaml +0 -37
  198. package/methodology/topic-naming-ontology.yaml +0 -21
  199. package/methodology/topic-ontology.yaml +0 -38
  200. package/methodology/topic-validation-policy.yaml +0 -9
  201. package/methodology/wave-dag-policy.yaml +0 -14
  202. package/spec/_meta/command-gating-matrix.yaml +0 -143
  203. package/spec/_meta/generate-drift-migration-checklist.yaml +0 -137
  204. package/spec/_meta/governance-routing-cutover-checklist.yaml +0 -35
  205. package/spec/_meta/phase2-impacted-surface-matrix.yaml +0 -44
  206. package/spec/_meta/spec-authority-cutover-readiness.yaml +0 -102
  207. package/spec/bootstrap-state.yaml +0 -99
@@ -1,76 +0,0 @@
1
- function requireNonEmptyString(value, field) {
2
- if (typeof value !== "string" || value.trim().length === 0) {
3
- return `${field} must be a non-empty string`;
4
- }
5
- return null;
6
- }
7
-
8
- function normalizeCodexResult(result) {
9
- return {
10
- raw: result,
11
- finalResponse: typeof result?.final_response === "string"
12
- ? result.final_response
13
- : typeof result?.finalResponse === "string"
14
- ? result.finalResponse
15
- : typeof result === "string"
16
- ? result
17
- : null,
18
- };
19
- }
20
-
21
- async function loadCodexSdk() {
22
- try {
23
- return await import("@openai/codex-sdk");
24
- } catch (error) {
25
- return {
26
- loadError: error,
27
- };
28
- }
29
- }
30
-
31
- export async function runNativeCodexSdkPrompt(options) {
32
- const promptError = requireNonEmptyString(options?.prompt, "prompt");
33
- if (promptError) {
34
- return {
35
- ok: false,
36
- error: `native Codex SDK dispatch refused: ${promptError}`,
37
- };
38
- }
39
-
40
- if (options.threadId !== undefined && options.threadId !== null) {
41
- const threadError = requireNonEmptyString(options.threadId, "threadId");
42
- if (threadError) {
43
- return {
44
- ok: false,
45
- error: `native Codex SDK dispatch refused: ${threadError}`,
46
- };
47
- }
48
- }
49
-
50
- let codex = options.codex ?? null;
51
- if (!codex) {
52
- const sdk = await loadCodexSdk();
53
- if (!sdk.Codex) {
54
- return {
55
- ok: false,
56
- error: "native Codex SDK dispatch refused: @openai/codex-sdk is not installed or does not export Codex",
57
- };
58
- }
59
- codex = new sdk.Codex();
60
- }
61
- const thread = options.threadId
62
- ? codex.resumeThread(options.threadId)
63
- : codex.startThread();
64
- const result = await thread.run(options.prompt);
65
- const normalized = normalizeCodexResult(result);
66
-
67
- return {
68
- ok: true,
69
- adapterId: "codex",
70
- sdkPackage: "@openai/codex-sdk",
71
- mode: options.threadId ? "resume_thread" : "start_thread",
72
- threadId: options.threadId ?? thread.id ?? result?.thread_id ?? null,
73
- finalResponse: normalized.finalResponse,
74
- result: normalized.raw,
75
- };
76
- }
@@ -1,101 +0,0 @@
1
- import path from "node:path";
2
-
3
- import {
4
- EXTERNAL_EXECUTION_ARTIFACTS_CONFIG_REF,
5
- HIGH_RISK_EXECUTION_ARTIFACT_HARD_CONSTRAINTS,
6
- HIGH_RISK_EXECUTION_ARTIFACT_ROOTS,
7
- HIGH_RISK_EXECUTION_RESULT_CONTRACT_REF,
8
- HOST_ADAPTER_CONFIG_REF,
9
- } from "../constants.mjs";
10
- import { readTextIfFile } from "./fs-helpers.mjs";
11
- import { arraysEqual, isPlainObject, toStringArray } from "./value-helpers.mjs";
12
- import { parseYamlText } from "./yaml-helpers.mjs";
13
-
14
- function parseExternalExecutionArtifactsConfig(text) {
15
- const parsed = parseYamlText(text);
16
- const root = parsed?.external_execution_artifacts;
17
- const artifactRoots = isPlainObject(root?.artifact_roots) ? root.artifact_roots : null;
18
- const hardConstraints = toStringArray(root?.hard_constraints);
19
-
20
- const artifactRootsOk = Boolean(artifactRoots)
21
- && Object.entries(HIGH_RISK_EXECUTION_ARTIFACT_ROOTS).every(
22
- ([field, expectedPath]) => String(artifactRoots[field] ?? "") === expectedPath,
23
- )
24
- && Object.keys(artifactRoots).length === Object.keys(HIGH_RISK_EXECUTION_ARTIFACT_ROOTS).length;
25
-
26
- return {
27
- ok: String(root?.skill_id ?? "") === "high_risk_execution"
28
- && String(root?.host_adapter_ref ?? "") === HOST_ADAPTER_CONFIG_REF
29
- && String(root?.result_contract_ref ?? "") === HIGH_RISK_EXECUTION_RESULT_CONTRACT_REF
30
- && String(root?.locality ?? "") === "local_only"
31
- && artifactRootsOk
32
- && arraysEqual(hardConstraints, HIGH_RISK_EXECUTION_ARTIFACT_HARD_CONSTRAINTS),
33
- artifactRoots: artifactRootsOk
34
- ? Object.fromEntries(
35
- Object.entries(HIGH_RISK_EXECUTION_ARTIFACT_ROOTS).map(([field]) => [field, artifactRoots[field]]),
36
- )
37
- : null,
38
- hardConstraints,
39
- };
40
- }
41
-
42
- function normalizeRef(ref) {
43
- return path.posix.normalize(String(ref ?? "")).replace(/^\.\/+/, "");
44
- }
45
-
46
- function isRefUnderRoot(ref, root) {
47
- const normalizedRef = normalizeRef(ref);
48
- const normalizedRoot = normalizeRef(root);
49
-
50
- return normalizedRef === normalizedRoot || normalizedRef.startsWith(`${normalizedRoot}/`);
51
- }
52
-
53
- export async function loadExternalExecutionArtifactsConfig(projectRoot) {
54
- const text = await readTextIfFile(
55
- path.join(projectRoot, EXTERNAL_EXECUTION_ARTIFACTS_CONFIG_REF),
56
- );
57
-
58
- return {
59
- path: EXTERNAL_EXECUTION_ARTIFACTS_CONFIG_REF,
60
- text,
61
- ...parseExternalExecutionArtifactsConfig(text),
62
- };
63
- }
64
-
65
- export function validateHighRiskExecutionArtifactRefs(summary, config) {
66
- if (!config.ok || !config.artifactRoots) {
67
- return {
68
- ok: false,
69
- reason: "external execution artifacts config is missing or malformed",
70
- };
71
- }
72
-
73
- for (const field of [
74
- "packet_ref",
75
- "orchestration_state_ref",
76
- "prompt_ref",
77
- "worker_output_ref",
78
- ]) {
79
- const expectedRoot = config.artifactRoots[field];
80
- if (!isRefUnderRoot(summary[field], expectedRoot)) {
81
- return {
82
- ok: false,
83
- reason: `high_risk_execution summary.${field} must stay under ${expectedRoot}`,
84
- };
85
- }
86
- }
87
-
88
- const evidenceRoot = config.artifactRoots.evidence_refs;
89
- for (const ref of summary.evidence_refs) {
90
- if (!isRefUnderRoot(ref, evidenceRoot)) {
91
- return {
92
- ok: false,
93
- reason: `high_risk_execution summary.evidence_refs entries must stay under ${evidenceRoot}`,
94
- };
95
- }
96
- }
97
-
98
- return {
99
- ok: true,
100
- };
101
- }