ccqa 1.18.0 → 1.20.0

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

@@ -85,6 +85,7 @@ declare const TriageCaseSchema: z.ZodObject<{
       TEST_DRIFT: "TEST_DRIFT";
       SPEC_CHANGE: "SPEC_CHANGE";
       PRODUCT_BUG: "PRODUCT_BUG";
+      ENVIRONMENT: "ENVIRONMENT";
       UNKNOWN: "UNKNOWN";
     }>;
     confidence: z.ZodNumber;
@@ -96,10 +97,12 @@ declare const TriageCaseSchema: z.ZodObject<{
       TEST_DRIFT: "TEST_DRIFT";
       SPEC_CHANGE: "SPEC_CHANGE";
       PRODUCT_BUG: "PRODUCT_BUG";
+      ENVIRONMENT: "ENVIRONMENT";
       NO_DRIFT: "NO_DRIFT";
     }>;
     note: z.ZodOptional<z.ZodString>;
     recordedAt: z.ZodString;
+    invalidForKind: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 type TriageCase = z.infer<typeof TriageCaseSchema>;
@@ -115,6 +118,7 @@ declare const RunTriageSchema: z.ZodObject<{
         TEST_DRIFT: "TEST_DRIFT";
         SPEC_CHANGE: "SPEC_CHANGE";
         PRODUCT_BUG: "PRODUCT_BUG";
+        ENVIRONMENT: "ENVIRONMENT";
         UNKNOWN: "UNKNOWN";
       }>;
       confidence: z.ZodNumber;
@@ -126,13 +130,16 @@ declare const RunTriageSchema: z.ZodObject<{
         TEST_DRIFT: "TEST_DRIFT";
         SPEC_CHANGE: "SPEC_CHANGE";
         PRODUCT_BUG: "PRODUCT_BUG";
+        ENVIRONMENT: "ENVIRONMENT";
         NO_DRIFT: "NO_DRIFT";
       }>;
       note: z.ZodOptional<z.ZodString>;
       recordedAt: z.ZodString;
+      invalidForKind: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
   }, z.core.$strip>>;
   recorded: z.ZodNumber;
+  recordedInvalidForKind: z.ZodNumber;
   total: z.ZodNumber;
 }, z.core.$strip>;
 type RunTriage = z.infer<typeof RunTriageSchema>;
@@ -141,11 +148,22 @@ declare const PutActualCauseRequestSchema: z.ZodObject<{
     TEST_DRIFT: "TEST_DRIFT";
     SPEC_CHANGE: "SPEC_CHANGE";
     PRODUCT_BUG: "PRODUCT_BUG";
+    ENVIRONMENT: "ENVIRONMENT";
     NO_DRIFT: "NO_DRIFT";
   }>;
   note: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type PutActualCauseRequest = z.infer<typeof PutActualCauseRequestSchema>;
