@astrosheep/keiyaku 2.9.13 → 4.0.0

package/build/cli/commands/task/compose/handler.js

@@ -1,18 +0,0 @@
-import { composeTasks, openTaskMutationContext, planTaskComposition, resolveTaskCreator, } from "../../../../core/task/index.js";
-import { renderTaskComposition, renderTaskCompositionJson } from "../../../render/task.js";
-import { textResponse } from "../../../render/shared.js";
-import { taskCommandDirectory } from "../shared.js";
-export const handler = async (stdin, flags, signal) => {
-    const cwd = await taskCommandDirectory(flags);
-    const context = await openTaskMutationContext(cwd, signal);
-    const input = {
-        sketch: stdin,
-        creator: await resolveTaskCreator(cwd),
-        namespace: context.namespace,
-        now: () => new Date(),
-    };
-    const plan = flags.check
-        ? planTaskComposition(await context.repository.read(), input)
-        : await composeTasks(context.repository, input);
-    return textResponse(flags.json ? renderTaskCompositionJson(plan, Boolean(flags.check)) : renderTaskComposition(plan, Boolean(flags.check)));
-};

package/build/cli/commands/task/compose/meta.js

@@ -1,10 +0,0 @@
-export const meta = {
-    command: "task compose",
-    summary: "Atomically compose tasks from a tree sketch",
-    usage: ["keiyaku task compose [-C|--cwd DIR] [--contract ADDR] [--check] - < sketch.md"],
-    stdin: { mode: "document", selector: { kind: "positional", index: 0, required: true, rejectBlank: true } },
-    flags: ["cwd", "contract", "check", "json"],
-    purpose: "Atomically create and rewire tasks from one validated tree sketch.",
-    input: ["Each task line is two-space indented + title or @COORDINATE, followed by whitespace-separated parent=, needs=@a,@b, supersedes=@c, or relates=@d declarations. Bare prose is allowed only in a nested + task body."],
-    notes: ["Nesting assigns parent. Top-level references preserve their parent; parent= clears it. Omitted relation declarations preserve their current complete set, while an explicit empty declaration clears that set."],
-};

package/build/cli/commands/task/doctor/handler.js

@@ -1,3 +0,0 @@
-import { textResponse } from "../../../render/shared.js";
-import { renderTaskDoctor, taskCommandDirectory } from "../shared.js";
-export const handler = async (_stdin, flags) => textResponse(await renderTaskDoctor(await taskCommandDirectory(flags)));

package/build/cli/commands/task/doctor/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task doctor",
-    summary: "Diagnose the task board",
-    usage: ["keiyaku task doctor [-C|--cwd DIR] [--contract ADDR]"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract"],
-    purpose: "Report task state counts, supported board diseases, and lock state without repair.",
-};

package/build/cli/commands/task/done/handler.js

@@ -1,10 +0,0 @@
-import { doneTask } from "../../../../core/task/index.js";
-import { mutationSelectionMessage, runTaskMutationCommand } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => {
-    try {
-        return await runTaskMutationCommand(flags, (repository) => doneTask(repository, positional[0]));
-    }
-    catch (error) {
-        return mutationSelectionMessage(error);
-    }
-};

package/build/cli/commands/task/done/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task done",
-    summary: "Complete a task",
-    usage: ["keiyaku task done [-C|--cwd DIR] [--contract ADDR] [COORDINATE]"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract"],
-    purpose: "Complete an open or in-progress task.",
-};

package/build/cli/commands/task/drop/handler.js

@@ -1,8 +0,0 @@
-import { dropTask, dropTaskWithNote, resolveTaskCreator } from "../../../../core/task/index.js";
-import { runTaskMutationCommand } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => runTaskMutationCommand(flags, async (repository, cwd) => flags.taskNote === undefined
-    ? dropTask(repository, positional[0])
-    : dropTaskWithNote(repository, positional[0], {
-        actor: await resolveTaskCreator(cwd),
-        text: flags.taskNote,
-    }));

