ccqa 1.24.0 → 1.26.0

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

@@ -37,6 +37,7 @@ declare const RunSchema: z.ZodObject<{
   kind: z.ZodDefault<z.ZodEnum<{
     run: "run";
     drift: "drift";
+    record: "record";
   }>>;
   drift: z.ZodDefault<z.ZodNullable<z.ZodObject<{
     specs: z.ZodNumber;
@@ -382,6 +383,10 @@ declare const DriftLedgerResponseSchema: z.ZodObject<{
       spec: "spec";
       generated: "generated";
     }>>;
+    specChangeKind: z.ZodOptional<z.ZodEnum<{
+      FEATURE_REMOVED: "FEATURE_REMOVED";
+      BEHAVIOUR_CHANGED: "BEHAVIOUR_CHANGED";
+    }>>;
     confidence: z.ZodOptional<z.ZodNumber>;
     headline: z.ZodOptional<z.ZodString>;
     gitHead: z.ZodString;
@@ -391,6 +396,49 @@ declare const DriftLedgerResponseSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type DriftLedgerResponse = z.infer<typeof DriftLedgerResponseSchema>;
+/**
+ * What one batch of ccqa invocations spent on Claude, as the job that ran them
+ * reported it (see `SpendStore`). `label` is the consumer's name for the batch
+ * — its job name — and the only thing that says where the money went.
+ */
+declare const SpendEntrySchema: z.ZodObject<{
+  id: z.ZodString;
+  at: z.ZodString;
+  costUsd: z.ZodNumber;
+  label: z.ZodString;
+  ciRunId: z.ZodOptional<z.ZodString>;
+  runUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SpendEntry = z.infer<typeof SpendEntrySchema>;
+/** Body of `POST /projects/:project/spend` — one batch's total. `at` defaults to now. */
+declare const RecordSpendRequestSchema: z.ZodObject<{
+  costUsd: z.ZodNumber;
+  label: z.ZodString;
+  at: z.ZodOptional<z.ZodString>;
+  ciRunId: z.ZodOptional<z.ZodString>;
+  runUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type RecordSpendRequest = z.infer<typeof RecordSpendRequestSchema>;
+/**
+ * Body of `GET /projects/:project/spend?since=&until=`, newest first. `since`
+ * and `until` echo the window that was asked for (null for an open end), so a
+ * reader of `totalUsd` can tell what it totals.
+ */
+declare const SpendLogResponseSchema: z.ZodObject<{
+  project: z.ZodString;
+  since: z.ZodNullable<z.ZodString>;
+  until: z.ZodNullable<z.ZodString>;
+  totalUsd: z.ZodNumber;
+  entries: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    at: z.ZodString;
+    costUsd: z.ZodNumber;
+    label: z.ZodString;
+    ciRunId: z.ZodOptional<z.ZodString>;
+    runUrl: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type SpendLogResponse = z.infer<typeof SpendLogResponseSchema>;
 //#endregion
 //#region src/prompts/prompt-names.d.ts
 /**
@@ -479,6 +527,10 @@ declare const ReportSpecResultSchema: z.ZodObject<{
       spec: "spec";
       generated: "generated";
     }>>;
+    specChangeKind: z.ZodOptional<z.ZodEnum<{
+      FEATURE_REMOVED: "FEATURE_REMOVED";
+      BEHAVIOUR_CHANGED: "BEHAVIOUR_CHANGED";
+    }>>;
   }, z.core.$strip>>;
   analysisSkipped: z.ZodNullable<z.ZodString>;
   customPromptVersion: z.ZodOptional<z.ZodString>;
@@ -565,6 +617,7 @@ declare const RunReportDataSchema: z.ZodObject<{
   kind: z.ZodDefault<z.ZodEnum<{
     run: "run";
     drift: "drift";
+    record: "record";
   }>>;
   createdAt: z.ZodString;
   runId: z.ZodNullable<z.ZodString>;
@@ -652,6 +705,10 @@ declare const RunReportDataSchema: z.ZodObject<{
         spec: "spec";
         generated: "generated";
       }>>;
+      specChangeKind: z.ZodOptional<z.ZodEnum<{
+        FEATURE_REMOVED: "FEATURE_REMOVED";
+        BEHAVIOUR_CHANGED: "BEHAVIOUR_CHANGED";
+      }>>;
     }, z.core.$strip>>;
     analysisSkipped: z.ZodNullable<z.ZodString>;
     customPromptVersion: z.ZodOptional<z.ZodString>;
@@ -834,7 +891,7 @@ interface HubClient {
     project: string;
     branch?: string;
     profile?: string;
-    kind?: "run" | "drift";
+    kind?: Run["kind"];
     deployedSha?: string;
   }): Promise<Run>;
   /**
@@ -852,7 +909,7 @@ interface HubClient {
     project: string;
     branch?: string;
     profile?: string;
-    kind?: "run" | "drift";
+    kind?: Run["kind"];
     gitHead?: string;
     deployedSha?: string;
     /** CI run id (GITHUB_RUN_ID) and its run URL, stamped at open time so an
@@ -936,6 +993,16 @@ interface HubClient {
     profile: string;
     limit?: number;
   }): Promise<DeployLogResponse>;
+  /**
+   * Report what one batch of ccqa invocations cost (`ccqa hub cost push`).
+   * Read instead of a sum over runs, never alongside one (ADR-0017).
+   */
+  recordSpend(project: string, body: RecordSpendRequest): Promise<SpendEntry>;
+  /** The project's spend over `[since, until)`, newest first, with the window's total. */
+  getSpend(project: string, q?: {
+    since?: string;
+    until?: string;
+  }): Promise<SpendLogResponse>;
   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

@@ -201,6 +201,19 @@ function createHubClient(opts) {
 				limit: q.limit
 			})}`);
 		},
+		recordSpend(project, body) {
+			return json(spendPath(project), {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify(body)
+			});
+		},
+		getSpend(project, q = {}) {
+			return json(`${spendPath(project)}?${queryString({
+				since: q.since,
+				until: q.until
+			})}`);
+		},
 		async listProjects() {
 			const { projects } = await json("/api/v1/projects");
 			return projects;
@@ -286,6 +299,9 @@ function promptsPath(project) {
 function deploysPath(project) {
 	return `/api/v1/projects/${encodeURIComponent(project)}/deploys`;
 }
+function spendPath(project) {
+	return `/api/v1/projects/${encodeURIComponent(project)}/spend`;
+}
 function locksPath(project) {
 	return `/api/v1/projects/${encodeURIComponent(project)}/locks`;
 }

package/dist/package.json

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