ccqa 1.14.0 → 1.16.0

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

@@ -173,6 +173,51 @@ declare const DeployEntrySchema: z.ZodObject<{
   gapBefore: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 type DeployEntry = z.infer<typeof DeployEntrySchema>;
+/** Body of `POST /projects/:project/locks?profile=`. */
+declare const AcquireLocksRequestSchema: z.ZodObject<{
+  specs: z.ZodArray<z.ZodString>;
+  kind: z.ZodEnum<{
+    run: "run";
+    audit: "audit";
+  }>;
+  holder: z.ZodString;
+  ttlSeconds: z.ZodNumber;
+}, z.core.$strip>;
+type AcquireLocksRequest = z.infer<typeof AcquireLocksRequestSchema>;
+/**
+ * Which specs the caller may work on. `denied` is not an error: another job got
+ * there first, and skipping those is the whole point.
+ */
+declare const AcquireLocksResponseSchema: z.ZodObject<{
+  granted: z.ZodArray<z.ZodString>;
+  denied: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+type AcquireLocksResponse = z.infer<typeof AcquireLocksResponseSchema>;
+/** Body of `GET /projects/:project/audit-needed?profile=`: one answer per spec. */
+declare const AuditNeedReportSchema: z.ZodObject<{
+  project: z.ZodString;
+  profile: z.ZodString;
+  specs: z.ZodRecord<z.ZodString, z.ZodObject<{
+    because: z.ZodEnum<{
+      cannotTell: "cannotTell";
+      neverAudited: "neverAudited";
+      deployReached: "deployReached";
+      held: "held";
+      current: "current";
+    }>;
+    reason: z.ZodOptional<z.ZodEnum<{
+      notEvaluated: "notEvaluated";
+      noSelectionInRange: "noSelectionInRange";
+      selectionUnknown: "selectionUnknown";
+      noDeployLog: "noDeployLog";
+      unknownDeployedSha: "unknownDeployedSha";
+      ambiguousDeployedSha: "ambiguousDeployedSha";
+      deployedShaNotInLog: "deployedShaNotInLog";
+      gapInRange: "gapInRange";
+    }>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type AuditNeedReport = z.infer<typeof AuditNeedReportSchema>;
 /** Body of `GET /projects/:project/rerun?profile=`: one verdict per spec in the perspectives document. */
 declare const RerunReportSchema: z.ZodObject<{
   project: z.ZodString;
@@ -183,14 +228,31 @@ declare const RerunReportSchema: z.ZodObject<{
     at: z.ZodString;
   }, z.core.$strip>>;
   specs: z.ZodRecord<z.ZodString, z.ZodObject<{
-    state: z.ZodEnum<{
-      unknown: "unknown";
-      needed: "needed";
-      notNeeded: "notNeeded";
+    verdict: z.ZodEnum<{
+      inProgress: "inProgress";
+      needsRepair: "needsRepair";
+      rerunNeeded: "rerunNeeded";
+      verified: "verified";
+      unanswerable: "unanswerable";
+    }>;
+    audit: z.ZodEnum<{
+      due: "due";
+      clean: "clean";
+      drifted: "drifted";
+      undecided: "undecided";
+      cannotTell: "cannotTell";
+    }>;
+    execution: z.ZodEnum<{
+      passed: "passed";
+      failed: "failed";
       neverRun: "neverRun";
-      notEvaluated: "notEvaluated";
     }>;
+    driftLabel: z.ZodOptional<z.ZodEnum<{
+      TEST_DRIFT: "TEST_DRIFT";
+      SPEC_CHANGE: "SPEC_CHANGE";
+    }>>;
     reason: z.ZodOptional<z.ZodEnum<{
+      notEvaluated: "notEvaluated";
       noSelectionInRange: "noSelectionInRange";
       selectionUnknown: "selectionUnknown";
       noDeployLog: "noDeployLog";
@@ -199,6 +261,14 @@ declare const RerunReportSchema: z.ZodObject<{
       deployedShaNotInLog: "deployedShaNotInLog";
       gapInRange: "gapInRange";
     }>>;
+    heldBy: z.ZodNullable<z.ZodObject<{
+      kind: z.ZodEnum<{
+        run: "run";
+        audit: "audit";
+      }>;
+      holder: z.ZodString;
+      expiresAt: z.ZodString;
+    }, z.core.$strip>>;
     lastRun: z.ZodNullable<z.ZodObject<{
       gitHead: z.ZodString;
       runId: z.ZodString;
@@ -820,7 +890,7 @@ interface HubClient {
   }): Promise<Record<string, LastGreenEntry>>;
   /**
    * Per spec of one project/profile: is its last result still trustworthy?
-   * Answers `ccqa run --only-hub-stale`. 404 when the project has no
+   * Answers `ccqa run --only-hub-rerun-needed`. 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".
@@ -828,6 +898,26 @@ interface HubClient {
   getRerun(project: string, q: {
     profile: string;
   }): Promise<RerunReport>;
+  /**
+   * Per spec of one project/profile: has a deploy landed on the code it covers
+   * since the audit last read it? Answers `ccqa audit
+   * --only-hub-audit-needed`. 404 on a project with no perspectives document,
+   * for the same reason `getRerun` does.
+   */
+  getAuditNeed(project: string, q: {
+    profile: string;
+  }): Promise<AuditNeedReport>;
+  /**
+   * Take the specs that are free, so a second job does not start on one this
+   * run is already working. `denied` is part of the answer, not an error.
+   */
+  acquireLocks(project: string, q: {
+    profile: string;
+  }, body: AcquireLocksRequest): Promise<AcquireLocksResponse>;
+  /** Drop everything `runId` holds. Safe to call when it holds nothing. */
+  releaseLocks(project: string, q: {
+    profile: string;
+  }, holder: string): Promise<void>;
   /**
    * Every spec's last `ccqa audit --report-to-hub` result, keyed by "feature/spec". No
    * profile — drift asks whether a spec still describes the code, not

package/dist/hub-client/index.mjs

@@ -168,6 +168,23 @@ function createHubClient(opts) {
 		getRerun(project, q) {
 			return json(`/api/v1/projects/${encodeURIComponent(project)}/rerun?${queryString({ profile: q.profile })}`);
 		},
+		acquireLocks(project, q, body) {
+			return json(`${locksPath(project)}?${queryString({ profile: q.profile })}`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify(body)
+			});
+		},
+		async releaseLocks(project, q, holder) {
+			await request(`${locksPath(project)}?${queryString({ profile: q.profile })}`, {
+				method: "DELETE",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({ holder })
+			});
+		},
+		getAuditNeed(project, q) {
+			return json(`/api/v1/projects/${encodeURIComponent(project)}/audit-needed?${queryString({ profile: q.profile })}`);
+		},
 		getDriftLedger(project) {
 			return json(`/api/v1/projects/${encodeURIComponent(project)}/drift`);
 		},
@@ -269,6 +286,9 @@ function promptsPath(project) {
 function deploysPath(project) {
 	return `/api/v1/projects/${encodeURIComponent(project)}/deploys`;
 }
+function locksPath(project) {
+	return `/api/v1/projects/${encodeURIComponent(project)}/locks`;
+}
 /** 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.14.0",
+  "version": "1.16.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.14.0",
+  "version": "1.16.0",
   "type": "module",
   "description": "Browser test recorder powered by Claude Code and agent-browser",
   "repository": {