package/build/cli/commands/task/drop/meta.js

@@ -1,11 +0,0 @@
-export const meta = {
-    command: "task drop",
-    summary: "Drop a task",
-    usage: ["keiyaku task drop [-C|--cwd DIR] [--contract ADDR] COORDINATE [--note TEXT|-]"],
-    stdin: {
-        mode: "argument",
-        selector: { kind: "flag", names: ["taskNote"], required: false, rejectBlank: true },
-    },
-    flags: ["cwd", "contract", "note"],
-    purpose: "Abandon an open or in-progress task.",
-};

package/build/cli/commands/task/hold/handler.js

@@ -1,3 +0,0 @@
-import { holdTask } from "../../../../core/task/index.js";
-import { runTaskMutationCommand } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => runTaskMutationCommand(flags, (repository) => holdTask(repository, positional[0]));

package/build/cli/commands/task/hold/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task hold",
-    summary: "Put a task on hold",
-    usage: ["keiyaku task hold [-C|--cwd DIR] [--contract ADDR] COORDINATE"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract"],
-    purpose: "Move an open or in-progress task to on hold.",
-};

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

@@ -1,12 +0,0 @@
-import { FlowError } from "../../../../flow-error.js";
-import { readTaskBoard, readTaskHistory, resolveTaskReadId, } from "../../../../core/task/index.js";
-import { textResponse } from "../../../render/shared.js";
-import { withTaskCommandRepository } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => withTaskCommandRepository(flags, async (repository, cwd) => {
-    const board = await readTaskBoard(repository);
-    const task = board.byId.get(resolveTaskReadId(board, positional[0]));
-    if (!task)
-        throw new FlowError("INTERNAL_STATE", "resolved task disappeared from the board");
-    const rows = await readTaskHistory(cwd, task.coordinate);
-    return textResponse(rows.map(({ timestamp, actor, subject }) => `${timestamp}\t${actor}\t${subject}`).join("\n"));
-});

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

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task log",
-    summary: "Show one task's Git history",
-    usage: ["keiyaku task log [-C|--cwd DIR] [--contract ADDR] COORDINATE"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract"],
-    purpose: "Read the current checkout branch's task micro-commit history.",
-};

package/build/cli/commands/task/ls/handler.js

@@ -1,17 +0,0 @@
-import { readTaskBoard, selectTaskList } from "../../../../core/task/index.js";
-import { renderSelectedTaskList, renderSelectedTaskListJson } from "../../../render/task.js";
-import { textResponse } from "../../../render/shared.js";
-import { taskJsonText, taskSelection, withTaskCommandRepository } from "../shared.js";
-export const handler = async (_stdin, flags) => {
-    const board = await withTaskCommandRepository(flags, (repository) => readTaskBoard(repository));
-    const selection = taskSelection(flags);
-    const tasks = selectTaskList(board.tasks, {
-        selection,
-        filters: flags.taskFilters,
-        sort: flags.taskSort,
-        nowMs: Date.now(),
-    });
-    return textResponse(flags.json
-        ? taskJsonText(renderSelectedTaskListJson(tasks))
-        : renderSelectedTaskList(tasks));
-};

package/build/cli/commands/task/ls/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task ls",
-    summary: "List tasks",
-    usage: ["keiyaku task ls [-C|--cwd DIR] [--contract ADDR] [--all|--done] [--filter EXPR] [--sort KEYS] [--json]"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract", "all", "done", "filter", "sort", "json"],
-    purpose: "List tasks from the working-tree board.",
-};

package/build/cli/commands/task/note/handler.js

@@ -1,6 +0,0 @@
-import { appendTaskNote, resolveTaskCreator } from "../../../../core/task/index.js";
-import { runTaskMutationCommand } from "../shared.js";
-export const handler = async (stdin, flags, _signal, positional) => runTaskMutationCommand(flags, async (repository, cwd) => appendTaskNote(repository, positional[0], {
-    actor: await resolveTaskCreator(cwd),
-    text: stdin,
-}));

