@astrosheep/keiyaku 2.9.12 → 4.0.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,63 +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 });
-            return buildPetitionPreviewResponse(await previewPetition({
-                cwd,
-                contractId: address.binding.commissionId,
-                oath: input.oath,
-                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: "Run or preview the gated settlement pipeline",
-    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 a0 or open explicit arc, queue the contract, and run verdict and claim processing; dry-run previews deterministic gates without mutation.",
-    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,24 +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 { effectiveDirectory, repositoryDirectory } from "../../shared.js";
-export const handler = async (_stdin, flags, signal) => {
-    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) {
-        return renderLifecycleResult(continueRenewKeiyaku({ cwd, address, appendScope: flags.appendScope, signal }), buildRenewResponse, { cwd, address });
-    }
-    if (flags.renewAbort) {
-        return renderLifecycleResult(abortRenewKeiyaku({ cwd, address, signal }), buildRenewAbortResponse, { cwd, address });
-    }
-    return renderLifecycleResult(renewKeiyaku({
-        cwd,
-        address,
-        appendScope: flags.appendScope,
-        signal,
-    }), buildRenewResponse, { cwd, address });
-};

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

@@ -1,18 +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]",
-        "keiyaku @<id> renew --continue [--append-scope PATTERN]",
-        "keiyaku @<id> renew --abort",
-    ],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "contract", "append-scope", "continue", "abort"],
-    purpose: "Capture receipts, rewrite delivery onto the default branch, then seal the current a0 or open explicit arc 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.",
-    ],
-    completionRank: 9,
-};

package/build/cli/commands/metadata.js

@@ -1,65 +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 reviveMeta } from "./projection/revive/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 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 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 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", "revive", "wait", "tell", "kill", "log",
-    "akuma", "akuma ls", "akuma show", "skills", "skills install", "amend", "audit",
-    "renew", "petition", "forfeit", "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 drop", "task update", "task doctor", "dump-env",
-];
-const COMMAND_METADATA = [
-    bindMeta, arcMeta, callMeta, reviveMeta, waitMeta, tellMeta, killMeta, logMeta,
-    akumaMeta, akumaLsMeta, akumaShowMeta, skillsMeta, skillsInstallMeta, amendMeta, auditMeta,
-    renewMeta, petitionMeta, forfeitMeta, guideMeta, completionMeta, statusMeta, historyMeta,
-    taskMeta, taskAddMeta, taskComposeMeta, taskShowMeta, taskLsMeta, taskLogMeta, taskStartMeta, taskStopMeta,
-    taskHoldMeta, taskResumeMeta,
-    taskDoneMeta, 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.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"],
-    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 reviveMeta } from "./revive/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: reviveMeta, load: () => import("./revive/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/history/handler.js

@@ -1,21 +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";
-export const handler = async (_stdin, flags, _signal, positional) => {
-    const cwd = await projectDirectory(flags, "history");
-    const [address] = positional;
-    if (!address) {
-        const runs = selectProjectionHistory(await readProjectionHistory(cwd), {
-            filters: flags.taskFilters,
-            sort: flags.taskSort,
-            nowMs: Date.now(),
-        });
-        return textResponse(flags.json ? projectionHistoryJson(runs) : renderProjectionHistoryList(runs));
-    }
-    const detail = await readProjectionHistoryAddress(cwd, address);
-    if (!detail)
-        throw new FlowError("PROJECTION_HISTORY_NOT_FOUND", `history has no retained run for '${address}'`);
-    return textResponse(flags.json ? projectionHistoryJson(detail) : renderProjectionHistoryDetail(detail));
-};

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

@@ -1,9 +0,0 @@
-export const meta = {
-    command: "history",
-    summary: "Discover retained Akuma runs or inspect one run",
-    usage: ["keiyaku history [PROJECTION|ALIAS|ARTIFACT] [-C|--cwd DIR] [--filter EXPR] [--sort KEYS] [--json]"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "filter", "sort", "json"],
-    purpose: "Read retained projection history and the public response-file path without reading response content.",
-    completionRank: 15,
-};

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

@@ -1,20 +0,0 @@
-import { FlowError } from "../../../../flow-error.js";
-import { killProjectionGeneration } from "../../../../core/projection/index.js";
-import { waitForProjection } from "../../../../core/projection/index.js";
-import { buildKillAcceptedResponse, buildKillAlreadyClosedResponse } from "../../../render/kill.js";
-import { buildWaitResponse } from "../../../render/wait.js";
-import { resolveProjectionCommandTarget, runProjectionCommand, } from "../shared.js";
-export const handler = async (_stdin, flags, signal, positional) => runProjectionCommand(flags, "kill", async (ctx) => {
-    const [projectionAddress] = positional;
-    if (!projectionAddress)
-        throw new FlowError("EMPTY_PARAM", "kill requires a projection address");
-    const projection = await resolveProjectionCommandTarget(ctx, projectionAddress, "kill");
-    const result = killProjectionGeneration(projection.directory);
-    if (flags.timeoutMs === undefined) {
-        return result.status === "already-closed"
-            ? buildKillAlreadyClosedResponse(projection.id)
-            : buildKillAcceptedResponse(projection.id);
-    }
-    // --wait always replays ordinary wait, including already-terminal generations.
-    return buildWaitResponse(projection.id, await waitForProjection({ projectionDirectory: projection.directory, timeoutMs: flags.timeoutMs, signal }), { alias: projection.alias });
-});

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

@@ -1,11 +0,0 @@
-export const meta = {
-    command: "kill",
-    summary: "Stop the current projection generation",
-    usage: [
-        "keiyaku kill <projection-address> [--wait DURATION]",
-        "keiyaku @addr kill <projection-address> [--wait DURATION]",
-    ],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "contract", "wait"],
-    purpose: "Terminate the current generation while keeping the projection identity and tell ledger.",
-};

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

@@ -1,56 +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 { observeGitRepository } from "../../../../git/branches.js";
-import { stableRepoRoot } from "../../../../core/worktree-path.js";
-import { buildCallResponse } from "../../../render/call.js";
-import { buildCallInput, effectiveDirectory, projectDirectory, revivePrompt } from "../../shared.js";
-export const handler = async (stdin, flags, signal, positional) => {
-    const cwd = effectiveDirectory(flags);
-    const artifactCwd = await projectDirectory(flags, "revive");
-    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 revive 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"],
-        }),
-    });
-    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(revivePrompt(stdin), { ...flags, cwd: executionCwd, repo }, "revive"),
-        reviveArtifact: artifact,
-        signal,
-    });
-    return buildCallResponse(outcome.result, { responsePath: outcome.responsePath, artifactId: outcome.artifactId, addressPlacement: "footer" });
-};

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

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

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

@@ -1,27 +0,0 @@
-import { resolveContractAddress, withResolvedAddress, } from "../../../core/addressing.js";
-import { resolveProjectionAddress, } from "../../projection-address.js";
-import { projectDirectory, repositoryDirectory } from "../shared.js";
-/** Resolve cwd + optional contract address, then run the verb under that carrier. */
-export async function runProjectionCommand(flags, verb, operation) {
-    const cwd = flags.contractId
-        ? await repositoryDirectory(flags, `${verb} contract addressing`)
-        : await projectDirectory(flags, verb);
-    const address = flags.contractId
-        ? await resolveContractAddress(cwd, flags.contractId, flags.contractAddressSource)
-        : undefined;
-    const run = () => operation({ cwd, address });
-    return address ? await withResolvedAddress(address, run) : await run();
-}
-export function resolveProjectionCommandAddress(ctx, projectionAddress, verb, coordinate) {
-    return resolveProjectionAddress({
-        cwd: ctx.cwd,
-        address: projectionAddress,
-        scope: ctx.address,
-        coordinate,
-        verb,
-    });
-}
-export async function resolveProjectionCommandTarget(ctx, projectionAddress, verb) {
-    const projection = await resolveProjectionCommandAddress(ctx, projectionAddress, verb);
-    return projection;
-}

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

