@astrosheep/keiyaku 2.9.13 → 4.0.1

package/build/cli/commands/contract/bind/meta.js

@@ -1,96 +0,0 @@
-export const meta = {
-    command: "bind",
-    summary: "Create a contract ledger and workspace files",
-    usage: [
-        "keiyaku @<full-contract-id> bind [-C|--cwd DIR] [--repo DIR]",
-        "keiyaku bind --contract <full-contract-id> [-C|--cwd DIR] [--repo DIR]",
-        "keiyaku bind [-C|--cwd DIR] [--repo DIR] [--task ID]... [- < contract.md]",
-        "keiyaku bind [-C|--cwd DIR] [--repo DIR] [--task ID]... --title TEXT --context TEXT --objective TEXT --design TEXT --scope GLOB [--scope GLOB]... --criteria CRITERION [--verification DECLARATION] [--dry-run]",
-    ],
-    stdin: { mode: "document", selector: { kind: "positional", index: 0, required: false, rejectBlank: false } },
-    flags: ["cwd", "repo", "contract", "after", "exclusive", "draft-only", "title", "context", "objective", "design", "scope", "criteria", "verification", "task", "dry-run"],
-    // contract and place are parseable only so the mouth can reject them with bind-specific copy.
-    parseFlags: ["cwd", "repo", "contract", "after", "exclusive", "draft-only", "place", "title", "context", "objective", "design", "scope", "criteria", "verification", "task", "dry-run"],
-    purpose: "Bind a Keiyaku from contract Markdown selected by literal -.",
-    input: [
-        "# <title>",
-        "",
-        "## Context",
-        "<established facts and constraints>",
-        "",
-        "## Objective",
-        "<what the commission should accomplish>",
-        "",
-        "## Design & Approach",
-        "<settled blueprint>",
-        "",
-        "## Scope",
-        "~~~",
-        "<pattern>",
-        "<another-pattern>",
-        "~~~",
-        "",
-        "## Criteria",
-        "- <declarative acceptance criterion>",
-        "",
-        "## Verification",
-        "- <executable declaration>",
-    ],
-    notes: [
-        "Bare bind creates a distinct contract. Addressed bind accepts only a full contract ID and replays its committed derived surfaces.",
-        "Primary document form is literal - followed by Markdown on stdin (full document below).",
-        "With --task, task title and body supply title/objective defaults; literal - or domain flags may send only the missing sections and any present section overrides the task default.",
-        "Domain flags remain available as a partial-document alternative; they cannot mix with Markdown selected by literal -.",
-        "Verification is optional; omit it when the contract has no executable testimony declarations.",
-    ],
-    examples: [
-        [
-            "keiyaku bind - <<'KEIYAKU'",
-            "# <title>",
-            "",
-            "## Context",
-            "<established facts and constraints>",
-            "",
-            "## Objective",
-            "<what the commission should accomplish>",
-            "",
-            "## Design & Approach",
-            "<settled blueprint>",
-            "",
-            "## Scope",
-            "~~~",
-            "<pattern>",
-            "<another-pattern>",
-            "~~~",
-            "",
-            "## Criteria",
-            "- <declarative acceptance criterion>",
-            "",
-            "## Verification",
-            "- <executable declaration>",
-            "KEIYAKU",
-        ].join("\n"),
-        [
-            "keiyaku bind --task fix-flaky-pump - <<'KEIYAKU'",
-            "## Context",
-            "<established facts and constraints>",
-            "",
-            "## Design & Approach",
-            "<settled blueprint>",
-            "",
-            "## Scope",
-            "~~~",
-            "<pattern>",
-            "<another-pattern>",
-            "~~~",
-            "",
-            "## Criteria",
-            "- <declarative acceptance criterion>",
-            "",
-            "## Verification",
-            "- <executable declaration>",
-            "KEIYAKU",
-        ].join("\n"),
-    ],
-    completionRank: 0,
-};

package/build/cli/commands/contract/catalog.js

