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

package/dist/pactile/jev/scheduler-advice.js

@@ -0,0 +1,323 @@
+import { createHash } from "node:crypto";
+import { projectJevConfidenceReceiptV1, unavailableJevConfidenceReceiptV1, } from "./response.js";
+const MAX_CHOICE_CANDIDATES = 16;
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function auditTransport(receipt) {
+    return {
+        latencyMs: receipt.transport.latencyMs,
+        attempts: receipt.transport.attempts,
+        httpStatus: receipt.transport.httpStatus,
+        model: receipt.transport.model,
+        inputTokens: receipt.transport.inputTokens,
+        outputTokens: receipt.transport.outputTokens,
+        estimatedInputCostMicrousd: receipt.transport.estimatedInputCostMicrousd,
+        confidence: projectJevConfidenceReceiptV1(receipt.transport.confidence, ["first_task"]),
+    };
+}
+function baseAudit(input) {
+    return {
+        schemaVersion: 1,
+        status: input.status,
+        reasonCode: input.reasonCode,
+        preparedRequestSnapshot: input.preparedRequestSnapshot ?? null,
+        sentRequestSnapshot: input.sentRequestSnapshot ?? null,
+        finalEligibleCandidates: {
+            candidateTaskIds: input.candidates.map(({ taskId }) => taskId),
+            filteredCandidates: [...input.filteredCandidates],
+            eligibility: {
+                approvalPassedTaskIds: [...input.eligibility.approvalPassedTaskIds],
+                worktreePassedTaskIds: [...input.eligibility.worktreePassedTaskIds],
+                activeLeaseCheckAt: input.eligibility.activeLeaseCheckAt,
+            },
+        },
+        eligibilityChanged: input.eligibilityChanged ?? false,
+        suggestedTaskIds: [...(input.suggestedTaskIds ?? [])],
+        adoptedTaskIds: [...(input.adoptedTaskIds ?? [])],
+        overriddenTaskIds: [...(input.overriddenTaskIds ?? [])],
+        transport: {
+            latencyMs: input.transport?.latencyMs ?? 0,
+            attempts: input.transport?.attempts ?? 0,
+            httpStatus: input.transport?.httpStatus ?? null,
+            model: input.transport?.model ?? null,
+            inputTokens: input.transport?.inputTokens ?? null,
+            outputTokens: input.transport?.outputTokens ?? null,
+            estimatedInputCostMicrousd: input.transport?.estimatedInputCostMicrousd ?? null,
+            confidence: input.transport
+                ? projectJevConfidenceReceiptV1(input.transport.confidence, ["first_task"])
+                : unavailableJevConfidenceReceiptV1(["first_task"]),
+        },
+    };
+}
+function attemptedRequestSnapshot(prepared, transport) {
+    return transport.attempts !== null && transport.attempts > 0
+        ? prepared
+        : null;
+}
+/**
+ * Asks Jev to choose a first task only within a locally filtered, equal
+ * critical-path candidate group. The caller owns fresh hard-gate checks.
+ */
+export async function requestJevTaskScheduleAdviceV1(input) {
+    const candidates = [...input.candidates].sort((left, right) => compareText(left.taskId, right.taskId));
+    if (input.fallbackReasonCode) {
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "fallback",
+                reasonCode: input.fallbackReasonCode,
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+            }),
+        };
+    }
+    if (!input.options) {
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "skipped",
+                reasonCode: "disabled",
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+            }),
+        };
+    }
+    if (candidates.length < 2) {
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "skipped",
+                reasonCode: "insufficient-candidates",
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+            }),
+        };
+    }
+    if (candidates.length > MAX_CHOICE_CANDIDATES) {
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "fallback",
+                reasonCode: "candidate-bound-exceeded",
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+            }),
+        };
+    }
+    const labels = candidates.map((_candidate, index) => `candidate-${String(index + 1).padStart(2, "0")}`);
+    const taskSummary = JSON.stringify({
+        purpose: "Choose one first task from already eligible equal critical-path candidates.",
+        constraints: [
+            "This is scheduling advice only.",
+            "Do not infer or grant execution permission.",
+            "Do not change dependencies, write-set rules, or concurrency limits.",
+        ],
+        candidates: candidates.map((candidate, index) => ({
+            label: labels[index],
+            criticalPathMs: candidate.criticalPathMs,
+            estimatedCostMs: candidate.estimatedCostMs,
+        })),
+    });
+    const question = {
+        type: "choice",
+        instructions: "Select the eligible candidate that should be suggested first. This may only break a tie in critical-path cost.",
+        criteria: Object.fromEntries(candidates.map((candidate, index) => [
+            labels[index],
+            `Eligible candidate ${index + 1}; critical path ${candidate.criticalPathMs} ms; estimated cost ${candidate.estimatedCostMs} ms.`,
+        ])),
+    };
+    const requestForDigest = {
+        node: "task-scheduling",
+        taskSummary,
+        questions: { first_task: question },
+    };
+    const inputDigest = createHash("sha256")
+        .update(JSON.stringify(requestForDigest), "utf8")
+        .digest("hex");
+    const preparedRequestSnapshot = {
+        candidateTaskIds: candidates.map(({ taskId }) => taskId),
+        inputDigest,
+        inputSummaryChars: taskSummary.length,
+    };
+    const startedAt = Date.now();
+    let result;
+    try {
+        result = await input.options.facade.decide({
+            node: "task-scheduling",
+            request: {
+                taskSummary,
+                questions: { first_task: question },
+            },
+            options: {
+                egress: input.options.egress,
+                ...(input.options.signal ? { signal: input.options.signal } : {}),
+                ...(input.options.minimumDecisionConfidence !== undefined
+                    ? {
+                        minimumDecisionConfidence: input.options.minimumDecisionConfidence,
+                    }
+                    : {}),
+            },
+        });
+    }
+    catch {
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "fallback",
+                reasonCode: "transport-error",
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+                preparedRequestSnapshot,
+                transport: {
+                    latencyMs: Math.max(0, Date.now() - startedAt),
+                    attempts: null,
+                    httpStatus: null,
+                    model: null,
+                    inputTokens: null,
+                    outputTokens: null,
+                    estimatedInputCostMicrousd: null,
+                    confidence: unavailableJevConfidenceReceiptV1(["first_task"]),
+                },
+            }),
+        };
+    }
+    if (result.status !== "answered") {
+        const transport = auditTransport(result.receipt);
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "fallback",
+                reasonCode: result.fallback.reasonCode,
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+                preparedRequestSnapshot,
+                sentRequestSnapshot: attemptedRequestSnapshot(preparedRequestSnapshot, transport),
+                transport,
+            }),
+        };
+    }
+    const answer = result.answers.first_task;
+    const selectedLabel = answer?.type === "choice" ? answer.choice : undefined;
+    const selectedIndex = labels.indexOf(selectedLabel ?? "");
+    if (selectedIndex < 0) {
+        const transport = auditTransport(result.receipt);
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "fallback",
+                reasonCode: "invalid-response",
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+                preparedRequestSnapshot,
+                sentRequestSnapshot: attemptedRequestSnapshot(preparedRequestSnapshot, transport),
+                transport,
+            }),
+        };
+    }
+    const selected = candidates[selectedIndex];
+    if (!selected) {
+        const transport = auditTransport(result.receipt);
+        return {
+            advice: null,
+            audit: baseAudit({
+                status: "fallback",
+                reasonCode: "invalid-response",
+                candidates,
+                filteredCandidates: input.filteredCandidates,
+                eligibility: input.eligibility,
+                preparedRequestSnapshot,
+                sentRequestSnapshot: attemptedRequestSnapshot(preparedRequestSnapshot, transport),
+                transport,
+            }),
+        };
+    }
+    const taskOrder = [
+        selected.taskId,
+        ...candidates
+            .filter(({ taskId }) => taskId !== selected.taskId)
+            .map(({ taskId }) => taskId),
+    ];
+    const transport = auditTransport(result.receipt);
+    const audit = baseAudit({
+        status: "answered",
+        reasonCode: null,
+        candidates,
+        filteredCandidates: input.filteredCandidates,
+        eligibility: input.eligibility,
+        preparedRequestSnapshot,
+        sentRequestSnapshot: attemptedRequestSnapshot(preparedRequestSnapshot, transport),
+        transport,
+        suggestedTaskIds: taskOrder,
+    });
+    return {
+        advice: {
+            taskOrder,
+            evidenceRef: `jev:schedule-order:${inputDigest}`,
+        },
+        audit,
+    };
+}
+export function finalizeJevTaskScheduleAdviceV1(audit, plan) {
+    if (audit.status !== "answered")
+        return audit;
+    const suggested = new Set(audit.suggestedTaskIds);
+    const actualCandidateOrder = (plan.waves[0]?.candidateTaskIds ?? []).filter((taskId) => suggested.has(taskId));
+    const adopted = actualCandidateOrder.length === audit.suggestedTaskIds.length &&
+        actualCandidateOrder.every((taskId, index) => taskId === audit.suggestedTaskIds[index]);
+    const adoptedTaskIds = adopted ? [...audit.suggestedTaskIds] : [];
+    const overriddenTaskIds = adopted ? [] : [...audit.suggestedTaskIds];
+    return {
+        ...audit,
+        adoptedTaskIds,
+        overriddenTaskIds,
+    };
+}
+export function finalizeJevTaskScheduleEligibilityV1(audit, candidates, filteredCandidates, eligibility, eligibilityChanged) {
+    return {
+        ...audit,
+        finalEligibleCandidates: {
+            candidateTaskIds: candidates.map(({ taskId }) => taskId),
+            filteredCandidates: [...filteredCandidates],
+            eligibility: {
+                approvalPassedTaskIds: [...eligibility.approvalPassedTaskIds],
+                worktreePassedTaskIds: [...eligibility.worktreePassedTaskIds],
+                activeLeaseCheckAt: eligibility.activeLeaseCheckAt,
+            },
+        },
+        eligibilityChanged,
+    };
+}
+export function supersedeJevTaskScheduleAdviceV1(audit) {
+    if (audit.status !== "answered")
+        return audit;
+    return {
+        ...audit,
+        status: "superseded",
+        reasonCode: "eligibility-changed",
+        adoptedTaskIds: [],
+        overriddenTaskIds: [...audit.suggestedTaskIds],
+    };
+}
+/** Rejects an answer when the project egress policy is no longer permissive. */
+export function applyJevTaskScheduleEgressFallbackV1(audit, reasonCode) {
+    return {
+        ...audit,
+        status: audit.status === "answered" || audit.status === "superseded"
+            ? "superseded"
+            : "fallback",
+        reasonCode,
+        adoptedTaskIds: [],
+        overriddenTaskIds: audit.suggestedTaskIds.length > 0
+            ? [...audit.suggestedTaskIds]
+            : [...audit.overriddenTaskIds],
+    };
+}
+//# sourceMappingURL=scheduler-advice.js.map