@@ -1,26 +0,0 @@
-import { readKanshiBoard } from "../../../../core/status/board.js";
-import { normalizeTargetRef } from "../../../../core/target-ref.js";
-import { isProjectionId } from "../../../../core/projection/index.js";
-import { FlowError } from "../../../../flow-error.js";
-import { renderProjectionFilteredStatus, renderStatusBoard } from "../../../render/status.js";
-import { coreTextResponse } from "../../../render/shared.js";
-import { projectDirectory, repositoryDirectory } from "../../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => {
-    const [projectionId] = positional;
-    if (projectionId !== undefined && !isProjectionId(projectionId)) {
-        throw new FlowError("EMPTY_PARAM", `invalid projection id: ${projectionId}`);
-    }
-    // Status is read-only and must open outside Git. projectDirectory still
-    // honors --repo as a repository coordinate when the operator names one.
-    const cwd = flags.target === undefined
-        ? await projectDirectory(flags, "status")
-        : await repositoryDirectory(flags, "status target filtering");
-    const target = flags.target === undefined ? undefined : normalizeTargetRef(flags.target);
-    const board = await readKanshiBoard(cwd, Date.now(), {
-        ...(target === undefined ? {} : { target }),
-        ...(projectionId === undefined ? {} : { projectionId }),
-    });
-    if (projectionId === undefined)
-        return coreTextResponse(renderStatusBoard(board), board);
-    return coreTextResponse(renderProjectionFilteredStatus(board, projectionId), board);
-};

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

@@ -1,9 +0,0 @@
-export const meta = {
-    command: "status",
-    summary: "Show the Kanshi board",
-    usage: ["keiyaku status [PROJECTION] [-C|--cwd DIR] [--repo DIR] [--target REF]"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "target"],
-    purpose: "Read the Kanshi board or filter it to one projection without mutation.",
-    completionRank: 14,
-};

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

@@ -1,28 +0,0 @@
-import { FlowError } from "../../../../flow-error.js";
-import { assertTellEffortSupported, interruptProjectionGeneration, tellProjection, writeInboxTell } from "../../../../core/projection/index.js";
-import { waitForProjection } from "../../../../core/projection/index.js";
-import { prependAddressReceipt } from "../../../render/address.js";
-import { buildSilentTellResponse } from "../../../render/tell.js";
-import { buildWaitResponse } from "../../../render/wait.js";
-import { resolveProjectionCommandTarget, runProjectionCommand, } from "../shared.js";
-export const handler = async (body, flags, signal, positional) => runProjectionCommand(flags, "tell", async (ctx) => {
-    const projectionAddress = positional[0];
-    if (!projectionAddress)
-        throw new FlowError("EMPTY_PARAM", "tell requires a projection address and message");
-    const projection = await resolveProjectionCommandTarget(ctx, projectionAddress, "tell");
-    assertTellEffortSupported(projection.directory, flags.effort);
-    // Address admission and any effort validation precede the durable mailbox write.
-    writeInboxTell(projection.directory, body, Date.now(), { effort: flags.effort });
-    if (flags.interrupt) {
-        const interrupted = interruptProjectionGeneration(projection.directory);
-        if (interrupted.status === "already-closed") {
-            await tellProjection(projection.directory, projection.id, flags.effort);
-        }
-    }
-    else {
-        await tellProjection(projection.directory, projection.id, flags.effort);
-    }
-    if (flags.timeoutMs === undefined)
-        return buildSilentTellResponse();
-    return prependAddressReceipt(buildWaitResponse(projection.id, await waitForProjection({ projectionDirectory: projection.directory, timeoutMs: flags.timeoutMs, signal }), { alias: projection.alias }), ctx.address, { projectionId: projection.id, projectionAlias: projection.alias });
-});

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

@@ -1,12 +0,0 @@
-export const meta = {
-    command: "tell",
-    summary: "Send intent to a projection mailbox",
-    usage: ["keiyaku tell PROJECTION [--interrupt] [--wait DURATION] [--] <BODY|->"],
-    stdin: {
-        mode: "argument",
-        selector: { kind: "positional", index: 1, required: true, rejectBlank: true },
-    },
-    flags: ["cwd", "repo", "contract", "effort", "interrupt", "wait"],
-    purpose: "Write intent to the mailbox; --interrupt terminates the active turn before successor wake.",
-    completionRank: 3,
-};