@astrosheep/keiyaku 4.6.7 → 4.6.9

package/build/src/cli/commands/{task.js → debt.js}

@@ -1,12 +1,11 @@
 import { CliUsageError, isBlankInput } from "../usage.js";
-import { parseTaskNamespaceSelector } from "../../task/catalog.js";
-import { tasksWithExecution, taskRowViewLimit, } from "../../task/index.js";
-import { taskCompositionNamespaceHeader } from "../../task/compose-language.js";
-import { installNamespaceContext, resolveTaskNamespaceContext } from "../../task/context.js";
-import { displayContext, emit, writeJson, writeStderr, writeStdout } from "../streams.js";
-import { renderDoctor, renderTaskCompose, renderTaskContext, renderTaskFailure, renderTaskIncompleteDiagnostic, renderTaskLifecycle, renderTaskList, renderTaskMutation, renderTaskShow, renderTaskTree, renderTaskUpdate, taskExitCode, } from "../render/task.js";
+import { parseDebtNamespaceSelector } from "../../debt/catalog.js";
+import { debtsWithExecution, debtRowViewLimit, } from "../../debt/index.js";
+import { installNamespaceContext, resolveDebtNamespaceContext } from "../../debt/context.js";
+import { displayContext, emit, writeJson } from "../streams.js";
+import { renderDoctor, renderDebtContext, renderDebtLifecycle, renderDebtList, renderDebtMutation, renderDebtShow, renderDebtTree, renderDebtUpdate, debtExitCode, } from "../render/debt.js";
 import { actorFromEdge } from "../actor.js";