package/build/cli/commands/task/note/meta.js

@@ -1,11 +0,0 @@
-export const meta = {
-    command: "task note",
-    summary: "Append an immutable task note",
-    usage: ["keiyaku task note [-C|--cwd DIR] [--contract ADDR] COORDINATE TEXT|-"],
-    stdin: {
-        mode: "argument",
-        selector: { kind: "positional", index: 1, required: true, rejectBlank: true },
-    },
-    flags: ["cwd", "contract"],
-    purpose: "Record an append-only task journal fact.",
-};

package/build/cli/commands/task/resume/handler.js

@@ -1,3 +0,0 @@
-import { resumeTask } from "../../../../core/task/index.js";
-import { runTaskMutationCommand } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => runTaskMutationCommand(flags, (repository) => resumeTask(repository, positional[0]));

package/build/cli/commands/task/resume/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task resume",
-    summary: "Resume a task on hold",
-    usage: ["keiyaku task resume [-C|--cwd DIR] [--contract ADDR] COORDINATE"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract"],
-    purpose: "Return an on-hold task to open.",
-};

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

@@ -1,181 +0,0 @@
-import { FlowError } from "../../../flow-error.js";
-import { attachAddressCarrier, resolveExplicitContractAddressFromRead } from "../../../core/addressing.js";
-import { readRepositoryLifecycle } from "../../../core/repository-ledger/read-model.js";
-import { findRegisteredContractWorktreePathFromModel, stableRepoRoot } from "../../../core/worktree-path.js";
-import { openTaskCommandRepository, parseTaskDocument, readTaskDoctor, taskCoordinateFromSourcePath, } from "../../../core/task/index.js";
-import { deriveTaskDisplay, renderTaskList, renderTaskMutationRow, } from "../../render/task.js";
-import { textResponse } from "../../render/shared.js";
-import { effectiveDirectory } from "../shared.js";
-/** Resolve --contract to its one ledger-owned checkout before task access. */
-export async function taskCommandDirectory(flags) {
-    const cwd = effectiveDirectory(flags);
-    if (flags.contractId === undefined)
-        return cwd;
-    const stableRoot = await stableRepoRoot(cwd);
-    const admitted = resolveExplicitContractAddressFromRead({
-        read: await readRepositoryLifecycle(stableRoot),
-        stableRoot,
-        workdir: cwd,
-        raw: flags.contractId,
-        source: flags.contractAddressSource ?? "explicit-flag",
-    });
-    const worktree = admitted.model.resources.worktree;
-    const lifecycle = admitted.model.phase;
-    if (!worktree || worktree.state !== "held") {
-        throw attachAddressCarrier(new FlowError("CONTRACT_WORKSPACE_UNAVAILABLE", `contract ${admitted.model.contract} has no materialized workspace for task commands (${lifecycle})`, { facts: { kind: "task_contract_workspace", contractId: admitted.model.contract, lifecycle, reason: "not-materialized" } }), admitted.address);
-    }
-    const registered = await findRegisteredContractWorktreePathFromModel(stableRoot, admitted.model);
-    if (!registered) {
-        throw attachAddressCarrier(new FlowError("CONTRACT_WORKSPACE_UNAVAILABLE", `contract ${admitted.model.contract} worktree is not a verified ledger-owned materialized checkout`, { facts: { kind: "task_contract_workspace", contractId: admitted.model.contract, lifecycle, reason: "unregistered" } }), admitted.address);
-    }
-    return registered;
-}
-/** Open the selected task command repository and run the verb. */
-export async function withTaskCommandRepository(flags, run) {
-    const cwd = await taskCommandDirectory(flags);
-    return run(await openTaskCommandRepository(cwd), cwd);
-}
-/** Shared shell: open repository → mutate → renderTaskMutationRow receipt. */
-export async function runTaskMutationCommand(flags, mutate) {
-    return textResponse(renderTaskMutationRow(await withTaskCommandRepository(flags, mutate)));
-}
-export function taskSelection(flags) {
-    return flags.all ? "all" : flags.done ? "done" : "default";
-}
-export function taskJsonText(text) {
-    return text.endsWith("\n") ? text.slice(0, -1) : text;
-}
-export function mutationSelectionMessage(error) {
-    if (error instanceof FlowError) {
-        const candidates = error.candidateTasks;
-        if (candidates && candidates.length > 1) {
-            error.message = `${renderTaskList(candidates, { selection: "all" })}\n${error.message}`;
-        }
-    }
-    throw error;
-}
-function taskDocumentsById(sources) {
-    const documents = new Map();
-    for (const source of sources) {
-        try {
-            const document = parseTaskDocument(source);
-            documents.set(taskCoordinateFromSourcePath(source.path).coordinate, document);
-        }
-        catch {
-            // Invalid documents are reported from board diseases.
-        }
-    }
-    return documents;
-}
-function renderTaskDiseaseRows(diseases, documents) {
-    const rows = [];
-    const renderedCycles = new Set();
-    for (const disease of diseases) {
-        if (disease.code === "invalid_document") {
-            try {
-                const coordinate = taskCoordinateFromSourcePath(disease.path).coordinate;
-                rows.push(`! ${coordinate} invalid front matter — quarantined`);
-            }
-            catch {
-                // A malformed non-coordinate path has no copyable task identity to render.
-            }
-            continue;
-        }
-        if (disease.code === "needs_cycle" && disease.id && disease.relatedIds) {
-            const cycleKey = disease.relatedIds.join("\0");
-            if (renderedCycles.has(cycleKey))
-                continue;
-            renderedCycles.add(cycleKey);
-            if (disease.relatedIds.length === 1) {
-                rows.push(`! ${disease.id} needs itself`);
-                continue;
-            }
-            const members = new Set(disease.relatedIds);
-            const start = [...members].sort()[0];
-            const cycle = [start];
-            let current = start;
-            for (let count = 0; count <= members.size; count += 1) {
-                const next = documents.get(current)?.needs.filter((id) => members.has(id)).sort()[0];
-                if (!next)
-                    break;
-                cycle.push(next);
-                if (next === start)
-                    break;
-                current = next;
-            }
-            if (cycle.at(-1) === start)
-                rows.push(`! cycle detected: ${cycle.join(" → ")}`);
-            continue;
-        }
-        if (disease.code === "supersedes_cycle" && disease.id && disease.relatedIds) {
-            const cycleKey = `supersedes\0${disease.relatedIds.join("\0")}`;
-            if (renderedCycles.has(cycleKey))
-                continue;
-            renderedCycles.add(cycleKey);
-            const members = new Set(disease.relatedIds);
-            const start = [...members].sort()[0];
-            const cycle = [start];
-            let current = start;
-            for (let count = 0; count <= members.size; count += 1) {
-                const next = documents.get(current)?.supersedes.filter((id) => members.has(id)).sort()[0];
-                if (!next)
-                    break;
-                cycle.push(next);
-                if (next === start)
-                    break;
-                current = next;
-            }
-            if (cycle.at(-1) === start)
-                rows.push(`! supersedes cycle detected: ${cycle.join(" → ")}`);
-            continue;
-        }
-        if (disease.code === "missing_reference" && disease.id && disease.relatedIds) {
-            const document = documents.get(disease.id);
-            if (!document)
-                continue;
-            for (const related of disease.relatedIds) {
-                if (document.needs.includes(related))
-                    rows.push(`! ${disease.id} needs missing task ${related}`);
-                if (document.parent === related)
-                    rows.push(`? ${disease.id} parent ${related} does not exist`);
-                if (document.supersedes.includes(related))
-                    rows.push(`! ${disease.id} supersedes missing task ${related}`);
-                if (document.relatesTo.includes(related))
-                    rows.push(`! ${disease.id} relates to missing task ${related}`);
-            }
-        }
-    }
-    return rows;
-}
-export async function renderTaskDoctor(cwd) {
-    const result = await readTaskDoctor(cwd);
-    const board = result.board;
-    const tasks = board.tasks;
-    const counts = { inProgress: 0, onHold: 0, ready: 0, blocked: 0, done: 0, dropped: 0, bound: 0 };
-    for (const task of tasks) {
-        const display = deriveTaskDisplay(task);
-        if (display === "in_progress")
-            counts.inProgress += 1;
-        else if (display === "on_hold")
-            counts.onHold += 1;
-        else if (display === "ready")
-            counts.ready += 1;
-        else if (display === "blocked")
-            counts.blocked += 1;
-        else if (display === "done")
-            counts.done += 1;
-        else if (display === "dropped")
-            counts.dropped += 1;
-        else
-            counts.bound += 1;
-    }
-    const lines = [
-        `tasks · ${tasks.length} total`,
-        `${counts.inProgress} in_progress · ${counts.onHold} on hold · ${counts.ready} ready · ${counts.blocked} blocked · ${counts.done} done · ${counts.dropped} dropped · ${counts.bound} bound`,
-        ...renderTaskDiseaseRows(board.diseases, taskDocumentsById(result.sources)),
-        ...result.orphans.map(({ taskId, contractId }) => `! ${taskId} points at contract ${contractId} which has no ledger entry — rolling back`),
-    ];
-    if (result.lockHeld)
-        lines.push("× board lock currently held by a live writer");
-    return lines.join("\n");
-}

