ccqa 1.16.1 → 1.17.0

package/README.md

@@ -133,7 +133,7 @@ grade the calls on the hub, and it learns from your grades.
 
 ```
 deploy lands
-  ├─ ccqa hub deploy record --select   what shipped, which specs it reaches
+  ├─ ccqa hub deploy record            what shipped, which specs it reaches
   ├─ ccqa audit --only-hub-audit-needed --report-to-hub
   │                                    does each spec still describe it?
   └─ ccqa run --only-hub-rerun-needed --on-fail-explain \
@@ -141,9 +141,10 @@ deploy lands
 ```
 
 The audit costs cents; a live spec costs dollars. Filtering first leaves
-a run whose failures are worth reading. Record every deploy with
-`--select` — a range recorded without it answers `unanswerable` forever, and
-nothing fills the hole later.
+a run whose failures are worth reading. `deploy record` decides which specs
+the range reaches unless you pass `--no-select-specs`; a range recorded
+without that decision answers `unanswerable` forever, and nothing fills the
+hole later.
 
 | Job | Trigger | Question it answers |
 |---|---|---|

package/dist/bin/ccqa.mjs

@@ -8805,7 +8805,7 @@ const promptRm = new Command("rm").description("Delete a prompt from the hub.").
 	info(`deleted prompt "${name}" from the hub`);
 }));
 const promptCommand = new Command("prompt").description("Manage prompt assets (per-flow user/agent guidance, triage user guidance, analysis custom prompt) stored on the hub (fetched automatically by `ccqa run` at run time).").addCommand(promptPush).addCommand(promptLs).addCommand(promptRm);
