@blxzer/pactile 0.6.0-beta.2 → 0.6.0-beta.4

package/dist/pactile/migration/legacy-task-batch-journal.js

@@ -0,0 +1,121 @@
+import path from "node:path";
+import { verifyGeneration } from "./legacy-task-batch-generation.js";
+import { ensureDirectory, atomicReplace, readRegularFile, storagePath, withLock, } from "./legacy-task-batch-io.js";
+import { verifySourceBackup } from "./legacy-task-batch-source.js";
+import { FINGERPRINT, JOURNAL_EVENTS, JOURNAL_STATES, digest, jsonBytes, } from "./legacy-task-batch-types.js";
+function parseJournal(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("migration-journal-invalid");
+    const journal = value;
+    if (journal.schemaVersion !== 1 ||
+        typeof journal.batchId !== "string" ||
+        typeof journal.generationId !== "string" ||
+        !JOURNAL_STATES.includes(journal.state) ||
+        !FINGERPRINT.test(journal.sourceFingerprint ?? "") ||
+        !FINGERPRINT.test(journal.targetFingerprint ?? "") ||
+        !FINGERPRINT.test(journal.planFingerprint ?? "") ||
+        (journal.expectedAuthorityFingerprint !== null &&
+            !FINGERPRINT.test(journal.expectedAuthorityFingerprint ?? "")) ||
+        typeof journal.createdAt !== "string" ||
+        Number.isNaN(Date.parse(journal.createdAt)) ||
+        typeof journal.updatedAt !== "string" ||
+        Number.isNaN(Date.parse(journal.updatedAt)) ||
+        !(journal.reason === null || typeof journal.reason === "string") ||
+        !Array.isArray(journal.events) ||
+        journal.events.some((event, index) => event.sequence !== index + 1 ||
+            !JOURNAL_EVENTS.includes(event.event) ||
+            !FINGERPRINT.test(event.evidenceFingerprint) ||
+            Number.isNaN(Date.parse(event.at)) ||
+            event.event === "source-change-reconciled" &&
+                (typeof event.relatedBatchId !== "string" ||
+                    !/^legacy-[a-f0-9]{64}$/.test(event.relatedBatchId) ||
+                    !FINGERPRINT.test(event.relatedSourceFingerprint ?? "") ||
+                    !FINGERPRINT.test(event.relatedPlanFingerprint ?? ""))))
+        throw new Error("migration-journal-invalid");
+    return journal;
+}
+function journalPath(projectRoot, batchId) {
+    return storagePath(projectRoot, "journals", `${batchId}.json`);
+}
+export function readJournal(projectRoot, batchId) {
+    const bytes = readRegularFile(projectRoot, journalPath(projectRoot, batchId));
+    if (!bytes)
+        return null;
+    try {
+        const journal = parseJournal(JSON.parse(bytes.toString("utf8")));
+        return { journal, fingerprint: digest(jsonBytes(journal)) };
+    }
+    catch {
+        throw new Error("migration-journal-invalid");
+    }
+}
+export function writeJournal(projectRoot, batchId, expectedFingerprint, journal) {
+    const directory = storagePath(projectRoot, "journals");
+    ensureDirectory(projectRoot, directory);
+    const target = journalPath(projectRoot, batchId);
+    const lock = `${target}.lock`;
+    return withLock(projectRoot, lock, () => {
+        const current = readJournal(projectRoot, batchId);
+        if ((current?.fingerprint ?? null) !== expectedFingerprint)
+            throw new Error("migration-journal-cas-mismatch");
+        const parsed = parseJournal(journal);
+        const bytes = jsonBytes(parsed);
+        atomicReplace(projectRoot, target, bytes);
+        return { journal: parsed, fingerprint: digest(bytes) };
+    });
+}
+function parseAuthority(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("migration-authority-invalid");
+    const authority = value;
+    if (authority.schemaVersion !== 1 ||
+        authority.kind !== "prepared-legacy-task-batch" ||
+        authority.visibility !== "active-v2" ||
+        typeof authority.batchId !== "string" ||
+        typeof authority.generationId !== "string" ||
+        !FINGERPRINT.test(authority.sourceFingerprint ?? "") ||
+        !FINGERPRINT.test(authority.targetFingerprint ?? "") ||
+        typeof authority.committedAt !== "string" ||
+        Number.isNaN(Date.parse(authority.committedAt)))
+        throw new Error("migration-authority-invalid");
+    return authority;
+}
+function authorityPath(projectRoot) {
+    return storagePath(projectRoot, "authority.json");
+}
+export function readAuthoritySnapshot(projectRoot) {
+    const bytes = readRegularFile(projectRoot, authorityPath(projectRoot));
+    if (!bytes)
+        return null;
+    try {
+        const authority = parseAuthority(JSON.parse(bytes.toString("utf8")));
+        verifyGeneration(projectRoot, authority.generationId, {
+            batchId: authority.batchId,
+            sourceFingerprint: authority.sourceFingerprint,
+            targetFingerprint: authority.targetFingerprint,
+        });
+        verifySourceBackup(projectRoot, authority.sourceFingerprint);
+        return { authority, fingerprint: digest(jsonBytes(authority)) };
+    }
+    catch {
+        throw new Error("migration-authority-invalid");
+    }
+}
+export function writeAuthority(projectRoot, expectedFingerprint, authority) {
+    const target = authorityPath(projectRoot);
+    ensureDirectory(projectRoot, path.dirname(target));
+    return withLock(projectRoot, `${target}.lock`, () => {
+        const current = readAuthoritySnapshot(projectRoot);
+        if ((current?.fingerprint ?? null) !== expectedFingerprint)
+            throw new Error("migration-authority-cas-mismatch");
+        verifyGeneration(projectRoot, authority.generationId, {
+            batchId: authority.batchId,
+            sourceFingerprint: authority.sourceFingerprint,
+            targetFingerprint: authority.targetFingerprint,
+        });
+        const bytes = jsonBytes(authority);
+        atomicReplace(projectRoot, target, bytes);
+        return { authority, fingerprint: digest(bytes) };
+    });
+}
+//# sourceMappingURL=legacy-task-batch-journal.js.map

package/dist/pactile/migration/legacy-task-batch-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-task-batch-journal.js","sourceRoot":"","sources":["../../../src/pactile/migration/legacy-task-batch-journal.ts"],"names":[],"mappings":"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"}

package/dist/pactile/migration/legacy-task-batch-orchestrator.d.ts

@@ -0,0 +1,18 @@
+import { type LegacyTaskBatchAuthority, type LegacyTaskBatchOptions, type LegacyTaskBatchRequest, type LegacyTaskBatchResult } from "./legacy-task-batch-types.js";
+export declare function legacyTaskBatchTaskIdConflict(projectRoot: string, targets: readonly {
+    readonly path: string;
+    readonly bytes: Uint8Array;
+}[]): string | null;
+/** Read the one committed-batch pointer and verify its source and staged bytes. */
+export declare function readPreparedLegacyTaskBatch(projectRoot: string): LegacyTaskBatchAuthority | null;
+/**
+ * A missing pointer may be retried only for a matching, pre-commit journal
+ * whose backup/staged generation verifies and which has no post-commit overlay.
+ * A lone lock for this exact batch may also reach `withLock`, which only reclaims
+ * it after confirming that its recorded process is dead.
+ */
+export declare function canResumeLegacyTaskBatchWithoutAuthority(request: LegacyTaskBatchRequest): boolean;
+/** Pure preflight for explicitly approved recovery from source-change residue. */
+export declare function canReconcileLegacyTaskBatchSourceChangeWithoutAuthority(request: LegacyTaskBatchRequest): boolean;
+export declare function runLegacyTaskBatch(request: LegacyTaskBatchRequest, options?: LegacyTaskBatchOptions): Promise<LegacyTaskBatchResult>;
+//# sourceMappingURL=legacy-task-batch-orchestrator.d.ts.map

package/dist/pactile/migration/legacy-task-batch-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-task-batch-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/pactile/migration/legacy-task-batch-orchestrator.ts"],"names":[],"mappings":"AAUA,OAAO,EAOL,KAAK,wBAAwB,EAE7B,KAAK,sBAAsB,EAE3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAI3B,MAAM,8BAA8B,CAAC;AAuBtC,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,EAAE,GACxE,MAAM,GAAG,IAAI,CAkCf;AAgHD,mFAAmF;AACnF,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,GAClB,wBAAwB,GAAG,IAAI,CAGjC;AAmCD;;;;;GAKG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CA4BT;AA4ND,kFAAkF;AAClF,wBAAgB,uDAAuD,CACrE,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAET;AAyYD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,sBAAsB,EAC/B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAqChC"}