@astrosheep/keiyaku 2.9.13 → 4.0.0

package/build/core/audit/facade.js

@@ -1,65 +0,0 @@
-import { createAuditCandidate, disposeAuditCandidate, prepareAuditCandidate, readAuditCandidateDiff } from "./candidate.js";
-import { completeAuditCoordinates, initialCoordinateRace, pinAuditSnapshot, rereadCoordinateRace } from "./coordinates.js";
-import { collectEvidence, resolveAuditVerificationPlan } from "./evidence.js";
-import { collectFindings, emptyRaceReport } from "./report.js";
-import { readinessFromFacts } from "./readiness.js";
-import { effectiveVerification } from "../lifecycle-history.js";
-export async function auditContract(input) {
-    const contractId = input.address.binding.commissionId;
-    const frozenSnapshot = await pinAuditSnapshot({ address: input.address });
-    const contractVerification = effectiveVerification(frozenSnapshot.lifecycle.history.map(({ entry }) => entry));
-    const admission = {
-        frozen: frozenSnapshot,
-        contractVerification,
-    };
-    let frozen;
-    try {
-        frozen = await completeAuditCoordinates({ address: input.address, frozen: admission.frozen });
-    }
-    catch (error) {
-        const fallback = admission.frozen;
-        return emptyRaceReport({ contractId, coordinates: fallback.coordinates, terms: { criteria: fallback.criteria, scope: fallback.scope, appendScope: fallback.appendScope }, detail: error instanceof Error ? error.message : String(error), race: initialCoordinateRace({ frozen: fallback, observed: error instanceof Error ? error.message : String(error) }) });
-    }
-    const candidateResult = await createAuditCandidate({ root: input.address.repo.stableRoot, contractId, frozen });
-    let evidence = null;
-    let verification;
-    let candidatePreparation = { status: "not-required", reason: "candidate_unavailable" };
-    try {
-        let verificationPlan = [];
-        let verificationOverride;
-        if (candidateResult.candidate) {
-            const planResolution = await resolveAuditVerificationPlan({ cwd: candidateResult.cwd, contract: admission.contractVerification });
-            if (planResolution.status === "unknown") {
-                candidatePreparation = { status: "not-required", reason: "verification_plan_unavailable" };
-                verificationOverride = { status: "unknown", cause: planResolution.cause, results: [] };
-            }
-            else {
-                verificationPlan = planResolution.plan;
-                const lifecycleBind = frozen.lifecycle.history.find(({ entry }) => entry.kind === "bind")?.entry;
-                candidatePreparation = await prepareAuditCandidate({ candidateResult, verificationRequired: verificationPlan.length > 0, plan: lifecycleBind?.kind === "bind" && lifecycleBind.data.workspace === "worktree" ? lifecycleBind.data.bootstrap : undefined });
-                if (candidatePreparation.status === "failed") {
-                    verificationOverride = { status: "not_evaluated", reason: "candidate_preparation_failed", results: [] };
-                }
-            }
-        }
-        const diff = await readAuditCandidateDiff(candidateResult);
-        evidence = await collectEvidence({ candidateResult, frozen, diff, diffBudgetBytes: input.diffBudgetBytes ?? 32_000, verificationPlan, signal: input.signal, root: input.address.repo.stableRoot, ...(verificationOverride ? { verificationOverride } : {}) });
-        verification = evidence?.verification ?? verificationOverride ?? { status: "not_evaluated", reason: candidateResult.rehearsal.status === "conflict" ? "renew_conflict" : "renew_unknown", results: [] };
-        await input.afterEvidence?.();
-    }
-    finally {
-        await disposeAuditCandidate(candidateResult);
-    }
-    const race = await rereadCoordinateRace({ cwd: input.cwd, address: input.address, frozen });
-    if (race) {
-        const detail = typeof race.observed === "string"
-            ? `final coordinate reread failed: ${race.observed}`
-            : race.which === "delivery-worktree"
-                ? "delivery worktree bytes or HEAD changed"
-                : `audit coordinates changed while evidence was collected: ${race.which}`;
-        return emptyRaceReport({ contractId, coordinates: frozen.coordinates, terms: { criteria: frozen.criteria, scope: frozen.scope, appendScope: frozen.appendScope }, detail, race });
-    }
-    const readiness = readinessFromFacts(frozen.readiness);
-    const findings = collectFindings({ contractId, deliveryCwd: frozen.deliveryCwd, rehearsal: candidateResult.rehearsal, scope: evidence?.scope ?? null, candidatePreparation, verification, readiness });
-    return { contract: contractId, coordinates: frozen.coordinates, terms: { criteria: frozen.criteria, scope: frozen.scope, appendScope: frozen.appendScope }, rehearsal: candidateResult.rehearsal, candidate: evidence ? (evidence.candidate.rewritten ? { kind: "renew-rehearsal", base: evidence.candidate.base, head: evidence.candidate.head, tree: evidence.candidate.tree, deliveryHead: frozen.coordinates.delivery.head, targetHead: frozen.coordinates.target.head } : { kind: "delivery", base: evidence.candidate.base, head: evidence.candidate.head, tree: evidence.candidate.tree }) : null, diff: evidence?.diff ?? null, presentation: evidence?.presentation ?? null, files: evidence?.files ?? null, scope: evidence?.scope ?? null, candidatePreparation, verification, readiness, findings, counts: { files: evidence?.files.length ?? 0, selected: evidence?.presentation.selected.length ?? 0, omitted: evidence?.presentation.omissions.length ?? 0, inScope: evidence?.scope.filter((row) => row.class === "in-scope").length ?? 0, downgraded: evidence?.scope.filter((row) => row.class === "downgraded").length ?? 0, violated: evidence?.scope.filter((row) => row.class === "violated").length ?? 0, findings: findings.length } };
-}

