@nimiplatform/nimi-coding 0.2.8 → 0.3.1

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 (206) hide show
  1. package/CHANGELOG.md +10 -90
  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/commands/validate-spec-governance.mjs +20 -0
  8. package/cli/constants.mjs +9 -417
  9. package/cli/help.mjs +28 -145
  10. package/cli/index.mjs +5 -33
  11. package/cli/lib/blueprint-audit.mjs +5 -12
  12. package/cli/lib/bootstrap.mjs +0 -9
  13. package/cli/lib/contracts.mjs +0 -163
  14. package/cli/lib/doctor.mjs +155 -10
  15. package/cli/lib/entrypoints.mjs +63 -167
  16. package/cli/lib/internal/contracts-loaders.mjs +0 -85
  17. package/cli/lib/internal/contracts-parse.mjs +84 -520
  18. package/cli/lib/internal/governance/ai/check-agents-freshness.mjs +13 -8
  19. package/cli/lib/internal/surface-taxonomy-validators.mjs +316 -66
  20. package/cli/lib/internal/validators-shared.mjs +0 -16
  21. package/cli/lib/internal/validators-spec-helpers.mjs +7 -140
  22. package/cli/lib/internal/validators-spec.mjs +103 -342
  23. package/cli/lib/shared.mjs +1 -42
  24. package/cli/lib/validators.mjs +0 -48
  25. package/cli/seeds/seed-policy.yaml +0 -3
  26. package/config/bootstrap.yaml +4 -4
  27. package/config/spec-generation-inputs.yaml +6 -12
  28. package/contracts/domain-admission.schema.yaml +3 -3
  29. package/contracts/migration-inventory.schema.yaml +12 -75
  30. package/contracts/negative-fixtures.yaml +19 -99
  31. package/contracts/placement-contract.schema.yaml +49 -78
  32. package/contracts/projection-edge.schema.yaml +37 -121
  33. package/contracts/shared-enums.yaml +4 -8
  34. package/contracts/spec-generation-inputs.schema.yaml +15 -112
  35. package/contracts/spec-layout.schema.yaml +32 -0
  36. package/contracts/surface-taxonomy.schema.yaml +43 -94
  37. package/contracts/table-family.schema.yaml +1 -1
  38. package/contracts/tracked-output-admission.schema.yaml +13 -66
  39. package/methodology/core.yaml +33 -25
  40. package/methodology/four-closure-policy.yaml +18 -26
  41. package/methodology/role-separation-policy.yaml +21 -27
  42. package/methodology/spec-reconstruction.yaml +17 -34
  43. package/package.json +2 -4
  44. package/spec/_meta/spec-tree-model.yaml +5 -101
  45. package/spec/product-scope.yaml +25 -57
  46. package/adapters/README.md +0 -25
  47. package/adapters/claude/README.md +0 -89
  48. package/adapters/claude/profile.yaml +0 -70
  49. package/adapters/codex/README.md +0 -53
  50. package/adapters/codex/profile.yaml +0 -78
  51. package/adapters/oh-my-codex/README.md +0 -184
  52. package/adapters/oh-my-codex/profile.yaml +0 -46
  53. package/cli/commands/admit-high-risk-decision.mjs +0 -108
  54. package/cli/commands/audit-sweep.mjs +0 -364
  55. package/cli/commands/closeout.mjs +0 -186
  56. package/cli/commands/decide-high-risk-execution.mjs +0 -124
  57. package/cli/commands/handoff.mjs +0 -123
  58. package/cli/commands/ingest-high-risk-execution.mjs +0 -95
  59. package/cli/commands/review-high-risk-execution.mjs +0 -95
  60. package/cli/commands/sweep-design.mjs +0 -295
  61. package/cli/commands/sweep.mjs +0 -22
  62. package/cli/commands/topic-formatters.mjs +0 -382
  63. package/cli/commands/topic-goal.mjs +0 -33
  64. package/cli/commands/topic-options-shared.mjs +0 -27
  65. package/cli/commands/topic-options-workflow.mjs +0 -767
  66. package/cli/commands/topic-options.mjs +0 -626
  67. package/cli/commands/topic-runner.mjs +0 -169
  68. package/cli/commands/topic.mjs +0 -795
  69. package/cli/commands/validate-acceptance.mjs +0 -5
  70. package/cli/commands/validate-execution-packet.mjs +0 -5
  71. package/cli/commands/validate-orchestration-state.mjs +0 -5
  72. package/cli/commands/validate-prompt.mjs +0 -5
  73. package/cli/commands/validate-worker-output.mjs +0 -5
  74. package/cli/lib/adapter-profiles.mjs +0 -403
  75. package/cli/lib/audit-execution.mjs +0 -52
  76. package/cli/lib/audit-sweep-runtime/admissions.mjs +0 -508
  77. package/cli/lib/audit-sweep-runtime/audit-validity.mjs +0 -356
  78. package/cli/lib/audit-sweep-runtime/chunks.mjs +0 -697
  79. package/cli/lib/audit-sweep-runtime/claude-auditor.mjs +0 -658
  80. package/cli/lib/audit-sweep-runtime/closeout.mjs +0 -144
  81. package/cli/lib/audit-sweep-runtime/codex-auditor-evidence.mjs +0 -654
  82. package/cli/lib/audit-sweep-runtime/codex-auditor.mjs +0 -527
  83. package/cli/lib/audit-sweep-runtime/common.mjs +0 -341
  84. package/cli/lib/audit-sweep-runtime/coverage-quality.mjs +0 -172
  85. package/cli/lib/audit-sweep-runtime/evidence-assignment.mjs +0 -155
  86. package/cli/lib/audit-sweep-runtime/format.mjs +0 -57
  87. package/cli/lib/audit-sweep-runtime/ingest.mjs +0 -486
  88. package/cli/lib/audit-sweep-runtime/inventory-spec-chunks.mjs +0 -425
  89. package/cli/lib/audit-sweep-runtime/inventory.mjs +0 -798
  90. package/cli/lib/audit-sweep-runtime/ledger.mjs +0 -315
  91. package/cli/lib/audit-sweep-runtime/p0p1-profile.mjs +0 -101
  92. package/cli/lib/audit-sweep-runtime/remediation.mjs +0 -349
  93. package/cli/lib/audit-sweep-runtime/rerun.mjs +0 -129
  94. package/cli/lib/audit-sweep-runtime/risk-budget.mjs +0 -300
  95. package/cli/lib/audit-sweep-runtime/status.mjs +0 -62
  96. package/cli/lib/audit-sweep-runtime/validators-ledger.mjs +0 -215
  97. package/cli/lib/audit-sweep-runtime/validators.mjs +0 -797
  98. package/cli/lib/audit-sweep.mjs +0 -19
  99. package/cli/lib/authority-convergence.mjs +0 -720
  100. package/cli/lib/closeout.mjs +0 -732
  101. package/cli/lib/codex-sdk-runner.mjs +0 -76
  102. package/cli/lib/external-execution.mjs +0 -101
  103. package/cli/lib/handoff.mjs +0 -812
  104. package/cli/lib/high-risk-admission.mjs +0 -512
  105. package/cli/lib/high-risk-decision.mjs +0 -353
  106. package/cli/lib/high-risk-ingest.mjs +0 -321
  107. package/cli/lib/high-risk-review.mjs +0 -267
  108. package/cli/lib/internal/contracts-parse-high-risk.mjs +0 -131
  109. package/cli/lib/internal/contracts-validators.mjs +0 -399
  110. package/cli/lib/internal/doctor-bootstrap-surface.mjs +0 -406
  111. package/cli/lib/internal/doctor-delegated-surface.mjs +0 -256
  112. package/cli/lib/internal/doctor-finalize.mjs +0 -383
  113. package/cli/lib/internal/doctor-format.mjs +0 -286
  114. package/cli/lib/internal/doctor-inspectors.mjs +0 -327
  115. package/cli/lib/internal/doctor-state.mjs +0 -205
  116. package/cli/lib/internal/validators-artifacts.mjs +0 -515
  117. package/cli/lib/sweep-design-runtime/common.mjs +0 -246
  118. package/cli/lib/sweep-design-runtime/engine.mjs +0 -733
  119. package/cli/lib/sweep-design-runtime/fix-topic.mjs +0 -414
  120. package/cli/lib/sweep-design-runtime/lifecycle.mjs +0 -54
  121. package/cli/lib/sweep-design-runtime/results.mjs +0 -324
  122. package/cli/lib/sweep-design.mjs +0 -8
  123. package/cli/lib/topic-artifacts.mjs +0 -186
  124. package/cli/lib/topic-authority-coverage.mjs +0 -73
  125. package/cli/lib/topic-closeout.mjs +0 -560
  126. package/cli/lib/topic-common.mjs +0 -404
  127. package/cli/lib/topic-decisions.mjs +0 -332
  128. package/cli/lib/topic-draft-packets.mjs +0 -167
  129. package/cli/lib/topic-execution.mjs +0 -533
  130. package/cli/lib/topic-goal.mjs +0 -440
  131. package/cli/lib/topic-ledger.mjs +0 -281
  132. package/cli/lib/topic-lifecycle-artifacts.mjs +0 -173
  133. package/cli/lib/topic-root-validation.mjs +0 -288
  134. package/cli/lib/topic-runner-commands.mjs +0 -174
  135. package/cli/lib/topic-runner-deferral.mjs +0 -532
  136. package/cli/lib/topic-runner-stale-gates.mjs +0 -114
  137. package/cli/lib/topic-runner-validation.mjs +0 -138
  138. package/cli/lib/topic-runner.mjs +0 -727
  139. package/cli/lib/topic-scaffold.mjs +0 -252
  140. package/cli/lib/topic-waves.mjs +0 -403
  141. package/cli/lib/topic.mjs +0 -81
  142. package/config/audit-execution-artifacts.yaml +0 -20
  143. package/config/external-execution-artifacts.yaml +0 -16
  144. package/config/host-adapter.yaml +0 -30
  145. package/config/host-profile.yaml +0 -29
  146. package/config/installer-evidence.yaml +0 -31
  147. package/config/skill-installer.yaml +0 -23
  148. package/config/skill-manifest.yaml +0 -48
  149. package/config/skills.yaml +0 -30
  150. package/contracts/acceptance.schema.yaml +0 -16
  151. package/contracts/admission-checklist.schema.yaml +0 -15
  152. package/contracts/audit-chunk.schema.yaml +0 -123
  153. package/contracts/audit-closeout.schema.yaml +0 -51
  154. package/contracts/audit-finding.schema.yaml +0 -61
  155. package/contracts/audit-ledger.schema.yaml +0 -138
  156. package/contracts/audit-plan.schema.yaml +0 -138
  157. package/contracts/audit-remediation-map.schema.yaml +0 -52
  158. package/contracts/audit-rerun.schema.yaml +0 -31
  159. package/contracts/audit-sweep-result.yaml +0 -53
  160. package/contracts/authority-convergence-audit.schema.yaml +0 -19
  161. package/contracts/closeout.schema.yaml +0 -25
  162. package/contracts/decision-review.schema.yaml +0 -16
  163. package/contracts/doc-spec-audit-result.yaml +0 -19
  164. package/contracts/execution-packet.schema.yaml +0 -49
  165. package/contracts/external-host-compatibility.yaml +0 -22
  166. package/contracts/forbidden-shortcuts.catalog.yaml +0 -23
  167. package/contracts/high-risk-admission.schema.yaml +0 -23
  168. package/contracts/high-risk-execution-result.yaml +0 -20
  169. package/contracts/orchestration-state.schema.yaml +0 -41
  170. package/contracts/overflow-continuation.schema.yaml +0 -12
  171. package/contracts/packet.schema.yaml +0 -30
  172. package/contracts/pending-note.schema.yaml +0 -17
  173. package/contracts/prompt.schema.yaml +0 -12
  174. package/contracts/remediation.schema.yaml +0 -16
  175. package/contracts/result.schema.yaml +0 -24
  176. package/contracts/spec-reconstruction-result.yaml +0 -41
  177. package/contracts/sweep-design-result.yaml +0 -349
  178. package/contracts/topic-goal.schema.yaml +0 -87
  179. package/contracts/topic-run-ledger.schema.yaml +0 -72
  180. package/contracts/topic-step-decision.schema.yaml +0 -45
  181. package/contracts/topic.schema.yaml +0 -65
  182. package/contracts/true-close.schema.yaml +0 -15
  183. package/contracts/wave.schema.yaml +0 -29
  184. package/contracts/worker-output.schema.yaml +0 -15
  185. package/contracts/workflow-consumer.schema.yaml +0 -110
  186. package/methodology/audit-sweep-p0p1-recall.yaml +0 -45
  187. package/methodology/authority-convergence-policy.yaml +0 -42
  188. package/methodology/overflow-continuation-policy.yaml +0 -14
  189. package/methodology/skill-exchange-projection.yaml +0 -114
  190. package/methodology/skill-handoff.yaml +0 -34
  191. package/methodology/skill-installer-result.yaml +0 -27
  192. package/methodology/skill-installer-summary-projection.yaml +0 -181
  193. package/methodology/skill-runtime.yaml +0 -23
  194. package/methodology/spec-target-truth-profile.yaml +0 -46
  195. package/methodology/topic-lifecycle-report.yaml +0 -144
  196. package/methodology/topic-lifecycle.yaml +0 -37
  197. package/methodology/topic-naming-ontology.yaml +0 -21
  198. package/methodology/topic-ontology.yaml +0 -38
  199. package/methodology/topic-validation-policy.yaml +0 -9
  200. package/methodology/wave-dag-policy.yaml +0 -14
  201. package/spec/_meta/command-gating-matrix.yaml +0 -143
  202. package/spec/_meta/generate-drift-migration-checklist.yaml +0 -137
  203. package/spec/_meta/governance-routing-cutover-checklist.yaml +0 -35
  204. package/spec/_meta/phase2-impacted-surface-matrix.yaml +0 -44
  205. package/spec/_meta/spec-authority-cutover-readiness.yaml +0 -102
  206. package/spec/bootstrap-state.yaml +0 -99
