@alan512/experienceengine 0.3.4 → 0.3.6

package/dist/store/sqlite/repositories/hygiene-governance-repo.d.ts

@@ -0,0 +1,187 @@
+import type { DatabaseSync } from "node:sqlite";
+export type GovernanceRunStatus = "pending" | "running" | "completed" | "failed" | "skipped";
+export type GovernanceActionStatus = "pending" | "applying" | "applied" | "rejected" | "failed" | "rolled_back";
+export type GovernanceSchedule = {
+    scope_id: string;
+    last_governed_at?: string;
+    next_due_at: string;
+    pending_reasons: string[];
+    last_run_status?: string;
+    last_failure_class?: string;
+    backoff_until?: string;
+    last_finding_hash?: string;
+    created_at: string;
+    updated_at: string;
+};
+export type GovernanceLease = {
+    scope_id: string;
+    lease_owner: string;
+    lease_expires_at: string;
+    acquired_at: string;
+    updated_at: string;
+};
+export type GovernanceRun = {
+    run_id: string;
+    scope_id: string;
+    trigger: string;
+    status: GovernanceRunStatus;
+    failure_class?: string;
+    failure_message?: string;
+    checkpoint?: Record<string, unknown>;
+    started_at?: string;
+    finished_at?: string;
+    created_at: string;
+    updated_at: string;
+};
+export type GovernanceAction = {
+    action_id: string;
+    plan_id?: string;
+    run_id?: string;
+    scope_id: string;
+    action_type: string;
+    status: GovernanceActionStatus;
+    affected_ids: string[];
+    affected_row_hashes: Record<string, string>;
+    action: Record<string, unknown>;
+    validator_decision?: Record<string, unknown>;
+    before_snapshot_id?: string;
+    after_state?: Record<string, unknown>;
+    rollback_of_action_id?: string;
+    created_at: string;
+    updated_at: string;
+    applied_at?: string;
+};
+export type GovernancePlan = {
+    plan_id: string;
+    run_id?: string;
+    scope_id: string;
+    status: string;
+    finding_hash?: string;
+    risk?: string;
+    plan: Record<string, unknown>;
+    validator_result?: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+};
+export type GovernanceApproval = {
+    approval_id: string;
+    action_id: string;
+    plan_id?: string;
+    scope_id: string;
+    status: string;
+    confirmation_token_hash?: string;
+    token_expires_at?: string;
+    diff_summary?: string;
+    affected_row_hashes: Record<string, string>;
+    created_at: string;
+    updated_at: string;
+    decided_at?: string;
+};
+export type GovernanceSnapshot = {
+    snapshot_id: string;
+    scope_id: string;
+    action_id: string;
+    row_refs: SnapshotRowRef[];
+    snapshot: SnapshotRow[];
+    row_hashes: Record<string, string>;
+    created_at: string;
+};
+export type SnapshotRowRef = {
+    table: string;
+    primaryKeyColumn: string;
+    primaryKeyValue: string;
+};
+type SnapshotRow = SnapshotRowRef & {
+    row: Record<string, unknown>;
+};
+export declare const computeGovernanceRowHashes: (db: DatabaseSync, rows: SnapshotRowRef[]) => Record<string, string>;
+export declare class GovernanceScheduleRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    get(scopeId: string): GovernanceSchedule | undefined;
+    maybeEnqueue(input: {
+        scopeId: string;
+        trigger: string;
+        now: string;
+        intervalMs: number;
+        findingHash?: string;
+    }): {
+        enqueued: boolean;
+        reason: "due" | "not_due" | "backoff";
+    };
+    recordFailure(input: {
+        scopeId: string;
+        failureClass: string;
+        now: string;
+        backoffMs: number;
+    }): GovernanceSchedule;
+}
+export declare class GovernanceLeaseRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    get(scopeId: string): GovernanceLease | undefined;
+    acquire(input: {
+        scopeId: string;
+        owner: string;
+        now: string;
+        ttlMs: number;
+    }): GovernanceLease | undefined;
+    release(scopeId: string, owner: string): boolean;
+}
+export declare class GovernanceRunRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(run: Omit<GovernanceRun, "run_id"> & {
+        run_id?: string;
+    }): GovernanceRun;
+    listByScope(scopeId: string): GovernanceRun[];
+}
+export declare class GovernanceActionRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(action: Omit<GovernanceAction, "action_id"> & {
+        action_id?: string;
+    }): GovernanceAction;
+    get(actionId: string): GovernanceAction | undefined;
+}
+export declare class GovernancePlanRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(plan: Omit<GovernancePlan, "plan_id"> & {
+        plan_id?: string;
+    }): GovernancePlan;
+    get(planId: string): GovernancePlan | undefined;
+    findReusableCompletedPlan(scopeId: string, findingHash: string): GovernancePlan | undefined;
+}
+export declare class GovernanceApprovalRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    create(approval: Omit<GovernanceApproval, "approval_id"> & {
+        approval_id?: string;
+    }): GovernanceApproval;
+    get(approvalId: string): GovernanceApproval | undefined;
+    getByActionId(actionId: string): GovernanceApproval | undefined;
+}
+export declare class GovernanceSnapshotRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    createForRows(input: {
+        scope_id: string;
+        action_id: string;
+        rows: SnapshotRowRef[];
+        created_at: string;
+        snapshot_id?: string;
+    }): GovernanceSnapshot;
+    get(snapshotId: string): GovernanceSnapshot | undefined;
+}
+export declare const applyGovernanceActionWithSnapshot: <T extends Record<string, unknown>>(db: DatabaseSync, input: {
+    actionId: string;
+    scopeId: string;
+    rows: SnapshotRowRef[];
+    now: string;
+    apply: () => T;
+}) => T & {
+    snapshot_id: string;
+};
+export declare const rollbackGovernanceSnapshot: (db: DatabaseSync, snapshotId: string, now: string) => void;
+export {};