@@ -1,18 +0,0 @@
-import { meta as bindMeta } from "./bind/meta.js";
-import { meta as arcMeta } from "./arc/meta.js";
-import { meta as logMeta } from "./log/meta.js";
-import { meta as amendMeta } from "./amend/meta.js";
-import { meta as auditMeta } from "./audit/meta.js";
-import { meta as renewMeta } from "./renew/meta.js";
-import { meta as petitionMeta } from "./petition/meta.js";
-import { meta as forfeitMeta } from "./forfeit/meta.js";
-export const contractCatalog = [
-    { meta: bindMeta, load: () => import("./bind/handler.js") },
-    { meta: arcMeta, load: () => import("./arc/handler.js") },
-    { meta: logMeta, load: () => import("./log/handler.js") },
-    { meta: amendMeta, load: () => import("./amend/handler.js") },
-    { meta: auditMeta, load: () => import("./audit/handler.js") },
-    { meta: renewMeta, load: () => import("./renew/handler.js") },
-    { meta: petitionMeta, load: () => import("./petition/handler.js") },
-    { meta: forfeitMeta, load: () => import("./forfeit/handler.js") },
-];

package/build/cli/commands/contract/forfeit/handler.js

@@ -1,17 +0,0 @@
-import { resolveExistingContractAddress, withResolvedAddress } from "../../../../core/addressing.js";
-import { defaultActorClock } from "../../../../core/outcome-base.js";
-import { forfeitContractCommand } from "../../../../core/forfeit.js";
-import { buildForfeitResponse } from "../../../render/shared.js";
-import { buildLifecycleOutcomeResponse } from "../../../render/lifecycle.js";
-import { isCompleteLifecycleOutcome } from "../../../../core/outcome-base.js";
-import { effectiveDirectory, repositoryDirectory } from "../../shared.js";
-export const handler = async (_stdin, flags, signal) => {
-    const cwd = await repositoryDirectory(flags, "forfeit");
-    const address = await resolveExistingContractAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
-    return await withResolvedAddress(address, async () => {
-        const result = await forfeitContractCommand({ cwd, contractId: address.binding.commissionId, ...defaultActorClock(), note: flags.reason, signal });
-        if (!isCompleteLifecycleOutcome(result))
-            return buildLifecycleOutcomeResponse(result, { cwd, address });
-        return buildForfeitResponse({ ...result, address, cleanup: result.cleanup });
-    });
-};

package/build/cli/commands/contract/forfeit/meta.js

@@ -1,12 +0,0 @@
-export const meta = {
-    command: "forfeit",
-    summary: "Forfeit an addressed contract",
-    usage: [
-        "keiyaku forfeit [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--reason TEXT]",
-        "keiyaku @addr forfeit [-C|--cwd DIR] [--repo DIR] [--reason TEXT]",
-    ],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "contract", "reason"],
-    purpose: "Record an abandoned contract without sealing it.",
-    completionRank: 11,
-};

package/build/cli/commands/contract/log/handler.js

@@ -1,12 +0,0 @@
-import { resolveExistingContractAddress, withResolvedAddress } from "../../../../core/addressing.js";
-import { readContractLog } from "../../../../core/log.js";
-import { buildLogResponse } from "../../../render/misc.js";
-import { effectiveDirectory, repositoryDirectory } from "../../shared.js";
-export const handler = async (_stdin, flags, signal) => {
-    const cwd = await repositoryDirectory(flags, "log");
-    const address = await resolveExistingContractAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
-    return await withResolvedAddress(address, async () => {
-        const result = await readContractLog({ cwd, contractId: address.binding.commissionId, signal });
-        return buildLogResponse({ ...result, address });
-    });
-};

package/build/cli/commands/contract/log/meta.js

@@ -1,12 +0,0 @@
-export const meta = {
-    command: "log",
-    summary: "Render a contract ledger",
-    usage: [
-        "keiyaku log [-C|--cwd DIR] [--repo DIR] [--contract ADDR]",
-        "keiyaku @addr log [-C|--cwd DIR] [--repo DIR]",
-    ],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "contract"],
-    purpose: "Read a contract ledger.",
-    completionRank: 5,
-};

package/build/cli/commands/contract/petition/handler.js

