ccqa 1.23.0 → 1.24.0

package/dist/bin/ccqa.mjs

@@ -4556,6 +4556,7 @@ const PerspectiveSpecSchema = z.object({
 	testCondition: z.string().optional(),
 	preconditions: z.array(z.string().min(1)).optional(),
 	status: PerspectiveStatusSchema,
+	changedAt: z.string().optional(),
 	note: z.string().optional()
 }).strip();
 const PerspectiveFeatureSchema = z.object({
@@ -7038,6 +7039,7 @@ const SpecRerunSchema = z.object({
 	driftLabel: DriftLabelSchema.exclude(["UNKNOWN"]).optional(),
 	auditAssumedReached: RerunUnknownReasonSchema.optional(),
 	executionAssumedReached: RerunUnknownReasonSchema.optional(),
+	specChangedSince: z.string().optional(),
 	heldBy: SpecLockSchema.nullable(),
 	lastRun: SpecLedgerEntrySchema.nullable(),
 	lastGreen: SpecLedgerEntrySchema.nullable(),
@@ -16180,6 +16182,53 @@ For each test case above, write a 1–2 sentence factual \`summary\` of what it
 `;
 }
 //#endregion
+//#region src/spec/spec-changed-at.ts
+/**
+* One `git log` over the spec tree, walked newest-first. The first time a spec's
+* directory appears is that spec's last edit.
+*
+* Best-effort: outside a repository (or with no history) this returns an empty
+* map and every caller falls back to what it did before. A missing timestamp
+* must never make a spec look fresher than it is.
+*/
+async function readSpecChangedAt(cwd) {
+	const out = /* @__PURE__ */ new Map();
+	let stdout;
+	try {
+		({stdout} = await execFileP("git", [
+			"log",
+			"--pretty=format:%x00%cI",
+			"--name-only",
+			"--",
+			".ccqa/features"
+		], {
+			cwd,
+			maxBuffer: 64 * 1024 * 1024
+		}));
+	} catch {
+		return out;
+	}
+	let when = "";
+	for (const line of stdout.split("\n")) {
+		if (line.startsWith("\0")) {
+			when = line.slice(1).trim();
+			continue;
+		}
+		const key = specKeyOf(line.trim());
+		if (key && when && !out.has(key)) out.set(key, when);
+	}
+	return out;
+}
+/**
+* "feature/spec" for a path under the spec tree, or null for anything else.
+* Every file in a case's directory counts: the generated code moving is as
+* much a change to the test as the spec.yaml moving.
+*/
+function specKeyOf(path) {
+	const m = /^\.ccqa\/features\/([^/]+)\/test-cases\/([^/]+)\//.exec(path);
+	return m ? `${m[1]}/${m[2]}` : null;
+}
+//#endregion
 //#region src/cli/perspectives.ts
 const perspectivesCommand = addHubOptions(addLanguageOption(new Command("perspectives").description("Generate/update the project's perspectives document on the hub — a factual inventory of existing test coverage (no severity, no gap analysis)").option("--instruction <text>", "Hint to steer how summaries are written").option("-y, --yes", "Apply without asking [y/N]", false).option("--verify", "Check the hub document against the local specs (mechanical fields only) and exit 1 when it is stale. No Claude calls — cheap enough for CI.", false).option("-m, --model <name>", "Claude model alias ('sonnet'|'opus'|'haiku') or full ID").option("--project <name>", "Hub project to store the document under (default: cwd directory name)"))).action(withHubErrors(async (opts) => {
 	await withCostReporting("perspectives", () => opts.verify ? runPerspectivesCheck(opts) : runPerspectives(opts));
@@ -16330,17 +16379,20 @@ async function cleanupLegacyLocalFiles() {
 */
 async function buildSkeleton(tree) {
 	const config = await loadProjectConfig(process.cwd()).catch(() => null);
+	const changedAt = await readSpecChangedAt(process.cwd());
 	return (await Promise.all(tree.map(async (feature) => {
 		const specs = await Promise.all(feature.specs.filter((s) => s.hasSpecFile).map(async (s) => {
 			const specYaml = await tryReadSpecFile(feature.featureName, s.specName);
 			const meta = readSpecMeta(s.specName, specYaml);
 			const plugin = resolveSpecTarget(specYaml, config);
 			const status = await deriveStatus(feature.featureName, s.specName, meta.mode, plugin);
+			const lastEdit = changedAt.get(`${feature.featureName}/${s.specName}`);
 			return {
 				specName: s.specName,
 				title: meta.title,
 				summary: "",
-				status
+				status,
+				...lastEdit ? { changedAt: lastEdit } : {}
 			};
 		}));
 		return {
@@ -17838,7 +17890,11 @@ function readSpecTargets(doc) {
 		for (const spec of specs) {
 			const specName = prop(spec, "specName");
 			if (typeof specName !== "string") continue;
-			out.push({ key: `${featureName}/${specName}` });
+			const changedAt = prop(spec, "changedAt");
+			out.push({
+				key: `${featureName}/${specName}`,
+				...typeof changedAt === "string" && changedAt ? { changedAt } : {}
+			});
 		}
 	}
 	return out;
@@ -17959,9 +18015,40 @@ function createReleaseLocksHandler(storage) {
 }
 //#endregion
 //#region src/hub/core/rerun.ts
+/**
+* When each deployed commit reached the environment. A baseline read at that
+* commit cannot have seen anything committed after it was deployed.
+*/
+function deployedAt(log) {
+	const out = /* @__PURE__ */ new Map();
+	for (const entry of log.entries) out.set(entry.sha, entry.at);
+	return out;
+}
+/**
+* Has the spec moved since the baseline was taken?
+*
+* A verdict is a claim about a (spec, product) pair, so either side moving
+* invalidates it. The deploy log covers the product side; this covers the
+* other one. Without it a spec repaired and merged stays `needsRepair` until
+* a deploy happens to reach it, and a run that passed against the previous
+* spec keeps answering `verified` for the new one.
+*
+* Compared against when the baseline commit was *deployed*, not when the audit
+* or run happened: the tree read at that commit predates its deployment, so an
+* edit after it is definitely not in it. Falls back to the baseline's own
+* timestamp when the log cannot place the commit.
+*
+* One-directional. A later edit time proves the baseline is stale; an earlier
+* one proves nothing, and this answers false rather than guessing.
+*/
+function specMovedSince(changedAt, baselineSha, baselineAt, deployTimes) {
+	if (!changedAt) return null;
+	return changedAt > (baselineSha && deployTimes.get(baselineSha) || baselineAt) ? changedAt : null;
+}
 function computeRerun(input) {
 	const { specs, ledger, log, touchIndex, drift, locks, now } = input;
 	const range = buildRange(log, touchIndex);
+	const deployTimes = deployedAt(log);
 	const out = {};
 	for (const spec of specs) {
 		const coords = {
@@ -17969,11 +18056,17 @@ function computeRerun(input) {
 			lastGreen: ledger.green[spec.key] ?? null,
 			lastRed: ledger.red[spec.key] ?? null
 		};
-		const audit = auditState(drift, spec.key, range);
-		const execution = executionState(coords, (sha) => freshness(sha, spec.key, range));
+		let audit = auditState(drift, spec.key, range);
+		let execution = executionState(coords, (sha) => freshness(sha, spec.key, range));
+		const driftEntry = drift.specs[spec.key];
+		const auditMoved = specMovedSince(spec.changedAt, driftEntry?.gitHead ?? null, driftEntry?.at ?? "", deployTimes);
+		const runMoved = specMovedSince(spec.changedAt, coords.lastRun?.deployedSha ?? null, coords.lastRun?.at ?? "", deployTimes);
+		if (auditMoved && audit.audit !== "due") audit = { audit: "due" };
+		if (runMoved && execution.execution === "passed") execution = { execution: "stale" };
 		const held = heldBy(locks, spec.key, now);
 		out[spec.key] = {
 			verdict: decide(audit.audit, execution.execution, held),
+			...auditMoved || runMoved ? { specChangedSince: auditMoved ?? runMoved } : {},
 			...audit,
 			...execution,
 			heldBy: held,

package/dist/hub-client/index.d.mts

@@ -286,6 +286,7 @@ declare const RerunReportSchema: z.ZodObject<{
       deployedShaNotInLog: "deployedShaNotInLog";
       gapInRange: "gapInRange";
     }>>;
+    specChangedSince: z.ZodOptional<z.ZodString>;
     heldBy: z.ZodNullable<z.ZodObject<{
       kind: z.ZodEnum<{
         run: "run";

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccqa",
-  "version": "1.23.0",
+  "version": "1.24.0",
   "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.23.0",
+  "version": "1.24.0",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {