ccqa 1.7.0 → 1.8.1

package/dist/bin/ccqa.mjs

@@ -789,10 +789,26 @@ async function runPool(items, concurrency, fn) {
 //#endregion
 //#region src/drift/auth.ts
 /**
+* Claude Code can also run against AWS Bedrock / Google Vertex AI, selected by
+* these env toggles. Credentials then come from the cloud SDK's own chain
+* (instance/task roles, gcloud auth, …), so none of the Anthropic-side probes
+* below apply — a set toggle counts as auth being available. ccqa forwards the
+* toggle verbatim; only "0"/"false" (any case) is treated as explicitly off.
+*/
+const CLOUD_PROVIDER_ENV_KEYS = ["CLAUDE_CODE_USE_BEDROCK", "CLAUDE_CODE_USE_VERTEX"];
+function cloudProviderEnabled() {
+	return CLOUD_PROVIDER_ENV_KEYS.some((key) => {
+		const value = process.env[key]?.trim().toLowerCase();
+		return value !== void 0 && value !== "" && value !== "0" && value !== "false";
+	});
+}
+/**
 * Probe whether the host has any credential the Anthropic SDK can pick up:
 *   1. ANTHROPIC_API_KEY env var (CI / scripted use)
-*   2. ~/.claude/.credentials.json (Claude Code login, file-based platforms)
-*   3. macOS Keychain item "Claude Code-credentials" (Claude Code login on
+*   2. CLAUDE_CODE_USE_BEDROCK / CLAUDE_CODE_USE_VERTEX (cloud-provider
+*      endpoints authenticated by the cloud SDK's credential chain)
+*   3. ~/.claude/.credentials.json (Claude Code login, file-based platforms)
+*   4. macOS Keychain item "Claude Code-credentials" (Claude Code login on
 *      darwin stores the OAuth credentials in the Keychain, not on disk)
 *
 * Claude-driven hooks are opt-in, so the caller only consults this after the
@@ -802,11 +818,12 @@ async function runPool(items, concurrency, fn) {
 function driftAuthAvailable() {
 	const key = process.env["ANTHROPIC_API_KEY"];
 	if (typeof key === "string" && key.length > 0) return { ok: true };
+	if (cloudProviderEnabled()) return { ok: true };
 	if (existsSync(join(homedir(), ".claude", ".credentials.json"))) return { ok: true };
 	if (process.platform === "darwin" && keychainHasClaudeCredentials()) return { ok: true };
 	return {
 		ok: false,
-		reason: "no ANTHROPIC_API_KEY / claude login"
+		reason: "no ANTHROPIC_API_KEY / Bedrock or Vertex env / claude login"
 	};
 }
 /**
@@ -2425,22 +2442,22 @@ function toAgentBrowserArgs(action) {
 			if (!action.locator) return null;
 			return [
 				lit("select"),
-				lit(locatorToSelector(action.locator)),
+				val(locatorToSelector(action.locator)),
 				val(action.value ?? "")
 			];
 		case "drag":
 			if (!action.locator || !action.target) return null;
 			return [
 				lit("drag"),
-				lit(locatorToSelector(action.locator)),
-				lit(locatorToSelector(action.target))
+				val(locatorToSelector(action.locator)),
+				val(locatorToSelector(action.target))
 			];
 		case "upload": {
 			const files = action.files ?? [];
 			if (!action.locator || files.length === 0) return null;
 			return [
 				lit("upload"),
-				lit(locatorToSelector(action.locator)),
+				val(locatorToSelector(action.locator)),
 				...files.map(val)
 			];
 		}
@@ -2480,7 +2497,7 @@ function interactionToArgs(action) {
 	const abAction = action.action === "type" ? "fill" : action.action;
 	const takesInput = action.action === "fill" || action.action === "type";
 	if (!(loc.by !== "css" || action.index !== void 0 || action.action === "focus")) {
-		const args = [lit(abAction), lit(loc.value)];
+		const args = [lit(abAction), val(loc.value)];
 		if (takesInput) args.push(val(action.value ?? ""));
 		return args;
 	}
@@ -2490,7 +2507,7 @@ function interactionToArgs(action) {
 		if (loc.by !== "css") return null;
 		if (action.index === "first" || action.index === "last") out.push(lit(action.index));
 		else out.push(lit("nth"), lit(String(action.index)));
-		out.push(lit(loc.value));
+		out.push(val(loc.value));
 	} else {
 		if (loc.by === "css") return null;
 		out.push(lit(loc.by), val(loc.value));
@@ -3016,6 +3033,7 @@ const ReportSpecResultSchema = z.object({
 	assertions: z.array(ReportAssertionSchema).nullable(),
 	analysis: FailureAnalysisSchema.nullable(),
 	analysisSkipped: z.string().nullable(),
+	customPromptVersion: z.string().optional(),
 	analysisBase: z.object({
 		ref: z.string(),
 		sha: z.string()
@@ -3055,6 +3073,7 @@ const RunReportDataSchema = z.object({
 	kind: z.enum(["run", "drift"]).default("run"),
 	createdAt: z.string(),
 	runId: z.string().nullable(),
+	runUrl: z.string().nullable().optional(),
 	git: GitEnvelopeSchema,
 	model: z.string().nullable(),
 	language: z.string().nullable().default(null),
@@ -3097,14 +3116,54 @@ const LabelsExportSchema = z.object({
 * names and failure signals) lives here and on the hub — never hard-coded
 * into ccqa itself.
 */
+/**
+* One per-target overlay: the same learned-note fields as the top-level, minus
+* `basePromptVersion` (shared across the whole document — the base analysis
+* prompt is target-agnostic).
+*/
+const AnalysisCustomPromptOverlaySchema = z.object({
+	customPromptVersion: z.string(),
+	generatedAt: z.string(),
+	guidance: z.string()
+});
 const AnalysisCustomPromptSchema = z.object({
 	schemaVersion: z.literal(1),
 	basePromptVersion: z.string(),
 	customPromptVersion: z.string(),
 	generatedAt: z.string(),
-	guidance: z.string()
+	guidance: z.string(),
+	byTarget: z.record(z.string(), AnalysisCustomPromptOverlaySchema).optional()
 });
 /**
+* Lift one overlay into a standalone single-target `AnalysisCustomPrompt`: the
+* overlay's own note fields plus the document-wide `schemaVersion` /
+* `basePromptVersion`, and never a `byTarget` map. Passing the document itself
+* as the overlay yields the un-scoped top-level note as a clean single prompt.
+*/
+function overlayAsPrompt(base, overlay) {
+	return {
+		schemaVersion: base.schemaVersion,
+		basePromptVersion: base.basePromptVersion,
+		customPromptVersion: overlay.customPromptVersion,
+		generatedAt: overlay.generatedAt,
+		guidance: overlay.guidance
+	};
+}
+/**
+* The effective single overlay for one target: its `byTarget` entry when it has
+* usable guidance, else the un-scoped top-level note when THAT has guidance,
+* else null. The returned value is a plain single-target `AnalysisCustomPrompt`
+* (no `byTarget`), so every downstream consumer — the prompt block and the
+* recorded `customPromptVersion` — sees exactly what was injected for the row.
+*/
+function resolveCustomPromptForTarget(cp, target) {
+	if (!cp) return null;
+	const scoped = cp.byTarget?.[target];
+	if (scoped && scoped.guidance.trim()) return overlayAsPrompt(cp, scoped);
+	if (cp.guidance.trim()) return overlayAsPrompt(cp, cp);
+	return null;
+}
+/**
 * Render the custom prompt as a prompt section, or "" when there's nothing to add.
 * Returning "" for the empty/absent case is what keeps the base prompt
 * byte-for-byte identical when no custom prompt is supplied (backward compatibility).
@@ -5694,6 +5753,7 @@ function createFailureAnalysisPass(deps) {
 			warnedDiffUnavailable = true;
 			info(`failure analysis: source diff unavailable (${specDiff.error}) — analyzing without diff context`);
 		}
+		const customPrompt = resolveCustomPromptForTarget(deps.customPrompt, input.target);
 		const fields = {
 			analysis: null,
 			analysisSkipped: null,
@@ -5733,7 +5793,7 @@ function createFailureAnalysisPass(deps) {
 			...input.artifactsDir ? { artifactsDir: input.artifactsDir } : {},
 			...deps.language ? { outputLanguage: deps.language } : {},
 			...deps.triageUserPrompt ? { triageUserPrompt: deps.triageUserPrompt } : {},
-			...deps.customPrompt ? { customPrompt: deps.customPrompt } : {}
+			...customPrompt ? { customPrompt } : {}
 		}, {
 			...deps.model ? { model: deps.model } : {},
 			cwd: deps.cwd,
@@ -5746,7 +5806,8 @@ function createFailureAnalysisPass(deps) {
 		printAnalysis(featureName, specName, outcome.analysis);
 		return {
 			...fields,
-			analysis: outcome.analysis
+			analysis: outcome.analysis,
+			...customPrompt ? { customPromptVersion: customPrompt.customPromptVersion } : {}
 		};
 	} };
 }
@@ -5849,6 +5910,7 @@ async function analyzeExternalRows(rows, run) {
 			readScript: () => readGeneratedTestSources(ref, deps.cwd),
 			failureLog: row.failureLogExcerpt ?? "",
 			specYaml: row.specYaml,
+			target: row.target ?? "agent-browser",
 			driftIssues,
 			artifactsDir: readableArtifactsDir(ref, deps)
 		});
@@ -7967,7 +8029,8 @@ function analysisFieldsFor(a, status) {
 		analysisSkipped: a.analysisSkipped,
 		failureLogExcerpt: a.failureLogExcerpt,
 		diffExcerpt: a.diffExcerpt,
-		...a.analysisBase ? { analysisBase: a.analysisBase } : {}
+		...a.analysisBase ? { analysisBase: a.analysisBase } : {},
+		...a.customPromptVersion ? { customPromptVersion: a.customPromptVersion } : {}
 	};
 	if (status === "failed") return { analysisSkipped: ANALYSIS_DISABLED };
 	return {};
@@ -8192,6 +8255,7 @@ async function analyzeOneLiveFailure(r, diffProvider, driftForSpec, auth, opts,
 		diffExcerpt: null
 	};
 	if (specDiff.error) info(`failure analysis: source diff unavailable (${specDiff.error}) — analyzing without diff context`);
+	const customPrompt = resolveCustomPromptForTarget(opts.customPrompt, AGENT_BROWSER_TARGET);
 	const outcome = await analyzeFailure({
 		liveTranscriptExcerpt: excerpt,
 		specYaml: r.specYaml,
@@ -8203,7 +8267,7 @@ async function analyzeOneLiveFailure(r, diffProvider, driftForSpec, auth, opts,
 		driftIssues: driftForSpec,
 		...opts.language ? { outputLanguage: opts.language } : {},
 		...opts.triageUserPrompt ? { triageUserPrompt: opts.triageUserPrompt } : {},
-		...opts.customPrompt ? { customPrompt: opts.customPrompt } : {}
+		...customPrompt ? { customPrompt } : {}
 	}, {
 		...opts.model ? { model: opts.model } : {},
 		cwd,
@@ -8220,7 +8284,8 @@ async function analyzeOneLiveFailure(r, diffProvider, driftForSpec, auth, opts,
 		analysisBase: {
 			ref: specDiff.base.ref,
 			sha: specDiff.base.sha
-		}
+		},
+		...customPrompt ? { customPromptVersion: customPrompt.customPromptVersion } : {}
 	};
 }
 function count(steps, target) {
@@ -8536,27 +8601,27 @@ function actionToLine$1(action) {
 					if (val) assertLine = `abAssertNotVisible(${jExpr$1("text=" + val)}, 180_000);`;
 					break;
 				case "element_visible":
-					if (sel) assertLine = `abAssertVisible(${j$1(sel)});`;
+					if (sel) assertLine = `abAssertVisible(${jExpr$1(sel)});`;
 					break;
 				case "element_not_visible":
-					if (sel) assertLine = `abAssertNotVisible(${j$1(sel)});`;
+					if (sel) assertLine = `abAssertNotVisible(${jExpr$1(sel)});`;
 					break;
 				case "url_contains":
 					if (val) assertLine = `abAssertUrl(${jExpr$1(val)});`;
 					break;
 				case "element_enabled":
 					if (isStateSelector(sel)) return tautologicalStateAssertMarker(action, sel);
-					if (sel && !sel.startsWith("text=") && !sel.startsWith("[aria-label=")) assertLine = `abAssertEnabled(${j$1(sel)});`;
+					if (sel && !sel.startsWith("text=") && !sel.startsWith("[aria-label=")) assertLine = `abAssertEnabled(${jExpr$1(sel)});`;
 					break;
 				case "element_disabled":
 					if (isStateSelector(sel)) return tautologicalStateAssertMarker(action, sel);
-					if (sel && !sel.startsWith("text=") && !sel.startsWith("[aria-label=")) assertLine = `abAssertDisabled(${j$1(sel)});`;
+					if (sel && !sel.startsWith("text=") && !sel.startsWith("[aria-label=")) assertLine = `abAssertDisabled(${jExpr$1(sel)});`;
 					break;
 				case "element_checked":
-					if (sel) assertLine = `abAssertChecked(${j$1(sel)});`;
+					if (sel) assertLine = `abAssertChecked(${jExpr$1(sel)});`;
 					break;
 				case "element_unchecked":
-					if (sel) assertLine = `abAssertUnchecked(${j$1(sel)});`;
+					if (sel) assertLine = `abAssertUnchecked(${jExpr$1(sel)});`;
 					break;
 			}
 			if (comment && assertLine) return `${comment}\n  ${assertLine}`;
@@ -8571,8 +8636,9 @@ function actionToLine$1(action) {
 }
 /**
 * Render one argv token into TS source: env-expandable tokens (fill values,
-* URLs, find texts) become template literals via `jExpr`; everything else
-* (command words, flags, raw CSS selectors) is a plain string literal.
+* URLs, find texts, CSS/selector-engine strings) become template literals via
+* `jExpr` when they carry a `${VAR}` / `$VAR` ref; command words and flags are
+* plain string literals.
 */
 function renderToken(token) {
 	return token.expandsEnv ? jExpr$1(token.text) : j$1(token.text);
@@ -8605,7 +8671,7 @@ const j$1 = (s) => JSON.stringify(s);
 * emits them as `${process.env.VAR ?? ""}` template-literal substitutions
 * instead of baking the literal `$VAR` string into the script. Used for
 * values that came from a spec or block param: form fills, opened URLs,
-* assertion texts/URLs.
+* assertion texts/URLs, and selector strings carrying a `${RUN_ID}`-style ref.
 */
 const jExpr$1 = (s) => envRefsToJsExpression(s);
 //#endregion
@@ -9487,6 +9553,9 @@ function emitPlaywrightDraft(input) {
 * Render a locator (plus positional pick) as a Playwright locator expression.
 * Semantic strategies map 1:1 onto the getBy* family; `by: "css"` keeps its
 * raw selector-engine string (locator() accepts `text=...` forms verbatim).
+* Every locator value — css included — goes through `jExpr`, so a `${VAR}` /
+* `$VAR` ref in a recorded selector expands to a `process.env` template
+* literal instead of baking the literal ref text into the selector.
 */
 function locatorToPlaywright(locator, index) {
 	let expr;
@@ -9518,7 +9587,7 @@ function locatorToPlaywright(locator, index) {
 			expr = `page.getByTestId(${jExpr(locator.value)})`;
 			break;
 		case "css":
-			expr = `page.locator(${j(locator.value)})`;
+			expr = `page.locator(${jExpr(locator.value)})`;
 			break;
 	}
 	if (index === "first") return `${expr}.first()`;
@@ -10061,6 +10130,25 @@ function createIncrementalReport(reportDir, envelope, sink) {
 	};
 }
 //#endregion
+//#region src/run/github-run.ts
+/**
+* The GitHub Actions run URL for the current job, built from the standard
+* Actions environment variables. Returns null unless all three are present,
+* so nothing is ever invented for a local run — the same "only when in CI"
+* contract the report envelope's `runId` (GITHUB_RUN_ID) already follows.
+*/
+function githubRunUrl(env = process.env) {
+	const server = env["GITHUB_SERVER_URL"];
+	const repo = env["GITHUB_REPOSITORY"];
+	const runId = githubRunId(env);
+	if (!server || !repo || !runId) return null;
+	return `${server}/${repo}/actions/runs/${runId}`;
+}
+/** The current GitHub Actions run id (GITHUB_RUN_ID); null outside Actions. */
+function githubRunId(env = process.env) {
+	return env["GITHUB_RUN_ID"] ?? null;
+}
+//#endregion
 //#region src/prompts/agent-update.ts
 /**
 * Build the prompts used by `--update-agent-prompt` to refresh
@@ -10582,11 +10670,15 @@ async function executeRun(targets, opts) {
 	let hubSink;
 	if (hubCtx != null && opts.pushReport) try {
 		const branch = await detectBranch(cwd);
+		const ciRunId = githubRunId();
+		const runUrl = githubRunUrl();
 		const opened = await hubCtx.hub.openRun({
 			project: hubCtx.project,
 			...branch ? { branch } : {},
 			...opts.profile ? { profile: opts.profile } : {},
 			...git.head ? { gitHead: git.head } : {},
+			...ciRunId ? { ciRunId } : {},
+			...runUrl ? { runUrl } : {},
 			kind: "run"
 		});
 		hubRunId = opened.id;
@@ -10932,6 +11024,7 @@ async function analyzeDeterministicSummaries(summaries, cwd, reportDir, { pass,
 			readScript: () => readScriptSafe(s.scriptFile),
 			failureLog,
 			specYaml,
+			target: AGENT_BROWSER_TARGET,
 			driftIssues
 		});
 		results.push({
@@ -10940,6 +11033,7 @@ async function analyzeDeterministicSummaries(summaries, cwd, reportDir, { pass,
 			analysis: fields.analysis,
 			analysisSkipped: fields.analysisSkipped,
 			...fields.analysisBase ? { analysisBase: fields.analysisBase } : {},
+			...fields.customPromptVersion ? { customPromptVersion: fields.customPromptVersion } : {},
 			driftIssues,
 			failureLogExcerpt: failureLog.length > 0 ? failureLog : null,
 			diffExcerpt: fields.diffExcerpt,
@@ -10958,11 +11052,13 @@ async function analyzeDeterministicSummaries(summaries, cwd, reportDir, { pass,
 */
 function buildReportEnvelope(args) {
 	const { git, customPromptVersion, triageUserPromptHash, opts } = args;
+	const runUrl = githubRunUrl();
 	return {
 		schemaVersion: 1,
 		kind: "run",
 		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-		runId: process.env["GITHUB_RUN_ID"] ?? null,
+		runId: githubRunId(),
+		...runUrl !== null ? { runUrl } : {},
 		git: {
 			head: git.head,
 			base: git.base?.ref ?? null,
@@ -14427,6 +14523,7 @@ z.object({
 	gitHead: z.string().nullable(),
 	promptVersion: z.string(),
 	ciRunId: z.string().nullable(),
+	runUrl: z.string().nullable().optional(),
 	reportCreatedAt: z.string(),
 	createdAt: z.string()
 });
@@ -14592,6 +14689,7 @@ function createPushRunHandler(config) {
 				gitHead: report.git.head,
 				promptVersion: report.promptVersion,
 				ciRunId: report.runId,
+				runUrl: report.runUrl ?? null,
 				reportCreatedAt: report.createdAt,
 				createdAt: (/* @__PURE__ */ new Date()).toISOString()
 			};
@@ -14619,6 +14717,8 @@ function createOpenRunHandler(config) {
 	return async (ctx) => {
 		const { project, branch, profile, kind } = parseRunScope(ctx);
 		const gitHead = ctx.url.searchParams.get("gitHead");
+		const ciRunId = ctx.url.searchParams.get("ciRunId");
+		const runUrl = ctx.url.searchParams.get("runUrl");
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		const run = {
 			id: randomUUID(),
@@ -14635,7 +14735,8 @@ function createOpenRunHandler(config) {
 			},
 			gitHead: gitHead || null,
 			promptVersion: "",
-			ciRunId: null,
+			ciRunId: ciRunId || null,
+			runUrl: runUrl || null,
 			reportCreatedAt: now,
 			createdAt: now
 		};
@@ -14654,6 +14755,7 @@ const PatchRunRequestSchema = z.object({
 		language: z.string().nullable().optional(),
 		promptVersion: z.string().optional(),
 		customPromptVersion: z.string().nullable().optional(),
+		runUrl: z.string().nullable().optional(),
 		triageUserPromptHash: z.string().optional()
 	}).partial().optional()
 });
@@ -14754,6 +14856,7 @@ function createPatchRunHandler(config) {
 				...reportMeta?.language !== void 0 ? { language: reportMeta.language } : {},
 				...reportMeta?.promptVersion !== void 0 ? { promptVersion: reportMeta.promptVersion } : {},
 				...reportMeta?.customPromptVersion !== void 0 ? { customPromptVersion: reportMeta.customPromptVersion } : {},
+				...reportMeta?.runUrl !== void 0 ? { runUrl: reportMeta.runUrl } : {},
 				...reportMeta?.triageUserPromptHash !== void 0 ? { triageUserPromptHash: reportMeta.triageUserPromptHash } : {}
 			};
 			const merged = mergeResults(current?.results ?? [], rows);
@@ -15684,6 +15787,9 @@ ${HTML_BODY}
 </body>
 </html>`;
 }
+function refreshButton(id) {
+	return `<button class="btn ghost sm" id="${id}"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 12a9 9 0 1 1-3-6.7L21 8"/><path d="M21 3v5h-5"/></svg> <span data-i18n="common.refresh">Refresh</span></button>`;
+}
 const HTML_BODY = `
 <div id="login" class="login" hidden>
   <div class="login-card">
@@ -15743,9 +15849,7 @@ const HTML_BODY = `
       <div class="page-bar">
         <h1 data-i18n="projects.title">Projects</h1>
         <div class="spacer"></div>
-        <button class="btn ghost sm" id="projects-refresh">
-          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 12a9 9 0 1 1-3-6.7L21 8"/><path d="M21 3v5h-5"/></svg> Refresh
-        </button>
+        ${refreshButton("projects-refresh")}
         <button class="btn primary sm" id="projects-new">
           <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 5v14M5 12h14"/></svg> <span data-i18n="projects.new">New project</span>
         </button>
@@ -15761,9 +15865,7 @@ const HTML_BODY = `
       <div class="page-bar">
         <h1 data-i18n="runs.title">Runs</h1>
         <div class="spacer"></div>
-        <button class="btn ghost sm" id="runs-refresh">
-          <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 12a9 9 0 1 1-3-6.7L21 8"/><path d="M21 3v5h-5"/></svg> Refresh
-        </button>
+        ${refreshButton("runs-refresh")}
       </div>
       <div class="content">
         <div class="card" id="runs-card">
@@ -15784,7 +15886,7 @@ const HTML_BODY = `
         <h1 data-i18n="perspectives.title">Perspectives</h1>
         <span class="updated" id="persp-updated"></span>
         <div class="spacer"></div>
-        <button class="btn ghost sm" id="persp-refresh" data-i18n="common.refresh">Refresh</button>
+        ${refreshButton("persp-refresh")}
       </div>
       <div class="content">
         <p id="persp-status" class="empty-note" hidden></p>
@@ -15854,7 +15956,7 @@ const HTML_BODY = `
       <div class="page-bar">
         <h1 data-i18n="learning.title">Learning</h1>
         <div class="spacer"></div>
-        <button class="btn ghost sm" id="jobs-refresh" data-i18n="common.refresh">Refresh</button>
+        ${refreshButton("jobs-refresh")}
       </div>
       <div class="content">
         <p id="jobs-status" class="empty-note" hidden></p>
@@ -15877,7 +15979,7 @@ const HTML_BODY = `
           <div class="proj-menu" id="sec-profile-menu" role="menu" hidden></div>
         </div>
         <div class="spacer"></div>
-        <button class="btn ghost sm" id="sec-load" data-i18n="common.refresh">Refresh</button>
+        ${refreshButton("sec-load")}
       </div>
       <div class="content">
         <div class="scope-note">
@@ -15902,7 +16004,7 @@ const HTML_BODY = `
       <div class="page-bar">
         <h1 data-i18n="prompts.title">Prompts</h1>
         <div class="spacer"></div>
-        <button class="btn ghost sm" id="pr-load" data-i18n="common.refresh">Refresh</button>
+        ${refreshButton("pr-load")}
       </div>
       <div class="content">
         <p id="prompts-status" class="empty-note" hidden></p>
@@ -16143,6 +16245,8 @@ const CSS = `
   .subline { margin-top: 3px; }
   .ci-badge { display: inline-flex; align-items: center; gap: 5px; font-size: 11px; font-family: var(--mono); color: var(--muted); background: var(--surface-3); border: 1px solid var(--border); border-radius: 5px; padding: 1px 6px; }
   .ci-badge.local { color: var(--muted-2); }
+  a.ci-badge { text-decoration: none; }
+  a.ci-badge:hover { color: var(--fg); border-color: var(--fg-dim); }
 
   .badge { display: inline-flex; align-items: center; gap: 5px; padding: 2px 8px 2px 7px; border-radius: var(--radius-sm); font-size: 12px; font-weight: 500; border: 1px solid transparent; }
   .badge .d { width: 6px; height: 6px; border-radius: 50%; }
@@ -16606,6 +16710,7 @@ const CLIENT_JS = `
       "prompt.runnAgent.hint": "Notes ccqa keeps for itself while generating runn runbooks, refined automatically. Read-only — ccqa regenerates it.",
       "prompt.triageUser.hint": "Rules you write for how failure causes are classified — e.g. which kinds of changes count as a spec change on this project. Applied on every failure analysis.",
       "prompt.customPrompt.hint": "Learned from your triage grades to make ccqa classify failure causes the way you do. Read-only — a learning job creates it.",
+      "prompt.customPrompt.fallback": "Un-scoped (fallback)",
       "prompt.readonly": "read-only",
       "prompt.notSet": "Not set. Type guidance and Save to store it on the hub.",
       "prompt.notSetRo": "Not set yet — ccqa fills this in as it runs.",
@@ -16623,7 +16728,7 @@ const CLIENT_JS = `
       "jobs.failed": "The learning job failed.", "jobs.newCustomPrompt": "New custom prompt:", "jobs.empty": "No learning jobs yet. Grade failing specs on a run, then Learn."
     },
     ja: {
-      "nav.projects": "プロジェクト", "nav.runs": "実行", "nav.perspectives": "Perspectives", "nav.secrets": "シークレット",
+      "nav.projects": "プロジェクト", "nav.runs": "実行", "nav.perspectives": "テスト観点", "nav.secrets": "シークレット",
       "nav.prompts": "プロンプト", "nav.learning": "学習",
       "app.project": "プロジェクト", "app.profile": "プロファイル", "app.disconnect": "切断", "app.noProject": "プロジェクト未選択",
       "app.newProfile": "新規プロファイル",
@@ -16666,15 +16771,15 @@ const CLIENT_JS = `
       "learn.cta.desc": "採点した内容をもとに、ccqaが次回から同じように失敗の原因を分類できるよう学習します。",
       "learn.cta.run": "学習",
       "secrets.title": "シークレット", "prompts.title": "プロンプト", "learning.title": "学習",
-      "perspectives.title": "Perspectives",
+      "perspectives.title": "テスト観点",
       "perspectives.search": "ケースを検索…",
       "perspectives.filter.all": "すべて", "perspectives.filter.deterministic": "決定的",
       "perspectives.filter.live": "ライブ", "perspectives.filter.norec": "未recordのみ",
       "perspectives.col.case": "ケース", "perspectives.col.mode": "モード", "perspectives.col.status": "状態",
       "perspectives.noHit": "該当するケースがありません。",
       "perspectives.updated": "最終更新:",
-      "perspectives.empty": "まだperspectivesがありません。ccqa perspectives を実行するか、recordすると自動作成されます。",
-      "perspectives.loadFailed": "perspectivesの読み込みに失敗しました",
+      "perspectives.empty": "まだテスト観点がありません。ccqa perspectives を実行するか、recordすると自動作成されます。",
+      "perspectives.loadFailed": "テスト観点の読み込みに失敗しました",
       "perspectives.mode.deterministic": "決定的", "perspectives.mode.live": "ライブ",
       "perspectives.status.runnable": "実行可能", "perspectives.status.notRecorded": "未record",
       "perspectives.metric.features": "機能", "perspectives.metric.cases": "テストケース",
@@ -16703,6 +16808,7 @@ const CLIENT_JS = `
       "prompt.runnAgent.hint": "runnランブック生成中にccqaが自分用に書き留め、自動で洗練していくメモです。読み取り専用 — ccqaが再生成します。",
       "prompt.triageUser.hint": "失敗原因を分類するときのルールを自分で書きます（例: どの変更をこのプロジェクトで仕様変更として扱うか）。失敗分析のたびに適用されます。",
       "prompt.customPrompt.hint": "あなたの採点から学習し、ccqaがあなたと同じように失敗の原因を分類できるようにします。読み取り専用 — 学習ジョブが生成します。",
+      "prompt.customPrompt.fallback": "共通（フォールバック）",
       "prompt.readonly": "読み取り専用",
       "prompt.notSet": "未設定。指示を入力して保存するとハブに保存されます。",
       "prompt.notSetRo": "未設定 — ccqaが実行しながら自動で書き込みます。",
@@ -16910,9 +17016,21 @@ const CLIENT_JS = `
   }
 
   function ciBadge(run) {
-    return run.ciRunId
-      ? el("span", "ci-badge", "Actions #" + run.ciRunId)
-      : el("span", "ci-badge local", "local run");
+    if (!run.ciRunId) return el("span", "ci-badge local", "local run");
+    var text = "Actions #" + run.ciRunId;
+    // A link to the GitHub Actions run when the URL was recorded; same chip
+    // style otherwise (plain text).
+    if (run.runUrl) {
+      var a = el("a", "ci-badge", text);
+      a.href = run.runUrl;
+      a.target = "_blank";
+      a.rel = "noopener";
+      // The runs-list row is itself clickable (opens the run); opening the CI
+      // link must not also navigate the row.
+      a.addEventListener("click", function (e) { e.stopPropagation(); });
+      return a;
+    }
+    return el("span", "ci-badge", text);
   }
 
   function labelChip(label) {
@@ -18636,13 +18754,29 @@ const CLIENT_JS = `
   }
 
   // The custom prompt body is JSON (schemaVersion/basePromptVersion/customPromptVersion/
-  // generatedAt/guidance); the textarea only ever shows the learned guidance
-  // text, never the raw JSON. A parse failure falls back to the raw text so a
-  // malformed custom prompt still shows something instead of leaving the UI stuck.
+  // generatedAt/guidance, plus an optional per-target byTarget map); the textarea
+  // only ever shows the learned guidance text, never the raw JSON. When byTarget
+  // is present, the slot shows the un-scoped fallback (when it has guidance) plus
+  // each per-target overlay under a short header, so it reflects the whole learned
+  // set. A parse failure falls back to the raw text so a malformed custom prompt
+  // still shows something instead of leaving the UI stuck.
   function customPromptDisplayText(text) {
     if (text == null) return "";
+    var NL = "\\n";
     try {
       var parsed = JSON.parse(text);
+      var byTarget = parsed && parsed.byTarget;
+      if (byTarget && typeof byTarget === "object") {
+        var parts = [];
+        var top = typeof parsed.guidance === "string" ? parsed.guidance.trim() : "";
+        if (top) parts.push("[" + t("prompt.customPrompt.fallback") + "]" + NL + top);
+        Object.keys(byTarget).sort().forEach(function (tg) {
+          var entry = byTarget[tg];
+          var g = entry && typeof entry.guidance === "string" ? entry.guidance.trim() : "";
+          if (g) parts.push("[" + tg + "]" + NL + g);
+        });
+        if (parts.length) return parts.join(NL + NL);
+      }
       return typeof parsed.guidance === "string" ? parsed.guidance : text;
     } catch (e) {
       // A malformed custom prompt shouldn't blank the panel; show the raw body but
@@ -19268,6 +19402,22 @@ function evidenceSignalFor(headline, note) {
 }
 function createLearningWorker(deps) {
 	const { storage, invoke = invokeClaudeStreaming, authCheck = driftAuthAvailable } = deps;
+	/**
+	* One Claude call turning a batch of graded cases into a calibration note.
+	* Returns null when nothing usable came back so the caller can drop that
+	* group's overlay without failing the whole job.
+	*/
+	const learnGuidance = async (cases) => {
+		const { result, isError } = await invoke({
+			prompt: buildLearningUserPrompt(cases.slice(0, LEARNING_MAX_CASES)),
+			systemPrompt: LEARNING_SYSTEM_PROMPT,
+			allowedTools: [],
+			disableBuiltinTools: true,
+			maxTurns: 1
+		}, () => {});
+		const guidance = result?.trim();
+		return isError || !guidance ? null : guidance;
+	};
 	return async function runLearningJob(job) {
 		const auth = authCheck();
 		if (!auth.ok) throw new Error(`triage learning needs Claude auth on the hub: ${auth.reason}`);
@@ -19285,7 +19435,8 @@ function createLearningWorker(deps) {
 					predicted: r.predicted.label,
 					actualCause: actual,
 					evidenceSignal: evidenceSignalFor(r.predicted.headline, r.note),
-					matches: r.predicted.label === actual
+					matches: r.predicted.label === actual,
+					...r.target ? { target: r.target } : {}
 				});
 			}
 		}
@@ -19294,32 +19445,47 @@ function createLearningWorker(deps) {
 			runLimit,
 			casesConsidered: cases.length
 		} });
-		const { result, isError } = await invoke({
-			prompt: buildLearningUserPrompt(cases.slice(0, LEARNING_MAX_CASES)),
-			systemPrompt: LEARNING_SYSTEM_PROMPT,
-			allowedTools: [],
-			disableBuiltinTools: true,
-			maxTurns: 1
-		}, () => {});
-		const guidance = result?.trim();
-		if (isError || !guidance) throw new Error("triage learning: Claude returned no usable calibration note");
-		const prevCustomPrompt = await loadStoredCustomPrompt(storage, job.project);
+		const fallbackCases = [];
+		const targetCases = /* @__PURE__ */ new Map();
+		for (const c of cases) {
+			if (!c.target) {
+				fallbackCases.push(c);
+				continue;
+			}
+			const list = targetCases.get(c.target) ?? [];
+			list.push(c);
+			targetCases.set(c.target, list);
+		}
 		const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+		const sortedTargets = [...targetCases.keys()].sort((a, b) => a.localeCompare(b));
+		const [fallbackGuidance, ...targetGuidances] = await Promise.all([fallbackCases.length > 0 ? learnGuidance(fallbackCases) : Promise.resolve(null), ...sortedTargets.map((target) => learnGuidance(targetCases.get(target)))]);
+		const byTarget = {};
+		sortedTargets.forEach((target, i) => {
+			const guidance = targetGuidances[i];
+			if (guidance) byTarget[target] = {
+				customPromptVersion: `${generatedAt}-${target}-c${targetCases.get(target).length}`,
+				generatedAt,
+				guidance
+			};
+		});
+		if (!fallbackGuidance && Object.keys(byTarget).length === 0) throw new Error("triage learning: Claude returned no usable calibration note");
+		const prevCustomPrompt = await loadStoredCustomPrompt(storage, job.project);
 		const customPrompt = {
 			schemaVersion: 1,
 			basePromptVersion: "7",
-			customPromptVersion: `${generatedAt}-c${cases.length}`,
+			customPromptVersion: `${generatedAt}-c${fallbackCases.length}`,
 			generatedAt,
-			guidance
+			guidance: fallbackGuidance ?? "",
+			...Object.keys(byTarget).length > 0 ? { byTarget } : {}
 		};
 		AnalysisCustomPromptSchema.parse(customPrompt);
 		const beforePrompt = buildFailureAnalysisPrompt({
 			...PROMPT_PREVIEW_FIXTURE,
-			customPrompt: prevCustomPrompt
+			customPrompt: representativeOverlay(prevCustomPrompt)
 		});
 		const afterPrompt = buildFailureAnalysisPrompt({
 			...PROMPT_PREVIEW_FIXTURE,
-			customPrompt
+			customPrompt: representativeOverlay(customPrompt)
 		});
 		await storage.prompts.put(job.project, "analysis-custom-prompt", new TextEncoder().encode(JSON.stringify(customPrompt)), {
 			customPromptVersion: customPrompt.customPromptVersion,
@@ -19336,6 +19502,19 @@ function createLearningWorker(deps) {
 		});
 	};
 }
+/**
+* A single representative overlay for the before/after prompt preview: the
+* un-scoped fallback when it has guidance, else the first target overlay by
+* name, else null. Only the preview uses this — the stored blob keeps every
+* overlay; run-time injection picks per target (resolveCustomPromptForTarget).
+*/
+function representativeOverlay(cp) {
+	if (!cp) return null;
+	if (cp.guidance.trim()) return overlayAsPrompt(cp, cp);
+	const firstTarget = cp.byTarget ? Object.keys(cp.byTarget).sort()[0] : void 0;
+	const overlay = firstTarget ? cp.byTarget?.[firstTarget] : void 0;
+	return overlay ? overlayAsPrompt(cp, overlay) : null;
+}
 /** Read the currently-stored custom prompt, or null when there is none / it's unreadable. */
 async function loadStoredCustomPrompt(storage, project) {
 	const entry = await storage.prompts.get(project, "analysis-custom-prompt");

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

@@ -52,6 +52,7 @@ declare const RunSchema: z.ZodObject<{
   gitHead: z.ZodNullable<z.ZodString>;
   promptVersion: z.ZodString;
   ciRunId: z.ZodNullable<z.ZodString>;
+  runUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   reportCreatedAt: z.ZodString;
   createdAt: z.ZodString;
 }, z.core.$strip>;
@@ -217,6 +218,7 @@ declare const ReportSpecResultSchema: z.ZodObject<{
     reasoning: z.ZodString;
   }, z.core.$strip>>;
   analysisSkipped: z.ZodNullable<z.ZodString>;
+  customPromptVersion: z.ZodOptional<z.ZodString>;
   analysisBase: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     ref: z.ZodString;
     sha: z.ZodString;
@@ -319,6 +321,7 @@ declare const RunReportDataSchema: z.ZodObject<{
   }>>;
   createdAt: z.ZodString;
   runId: z.ZodNullable<z.ZodString>;
+  runUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   git: z.ZodObject<{
     head: z.ZodNullable<z.ZodString>;
     base: z.ZodNullable<z.ZodString>;
@@ -384,6 +387,7 @@ declare const RunReportDataSchema: z.ZodObject<{
       reasoning: z.ZodString;
     }, z.core.$strip>>;
     analysisSkipped: z.ZodNullable<z.ZodString>;
+    customPromptVersion: z.ZodOptional<z.ZodString>;
     analysisBase: z.ZodOptional<z.ZodNullable<z.ZodObject<{
       ref: z.ZodString;
       sha: z.ZodString;
@@ -584,6 +588,10 @@ interface HubClient {
     profile?: string;
     kind?: "run" | "drift";
     gitHead?: string;
+    /** CI run id (GITHUB_RUN_ID) and its run URL, stamped at open time so an
+     *  interrupted incremental run still links back to its CI run. */
+    ciRunId?: string;
+    runUrl?: string;
   }): Promise<Run>;
   /** Add finished spec rows (+ evidence) to a running run; `done` closes it. */
   patchRun(id: string, body: PatchRunRequest): Promise<Run>;

package/dist/hub-client/index.mjs

@@ -110,6 +110,8 @@ function createHubClient(opts) {
 			if (meta.profile) params.set("profile", meta.profile);
 			if (meta.kind) params.set("kind", meta.kind);
 			if (meta.gitHead) params.set("gitHead", meta.gitHead);
+			if (meta.ciRunId) params.set("ciRunId", meta.ciRunId);
+			if (meta.runUrl) params.set("runUrl", meta.runUrl);
 			return json(`/api/v1/runs/open?${params}`, { method: "POST" });
 		},
 		patchRun(id, body) {

package/dist/package.json

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