-import { taskQuerySelection } from "../../task/query.js";
+import { debtQuerySelection } from "../../debt/query.js";
 function value(command, name) {
     const item = command.flags[name];
     return typeof item === "string" ? item : undefined;
@@ -30,40 +29,38 @@ function limit(command) {
     const raw = value(command, "limit");
     return raw === undefined ? undefined : Number(raw);
 }
-function validateTaskRowView(command) {
+function validateDebtRowView(command) {
     if (command.action === "ls" ||
         command.action === "ready" ||
         command.action === "blocked" ||
         command.action === "query")
-        taskRowViewLimit(limit(command));
+        debtRowViewLimit(limit(command));
 }
 function explicitListNamespace(command) {
     return command.action === "ls" && command.positionals.length === 1
-        ? parseTaskNamespaceSelector(command.positionals[0])
+        ? parseDebtNamespaceSelector(command.positionals[0])
         : undefined;
 }
-function taskStdinDiagnostic(command) {
+function debtStdinDiagnostic(command) {
     switch (command.stdin) {
         case "document":
-            return "task add requires a nonblank stdin document";
-        case "compose":
-            return "task compose requires a nonblank stdin document";
+            return "debt add requires a nonblank stdin document";
         case "body":
-            return "task update --body requires a nonblank value";
+            return "debt update --body requires a nonblank value";
         case "append":
-            return "task update --append requires a nonblank value";
+            return "debt update --append requires a nonblank value";
         case "note":
-            return "task update --note requires a nonblank value";
+            return "debt update --note requires a nonblank value";
         default:
             return undefined;
     }
 }
 async function invokeAdd(input) {
-    const { tasks, command, current = [] } = input;
+    const { debts, command, current = [] } = input;
     const selectedNamespace = namespace(value(command, "namespace")) ?? current;
     const actor = input.actor;
     if (command.stdin === "document") {
-        return tasks.addDocument({
+        return debts.addDocument({
             markdown: input.stdin,
             ...(selectedNamespace === undefined ? {} : { namespace: selectedNamespace }),
             ...(actor === undefined ? {} : { actor }),
@@ -72,7 +69,7 @@ async function invokeAdd(input) {
     const body = value(command, "body"), note = value(command, "note"), initialState = value(command, "state"), selectedPriority = priority(value(command, "priority"));
     const needs = ids(values(command, "needs")), parent = value(command, "parent");
     const supersedes = ids(values(command, "supersedes")), relates = ids(values(command, "relates"));
-    return tasks.add({
+    return debts.add({
         title: command.positionals[0],
         ...(selectedNamespace === undefined ? {} : { namespace: selectedNamespace }),
         ...(body === undefined ? {} : { body }),
@@ -87,7 +84,7 @@ async function invokeAdd(input) {
     });
 }
 function invokeUpdate(input) {
-    const { tasks, command, stdin } = input;
+    const { debts, command, stdin } = input;
     const body = command.stdin === "body" ? stdin : value(command, "body"), appendBody = command.stdin === "append" ? stdin : value(command, "append");
     const note = command.stdin === "note" ? stdin : value(command, "note");
     const title = value(command, "title"), selectedPriority = priority(value(command, "priority"));
@@ -95,7 +92,7 @@ function invokeUpdate(input) {
     const parent = value(command, "parent"), addSupersedes = ids(values(command, "supersedes"));
     const dropSupersedes = ids(values(command, "drop-supersedes")), addRelates = ids(values(command, "relates"));
     const dropRelates = ids(values(command, "drop-relates"));
-    return tasks.task({ id: command.positionals[0] }).update({
+    return debts.debt({ id: command.positionals[0] }).update({
         ...(title === undefined ? {} : { title }),
         ...(body === undefined ? {} : { body }),
         ...(appendBody === undefined ? {} : { appendBody }),
@@ -118,21 +115,21 @@ function readScope(command, current) {
     return command.flags.world === true ? { scope: "world" } : { namespace: current ?? [] };
 }
 /** One addressed read per caller-supplied id, in caller order; the native null survives to JSON. */
-async function runShow(command, tasks) {
-    const handles = command.positionals.map((taskId) => tasks.task({ id: taskId }).id);
+async function runShow(command, debts) {
+    const handles = command.positionals.map((debtId) => debts.debt({ id: debtId }).id);
     const details = [];
     for (const id of handles)
-        details.push(await tasks.task({ id }).read());
+        details.push(await debts.debt({ id }).read());
     const missing = details.findIndex((detail) => detail === null);
     const code = missing >= 0 ? 1 : 0;
     const projected = handles.length === 1 ? details[0] : details;
     if (missing >= 0) {
-        const refusal = { kind: "refused", refusal: { kind: "task-missing", taskId: handles[missing] } };
-        return emit(command.output, projected, () => renderTaskShow(refusal, displayContext()), code);
+        const refusal = { kind: "refused", refusal: { kind: "debt-missing", debtId: handles[missing] } };
+        return emit(command.output, projected, () => renderDebtShow(refusal, displayContext()), code);
     }
     const found = details.filter((detail) => detail !== null);
     const result = found.length === 1 ? found[0] : found;
-    return emit(command.output, projected, () => renderTaskShow(result, displayContext()), code);
+    return emit(command.output, projected, () => renderDebtShow(result, displayContext()), code);
 }
 /** Presentation-only list scope the leaf acquired, never part of the native answer. */
 function listPresentation(command) {
@@ -142,55 +139,49 @@ function listPresentation(command) {
     return command.action === "ls" && first !== undefined ? { namespace: first } : "current";
 }
 async function runRead(input) {
-    const { tasks, command, current } = input;
+    const { debts, command, current } = input;
     const id = command.positionals[0];
     const scope = listPresentation(command);
     switch (command.action) {
         case "ls": {
-            const result = await tasks.list({
+            const result = await debts.list({
                 selection: command.flags.all === true ? "all" : command.flags.closed === true ? "closed" : "active",
                 ...(explicitListNamespace(command) === undefined
                     ? readScope(command, current)
                     : { namespace: explicitListNamespace(command) }),
                 ...(limit(command) === undefined ? {} : { limit: limit(command) }),
             });
-            return emit(command.output, result, () => renderTaskList("ls", scope, result, displayContext()), taskExitCode(result));
-        }
-        case "ready": {
-            const result = await tasks.ready({
-                ...readScope(command, current),
-                ...(value(command, "parent") === undefined ? {} : { parent: value(command, "parent") }),
-                ...(limit(command) === undefined ? {} : { limit: limit(command) }),
-            });
-            return emit(command.output, result, () => renderTaskList("ready", scope, result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtList("ls", scope, result, displayContext()), debtExitCode(result));
         }
+        case "ready":
         case "blocked": {
-            const result = await tasks.blocked({
+            const action = command.action;
+            const result = await debts[action]({
                 ...readScope(command, current),
                 ...(value(command, "parent") === undefined ? {} : { parent: value(command, "parent") }),
                 ...(limit(command) === undefined ? {} : { limit: limit(command) }),
             });
-            return emit(command.output, result, () => renderTaskList("blocked", scope, result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtList(action, scope, result, displayContext()), debtExitCode(result));
         }
         case "query": {
-            const result = await tasks.query({
-                where: taskQuerySelection(command.flags.all === true ? "all" : command.flags.closed === true ? "closed" : "active", command.where),
+            const result = await debts.query({
+                where: debtQuerySelection(command.flags.all === true ? "all" : command.flags.closed === true ? "closed" : "active", command.where),
                 ...readScope(command, current),
                 ...(value(command, "sort") === undefined ? {} : { sort: value(command, "sort") }),
                 ...(limit(command) === undefined ? {} : { limit: limit(command) }),
             });
-            return emit(command.output, result, () => renderTaskList("query", scope, result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtList("query", scope, result, displayContext()), debtExitCode(result));
         }
         case "tree": {
-            const result = await tasks.task({ id }).tree();
-            return emit(command.output, result, () => renderTaskTree(result, displayContext()), taskExitCode(result));
+            const result = await debts.debt({ id }).tree();
+            return emit(command.output, result, () => renderDebtTree(result, displayContext()), debtExitCode(result));
         }
         case "doctor": {
-            const result = await tasks.doctor();
-            return emit(command.output, result, () => renderDoctor(result), taskExitCode(result));
+            const result = await debts.doctor();
+            return emit(command.output, result, () => renderDoctor(result), debtExitCode(result));
         }
         default:
-            throw new Error(`task action is not a read: ${command.action}`);
+            throw new Error(`debt action is not a read: ${command.action}`);
     }
 }
 function isWorldObservationAction(command) {
@@ -200,11 +191,11 @@ function isWorldObservationAction(command) {
         command.action === "query" ||
         command.action === "doctor");
 }
-function missingTask(id) {
-    return { kind: "refused", refusal: { kind: "task-missing", taskId: id } };
+function missingDebt(id) {
+    return { kind: "refused", refusal: { kind: "debt-missing", debtId: id } };
 }
 /**
- * The one CLI edge mapping a Task action with no World to its native refusal answer, then through
+ * The one CLI edge mapping a Debt action with no World to its native refusal answer, then through
  * the matching action renderer and the native exit classifier.
  */
 function missingWorld(command) {
@@ -215,135 +206,81 @@ function missingWorld(command) {
             writeJson(command.positionals.length === 1 ? null : command.positionals.map(() => null));
             return 1;
         }
-        const refusal = missingTask(command.positionals[0]);
-        return emit(output, refusal, () => renderTaskShow(refusal, displayContext()), 1);
+        const refusal = missingDebt(command.positionals[0]);
+        return emit(output, refusal, () => renderDebtShow(refusal, displayContext()), 1);
     }
-    if (isWorldObservationAction(command) || (command.action === "compose" && command.flags.plan === true)) {
-        return emit(output, { kind: "absent" }, () => "task world absent", 1);
+    if (isWorldObservationAction(command)) {
+        return emit(output, { kind: "absent" }, () => "debt world absent", 1);
     }
     if (command.action === "context") {
         const result = { kind: "accepted", value: { namespace: [], source: "default-root" } };
-        return emit(output, result, () => renderTaskContext(result, displayContext()), taskExitCode(result));
+        return emit(output, result, () => renderDebtContext(result, displayContext()), debtExitCode(result));
     }
     if (command.action === "tree") {
-        const result = missingTask(command.positionals[0]);
-        return emit(output, result, () => renderTaskTree(result, displayContext()), taskExitCode(result));
+        const result = missingDebt(command.positionals[0]);
+        return emit(output, result, () => renderDebtTree(result, displayContext()), debtExitCode(result));
     }
     if (command.action === "update") {
-        const result = missingTask(command.positionals[0]);
-        return emit(output, result, () => renderTaskUpdate(result, displayContext()), taskExitCode(result));
-    }
-    if (command.action === "start" ||
-        command.action === "stop" ||
-        command.action === "hold" ||
-        command.action === "resume") {
-        if (command.positionals.length === 1) {
-            const result = missingTask(command.positionals[0]);
-            return emit(output, result, () => renderTaskMutation(command.action, result, displayContext()), taskExitCode(result));
-        }
-        const result = {
-            items: command.positionals.map((id) => ({ id: id, outcome: missingTask(id) })),
-        };
-        return emit(output, result, () => renderTaskLifecycle(command.action, result, displayContext()), taskExitCode(result));
-    }
-    if (command.action === "done" || command.action === "drop") {
-        const result = {
-            items: command.positionals.map((id) => ({ id: id, outcome: missingTask(id) })),
-        };
-        return emit(output, result, () => renderTaskLifecycle(command.action, result, displayContext()), taskExitCode(result));
+        const result = missingDebt(command.positionals[0]);
+        return emit(output, result, () => renderDebtUpdate(result, displayContext()), debtExitCode(result));
     }
-    throw new Error(`task action has no missing-world answer: ${command.action}`);
+    if (command.action !== "done" && command.action !== "drop")
+        throw new Error(`debt action has no missing-world answer: ${command.action}`);
+    const result = {
+        items: command.positionals.map((id) => ({ id: id, outcome: missingDebt(id) })),
+    };
+    return emit(output, result, () => renderDebtLifecycle(command.action, result, displayContext()), debtExitCode(result));
 }
-/**
- * One compose execution outcome: JSON keeps the untouched native value, while an incomplete text
- * answer recovers its draft and puts the diagnostic on stderr.
- */
-function emitCompose(output, result) {
-    if (output === "json") {
-        writeJson(result);
-        return taskExitCode(result);
-    }
-    if (result.kind === "incomplete") {
-        const diagnostic = renderTaskIncompleteDiagnostic(result);
-        if (diagnostic.length > 0)
-            writeStderr(diagnostic);
-        process.stdout.write(result.draft);
-        return taskExitCode(result);
-    }
-    writeStdout(renderTaskCompose(result, displayContext()));
-    return taskExitCode(result);
-}
-/** One plural Task lifecycle answer: every verb shares the same batch shape and renderer. */
-async function runBatchLifecycle(tasks, command, verb) {
+/** One plural Debt lifecycle answer: every verb shares the same batch shape and renderer. */
+async function runBatchLifecycle(debts, command, verb) {
     const note = value(command, "note");
-    const result = await tasks.batch({
+    const result = await debts.batch({
         verb,
         ids: command.positionals,
         ...(note === undefined ? {} : { note }),
     });
-    return emit(command.output, result, () => renderTaskLifecycle(verb, result, displayContext()), taskExitCode(result));
+    return emit(command.output, result, () => renderDebtLifecycle(verb, result, displayContext()), debtExitCode(result));
 }
 async function runMutation(input) {
-    const { tasks, command, current, stdin, composeMarkdown, composeNamespace } = input;
+    const { debts, command, current } = input;
     if (isWorldObservationAction(command) || command.action === "tree")
         return await runRead(input);
     switch (command.action) {
         case "add": {
             const result = await invokeAdd(input);
-            return emit(command.output, result, () => renderTaskMutation("add", result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtMutation("add", result, displayContext()), debtExitCode(result));
         }
         case "update": {
             const result = await invokeUpdate(input);
-            return emit(command.output, result, () => renderTaskUpdate(result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtUpdate(result, displayContext()), debtExitCode(result));
         }
-        case "start":
-        case "stop":
-        case "resume": {
-            const result = await invokeLifecycle(tasks, command.positionals, command.positionals[0], command.action);
-            return emit(command.output, result, () => renderTaskLifecycle(command.action, result, displayContext()), taskExitCode(result));
-        }
-        case "hold":
         case "done":
         case "drop":
-            return await runBatchLifecycle(tasks, command, command.action);
+            return await runBatchLifecycle(debts, command, command.action);
         case "context": {
             const selected = namespace(command.positionals[0]);
             if (selected !== undefined) {
                 await installNamespaceContext(input.context.writeRoot ?? input.context.directory, selected);
-                const resolved = await resolveTaskNamespaceContext(input.context);
+                const resolved = await resolveDebtNamespaceContext(input.context);
                 if (typeof resolved === "object" && "kind" in resolved) {
                     const result = { kind: "refused", refusal: resolved };
-                    return emit(command.output, result, () => renderTaskContext(result, displayContext()), taskExitCode(result));
+                    return emit(command.output, result, () => renderDebtContext(result, displayContext()), debtExitCode(result));
                 }
                 const result = { kind: "accepted", value: resolved };
-                return emit(command.output, result, () => renderTaskContext(result, displayContext()), taskExitCode(result));
+                return emit(command.output, result, () => renderDebtContext(result, displayContext()), debtExitCode(result));
             }
             const result = {
                 kind: "accepted",
                 value: { namespace: current ?? [], source: "default-root" },
             };
-            return emit(command.output, result, () => renderTaskContext(result, displayContext()), taskExitCode(result));
-        }
-        case "compose": {
-            const result = await tasks.compose({
-                markdown: composeMarkdown ?? stdin ?? "",
-                namespace: composeNamespace ?? current ?? [],
-                ...(input.actor === undefined ? {} : { actor: input.actor }),
-                ...(command.flags.plan === true ? { plan: true } : {}),
-            });
-            return emitCompose(command.output, result);
+            return emit(command.output, result, () => renderDebtContext(result, displayContext()), debtExitCode(result));
         }
         default:
-            throw new Error(`task action has no invocation: ${command.action}`);
+            throw new Error(`debt action has no invocation: ${command.action}`);
     }
 }
-function invokeLifecycle(tasks, taskIds, firstId, verb) {
-    return taskIds.length === 1 ? tasks.task({ id: firstId })[verb]() : tasks.batch({ verb, ids: taskIds });
-}
 function establishesWorld(command) {
-    return (command.action === "add" ||
-        (command.action === "compose" && command.flags.plan !== true) ||
-        (command.action === "context" && command.positionals.length > 0));
+    return command.action === "add" || (command.action === "context" && command.positionals.length > 0);
 }
 /**
  * One CLI edge turning a namespace-context refusal into the addressed action's native refusal
@@ -357,42 +294,31 @@ function refuseNamespace(command, refusal) {
         case "blocked":
         case "query": {
             const action = command.action;
-            return emit(command.output, result, () => renderTaskList(action, listPresentation(command), result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtList(action, listPresentation(command), result, displayContext()), debtExitCode(result));
         }
         case "add":
-            return emit(command.output, result, () => renderTaskMutation("add", result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtMutation("add", result, displayContext()), debtExitCode(result));
         case "context":
-            return emit(command.output, result, () => renderTaskContext(result, displayContext()), taskExitCode(result));
-        case "compose":
-            return emit(command.output, result, () => renderTaskFailure("compose", result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtContext(result, displayContext()), debtExitCode(result));
         default:
-            throw new Error(`task action has no namespace refusal: ${command.action}`);
+            throw new Error(`debt action has no namespace refusal: ${command.action}`);
     }
 }
 // eslint-disable-next-line complexity -- this is the single CLI edge ordering world, context, forwarding, and local execution.
-export async function runTaskCommand(command, coordinates, runtime) {
-    validateTaskRowView(command);
-    const stdinDiagnostic = taskStdinDiagnostic(command);
+export async function runDebtCommand(command, coordinates, runtime) {
+    validateDebtRowView(command);
+    const stdinDiagnostic = debtStdinDiagnostic(command);
     const stdin = stdinDiagnostic === undefined ? undefined : await runtime.readStdin();
     if (stdinDiagnostic !== undefined && isBlankInput(stdin ?? ""))
         throw new CliUsageError(stdinDiagnostic);
-    const planOnly = command.action === "compose" && command.flags.plan === true;
-    const composeMarkdown = command.action === "compose" ? stdin : undefined;
-    const composition = composeMarkdown === undefined ? undefined : taskCompositionNamespaceHeader(composeMarkdown);
-    const explicitNamespace = command.action === "add"
-        ? namespace(value(command, "namespace"))
-        : command.action === "compose" && composition?.specified
-            ? composition.namespace
-            : undefined;
+    const explicitNamespace = command.action === "add" ? namespace(value(command, "namespace")) : undefined;
     const actor = actorFromEdge(typeof command.flags.actor === "string" ? command.flags.actor : undefined, runtime.environment);
-    const world = coordinates.world ??
-        (planOnly ? coordinates.candidateWorld : establishesWorld(command) ? await coordinates.establishWorld() : null);
+    const world = coordinates.world ?? (establishesWorld(command) ? await coordinates.establishWorld() : null);
     if (world === null)
         return missingWorld(command);
-    const tasks = tasksWithExecution(world, runtime.execution);
+    const debts = debtsWithExecution(world, runtime.execution);
     const contextSensitive = command.action === "context" ||
         (command.action === "add" && explicitNamespace === undefined) ||
-        (command.action === "compose" && composition?.specified !== true) ||
         (((command.action === "ls" && explicitListNamespace(command) === undefined) ||
             command.action === "ready" ||
             command.action === "blocked" ||
@@ -400,26 +326,23 @@ export async function runTaskCommand(command, coordinates, runtime) {
             command.flags.world !== true);
     let current;
     if (contextSensitive) {
-        const resolved = await resolveTaskNamespaceContext(coordinates.taskContext);
+        const resolved = await resolveDebtNamespaceContext(coordinates.debtContext);
         if (typeof resolved === "object" && "kind" in resolved)
             return refuseNamespace(command, resolved);
         current = resolved.namespace;
         if (command.action === "context" && command.positionals.length === 0) {
             const result = { kind: "accepted", value: resolved };
-            return emit(command.output, result, () => renderTaskContext(result, displayContext()), taskExitCode(result));
+            return emit(command.output, result, () => renderDebtContext(result, displayContext()), debtExitCode(result));
         }
     }
     if (command.action === "show")
-        return await runShow(command, tasks);
+        return await runShow(command, debts);
     return await runMutation({
-        tasks,
+        debts,
         command,
-        runtime,
-        context: coordinates.taskContext,
+        context: coordinates.debtContext,
         ...(actor === undefined ? {} : { actor }),
         ...(current === undefined ? {} : { current }),
         ...(stdin === undefined ? {} : { stdin }),
-        ...(composeMarkdown === undefined ? {} : { composeMarkdown }),
-        ...(explicitNamespace === undefined ? {} : { composeNamespace: explicitNamespace }),
     });
 }

package/build/src/cli/coordinates.d.ts

@@ -7,7 +7,7 @@ export type CliCoordinates = Readonly<{
     repo?: Repo;
     world: WorldRoot | null;
     candidateWorld: WorldRoot | null;
-    taskContext: Readonly<{
+    debtContext: Readonly<{
         directory: string;
         boundary: string;
         writeRoot: string;

package/build/src/cli/coordinates.js

@@ -69,7 +69,7 @@ export const cliCoordinateDiscovery = {
             ...(repo === undefined ? {} : { repo }),
             world: world.root,
             candidateWorld: world.candidate,
-            taskContext: {
+            debtContext: {
                 directory: cwd,
                 boundary,
                 writeRoot: worldRepo === undefined ? boundary : cwd,

package/build/src/cli/parse.d.ts

@@ -1,7 +1,7 @@
-import { type ParsedTaskCommand, type TaskAction } from "./commands/task-grammar.js";
+import { type ParsedDebtCommand, type DebtAction } from "./commands/debt-grammar.js";
 import { type AkumaAction, type ParsedAkumaCommand } from "./commands/akuma-grammar.js";
 import { type ParsedInstallCommand } from "./commands/install.js";
-import { type ParsedAbandon, type ParsedAmend, type ParsedArc, type ParsedAudit, type ParsedBind, type ParsedDeliver, type ParsedLs, type ParsedNuke, type ParsedReconcile, type ParsedRegion, type ParsedReview, type ParsedSettings, type ParsedStatus } from "./commands/contract-grammar.js";
+import { type ParsedContractCommand } from "./commands/contract-grammar.js";
 import { type ContractCommand as Command } from "./commands/contract-help.js";
 import { type CliUsageGuide } from "./usage.js";
 export { CliUsageError } from "./usage.js";
@@ -10,15 +10,15 @@ export type { Command };
 export declare function renderRootHelp(columns?: number): string;
 export declare function usageGuideForCommand(command: ParsedCommand): CliUsageGuide;
 export declare function renderHelp(coordinate: CliHelpCoordinate, columns?: number): string;
-export type ParsedCommand = ParsedBind | ParsedAmend | ParsedDeliver | ParsedReview | ParsedArc | ParsedAbandon | ParsedStatus | ParsedLs | ParsedAudit | ParsedReconcile | ParsedNuke | ParsedSettings | ParsedRegion | ParsedInstallCommand | ParsedAkumaCommand | ParsedTaskCommand;
+export type ParsedCommand = ParsedContractCommand | ParsedInstallCommand | ParsedAkumaCommand | ParsedDebtCommand;
 type CliHelpCoordinate = Readonly<{
     kind: "root";
 }> | Readonly<{
     kind: "contract";
     command: Command;
 }> | Readonly<{
-    kind: "task";
-    action?: TaskAction;
+    kind: "debt";
+    action?: DebtAction;
 }> | Readonly<{
     kind: "install";
 }> | Readonly<{

package/build/src/cli/parse.js

@@ -1,4 +1,4 @@
-import { isTaskAction, parseTaskCommand, renderTaskHelp, taskUsageGuide, } from "./commands/task-grammar.js";
+import { isDebtAction, parseDebtCommand, renderDebtHelp, debtUsageGuide, } from "./commands/debt-grammar.js";
 import { akumaUsageGuide, isAkumaAction, parseAkumaCommand, renderAkumaHelp, renderAkumaRootRows, } from "./commands/akuma-grammar.js";
 import { INSTALL_ROOT_PURPOSE, INSTALL_USAGE, parseInstallCommand, renderInstallHelp, } from "./commands/install.js";
 import { parseContractCommand, } from "./commands/contract-grammar.js";
@@ -14,7 +14,7 @@ const ROOT_USAGE = [
 const INVOCATION_PATH_OPTIONS = new Set(["-C", "--cwd", "--repo", "--workdir"]);
 export function renderRootHelp(columns) {
     return renderHelpText([
-        "keiyaku — Contract, Task, and Akuma control for one repository",
+        "keiyaku — Contract, Debt, and Akuma control for one repository",
         "",
         ROOT_USAGE,
         "",
@@ -23,8 +23,8 @@ export function renderRootHelp(columns) {
             .filter(([command]) => command !== "settings")
             .map(([command, spec]) => `  ${command.padEnd(10)} ${spec.purpose}`),
         "",
-        "Task — plan memory",
-        "  task       Task coordination; see `keiyaku task --help`.",
+        "Debt — unresolved-work ledger",
+        "  debt       Debt coordination; see `keiyaku debt --help`.",
         "",
         "Akuma — contracted demons",
         ...renderAkumaRootRows(),
@@ -64,8 +64,8 @@ function renderHelpText(help, columns) {
 export function usageGuideForCommand(command) {
     if (command.command === "install")
         return commandGuide("install", INSTALL_USAGE);
-    if (command.command === "task")
-        return taskUsageGuide(command.action);
+    if (command.command === "debt")
+        return debtUsageGuide(command.action);
     if (isAkumaAction(command.command))
         return akumaUsageGuide(command.command);
     return commandGuide(command.command, CONTRACT_COMMAND_SPECS[command.command].usage);
@@ -77,8 +77,8 @@ export function renderHelp(coordinate, columns) {
                 return renderRootHelp();
             case "contract":
                 return renderContractHelpForOwner(coordinate.command);
-            case "task":
-                return renderTaskHelp(coordinate.action);
+            case "debt":
+                return renderDebtHelp(coordinate.action);
             case "install":
                 return renderInstallHelp();
             case "akuma":
@@ -98,6 +98,7 @@ export function commandRepoPolicy(command) {
         case "audit":
         case "reconcile":
         case "region":
+        case "show":
             return { use: "required", acceptsExplicit: true };
         case "ls":
             return { use: command.query.kind === "contracts" ? "required" : "none", acceptsExplicit: false };
@@ -123,7 +124,7 @@ export function commandRepoPolicy(command) {
             };
         case "settings":
         case "nuke":
-        case "task":
+        case "debt":
         case "install":
             return { use: "none", acceptsExplicit: false };
     }
@@ -234,9 +235,9 @@ function helpCoordinate(argv) {
         return null;
     const words = argv.slice(0, help);
     const root = words[0];
-    if (root === "task") {
-        const action = isTaskAction(words[1]) ? words[1] : undefined;
-        return { kind: "task", ...(action === undefined ? {} : { action }) };
+    if (root === "debt") {
+        const action = isDebtAction(words[1]) ? words[1] : undefined;
+        return { kind: "debt", ...(action === undefined ? {} : { action }) };
     }
     if (root === "install")
         return { kind: "install" };
@@ -255,14 +256,14 @@ export function parseArgv(argv) {
     // A bare invocation asks for orientation: the root help index, not a refusal.
     if (invocation.commandArgv.length === 0)
         return { help: { kind: "root" } };
-    if (invocation.commandArgv.length === 1 && invocation.commandArgv[0] === "task")
-        return { help: { kind: "task" } };
+    if (invocation.commandArgv.length === 1 && invocation.commandArgv[0] === "debt")
+        return { help: { kind: "debt" } };
     if (invocation.commandArgv.length === 1 && invocation.commandArgv[0] === "--version")
         return { version: true };
-    const task = invocation.commandArgv[0] === "task" ? parseTaskCommand(invocation.commandArgv.slice(1)) : undefined;
+    const debt = invocation.commandArgv[0] === "debt" ? parseDebtCommand(invocation.commandArgv.slice(1)) : undefined;
     const install = invocation.commandArgv[0] === "install" ? parseInstallCommand(invocation.commandArgv.slice(1)) : undefined;
     const akuma = isAkumaAction(invocation.commandArgv[0]) ? parseAkumaCommand(invocation.commandArgv) : undefined;
-    const command = task ?? akuma ?? install ?? parseContractCommand(scanArgv(invocation.commandArgv));
+    const command = debt ?? akuma ?? install ?? parseContractCommand(scanArgv(invocation.commandArgv));
     if (invocation.workdir !== undefined && command.command !== "call") {
         throw new CliUsageError(`option --workdir is not valid for ${command.command}`, usageGuideForCommand(command));
     }