package/build/core/audit/readiness.js

@@ -1,4 +0,0 @@
-/** Readiness is assembled from the coordinate owner's one frozen read. */
-export function readinessFromFacts(facts) {
-    return facts;
-}

package/build/core/audit/report.js

@@ -1,38 +0,0 @@
-export function collectFindings(input) {
-    const findings = [];
-    const selector = `keiyaku @${input.contractId}`;
-    if (input.rehearsal.status === "clean")
-        findings.push({ code: "BASE_DRIFT", detail: `${input.rehearsal.oldBase} -> ${input.rehearsal.newBase}`, nextCommand: `${selector} renew` });
-    if (input.rehearsal.status === "conflict")
-        findings.push({ code: "RENEW_CONFLICT", detail: input.rehearsal.paths.join(", "), nextCommand: `${selector} renew` });
-    if (input.rehearsal.status === "unknown")
-        findings.push({ code: "RENEW_UNKNOWN", detail: `${input.rehearsal.cause.code}: ${input.rehearsal.cause.message}`, nextCommand: `${selector} audit` });
-    for (const row of input.scope?.filter((item) => item.class === "violated") ?? [])
-        findings.push({ code: "SCOPE_RESIDUE", severity: "warning", detail: `${row.path}: ${row.residue.length} unexplained changes`, nextCommand: `${selector} amend --scope-add ${JSON.stringify(row.path)}` });
-    if (input.candidatePreparation.status === "failed")
-        findings.push({ code: "CANDIDATE_PREPARATION_FAILED", detail: `${input.candidatePreparation.cause.code}: ${input.candidatePreparation.cause.message}`, nextCommand: `${selector} audit` });
-    if (input.verification.status === "evaluated") {
-        for (const result of input.verification.results) {
-            if (result.status === "executed" && result.exitCode !== 0)
-                findings.push({ code: "VERIFICATION_FAILED", detail: `${result.label} exited ${result.exitCode}`, nextCommand: result.command });
-            if (result.status === "runner_failed")
-                findings.push({ code: "VERIFICATION_UNKNOWN", detail: `${result.source} ${result.label}: ${result.cause.code}: ${result.cause.message}`, nextCommand: result.command });
-        }
-    }
-    const residue = input.readiness.deliveryResidue;
-    if (residue.tracked.length + residue.staged.length + residue.unstaged.length + residue.untracked.length > 0)
-        findings.push({ code: "DELIVERY_RESIDUE", detail: `registered delivery worktree has uncommitted residue at ${input.deliveryCwd}`, nextCommand: `git -C ${JSON.stringify(input.deliveryCwd)} status --short` });
-    if (input.readiness.arc.max > 0 && input.readiness.arc.open === null && input.readiness.arc.looseCommits.length > 0)
-        findings.push({ code: "LOOSE_COMMITS", detail: `${input.readiness.arc.looseCommits.length} loose commits after fence`, nextCommand: `printf '# Continue\\n\\n## Objective\\nReceipt loose commits.\\n\\n## Brief\\nContinue delivery.\\n' | ${selector} arc` });
-    if (input.readiness.rewriteGuard.liveProjection)
-        findings.push({ code: "LIVE_REWRITE_GUARD", detail: "a live projection owns the delivery worktree", nextCommand: "keiyaku status" });
-    for (const dependency of input.readiness.dependencies.filter((item) => !item.satisfied))
-        findings.push({ code: "DEPENDENCY_OPEN", detail: `dependency ${dependency.id} is ${dependency.state}`, nextCommand: `keiyaku @${dependency.id} log` });
-    if (input.readiness.petition.state === "petitioned" && input.readiness.petition.queue?.position !== 1)
-        findings.push({ code: "PETITION_QUEUE", detail: `petition queue position ${input.readiness.petition.queue?.position ?? "unknown"}`, nextCommand: "keiyaku status" });
-    return findings;
-}
-export function emptyRaceReport(input) {
-    const findings = [{ code: "COORDINATE_RACE", detail: input.detail, nextCommand: `keiyaku @${input.contractId} audit`, race: input.race }];
-    return { contract: input.contractId, coordinates: input.coordinates, terms: input.terms, rehearsal: { status: "unknown", cause: { code: "COORDINATE_RACE", message: input.detail } }, candidate: null, diff: null, presentation: null, files: null, scope: null, candidatePreparation: { status: "not-required", reason: "coordinate_race" }, verification: { status: "not_evaluated", reason: "coordinate_race", results: [] }, readiness: null, findings, counts: { files: 0, selected: 0, omitted: 0, inScope: 0, downgraded: 0, violated: 0, findings: 1 } };
-}

package/build/core/audit.js

@@ -1 +0,0 @@
-export { auditContract } from "./audit/facade.js";

package/build/core/bind-reconciliation.js

@@ -1,409 +0,0 @@
-import { FlowError } from "../flow-error.js";
-import { access } from "node:fs/promises";
-import { lookupCurrentContract, readRepositoryLifecycle, } from "./repository-ledger/read-model.js";
-import { withContractCarrierSession, withObservedContractCarrierSession } from "./contract-carrier.js";
-import { contractWorktreePathFromStableRoot, findRegisteredContractWorktreePathFromModel } from "./worktree-path.js";
-import { defaultCreateWorktree } from "./bind-workspace.js";
-import { isCommissionId } from "./ids.js";
-import { REPOSITORY_LEDGER_REF, repositoryDeliveryRef } from "./repository-ledger/codec.js";
-import { resolveLocalBranchHead } from "../git/refs.js";
-import { runWorktreeBootstrap, bootstrapEntryDataFromObservation, isBootstrapSuccess } from "./worktree-bootstrap.js";
-import { committedLifecycleFacts, containedCommittedLifecycleFacts, EffectJournal } from "./outcome-base.js";
-/**
- * Repository admission can only recover a bind whose authority remains active.
- * A terminal contract may retain its historical bootstrap disposition, but its
- * projection is addressed recovery work and must not be adopted by another bind.
- */
-export function requiresBindRecovery(lifecycle) {
-    if (lifecycle.phase !== "active")
-        return false;
-    return lifecycle.bootstrapReplay.state === "pending" || lifecycle.bootstrapReplay.state === "failed-interrupted";
-}
-export async function publishBindBootstrap(session, entry, expectedLedgerHead) {
-    return await session.publishAuthoritative({ verb: "bootstrap", admittedLedgerHead: expectedLedgerHead, acceptedLifecycleTail: session.lifecycle.contractHead, entries: [entry] });
-}
-export async function publishBindFailedForfeit(session, entry, delivery, expectedLedgerHead) {
-    return await session.publishAuthoritative({
-        verb: "forfeit",
-        admittedLedgerHead: expectedLedgerHead,
-        acceptedLifecycleTail: session.lifecycle.contractHead,
-        entries: [entry],
-        delivery: {
-            ref: repositoryDeliveryRef(entry.contract),
-            expectedOid: delivery.status === "present" ? delivery.head : null,
-        },
-    });
-}
-function copyAcceptedBindEntry(entry) {
-    const common = {
-        title: entry.data.title,
-        context: entry.data.context,
-        objective: entry.data.objective,
-        design: entry.data.design,
-        scope: [...entry.data.scope],
-        criteria: [...entry.data.criteria],
-        verification: [...entry.data.verification],
-        extensions: entry.data.extensions.map((extension) => ({ title: extension.title, content: extension.content })),
-        base: entry.data.base,
-        target: entry.data.target,
-        ...(entry.data.after ? { after: [...entry.data.after] } : {}),
-        ...(entry.data.taskIds ? { taskIds: [...entry.data.taskIds] } : {}),
-    };
-    return {
-        v: 3,
-        kind: "bind",
-        contract: entry.contract,
-        at: entry.at,
-        actor: entry.actor,
-        data: entry.data.workspace === "worktree"
-            ? {
-                ...common,
-                workspace: "worktree",
-                place: entry.data.place,
-                ...(entry.data.bootstrap ? { bootstrap: { command: [...entry.data.bootstrap.command], timeoutMs: entry.data.bootstrap.timeoutMs } } : {}),
-            }
-            : { ...common, workspace: "here" },
-    };
-}
-function copyAcceptedBootstrapEntry(entry) {
-    return {
-        v: 1,
-        kind: "bootstrap",
-        contract: entry.contract,
-        at: entry.at,
-        actor: entry.actor,
-        data: {
-            result: { ...entry.data.result },
-            durationMs: entry.data.durationMs,
-            ...(entry.data.stderrTail === undefined ? {} : { stderrTail: entry.data.stderrTail }),
-            ...(entry.data.stderrTruncated === undefined ? {} : { stderrTruncated: entry.data.stderrTruncated }),
-        },
-    };
-}
-function bootstrapProgressLine(command) {
-    return `bootstrap » ${command.join(" ")}`;
-}
-function workspaceBindView(entry) {
-    return entry;
-}
-export function committedOrThrow(result, operation) {
-    if (result.family === "committed")
-        return result;
-    const detail = `${result.code}: ${result.cause}`;
-    if (result.family === "indeterminate") {
-        throw new FlowError("INTERNAL_STATE", `${operation}_INDETERMINATE: ${detail}`);
-    }
-    throw new FlowError("CONCURRENT_MODIFICATION", `${operation}_REFUSED: ${detail}`);
-}
-function effectCause(row) {
-    return row.status === "succeeded" ? undefined : row.cause;
-}
-function bindResult(input) {
-    const ledgerHead = input.heads.bindFailedForfeit ?? input.heads.bootstrap ?? input.heads.bind;
-    const reconciliationKey = `${input.coordinates.id}:${input.heads.bind}`;
-    if (input.cause) {
-        return {
-            ledgerHead,
-            heads: input.heads,
-            reconciliationKey,
-            ...containedCommittedLifecycleFacts({
-                head: ledgerHead,
-                entryKind: input.heads.bindFailedForfeit ? "forfeit" : input.heads.bootstrap ? "bootstrap" : "bind",
-                contractId: input.coordinates.id,
-                carrier: input.carrier,
-                cause: input.cause,
-                prerequisites: input.journal.rows("prerequisite"),
-                downstream: input.journal.rows("downstream"),
-            }),
-            replay: {
-                idempotencyKey: reconciliationKey,
-                action: "reconcile",
-                reason: "one or more committed-head effects remain",
-            },
-        };
-    }
-    const lifecycle = committedLifecycleFacts({
-        head: ledgerHead,
-        entryKind: input.heads.bootstrap ? "bootstrap" : "bind",
-        contractId: input.coordinates.id,
-        carrier: input.carrier,
-        prerequisites: input.journal.rows("prerequisite"),
-        downstream: input.journal.rows("downstream"),
-    });
-    return {
-        ...input.coordinates,
-        ledgerHead,
-        heads: input.heads,
-        reconciliationKey,
-        surfaces: bindSurfaceReceipts(input.journal),
-        ...lifecycle,
-        replay: { ...lifecycle.replay, idempotencyKey: reconciliationKey },
-    };
-}
-function bindSurfaceReceipts(journal) {
-    const mapping = new Map([
-        ["task-board-projection", "task-view"],
-        ["registry-projection", "registry"],
-        ["worktree-projection", "worktree"],
-        ["bootstrap-execution", "bootstrap"],
-        ["carrier-projection", "carrier"],
-    ]);
-    const receipts = [];
-    for (const row of journal.rows("downstream")) {
-        const surface = mapping.get(row.effect);
-        if (!surface || row.status !== "succeeded")
-            continue;
-        const raw = row.receipt?.status;
-        const status = raw === "current" || raw === "already-present" || raw === "not-applicable"
-            ? "already-present"
-            : "created";
-        receipts.push({ surface, status });
-    }
-    return receipts;
-}
-export async function reconcileCommittedBindFromSnapshot(input, admittedScopeOverlaps, snapshot) {
-    const result = await withObservedContractCarrierSession({
-        stableRoot: snapshot.stableRoot,
-        contractId: input.contractId,
-        observation: snapshot.observation,
-        signal: input.signal,
-        ...(input.terminalWorkspaceCleanup ? { terminalWorkspaceCleanup: input.terminalWorkspaceCleanup } : {}),
-    }, async (session) => reconcileBindContractLocked({ ...input, cwd: snapshot.stableRoot }, session, admittedScopeOverlaps));
-    if (!("continueAfterFailedBootstrap" in result))
-        return result;
-    return reconcileCommittedBind(input, admittedScopeOverlaps);
-}
-/**
- * Sole replay-only entry for a committed bind. It never allocates identity or
- * reads draft input; every coordinate is reconstructed from the accepted bind.
- */
-export async function reconcileCommittedBind(input, admittedScopeOverlaps) {
-    if (input.signal?.aborted) {
-        throw new FlowError("CARRIER_GATE_CANCELLED", "contract replay cancelled before derived effects");
-    }
-    for (let attempt = 0; attempt < 2; attempt += 1) {
-        const result = await withContractCarrierSession({
-            cwd: input.cwd,
-            contractId: input.contractId,
-            mode: "mutation",
-            signal: input.signal,
-            ...(input.terminalWorkspaceCleanup ? { terminalWorkspaceCleanup: input.terminalWorkspaceCleanup } : {}),
-        }, async (session) => reconcileBindContractLocked({ ...input, cwd: session.stableRoot }, session, admittedScopeOverlaps));
-        if ("continueAfterFailedBootstrap" in result)
-            continue;
-        return result;
-    }
-    throw new FlowError("INTERNAL_STATE", `bind-failed finalization for ${input.contractId} did not settle after bootstrap re-admission`);
-}
-async function reconcileBindContractLocked(input, replaySession, admittedScopeOverlaps) {
-    const stableRoot = replaySession.stableRoot;
-    if (!isCommissionId(input.contractId)) {
-        throw new FlowError("INVALID_TARGET", `bind replay requires a full canonical contract id; got ${input.contractId}`);
-    }
-    const initialRead = replaySession.repository;
-    const outcome = lookupCurrentContract(initialRead, input.contractId);
-    if (outcome.status === "absent")
-        throw new FlowError("CONTRACT_NOT_FOUND", `contract ${input.contractId} not found`);
-    if (outcome.status !== "healthy") {
-        throw new FlowError("INTERNAL_STATE", `contract ${input.contractId} is unavailable (${outcome.status})`);
-    }
-    const bindRow = outcome.model.history.find((row) => row.entry.kind === "bind");
-    if (!bindRow || bindRow.entry.kind !== "bind")
-        throw new FlowError("INTERNAL_STATE", `contract ${input.contractId} has no accepted bind`);
-    const bootstrapRow = outcome.model.history.find((row) => row.entry.kind === "bootstrap");
-    const forfeitRow = outcome.model.history.find((row) => row.entry.kind === "forfeit");
-    const replayingBindFailedTerminal = outcome.model.phase === "forfeited"
-        && bootstrapRow?.entry.kind === "bootstrap"
-        && !isBootstrapSuccess(bootstrapRow.entry.data)
-        && forfeitRow?.entry.kind === "forfeit"
-        && forfeitRow.entry.data.reason === "bind-failed";
-    if (["claimed", "forfeited"].includes(outcome.model.phase) && !replayingBindFailedTerminal) {
-        throw new FlowError("CONTRACT_TERMINAL", `contract ${input.contractId} is terminal (${outcome.model.phase})`);
-    }
-    const entry = copyAcceptedBindEntry(bindRow.entry);
-    const workspace = entry.data.workspace;
-    const branch = `keiyaku/${entry.contract}`;
-    const worktreePath = contractWorktreePathFromStableRoot(stableRoot, entry.contract, workspaceBindView(entry));
-    const targetRoot = workspace === "here" ? stableRoot : worktreePath;
-    const deps = input.dependencies ?? {};
-    const heads = {
-        bind: bindRow.objectId,
-        bootstrap: bootstrapRow?.objectId ?? null,
-        bindFailedForfeit: replayingBindFailedTerminal ? forfeitRow.objectId : null,
-    };
-    const journal = new EffectJournal(`bind:${entry.contract}:${bindRow.objectId}`);
-    journal.record({
-        effect: "ledger-cas",
-        idempotencyKey: `bind:${entry.contract}:${bindRow.objectId}:ledger-cas`,
-        status: "succeeded",
-        receipt: { bindHead: bindRow.objectId, observed: true },
-    });
-    let containedCause;
-    const rememberFailure = (row) => { containedCause ??= effectCause(row); };
-    const scopeOverlaps = [...admittedScopeOverlaps];
-    if (input.preparedTask && input.preparedTaskProjectionSucceeded) {
-        replaySession.journal.beginDerivedReplay();
-        replaySession.journal.record({
-            effect: "task-board-projection",
-            idempotencyKey: `${entry.contract}:${outcome.model.contractHead}:task-board`,
-            status: "succeeded",
-            receipt: { surface: "task-board", status: "created", authoritativeHead: outcome.model.contractHead, facts: { taskCount: input.preparedTask.taskIds.length } },
-        });
-    }
-    const bootstrapPlan = entry.data.workspace === "worktree" ? entry.data.bootstrap : undefined;
-    if (!replayingBindFailedTerminal && bootstrapPlan) {
-        const worktreeReplay = await journal.run({
-            effect: "bootstrap-worktree-prerequisite",
-            run: async () => {
-                const registered = await findRegisteredContractWorktreePathFromModel(stableRoot, outcome.model);
-                if (registered === worktreePath)
-                    return { status: "already-present", path: worktreePath };
-                try {
-                    await access(worktreePath);
-                    throw Object.assign(new Error(`worktree path ${worktreePath} is occupied by an unowned filesystem entry`), {
-                        code: "BIND_WORKTREE_PATH_OCCUPIED",
-                        facts: { path: worktreePath, occupant: "unowned-filesystem-entry" },
-                    });
-                }
-                catch (error) {
-                    if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT")
-                        throw error;
-                }
-                await (input.createWorktree ?? defaultCreateWorktree)({ cwd: stableRoot, id: entry.contract, branch, base: entry.data.base, worktreePath });
-                return { status: "created", path: worktreePath };
-            },
-        });
-        rememberFailure(worktreeReplay);
-    }
-    let bootstrapData = bootstrapRow?.entry.kind === "bootstrap"
-        ? copyAcceptedBootstrapEntry(bootstrapRow.entry)
-        : undefined;
-    let publishedFailedBootstrapThroughSession = false;
-    if (bootstrapPlan) {
-        const locked = lookupCurrentContract(replaySession.repository, entry.contract);
-        if (locked.status !== "healthy")
-            throw new FlowError("INTERNAL_STATE", `contract ${entry.contract} became unavailable during bootstrap replay`);
-        const existingBootstrap = locked.model.history.find((row) => row.entry.kind === "bootstrap")?.entry;
-        bootstrapData = existingBootstrap?.kind === "bootstrap"
-            ? copyAcceptedBootstrapEntry(existingBootstrap)
-            : undefined;
-        if (bootstrapData) {
-            const row = await journal.run({ effect: "bootstrap-execution", run: async () => ({ status: "already-present" }) });
-            rememberFailure(row);
-            const publication = await journal.run({
-                effect: "bootstrap-ledger-cas",
-                dependency: "bootstrap-execution",
-                run: async () => ({ head: heads.bootstrap, status: "already-present" }),
-            });
-            rememberFailure(publication);
-        }
-        else {
-            const execution = await journal.run({
-                effect: "bootstrap-execution",
-                dependency: "bootstrap-worktree-prerequisite",
-                run: async () => {
-                    input.onProgress?.(bootstrapProgressLine(bootstrapPlan.command));
-                    const observation = await (input.bootstrapRunner ?? runWorktreeBootstrap)({ cwd: worktreePath, plan: bootstrapPlan }, input.bootstrapDependencies);
-                    const data = bootstrapEntryDataFromObservation(observation);
-                    bootstrapData = { v: 1, kind: "bootstrap", contract: entry.contract, at: new Date(input.nowMs).toISOString(), actor: input.actor, data };
-                    return { status: "created", result: data.result.kind };
-                },
-            });
-            rememberFailure(execution);
-            const publication = await journal.run({
-                effect: "bootstrap-ledger-cas",
-                dependency: "bootstrap-execution",
-                run: async () => {
-                    const current = await readRepositoryLifecycle(stableRoot);
-                    const written = deps.publishBootstrap
-                        ? await deps.publishBootstrap(bootstrapData, current.observedLedgerHead)
-                        : await publishBindBootstrap(replaySession, bootstrapData, current.observedLedgerHead);
-                    if (written.status !== "committed")
-                        throw new FlowError("CONCURRENT_MODIFICATION", "BIND_BOOTSTRAP_TRANSACTION_REFUSED");
-                    publishedFailedBootstrapThroughSession = !deps.publishBootstrap && !isBootstrapSuccess(bootstrapData.data);
-                    heads.bootstrap = written.head;
-                    return { head: written.head };
-                },
-            });
-            rememberFailure(publication);
-        }
-    }
-    const bootstrapEntry = bootstrapData?.kind === "bootstrap" ? bootstrapData : undefined;
-    if (publishedFailedBootstrapThroughSession)
-        return { continueAfterFailedBootstrap: true };
-    if (bootstrapEntry && !isBootstrapSuccess(bootstrapEntry.data)) {
-        const forfeitPublication = await journal.run({
-            effect: "bind-failed-forfeit-cas",
-            dependency: heads.bootstrap ? "bootstrap-ledger-cas" : undefined,
-            run: async () => {
-                const current = await readRepositoryLifecycle(stableRoot);
-                const currentContract = lookupCurrentContract(current, entry.contract);
-                if (currentContract.status === "healthy" && currentContract.model.phase === "forfeited") {
-                    const existing = currentContract.model.history.find((row) => row.entry.kind === "forfeit");
-                    if (!existing)
-                        throw new FlowError("INTERNAL_STATE", `forfeited contract ${entry.contract} has no accepted terminal entry`);
-                    heads.bindFailedForfeit = existing.objectId;
-                    return { head: existing.objectId, status: "already-present" };
-                }
-                const delivery = await resolveLocalBranchHead(stableRoot, repositoryDeliveryRef(entry.contract));
-                if (!delivery) {
-                    throw new FlowError("INTERNAL_STATE", `contract ${entry.contract} delivery ref is absent before bind-failed forfeit`);
-                }
-                const forfeitEntry = {
-                    v: 2,
-                    kind: "forfeit",
-                    contract: entry.contract,
-                    at: new Date(input.nowMs).toISOString(),
-                    actor: input.actor,
-                    data: { reason: "bind-failed", actor: input.actor, finalHead: delivery.head },
-                };
-                const deliveryState = { status: "present", head: delivery.head };
-                const written = deps.publishBindFailedForfeit
-                    ? await deps.publishBindFailedForfeit(forfeitEntry, deliveryState, current.observedLedgerHead)
-                    : await publishBindFailedForfeit(replaySession, forfeitEntry, deliveryState, current.observedLedgerHead);
-                if (written.status !== "committed")
-                    throw new FlowError("CONCURRENT_MODIFICATION", "BIND_FAILED_FORFEIT_TRANSACTION_REFUSED");
-                heads.bindFailedForfeit = written.head;
-                return { head: written.head, status: "created" };
-            },
-        });
-        rememberFailure(forfeitPublication);
-        const terminalCarrier = await replaySession.replayDerivedState();
-        for (const row of replaySession.journal.all()) {
-            journal.record(row);
-            rememberFailure(row);
-        }
-        return bindResult({
-            coordinates: {
-                id: entry.contract, ref: REPOSITORY_LEDGER_REF, target: entry.data.target,
-                place: workspace === "worktree" ? entry.data.place : null,
-                ...(workspace === "worktree" ? { branch } : {}), worktreePath: targetRoot,
-                workspace, scopeOverlaps,
-            },
-            heads,
-            journal,
-            carrier: terminalCarrier,
-            cause: { code: "BIND_BOOTSTRAP_FAILED", message: `worktree bootstrap failed with ${bootstrapEntry.data.result.kind}` },
-        });
-    }
-    const carrier = await replaySession.replayDerivedState();
-    for (const row of replaySession.journal.all()) {
-        journal.record(row);
-        rememberFailure(row);
-    }
-    return bindResult({
-        coordinates: {
-            id: entry.contract, ref: REPOSITORY_LEDGER_REF, target: entry.data.target,
-            place: workspace === "worktree" ? entry.data.place : null,
-            ...(workspace === "worktree" ? { branch } : {}), worktreePath: targetRoot,
-            workspace, scopeOverlaps,
-        },
-        heads,
-        journal,
-        carrier,
-        ...(containedCause ? { cause: containedCause } : {}),
-    });
-}
-export async function reconcileBindContract(input) {
-    return await reconcileCommittedBind(input, []);
-}