package/build/cli/commands/task/show/handler.js

@@ -1,13 +0,0 @@
-import { FlowError } from "../../../../flow-error.js";
-import { buildTaskTree, readTaskBoard, resolveTaskReadId, } from "../../../../core/task/index.js";
-import { renderTaskShow, renderTaskShowJson } from "../../../render/task.js";
-import { textResponse } from "../../../render/shared.js";
-import { taskJsonText, withTaskCommandRepository } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => withTaskCommandRepository(flags, async (repository) => {
-    const board = await readTaskBoard(repository);
-    const task = board.byId.get(resolveTaskReadId(board, positional[0]));
-    if (!task)
-        throw new FlowError("INTERNAL_STATE", "resolved task disappeared from the board");
-    const tree = buildTaskTree(board, task.coordinate);
-    return textResponse(flags.json ? taskJsonText(renderTaskShowJson(task, tree)) : renderTaskShow(task, tree));
-});

package/build/cli/commands/task/show/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task show",
-    summary: "Show one task and its children tree",
-    usage: ["keiyaku task show [-C|--cwd DIR] [--contract ADDR] COORDINATE [--json]"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract", "json"],
-    purpose: "Read one task and every descendant linked by parent edges.",
-};

package/build/cli/commands/task/start/handler.js