+/** Response of `PUT /runs/:id/triage/actual-causes`. */
+declare const ImportActualCausesResponseSchema: z.ZodObject<{
+  imported: z.ZodNumber;
+  rejected: z.ZodArray<z.ZodObject<{
+    feature: z.ZodString;
+    spec: z.ZodString;
+    reason: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ImportActualCausesResponse = z.infer<typeof ImportActualCausesResponseSchema>;
 /**
  * One spec's "last time it passed" record in the last-green ledger. The hub
  * updates the ledger whenever a `kind: "run"` run reaches a terminal state:
@@ -199,14 +217,13 @@ declare const AuditNeedReportSchema: z.ZodObject<{
   profile: z.ZodString;
   specs: z.ZodRecord<z.ZodString, z.ZodObject<{
     because: z.ZodEnum<{
-      cannotTell: "cannotTell";
       neverAudited: "neverAudited";
       deployReached: "deployReached";
+      cannotTell: "cannotTell";
       held: "held";
       current: "current";
     }>;
     reason: z.ZodOptional<z.ZodEnum<{
-      notEvaluated: "notEvaluated";
       noSelectionInRange: "noSelectionInRange";
       selectionUnknown: "selectionUnknown";
       noDeployLog: "noDeployLog";
@@ -233,26 +250,33 @@ declare const RerunReportSchema: z.ZodObject<{
       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";
+      stale: "stale";
       neverRun: "neverRun";
     }>;
     driftLabel: z.ZodOptional<z.ZodEnum<{
       TEST_DRIFT: "TEST_DRIFT";
       SPEC_CHANGE: "SPEC_CHANGE";
     }>>;
-    reason: z.ZodOptional<z.ZodEnum<{
-      notEvaluated: "notEvaluated";
+    auditAssumedReached: z.ZodOptional<z.ZodEnum<{
+      noSelectionInRange: "noSelectionInRange";
+      selectionUnknown: "selectionUnknown";
+      noDeployLog: "noDeployLog";
+      unknownDeployedSha: "unknownDeployedSha";
+      ambiguousDeployedSha: "ambiguousDeployedSha";
+      deployedShaNotInLog: "deployedShaNotInLog";
+      gapInRange: "gapInRange";
+    }>>;
+    executionAssumedReached: z.ZodOptional<z.ZodEnum<{
       noSelectionInRange: "noSelectionInRange";
       selectionUnknown: "selectionUnknown";
       noDeployLog: "noDeployLog";
@@ -366,19 +390,25 @@ type DriftLedgerResponse = z.infer<typeof DriftLedgerResponseSchema>;
  * the names without a circular import.
  *
  * Two kinds share one namespace:
- *  - "guidance": the record/live prompt bundle — `.user.md` (human-maintained)
- *    and `.agent.md` (auto-rewritten by `ccqa run --learn-hub-live-prompt`) —
- *    plus `triage.user`, the human-maintained guidance injected into the
- *    failure-analysis (triage) prompt.
- *  - "custom-prompt": `analysis-custom-prompt` — Claude-written calibration guidance
- *    learned from graded triage cases, injected into the failure-analysis
- *    prompt at run time.
+ *  - "guidance": Markdown — every `.user.md` file, plus the record/live/
+ *    playwright/runn `.agent.md` notes (despite the "agent" name, these are
+ *    plain prose, not the learned JSON below).
+ *  - "custom-prompt": JSON Claude writes — only `triage.agent` and
+ *    `audit.agent`, calibration distilled from graded cases and injected at
+ *    run time.
+ *
+ * `triage.*` belongs to `ccqa run`'s failure classification and `audit.*` to
+ * `ccqa audit`. They are two prompts because they answer two questions in one
+ * shared vocabulary: the audit decides whether a spec still describes the
+ * code (from the source alone), and the run decides why it failed, using the
+ * execution evidence — the two commands run independently, neither gating the
+ * other (ADR-0016).
  *
  * Hub names are extensionless (`record.agent`), local files keep their real
  * extensions; `PROMPT_LOCAL_PATHS` is the single mapping every caller (push,
  * pull, learn, UI) goes through so the two never drift.
  */
-declare const PROMPT_NAMES: readonly ["record.user", "record.agent", "live.user", "live.agent", "playwright.user", "playwright.agent", "runn.user", "runn.agent", "triage.user", "analysis-custom-prompt"];
+declare const PROMPT_NAMES: readonly ["record.user", "record.agent", "live.user", "live.agent", "playwright.user", "playwright.agent", "runn.user", "runn.agent", "triage.user", "triage.agent", "audit.user", "audit.agent"];
 type PromptName = (typeof PROMPT_NAMES)[number];
 //#endregion
 //#region src/report/schema.d.ts
@@ -417,6 +447,7 @@ declare const ReportSpecResultSchema: z.ZodObject<{
       TEST_DRIFT: "TEST_DRIFT";
       SPEC_CHANGE: "SPEC_CHANGE";
       PRODUCT_BUG: "PRODUCT_BUG";
+      ENVIRONMENT: "ENVIRONMENT";
       UNKNOWN: "UNKNOWN";
     }>;
     confidence: z.ZodNumber;
@@ -445,30 +476,6 @@ declare const ReportSpecResultSchema: z.ZodObject<{
     ref: z.ZodString;
     sha: z.ZodString;
   }, z.core.$strip>>>;
-  driftAudit: z.ZodNullable<z.ZodObject<{
-    label: z.ZodEnum<{
-      TEST_DRIFT: "TEST_DRIFT";
-      SPEC_CHANGE: "SPEC_CHANGE";
-      UNKNOWN: "UNKNOWN";
-    }>;
-    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>;
@@ -603,6 +610,7 @@ declare const RunReportDataSchema: z.ZodObject<{
         TEST_DRIFT: "TEST_DRIFT";
         SPEC_CHANGE: "SPEC_CHANGE";
         PRODUCT_BUG: "PRODUCT_BUG";
+        ENVIRONMENT: "ENVIRONMENT";
         UNKNOWN: "UNKNOWN";
       }>;
       confidence: z.ZodNumber;
@@ -631,30 +639,6 @@ declare const RunReportDataSchema: z.ZodObject<{
       ref: z.ZodString;
       sha: z.ZodString;
     }, z.core.$strip>>>;
-    driftAudit: z.ZodNullable<z.ZodObject<{
-      label: z.ZodEnum<{
-        TEST_DRIFT: "TEST_DRIFT";
-        SPEC_CHANGE: "SPEC_CHANGE";
-        UNKNOWN: "UNKNOWN";
-      }>;
-      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>;
@@ -742,12 +726,15 @@ declare const LabelsExportSchema: z.ZodObject<{
       TEST_DRIFT: "TEST_DRIFT";
       SPEC_CHANGE: "SPEC_CHANGE";
       PRODUCT_BUG: "PRODUCT_BUG";
+      ENVIRONMENT: "ENVIRONMENT";
       UNKNOWN: "UNKNOWN";
     }>;
     label: z.ZodEnum<{
       TEST_DRIFT: "TEST_DRIFT";
       SPEC_CHANGE: "SPEC_CHANGE";
       PRODUCT_BUG: "PRODUCT_BUG";
+      ENVIRONMENT: "ENVIRONMENT";
+      NO_DRIFT: "NO_DRIFT";
     }>;
     note: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
@@ -873,9 +860,7 @@ interface HubClient {
     feature: string;
     spec: string;
   }): Promise<void>;
-  importActualCauses(id: string, labels: LabelsExport): Promise<{
-    imported: number;
-  }>;
+  importActualCauses(id: string, labels: LabelsExport): Promise<ImportActualCausesResponse>;
   /** Every project the hub knows (from runs and stored secrets). */
   listProjects(): Promise<string[]>;
   /**

package/dist/package.json

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