@cleocode/core 2026.11.1-canary.2 → 2026.11.1-canary.4

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 (217) hide show
  1. package/README.md +2 -0
  2. package/binaries/README.md +30 -10
  3. package/dist/.source-stamp.json +1 -1
  4. package/dist/audit/reconstruct.d.ts.map +1 -1
  5. package/dist/audit/reconstruct.js +3 -13
  6. package/dist/audit/reconstruct.js.map +1 -1
  7. package/dist/build-provenance.json +2 -2
  8. package/dist/cloud/nexus-vault.d.ts.map +1 -1
  9. package/dist/cloud/nexus-vault.js +3 -9
  10. package/dist/cloud/nexus-vault.js.map +1 -1
  11. package/dist/docs/docs-fts.d.ts +102 -0
  12. package/dist/docs/docs-fts.d.ts.map +1 -0
  13. package/dist/docs/docs-fts.js +276 -0
  14. package/dist/docs/docs-fts.js.map +1 -0
  15. package/dist/docs/docs-ops.d.ts +40 -5
  16. package/dist/docs/docs-ops.d.ts.map +1 -1
  17. package/dist/docs/docs-ops.js +168 -19
  18. package/dist/docs/docs-ops.js.map +1 -1
  19. package/dist/docs/docs-read-model.d.ts +41 -14
  20. package/dist/docs/docs-read-model.d.ts.map +1 -1
  21. package/dist/docs/docs-read-model.js +13 -99
  22. package/dist/docs/docs-read-model.js.map +1 -1
  23. package/dist/docs/doctor.d.ts +39 -0
  24. package/dist/docs/doctor.d.ts.map +1 -1
  25. package/dist/docs/doctor.js +111 -31
  26. package/dist/docs/doctor.js.map +1 -1
  27. package/dist/docs/lineage.d.ts +16 -1
  28. package/dist/docs/lineage.d.ts.map +1 -1
  29. package/dist/docs/lineage.js +73 -0
  30. package/dist/docs/lineage.js.map +1 -1
  31. package/dist/docs/modernize/apply.d.ts +16 -2
  32. package/dist/docs/modernize/apply.d.ts.map +1 -1
  33. package/dist/docs/modernize/apply.js +116 -28
  34. package/dist/docs/modernize/apply.js.map +1 -1
  35. package/dist/docs/modernize/guard.d.ts +27 -7
  36. package/dist/docs/modernize/guard.d.ts.map +1 -1
  37. package/dist/docs/modernize/guard.js +110 -14
  38. package/dist/docs/modernize/guard.js.map +1 -1
  39. package/dist/docs/modernize/index.d.ts +11 -2
  40. package/dist/docs/modernize/index.d.ts.map +1 -1
  41. package/dist/docs/modernize/index.js +20 -10
  42. package/dist/docs/modernize/index.js.map +1 -1
  43. package/dist/docs/modernize/plan.d.ts.map +1 -1
  44. package/dist/docs/modernize/plan.js +113 -5
  45. package/dist/docs/modernize/plan.js.map +1 -1
  46. package/dist/docs/modernize/rules.d.ts +92 -8
  47. package/dist/docs/modernize/rules.d.ts.map +1 -1
  48. package/dist/docs/modernize/rules.js +224 -28
  49. package/dist/docs/modernize/rules.js.map +1 -1
  50. package/dist/docs/publish-pr.d.ts.map +1 -1
  51. package/dist/docs/publish-pr.js +3 -1
  52. package/dist/docs/publish-pr.js.map +1 -1
  53. package/dist/gateway-client/generated/index.d.ts +2 -2
  54. package/dist/gateway-client/generated/index.d.ts.map +1 -1
  55. package/dist/gateway-client/generated/index.js +1 -1
  56. package/dist/gateway-client/generated/index.js.map +1 -1
  57. package/dist/gateway-client/generated/namespaces.gen.d.ts +1 -0
  58. package/dist/gateway-client/generated/namespaces.gen.d.ts.map +1 -1
  59. package/dist/gateway-client/generated/namespaces.gen.js +2 -1
  60. package/dist/gateway-client/generated/namespaces.gen.js.map +1 -1
  61. package/dist/gateway-client/generated/sdk.gen.d.ts +5 -1
  62. package/dist/gateway-client/generated/sdk.gen.d.ts.map +1 -1
  63. package/dist/gateway-client/generated/sdk.gen.js +11 -0
  64. package/dist/gateway-client/generated/sdk.gen.js.map +1 -1
  65. package/dist/gateway-client/generated/types.gen.d.ts +54 -0
  66. package/dist/gateway-client/generated/types.gen.d.ts.map +1 -1
  67. package/dist/git/work-tree.d.ts +24 -0
  68. package/dist/git/work-tree.d.ts.map +1 -1
  69. package/dist/git/work-tree.js +12 -1
  70. package/dist/git/work-tree.js.map +1 -1
  71. package/dist/init.d.ts.map +1 -1
  72. package/dist/init.js +13 -5
  73. package/dist/init.js.map +1 -1
  74. package/dist/internal.d.ts +1 -1
  75. package/dist/internal.d.ts.map +1 -1
  76. package/dist/internal.js +1 -1
  77. package/dist/internal.js.map +1 -1
  78. package/dist/memory/engine-compat.d.ts.map +1 -1
  79. package/dist/memory/engine-compat.js +44 -12
  80. package/dist/memory/engine-compat.js.map +1 -1
  81. package/dist/orchestration/spawn-prompt.d.ts +17 -0
  82. package/dist/orchestration/spawn-prompt.d.ts.map +1 -1
  83. package/dist/orchestration/spawn-prompt.js +41 -3
  84. package/dist/orchestration/spawn-prompt.js.map +1 -1
  85. package/dist/orchestration/spawn.d.ts.map +1 -1
  86. package/dist/orchestration/spawn.js +12 -0
  87. package/dist/orchestration/spawn.js.map +1 -1
  88. package/dist/paths.d.ts +20 -0
  89. package/dist/paths.d.ts.map +1 -1
  90. package/dist/paths.js +26 -0
  91. package/dist/paths.js.map +1 -1
  92. package/dist/release/ci-evidence.d.ts +7 -3
  93. package/dist/release/ci-evidence.d.ts.map +1 -1
  94. package/dist/release/ci-evidence.js +77 -14
  95. package/dist/release/ci-evidence.js.map +1 -1
  96. package/dist/release/cut.d.ts +13 -0
  97. package/dist/release/cut.d.ts.map +1 -1
  98. package/dist/release/cut.js +63 -9
  99. package/dist/release/cut.js.map +1 -1
  100. package/dist/release/engine-ops.d.ts.map +1 -1
  101. package/dist/release/engine-ops.js +10 -4
  102. package/dist/release/engine-ops.js.map +1 -1
  103. package/dist/release/plan.d.ts +3 -1
  104. package/dist/release/plan.d.ts.map +1 -1
  105. package/dist/release/plan.js +4 -2
  106. package/dist/release/plan.js.map +1 -1
  107. package/dist/release/reconcile.d.ts +3 -1
  108. package/dist/release/reconcile.d.ts.map +1 -1
  109. package/dist/release/reconcile.js +18 -6
  110. package/dist/release/reconcile.js.map +1 -1
  111. package/dist/release/release-published.d.ts +27 -0
  112. package/dist/release/release-published.d.ts.map +1 -0
  113. package/dist/release/release-published.js +35 -0
  114. package/dist/release/release-published.js.map +1 -0
  115. package/dist/remote/index.js +1 -1
  116. package/dist/remote/index.js.map +1 -1
  117. package/dist/scaffold/ensure-dirs.d.ts.map +1 -1
  118. package/dist/scaffold/ensure-dirs.js +8 -6
  119. package/dist/scaffold/ensure-dirs.js.map +1 -1
  120. package/dist/selfimprove/draft-pr.d.ts.map +1 -1
  121. package/dist/selfimprove/draft-pr.js +4 -1
  122. package/dist/selfimprove/draft-pr.js.map +1 -1
  123. package/dist/skills/propose-patch.d.ts.map +1 -1
  124. package/dist/skills/propose-patch.js +4 -1
  125. package/dist/skills/propose-patch.js.map +1 -1
  126. package/dist/store/ac-binding-prune.d.ts +3 -2
  127. package/dist/store/ac-binding-prune.d.ts.map +1 -1
  128. package/dist/store/ac-binding-prune.js +4 -3
  129. package/dist/store/ac-binding-prune.js.map +1 -1
  130. package/dist/store/git-checkpoint.d.ts +11 -1
  131. package/dist/store/git-checkpoint.d.ts.map +1 -1
  132. package/dist/store/git-checkpoint.js +14 -3
  133. package/dist/store/git-checkpoint.js.map +1 -1
  134. package/dist/store/schema/tasks.d.ts +1 -1
  135. package/dist/store/schema/tasks.d.ts.map +1 -1
  136. package/dist/store/schema/tasks.js +2 -0
  137. package/dist/store/schema/tasks.js.map +1 -1
  138. package/dist/store/table-classification.d.ts.map +1 -1
  139. package/dist/store/table-classification.js +8 -0
  140. package/dist/store/table-classification.js.map +1 -1
  141. package/dist/system/dependencies.d.ts +22 -0
  142. package/dist/system/dependencies.d.ts.map +1 -1
  143. package/dist/system/dependencies.js +49 -2
  144. package/dist/system/dependencies.js.map +1 -1
  145. package/dist/system/health.d.ts.map +1 -1
  146. package/dist/system/health.js +3 -1
  147. package/dist/system/health.js.map +1 -1
  148. package/dist/task-work/index.d.ts.map +1 -1
  149. package/dist/task-work/index.js +3 -1
  150. package/dist/task-work/index.js.map +1 -1
  151. package/dist/tasks/ac-immutability.d.ts +21 -2
  152. package/dist/tasks/ac-immutability.d.ts.map +1 -1
  153. package/dist/tasks/ac-immutability.js +25 -0
  154. package/dist/tasks/ac-immutability.js.map +1 -1
  155. package/dist/tasks/ac-table.d.ts +15 -1
  156. package/dist/tasks/ac-table.d.ts.map +1 -1
  157. package/dist/tasks/ac-table.js +21 -0
  158. package/dist/tasks/ac-table.js.map +1 -1
  159. package/dist/tasks/add.d.ts +8 -0
  160. package/dist/tasks/add.d.ts.map +1 -1
  161. package/dist/tasks/add.js +12 -3
  162. package/dist/tasks/add.js.map +1 -1
  163. package/dist/tasks/change-set.d.ts.map +1 -1
  164. package/dist/tasks/change-set.js +92 -27
  165. package/dist/tasks/change-set.js.map +1 -1
  166. package/dist/tasks/complete.d.ts.map +1 -1
  167. package/dist/tasks/complete.js +23 -14
  168. package/dist/tasks/complete.js.map +1 -1
  169. package/dist/tasks/component-pr.d.ts.map +1 -1
  170. package/dist/tasks/component-pr.js +4 -3
  171. package/dist/tasks/component-pr.js.map +1 -1
  172. package/dist/tasks/criterion-receipt.d.ts +63 -0
  173. package/dist/tasks/criterion-receipt.d.ts.map +1 -0
  174. package/dist/tasks/criterion-receipt.js +145 -0
  175. package/dist/tasks/criterion-receipt.js.map +1 -0
  176. package/dist/tasks/done-plan.d.ts.map +1 -1
  177. package/dist/tasks/done-plan.js +70 -6
  178. package/dist/tasks/done-plan.js.map +1 -1
  179. package/dist/tasks/evidence.d.ts +8 -2
  180. package/dist/tasks/evidence.d.ts.map +1 -1
  181. package/dist/tasks/evidence.js +51 -15
  182. package/dist/tasks/evidence.js.map +1 -1
  183. package/dist/tasks/gate-notes.d.ts +17 -0
  184. package/dist/tasks/gate-notes.d.ts.map +1 -1
  185. package/dist/tasks/gate-notes.js.map +1 -1
  186. package/dist/tasks/manifest-scope.d.ts +42 -5
  187. package/dist/tasks/manifest-scope.d.ts.map +1 -1
  188. package/dist/tasks/manifest-scope.js +162 -9
  189. package/dist/tasks/manifest-scope.js.map +1 -1
  190. package/dist/tasks/merge-close.d.ts +25 -2
  191. package/dist/tasks/merge-close.d.ts.map +1 -1
  192. package/dist/tasks/merge-close.js +30 -2
  193. package/dist/tasks/merge-close.js.map +1 -1
  194. package/dist/tasks/req.d.ts +49 -0
  195. package/dist/tasks/req.d.ts.map +1 -1
  196. package/dist/tasks/req.js +156 -2
  197. package/dist/tasks/req.js.map +1 -1
  198. package/dist/tasks/verification-policy.d.ts +34 -0
  199. package/dist/tasks/verification-policy.d.ts.map +1 -1
  200. package/dist/tasks/verification-policy.js +77 -5
  201. package/dist/tasks/verification-policy.js.map +1 -1
  202. package/dist/validation/doctor/checks.d.ts +20 -0
  203. package/dist/validation/doctor/checks.d.ts.map +1 -1
  204. package/dist/validation/doctor/checks.js +112 -0
  205. package/dist/validation/doctor/checks.js.map +1 -1
  206. package/dist/validation/engine-ops.d.ts.map +1 -1
  207. package/dist/validation/engine-ops.js +11 -4
  208. package/dist/validation/engine-ops.js.map +1 -1
  209. package/dist/worktree/merged-cleanup.d.ts +10 -0
  210. package/dist/worktree/merged-cleanup.d.ts.map +1 -1
  211. package/dist/worktree/merged-cleanup.js +12 -1
  212. package/dist/worktree/merged-cleanup.js.map +1 -1
  213. package/package.json +12 -12
  214. package/templates/CLEO-INJECTION.md +1 -1
  215. package/templates/CLEO-REFERENCE.md +6 -2
  216. package/templates/git-hooks/legacy-hashes.json +2 -1
  217. package/templates/git-hooks/pre-commit +43 -11
