valent-pipeline 0.19.63 → 0.19.64

package/bin/cli.js

@@ -760,6 +760,7 @@ traceCmd
   .option('--reqs-manifest <path>', 'AC manifest (defaults to stories/<id>/output/reqs-brief.manifest.json)')
   .option('--spec-manifest <path>', 'Spec manifest (defaults to stories/<id>/output/qa-test-spec.manifest.json)')
   .option('--label <name>', 'Evidence-run label whose junit results prove execution (default qa-b-tests)')
+  .option('--run <runId>', 'Bind to an exact evidence run id (overrides label resolution — use when several suites multiplex one label)')
   .action(async (options) => {
     const { traceCheckCmd } = await import('../src/commands/trace.js');
     await traceCheckCmd(options);
@@ -773,6 +774,7 @@ traceCmd
   .option('--reqs-manifest <path>', 'AC manifest path override')
   .option('--spec-manifest <path>', 'Spec manifest path override')
   .option('--label <name>', 'Evidence-run label for junit results (default qa-b-tests)')
+  .option('--run <runId>', 'Bind to an exact evidence run id (overrides label resolution — use when several suites multiplex one label)')
   .option('--out <path>', 'Output path (defaults to stories/<id>/output/traceability-matrix.generated.md)')
   .action(async (options) => {
     const { traceMatrixCmd } = await import('../src/commands/trace.js');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valent-pipeline",
-  "version": "0.19.63",
+  "version": "0.19.64",
   "description": "v3 multi-agent AI pipeline for software development lifecycle",
   "type": "module",
   "bin": {

package/src/commands/trace.js

@@ -9,9 +9,21 @@
 import { readFileSync, existsSync, mkdirSync, writeFileSync } from 'fs';
 import { join, isAbsolute, dirname } from 'path';
 import { traceCheck, traceMatrix } from '../lib/trace.js';
-import { evidenceDir, latestRun, resolveRoot } from '../lib/evidence.js';
+import { evidenceDir, resolveRunForAssert, requiredCaseIdsForRun, resolveRoot } from '../lib/evidence.js';
 import { parseJunit } from '../lib/junit.js';
 
+/** Load an exact evidence run by id (for `--run`), or null if absent/unreadable. */
+function loadRunById(evDir, runId) {
+  const dir = join(evDir, 'runs', runId);
+  const recPath = join(dir, 'evidence.json');
+  if (!existsSync(recPath)) return null;
+  try {
+    return { runId, dir, record: JSON.parse(readFileSync(recPath, 'utf-8')) };
+  } catch {
+    return null;
+  }
+}
+
 function readJson(path, what) {
   try {
     return JSON.parse(readFileSync(path, 'utf-8'));
@@ -41,11 +53,24 @@ function loadInputs(options) {
     return { noop: 'spec manifest predates the per-case `ac` field — skipping (no-op pass). Re-run QA-A to gain mechanical AC coverage.' };
   }
 
-  // Executed testcases from the newest report-bearing evidence run (junit re-parsed from the
-  // frozen copies — never from a transcription).
+  // Executed testcases from the evidence run that ACTUALLY carries this story's required acceptance
+  // cases — NOT merely the newest same-label run. A REVALIDATE (and any multi-suite cycle) re-runs the
+  // full npm suite under the `qa-b-tests` label ALONGSIDE the acceptance run; binding to the newest by
+  // label alone globs the full suite (which carries ZERO of the story's required cases) and false-fails
+  // every required case as "unexecuted" — label-multiplexing, the M-11/.45/.60 class, of which the
+  // trace-check was the last unfixed surface (the `evidence assert` + verdict-crosscheck paths already
+  // resolve this way). resolveRunForAssert binds to the same-SHA sibling carrying a required case id and
+  // preserves the #5 crash-loud invariant (a report-less newest is never silently skipped). An explicit
+  // --run pins exactly, for the operator who wants to override resolution. (junit re-parsed from the
+  // frozen copies — never from a transcription.)
   let junitCases = null;
   let runId = null;
-  const run = latestRun(evidenceDir(root, story), { label: options.label || 'qa-b-tests', requireReport: true });
+  const evDir = evidenceDir(root, story);
+  const label = options.label || 'qa-b-tests';
+  const requiredCaseIds = requiredCaseIdsForRun(cases);
+  const run = options.run
+    ? loadRunById(evDir, options.run)
+    : resolveRunForAssert(evDir, { label, requiredCaseIds });
   if (run) {
     runId = run.runId;
     junitCases = [];