@astrosheep/keiyaku 4.6.8 → 4.6.9

package/build/src/cli/commands/akuma.js

@@ -14,8 +14,8 @@ import { World } from "../../world.js";
 import { contractFromInput } from "../selectors.js";
 import { ActivityDriver } from "../activity.js";
 import { displayContext, emit, resultContext, writeJson, writeStderr, writeStdout } from "../streams.js";
-import { callObservationStream, inputWaitStream, waitObservationStream, } from "../render/akuma-activity.js";
-import { askRawAnswer, callRawAnswer, historyRawAnswer, historyText, tellText, waitRawAnswer, waitText, } from "../render/akuma-activity.js";
+import { callObservationStream, inputWaitStream } from "../render/akuma-activity.js";
+import { askRawAnswer, callRawAnswer, historyRawAnswer, historyText, tellText, waitText, } from "../render/akuma-activity.js";
 import { askExitCode, askProgressStream, callExitCode, callObservationHead, forkExitCode, historyExitCode, killExitCode, renderCallText, renderForkText, renderKillText, tellExitCode, waitedTellProgress, } from "../render/akuma.js";
 export { isParsedAkumaCommand, renderAkumaHelp } from "./akuma-grammar.js";
 // ---------------------------------------------------------------------------
@@ -50,17 +50,6 @@ async function promptBody(action, command, input) {
         throw new CliUsageError(`${action} requires a nonblank prompt`);
     return bytes;
 }
