@blxzer/pactile 0.5.0

package/dist/pactile/migration/transaction.js

@@ -0,0 +1,445 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+import { canonicalizePactileJsonV1, fingerprintPactileContractV1, parseMigrationJournalV1, parseMigrationPlanV1, } from "@blxzer/pactile-core";
+import { GenerationStore, InstallStateStore } from "../runtime/stores.js";
+import { assertCanonicalWriteTarget, normalizeRuntimeRelativePath, resolveCanonicalPaths, } from "../runtime/paths.js";
+const LOGICAL_ID = /^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$/;
+const FINGERPRINT = /^sha256:[0-9a-f]{64}$/;
+const MAX_MIGRATION_FILE_BYTES = 16 * 1024 * 1024;
+function fingerprintBytes(bytes) {
+    return `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
+}
+function normalizeRequest(request) {
+    try {
+        if (!path.isAbsolute(request.projectRoot) ||
+            !LOGICAL_ID.test(request.id) ||
+            !LOGICAL_ID.test(request.generationId) ||
+            ![".cstl", ".trellis"].includes(request.sourceRoot) ||
+            !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(request.runtimeVersion) ||
+            (request.expectedInstallStateFingerprint !== null &&
+                !FINGERPRINT.test(request.expectedInstallStateFingerprint)) ||
+            Number.isNaN(Date.parse(request.occurredAt)) ||
+            request.files.length === 0)
+            return null;
+        const files = request.files
+            .map((file) => ({
+            sourceRef: file.sourceRef,
+            targetPath: normalizeRuntimeRelativePath(file.targetPath),
+            classification: file.classification,
+            sourceBytes: Buffer.from(file.sourceBytes),
+            targetBytes: Buffer.from(file.targetBytes),
+            expectedSourceFingerprint: file.expectedSourceFingerprint,
+        }))
+            .sort((left, right) => left.targetPath.localeCompare(right.targetPath));
+        if (new Set(files.map((file) => file.targetPath.toLowerCase())).size !==
+            files.length ||
+            files.some((file) => !file.sourceRef ||
+                file.sourceRef.length > 512 ||
+                /[\0\r\n]/.test(file.sourceRef) ||
+                !["active", "closed", "generated"].includes(file.classification) ||
+                !FINGERPRINT.test(file.expectedSourceFingerprint) ||
+                file.sourceBytes.byteLength > MAX_MIGRATION_FILE_BYTES ||
+                file.targetBytes.byteLength > MAX_MIGRATION_FILE_BYTES ||
+                fingerprintBytes(file.sourceBytes) !==
+                    file.expectedSourceFingerprint ||
+                (file.classification === "closed" &&
+                    !file.sourceBytes.equals(file.targetBytes))))
+            return null;
+        return { ...request, files };
+    }
+    catch {
+        return null;
+    }
+}
+export function planMigrationTransaction(request) {
+    const input = normalizeRequest(request);
+    if (!input)
+        return null;
+    const detectId = `${input.id}.detect`;
+    const backupId = `${input.id}.backup`;
+    const validateId = `${input.id}.validate`;
+    const commitId = `${input.id}.commit`;
+    const doctorId = `${input.id}.doctor`;
+    const candidate = {
+        schemaVersion: 1,
+        id: input.id,
+        source: {
+            kind: "legacy",
+            root: input.sourceRoot,
+            access: "read-only",
+            runtimeVersion: input.sourceRuntimeVersion,
+            schemaVersion: input.sourceSchemaVersion,
+        },
+        target: {
+            root: ".pactile",
+            runtimeVersion: input.runtimeVersion,
+            schemaVersion: 1,
+            generationId: input.generationId,
+        },
+        actions: [
+            {
+                id: detectId,
+                phase: "detect",
+                kind: "capture-facts",
+                domain: "canonical",
+                sourceRef: `legacy://${input.sourceRoot.slice(1)}`,
+                targetRef: null,
+                adapterId: null,
+                reversible: true,
+            },
+            {
+                id: backupId,
+                phase: "backup",
+                kind: "snapshot",
+                domain: "canonical",
+                sourceRef: `legacy://${input.sourceRoot.slice(1)}`,
+                targetRef: `backup://${input.id}`,
+                adapterId: null,
+                reversible: true,
+            },
+            ...input.files.map((file, index) => ({
+                id: `${input.id}.stage.${index + 1}`,
+                phase: "stage",
+                kind: file.classification === "closed"
+                    ? "copy-byte-preserved"
+                    : file.classification === "generated"
+                        ? "write-generation"
+                        : "transform-schema",
+                domain: "canonical",
+                sourceRef: file.sourceRef,
+                targetRef: `generation://${input.generationId}/${file.targetPath}`,
+                adapterId: null,
+                reversible: true,
+            })),
+            {
+                id: validateId,
+                phase: "validate",
+                kind: "validate-generation",
+                domain: "canonical",
+                sourceRef: `generation://${input.generationId}`,
+                targetRef: null,
+                adapterId: null,
+                reversible: true,
+            },
+            {
+                id: commitId,
+                phase: "commit",
+                kind: "activate-generation",
+                domain: "canonical",
+                sourceRef: `generation://${input.generationId}`,
+                targetRef: "install-state://active",
+                adapterId: null,
+                reversible: true,
+            },
+            {
+                id: doctorId,
+                phase: "doctor",
+                kind: "doctor",
+                domain: "canonical",
+                sourceRef: `generation://${input.generationId}`,
+                targetRef: null,
+                adapterId: null,
+                reversible: true,
+            },
+        ],
+        canonicalCommitPointActionId: commitId,
+        preservation: {
+            bytePreservedRefs: input.files
+                .filter((file) => file.classification === "closed")
+                .map((file) => file.sourceRef),
+            transformedRefs: input.files
+                .filter((file) => file.classification !== "closed")
+                .map((file) => file.sourceRef),
+        },
+        recovery: {
+            backupRef: `backup://${input.id}`,
+            preserveNewerData: true,
+        },
+        projectionPlanIds: [],
+    };
+    const parsed = parseMigrationPlanV1(candidate);
+    return parsed.success
+        ? { plan: parsed.data, fingerprint: parsed.fingerprint }
+        : null;
+}
+class MigrationJournalStore {
+    projectRoot;
+    directory;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.directory = resolveCanonicalPaths(projectRoot).migrationJournalsPath;
+    }
+    target(id) {
+        if (!LOGICAL_ID.test(id))
+            throw new Error("invalid-journal-id");
+        return assertCanonicalWriteTarget(this.projectRoot, path.join(this.directory, `${id}.json`));
+    }
+    read(id) {
+        try {
+            const value = JSON.parse(fs.readFileSync(this.target(id), "utf8"));
+            const parsed = parseMigrationJournalV1(value);
+            return parsed.success
+                ? { journal: parsed.data, fingerprint: parsed.fingerprint }
+                : null;
+        }
+        catch (error) {
+            if (error instanceof Error && "code" in error && error.code === "ENOENT")
+                return null;
+            throw new Error("migration-journal-unavailable");
+        }
+    }
+    write(id, expectedFingerprint, journal) {
+        const parsed = parseMigrationJournalV1(journal);
+        if (!parsed.success)
+            throw new Error("invalid-migration-journal");
+        fs.mkdirSync(assertCanonicalWriteTarget(this.projectRoot, this.directory), {
+            recursive: true,
+        });
+        const target = this.target(id);
+        const lock = assertCanonicalWriteTarget(this.projectRoot, `${target}.lock`);
+        const temporary = assertCanonicalWriteTarget(this.projectRoot, `${target}.tmp-${randomUUID()}`);
+        let descriptor = null;
+        try {
+            descriptor = fs.openSync(lock, "wx", 0o600);
+            const current = this.read(id);
+            if ((current?.fingerprint ?? null) !== expectedFingerprint)
+                throw new Error("migration-journal-cas-mismatch");
+            fs.writeFileSync(temporary, canonicalizePactileJsonV1(parsed.data), {
+                flag: "wx",
+                mode: 0o600,
+            });
+            fs.renameSync(temporary, target);
+            return { journal: parsed.data, fingerprint: parsed.fingerprint };
+        }
+        finally {
+            if (descriptor !== null)
+                fs.closeSync(descriptor);
+            try {
+                fs.unlinkSync(lock);
+            }
+            catch {
+                /* An unavailable cleanup remains visible to recovery. */
+            }
+            try {
+                fs.unlinkSync(temporary);
+            }
+            catch {
+                /* The successful rename consumes the temporary file. */
+            }
+        }
+    }
+}
+function event(journal, at, name, actionId, evidenceRef) {
+    return {
+        sequence: journal.events.length + 1,
+        at,
+        event: name,
+        actionId,
+        adapterId: null,
+        evidenceRefs: [evidenceRef],
+    };
+}
+function initialJournal(request, plan, planFingerprint) {
+    return {
+        schemaVersion: 1,
+        id: request.id,
+        planId: plan.id,
+        planFingerprint,
+        state: "planned",
+        canonicalCommit: {
+            status: "pending",
+            actionId: plan.canonicalCommitPointActionId,
+            generationId: null,
+            committedAt: null,
+        },
+        recovery: {
+            status: "not-required",
+            backupRef: plan.recovery.backupRef,
+            updatedAt: request.occurredAt,
+            error: null,
+        },
+        adapterReconciliations: [],
+        events: [
+            {
+                sequence: 1,
+                at: request.occurredAt,
+                event: "planned",
+                actionId: `${request.id}.detect`,
+                adapterId: null,
+                evidenceRefs: [planFingerprint],
+            },
+        ],
+    };
+}
+function updateJournal(journal, patch) {
+    return { ...journal, ...patch };
+}
+export async function runMigrationTransaction(request, options = {}) {
+    const input = normalizeRequest(request);
+    const planned = input ? planMigrationTransaction(input) : null;
+    if (!input || !planned)
+        return {
+            status: "review",
+            reason: "invalid-migration-request",
+            plan: null,
+            journal: null,
+        };
+    const journals = new MigrationJournalStore(input.projectRoot);
+    const generations = new GenerationStore(input.projectRoot);
+    const installs = new InstallStateStore(input.projectRoot);
+    let snapshot = null;
+    let resumed = false;
+    try {
+        snapshot = journals.read(input.id);
+        if (snapshot) {
+            resumed = true;
+            if (snapshot.journal.planId !== planned.plan.id ||
+                snapshot.journal.planFingerprint !== planned.fingerprint)
+                return {
+                    status: "review",
+                    reason: "migration-plan-conflict",
+                    plan: planned.plan,
+                    journal: snapshot.journal,
+                };
+        }
+        else {
+            snapshot = journals.write(input.id, null, initialJournal(input, planned.plan, planned.fingerprint));
+        }
+        if (snapshot.journal.state === "completed")
+            return {
+                status: "completed",
+                resumed,
+                plan: planned.plan,
+                planFingerprint: planned.fingerprint,
+                journal: snapshot.journal,
+            };
+        if (snapshot.journal.state === "planned") {
+            const next = updateJournal(snapshot.journal, {
+                state: "backed-up",
+                recovery: {
+                    status: "available",
+                    backupRef: planned.plan.recovery.backupRef,
+                    updatedAt: input.occurredAt,
+                    error: null,
+                },
+                events: [
+                    ...snapshot.journal.events,
+                    event(snapshot.journal, input.occurredAt, "backup-completed", `${input.id}.backup`, planned.fingerprint),
+                ],
+            });
+            snapshot = journals.write(input.id, snapshot.fingerprint, next);
+        }
+        if (snapshot.journal.state === "backed-up") {
+            generations.stage(input.generationId);
+            const written = input.files.map((file) => generations.writeFile(input.generationId, file.targetPath, file.targetBytes));
+            const seal = generations.seal(input.generationId, written);
+            const next = updateJournal(snapshot.journal, {
+                state: "staged",
+                events: [
+                    ...snapshot.journal.events,
+                    event(snapshot.journal, input.occurredAt, "stage-completed", `${input.id}.stage.1`, seal.fingerprint),
+                ],
+            });
+            snapshot = journals.write(input.id, snapshot.fingerprint, next);
+        }
+        if (snapshot.journal.state === "staged") {
+            generations.verify(input.generationId);
+            const validationFiles = input.files.map((file) => {
+                const bytes = generations.readFile(input.generationId, file.targetPath);
+                if (!bytes.equals(file.targetBytes) ||
+                    (file.classification === "closed" &&
+                        fingerprintBytes(bytes) !== file.expectedSourceFingerprint))
+                    throw new Error("migration-validation-failed");
+                return {
+                    sourceRef: file.sourceRef,
+                    targetPath: file.targetPath,
+                    classification: file.classification,
+                    fingerprint: fingerprintBytes(bytes),
+                };
+            });
+            if (options.validateStaged &&
+                !(await options.validateStaged({
+                    plan: planned.plan,
+                    generationId: input.generationId,
+                    files: validationFiles,
+                })))
+                return {
+                    status: "review",
+                    reason: "migration-validation-failed",
+                    plan: planned.plan,
+                    journal: snapshot.journal,
+                };
+            const next = updateJournal(snapshot.journal, {
+                state: "validated",
+                events: [
+                    ...snapshot.journal.events,
+                    event(snapshot.journal, input.occurredAt, "validation-completed", `${input.id}.validate`, fingerprintPactileContractV1(validationFiles)),
+                ],
+            });
+            snapshot = journals.write(input.id, snapshot.fingerprint, next);
+        }
+        if (snapshot.journal.state === "validated") {
+            const current = installs.read();
+            if (current?.state.generationId !== input.generationId ||
+                current.state.lastMigrationJournalId !== input.id) {
+                installs.compareAndSwap(input.expectedInstallStateFingerprint, {
+                    schemaVersion: 1,
+                    product: "pactile",
+                    canonicalRoot: ".pactile",
+                    runtimeVersion: input.runtimeVersion,
+                    contractVersion: 1,
+                    generationId: input.generationId,
+                    status: "active",
+                    installedAdapters: current?.state.installedAdapters ?? [],
+                    lastMigrationJournalId: input.id,
+                    createdAt: current?.state.createdAt ?? input.occurredAt,
+                    updatedAt: input.occurredAt,
+                });
+            }
+            const next = updateJournal(snapshot.journal, {
+                state: "committed",
+                canonicalCommit: {
+                    status: "committed",
+                    actionId: planned.plan.canonicalCommitPointActionId,
+                    generationId: input.generationId,
+                    committedAt: input.occurredAt,
+                },
+                events: [
+                    ...snapshot.journal.events,
+                    event(snapshot.journal, input.occurredAt, "canonical-committed", planned.plan.canonicalCommitPointActionId, `generation:${input.generationId}`),
+                ],
+            });
+            snapshot = journals.write(input.id, snapshot.fingerprint, next);
+        }
+        if (snapshot.journal.state === "committed") {
+            const next = updateJournal(snapshot.journal, {
+                state: "completed",
+                events: [
+                    ...snapshot.journal.events,
+                    event(snapshot.journal, input.occurredAt, "doctor-completed", `${input.id}.doctor`, `generation:${input.generationId}`),
+                ],
+            });
+            snapshot = journals.write(input.id, snapshot.fingerprint, next);
+        }
+        return {
+            status: "completed",
+            resumed,
+            plan: planned.plan,
+            planFingerprint: planned.fingerprint,
+            journal: snapshot.journal,
+        };
+    }
+    catch (error) {
+        return {
+            status: "interrupted",
+            reason: error instanceof Error &&
+                error.message === "migration-validation-failed"
+                ? "migration-validation-failed"
+                : "migration-interrupted",
+            plan: planned.plan,
+            journal: journals.read(input.id)?.journal ?? snapshot?.journal ?? null,
+        };
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/pactile/migration/transaction.js.map

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

package/dist/pactile/projection/managed-block.d.ts

@@ -0,0 +1,32 @@
+/** Pure span operations: ambiguity never grants permission to edit. */
+export declare const PACTILE_MARKERS: {
+    readonly start: "<!-- PACTILE:START -->";
+    readonly end: "<!-- PACTILE:END -->";
+};
+export interface BlockMarkers {
+    readonly start: string;
+    readonly end: string;
+}
+export type MergeResult = {
+    readonly status: "merged";
+    readonly text: string;
+} | {
+    readonly status: "review";
+    readonly reason: string;
+};
+export type BlockSpan = {
+    readonly status: "present";
+    readonly start: number;
+    readonly end: number;
+    readonly text: string;
+} | {
+    readonly status: "absent";
+} | {
+    readonly status: "review";
+};
+export declare function inspectManagedBlock(text: string, markers?: BlockMarkers): BlockSpan;
+export declare function patchManagedBlock(current: string, replacement: string | null, markers?: BlockMarkers, insertionOffset?: number): MergeResult;
+/** Legacy facade escape hatch for replacing a proven span with an unmarked template. */
+export declare function replaceManagedBlockSpan(current: string, replacement: string, markers: BlockMarkers): MergeResult;
+export declare function mergeManagedBlock(current: string, previous: string | null, desired: string): MergeResult;
+//# sourceMappingURL=managed-block.d.ts.map

package/dist/pactile/projection/managed-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-block.d.ts","sourceRoot":"","sources":["../../../src/pactile/projection/managed-block.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AACX,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3D,MAAM,MAAM,SAAS,GACjB;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GACD;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAElC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAA8B,GACtC,SAAS,CAmBX;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,GAAE,YAA8B,EACvC,eAAe,SAAiB,GAC/B,WAAW,CAiCb;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,YAAY,GACpB,WAAW,CAQb;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,OAAO,EAAE,MAAM,GACd,WAAW,CAgBb"}

package/dist/pactile/projection/managed-block.js

@@ -0,0 +1,78 @@
+/** Pure span operations: ambiguity never grants permission to edit. */
+export const PACTILE_MARKERS = {
+    start: "<!-- PACTILE:START -->",
+    end: "<!-- PACTILE:END -->",
+};
+export function inspectManagedBlock(text, markers = PACTILE_MARKERS) {
+    if (!markers.start || !markers.end || markers.start === markers.end)
+        return { status: "review" };
+    const start = text.indexOf(markers.start);
+    const end = text.indexOf(markers.end);
+    if (start === -1 && end === -1)
+        return { status: "absent" };
+    if (start === -1 ||
+        end < start + markers.start.length ||
+        text.indexOf(markers.start, start + markers.start.length) !== -1 ||
+        text.indexOf(markers.end, end + markers.end.length) !== -1)
+        return { status: "review" };
+    return {
+        status: "present",
+        start,
+        end: end + markers.end.length,
+        text: text.slice(start, end + markers.end.length),
+    };
+}
+export function patchManagedBlock(current, replacement, markers = PACTILE_MARKERS, insertionOffset = current.length) {
+    const span = inspectManagedBlock(current, markers);
+    if (span.status === "review")
+        return { status: "review", reason: "ambiguous-markers" };
+    if (replacement !== null) {
+        const next = inspectManagedBlock(replacement, markers);
+        if (next.status !== "present" || next.text !== replacement)
+            return { status: "review", reason: "invalid-generated-block" };
+    }
+    if (span.status === "present")
+        return {
+            status: "merged",
+            text: current.slice(0, span.start) +
+                (replacement ?? "") +
+                current.slice(span.end),
+        };
+    if (replacement === null)
+        return { status: "merged", text: current };
+    if (!Number.isInteger(insertionOffset) ||
+        insertionOffset < 0 ||
+        insertionOffset > current.length)
+        return { status: "review", reason: "invalid-insertion-offset" };
+    return {
+        status: "merged",
+        text: current.slice(0, insertionOffset) +
+            (insertionOffset ? "\n\n" : "") +
+            replacement +
+            "\n" +
+            current.slice(insertionOffset),
+    };
+}
+/** Legacy facade escape hatch for replacing a proven span with an unmarked template. */
+export function replaceManagedBlockSpan(current, replacement, markers) {
+    const span = inspectManagedBlock(current, markers);
+    if (span.status !== "present")
+        return { status: "review", reason: "missing-or-ambiguous-markers" };
+    return {
+        status: "merged",
+        text: current.slice(0, span.start) + replacement + current.slice(span.end),
+    };
+}
+export function mergeManagedBlock(current, previous, desired) {
+    const now = inspectManagedBlock(current), old = inspectManagedBlock(previous ?? ""), next = inspectManagedBlock(desired);
+    if (now.status === "review" ||
+        old.status === "review" ||
+        next.status !== "present")
+        return { status: "review", reason: "ambiguous-markers" };
+    const normalize = (text) => text.replace(/\r\n/g, "\n");
+    const oldText = old.status === "present" ? normalize(old.text) : null, nowText = now.status === "present" ? normalize(now.text) : null;
+    if (nowText !== oldText && nowText !== normalize(next.text))
+        return { status: "review", reason: "owned-region-modified" };
+    return patchManagedBlock(current, normalize(next.text));
+}
+//# sourceMappingURL=managed-block.js.map

package/dist/pactile/projection/managed-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-block.js","sourceRoot":"","sources":["../../../src/pactile/projection/managed-block.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,wBAAwB;IAC/B,GAAG,EAAE,sBAAsB;CACnB,CAAC;AAkBX,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,UAAwB,eAAe;IAEvC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,GAAG;QACjE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC5D,IACE,KAAK,KAAK,CAAC,CAAC;QACZ,GAAG,GAAG,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM;QAClC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE1D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9B,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,KAAK;QACL,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM;QAC7B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,WAA0B,EAC1B,UAAwB,eAAe,EACvC,eAAe,GAAG,OAAO,CAAC,MAAM;IAEhC,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;QAC1B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC3D,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YACxD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAC3B,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,IAAI,EACF,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;gBAC5B,CAAC,WAAW,IAAI,EAAE,CAAC;gBACnB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;SAC1B,CAAC;IACJ,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACrE,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;QAClC,eAAe,GAAG,CAAC;QACnB,eAAe,GAAG,OAAO,CAAC,MAAM;QAEhC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;IAClE,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,IAAI,EACF,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;YACjC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,WAAW;YACX,IAAI;YACJ,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,WAAmB,EACnB,OAAqB;IAErB,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAC3B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;IACtE,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,QAAuB,EACvB,OAAe;IAEf,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,CAAC,EACtC,GAAG,GAAG,mBAAmB,CAAC,QAAQ,IAAI,EAAE,CAAC,EACzC,IAAI,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtC,IACE,GAAG,CAAC,MAAM,KAAK,QAAQ;QACvB,GAAG,CAAC,MAAM,KAAK,QAAQ;QACvB,IAAI,CAAC,MAAM,KAAK,SAAS;QAEzB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EACnE,OAAO,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,IAAI,OAAO,KAAK,OAAO,IAAI,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAC/D,OAAO,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/pactile/projection/planner.d.ts

@@ -0,0 +1,65 @@
+import { type OwnershipLedgerV1, type ProjectionOperationV1 } from "@blxzer/pactile-core";
+import { type TomlOwnedKey } from "./structured-merge.js";
+export declare const fingerprintBytes: (bytes: Uint8Array | string) => string;
+/** Shared accepted artifact/output and persisted-file limit; includes stage recovery. */
+export declare const MAX_PROJECTION_BYTES: number;
+export interface ProjectionContent {
+    readonly bytes: Uint8Array;
+    readonly ownedJsonPointers?: readonly string[];
+    readonly ownedTomlKeys?: readonly TomlOwnedKey[];
+}
+/** Immutable artifact resolver. Specs belong to referenced artifacts, never extra fields on M0 operations. */
+export type ContentResolver = (contentRef: string) => ProjectionContent;
+export interface ExternalBindingClaim {
+    readonly resourceId: string;
+    readonly externalAssetId: string;
+    readonly claimants: readonly string[];
+}
+export interface ProjectionMutation {
+    readonly targetPath: string;
+    readonly before: string | null;
+    readonly bytes: Uint8Array | null;
+}
+export interface ProjectionDecision {
+    readonly operationId: string;
+    readonly resourceId: string;
+    readonly disposition: string;
+}
+export interface ProjectionPreview {
+    readonly status: "ready";
+    /** Adapter identity carried from the validated plan for adapter-scoped receipts. */
+    readonly adapterId: string;
+    readonly planFingerprint: string;
+    readonly expectedLedgerFingerprint: string | null;
+    readonly ledger: OwnershipLedgerV1;
+    readonly mutations: readonly ProjectionMutation[];
+    readonly observations: readonly {
+        targetPath: string;
+        fingerprint: string | null;
+    }[];
+    readonly decisions: readonly ProjectionDecision[];
+    /** Pure-plan state; ProjectionStore persists only claim identities, never bodies. */
+    readonly externalClaims: readonly ExternalBindingClaim[];
+}
+export type ProjectionPreviewResult = ProjectionPreview | {
+    readonly status: "review" | "conflict";
+    readonly reason: string;
+};
+export interface ProjectionInputs {
+    readonly plan: unknown;
+    readonly ledger: unknown | null;
+    readonly canonicalFingerprint: string;
+    readonly updatedAt: string;
+    readonly observe: (targetPath: string) => Uint8Array | null;
+    readonly resolveContent: ContentResolver;
+    readonly externalClaims?: readonly ExternalBindingClaim[];
+}
+export declare function canonicalOwnershipLedger(input: unknown): {
+    ledger: OwnershipLedgerV1;
+    fingerprint: string;
+};
+/** Pure external-ref reducer. It cannot receive an asset path or filesystem writer. */
+export declare function reduceExternalBindingClaims(input: readonly ExternalBindingClaim[], operations: readonly ProjectionOperationV1[]): readonly ExternalBindingClaim[];
+/** Read-only planning. A single ambiguous operation rejects the complete transaction. */
+export declare function planProjection(input: ProjectionInputs): ProjectionPreviewResult;
+//# sourceMappingURL=planner.d.ts.map