@@ -1,64 +0,0 @@
-import { FlowError } from "../../../../flow-error.js";
-import { resolveExistingContractAddress, withResolvedAddress } from "../../../../core/addressing.js";
-import { buildPetitionClaimInput, petitionKeiyaku, previewPetition, reconcilePetitionRetry, } from "../../../../core/settlement/index.js";
-import { renewKeiyaku } from "../../../../core/renew.js";
-import { buildPetitionClaimResponse, buildPetitionPreviewResponse, renderPetitionRetryConsequence, renderPetitionRenewedConsequence, } from "../../../render/petition.js";
-import { writeCliOutput } from "../../../output-stream-error-policy.js";
-import { buildLifecycleOutcomeResponse } from "../../../render/lifecycle.js";
-import { isCompleteLifecycleOutcome } from "../../../../core/outcome-base.js";
-import { effectiveDirectory, repositoryDirectory } from "../../shared.js";
-export const handler = async (stdin, flags, signal) => {
-    if (flags.json && !flags.dryRun) {
-        throw new FlowError("EMPTY_PARAM", "petition --json requires --dry-run");
-    }
-    if (flags.renewBeforePetition && flags.dryRun) {
-        throw new FlowError("EMPTY_PARAM", "petition --renew cannot be used with --dry-run");
-    }
-    const cwd = await repositoryDirectory(flags, "petition");
-    const address = await resolveExistingContractAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
-    return await withResolvedAddress(address, async () => {
-        if (flags.dryRun) {
-            const input = buildPetitionClaimInput({ cwd, contractId: address.binding.commissionId, stdin, signal, appendScope: flags.appendScope });
-            return buildPetitionPreviewResponse(await previewPetition({
-                cwd,
-                contractId: address.binding.commissionId,
-                oath: input.oath,
-                appendScope: input.appendScope,
-                signal,
-            }), flags.json === true);
-        }
-        const retry = await reconcilePetitionRetry({
-            cwd,
-            contractId: address.binding.commissionId,
-            signal,
-        });
-        if (retry.status === "verdict") {
-            if (!isCompleteLifecycleOutcome(retry.verdict)) {
-                return buildLifecycleOutcomeResponse(retry.verdict, { cwd, address });
-            }
-            if (retry.result === "rejected") {
-                await writeCliOutput(process.stdout, `${renderPetitionRetryConsequence(retry.reason)}\n`);
-            }
-        }
-        const resumesApprovedClaim = retry.status === "approved-awaiting-claim"
-            || (retry.status === "verdict" && retry.result === "approved");
-        const renewed = flags.renewBeforePetition && !resumesApprovedClaim
-            ? await renewKeiyaku({ cwd, address, appendScope: flags.appendScope, signal })
-            : undefined;
-        const alreadyFresh = renewed?.family === "refused-before-effects"
-            && renewed.failedInvariant.code === "NO_LIFECYCLE_CHANGE";
-        if (renewed && renewed.family !== "committed" && !alreadyFresh)
-            return buildLifecycleOutcomeResponse(renewed, { cwd, address });
-        if (renewed && renewed.family === "committed" && !isCompleteLifecycleOutcome(renewed))
-            return buildLifecycleOutcomeResponse(renewed, { cwd, address });
-        if (renewed && isCompleteLifecycleOutcome(renewed) && !renewed.alreadyFresh) {
-            await writeCliOutput(process.stdout, `${renderPetitionRenewedConsequence(renewed)}\n`);
-        }
-        const input = buildPetitionClaimInput({ cwd, contractId: address.binding.commissionId, stdin, signal, appendScope: flags.appendScope });
-        const petitionInput = renewed && isCompleteLifecycleOutcome(renewed) ? { ...input, appendScope: undefined } : input;
-        const result = await petitionKeiyaku(petitionInput);
-        return isCompleteLifecycleOutcome(result) && "status" in result
-            ? buildPetitionClaimResponse({ ...result, address }, input)
-            : buildLifecycleOutcomeResponse(result, { cwd, address });
-    });
-};

package/build/cli/commands/contract/petition/meta.js

@@ -1,23 +0,0 @@
-export const meta = {
-    command: "petition",
-    summary: "Settle or preview settlement for a contract",
-    usage: [
-        "keiyaku petition [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--renew] [--append-scope PATTERN] [- < petition.md]",
-        "keiyaku @<id> petition [-C|--cwd DIR] [--repo DIR] [--renew] [--append-scope PATTERN] [- < petition.md]",
-        "keiyaku @<id> petition --dry-run [--json] [- < petition.md]",
-    ],
-    stdin: { mode: "document", selector: { kind: "positional", index: 0, required: false, rejectBlank: false } },
-    flags: ["cwd", "repo", "contract", "renew", "append-scope", "dry-run", "json"],
-    purpose: "Seal the current delivery stage and run settlement checks before claiming the contract; dry-run previews deterministic checks without changing the contract.",
-    input: [
-        "## Oath",
-        "<free first-person attestation>",
-    ],
-    notes: [
-        "Petition stdin is optional and read only when literal - is supplied; a missing, empty, or blank oath is rejected by the settlement gate with OATH_MISSING.",
-        "The machine checks only that the oath is present. Accepted oath text is persisted in the petition entry and hidden from the reviewer.",
-        "Use --renew to run ordinary renew before petition; renew failures stop the command before settlement.",
-        "Dry-run never runs verification or review and exits 0, 1, or 2.",
-    ],
-    completionRank: 10,
-};

package/build/cli/commands/contract/renew/handler.js

@@ -1,65 +0,0 @@
-import { resolveContractAddress, resolveExistingContractAddress } from "../../../../core/addressing.js";
-import { abortRenewKeiyaku, continueRenewKeiyaku, renewKeiyaku } from "../../../../core/renew.js";
-import { buildRenewAbortResponse, buildRenewResponse } from "../../../render/arc.js";
-import { renderLifecycleResult } from "../../../render/lifecycle.js";
-import { buildAuditConstructionFailure } from "../../../render/audit.js";
-import { isCompleteLifecycleOutcome } from "../../../../core/outcome-base.js";
-import { writeCliOutput } from "../../../output-stream-error-policy.js";
-import { assertAuditPresentationOptions, runAuditCommand } from "../audit/handler.js";
-import { FlowError } from "../../../../flow-error.js";
-import { effectiveDirectory, repositoryDirectory } from "../../shared.js";
-export const handler = async (_stdin, flags, signal) => {
-    if (flags.renewAbort && flags.renewAudit) {
-        throw new FlowError("INVALID_USAGE", "renew --audit cannot be used with --abort");
-    }
-    if (flags.auditSkipDiffBody && !flags.renewAudit) {
-        throw new FlowError("INVALID_USAGE", "renew --skip-diff-body requires --audit");
-    }
-    if (flags.renewAudit) {
-        assertAuditPresentationOptions({
-            diffBudgetBytes: flags.auditDiffBudgetBytes,
-            skipDiffBody: flags.auditSkipDiffBody,
-            json: flags.json,
-        });
-    }
-    const cwd = await repositoryDirectory(flags, "renew");
-    const resolveAddress = flags.renewContinue || flags.renewAbort
-        ? resolveContractAddress
-        : resolveExistingContractAddress;
-    const address = await resolveAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
-    if (flags.renewContinue) {
-        const result = await continueRenewKeiyaku({ cwd, address, appendScope: flags.appendScope, signal });
-        if (!flags.renewAudit || !isCompleteLifecycleOutcome(result)) {
-            return renderLifecycleResult(Promise.resolve(result), buildRenewResponse, { cwd, address });
-        }
-        return renderRenewThenAudit({ cwd, address, result, flags, signal });
-    }
-    if (flags.renewAbort) {
-        return renderLifecycleResult(abortRenewKeiyaku({ cwd, address, signal }), buildRenewAbortResponse, { cwd, address });
-    }
-    const result = await renewKeiyaku({
-        cwd,
-        address,
-        appendScope: flags.appendScope,
-        signal,
-    });
-    if (!flags.renewAudit || !isCompleteLifecycleOutcome(result)) {
-        return renderLifecycleResult(Promise.resolve(result), buildRenewResponse, { cwd, address });
-    }
-    return renderRenewThenAudit({ cwd, address, result, flags, signal });
-};
-async function renderRenewThenAudit({ cwd, address, result, flags, signal, }) {
-    await writeCliOutput(process.stdout, `${buildRenewResponse(result).text}\n\n`);
-    try {
-        return await runAuditCommand({
-            cwd,
-            address,
-            diffBudgetBytes: flags.auditDiffBudgetBytes,
-            skipDiffBody: flags.auditSkipDiffBody,
-            signal,
-        });
-    }
-    catch (error) {
-        return buildAuditConstructionFailure(error, false);
-    }
-}

package/build/cli/commands/contract/renew/meta.js

@@ -1,19 +0,0 @@
-export const meta = {
-    command: "renew",
-    summary: "Rewrite delivery onto the current base",
-    usage: [
-        "keiyaku renew [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--append-scope PATTERN] [--audit [--skip-diff-body]]",
-        "keiyaku @<id> renew --continue [--append-scope PATTERN] [--audit [--skip-diff-body]]",
-        "keiyaku @<id> renew --abort",
-    ],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "contract", "append-scope", "continue", "abort", "audit", "skip-diff-body"],
-    purpose: "Refresh committed contract changes onto the current target, then seal the refreshed delivery stage and record the renewal.",
-    notes: [
-        "After an explicit arc closes, refuses loose commits until another arc is open.",
-        "Refuses while an Akuma is in flight.",
-        "Conflicts create derived scratch without changing the ledger, delivery branch, or worktree; resolve that scratch with --continue or discard it with --abort.",
-        "--audit runs the ordinary read-only audit only after renew completes or reports already fresh; --skip-diff-body is available only with --audit.",
-    ],
-    completionRank: 9,
-};

package/build/cli/commands/metadata.js

@@ -1,68 +0,0 @@
-import { meta as bindMeta } from "./contract/bind/meta.js";
-import { meta as arcMeta } from "./contract/arc/meta.js";
-import { meta as callMeta } from "./projection/call/meta.js";
-import { meta as forkMeta } from "./projection/fork/meta.js";
-import { meta as waitMeta } from "./projection/wait/meta.js";
-import { meta as tellMeta } from "./projection/tell/meta.js";
-import { meta as killMeta } from "./projection/kill/meta.js";
-import { meta as logMeta } from "./contract/log/meta.js";
-import { meta as akumaMeta } from "./akuma/akuma/meta.js";
-import { meta as akumaListMeta } from "./akuma/list/meta-list.js";
-import { meta as akumaLsMeta } from "./akuma/list/meta-ls.js";
-import { meta as akumaShowMeta } from "./akuma/show/meta.js";
-import { meta as skillsMeta } from "./skills/skills/meta.js";
-import { meta as skillsInstallMeta } from "./skills/install/meta.js";
-import { meta as amendMeta } from "./contract/amend/meta.js";
-import { meta as auditMeta } from "./contract/audit/meta.js";
-import { meta as renewMeta } from "./contract/renew/meta.js";
-import { meta as petitionMeta } from "./contract/petition/meta.js";
-import { meta as forfeitMeta } from "./contract/forfeit/meta.js";
-import { meta as verificationMeta } from "./verification/meta.js";
-import { meta as guideMeta } from "./system/guide/meta.js";
-import { meta as completionMeta } from "./system/completion/meta.js";
-import { meta as statusMeta } from "./projection/status/meta.js";
-import { meta as historyMeta } from "./projection/history/meta.js";
-import { meta as taskMeta } from "./task/task/meta.js";
-import { meta as taskAddMeta } from "./task/add/meta.js";
-import { meta as taskComposeMeta } from "./task/compose/meta.js";
-import { meta as taskShowMeta } from "./task/show/meta.js";
-import { meta as taskLsMeta } from "./task/ls/meta.js";
-import { meta as taskLogMeta } from "./task/log/meta.js";
-import { meta as taskStartMeta } from "./task/start/meta.js";
-import { meta as taskStopMeta } from "./task/stop/meta.js";
-import { meta as taskHoldMeta } from "./task/hold/meta.js";
-import { meta as taskResumeMeta } from "./task/resume/meta.js";
-import { meta as taskDoneMeta } from "./task/done/meta.js";
-import { meta as taskNoteMeta } from "./task/note/meta.js";
-import { meta as taskDropMeta } from "./task/drop/meta.js";
-import { meta as taskUpdateMeta } from "./task/update/meta.js";
-import { meta as taskDoctorMeta } from "./task/doctor/meta.js";
-import { meta as dumpEnvMeta } from "./system/dump-env/meta.js";
-export const COMMAND_METADATA_ORDER = [
-    "bind", "arc", "call", "fork", "wait", "tell", "kill", "log",
-    "akuma", "akuma list", "akuma ls", "akuma show", "skills", "skills install", "amend", "audit",
-    "renew", "petition", "forfeit", "verification", "guide", "completion", "status", "history", "task",
-    "task add", "task compose", "task show", "task ls", "task log", "task start", "task stop", "task hold", "task resume", "task done", "task note",
-    "task drop", "task update", "task doctor", "dump-env",
-];
-const COMMAND_METADATA = [
-    bindMeta, arcMeta, callMeta, forkMeta, waitMeta, tellMeta, killMeta, logMeta,
-    akumaMeta, akumaListMeta, akumaLsMeta, akumaShowMeta, skillsMeta, skillsInstallMeta, amendMeta, auditMeta,
-    renewMeta, petitionMeta, forfeitMeta, verificationMeta, guideMeta, completionMeta, statusMeta, historyMeta,
-    taskMeta, taskAddMeta, taskComposeMeta, taskShowMeta, taskLsMeta, taskLogMeta, taskStartMeta, taskStopMeta,
-    taskHoldMeta, taskResumeMeta,
-    taskDoneMeta, taskNoteMeta, taskDropMeta, taskUpdateMeta, taskDoctorMeta, dumpEnvMeta,
-];
-export const CLI_COMMAND_METADATA = Object.fromEntries(COMMAND_METADATA.map((meta) => [meta.command, meta]));
-export function getCommandMetadata(command) {
-    return CLI_COMMAND_METADATA[command];
-}
-export function allCommandMetadata() {
-    return COMMAND_METADATA_ORDER.map((command) => CLI_COMMAND_METADATA[command]);
-}
-export function commandParseOrder() {
-    return [...COMMAND_METADATA_ORDER].sort((a, b) => {
-        const tokenDelta = b.split(" ").length - a.split(" ").length;
-        return tokenDelta !== 0 ? tokenDelta : COMMAND_METADATA_ORDER.indexOf(a) - COMMAND_METADATA_ORDER.indexOf(b);
-    });
-}

package/build/cli/commands/projection/call/handler.js

@@ -1,43 +0,0 @@
-import { runCallAndPersist } from "../../../../core/call-persist.js";
-import { projectionDir } from "../../../../core/projection/index.js";
-import { waitForProjection } from "../../../../core/projection/index.js";
-import { buildCallResponse, renderAdoptedLaunchReceipt } from "../../../render/call.js";
-import { buildWaitResponse } from "../../../render/wait.js";
-import { buildCallInput } from "../../shared.js";
-export const handler = async (stdin, flags, signal) => {
-    const outcome = await runCallAndPersist({
-        ...buildCallInput(stdin, flags, "call"),
-        // Bounded outer join: same durable launch/adoption as detach, without core's unbounded join.
-        ...(flags.timeoutMs !== undefined ? { detach: true } : {}),
-        signal,
-        ...(!flags.json && !flags.detach
-            ? {
-                onLaunch: ({ address, projection, akumaName }) => {
-                    process.stdout.write(`${renderAdoptedLaunchReceipt(address, projection.id, projection.alias, projection.previousAliasTarget, akumaName)}\n`);
-                },
-            }
-            : {}),
-    });
-    if (flags.timeoutMs !== undefined) {
-        const projection = outcome.result.projection;
-        if (!projection)
-            throw new Error("call --wait requires projection facts after launch");
-        const projectionRoot = outcome.result.address.repo.kind === "repository"
-            ? outcome.result.address.repo.stableRoot
-            : flags.cwd ?? process.cwd();
-        const projectionDirectory = await projectionDir(projectionRoot, projection.id);
-        return buildWaitResponse(projection.id, await waitForProjection({
-            projectionDirectory,
-            timeoutMs: flags.timeoutMs,
-            signal,
-        }), { alias: projection.alias });
-    }
-    if (outcome.result.foregroundWait && outcome.result.projection) {
-        return buildWaitResponse(outcome.result.projection.id, outcome.result.foregroundWait, { alias: outcome.result.projection.alias });
-    }
-    return buildCallResponse(outcome.result, {
-        responsePath: outcome.responsePath,
-        artifactId: outcome.artifactId,
-        addressPlacement: flags.detach ? "stdout" : "none",
-    });
-};

package/build/cli/commands/projection/call/meta.js

@@ -1,12 +0,0 @@
-export const meta = {
-    command: "call",
-    summary: "Start an Akuma helper session",
-    usage: ["keiyaku call NAME [-d|--detach] [--wait DURATION] <BODY|->"],
-    stdin: {
-        mode: "argument",
-        selector: { kind: "positional", index: 0, required: true, rejectBlank: true },
-    },
-    flags: ["cwd", "repo", "contract", "akuma", "model", "effort", "incognito", "bare", "detach", "alias", "wait", "json"],
-    purpose: "Run a scoped helper task.",
-    completionRank: 2,
-};

package/build/cli/commands/projection/catalog.js

@@ -1,16 +0,0 @@
-import { meta as callMeta } from "./call/meta.js";
-import { meta as forkMeta } from "./fork/meta.js";
-import { meta as waitMeta } from "./wait/meta.js";
-import { meta as tellMeta } from "./tell/meta.js";
-import { meta as killMeta } from "./kill/meta.js";
-import { meta as statusMeta } from "./status/meta.js";
-import { meta as historyMeta } from "./history/meta.js";
-export const projectionCatalog = [
-    { meta: callMeta, load: () => import("./call/handler.js") },
-    { meta: forkMeta, load: () => import("./fork/handler.js") },
-    { meta: waitMeta, load: () => import("./wait/handler.js") },
-    { meta: tellMeta, load: () => import("./tell/handler.js") },
-    { meta: killMeta, load: () => import("./kill/handler.js") },
-    { meta: statusMeta, load: () => import("./status/handler.js") },
-    { meta: historyMeta, load: () => import("./history/handler.js") },
-];

package/build/cli/commands/projection/fork/handler.js

@@ -1,61 +0,0 @@
-import * as fs from "node:fs/promises";
-import { FlowError } from "../../../../flow-error.js";
-import { buildArtifactResolutionAttempt, } from "../../../../core/addressing.js";
-import { runCallAndPersist } from "../../../../core/call-persist.js";
-import { locateResponseArtifact, reconcileResponseArtifactCatalog, } from "../../../../core/transcripts.js";
-import { resolveProjectionHistoryAddress } from "../../../../core/projection/index.js";
-import { observeGitRepository } from "../../../../git/branches.js";
-import { stableRepoRoot } from "../../../../core/worktree-path.js";
-import { buildCallResponse } from "../../../render/call.js";
-import { buildCallInput, effectiveDirectory, forkPrompt, projectDirectory } from "../../shared.js";
-export const handler = async (stdin, flags, signal, positional) => {
-    const cwd = effectiveDirectory(flags);
-    const artifactCwd = await projectDirectory(flags, "fork");
-    const artifactId = positional[0];
-    const repository = await observeGitRepository(artifactCwd);
-    if (repository.capability === "unknown")
-        throw repository.error;
-    const isRepo = repository.capability === "available" && repository.coordinate === "repository";
-    const responseStoreCwd = isRepo ? await stableRepoRoot(artifactCwd) : await fs.realpath(artifactCwd);
-    try {
-        await reconcileResponseArtifactCatalog(responseStoreCwd);
-    }
-    catch {
-        // The catalog is disposable and cannot make an otherwise valid fork fail.
-    }
-    const artifact = await locateResponseArtifact({
-        cwd: responseStoreCwd,
-        artifactId,
-        attempt: buildArtifactResolutionAttempt({
-            repo: isRepo
-                ? { kind: "repository", stableRoot: responseStoreCwd }
-                : { kind: "user" },
-            workdir: cwd,
-            supplied: artifactId,
-            inference: ["response artifact identity lookup"],
-        }),
-    });
-    const sourceProjectionId = await resolveProjectionHistoryAddress(responseStoreCwd, artifactId);
-    let executionCwd;
-    let repo;
-    if (artifact.provenance.authority.kind === "repository") {
-        executionCwd = artifact.storageRoot;
-        repo = flags.repo ? responseStoreCwd : undefined;
-    }
-    else {
-        if (!("workdir" in artifact.provenance.evidence)) {
-            throw new FlowError("INVALID_RESPONSE_PATH", `Invalid response artifact '${artifactId}': field 'provenance.evidence.workdir' is missing.`);
-        }
-        executionCwd = artifact.provenance.evidence.workdir;
-        repo = undefined;
-    }
-    const outcome = await runCallAndPersist({
-        ...buildCallInput(forkPrompt(stdin), { ...flags, cwd: executionCwd, repo }, "revive"),
-        reviveArtifact: artifact,
-        signal,
-    });
-    return buildCallResponse({
-        ...outcome.result,
-        ...(sourceProjectionId ? { sourceProjectionId } : {}),
-    }, { responsePath: outcome.responsePath, artifactId: outcome.artifactId, addressPlacement: "footer" });
-};