-function waitObserver(stream, driver, onSelected) {
-    return {
-        selected: (selected) => {
-            onSelected?.(selected);
-            stream.select(selected);
-        },
-        observe: (observed) => {
-            driver.settle(stream.observe(observed), stream.frame());
-        },
-    };
-}
 async function inputInitiator(input) {
     let initiator;
     try {
@@ -162,46 +151,19 @@ async function runCall(command, input) {
 }
 async function runWait(command, input) {
     const alias = command.akuma.length === 1 ? inputAlias(command.akuma[0]) : undefined;
-    const stream = command.output === "text" ? waitObservationStream(resultContext()) : undefined;
-    const driver = new ActivityDriver(process.stderr);
-    const startedAt = Date.now();
-    let selection;
-    const observer = stream === undefined
-        ? undefined
-        : waitObserver(stream, driver, (selected) => {
-            selection = selected;
-        });
-    try {
-        const result = await akumas(input).wait({
-            akuma: command.akuma,
-            ...(input.repo === undefined ? {} : { repo: input.repo }),
-            ...(command.completion === undefined ? {} : { completion: command.completion }),
-            ...(command.timeoutMs === undefined ? {} : { timeoutMs: command.timeoutMs }),
-            ...(input.signal === undefined ? {} : { signal: input.signal }),
-            ...(observer === undefined ? {} : { observe: observer }),
-        });
-        const streamed = stream !== undefined && stream.streamed();
-        if (stream !== undefined && streamed)
-            driver.conclude(stream.conclude(result));
-        const presentation = {
-            ...(alias === undefined ? {} : { alias }),
-            ...(selection === undefined ? {} : { selection }),
-            startedAt,
-        };
-        if (command.output === "json") {
-            writeJson(result);
-            return 0;
-        }
-        const raw = waitRawAnswer(result, streamed);
-        if (raw === undefined)
-            emitAnswer(waitText(result, presentation, displayContext()), false);
-        else
-            emitAnswer(raw, true);
+    const result = await akumas(input).wait({
+        akuma: command.akuma,
+        ...(input.repo === undefined ? {} : { repo: input.repo }),
+        ...(command.completion === undefined ? {} : { completion: command.completion }),
+        ...(command.timeoutMs === undefined ? {} : { timeoutMs: command.timeoutMs }),
+        ...(input.signal === undefined ? {} : { signal: input.signal }),
+    });
+    if (command.output === "json") {
+        writeJson(result);
         return 0;
     }
-    finally {
-        driver.close(stream?.flush() ?? []);
-    }
+    emitAnswer(waitText(result, { ...(alias === undefined ? {} : { alias }) }, displayContext()), false);
+    return 0;
 }
 async function runTell(command, input) {
     const body = await promptBody("tell", command, input);

package/build/src/cli/commands/contract-grammar.d.ts

@@ -1,6 +1,6 @@
 import { type ContractCommand } from "./contract-help.js";
 type CatalogQuery = Readonly<{
-    kind: "tasks";
+    kind: "debts";
     namespace?: readonly string[];
     limit?: number;
 }> | Readonly<{
@@ -23,7 +23,7 @@ type Actor = Readonly<{
 export type ParsedBind = Output & Actor & Readonly<{
     command: "bind";
     forkOf?: string;
-    task?: string;
+    debt?: string;
     /** A literal target branch, or `null` for a deliberately targetless bind. */
     target?: string | null;
     after?: readonly string[];
@@ -61,19 +61,21 @@ export type ParsedAbandon = Output & Actor & Readonly<{
     contract?: string;
     note?: string;
 }>;
+export type ParsedShow = Output & Readonly<{
+    command: "show";
+    contract?: string;
+}>;
 export type ParsedStatus = Output & (Readonly<{
     command: "status";
     contract?: string;
     selectors?: readonly string[];
     akuma?: never;
-    guidance?: true;
     category?: never;
     limit?: never;
 }> | Readonly<{
     command: "status";
     contract: string;
     akuma: true;
-    guidance?: never;
     category?: never;
     limit?: never;
 }> | Readonly<{
@@ -83,7 +85,6 @@ export type ParsedStatus = Output & (Readonly<{
     contract?: never;
     selectors?: never;
     akuma?: never;
-    guidance?: never;
 }>);
 export type ParsedLs = Output & Readonly<{
     command: "ls";
@@ -120,7 +121,7 @@ export type ParsedContractParts = Readonly<{
     output: "text" | "json";
     actor?: string;
 }>;
-export type ParsedContractCommand = ParsedBind | ParsedAmend | ParsedDeliver | ParsedReview | ParsedArc | ParsedAbandon | ParsedStatus | ParsedLs | ParsedAudit | ParsedReconcile | ParsedNuke | ParsedSettings | ParsedRegion;
+export type ParsedContractCommand = ParsedBind | ParsedAmend | ParsedDeliver | ParsedReview | ParsedArc | ParsedAbandon | ParsedShow | ParsedStatus | ParsedLs | ParsedAudit | ParsedReconcile | ParsedNuke | ParsedSettings | ParsedRegion;
 export type StatusCategory = "akuma" | "contract";
 export declare function parseContractCommand(parts: ParsedContractParts): ParsedContractCommand;
 export {};

package/build/src/cli/commands/contract-grammar.js

@@ -1,5 +1,5 @@
 import { validateAkumaName } from "../../identity/normalize.js";
-import { parseTaskNamespaceSelector } from "../../task/catalog.js";
+import { parseDebtNamespaceSelector } from "../../debt/catalog.js";
 import { CliUsageError, commandGuide } from "../usage.js";
 import { CONTRACT_COMMAND_SPECS } from "./contract-help.js";
 function parseAkumaCatalogPath(value) {
@@ -53,7 +53,7 @@ function parseBind(parts) {
     if (forkOf !== undefined) {
         if (parts.stdin)
             refuse("bind", "fork bind reads no stdin");
-        for (const option of ["task", "after", "gates"]) {
+        for (const option of ["debt", "after", "gates"]) {
             if (parts.flags[option] !== undefined)
                 refuse("bind", `--${option} is not valid with --fork-of`);
         }
@@ -68,13 +68,13 @@ function parseBind(parts) {
     }
     if (!parts.stdin)
         refuse("bind", "bind requires stdin");
-    const task = optionalFlag(parts.flags, "task");
+    const debt = optionalFlag(parts.flags, "debt");
     const target = parseBindTarget(parts);
     const after = parts.flags.after === undefined ? [] : Array.isArray(parts.flags.after) ? parts.flags.after : [parts.flags.after];
     const gates = parseGateNames(parts, "bind");
     return {
         command: "bind",
-        ...(task === undefined ? {} : { task }),
+        ...(debt === undefined ? {} : { debt }),
         ...(target === undefined ? {} : { target }),
         ...(parts.flags.after === undefined ? {} : { after }),
         ...(gates === undefined ? {} : { gates }),
@@ -149,29 +149,20 @@ function rejectStatusGlobs(positionals) {
             refuse("status", `unsupported status glob: ${selector}`);
     }
 }
-function parseStatusGuidance(parts, limit) {
-    if (limit !== undefined)
-        refuse("status", "--limit is not valid with --guidance");
+function showSelector(parts) {
     const selected = parts.positionals[0];
     if (selected !== undefined && STATUS_CATEGORY_SELECTORS.has(selected))
-        refuse("status", "--guidance cannot select a category");
+        refuse("show", "show cannot select a category");
     if (parts.positionals.length > 1)
-        refuse("status", "--guidance accepts at most one Contract selector");
+        refuse("show", "show accepts at most one Contract selector");
     if (selected?.startsWith("aku/") === true)
-        refuse("status", "--guidance cannot select an Akuma");
+        refuse("show", "show cannot select an Akuma");
     if (selected !== undefined && !selected.startsWith("@") && /[*?\[\]]/u.test(selected))
-        refuse("status", `unsupported status glob: ${selected}`);
-    return {
-        command: "status",
-        ...(selected === undefined ? {} : { contract: selected }),
-        guidance: true,
-        output: parts.output,
-    };
+        refuse("show", `unsupported show glob: ${selected}`);
+    return selected;
 }
 function parseStatus(parts) {
     const limit = listLimit(parts, "status");
-    if (parts.flags.guidance === true)
-        return parseStatusGuidance(parts, limit);
     rejectStatusGlobs(parts.positionals);
     if (parts.positionals.length > 1) {
         if (limit !== undefined)
@@ -209,23 +200,23 @@ function listLimit(parts, command = "ls") {
         refuse(command, "--limit requires a positive safe integer");
     return limit === undefined ? undefined : Number(limit);
 }
-function taskCatalogQuery(path, limit) {
-    if (path === "task" || path === "task/") {
-        return { kind: "tasks", namespace: [], ...(limit === undefined ? {} : { limit }) };
+function debtCatalogQuery(path, limit) {
+    if (path === "debt" || path === "debt/") {
+        return { kind: "debts", namespace: [], ...(limit === undefined ? {} : { limit }) };
     }
-    if (!path.startsWith("task/"))
+    if (!path.startsWith("debt/"))
         return null;
     if (!path.endsWith("/"))
-        refuse("ls", `invalid Task namespace selector: ${path}`);
-    const body = path.slice("task/".length, -1);
+        refuse("ls", `invalid Debt namespace selector: ${path}`);
+    const body = path.slice("debt/".length, -1);
     if (body.length === 0 || body.split("/").some((segment) => segment.length === 0))
-        refuse("ls", `invalid Task namespace selector: ${path}`);
+        refuse("ls", `invalid Debt namespace selector: ${path}`);
     try {
-        const namespace = parseTaskNamespaceSelector(path);
-        return { kind: "tasks", namespace, ...(limit === undefined ? {} : { limit }) };
+        const namespace = parseDebtNamespaceSelector(path);
+        return { kind: "debts", namespace, ...(limit === undefined ? {} : { limit }) };
     }
     catch (error) {
-        refuse("ls", error instanceof Error ? error.message : `invalid Task namespace selector: ${path}`);
+        refuse("ls", error instanceof Error ? error.message : `invalid Debt namespace selector: ${path}`);
     }
 }
 function parseLs(parts) {
@@ -233,9 +224,9 @@ function parseLs(parts) {
     if (path === undefined)
         refuse("ls", "ls requires a selector");
     const limit = listLimit(parts);
-    const taskQuery = taskCatalogQuery(path, limit);
-    if (taskQuery !== null)
-        return { command: "ls", query: taskQuery, output: parts.output };
+    const debtQuery = debtCatalogQuery(path, limit);
+    if (debtQuery !== null)
+        return { command: "ls", query: debtQuery, output: parts.output };
     if (path === "kei" || path === "kei/") {
         return {
             command: "ls",
@@ -285,6 +276,10 @@ export function parseContractCommand(parts) {
                 output: parts.output,
             };
         }
+        case "show": {
+            const contract = showSelector(parts);
+            return { command: "show", ...(contract === undefined ? {} : { contract }), output: parts.output };
+        }
         case "status":
             return parseStatus(parts);
         case "ls":

package/build/src/cli/commands/contract-help.d.ts

@@ -13,7 +13,7 @@ export declare const CONTRACT_COMMAND_SPECS: {
         readonly stdin: "optional";
         readonly flags: {
             readonly actor: "value";
-            readonly task: "value";
+            readonly debt: "value";
             readonly target: "value";
             readonly "no-target": "boolean";
             readonly after: "repeat";
@@ -21,7 +21,7 @@ export declare const CONTRACT_COMMAND_SPECS: {
             readonly "fork-of": "value";
             readonly json: "boolean";
         };
-        readonly usage: "bind [--task <task/...>] [--target <ref> | --no-target] [--after <kei/...> ...] [--gates <name,...>] [--actor <actor>] - | bind --fork-of <kei/...> [--target <ref> | --no-target] [--actor <actor>]";
+        readonly usage: "bind [--debt <debt/...>] [--target <ref> | --no-target] [--after <kei/...> ...] [--gates <name,...>] [--actor <actor>] - | bind --fork-of <kei/...> [--target <ref> | --no-target] [--actor <actor>]";
         readonly purpose: "Create a Contract from stdin Markdown or copy an existing Contract as a starting point.";
         readonly details: string;
     };
@@ -89,15 +89,24 @@ export declare const CONTRACT_COMMAND_SPECS: {
         readonly usage: "abandon [<contract>|@<contract>] [--note <text>] [--actor <actor>]";
         readonly purpose: "End work on a Contract without delivering it; optionally record why.";
     };
+    readonly show: {
+        readonly positional: "optional";
+        readonly stdin: "none";
+        readonly flags: {
+            readonly json: "boolean";
+        };
+        readonly usage: "show [<contract>|@<contract>]";
+        readonly purpose: "Read one Contract's guidance.";
+        readonly details: string;
+    };
     readonly status: {
         readonly positional: "optional";
         readonly stdin: "none";
         readonly flags: {
-            readonly guidance: "boolean";
             readonly limit: "value";
             readonly json: "boolean";
         };
-        readonly usage: "status [<contract>|@name|<aku/...>]...\nstatus (aku|aku/|aku/*) [--limit <count>]\nstatus (kei|kei/|kei/*) [--limit <count>]\nstatus --guidance [<contract>|@<contract>]";
+        readonly usage: "status [<contract>|@name|<aku/...>]...\nstatus (aku|aku/|aku/*) [--limit <count>]\nstatus (kei|kei/|kei/*) [--limit <count>]";
         readonly purpose: "Show the world overview or selected Contract and Akuma status.";
         readonly details: string;
     };
@@ -108,8 +117,8 @@ export declare const CONTRACT_COMMAND_SPECS: {
             readonly limit: "value";
             readonly json: "boolean";
         };
-        readonly usage: "ls task[/] [--limit <count>]\nls kei[/] [--limit <count>]\nls aku[/] [--limit <count>]\nls aku/<name>[/] [--limit <count>]\nls \"aku/<name>/*\" [--limit <count>]\nls \"aku/*/*\" [--limit <count>]";
-        readonly purpose: "List tasks (ls task), contracts (ls kei), or akumas (ls aku).";
+        readonly usage: "ls debt[/] [--limit <count>]\nls kei[/] [--limit <count>]\nls aku[/] [--limit <count>]\nls aku/<name>[/] [--limit <count>]\nls \"aku/<name>/*\" [--limit <count>]\nls \"aku/*/*\" [--limit <count>]";
+        readonly purpose: "List debts (ls debt), contracts (ls kei), or akumas (ls aku).";
         readonly details: string;
     };
     readonly audit: {
@@ -144,7 +153,7 @@ export declare const CONTRACT_COMMAND_SPECS: {
         };
         readonly usage: "nuke [--confirm <world-directory>]";
         readonly purpose: "Remove Keiyaku-owned data from this World.";
-        readonly details: "Stops Akumas and removes this World's Tasks and Keiyaku-created worktrees and Git references. --confirm must exactly match this World's directory; source files are not deleted.";
+        readonly details: "Stops Akumas and removes this World's Debts and Keiyaku-created worktrees and Git references. --confirm must exactly match this World's directory; source files are not deleted.";
     };
     readonly settings: {
         readonly positional: "none";

package/build/src/cli/commands/contract-help.js

@@ -5,7 +5,7 @@ export const CONTRACT_COMMAND_SPECS = {
         stdin: "optional",
         flags: {
             actor: "value",
-            task: "value",
+            debt: "value",
             target: "value",
             "no-target": "boolean",
             after: "repeat",
@@ -13,7 +13,7 @@ export const CONTRACT_COMMAND_SPECS = {
             "fork-of": "value",
             json: "boolean",
         },
-        usage: "bind [--task <task/...>] [--target <ref> | --no-target] [--after <kei/...> ...] [--gates <name,...>] [--actor <actor>] - | bind --fork-of <kei/...> [--target <ref> | --no-target] [--actor <actor>]",
+        usage: "bind [--debt <debt/...>] [--target <ref> | --no-target] [--after <kei/...> ...] [--gates <name,...>] [--actor <actor>] - | bind --fork-of <kei/...> [--target <ref> | --no-target] [--actor <actor>]",
         purpose: "Create a Contract from stdin Markdown or copy an existing Contract as a starting point.",
         details: [
             "--target names one existing local branch literally; it is never created and never",
@@ -147,11 +147,24 @@ export const CONTRACT_COMMAND_SPECS = {
         usage: "abandon [<contract>|@<contract>] [--note <text>] [--actor <actor>]",
         purpose: "End work on a Contract without delivering it; optionally record why.",
     },
+    show: {
+        positional: "optional",
+        stdin: "none",
+        flags: { json: "boolean" },
+        usage: "show [<contract>|@<contract>]",
+        purpose: "Read one Contract's guidance.",
+        details: [
+            "Accepts a complete Contract identity or exact @<contract> short selector.",
+            "Omitted selection uses the exact managed worktree's installed Contract context.",
+            "Akuma, category, and plural selections are refused before reading guidance.",
+            "Text returns guidance directly; --json serializes the same native value.",
+        ].join("\n"),
+    },
     status: {
         positional: "optional",
         stdin: "none",
-        flags: { guidance: "boolean", limit: "value", json: "boolean" },
-        usage: "status [<contract>|@name|<aku/...>]...\nstatus (aku|aku/|aku/*) [--limit <count>]\nstatus (kei|kei/|kei/*) [--limit <count>]\nstatus --guidance [<contract>|@<contract>]",
+        flags: { limit: "value", json: "boolean" },
+        usage: "status [<contract>|@name|<aku/...>]...\nstatus (aku|aku/|aku/*) [--limit <count>]\nstatus (kei|kei/|kei/*) [--limit <count>]",
         purpose: "Show the world overview or selected Contract and Akuma status.",
         details: [
             "Akuma entries show the directory each Akuma was started in.",
@@ -159,18 +172,14 @@ export const CONTRACT_COMMAND_SPECS = {
             "aku, aku/, and aku/* show the recent Akuma board; kei, kei/, and kei/* show the",
             "recent active Contract board. --limit bounds the board to that many recent rows",
             "(default 10). The Contract category requires a Repo; the Akuma category does not.",
-            "",
-            "--guidance reads one Contract's guidance instead of status. It accepts one Contract",
-            "selector or the installed Contract selection context, and refuses an Akuma, plural,",
-            "or world selection before the read.",
         ].join("\n"),
     },
     ls: {
         positional: "optional",
         stdin: "none",
         flags: { limit: "value", json: "boolean" },
-        usage: 'ls task[/] [--limit <count>]\nls kei[/] [--limit <count>]\nls aku[/] [--limit <count>]\nls aku/<name>[/] [--limit <count>]\nls "aku/<name>/*" [--limit <count>]\nls "aku/*/*" [--limit <count>]',
-        purpose: "List tasks (ls task), contracts (ls kei), or akumas (ls aku).",
+        usage: 'ls debt[/] [--limit <count>]\nls kei[/] [--limit <count>]\nls aku[/] [--limit <count>]\nls aku/<name>[/] [--limit <count>]\nls "aku/<name>/*" [--limit <count>]\nls "aku/*/*" [--limit <count>]',
+        purpose: "List debts (ls debt), contracts (ls kei), or akumas (ls aku).",
         details: [
             "ls kei lists active Contracts; accepted and abandoned ones leave the list, and their record stays in history and Git.",
             "ls aku/ lists the callable Akuma-name catalog; ls aku/<name> lists the living Akumas under one name.",
@@ -205,7 +214,7 @@ export const CONTRACT_COMMAND_SPECS = {
         flags: { confirm: "value", json: "boolean" },
         usage: "nuke [--confirm <world-directory>]",
         purpose: "Remove Keiyaku-owned data from this World.",
-        details: "Stops Akumas and removes this World's Tasks and Keiyaku-created worktrees and Git references. --confirm must exactly match this World's directory; source files are not deleted.",
+        details: "Stops Akumas and removes this World's Debts and Keiyaku-created worktrees and Git references. --confirm must exactly match this World's directory; source files are not deleted.",
     },
     settings: {
         positional: "none",

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

@@ -6,12 +6,12 @@ import { composeContractLibrary, observeKeiyaku } from "../../library/contract-c
 import { validateArcMarkdown, validateContractMarkdown } from "../../library/input.js";
 import { createKeiyakuHandle } from "../../library/keiyaku.js";
 import { SettingsError, settings } from "../../settings.js";
-import { Tasks } from "../../task/index.js";
+import { Debts } from "../../debt/index.js";
 import { actorFromEdge } from "../actor.js";
 import { resolveInvocationCwd } from "../coordinates.js";
 import { BindDraftError, preserveBindDraft } from "../draft.js";
 import { snapshotText } from "../render/akuma-activity.js";
-import { renderAkumaCatalogue, renderArchetypeCatalogue, renderContractCatalogue, renderTaskCatalogue, } from "../render/catalog.js";
+import { renderAkumaCatalogue, renderArchetypeCatalogue, renderContractCatalogue, renderDebtCatalogue, } from "../render/catalog.js";
 import { renderAccepted, renderContractHistory, renderRetry } from "../render/contract.js";
 import { renderKanshiCategoryText, renderKanshiText } from "../render/kanshi.js";
 import { nukeExitCode, renderNukeText } from "../render/nuke.js";
@@ -152,7 +152,7 @@ async function runBind(command, input, library) {
         const answer = await library.bind({
             repo,
             markdown,
-            ...(command.task === undefined ? {} : { task: command.task }),
+            ...(command.debt === undefined ? {} : { debt: command.debt }),
             ...(command.target === undefined ? {} : { target: command.target }),
             ...(actor === undefined ? {} : { actor }),
             ...(after === undefined ? {} : { after }),
@@ -324,15 +324,15 @@ async function runLs(command, coordinates, home) {
     }
     if (coordinates.world === null)
         throw new CliUsageError("no Keiyaku world contains the invocation cwd");
-    if (query.kind === "tasks") {
-        const listed = await Tasks.of(coordinates.world).list({
+    if (query.kind === "debts") {
+        const listed = await Debts.of(coordinates.world).list({
             selection: "all",
             namespace: query.namespace ?? [],
             ...(query.limit === undefined ? {} : { limit: query.limit }),
         });
         if (listed.kind !== "accepted")
-            throw new Error("Task list did not return an accepted observation");
-        return emit(command.output, listed, () => renderTaskCatalogue(listed.value, query.namespace ?? []), 0);
+            throw new Error("Debt list did not return an accepted observation");
+        return emit(command.output, listed, () => renderDebtCatalogue(listed.value, query.namespace ?? []), 0);
     }
     const listed = await Akumas.of(coordinates.world).list({
         ...(query.archetype === undefined ? {} : { archetype: query.archetype }),
@@ -375,14 +375,14 @@ async function namedStatus(selector, coordinates, named) {
         return await readAkumaStatus(address.id, selector, coordinates);
     return await readContractStatus(address.id, coordinates, named);
 }
-async function runStatusGuidance(command, coordinates) {
+async function runShow(command, coordinates) {
     const repo = coordinates.repo;
     if (repo === undefined)
         throw new CliUsageError("cannot select a contract while the Contract world is absent");
     const selected = await selectedContract(repo, command.contract, coordinates.cwd);
     const guidance = await selected.contract.guidance();
     if (guidance === null) {
-        const refusal = statusRefusal("status", selected.id);
+        const refusal = statusRefusal(command.command, selected.id);
         return emit(command.output, null, () => renderRefusal(refusal, undefined, displayContext()), 1);
     }
     return emit(command.output, guidance, () => guidance, 0);
@@ -453,8 +453,6 @@ async function runStatusIdentity(command, coordinates) {
     throw new CliUsageError(`contract selector must use kei/: ${command.contract}`);
 }
 async function runStatus(command, coordinates) {
-    if (command.guidance === true)
-        return await runStatusGuidance(command, coordinates);
     if (command.category !== undefined)
         return await runStatusCategory(command, coordinates);
     if ("selectors" in command && command.selectors !== undefined)
@@ -550,6 +548,8 @@ export async function runContractCommand(command, coordinates, runtime) {
             return await runNuke(command, coordinates);
         case "ls":
             return await runLs(command, coordinates, home);
+        case "show":
+            return await runShow(command, coordinates);
         case "status":
             return await runStatus(command, coordinates);
         case "region":

package/build/src/cli/commands/debt-grammar.d.ts

@@ -0,0 +1,19 @@
+import { type CliUsageGuide } from "../usage.js";
+import { type DebtQueryExpression } from "./debt-query.js";
+export type DebtAction = "add" | "show" | "ls" | "ready" | "blocked" | "tree" | "doctor" | "update" | "query" | "done" | "drop" | "context";
+type DebtFlagValue = string | true | readonly string[];
+type DebtStdin = "document" | "body" | "append" | "note";
+export type ParsedDebtCommand = Readonly<{
+    command: "debt";
+    action: DebtAction;
+    output: "text" | "json";
+    positionals: readonly string[];
+    flags: Readonly<Record<string, DebtFlagValue>>;
+    stdin?: DebtStdin;
+    where?: DebtQueryExpression;
+}>;
+export declare function isDebtAction(value: string | undefined): value is DebtAction;
+export declare function renderDebtHelp(action?: DebtAction): string;
+export declare function debtUsageGuide(action: DebtAction): CliUsageGuide;
+export declare function parseDebtCommand(argv: readonly string[]): ParsedDebtCommand;
+export {};