ccqa 1.8.3 → 1.9.0

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

@@ -55,6 +55,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>;
 /**
@@ -143,6 +149,100 @@ 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>>;
+  truncated: 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<{
+      noRelatedPaths: "noRelatedPaths";
+      noDeployLog: "noDeployLog";
+      unknownDeployedSha: "unknownDeployedSha";
+      ambiguousDeployedSha: "ambiguousDeployedSha";
+      deployedShaNotInLog: "deployedShaNotInLog";
+      gapInRange: "gapInRange";
+      truncatedInRange: "truncatedInRange";
+    }>>;
+    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>>>;
+  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>>;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+    gapBefore: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>>;
+  nextIndex: z.ZodNumber;
+}, z.core.$strip>;
+type DeployLogResponse = z.infer<typeof DeployLogResponseSchema>;
 //#endregion
 //#region src/prompts/prompt-names.d.ts
 /**
@@ -337,6 +437,7 @@ 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;
@@ -568,12 +669,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 +690,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 +701,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 +742,22 @@ 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 `relatedPaths` to match a deploy
+   * against, which the caller must report rather than read as "nothing to run".
+   */
+  getRerun(project: string, q: {
+    profile: string;
+  }): Promise<RerunReport>;
+  /** 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,22 @@ 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 })}`);
+		},
+		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 +262,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.9.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.9.0",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {