@cleocode/core 2026.10.25 → 2026.10.26

package/dist/tasks/gate-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate-runner.d.ts","sourceRoot":"","sources":["../../src/tasks/gate-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gate-runner.d.ts","sourceRoot":"","sources":["../../src/tasks/gate-runner.ts"],"names":[],"mappings":"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"}

package/dist/tasks/gate-runner.js

@@ -33,7 +33,7 @@ import { isDeepStrictEqual } from 'node:util';
 import { acceptanceGateResultSchema, acceptanceGateSchema, testCountReportSchema, testCountSummarySchema, } from '@cleocode/contracts/acceptance-gate-schema.js';
 import { findOnPath } from '@cleocode/paths';
 import { resolveOriginDefault } from '../git/base-ref.js';
-import { discoveryEnv, gitToplevel, resolveDeclaredEvidenceGitRoot } from '../git/work-tree.js';
+import { discoveryEnv } from '../git/work-tree.js';
 import { getProjectRoot } from '../paths.js';
 import { captureProjectScope, worktreeScope } from '../project-scope.js';
 import { truncateString } from '../render/helpers.js';
@@ -44,6 +44,7 @@ import { registerTeardownAbort } from '../teardown-signal.js';
 import { acItemToText, acTextHash } from './ac-table.js';
 import { splitCommandLine } from './command-line.js';
 import { resolveCanonicalProjectRoot } from './evidence.js';
+import { resolveEvidenceTree } from './evidence-tree.js';
 import { buildGateCacheEntryBody, captureGateCacheState, describeGateCacheMiss, evidenceCacheKeyPath, gateCacheEntryPath, readGateCacheEntry, sealGateCacheEntry, } from './gate-result-cache.js';
 import { planHeavyToolEnv, vitestWorkerCeiling } from './heavy-tool-env.js';
 import { resolveSpawnTimeoutMs } from './tool-cache.js';
