@dsh-enhanced/plugin-control-plane 0.1.66 → 0.1.67

package/lib/revision-capability-journal.d.ts

@@ -0,0 +1,103 @@
+import type { RevisionCapabilityAdoptionReceipt, RevisionCapabilityAdoptionRecord, RevisionCapabilityCall, RevisionCapabilityCallEvidence, RevisionCapabilityConfig, RevisionCapabilityEntry, RevisionCapabilityJournalPort, RevisionCapabilityRollbackRecord, RevisionCapabilityVersion } from './revision-capability-types.js';
+/** Read-only preflight; it never creates a signing key or ledger. */
+export declare function validateRevisionCapabilityConfig(value: unknown): asserts value is RevisionCapabilityConfig;
+/** Stable public identity for preflight separation from acceptance and creation adoption keys. */
+export declare function revisionCapabilityPublicKey(config: RevisionCapabilityConfig): string;
+/**
+ * Stable journal authority identity: canonical journal path, the full grant and the signing key file
+ * fingerprint. A missing, non-canonical or non-private key fails closed before any ledger exists.
+ */
+export declare function revisionCapabilityAuthorityDigest(input: {
+    path: string;
+    config: RevisionCapabilityConfig;
+}): string;
+export declare function verifyRevisionCapabilityAdoptionReceipt(value: unknown, authorityDigest: string, publicKey: string, now?: number): value is RevisionCapabilityAdoptionReceipt;
+/** Reservations consume quota before any external action; recovery only marks uncertainty. */
+export declare class RevisionCapabilityJournal implements RevisionCapabilityJournalPort {
+    readonly authorityDigest: string;
+    readonly publicKey: string;
+    private readonly db;
+    private readonly key;
+    private readonly identity;
+    private readonly ledgerPath;
+    private readonly config;
+    constructor(input: {
+        path: string;
+        config: RevisionCapabilityConfig;
+    });
+    private checkFiles;
+    private syncDirectory;
+    private transaction;
+    private count;
+    usage(): {
+        adoptions: number;
+        rollbacks: number;
+        calls: number;
+    };
+    private row;
+    private versionRow;
+    private decodeEntry;
+    private decodeVersion;
+    private decodeAdoption;
+    inspectAdoption(planId: string): RevisionCapabilityAdoptionRecord | undefined;
+    listEntries(): readonly RevisionCapabilityEntry[];
+    inspectVersion(planId: string): RevisionCapabilityVersion | undefined;
+    inspectEntry(entryId: string): {
+        entry: RevisionCapabilityEntry;
+        parent: RevisionCapabilityVersion;
+        current: RevisionCapabilityVersion;
+    } | undefined;
+    claim(input: {
+        planId: string;
+        parentPlanId: string;
+        certificateDigest: string;
+    }): {
+        created: boolean;
+        record: RevisionCapabilityAdoptionRecord;
+    };
+    settle(planId: string, status: 'closed' | 'unknown' | 'rejected', reason: string): void;
+    commit(input: {
+        entry: {
+            entryId: string;
+            name: string;
+            aliases: readonly string[];
+        };
+        parent: RevisionCapabilityVersion;
+        revision: RevisionCapabilityVersion;
+        receipt: RevisionCapabilityAdoptionReceipt;
+        expectedCurrentPlanId: string;
+        inFlightParentCalls: number;
+    }): RevisionCapabilityAdoptionRecord;
+    signReceipt(body: Omit<RevisionCapabilityAdoptionReceipt, 'signature'>): RevisionCapabilityAdoptionReceipt;
+    private insertVersion;
+    rollback(input: {
+        entryId: string;
+        expectedCurrentPlanId: string;
+        authorityId: string;
+    }): {
+        created: boolean;
+        record: RevisionCapabilityRollbackRecord;
+    };
+    private decodeRollback;
+    claimCall(input: {
+        entryId: string;
+        key: string;
+        argumentsDigest: string;
+        toolAlias: string;
+        versionPlanId: string;
+    }): {
+        created: boolean;
+        call: RevisionCapabilityCall;
+    };
+    private decodeCall;
+    settleCall(input: {
+        entryId: string;
+        key: string;
+        status: 'completed' | 'unknown';
+        result?: unknown;
+    }): void;
+    listCallEvidence(entryId: string): readonly RevisionCapabilityCallEvidence[];
+    recoverClaims(): void;
+    close(): void;
+}
+//# sourceMappingURL=revision-capability-journal.d.ts.map

package/lib/revision-capability-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revision-capability-journal.d.ts","sourceRoot":"","sources":["../src/revision-capability-journal.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iCAAiC,EAAE,gCAAgC,EAAE,sBAAsB,EACvG,8BAA8B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,6BAA6B,EACvF,gCAAgC,EACzD,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AA2HnE,qEAAqE;AACrE,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAoB1G;AAMD,kGAAkG;AAClG,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CAGpF;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,wBAAwB,CAAA;CAAE,GAAG,MAAM,CAGnH;AA4BD,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAChH,GAAG,SAAa,GAAG,KAAK,IAAI,iCAAiC,CAS9D;AAqCD,8FAA8F;AAC9F,qBAAa,yBAA0B,YAAW,6BAA6B;IAC7E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAW;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBACrC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,wBAAwB,CAAA;KAAE;IA8CrE,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,KAAK;IAGb,KAAK,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAIhE,OAAO,CAAC,GAAG;IAGX,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,aAAa;IA+CrB,OAAO,CAAC,cAAc;IAoBtB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gCAAgC,GAAG,SAAS;IAK7E,WAAW,IAAI,SAAS,uBAAuB,EAAE;IAKjD,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAKrE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,uBAAuB,CAAC;QAAC,MAAM,EAAE,yBAAyB,CAAC;QACjG,OAAO,EAAE,yBAAyB,CAAA;KAAE,GAAG,SAAS;IAWlD,KAAK,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;QACnG,MAAM,EAAE,gCAAgC,CAAA;KAAE;IAgB5C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAavF,MAAM,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;SAAE,CAAA;QAClF,MAAM,EAAE,yBAAyB,CAAC;QAAC,QAAQ,EAAE,yBAAyB,CAAA;QACtE,OAAO,EAAE,iCAAiC,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,GACxG,gCAAgC;IAyDlC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,iCAAiC,EAAE,WAAW,CAAC,GAAG,iCAAiC;IAK1G,OAAO,CAAC,aAAa;IAWrB,QAAQ,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,qBAAqB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GACrF;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,gCAAgC,CAAA;KAAE;IA+BhE,OAAO,CAAC,cAAc;IAStB,SAAS,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAClH;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,sBAAsB,CAAA;KAAE;IAuBpD,OAAO,CAAC,UAAU;IAclB,UAAU,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAY5G,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,8BAA8B,EAAE;IAkB5E,aAAa,IAAI,IAAI;IAMrB,KAAK,IAAI,IAAI;CACd"}