@@ -1,3 +0,0 @@
-import { startTask } from "../../../../core/task/index.js";
-import { runTaskMutationCommand } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => runTaskMutationCommand(flags, (repository) => startTask(repository, positional[0], new Date()));

package/build/cli/commands/task/start/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task start",
-    summary: "Start a task",
-    usage: ["keiyaku task start [-C|--cwd DIR] [--contract ADDR] COORDINATE"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract"],
-    purpose: "Move an open task to in_progress.",
-};

package/build/cli/commands/task/stop/handler.js

@@ -1,10 +0,0 @@
-import { stopTask } from "../../../../core/task/index.js";
-import { mutationSelectionMessage, runTaskMutationCommand } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => {
-    try {
-        return await runTaskMutationCommand(flags, (repository) => stopTask(repository, positional[0]));
-    }
-    catch (error) {
-        return mutationSelectionMessage(error);
-    }
-};

package/build/cli/commands/task/stop/meta.js

@@ -1,8 +0,0 @@
-export const meta = {
-    command: "task stop",
-    summary: "Stop a task",
-    usage: ["keiyaku task stop [-C|--cwd DIR] [--contract ADDR] [COORDINATE]"],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "contract"],
-    purpose: "Return an in-progress task to open.",
-};

package/build/cli/commands/task/task/handler.js