-const deployRecord = new Command("record").description("Tell the hub what a deploy shipped, so it can answer which specs need a re-run (`ccqa run --only-hub-rerun-needed`). Run this from the deploy job, after the deploy succeeds. The changed paths are computed locally with a two-dot `git diff <previous> <sha>`; a job that has only curl and git can POST the same body directly (see docs/hub.md).").requiredOption("--profile <name>", "Environment this deploy landed in (e.g. 'stg'). Required: dev and stg sit at different commits, so the deploy log is per-profile.").requiredOption("--sha <sha>", "Commit that was deployed.").option("--previous <sha>", "Commit this deploy replaced. Defaults to the profile's current deploy-log head on the hub. With neither, there's nothing to diff against: changedPaths is unset and --select is skipped.").option("--ref <ref>", "Ref that was deployed (branch or tag). Recorded for display only.").option("--select", "Also decide which specs this deploy reaches (`ccqa select-specs`) and send the verdict with it. Without it the deploy is a hole in the range: specs behind it report 'unknown' rather than 'not needed'.").option("-m, --model <name>", "Model for --select. Claude alias ('sonnet'|'opus'|'haiku') or full ID. Overrides CCQA_MODEL.").option(...hubUrlOption).option(...hubTokenOption).option("--project <name>", "Project whose deploy log this entry joins. Defaults to the current directory's name.").option("--cwd <path>", "Directory the git diff and the default --project name are resolved against.").action(withHubErrors(async (opts) => {
+const deployRecord = new Command("record").description("Tell the hub what a deploy shipped, so it can answer which specs need a re-run (`ccqa run --only-hub-rerun-needed`). Run this from the deploy job, after the deploy succeeds. The changed paths are computed locally with a two-dot `git diff <previous> <sha>`; a job that has only curl and git can POST the same body directly (see docs/hub.md).").requiredOption("--profile <name>", "Environment this deploy landed in (e.g. 'stg'). Required: dev and stg sit at different commits, so the deploy log is per-profile.").requiredOption("--sha <sha>", "Commit that was deployed.").option("--previous <sha>", "Commit this deploy replaced. Defaults to the profile's current deploy-log head on the hub. With neither, there's nothing to diff against: changedPaths is unset and the spec selection is skipped.").option("--ref <ref>", "Ref that was deployed (branch or tag). Recorded for display only.").option("--no-select-specs", "Record the deploy without deciding which specs it reaches. The entry then becomes a hole in the range — every spec behind it answers 'unanswerable' rather than being cleared, and nothing can fill it in later, since the hub has no checkout to diff. Only pass this when no Claude credential is available; it costs one model call to leave the log answerable.").option("-m, --model <name>", "Model for the spec selection. Claude alias ('sonnet'|'opus'|'haiku') or full ID. Overrides CCQA_MODEL.").option(...hubUrlOption).option(...hubTokenOption).option("--project <name>", "Project whose deploy log this entry joins. Defaults to the current directory's name.").option("--cwd <path>", "Directory the git diff and the default --project name are resolved against.").action(withHubErrors(async (opts) => {
 	const cwd = resolveCwd(opts.cwd);
 	const project = resolveProject(opts);
 	const hub = connect(opts);
@@ -8813,7 +8813,7 @@ const deployRecord = new Command("record").description("Tell the hub what a depl
 	const runUrl = githubRunUrl();
 	const diff = previous === null ? null : await diffOrNull(previous, opts.sha, cwd);
 	const changedPaths = diff ? capDeployPaths(diff.map((f) => f.path)) : null;
-	const selection = opts.select && previous !== null && diff !== null ? await selectionForDeploy(diff, previous, opts.sha, cwd, opts.model) : void 0;
+	const selection = opts.selectSpecs !== false && previous !== null && diff !== null ? await selectionForDeploy(diff, previous, opts.sha, cwd, opts.model) : void 0;
 	const entry = await hub.recordDeploy(project, opts.profile, {
 		sha: opts.sha,
 		previousSha: previous,
@@ -8827,7 +8827,7 @@ const deployRecord = new Command("record").description("Tell the hub what a depl
 	meta("profile", opts.profile);
 	meta("previous", previous ? previous.slice(0, 12) : "(none)");
 	meta("changed paths", changedPaths === null ? "(not reported)" : String(changedPaths.length));
-	if (opts.select) meta("selection", describeSelection(selection, diff !== null));
+	if (opts.selectSpecs !== false) meta("selection", describeSelection(selection, diff !== null));
 	if (entry.gapBefore) warn("this deploy does not chain onto the log head, so a gap is recorded — specs whose baseline sits behind it report 'unanswerable' rather than 'verified'");
 	if (selection && !entry.hasSelection) {
 		error("the hub recorded this deploy but could not store its spec selection — the range answers 'unanswerable' from here on, and nothing fills it in later. Re-record this deploy.");
@@ -8870,7 +8870,7 @@ async function selectionForDeploy(changed, previous, sha, cwd, model) {
 /**
 * The two-dot diff for this deploy's range, or `null` when git can't produce
 * one (a shallow checkout that never fetched `previous`, a rolled-back sha
-* that isn't local). Shared by `changedPaths` and `--select`'s input, so a
+* that isn't local). Shared by `changedPaths` and the selection's input, so a
 * diff failure skips both rather than each attempting — and separately
 * failing — its own git call.
 */
@@ -8882,7 +8882,7 @@ async function diffOrNull(previous, sha, cwd) {
 		return null;
 	}
 }
-/** The `--select` summary line: verdict counts, or why there isn't one. */
+/** The selection summary line: verdict counts, or why there isn't one. */
 function describeSelection(selection, diffAvailable) {
 	if (!selection) return diffAvailable ? "(skipped — see warning above)" : "(skipped — no diff to select against)";
 	const values = Object.values(selection);

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

@@ -388,8 +388,8 @@ declare const ReportSpecResultSchema: z.ZodObject<{
   title: z.ZodNullable<z.ZodString>;
   target: z.ZodOptional<z.ZodString>;
   mode: z.ZodOptional<z.ZodEnum<{
-    deterministic: "deterministic";
     live: "live";
+    deterministic: "deterministic";
   }>>;
   status: z.ZodEnum<{
     passed: "passed";
@@ -574,8 +574,8 @@ declare const RunReportDataSchema: z.ZodObject<{
     title: z.ZodNullable<z.ZodString>;
     target: z.ZodOptional<z.ZodString>;
     mode: z.ZodOptional<z.ZodEnum<{
-      deterministic: "deterministic";
       live: "live";
+      deterministic: "deterministic";
     }>>;
     status: z.ZodEnum<{
       passed: "passed";

package/dist/package.json

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