package/build/cli/commands/projection/fork/meta.js

@@ -1,12 +0,0 @@
-export const meta = {
-    command: "fork",
-    summary: "Start an Akuma helper session from a response artifact",
-    usage: ["keiyaku fork ARTIFACT [BODY|-]"],
-    stdin: {
-        mode: "argument",
-        selector: { kind: "positional", index: 1, required: false, rejectBlank: true },
-    },
-    flags: ["cwd", "repo", "model", "effort", "json"],
-    purpose: "Start a new projection from a persisted helper session.",
-    completionRank: 4,
-};

package/build/cli/commands/projection/history/handler.js

@@ -1,65 +0,0 @@
-import { readProjectionHistoryAddress, readProjectionHistory, selectProjectionHistory, } from "../../../../core/projection/index.js";
-import { FlowError } from "../../../../flow-error.js";
-import { projectionHistoryJson, renderProjectionHistoryDetail, renderProjectionHistoryList } from "../../../render/projection-history.js";
-import { textResponse } from "../../../render/shared.js";
-import { projectDirectory } from "../../shared.js";
-const DEFAULT_HISTORY_LIMIT = 20;
-function page(entries, offset, requestedLimit) {
-    const limit = requestedLimit ?? DEFAULT_HISTORY_LIMIT;
-    const selected = entries.slice(offset, offset + limit);
-    const nextOffset = offset + selected.length < entries.length ? offset + selected.length : null;
-    return { entries: selected, pagination: { offset, limit, total: entries.length, nextOffset } };
-}
-function rawAvailability() {
-    return { retention: "unavailable", reason: "provider-raw-body-not-retained" };
-}
-export const handler = async (_stdin, flags, _signal, positional) => {
-    const cwd = await projectDirectory(flags, "history");
-    const [address] = positional;
-    const offset = flags.historyOffset ?? 0;
-    if (!address) {
-        if (flags.historyRaw || flags.historyEntry !== undefined) {
-            throw new FlowError("INVALID_USAGE", "history --raw and --entry require one projection, alias, or artifact address");
-        }
-        const runs = selectProjectionHistory(await readProjectionHistory(cwd), {
-            filters: flags.taskFilters,
-            sort: flags.taskSort,
-            nowMs: Date.now(),
-        });
-        const result = page(runs, offset, flags.historyLimit);
-        return textResponse(flags.json ? projectionHistoryJson(result) : renderProjectionHistoryList(result.entries, result.pagination));
-    }
-    if (flags.historyRaw && !flags.json) {
-        throw new FlowError("INVALID_USAGE", "history --raw requires --json");
-    }
-    if (flags.historyRaw && flags.historyEntry === undefined) {
-        throw new FlowError("INVALID_USAGE", "history --raw requires --entry N");
-    }
-    if (flags.historyEntry !== undefined && (flags.historyLimit !== undefined || offset !== 0)) {
-        throw new FlowError("INVALID_USAGE", "history --entry cannot be combined with --limit or --offset");
-    }
-    const detail = await readProjectionHistoryAddress(cwd, address);
-    if (!detail)
-        throw new FlowError("PROJECTION_HISTORY_NOT_FOUND", `history has no retained run for '${address}'`);
-    const addressedDetail = {
-        ...detail,
-        inputToken: address,
-        canonicalId: detail.id,
-    };
-    if (flags.historyEntry !== undefined) {
-        const entry = detail.activity?.retainedTimeline[flags.historyEntry];
-        if (!entry)
-            throw new FlowError("PROJECTION_HISTORY_NOT_FOUND", `history entry ${flags.historyEntry} is not retained for '${address}'`);
-        const response = {
-            id: addressedDetail.id,
-            inputToken: addressedDetail.inputToken,
-            canonicalId: detail.id,
-            ...(detail.alias ? { alias: detail.alias } : {}),
-            entry: { index: flags.historyEntry, event: entry, ...(flags.historyRaw ? { raw: rawAvailability() } : {}) },
-        };
-        return textResponse(flags.json ? projectionHistoryJson(response) : renderProjectionHistoryDetail(detail, response.entry));
-    }
-    return textResponse(flags.json
-        ? projectionHistoryJson(addressedDetail)
-        : renderProjectionHistoryDetail(detail));
-};