@@ -42,7 +42,7 @@ import { bindTestRunReport, configSchemaCompositionGap, coveredTestFiles, TEST_R
42
42
  import { captureHead, captureTree, resolveSpawnTimeoutMs, runToolCached, } from './tool-cache.js';
43
43
  import { CANONICAL_TOOLS, canonicalToolName, listValidToolNames, resolveToolCommand, } from './tool-resolver.js';
44
44
  import { detectStaticVacuity, probeTscFileCount, VACUOUS_TOOL_FIX } from './tool-vacuity.js';
45
- import { classifyEvidenceTask, declaredEvidenceKind, gateProfileOf, implementedCodeEvidence, isDocumentArtifact, isDocumentEvidencePath, } from './verification-policy.js';
45
+ import { classifyEvidenceTask, declaredEvidenceKind, evidenceProfileOf, gateProfileOf, ignoredProfileReason, implementedCodeEvidence, isDocumentArtifact, isDocumentEvidencePath, } from './verification-policy.js';
46
46
  /**
47
47
  * Valid tool names recognised by the `tool:<name>` evidence atom.
48
48
  *
@@ -888,8 +888,10 @@ export function extractTaskAcFilesWithProvenance(task) {
888
888
  /**
889
889
  * Return the list of file paths a commit touched (added, modified, or deleted).
890
890
  *
891
- * Uses `git diff-tree --no-commit-id -r --name-only -m --first-parent` which
892
- * correctly handles **merge commits** by diffing against the first parent only.
891
+ * Uses `git diff-tree --no-commit-id -r --name-only --diff-merges=first-parent`
892
+ * (git 2.31+), which diffs a **merge commit** against its first parent only.
893
+ * `-m --first-parent` listed the diff against EVERY parent, since
894
+ * `--first-parent` limits a revision walk, not diff-tree (T14166).
893
895
  * The legacy `git show --name-only` approach returned an empty list for merge
894
896
  * commits because show without `--first-parent` produces a combined diff that
895
897
  * `--name-only` cannot meaningfully summarise, causing the content-intersect
@@ -902,6 +904,7 @@ export function extractTaskAcFilesWithProvenance(task) {
902
904
  * @internal
903
905
  * @task T9245
904
906
  * @task T11959 (DHQ-083 companion b — merge-commit first-parent diff)
907
+ * @task T14166
905
908
  */
906
909
  async function gitShowFiles(sha, projectRoot) {
907
910
  return (await commitFilesOrNull(sha, projectRoot)) ?? [];
@@ -916,9 +919,9 @@ async function gitShowFiles(sha, projectRoot) {
916
919
  * @task T14001
917
920
  */
918
921
  async function commitFilesOrNull(sha, projectRoot) {
919
- // diff-tree with --first-parent gives a clean single-parent diff for both
922
+ // --diff-merges=first-parent gives a clean single-parent diff for both
920
923
  // regular commits and merge commits (compares merge result to first parent,
921
- // i.e. the branch tip before the PR was merged).
924
+ // i.e. the branch tip before the PR was merged; T14166).
922
925
  //
923
926
  // --root: Without this flag, git diff-tree returns EMPTY output for the
924
927
  // repository's initial (root) commit because there is no parent to diff
@@ -926,7 +929,15 @@ async function commitFilesOrNull(sha, projectRoot) {
926
929
  // against the empty tree, correctly listing all files it introduced.
927
930
  // This fixes the gate-verify-hint tests (and any real workflow) where the
928
931
  // evidence commit happens to be the very first commit in the repo (T11959).
929
- const r = await runCommand('git', ['diff-tree', '--root', '--no-commit-id', '-r', '--name-only', '-m', '--first-parent', sha], projectRoot);
932
+ const r = await runCommand('git', [
933
+ 'diff-tree',
934
+ '--root',
935
+ '--no-commit-id',
936
+ '-r',
937
+ '--name-only',
938
+ '--diff-merges=first-parent',
939
+ sha,
940
+ ], projectRoot);
930
941
  if (r.exitCode !== 0)
931
942
  return null;
932
943
  return r.stdout
@@ -3248,8 +3259,13 @@ export function checkTaskEvidenceContext(context, gate, atoms) {
3248
3259
  if (classifyEvidenceTask(context) === 'code' &&
3249
3260
  gate === 'implemented' &&
3250
3261
  atoms.some((atom) => atom.kind === 'decision') &&
3251
- !atoms.some((atom) => atom.kind === 'commit' || atom.kind === 'pr'))
3252
- return 'A research decision alone cannot implement a code-fix task.';
3262
+ !atoms.some((atom) => atom.kind === 'commit' || atom.kind === 'pr')) {
3263
+ // T14193: when a gate profile was overridden, say which rule decided code.
3264
+ const ignored = ignoredProfileReason(context.task);
3265
+ return ignored === null
3266
+ ? 'A research decision alone cannot implement a code-fix task.'
3267
+ : `A research decision alone cannot implement a code-fix task: ${ignored}`;
3268
+ }
3253
3269
  return null;
3254
3270
  }
3255
3271
  /**
@@ -3368,18 +3384,33 @@ export function decisionOnlyRouteNote(gate, implemented) {
3368
3384
  function deploySatisfiesGate(gate, atoms) {
3369
3385
  return atoms.some((atom) => atom.kind === 'deploy' && atom.satisfiesGates.includes(gate));
3370
3386
  }
3387
+ /**
3388
+ * The profile whose extra combinations apply to these atoms (T14187): the
3389
+ * task's, while every `files:` path is a document. A code path keeps the base
3390
+ * requirements, so a profiled change that touched code still owes a commit
3391
+ * or PR.
3392
+ */
3393
+ function profileForAtoms(profile, atoms) {
3394
+ if (!profile)
3395
+ return null;
3396
+ const paths = atoms.flatMap((atom) => atom.kind === 'files' ? atom.files.map((f) => f.path) : []);
3397
+ return paths.every(isDocumentEvidencePath) ? profile : null;
3398
+ }
3371
3399
  /**
3372
3400
  * Check whether a set of validated atoms satisfies the minimum evidence
3373
3401
  * required for a given gate.
3374
3402
  *
3375
3403
  * @param gate - The gate being verified
3376
3404
  * @param atoms - Validated atoms
3405
+ * @param profile - The task's gate profile ({@link evidenceProfileOf}); its
3406
+ * extra combinations apply while every `files:` path is a document (T14187).
3377
3407
  * @returns null when satisfied; otherwise the reason message
3378
3408
  *
3379
3409
  * @task T832
3410
+ * @task T14187
3380
3411
  * @adr ADR-051 §2.3
3381
3412
  */
3382
- export function checkGateEvidenceMinimum(gate, atoms) {
3413
+ export function checkGateEvidenceMinimum(gate, atoms, profile) {
3383
3414
  if (deploySatisfiesGate(gate, atoms))
3384
3415
  return null;
3385
3416
  // Delegate to the SSoT in @cleocode/contracts (T10337). validateEvidenceForGate
@@ -3397,7 +3428,7 @@ export function checkGateEvidenceMinimum(gate, atoms) {
3397
3428
  const kind = atom.kind;
3398
3429
  projected.push({ kind });
3399
3430
  }
3400
- const result = validateEvidenceForGate(gate, projected);
3431
+ const result = validateEvidenceForGate(gate, projected, profileForAtoms(profile, atoms));
3401
3432
  return result.ok ? null : result.message;
3402
3433
  }
3403
3434
  /**
@@ -3411,12 +3442,14 @@ export function checkGateEvidenceMinimum(gate, atoms) {
3411
3442
  *
3412
3443
  * @param gate - The gate being verified
3413
3444
  * @param atoms - Validated atoms
3445
+ * @param profile - The task's gate profile, as for {@link checkGateEvidenceMinimum} (T14187).
3414
3446
  * @returns `null` when satisfied; `{ message, hint }` when not
3415
3447
  *
3416
3448
  * @task T9949
3449
+ * @task T14187
3417
3450
  * @adr ADR-051 §2.3
3418
3451
  */
3419
- export function checkGateEvidenceMinimumDetailed(gate, atoms) {
3452
+ export function checkGateEvidenceMinimumDetailed(gate, atoms, profile) {
3420
3453
  if (deploySatisfiesGate(gate, atoms))
3421
3454
  return null;
3422
3455
  const projected = [];
@@ -3426,7 +3459,7 @@ export function checkGateEvidenceMinimumDetailed(gate, atoms) {
3426
3459
  const kind = atom.kind;
3427
3460
  projected.push({ kind });
3428
3461
  }
3429
- const result = validateEvidenceForGate(gate, projected);
3462
+ const result = validateEvidenceForGate(gate, projected, profileForAtoms(profile, atoms));
3430
3463
  return result.ok ? null : { message: result.message, hint: result.hint };
3431
3464
  }
3432
3465
  /**
@@ -3666,8 +3699,11 @@ export async function taskEvidenceKindReport(task, projectRoot, extraPaths = [],
3666
3699
  const kind = classifyEvidenceTask({ task });
3667
3700
  // T14048: a task its record leaves undecided is classified by what it changed.
3668
3701
  const undecided = kind === 'code' && declaredEvidenceKind(task) === null;
3669
- if (kind === 'code' && !undecided)
3670
- return { kind };
3702
+ if (kind === 'code' && !undecided) {
3703
+ // T14193: a profile the record overrides is named, with the deciding rule.
3704
+ const ignored = ignoredProfileReason(task);
3705
+ return ignored === null ? { kind } : { kind, reason: ignored };
3706
+ }
3671
3707
  // T13474: a gate profile never covers code evidence, wherever it points.
3672
3708
  const profile = gateProfileOf(task);
3673
3709
  const codeAtom = profile === null ? null : implementedCodeEvidence(task);
@@ -3846,7 +3882,7 @@ export async function revalidateEvidence(evidence, projectRoot, gate, taskId, op
3846
3882
  !(classifyEvidenceTask(context) !== 'code' &&
3847
3883
  isDecisionOnlyImplementation(task.verification?.evidence?.implemented) &&
3848
3884
  DECISION_ONLY_RELAXED_GATES.includes(gate))) {
3849
- reason = checkGateEvidenceMinimum(gate, evidence.atoms);
3885
+ reason = checkGateEvidenceMinimum(gate, evidence.atoms, evidenceProfileOf(task));
3850
3886
  }
3851
3887
  if (!reason && evidence.scope) {
3852
3888
  if (evidence.scope.taskId !== taskId || evidence.scope.gate !== gate)