@@ -1,5 +0,0 @@
-import { missingSubcommandError } from "../../../missing-subcommand.js";
-import { TASK_SUBCOMMANDS } from "../../../types.js";
-export const handler = async () => {
-    throw missingSubcommandError("task", TASK_SUBCOMMANDS);
-};

package/build/cli/commands/task/task/meta.js

@@ -1,11 +0,0 @@
-import { TASK_SUBCOMMANDS } from "../../../types.js";
-export const meta = {
-    command: "task",
-    summary: "Manage lightweight repository tasks",
-    usage: ["keiyaku task <subcommand>"],
-    stdin: { mode: "argument" },
-    flags: [],
-    purpose: "Manage the file-backed task board.",
-    subcommands: TASK_SUBCOMMANDS,
-    completionRank: 15,
-};

package/build/cli/commands/task/update/handler.js

@@ -1,21 +0,0 @@
-import { updateTaskWithReceipt } from "../../../../core/task/index.js";
-import { renderTaskUpdate, renderTaskUpdateJson } from "../../../render/task.js";
-import { textResponse } from "../../../render/shared.js";
-import { withTaskCommandRepository } from "../shared.js";
-export const handler = async (_stdin, flags, _signal, positional) => {
-    const result = await withTaskCommandRepository(flags, (repository) => updateTaskWithReceipt(repository, positional[0], {
-        ...(flags.taskTitle === undefined ? {} : { title: flags.taskTitle }),
-        ...(flags.taskBody === undefined ? {} : { body: flags.taskBody }),
-        ...(flags.taskAppend === undefined ? {} : { appendBody: flags.taskAppend }),
-        ...(flags.taskPri === undefined ? {} : { pri: flags.taskPri }),
-        ...(flags.taskNeeds === undefined ? {} : { addNeeds: flags.taskNeeds }),
-        ...(flags.taskDropNeeds === undefined ? {} : { dropNeeds: flags.taskDropNeeds }),
-        ...(flags.taskParent !== undefined ? { parent: flags.taskParent } : flags.taskNoParent ? { parent: null } : {}),
-        ...(flags.taskFrom === undefined ? {} : { from: flags.taskFrom }),
-        ...(flags.taskSupersedes === undefined ? {} : { addSupersedes: flags.taskSupersedes }),
-        ...(flags.taskDropSupersedes === undefined ? {} : { dropSupersedes: flags.taskDropSupersedes }),
-        ...(flags.taskRelatesTo === undefined ? {} : { addRelatesTo: flags.taskRelatesTo }),
-        ...(flags.taskDropRelatesTo === undefined ? {} : { dropRelatesTo: flags.taskDropRelatesTo }),
-    }));
-    return textResponse(flags.json ? renderTaskUpdateJson(result) : renderTaskUpdate(result));
-};

package/build/cli/commands/task/update/meta.js

@@ -1,12 +0,0 @@
-export const TASK_UPDATE_EXPLICIT_CHANGE_ERROR = "task update requires an explicit change: --title, --body TEXT or --body -, --append TEXT|-, --pri, --needs/--drop-needs, --parent/--no-parent, --from, --supersedes/--drop-supersedes, or --relates-to/--drop-relates-to";
-export const meta = {
-    command: "task update",
-    summary: "Update task facts",
-    usage: ["keiyaku task update [-C|--cwd DIR] [--contract ADDR] COORDINATE [--title TEXT] [--body TEXT|-|--append TEXT|-] [--pri 0-3] [--needs COORDINATE] [--drop-needs COORDINATE] [--parent COORDINATE|--no-parent] [--from COORDINATE] [--supersedes COORDINATE] [--drop-supersedes COORDINATE] [--relates-to COORDINATE] [--drop-relates-to COORDINATE] [--json]"],
-    stdin: {
-        mode: "argument",
-        selector: { kind: "flag", names: ["taskBody", "taskAppend"], required: false, rejectBlank: false },
-    },
-    flags: ["cwd", "contract", "title", "body", "append", "pri", "needs", "drop-needs", "parent", "no-parent", "from", "supersedes", "drop-supersedes", "relates-to", "drop-relates-to", "json"],
-    purpose: "Change mutable task facts.",
-};