@@ -239,7 +240,7 @@ export async function captureGateInputsHash(task, gate, execution, env = process
  * @task T13693
  */
 export async function captureGateInputs(task, gate, execution, env = process.env) {
-    const tree = resolveTypedGateRoot(resolve(execution.identity.projectRoot));
+    const tree = resolveTypedGateRoot(resolve(execution.identity.projectRoot), undefined, undefined, task.id);
     const invocation = executableInvocation(gate, tree, { ...env });
     const artifacts = await snapshotGateInputs(task, gate, invocation, execution, tree);
     return {
@@ -271,18 +272,26 @@ export async function captureGateInputs(task, gate, execution, env = process.env
  * or `evidence.gitRoot`) is consulted first, as `resolveEvidenceExecutionRoot`
  * does for evidence tools. Without it, a run whose cwd had been moved to the
  * store root keyed the gate cache to the primary checkout's HEAD even when the
- * caller named its worktree. A declared tree is honoured only when it is this
- * project's checkout or one of its linked worktrees, like the cwd.
+ * caller named its worktree.
+ *
+ * T14058: the tree comes from {@link resolveEvidenceTree}, the resolver
+ * change-set binding uses, so typed gates and a bound test-run never measure
+ * different checkouts: the invocation's linked worktree of the declared
+ * repository wins, and with `taskId` the task's `task/<id>` worktree is chosen
+ * from the main checkout. Only this project's checkout or one of its linked
+ * worktrees is accepted; any other candidate is skipped.
  *
  * @param projectRoot - CLEO store root (the typed gate's authority).
  * @param cwd - Invocation directory. Defaults to `process.cwd()`.
  * @param env - Where the evidence declaration is read. Defaults to `process.env`.
+ * @param taskId - Task whose `task/<id>` worktree may be the tree; null skips that tier.
  * @returns The realpath of the tree typed gates execute in.
  * @task T12625
  * @task T13649
+ * @task T14058
  */
 export function resolveTypedGateRoot(projectRoot, cwd = process.cwd(), // CWD-OK: the invocation tree is the subject (gh#1220)
-env = process.env) {
+env = process.env, taskId = null) {
     const real = (p) => {
         try {
             return realpathSync(p);
@@ -292,15 +301,9 @@ env = process.env) {
         }
     };
     const root = real(projectRoot);
-    const ofThisProject = (top) => top !== null && real(top) !== root && real(resolveCanonicalProjectRoot(top)) === root
-        ? real(top)
-        : null;
-    const declared = resolveDeclaredEvidenceGitRoot(projectRoot, env);
-    const declaredTop = declared ? gitToplevel(declared.path) : null;
-    // A declaration naming the store root itself is honoured as such.
-    if (declaredTop !== null && real(declaredTop) === root)
-        return projectRoot;
-    return ofThisProject(declaredTop) ?? ofThisProject(gitToplevel(cwd)) ?? projectRoot;
+    const ofThisProject = (top) => real(top) === root || real(resolveCanonicalProjectRoot(top)) === root;
+    const tree = real(resolveEvidenceTree(projectRoot, taskId, cwd, env, ofThisProject).root);
+    return tree === root ? projectRoot : tree;
 }
 /**
  * Admission for a batch run without a caller-owned lifetime.
@@ -354,7 +357,7 @@ export async function runGates(gates, options = {}) {
     if (!Number.isSafeInteger(maxOutputBytes) || maxOutputBytes < 1)
         throw new RangeError('Gate capture byte limit must be a positive safe integer');
     // T12625: execute and fingerprint in the caller's worktree of this project.
-    const treeRoot = resolveTypedGateRoot(projectRoot);
+    const treeRoot = resolveTypedGateRoot(projectRoot, undefined, undefined, options.taskId ?? null);
     const snapshot = structuredClone(gates);
     const controller = new AbortController();
     const deregister = registerTeardownAbort(controller);
@@ -619,7 +622,7 @@ export async function runTaskGates(task, criteria, options) {
     assertCriterionProjection(snapshot, rows);
     const env = { ...(options.env ?? process.env) };
     const verificationId = randomUUID();
-    const tree = resolveTypedGateRoot(root);
+    const tree = resolveTypedGateRoot(root, undefined, undefined, snapshot.id);
     return worktreeScope.run(scope, async () => {
         const results = [];
         for (const [index, gate] of (snapshot.acceptance ?? []).entries()) {
@@ -669,6 +672,7 @@ export async function runTaskGates(task, criteria, options) {
                 : (await runGates([gate], {
                     ...options,
                     projectRoot: root,
+                    taskId: snapshot.id,
                     env,
                     execution,
                     ...(options.cache && options.cache !== 'off'
@@ -986,6 +990,8 @@ function typedRevalidationScope(task, criteria, results, options, requirePassing
             results,
             execution,
             root,
+            // No task id: completion judges a stored result in the invocation's own
+            // tree, so completing from main before the merge stays refused (T12625).
             tree: resolveTypedGateRoot(root, cwd),
             env: { ...(options.env ?? process.env) },
             requirePassing,
@@ -1668,6 +1674,71 @@ function matchingBrace(text, start) {
     }
     return -1;
 }
+/** Top-level keys that mark a JSON object as an attempted test-count report. */
+const COUNT_REPORT_KEYS = ['numTotalTests', 'numPassedTests', 'numFailedTests', 'testResults'];
+/**
+ * Why a parsed candidate was refused: its first schema issue, by field path
+ * (T14060). A report that parsed but failed validation used to be dropped
+ * silently, so the author was told no report existed at all.
+ */
+function firstSchemaIssue(error) {
+    const issue = error.issues[0];
+    if (issue === undefined)
+        return 'invalid';
+    return issue.path.length > 0
+        ? `${issue.path.map(String).join('.')}: ${issue.message}`
+        : issue.message;
+}
+/** Whether `value` is a JSON object carrying any {@link COUNT_REPORT_KEYS}. */
+function looksLikeCountReport(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        COUNT_REPORT_KEYS.some((key) => Object.hasOwn(value, key)));
+}
+/**
+ * Counts from node:test TAP output (`node --test --test-reporter=tap`, also
+ * via `tsx --test`), which ships no JSON reporter (T14051). The run's LAST
+ * top-level plan (`1..N` at column 0) must be followed by its `# tests N`,
+ * `# pass N` and `# fail N` summary; `# cancelled N` counts as failed. Test
+ * console output is re-emitted as indented or `# ` comment lines before that
+ * plan, so it cannot forge the summary.
+ *
+ * @param stdout - The run's captured stdout.
+ * @returns Counts, a refusal reason, or null when the output is not TAP.
+ * @task T14051
+ */
+function tapTestCounts(stdout) {
+    const lines = stdout.split(/\r?\n/);
+    if (!lines.some((line) => /^TAP version \d+$/.test(line.trim())))
+        return null;
+    if (lines.some((line) => /^\s*Bail out!/.test(line)))
+        return { refusal: 'its TAP output contains "Bail out!"' };
+    const plan = lines.findLastIndex((line) => /^1\.\.\d+(?:\s|$)/.test(line));
+    if (plan === -1)
+        return { refusal: 'its TAP output has no top-level 1..N plan' };
+    const summary = new Map();
+    for (const line of lines.slice(plan + 1)) {
+        const match = line.match(/^# (tests|pass|fail|cancelled) (\d+)$/);
+        if (match)
+            summary.set(match[1], Number(match[2]));
+    }
+    const tests = summary.get('tests');
+    const pass = summary.get('pass');
+    const fail = summary.get('fail');
+    if (tests === undefined || pass === undefined || fail === undefined)
+        return {
+            refusal: 'its TAP output has no "# tests", "# pass" and "# fail" summary after the plan',
+        };
+    if (tests === 0 || /^1\.\.0(?:\s|$)/.test(lines[plan]))
+        return { refusal: 'its TAP output reports zero tests' };
+    const failed = fail + (summary.get('cancelled') ?? 0);
+    return {
+        numPassedTests: pass,
+        numFailedTests: failed,
+        numTotalTests: tests,
+        success: failed === 0,
+    };
+}
 /**
  * Structured test counts emitted by THIS gate's own process, or `null`.
  *
@@ -1686,32 +1757,59 @@ function matchingBrace(text, start) {
  * code, at any time. Only the bytes this invocation emitted are bound to it.
  *
  * A non-runner command (a wrapper script) may instead print a bare count
- * summary ({@link testCountSummarySchema}) as its last stdout line (T13753).
+ * summary ({@link testCountSummarySchema}) as its last stdout line (T13753),
+ * and node:test may print TAP ({@link tapTestCounts}, T14051).
+ *
+ * A candidate that parses as a count report but fails its schema is recorded
+ * in `refusals` with its first issue (T14060), so the error can say which
+ * report was found and why it was refused.
  *
  * @param captured - Result of running the gate command.
+ * @param refusals - Receives why each report-like candidate was refused, in the order the
+ *   candidates are tried (last stdout line, TAP, then the output newest-first); the
+ *   first is the one reported.
  * @returns Validated counts, or `null` when the run emitted no usable report.
  * @task T12308
  * @task T13753
+ * @task T14051
+ * @task T14060
  */
-function structuredTestCounts(captured) {
+function structuredTestCounts(captured, refusals) {
     const lastLine = captured.stdout.trimEnd().split('\n').at(-1)?.trim() ?? '';
     if (lastLine.startsWith('{')) {
         try {
-            const summary = testCountSummarySchema.safeParse(JSON.parse(lastLine));
+            const raw = JSON.parse(lastLine);
+            const summary = testCountSummarySchema.safeParse(raw);
             if (summary.success)
                 return summary.data;
+            // A line carrying testResults is a full report: the search below judges it.
+            if (looksLikeCountReport(raw) && !Object.hasOwn(raw, 'testResults'))
+                refusals.push(`the last stdout line is not a count summary (${firstSchemaIssue(summary.error)})`);
         }
         catch {
             // Not JSON: fall through to the full-report search.
         }
     }
+    const tap = tapTestCounts(captured.stdout);
+    if (tap !== null) {
+        if ('refusal' in tap) {
+            refusals.push(tap.refusal);
+            return null;
+        }
+        return tap;
+    }
     const text = `${captured.stdout}\n${captured.stderr}`.trim();
     if (text.length === 0)
         return null;
     const tryParse = (candidate) => {
         try {
-            const report = testCountReportSchema.safeParse(JSON.parse(candidate));
-            return report.success ? report.data : null;
+            const raw = JSON.parse(candidate);
+            const report = testCountReportSchema.safeParse(raw);
+            if (report.success)
+                return report.data;
+            if (looksLikeCountReport(raw))
+                refusals.push(`a JSON report in its output fails the full report shape (${firstSchemaIssue(report.error)})`);
+            return null;
         }
         catch {
             return null;
@@ -1820,10 +1918,12 @@ async function fileStamp(path) {
  *
  * @param before - Each candidate's stamp just before the spawn.
  * @param startedAt - Epoch ms just before the spawn.
+ * @param refusals - Receives why a fresh report that failed its schema was refused (T14060).
  * @returns Validated counts, or null.
  * @task T13782
+ * @task T14060
  */
-async function freshReportCounts(before, startedAt) {
+async function freshReportCounts(before, startedAt, refusals) {
     for (const [path, was] of before) {
         const now = await fileStamp(path);
         if (now === null || now.mtimeMs < startedAt || (was !== null && was.sha256 === now.sha256))
@@ -1835,6 +1935,7 @@ async function freshReportCounts(before, startedAt) {
             const report = testCountReportSchema.safeParse(raw);
             if (report.success)
                 return report.data;
+            refusals.push(`${path} fails the full report shape (${firstSchemaIssue(report.error)})`);
         }
         catch {
             // Unreadable or not JSON: not a report of this run.
@@ -1849,24 +1950,40 @@ async function freshReportCounts(before, startedAt) {
  * reader had no way to learn what "supported" meant, what shape was expected,
  * or which flag produced it — so the reported resolution was to delete the
  * `minCount` from the gate, which removes the guarantee rather than meeting it.
+ * node:test (`node --test`, `tsx --test`) is detected before the package
+ * managers, which run it too and whose `--reporter=json` it rejects (T14051);
+ * a report that was found but refused is named with its first issue (T14060).
  *
  * @param gate - Gate whose command needs a machine-readable reporter.
+ * @param refusal - Why the newest report-like candidate was refused, if any.
  * @task T12308
+ * @task T14051
+ * @task T14060
  */
-function describeMissingTestCount(gate) {
+function describeMissingTestCount(gate, refusal) {
     const invoked = [gate.command, ...(gate.args ?? [])].join(' ');
-    const flag = /jest/.test(invoked)
-        ? '--json'
-        : /vitest|pnpm|npm|yarn|bun/.test(invoked)
-            ? '--reporter=json'
-            : '<your runner\u2019s JSON reporter flag>';
-    return (`minCount ${gate.minCount} cannot be proved: \`${invoked}\` emitted no machine-readable ` +
-        `test report, and an exit code alone carries no count. Add a JSON reporter to the gate ` +
-        `command itself (e.g. \`${invoked} ${flag}\`) so the run that is being attested is the ` +
-        `run that is counted. A report file this run writes (its --outputFile, or ` +
-        `${REDIRECTED_JSON_REPORT}) is read too, but one produced by a separate invocation is ` +
-        `deliberately not accepted \u2014 it is not bound to this execution; record that as \`test-run:<path>\` ` +
-        `evidence instead, or drop minCount if an exit code is the guarantee you want.`);
+    const flag = /\b(?:node|tsx)\b.*\s--test(?![\w-])/.test(invoked)
+        ? '--test-reporter=tap'
+        : /jest/.test(invoked)
+            ? '--json'
+            : /vitest|pnpm|npm|yarn|bun/.test(invoked)
+                ? '--reporter=json'
+                : '<your runner\u2019s JSON reporter flag>';
+    const found = refusal === undefined
+        ? `\`${invoked}\` emitted no machine-readable test report`
+        : `\`${invoked}\` emitted a test report that was refused: ${refusal}`;
+    return (`minCount ${gate.minCount} cannot be proved: ${found}, and an exit code alone carries no ` +
+        `count. Add a reporter to the gate command itself (e.g. \`${invoked} ${flag}\`) so the run ` +
+        `that is being attested is the run that is counted. Accepted: a full Vitest/Jest JSON report ` +
+        `(numTotalTests, numPassedTests, numFailedTests, numPendingTests, numTodoTests, the four ` +
+        `numTotal/Passed/Failed/PendingTestSuites counters, success, testResults[].assertionResults, ` +
+        `counters equal to the assertions); a bare summary as the LAST stdout line, at minimum ` +
+        `{"numPassedTests":N} (numFailedTests, numTotalTests and success optional, no testResults); ` +
+        `or node:test TAP (--test-reporter=tap) with its 1..N plan and # tests/# pass/# fail summary. ` +
+        `A report file this run writes (its --outputFile, or ${REDIRECTED_JSON_REPORT}) is read too, ` +
+        `but one produced by a separate invocation is deliberately not accepted \u2014 it is not bound ` +
+        `to this execution; record that as \`test-run:<path>\` evidence instead, or drop minCount if ` +
+        `an exit code is the guarantee you want.`);
 }
 /**
  * Zero-count runner summaries that name failure without reporting any: node:test
@@ -1917,13 +2034,15 @@ async function runTestGate(gate, index, projectRoot, timeoutMs, context) {
     const announced = await announcedReportFile(captured.stdout, projectRoot);
     if (announced !== null && !before.has(announced))
         before.set(announced, null);
-    const counts = structuredTestCounts(captured) ?? (await freshReportCounts(before, startedAt));
+    const refusals = [];
+    const counts = structuredTestCounts(captured, refusals) ??
+        (await freshReportCounts(before, startedAt, refusals));
     // T12308: the counts come from this run's own validated report; only their
     // ABSENCE is an error, because inferring a count from exit zero is the thing
     // that must not happen. T13753: the error keeps the run's execution record.
     if (gate.minCount !== undefined && gate.minCount > 0) {
         if (counts === null)
-            return processGateResult(index, gate, captured, 'error', describeMissingTestCount(gate));
+            return processGateResult(index, gate, captured, 'error', describeMissingTestCount(gate, refusals[0]));
         if (counts.numPassedTests < gate.minCount)
             return processGateResult(index, gate, captured, 'fail', `Structured report counts ${counts.numPassedTests} passing tests, below the required minimum of ${gate.minCount}`);
     }