feat(ql3): establish 3.0 incubation baseline

2026-09-22 19:29:13 +08:00 · 2026-08-12 00:25:26 +08:00
parent 4bf92dcfeb
commit c699c32461
2817 changed files with 779642 additions and 653 deletions
@@ -0,0 +1,37 @@
+import type {
+  ApprovedActionRecoveryFinding,
+  ApprovedActionRecoverySnapshot,
+} from '../domain/approvedActionRecovery';
+
+export type ApprovedActionRecoveryCapability = 'automatic' | 'manual_only';
+
+export type ApprovedActionRecoveryEvidence =
+  | {
+      finding: 'verified_succeeded' | 'verified_failed';
+      resultCode: string;
+      evidenceDigest: string;
+    }
+  | {
+      finding: Exclude<
+        ApprovedActionRecoveryFinding,
+        'verified_succeeded' | 'verified_failed'
+      >;
+      resultCode: string;
+      evidenceDigest?: string;
+    };
+
+export interface ApprovedActionRecoveryEvidenceContext {
+  snapshot: Readonly<ApprovedActionRecoverySnapshot>;
+  idempotencyKey: string;
+  observedAtMs: number;
+}
+
+export interface ApprovedActionRecoveryEvidenceProvider {
+  readonly actionType: string;
+  readonly capability: ApprovedActionRecoveryCapability;
+
+  /** Must only observe evidence; it must not repeat the approved side effect. */
+  inspect(
+    context: Readonly<ApprovedActionRecoveryEvidenceContext>,
+  ): Promise<ApprovedActionRecoveryEvidence>;
+}