package/build/cli/commands/verification/handler.js

@@ -1,43 +0,0 @@
-import { readVerificationRun, requestVerificationRunCancellation, VerificationRunUnknownError, VerificationRunWaitTimeoutError, waitForVerificationRun, } from "../../../core/settlement/verification.js";
-import { FlowError } from "../../../flow-error.js";
-import { renderVerificationCli, verificationCancelModel, verificationStatusModel, verificationWaitModel, verificationWaitTimeoutModel, } from "../../render/verification.js";
-import { projectDirectory } from "../shared.js";
-export const handler = async (_stdin, flags, signal, positional) => {
-    const [operation, runId, ...extra] = positional;
-    if (!operation || !runId || extra.length > 0) {
-        throw new FlowError("EMPTY_PARAM", "verification requires wait, status, or cancel followed by one VerificationRun id");
-    }
-    // Honor --repo through the shared repository-resolution primitive.
-    const root = await projectDirectory(flags, "verification");
-    const json = flags.json === true;
-    if (operation === "wait") {
-        try {
-            // Observation only: timeout/abort end wait without requesting cancellation.
-            const terminal = await waitForVerificationRun({ root, runId, timeoutMs: flags.timeoutMs, signal });
-            return renderVerificationCli(verificationWaitModel(runId, terminal), json);
-        }
-        catch (error) {
-            if (error instanceof VerificationRunUnknownError) {
-                throw new FlowError("UNKNOWN_ADDRESS", error.message);
-            }
-            if (!(error instanceof VerificationRunWaitTimeoutError))
-                throw error;
-            return renderVerificationCli(verificationWaitTimeoutModel(runId), json);
-        }
-    }
-    if (operation === "status") {
-        const run = readVerificationRun(root, runId);
-        if (!run)
-            throw new FlowError("UNKNOWN_ADDRESS", `verification run '${runId}' does not exist`);
-        return renderVerificationCli(verificationStatusModel(run), json);
-    }
-    if (operation === "cancel") {
-        // Explicit cancel is the only mutating verification CLI path.
-        if (!readVerificationRun(root, runId)) {
-            throw new FlowError("UNKNOWN_ADDRESS", `verification run '${runId}' does not exist`);
-        }
-        const accepted = requestVerificationRunCancellation(root, runId);
-        return renderVerificationCli(verificationCancelModel(runId, accepted), json);
-    }
-    throw new FlowError("INVALID_USAGE", "verification operation must be wait, status, or cancel");
-};

package/build/cli/commands/verification/meta.js

@@ -1,13 +0,0 @@
-export const meta = {
-    command: "verification",
-    summary: "Observe or cancel one durable VerificationRun",
-    usage: [
-        "keiyaku verification wait RUN_ID [-C|--cwd DIR] [--repo DIR] [--timeout DURATION] [--json]",
-        "keiyaku verification cancel RUN_ID [-C|--cwd DIR] [--repo DIR] [--json]",
-        "keiyaku verification status RUN_ID [-C|--cwd DIR] [--repo DIR] [--json]",
-    ],
-    stdin: { mode: "argument" },
-    flags: ["cwd", "repo", "timeout", "json"],
-    purpose: "Rejoin, inspect, or request cancellation of an addressable VerificationRun without inspecting runtime SQLite directly.",
-    completionRank: 11,
-};