@@ -1,18 +1,6 @@
1
1
  export const VALIDATOR_CLI_RESULT_CONTRACT = "validator-cli-result.v1";
2
2
 
3
3
  export const VALIDATOR_NATIVE_REFUSAL_CODES = {
4
- EXECUTION_PACKET_MISSING: "EXECUTION_PACKET_MISSING",
5
- EXECUTION_PACKET_INVALID: "EXECUTION_PACKET_INVALID",
6
- ORCHESTRATION_STATE_MISSING: "ORCHESTRATION_STATE_MISSING",
7
- ORCHESTRATION_STATE_INVALID: "ORCHESTRATION_STATE_INVALID",
8
- PROMPT_MISSING: "PROMPT_MISSING",
9
- PROMPT_INVALID: "PROMPT_INVALID",
10
- WORKER_OUTPUT_MISSING: "WORKER_OUTPUT_MISSING",
11
- WORKER_OUTPUT_INVALID: "WORKER_OUTPUT_INVALID",
12
- RUNNER_SIGNAL_MISSING: "RUNNER_SIGNAL_MISSING",
13
- RUNNER_SIGNAL_INVALID: "RUNNER_SIGNAL_INVALID",
14
- ACCEPTANCE_MISSING: "ACCEPTANCE_MISSING",
15
- ACCEPTANCE_INVALID: "ACCEPTANCE_INVALID",
16
4
  SPEC_TREE_MISSING: "SPEC_TREE_MISSING",
17
5
  SPEC_TREE_INVALID: "SPEC_TREE_INVALID",
18
6
  SPEC_AUDIT_MISSING: "SPEC_AUDIT_MISSING",
@@ -22,7 +10,3 @@ export const VALIDATOR_NATIVE_REFUSAL_CODES = {
22
10
  export function makeValidatorRefusal(code, message) {
23
11
  return { code, message };
24
12
  }
25
-
26
- export function normalizeArgv(args) {
27
- return args[0] === "--" ? args.slice(1) : args;
28
- }
@@ -1,21 +1,7 @@
1
- import path from "node:path";
2
1
  import { readdir } from "node:fs/promises";
3
-
4
- import { readTextIfFile } from "../fs-helpers.mjs";
5
-
6
- function posixRelative(targetRoot, absolutePath) {
7
- return path.relative(targetRoot, absolutePath).split(path.sep).join(path.posix.sep);
8
- }
2
+ import path from "node:path";
9
3
 
10
4
  export async function collectTreeFiles(rootPath) {
11
- const text = await readTextIfFile(path.join(rootPath, "INDEX.md"));
12
- if (text === null) {
13
- const info = await readTextIfFile(rootPath);
14
- if (info !== null) {
15
- return [];
16
- }
17
- }
18
-
19
5
  async function walk(currentPath) {
20
6
  let entries;
21
7
  try {
@@ -30,7 +16,7 @@ export async function collectTreeFiles(rootPath) {
30
16
  if (entry.isDirectory()) {
31
17
  files.push(...await walk(childPath));
32
18
  } else if (entry.isFile()) {
33
- files.push(posixRelative(rootPath, childPath));
19
+ files.push(path.relative(rootPath, childPath).split(path.sep).join(path.posix.sep));
34
20
  }
35
21
  }
36
22
  return files.sort();
@@ -38,117 +24,6 @@ export async function collectTreeFiles(rootPath) {
38
24
 
39
25
  return walk(rootPath);
40
26
  }
41
-
42
- function escapeRegexLiteral(value) {
43
- return value.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
44
- }
45
-
46
- function globToRegex(pattern) {
47
- const DOUBLE_STAR_SLASH = "__DOUBLE_STAR_SLASH__";
48
- const DOUBLE_STAR = "__DOUBLE_STAR__";
49
- const SINGLE_STAR = "__SINGLE_STAR__";
50
-
51
- let source = pattern
52
- .replaceAll("**/", DOUBLE_STAR_SLASH)
53
- .replaceAll("**", DOUBLE_STAR)
54
- .replaceAll("*", SINGLE_STAR);
55
-
56
- source = escapeRegexLiteral(source)
57
- .replaceAll(DOUBLE_STAR_SLASH, "(?:.*/)?")
58
- .replaceAll(DOUBLE_STAR, ".*")
59
- .replaceAll(SINGLE_STAR, "[^/]*");
60
-
61
- return new RegExp(`^${source}$`);
62
- }
63
-
64
- function compilePathClassMatchers(specTreeModel) {
65
- const classes = [
66
- ...specTreeModel.normativeClasses.map((entry) => ({ ...entry, category: "normative" })),
67
- ...specTreeModel.derivedClasses.map((entry) => ({ ...entry, category: "derived" })),
68
- ...specTreeModel.guidanceClasses.map((entry) => ({ ...entry, category: "guidance" })),
69
- ];
70
-
71
- return classes.map((entry) => ({
72
- ...entry,
73
- includeMatchers: entry.pathPatterns.map(globToRegex),
74
- excludeMatchers: (entry.excludedPathPatterns ?? []).map(globToRegex),
75
- }));
76
- }
77
-
78
- function isAllowedTopLevelSupportFile(relativePath) {
79
- return [
80
- "INDEX.md",
81
- "bootstrap-state.yaml",
82
- "product-scope.yaml",
83
- ].includes(relativePath);
84
- }
85
-
86
- export function classifySpecTreeFiles(canonicalRoot, files, specTreeModel) {
87
- const matchers = compilePathClassMatchers(specTreeModel);
88
- const classifications = [];
89
- const unexpected = [];
90
- const conflicts = [];
91
-
92
- for (const relativePath of files) {
93
- const canonicalRelativePath = path.posix.join(canonicalRoot, relativePath);
94
-
95
- if (relativePath.startsWith("_meta/")) {
96
- classifications.push({ path: relativePath, classId: "_meta", category: "meta" });
97
- continue;
98
- }
99
-
100
- if (isAllowedTopLevelSupportFile(relativePath)) {
101
- classifications.push({ path: relativePath, classId: "support", category: "support" });
102
- continue;
103
- }
104
-
105
- const matched = matchers.filter((matcher) => (
106
- matcher.includeMatchers.some((regex) => regex.test(canonicalRelativePath))
107
- && !matcher.excludeMatchers.some((regex) => regex.test(canonicalRelativePath))
108
- ));
109
-
110
- if (matched.length === 0) {
111
- unexpected.push(relativePath);
112
- continue;
113
- }
114
-
115
- if (matched.length > 1) {
116
- conflicts.push({
117
- path: relativePath,
118
- classes: matched.map((entry) => entry.id),
119
- });
120
- continue;
121
- }
122
-
123
- classifications.push({
124
- path: relativePath,
125
- classId: matched[0].id,
126
- category: matched[0].category,
127
- });
128
- }
129
-
130
- return {
131
- classifications,
132
- unexpected,
133
- conflicts,
134
- };
135
- }
136
-
137
- export function classifyAuditCoveredFiles(files, specTreeModel) {
138
- const classifications = classifySpecTreeFiles(specTreeModel.canonicalRoot, files, specTreeModel);
139
- const auditedFiles = classifications.classifications.filter((entry) => (
140
- entry.category !== "meta"
141
- && (
142
- entry.category !== "support"
143
- || entry.path === "INDEX.md"
144
- )
145
- ));
146
- return {
147
- classifications,
148
- auditedFiles,
149
- };
150
- }
151
-
152
27
  export function isSourceRefWithinDeclaredRoots(sourceRef, declaredInputs) {
153
28
  const roots = [
154
29
  ...declaredInputs.code_roots,
@@ -157,10 +32,6 @@ export function isSourceRefWithinDeclaredRoots(sourceRef, declaredInputs) {
157
32
  ...(declaredInputs.benchmark_blueprint_root ? [declaredInputs.benchmark_blueprint_root] : []),
158
33
  ];
159
34
 
160
- if (declaredInputs.human_note_paths.includes(sourceRef)) {
161
- return true;
162
- }
163
-
164
35
  return roots.some((root) => (
165
36
  root === "."
166
37
  ? !path.posix.isAbsolute(sourceRef)
@@ -169,17 +40,13 @@ export function isSourceRefWithinDeclaredRoots(sourceRef, declaredInputs) {
169
40
  }
170
41
 
171
42
  export function isDeclaredInputsCompatibleWithConfig(declaredInputs, generationInputs, blueprintReference) {
172
- const benchmarkRoot = generationInputs.benchmarkBlueprintRoot ?? blueprintReference.root ?? null;
173
-
174
- const rootsAlign = (declaredRoots, configuredRoots) => declaredRoots.every((entry) => configuredRoots.includes(entry));
43
+ const blueprintRoot = blueprintReference.present ? blueprintReference.root : null;
44
+ const rootsAlign = (declaredRoots, configuredRoots) =>
45
+ declaredRoots.every((entry) => configuredRoots.includes(entry));
175
46
 
176
47
  return rootsAlign(declaredInputs.code_roots, generationInputs.codeRoots ?? [])
177
48
  && rootsAlign(declaredInputs.docs_roots, generationInputs.docsRoots ?? [])
178
49
  && rootsAlign(declaredInputs.structure_roots, generationInputs.structureRoots ?? [])
179
- && rootsAlign(declaredInputs.human_note_paths, generationInputs.humanNotePaths ?? [])
180
- && (
181
- declaredInputs.benchmark_blueprint_root === null
182
- ? benchmarkRoot === null
183
- : declaredInputs.benchmark_blueprint_root === benchmarkRoot
184
- );
50
+ && declaredInputs.human_note_paths.length === 0
51
+ && declaredInputs.benchmark_blueprint_root === blueprintRoot;
185
52
  }