package/dist/pactile/jev/scheduler-advice.js.map

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

package/dist/pactile/jev/transport.d.ts

@@ -0,0 +1,6 @@
+import type { JevCallOptionsV1, JevTransportConfigV1, JevTransportResultV1 } from "./contracts.js";
+export { JEV_ENDPOINT_V1 } from "./contracts.js";
+export type { JevAnswerV1, JevCallOptionsV1, JevConfidenceReceiptV1, JevConfidenceUnavailableReasonV1, JevConfidenceValueV1, JevDecisionRequestV1, JevEgressAuthorizationV1, JevFallbackCodeV1, JevQuestionV1, JevReceiptV1, JevTransportConfigV1, JevTransportResultV1, } from "./contracts.js";
+/** The response is a suggestion only, never Kernel, Review, CI, or authorization authority. */
+export declare function createJevTransportV1(config?: JevTransportConfigV1): (raw: unknown, options?: JevCallOptionsV1) => Promise<JevTransportResultV1>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/pactile/jev/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/pactile/jev/transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAEhB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,gCAAgC,EAChC,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,oBAAyB,IAElE,KAAK,OAAO,EACZ,UAAU,gBAAgB,KACzB,OAAO,CAAC,oBAAoB,CAAC,CA6FjC"}

package/dist/pactile/jev/transport.js

