ccqa 1.40.7 → 1.40.8

package/dist/bin/ccqa.mjs

@@ -16360,6 +16360,53 @@ async function collectChangedSpecs(specs, opts) {
 	};
 }
 //#endregion
+//#region src/run/measure-backfill.ts
+/**
+* `ccqa run --measure-backfill <n>`: keep the measured-reach edges alive.
+*
+* Selection (ADR-0024) consumes each spec's most recent measured reach, and
+* an edge expires after `EDGE_MAX_AGE_MS`. Nothing else re-measures: an
+* unmeasured spec answers `unknown`, `unknown` marks nothing due (ADR-0023),
+* and a suite can settle into a state where no run ever fires — the seed
+* deadlock. Appending a few unmeasured-or-aging specs to every selected run
+* breaks that loop and keeps the whole suite inside the freshness window
+* without a scheduled full sweep.
+*/
+/**
+* Re-measure once an edge has spent half its lifetime. Half, not "expired":
+* a spec re-measured only after expiry answers `unknown` for the gap between
+* expiry and the next run, which is exactly the window this flag exists to
+* close.
+*/
+const REMEASURE_AFTER_MS = EDGE_MAX_AGE_MS / 2;
+/**
+* Picks up to `limit` specs from `inventory` worth re-measuring: ones with no
+* edge at all first (they cost an `unknown` verdict today), then the oldest
+* measured ones. Specs already selected for this run are never doubled.
+*/
+function chooseMeasureBackfill(inventory, selected, edges, limit, now) {
+	const alreadyRunning = new Set(selected.map(specKey));
+	const missing = [];
+	const aging = [];
+	for (const spec of inventory) {
+		if (alreadyRunning.has(specKey(spec))) continue;
+		const edge = edges.get(specKey(spec));
+		if (edge === void 0) missing.push(spec);
+		else if (now - edge.measuredAt > REMEASURE_AFTER_MS) aging.push({
+			spec,
+			measuredAt: edge.measuredAt
+		});
+	}
+	aging.sort((a, b) => a.measuredAt - b.measuredAt);
+	const specs = [...missing, ...aging.map((entry) => entry.spec)].slice(0, limit);
+	const missingTaken = Math.min(missing.length, specs.length);
+	return {
+		specs,
+		missing: missingTaken,
+		aging: specs.length - missingTaken
+	};
+}
+//#endregion
 //#region src/run/pipeline.ts
 async function resolveVitestConfig(cwd) {
 	const userConfig = resolve(cwd, ".ccqa/vitest.config.ts");
@@ -16538,6 +16585,10 @@ async function executeRun(targets, opts) {
 	if (rerunProfile !== null && hubCtx == null) throw new RunUsageError(needsHubConnection("--only-hub-rerun-needed"));
 	if (opts.reportToHub && hubCtx == null) throw new RunUsageError(REPORT_TO_HUB_NEEDS_CONNECTION);
 	if (opts.learnHubLivePrompt && hubCtx == null) throw new RunUsageError(needsHubConnection("--learn-hub-live-prompt"));
+	if ((opts.measureBackfill ?? 0) > 0) {
+		if (opts.coverage !== true) throw new RunUsageError("--measure-backfill does nothing without --coverage — there is no measurement to keep fresh");
+		if (!filtering) throw new RunUsageError("--measure-backfill needs a selection flag (--only-hub-rerun-needed / --only-affected-by); an explicit spec list runs exactly what was asked");
+	}
 	let coverageInbox;
 	if (opts.coverageInbox === "hub") {
 		if (opts.coverage !== true) throw new RunUsageError("--coverage-inbox hub does nothing without --coverage — there is no measurement to stream");
@@ -16586,6 +16637,7 @@ async function executeRun(targets, opts) {
 	};
 	const enumerateAll = () => listAllSpecsWithSpecFile(cwd);
 	let specs = dedupeSpecs((await Promise.all((targets.length ? targets : [void 0]).map((t) => resolveSpecTargets(t, enumerateAll, cwd)))).flat());
+	const inventory = specs;
 	if (filtering) {
 		const before = specs.length;
 		let inProgress = 0;
@@ -16616,6 +16668,14 @@ async function executeRun(targets, opts) {
 			throw new RunUsageError("nothing was selected and no spec was cleared to run: exiting non-zero rather than reporting a green run that verified nothing");
 		}
 	}
+	if (filtering && (opts.measureBackfill ?? 0) > 0 && hubCtx != null) {
+		const edges = await loadCoverageEdges(hubCtx);
+		const pick = chooseMeasureBackfill(inventory, specs, edges, opts.measureBackfill ?? 0, Date.now());
+		if (pick.specs.length > 0) {
+			specs = [...specs, ...pick.specs];
+			meta("measure-backfill", `${pick.specs.length} spec(s) appended (${pick.missing} unmeasured / ${pick.aging} aging)`);
+		}
+	}
 	if (specs.length === 0) {
 		warn("no specs to run");
 		return {
@@ -17570,7 +17630,11 @@ const runCommand = addHubOptions(addProfileOption(addLanguageOption(new Command(
 }, "text").option("--report-to-hub", "Incrementally push the run report to the hub as the run progresses (open → patch per spec → finalize). Requires --hub-url/--hub-token (or CCQA_HUB_URL/CCQA_HUB_TOKEN). Without it, hub credentials are used only to fetch variables/sessions/prompts, not to push.").option("--coverage", "Measure what each spec actually reached in the application under test, and record it on the spec's report row. Needs a `coverage:` block in .ccqa/config.yaml naming the instrumented origins the spec cookie may go to. The browser half attaches to the target's browser from outside (nothing is emitted into generated tests; needs node 22+); the server half needs the application running with ccqa-tools.").option("--coverage-inbox <where>", "With --coverage: where the measurement's two sides meet. 'local' (default) binds a loopback inbox on this machine for the run's duration; 'hub' appends every event to the hub's durable coverage inbox instead — nothing listens on the runner, report.json carries no coverage, and the hub resolves per-spec results on read (requires a hub connection).", (raw) => {
 	if (COVERAGE_INBOX_MODES.includes(raw)) return raw;
 	throw new Error(`--coverage-inbox must be one of ${COVERAGE_INBOX_MODES.join(" | ")}`);
-}, "local").optionsGroup("Learning:").option("--learn-hub-live-prompt", "(live only) After the run finishes, ask Claude to refresh the \"live.agent\" prompt on the hub from a summary of the run. Requires a hub connection.").optionsGroup("Environment and connection:").option("--cwd <path>", "Working directory containing the .ccqa/ tree (monorepo support). Defaults to the current directory.").option("--project <name>", "Project name for the hub. Defaults to the current directory's name.")))).action(async (targets, opts) => {
+}, "local").option("--measure-backfill <n>", "With --coverage and a selection flag (--only-hub-rerun-needed / --only-affected-by): also run up to <n> specs whose measured reach is missing or past half its freshness window, unmeasured-first then oldest-first. This is what keeps selection's edges alive — without it an unmeasured spec answers `unknown` forever, because `unknown` marks nothing due and nothing else re-measures.", (raw) => {
+	const n = Number(raw);
+	if (!Number.isInteger(n) || n < 0) throw new Error("--measure-backfill must be a non-negative integer");
+	return n;
+}).optionsGroup("Learning:").option("--learn-hub-live-prompt", "(live only) After the run finishes, ask Claude to refresh the \"live.agent\" prompt on the hub from a summary of the run. Requires a hub connection.").optionsGroup("Environment and connection:").option("--cwd <path>", "Working directory containing the .ccqa/ tree (monorepo support). Defaults to the current directory.").option("--project <name>", "Project name for the hub. Defaults to the current directory's name.")))).action(async (targets, opts) => {
 	await runCliAction(targets, opts);
 });
 /** Parse --concurrency: a positive integer. Rejects 0, negatives, non-integers. */

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.40.7",
+  "version": "1.40.8",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.40.7",
+  "version": "1.40.8",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {