ccqa 1.8.3 → 1.10.0

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

@@ -39,11 +39,19 @@ declare const RunSchema: z.ZodObject<{
     drift: "drift";
   }>>;
   drift: z.ZodDefault<z.ZodNullable<z.ZodObject<{
-    issues: z.ZodNumber;
-    errors: z.ZodNumber;
-    warnings: z.ZodNumber;
-    specsWithIssues: z.ZodNumber;
+    specs: z.ZodNumber;
+    testDrift: z.ZodNumber;
+    specChange: z.ZodNumber;
+    unknown: z.ZodNumber;
   }, z.core.$strip>>>;
+  gradedDrift: z.ZodOptional<z.ZodObject<{
+    specs: z.ZodNumber;
+    testDrift: z.ZodNumber;
+    specChange: z.ZodNumber;
+    unknown: z.ZodNumber;
+    noDrift: z.ZodNumber;
+    graded: z.ZodNumber;
+  }, z.core.$strip>>;
   specs: z.ZodObject<{
     total: z.ZodNumber;
     passed: z.ZodNumber;
@@ -55,6 +63,12 @@ declare const RunSchema: z.ZodObject<{
   runUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   reportCreatedAt: z.ZodString;
   createdAt: z.ZodString;
+  deployedSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  deployedShaSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+    "hub-deploy-log": "hub-deploy-log";
+    client: "client";
+  }>>>;
+  deployedShaAmbiguous: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type Run = z.infer<typeof RunSchema>;
 /**
@@ -82,6 +96,7 @@ declare const TriageCaseSchema: z.ZodObject<{
       TEST_DRIFT: "TEST_DRIFT";
       SPEC_CHANGE: "SPEC_CHANGE";
       PRODUCT_BUG: "PRODUCT_BUG";
+      NO_DRIFT: "NO_DRIFT";
     }>;
     note: z.ZodOptional<z.ZodString>;
     recordedAt: z.ZodString;
@@ -111,6 +126,7 @@ declare const RunTriageSchema: z.ZodObject<{
         TEST_DRIFT: "TEST_DRIFT";
         SPEC_CHANGE: "SPEC_CHANGE";
         PRODUCT_BUG: "PRODUCT_BUG";
+        NO_DRIFT: "NO_DRIFT";
       }>;
       note: z.ZodOptional<z.ZodString>;
       recordedAt: z.ZodString;
@@ -125,6 +141,7 @@ declare const PutActualCauseRequestSchema: z.ZodObject<{
     TEST_DRIFT: "TEST_DRIFT";
     SPEC_CHANGE: "SPEC_CHANGE";
     PRODUCT_BUG: "PRODUCT_BUG";
+    NO_DRIFT: "NO_DRIFT";
   }>;
   note: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -143,6 +160,133 @@ declare const LastGreenEntrySchema: z.ZodObject<{
   at: z.ZodString;
 }, z.core.$strip>;
 type LastGreenEntry = z.infer<typeof LastGreenEntrySchema>;
+/** One deploy, as the consumer's deploy job reported it (ADR-0010). */
+declare const DeployEntrySchema: z.ZodObject<{
+  index: z.ZodNumber;
+  sha: z.ZodString;
+  previousSha: z.ZodNullable<z.ZodString>;
+  at: z.ZodString;
+  ref: z.ZodOptional<z.ZodString>;
+  runUrl: z.ZodOptional<z.ZodString>;
+  changedPaths: z.ZodNullable<z.ZodArray<z.ZodString>>;
+  hasSelection: z.ZodDefault<z.ZodBoolean>;
+  gapBefore: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type DeployEntry = z.infer<typeof DeployEntrySchema>;
+/** Body of `GET /projects/:project/rerun?profile=`: one verdict per spec in the perspectives document. */
+declare const RerunReportSchema: z.ZodObject<{
+  project: z.ZodString;
+  profile: z.ZodString;
+  deployHead: z.ZodNullable<z.ZodObject<{
+    index: z.ZodNumber;
+    sha: z.ZodString;
+    at: z.ZodString;
+  }, z.core.$strip>>;
+  specs: z.ZodRecord<z.ZodString, z.ZodObject<{
+    state: z.ZodEnum<{
+      unknown: "unknown";
+      needed: "needed";
+      notNeeded: "notNeeded";
+      neverRun: "neverRun";
+      notEvaluated: "notEvaluated";
+    }>;
+    reason: z.ZodOptional<z.ZodEnum<{
+      noSelectionInRange: "noSelectionInRange";
+      selectionUnknown: "selectionUnknown";
+      noDeployLog: "noDeployLog";
+      unknownDeployedSha: "unknownDeployedSha";
+      ambiguousDeployedSha: "ambiguousDeployedSha";
+      deployedShaNotInLog: "deployedShaNotInLog";
+      gapInRange: "gapInRange";
+    }>>;
+    lastRun: z.ZodNullable<z.ZodObject<{
+      gitHead: z.ZodString;
+      runId: z.ZodString;
+      at: z.ZodString;
+      deployedSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      deployedShaAmbiguous: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    lastGreen: z.ZodNullable<z.ZodObject<{
+      gitHead: z.ZodString;
+      runId: z.ZodString;
+      at: z.ZodString;
+      deployedSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      deployedShaAmbiguous: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    lastRed: z.ZodNullable<z.ZodObject<{
+      gitHead: z.ZodString;
+      runId: z.ZodString;
+      at: z.ZodString;
+      deployedSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      deployedShaAmbiguous: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    touchedBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    touchedByDeploy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      index: z.ZodNumber;
+      sha: z.ZodString;
+      at: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type RerunReport = z.infer<typeof RerunReportSchema>;
+/** Body of `POST /projects/:project/deploys?profile=` — what the deploy job shipped. */
+declare const RecordDeployRequestSchema: z.ZodObject<{
+  sha: z.ZodString;
+  previousSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  changedPaths: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+  selection: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    verdict: z.ZodEnum<{
+      unknown: "unknown";
+      needed: "needed";
+      notNeeded: "notNeeded";
+    }>;
+    reason: z.ZodString;
+    touchedBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>>;
+  ref: z.ZodOptional<z.ZodString>;
+  runUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type RecordDeployRequest = z.infer<typeof RecordDeployRequestSchema>;
+/** Body of `GET /projects/:project/deploys?profile=` — newest last, as stored. */
+declare const DeployLogResponseSchema: z.ZodObject<{
+  entries: z.ZodArray<z.ZodObject<{
+    index: z.ZodNumber;
+    sha: z.ZodString;
+    previousSha: z.ZodNullable<z.ZodString>;
+    at: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    runUrl: z.ZodOptional<z.ZodString>;
+    changedPaths: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    hasSelection: z.ZodDefault<z.ZodBoolean>;
+    gapBefore: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
+  nextIndex: z.ZodNumber;
+}, z.core.$strip>;
+type DeployLogResponse = z.infer<typeof DeployLogResponseSchema>;
+/**
+ * Body of `GET /projects/:project/drift`. No `?profile=` — see `SpecDriftEntrySchema`.
+ */
+declare const DriftLedgerResponseSchema: z.ZodObject<{
+  project: z.ZodString;
+  specs: z.ZodRecord<z.ZodString, z.ZodObject<{
+    label: z.ZodNullable<z.ZodEnum<{
+      TEST_DRIFT: "TEST_DRIFT";
+      SPEC_CHANGE: "SPEC_CHANGE";
+      UNKNOWN: "UNKNOWN";
+    }>>;
+    surface: z.ZodOptional<z.ZodEnum<{
+      spec: "spec";
+      generated: "generated";
+    }>>;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    headline: z.ZodOptional<z.ZodString>;
+    gitHead: z.ZodString;
+    runId: z.ZodString;
+    at: z.ZodString;
+    graded: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type DriftLedgerResponse = z.infer<typeof DriftLedgerResponseSchema>;
 //#endregion
 //#region src/prompts/prompt-names.d.ts
 /**
@@ -173,6 +317,10 @@ declare const ReportSpecResultSchema: z.ZodObject<{
   spec: z.ZodString;
   title: z.ZodNullable<z.ZodString>;
   target: z.ZodOptional<z.ZodString>;
+  mode: z.ZodOptional<z.ZodEnum<{
+    live: "live";
+    deterministic: "deterministic";
+  }>>;
   status: z.ZodEnum<{
     passed: "passed";
     failed: "failed";
@@ -216,6 +364,10 @@ declare const ReportSpecResultSchema: z.ZodObject<{
       detail: z.ZodString;
     }, z.core.$strip>>;
     reasoning: z.ZodString;
+    surface: z.ZodOptional<z.ZodEnum<{
+      spec: "spec";
+      generated: "generated";
+    }>>;
   }, z.core.$strip>>;
   analysisSkipped: z.ZodNullable<z.ZodString>;
   customPromptVersion: z.ZodOptional<z.ZodString>;
@@ -223,22 +375,30 @@ declare const ReportSpecResultSchema: z.ZodObject<{
     ref: z.ZodString;
     sha: z.ZodString;
   }, z.core.$strip>>>;
-  driftIssues: z.ZodNullable<z.ZodArray<z.ZodObject<{
-    severity: z.ZodEnum<{
-      OK: "OK";
-      WARN: "WARN";
-      ERROR: "ERROR";
-    }>;
-    category: z.ZodEnum<{
-      assertable: "assertable";
-      blocks: "blocks";
-      granularity: "granularity";
-      unimplemented: "unimplemented";
+  driftAudit: z.ZodNullable<z.ZodObject<{
+    label: z.ZodEnum<{
+      TEST_DRIFT: "TEST_DRIFT";
+      SPEC_CHANGE: "SPEC_CHANGE";
+      UNKNOWN: "UNKNOWN";
     }>;
-    stepId: z.ZodNullable<z.ZodString>;
-    message: z.ZodString;
-    detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  }, z.core.$strip>>>;
+    confidence: z.ZodNumber;
+    surface: z.ZodDefault<z.ZodEnum<{
+      spec: "spec";
+      generated: "generated";
+    }>>;
+    subDiagnosis: z.ZodDefault<z.ZodEnum<{
+      OVER_ASSERTION: "OVER_ASSERTION";
+      SELECTOR_DRIFT: "SELECTOR_DRIFT";
+      NONE: "NONE";
+    }>>;
+    headline: z.ZodString;
+    recommendation: z.ZodDefault<z.ZodString>;
+    evidence: z.ZodArray<z.ZodObject<{
+      file: z.ZodOptional<z.ZodString>;
+      detail: z.ZodString;
+    }, z.core.$strip>>;
+    reasoning: z.ZodDefault<z.ZodString>;
+  }, z.core.$strip>>;
   failureLogExcerpt: z.ZodNullable<z.ZodString>;
   diffExcerpt: z.ZodNullable<z.ZodString>;
   specYaml: z.ZodNullable<z.ZodString>;
@@ -337,11 +497,16 @@ declare const RunReportDataSchema: z.ZodObject<{
   promptVersion: z.ZodString;
   customPromptVersion: z.ZodDefault<z.ZodNullable<z.ZodString>>;
   triageUserPromptHash: z.ZodOptional<z.ZodString>;
+  deployedSha: z.ZodOptional<z.ZodString>;
   results: z.ZodArray<z.ZodObject<{
     feature: z.ZodString;
     spec: z.ZodString;
     title: z.ZodNullable<z.ZodString>;
     target: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<{
+      live: "live";
+      deterministic: "deterministic";
+    }>>;
     status: z.ZodEnum<{
       passed: "passed";
       failed: "failed";
@@ -385,6 +550,10 @@ declare const RunReportDataSchema: z.ZodObject<{
         detail: z.ZodString;
       }, z.core.$strip>>;
       reasoning: z.ZodString;
+      surface: z.ZodOptional<z.ZodEnum<{
+        spec: "spec";
+        generated: "generated";
+      }>>;
     }, z.core.$strip>>;
     analysisSkipped: z.ZodNullable<z.ZodString>;
     customPromptVersion: z.ZodOptional<z.ZodString>;
@@ -392,22 +561,30 @@ declare const RunReportDataSchema: z.ZodObject<{
       ref: z.ZodString;
       sha: z.ZodString;
     }, z.core.$strip>>>;
-    driftIssues: z.ZodNullable<z.ZodArray<z.ZodObject<{
-      severity: z.ZodEnum<{
-        OK: "OK";
-        WARN: "WARN";
-        ERROR: "ERROR";
-      }>;
-      category: z.ZodEnum<{
-        assertable: "assertable";
-        blocks: "blocks";
-        granularity: "granularity";
-        unimplemented: "unimplemented";
+    driftAudit: z.ZodNullable<z.ZodObject<{
+      label: z.ZodEnum<{
+        TEST_DRIFT: "TEST_DRIFT";
+        SPEC_CHANGE: "SPEC_CHANGE";
+        UNKNOWN: "UNKNOWN";
       }>;
-      stepId: z.ZodNullable<z.ZodString>;
-      message: z.ZodString;
-      detail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>>;
+      confidence: z.ZodNumber;
+      surface: z.ZodDefault<z.ZodEnum<{
+        spec: "spec";
+        generated: "generated";
+      }>>;
+      subDiagnosis: z.ZodDefault<z.ZodEnum<{
+        OVER_ASSERTION: "OVER_ASSERTION";
+        SELECTOR_DRIFT: "SELECTOR_DRIFT";
+        NONE: "NONE";
+      }>>;
+      headline: z.ZodString;
+      recommendation: z.ZodDefault<z.ZodString>;
+      evidence: z.ZodArray<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        detail: z.ZodString;
+      }, z.core.$strip>>;
+      reasoning: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
     failureLogExcerpt: z.ZodNullable<z.ZodString>;
     diffExcerpt: z.ZodNullable<z.ZodString>;
     specYaml: z.ZodNullable<z.ZodString>;
@@ -568,12 +745,20 @@ interface HubPromptMeta {
   meta: Record<string, unknown>;
 }
 interface HubClient {
-  /** Push a report directory (as a tar.gz) for an already-finished `ccqa run`. */
+  /**
+   * Push a report directory (as a tar.gz) for an already-finished `ccqa run`.
+   *
+   * `deployedSha` asserts the commit the environment was running *when the run
+   * started*. Without it the hub falls back to its deploy-log head, which by
+   * push time is the head after the run — a deploy that landed mid-run would
+   * then read as that run's baseline.
+   */
   pushRun(archive: Uint8Array, meta: {
     project: string;
     branch?: string;
     profile?: string;
     kind?: "run" | "drift";
+    deployedSha?: string;
   }): Promise<Run>;
   /**
    * Open a `running` run to push results into incrementally. Returns the new
@@ -581,6 +766,10 @@ interface HubClient {
    * would leave a second open run); callers degrade to local-only on failure.
    * `gitHead` stamps the run's commit at open time, so even a run that dies
    * before its final reconcile patch is attributable to a commit.
+   *
+   * `deployedSha` does the same for the environment's commit. The hub would
+   * otherwise read its own deploy-log head here, and the open happens after
+   * the deterministic phase, not before the first spec.
    */
   openRun(meta: {
     project: string;
@@ -588,6 +777,7 @@ interface HubClient {
     profile?: string;
     kind?: "run" | "drift";
     gitHead?: string;
+    deployedSha?: 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;
@@ -628,6 +818,29 @@ interface HubClient {
     branch: string;
     fallbackBranch?: string;
   }): Promise<Record<string, LastGreenEntry>>;
+  /**
+   * Per spec of one project/profile: is its last result still trustworthy?
+   * Answers `ccqa run --changed=last-run`. 404 when the project has no
+   * perspectives document — there is then no spec registered to compare
+   * against a deploy, which the caller must report rather than read as
+   * "nothing to run".
+   */
+  getRerun(project: string, q: {
+    profile: string;
+  }): Promise<RerunReport>;
+  /**
+   * Every spec's last `ccqa drift --push` audit, keyed by "feature/spec". No
+   * profile — drift asks whether a spec still describes the code, not
+   * whether an environment is stale.
+   */
+  getDriftLedger(project: string): Promise<DriftLedgerResponse>;
+  /** Tell the hub what a deploy shipped (`ccqa hub deploy record`). */
+  recordDeploy(project: string, profile: string, body: RecordDeployRequest): Promise<DeployEntry>;
+  /** The profile's retained deploy log, oldest first; `limit` keeps the newest N. */
+  getDeployLog(project: string, q: {
+    profile: string;
+    limit?: number;
+  }): Promise<DeployLogResponse>;
   putSession(project: string, profile: string, name: string, storageState: unknown): Promise<void>;
   getSession(project: string, profile: string, name: string): Promise<unknown>;
   listSessions(project: string, profile: string): Promise<{

package/dist/hub-client/index.mjs

@@ -98,6 +98,7 @@ function createHubClient(opts) {
 			if (meta.branch) params.set("branch", meta.branch);
 			if (meta.profile) params.set("profile", meta.profile);
 			if (meta.kind) params.set("kind", meta.kind);
+			if (meta.deployedSha) params.set("deployedSha", meta.deployedSha);
 			return json(`/api/v1/runs?${params}`, {
 				method: "POST",
 				headers: { "Content-Type": "application/gzip" },
@@ -110,6 +111,7 @@ 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.deployedSha) params.set("deployedSha", meta.deployedSha);
 			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" });
@@ -163,6 +165,25 @@ function createHubClient(opts) {
 			const { entries } = await json(`/api/v1/projects/${encodeURIComponent(project)}/last-green?${params}`);
 			return entries;
 		},
+		getRerun(project, q) {
+			return json(`/api/v1/projects/${encodeURIComponent(project)}/rerun?${queryString({ profile: q.profile })}`);
+		},
+		getDriftLedger(project) {
+			return json(`/api/v1/projects/${encodeURIComponent(project)}/drift`);
+		},
+		recordDeploy(project, profile, body) {
+			return json(`${deploysPath(project)}?${queryString({ profile })}`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify(body)
+			});
+		},
+		getDeployLog(project, q) {
+			return json(`${deploysPath(project)}?${queryString({
+				profile: q.profile,
+				limit: q.limit
+			})}`);
+		},
 		async listProjects() {
 			const { projects } = await json("/api/v1/projects");
 			return projects;
@@ -244,6 +265,10 @@ function scopePath(project, kind, profile) {
 function promptsPath(project) {
 	return `/api/v1/projects/${encodeURIComponent(project)}/prompts`;
 }
+/** The deploy log is per project, selected by a `?profile=` query param: `/api/v1/projects/<project>/deploys`. */
+function deploysPath(project) {
+	return `/api/v1/projects/${encodeURIComponent(project)}/deploys`;
+}
 /** Perspectives are one document per project: `/api/v1/projects/<project>/perspectives`. */
 function perspectivesPath(project) {
 	return `/api/v1/projects/${encodeURIComponent(project)}/perspectives`;

package/dist/package.json

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