package/build/core/bind-workspace.js

@@ -1,115 +0,0 @@
-import * as fs from "node:fs/promises";
-import { createGit, wrapGitError } from "../git/core.js";
-import { CONTRACT_PLACES } from "./places.js";
-import { lookupCurrentContract, readRepositoryLifecycle } from "./repository-ledger/read-model.js";
-import { contractWorktreePathFromBind } from "./worktree-path.js";
-export async function createContractBranch(cwd, branch, base) {
-    const git = createGit(cwd);
-    try {
-        await git.raw(["branch", branch, base]);
-    }
-    catch (error) {
-        throw wrapGitError(`branch ${branch} ${base}`, error, cwd);
-    }
-}
-export async function defaultCreateWorktree(input) {
-    void input.id;
-    void input.base;
-    const git = createGit(input.cwd);
-    try {
-        await git.raw(["worktree", "add", input.worktreePath, input.branch]);
-    }
-    catch (error) {
-        throw wrapGitError(`worktree add ${input.worktreePath} ${input.branch}`, error, input.cwd);
-    }
-}
-export async function resolveTreeRoot(cwd, workspace, contractId, bind) {
-    const repoRoot = await fs.realpath(cwd);
-    if (workspace === "here")
-        return repoRoot;
-    return await contractWorktreePathFromBind(repoRoot, contractId, bind);
-}
-async function removeWorktree(cwd, worktreePath) {
-    const git = createGit(cwd);
-    try {
-        await git.raw(["worktree", "remove", "--force", worktreePath]);
-    }
-    catch (error) {
-        throw wrapGitError(`worktree remove ${worktreePath}`, error, cwd);
-    }
-}
-async function deleteBranch(cwd, branch) {
-    const git = createGit(cwd);
-    try {
-        await git.raw(["branch", "-D", branch]);
-    }
-    catch (error) {
-        throw wrapGitError(`branch -D ${branch}`, error, cwd);
-    }
-}
-/** Best-effort cleanup of resources created by the current bind attempt. */
-export async function cleanupCreatedBindResources(cwd, resources) {
-    const failures = [];
-    if (resources.keiyakuPath) {
-        try {
-            await fs.rm(resources.keiyakuPath, { force: true });
-        }
-        catch (error) {
-            failures.push(`delete ${resources.keiyakuPath}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    if (resources.worktreePath) {
-        try {
-            await removeWorktree(cwd, resources.worktreePath);
-        }
-        catch (error) {
-            failures.push(`remove worktree: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    if (resources.branch) {
-        try {
-            await deleteBranch(cwd, resources.branch);
-        }
-        catch (error) {
-            failures.push(`delete branch: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    return failures;
-}
-function occupiedWorktreePlaces(read) {
-    const occupied = new Set();
-    for (const model of read.contracts) {
-        if (lookupCurrentContract(read, model.contract).status !== "healthy")
-            continue;
-        const worktree = model.resources.worktree;
-        if (worktree?.state === "held")
-            occupied.add(worktree.place);
-    }
-    return occupied;
-}
-function randomIndex(randomBytes, size) {
-    let value = 0;
-    for (const byte of randomBytes) {
-        value = (value * 256 + byte) % size;
-    }
-    return value;
-}
-function nextGenerationPlace(base, occupied) {
-    for (let generation = 2;; generation += 1) {
-        const candidate = `${base}${generation}`;
-        if (!occupied.has(candidate))
-            return candidate;
-    }
-}
-export async function allocateWorktreePlace(cwd, randomBytes) {
-    return allocateWorktreePlaceFromRead(await readRepositoryLifecycle(cwd), randomBytes);
-}
-export function allocateWorktreePlaceFromRead(read, randomBytes) {
-    const occupied = occupiedWorktreePlaces(read);
-    const candidates = CONTRACT_PLACES.filter((place) => !occupied.has(place));
-    if (candidates.length > 0) {
-        return candidates[randomIndex(randomBytes, candidates.length)];
-    }
-    const base = CONTRACT_PLACES[randomIndex(randomBytes, CONTRACT_PLACES.length)];
-    return nextGenerationPlace(base, occupied);
-}