ccqa 0.8.0 → 0.8.2

package/dist/bin/ccqa.mjs

@@ -869,11 +869,23 @@ async function timedPhase(label, fn, scope = "fix") {
 * prioritisation; that is a separate, later concern.
 */
 /**
-* Whether the spec has been traced / generated. Both are derived mechanically
-* by the CLI from on-disk artifacts (actions.json / test.spec.ts), never
-* written by Claude — these are facts and must not drift.
+* Mechanically-derived facts about the spec's recording state, transcribed by
+* the CLI from spec.yaml + on-disk artifacts (actions.json / test.spec.ts).
+* Never written by Claude — these must not drift.
+*
+* `mode` mirrors spec.yaml's `mode:` field (defaulting to `deterministic`).
+* Its meaning shapes how `traced` / `generated` should be interpreted:
+*
+*  - `mode: deterministic` — `traced` and `generated` are the spec's
+*    completeness signal. `generated: false` means "spec.yaml exists but
+*    `ccqa record` hasn't been run yet" — i.e. the case has not been
+*    materialised into a runnable test.
+*  - `mode: live` — the live runner skips codegen entirely, so `traced` and
+*    `generated` carry no completeness meaning here. Reports should not flag
+*    `generated: false` as incomplete for live specs.
 */
 const PerspectiveStatusSchema = z.object({
+	mode: SpecModeSchema,
 	traced: z.boolean(),
 	generated: z.boolean()
 }).strict();
@@ -9243,7 +9255,7 @@ async function buildSkeleton(tree) {
 	return (await Promise.all(tree.map(async (feature) => {
 		const specs = await Promise.all(feature.specs.filter((s) => s.hasSpecFile).map(async (s) => {
 			const spec = await readSpecMeta(feature.featureName, s.specName);
-			const status = await deriveStatus(feature.featureName, s.specName);
+			const status = await deriveStatus(feature.featureName, s.specName, spec.mode);
 			const entry = {
 				specName: s.specName,
 				title: spec.title,
@@ -9326,15 +9338,28 @@ function noteKey(featureName, specName) {
 }
 async function readSpecMeta(featureName, specName) {
 	const raw = await tryReadSpecFile(featureName, specName);
-	if (raw === null) return { title: specName };
+	if (raw === null) return {
+		title: specName,
+		mode: DEFAULT_SPEC_MODE
+	};
 	try {
 		const parsed = parse(raw);
-		if (typeof parsed.title === "string" && parsed.title.length > 0) return { title: parsed.title };
-	} catch {}
-	return { title: specName };
+		const title = typeof parsed.title === "string" && parsed.title.length > 0 ? parsed.title : specName;
+		const modeResult = SpecModeSchema.safeParse(parsed.mode);
+		return {
+			title,
+			mode: modeResult.success ? modeResult.data : DEFAULT_SPEC_MODE
+		};
+	} catch {
+		return {
+			title: specName,
+			mode: DEFAULT_SPEC_MODE
+		};
+	}
 }
-async function deriveStatus(featureName, specName) {
+async function deriveStatus(featureName, specName, mode) {
 	return {
+		mode,
 		traced: await stat(join(getSpecDir(featureName, specName), "actions.json")).then(() => true).catch(() => false),
 		generated: await getTestScript(featureName, specName) !== null
 	};
@@ -9426,20 +9451,34 @@ const LABELS_JA = {
 	caseCol: "ケース",
 	itemCol: "項目",
 	valueCol: "内容",
+	modeCol: "モード",
+	statusCol: "状態",
+	modeLabel: "モード",
 	summary: "検証内容",
 	preconditions: "前提条件",
 	startScreen: "開始画面",
-	relatedCode: "関連コード"
+	relatedCode: "関連コード",
+	modeDeterministic: "deterministic",
+	modeLive: "live",
+	notRunnable: "⚠️ 未record",
+	runnable: "✅ 実行可能"
 };
 const LABELS_EN = {
 	indexTitle: "Test Perspectives (perspectives)",
 	caseCol: "Case",
 	itemCol: "Item",
 	valueCol: "Value",
+	modeCol: "Mode",
+	statusCol: "Status",
+	modeLabel: "Mode",
 	summary: "Verifies",
 	preconditions: "Preconditions",
 	startScreen: "Start screen",
-	relatedCode: "Related code"
+	relatedCode: "Related code",
+	modeDeterministic: "deterministic",
+	modeLive: "live",
+	notRunnable: "⚠️ not recorded",
+	runnable: "✅ runnable"
 };
 /**
 * Pick the label set for a `--language` value. Only an explicit English tag
@@ -9451,6 +9490,19 @@ function labelsFor(language) {
 	return /^en\b/i.test(language?.trim() ?? "") ? LABELS_EN : LABELS_JA;
 }
 /**
+* Whether the spec is runnable from the reviewer's perspective. Live specs
+* are always runnable (no codegen step); a deterministic spec is runnable
+* only once `test.spec.ts` exists.
+*/
+function statusLabel(status, labels) {
+	if (status.mode === "live") return labels.runnable;
+	return status.generated ? labels.runnable : labels.notRunnable;
+}
+/** The spec's execution mode (deterministic or live), per spec.yaml. */
+function modeLabel(status, labels) {
+	return status.mode === "live" ? labels.modeLive : labels.modeDeterministic;
+}
+/**
 * Path to a spec.yaml relative to the **root** `.ccqa/perspectives.md`
 * (i.e. relative to the `.ccqa/` dir). Used for the category index links.
 */
@@ -9493,11 +9545,13 @@ function renderIndexMarkdown(perspectives, labels = LABELS_JA) {
 		const detailLink = featureDetailRelPathFromRoot(feature.featureName);
 		lines.push(`## [${feature.featureName}](${detailLink})`);
 		lines.push("");
-		lines.push(`| ${labels.caseCol} | spec |`);
-		lines.push("| --- | --- |");
+		lines.push(`| ${labels.caseCol} | ${labels.modeCol} | ${labels.statusCol} | spec |`);
+		lines.push("| --- | --- | --- | --- |");
 		for (const spec of feature.specs) {
 			const specLink = specRelPathFromRoot(feature.featureName, spec.specName);
-			lines.push(`| ${mdCell(spec.title)} | [spec](${specLink}) |`);
+			const mode = mdCell(modeLabel(spec.status, labels));
+			const status = mdCell(statusLabel(spec.status, labels));
+			lines.push(`| ${mdCell(spec.title)} | ${mode} | ${status} | [spec](${specLink}) |`);
 		}
 		lines.push("");
 	}
@@ -9537,11 +9591,15 @@ function renderSpecMarkdown(spec, labels = LABELS_JA) {
 	lines.push("");
 	lines.push(`| ${labels.itemCol} | ${labels.valueCol} |`);
 	lines.push("| --- | --- |");
+	lines.push(`| ${labels.modeLabel} | ${mdCell(modeLabel(spec.status, labels))} |`);
+	lines.push(`| ${labels.statusCol} | ${mdCell(statusLabel(spec.status, labels))} |`);
 	if (spec.summary) lines.push(`| ${labels.summary} | ${mdCell(spec.summary)} |`);
 	if (spec.preconditions && spec.preconditions.length > 0) lines.push(`| ${labels.preconditions} | ${spec.preconditions.map(mdCell).join("<br>")} |`);
 	if (spec.startScreen) lines.push(`| ${labels.startScreen} | ${mdCell(spec.startScreen)} |`);
 	const specPath = specRelPathFromCategory(spec.specName);
 	lines.push(`| spec | [${specPath}](${specPath}) |`);
+	lines.push(`| ${labels.modeLabel} | ${mdCell(modeLabel(spec.status, labels))} |`);
+	lines.push(`| ${labels.statusCol} | ${mdCell(statusLabel(spec.status, labels))} |`);
 	if (spec.relatedPaths && spec.relatedPaths.length > 0) lines.push(`| ${labels.relatedCode} | ${spec.relatedPaths.map((p) => `\`${p}\``).join("<br>")} |`);
 	if (spec.note) lines.push(`| 📝 note | ${mdCell(spec.note)} |`);
 	lines.push("");

package/dist/package.json

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

package/package.json

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