@@ -0,0 +1,87 @@
+import process from "node:process";
+import { fail, MAX_DEADLINE_MS } from "./contracts.js";
+import { egressFailure, validateInput } from "./outbound.js";
+import { requestJevHttpV1 } from "./http.js";
+import { costEstimate, decisionConfidence, parseSuccess, readJevConfidenceReceiptV1, unavailableJevConfidenceReceiptV1, } from "./response.js";
+export { JEV_ENDPOINT_V1 } from "./contracts.js";
+/** The response is a suggestion only, never Kernel, Review, CI, or authorization authority. */
+export function createJevTransportV1(config = {}) {
+    return async function requestJevDecisionV1(raw, options) {
+        if (Number(process.versions.node.split(".")[0]) < 20)
+            return fail("runtime-unsupported");
+        const key = config.apiKey;
+        if (typeof key !== "string" || key.length === 0)
+            return fail("configuration-missing");
+        if (key.length < 8 || key.length > 512 || !/^[\x21-\x7E]+$/u.test(key))
+            return fail("configuration-invalid");
+        const deadlineMs = config.deadlineMs ?? 2_500;
+        const maxRetries = config.maxRetries ?? 1;
+        if (!Number.isSafeInteger(deadlineMs) ||
+            deadlineMs < 1 ||
+            deadlineMs > MAX_DEADLINE_MS ||
+            !Number.isSafeInteger(maxRetries) ||
+            maxRetries < 0 ||
+            maxRetries > 1)
+            return fail("configuration-invalid");
+        const input = validateInput(raw, key);
+        if (!input.ok)
+            return fail(input.code);
+        const unavailableConfidence = unavailableJevConfidenceReceiptV1(Object.keys(input.request.questions));
+        const failForInput = (code, info = {}) => fail(code, { confidence: unavailableConfidence, ...info });
+        if (options === undefined)
+            return failForInput("egress-denied");
+        const policyError = egressFailure(options.egress, (input.request.sourceSnippets?.length ?? 0) > 0);
+        if (policyError !== null)
+            return failForInput(policyError);
+        const minConfidence = options.minimumDecisionConfidence ?? 0.65;
+        if (!Number.isFinite(minConfidence) ||
+            minConfidence < 0 ||
+            minConfidence > 1)
+            return failForInput("configuration-invalid");
+        if (options.signal?.aborted)
+            return failForInput("cancelled");
+        const fetchImpl = config.fetchImpl ?? globalThis.fetch;
+        if (typeof fetchImpl !== "function")
+            return failForInput("runtime-unsupported");
+        const http = await requestJevHttpV1({
+            apiKey: key,
+            body: input.body,
+            deadlineMs,
+            maxRetries,
+            fetchImpl,
+            signal: options.signal,
+        });
+        if (!http.ok)
+            return failForInput(http.reasonCode, http.metrics);
+        const confidence = readJevConfidenceReceiptV1(http.payload, input.request.questions);
+        const result = parseSuccess(http.payload, input.request.questions);
+        if (result === null || result.model.includes(key))
+            return failForInput("invalid-response", {
+                ...http.metrics,
+                confidence,
+            });
+        const receiptData = {
+            ...http.metrics,
+            model: result.model,
+            inputTokens: result.inputTokens,
+            outputTokens: result.outputTokens,
+            estimatedInputCostMicrousd: costEstimate(result.inputTokens),
+            confidence,
+        };
+        if (Object.values(result.answers).some((answer) => decisionConfidence(answer) < minConfidence))
+            return failForInput("low-confidence", receiptData);
+        const receipt = Object.freeze({
+            provider: "typesafe-jev",
+            outcome: "answered",
+            reasonCode: null,
+            ...receiptData,
+        });
+        return Object.freeze({
+            status: "answered",
+            answers: result.answers,
+            fallback: null,
+            receipt,
+        });
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/pactile/jev/transport.js.map

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

package/dist/pactile/lifecycle/deferred-live.d.ts

@@ -0,0 +1,17 @@
+export interface DeferredLiveWrite {
+    readonly content: string;
+    readonly executable: boolean;
+    readonly original: Buffer | null;
+    readonly originalMode?: number;
+}
+export declare function clearDeferredLivePlan(root: string): void;
+/** Save a retryable plan before the canonical commit; it remains private runtime state. */
+export declare function prepareDeferredLivePlan(root: string, sourceGenerationId: string, writes: ReadonlyMap<string, DeferredLiveWrite>): void;
+export declare function commitDeferredLivePlan(root: string, generationId: string): void;
+/** Resume only when the recorded canonical generation is still active. */
+export declare function resumeDeferredLivePlan(root: string, activeGenerationId: string | null): boolean;
+/** Capture the project-file bytes that the update plan actually reviewed. */
+export declare function captureDeferredLiveWrite(root: string, relativePath: string, content: string, executable: boolean): DeferredLiveWrite;
+/** Prevalidate the whole batch, then restore prior bytes if any write fails. */
+export declare function applyDeferredLiveWrites(root: string, writes: ReadonlyMap<string, DeferredLiveWrite>): void;
+//# sourceMappingURL=deferred-live.d.ts.map

package/dist/pactile/lifecycle/deferred-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-live.d.ts","sourceRoot":"","sources":["../../../src/pactile/lifecycle/deferred-live.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AA4CD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGxD;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAUtI;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAI/E;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAkB/F;AAsBD,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,iBAAiB,CAMpI;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CA+C1G"}

package/dist/pactile/lifecycle/deferred-live.js

@@ -0,0 +1,173 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { assertCanonicalWriteTarget } from "../runtime/paths.js";
+function pendingPath(root) {
+    return assertCanonicalWriteTarget(root, ".pactile/.runtime/update-deferred-live.json");
+}
+function readPending(root) {
+    const file = pendingPath(root);
+    if (!fs.existsSync(file))
+        return null;
+    const value = JSON.parse(fs.readFileSync(file, "utf8"));
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Invalid pending deferred live update");
+    const plan = value;
+    if (plan.schemaVersion !== 1 || typeof plan.sourceGenerationId !== "string" || !plan.sourceGenerationId
+        || (plan.committedGenerationId !== null && (typeof plan.committedGenerationId !== "string" || !plan.committedGenerationId))
+        || !Array.isArray(plan.writes) || plan.writes.some((entry) => !entry || typeof entry.path !== "string"
+        || typeof entry.content !== "string" || typeof entry.executable !== "boolean"
+        || (entry.original !== null && typeof entry.original !== "string")
+        || (entry.originalMode !== undefined && (!Number.isInteger(entry.originalMode) || entry.originalMode < 0 || entry.originalMode > 0o7777)))) {
+        throw new Error("Invalid pending deferred live update");
+    }
+    if (new Set(plan.writes.map((entry) => entry.path)).size !== plan.writes.length)
+        throw new Error("Invalid pending deferred live update");
+    return plan;
+}
+function writePending(root, plan) {
+    const file = pendingPath(root);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    assertCanonicalWriteTarget(root, file);
+    const temporary = assertCanonicalWriteTarget(root, `${file}.${randomUUID()}.tmp`);
+    try {
+        fs.writeFileSync(temporary, `${JSON.stringify(plan)}\n`, { encoding: "utf8", flag: "wx", mode: 0o600 });
+        fs.renameSync(temporary, file);
+    }
+    finally {
+        if (fs.existsSync(temporary))
+            fs.unlinkSync(temporary);
+    }
+}
+export function clearDeferredLivePlan(root) {
+    const file = pendingPath(root);
+    if (fs.existsSync(file))
+        fs.unlinkSync(file);
+}
+/** Save a retryable plan before the canonical commit; it remains private runtime state. */
+export function prepareDeferredLivePlan(root, sourceGenerationId, writes) {
+    if (!writes.size)
+        return;
+    if (readPending(root))
+        throw new Error("A deferred live update is already pending");
+    const plan = {
+        schemaVersion: 1, sourceGenerationId, committedGenerationId: null,
+        writes: [...writes].map(([relativePath, write]) => ({ path: relativePath, content: write.content,
+            executable: write.executable, original: write.original?.toString("base64") ?? null,
+            ...(write.originalMode !== undefined ? { originalMode: write.originalMode } : {}) })),
+    };
+    writePending(root, plan);
+}
+export function commitDeferredLivePlan(root, generationId) {
+    const plan = readPending(root);
+    if (!plan)
+        return;
+    writePending(root, { ...plan, committedGenerationId: generationId });
+}
+/** Resume only when the recorded canonical generation is still active. */
+export function resumeDeferredLivePlan(root, activeGenerationId) {
+    const plan = readPending(root);
+    if (!plan)
+        return false;
+    if (plan.committedGenerationId === null && plan.sourceGenerationId === activeGenerationId) {
+        clearDeferredLivePlan(root);
+        return false;
+    }
+    if (plan.committedGenerationId === null || plan.committedGenerationId !== activeGenerationId) {
+        throw new Error("Deferred live update needs review: canonical generation changed outside its recorded commit");
+    }
+    const writes = new Map(plan.writes.map((entry) => [entry.path, {
+            content: entry.content, executable: entry.executable,
+            original: entry.original === null ? null : Buffer.from(entry.original, "base64"),
+            ...(entry.originalMode !== undefined ? { originalMode: entry.originalMode } : {}),
+        }]));
+    applyDeferredLiveWrites(root, writes);
+    clearDeferredLivePlan(root);
+    return true;
+}
+function liveTarget(root, relativePath) {
+    if (!relativePath || path.isAbsolute(relativePath) || relativePath.startsWith("/") || relativePath.startsWith("\\")) {
+        throw new Error(`Invalid deferred live path: ${relativePath}`);
+    }
+    const resolvedRoot = path.resolve(root);
+    const target = path.resolve(resolvedRoot, ...relativePath.replaceAll("\\", "/").split("/"));
+    const within = path.relative(resolvedRoot, target);
+    if (!within || within === ".." || within.startsWith(`..${path.sep}`) || path.isAbsolute(within)) {
+        throw new Error(`Deferred live path escapes project: ${relativePath}`);
+    }
+    let cursor = resolvedRoot;
+    for (const segment of within.split(path.sep)) {
+        cursor = path.join(cursor, segment);
+        if (fs.lstatSync(cursor, { throwIfNoEntry: false })?.isSymbolicLink()) {
+            throw new Error(`Deferred live path crosses a symlink: ${relativePath}`);
+        }
+    }
+    return target;
+}
+/** Capture the project-file bytes that the update plan actually reviewed. */
+export function captureDeferredLiveWrite(root, relativePath, content, executable) {
+    const target = liveTarget(root, relativePath);
+    const stat = fs.statSync(target, { throwIfNoEntry: false });
+    if (stat && (!stat.isFile() || stat.nlink !== 1))
+        throw new Error(`Deferred live target is not a standalone file: ${relativePath}`);
+    return { content, executable, original: stat ? fs.readFileSync(target) : null,
+        ...(stat ? { originalMode: stat.mode & 0o7777 } : {}) };
+}
+/** Prevalidate the whole batch, then restore prior bytes if any write fails. */
+export function applyDeferredLiveWrites(root, writes) {
+    const planned = [...writes].map(([relativePath, write]) => {
+        const target = liveTarget(root, relativePath);
+        const stat = fs.statSync(target, { throwIfNoEntry: false });
+        if (stat && (!stat.isFile() || stat.nlink !== 1))
+            throw new Error(`Deferred live target is not a standalone file: ${relativePath}`);
+        const actual = stat ? fs.readFileSync(target) : null;
+        const intended = Buffer.from(write.content);
+        const matches = actual === null ? write.original === null : write.original?.equals(actual) === true;
+        if (!matches && actual?.equals(intended) !== true) {
+            throw new Error(`Deferred live file changed after planning: ${relativePath}`);
+        }
+        return { relativePath, target, write, alreadyApplied: actual?.equals(intended) === true };
+    });
+    const attempted = [];
+    try {
+        for (const entry of planned) {
+            if (entry.alreadyApplied)
+                continue;
+            fs.mkdirSync(path.dirname(entry.target), { recursive: true });
+            attempted.push(entry);
+            fs.writeFileSync(entry.target, entry.write.content);
+            if (entry.write.executable)
+                fs.chmodSync(entry.target, 0o755);
+        }
+    }
+    catch (error) {
+        const rollbackErrors = [];
+        for (const entry of attempted.reverse()) {
+            try {
+                const actual = fs.statSync(entry.target, { throwIfNoEntry: false })?.isFile() ? fs.readFileSync(entry.target) : null;
+                const intended = Buffer.from(entry.write.content);
+                if (actual !== null && !actual.equals(intended)
+                    && entry.write.original?.equals(actual) !== true) {
+                    rollbackErrors.push(`${entry.relativePath}: changed during rollback; preserved current bytes`);
+                    continue;
+                }
+                if (entry.write.original === null) {
+                    if (actual !== null)
+                        fs.unlinkSync(entry.target);
+                }
+                else if (actual?.equals(entry.write.original) !== true) {
+                    fs.writeFileSync(entry.target, entry.write.original);
+                    if (entry.write.originalMode !== undefined)
+                        fs.chmodSync(entry.target, entry.write.originalMode);
+                }
+            }
+            catch (rollbackError) {
+                rollbackErrors.push(`${entry.relativePath}: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`);
+            }
+        }
+        if (rollbackErrors.length)
+            throw new Error(`Deferred live write failed and rollback was incomplete: ${rollbackErrors.join("; ")}`, { cause: error });
+        throw error;
+    }
+}
+//# sourceMappingURL=deferred-live.js.map