@danypops/papyrus 0.44.9 → 0.44.11

package/src/cli.ts

@@ -3,15 +3,25 @@ import { execFileSync } from "node:child_process";
 import { copyFileSync, existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { createNodeServiceInstallDeps, generateSystemdUnit, installUserService, type ServiceSpec } from "@danypops/vehicle-server/service";
-import { connectPapyrusClient, type PapyrusClient } from "./client.ts";
-import { DAEMON_UNIT_NAME, dbPath, TASK_EXECUTION_MAX_NODES } from "./constants.ts";
+import { runArtifactCli } from "./cli/artifact-command.ts";
+import { runDiscussCli } from "./cli/discuss-command.ts";
+import { runDocsCli } from "./cli/docs-command.ts";
+import { runGatesCli } from "./cli/gates-command.ts";
+import { runGraphCli } from "./cli/graph-command.ts";
+import { runGraphProjectionCli } from "./cli/graph-projection-command.ts";
+import { runLogCli } from "./cli/log-command.ts";
+import { runMigrationCli } from "./cli/migration-command.ts";
+import { runNoteCli } from "./cli/note-command.ts";
+import { runPlaybooksCli } from "./cli/playbooks-command.ts";
+import { runRulesCli } from "./cli/rules-command.ts";
+import { runSessionIdentityCli } from "./cli/session-identity-command.ts";
+import { runTaskCli } from "./cli/task-command.ts";
+import { connectPapyrusClient } from "./client.ts";
+import { DAEMON_UNIT_NAME, dbPath } from "./constants.ts";
 import { serveMain } from "./daemon/daemon.ts";
 import { daemonStateDir, vehicleHandlePath } from "./daemon/daemon-state.ts";
 import { openDb } from "./db.ts";
-import type { GateResult } from "./domain/gate.ts";
 import { applyIdMigration, type IdMigrationPlan, mirrorDatabase, planIdMigration, verifyIdMigration } from "./id-migration.ts";
-import type { TaskExecutionPlan } from "./task/task-execution.ts";
-import type { TaskBlockage, TaskCompletion } from "./task/task-service.ts";
 import { VERSION } from "./version.ts";
 
 export interface SystemdUnitOptions {
@@ -194,80 +204,7 @@ function usage(): never {
 	process.exit(2);
 }
 
-type TaskCliClient = Pick<PapyrusClient, "call">;
-type MigrationResult = { from: number; to: number; applied: string[] };
-type CliArtifact = { id: string; alias: string; title: string; status: string; body?: string };
-type CliTaskLease = {
-	taskId: string;
-	owner: string;
-	token: string;
-	claimedAt: string;
-	leaseExpiresAt: string;
-	heartbeatAt?: string;
-	note?: string;
-};
-type CliCompletion = Omit<TaskCompletion, "artifact" | "blocked"> & {
-	artifact: CliArtifact;
-	blocked: Array<Omit<TaskBlockage, "artifact"> & { artifact: CliArtifact }>;
-	gates: GateResult[];
-};
-
-function parseJsonObjectFlag(value: string | undefined, flag: string): Record<string, unknown> {
-	if (value === undefined) throw new Error(`${flag} requires a value`);
-	const parsed = JSON.parse(value) as unknown;
-	if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new Error(`${flag} must be a JSON object`);
-	return parsed as Record<string, unknown>;
-}
-
-function parseJsonStringArrayFlag(value: string | undefined, flag: string): string[] {
-	if (value === undefined) throw new Error(`${flag} requires a value`);
-	const parsed = JSON.parse(value) as unknown;
-	if (!Array.isArray(parsed) || parsed.some((entry) => typeof entry !== "string")) throw new Error(`${flag} must be a JSON string array`);
-	return parsed as string[];
-}
-
-/**
- * No shape assertion here -- playbooks --arguments-json is genuinely polymorphic (an array on
- * create, a {name: value} map on invoke, sharing one flag-parsing pass in runPlaybooksCli), and
- * --steps-json accepts a mix of plain prose strings and structured step objects (doc/rule/call/
- * task) that a single string-array assertion would wrongly reject. The service validates the
- * real shape for whichever operation actually receives it.
- */
-function parseJsonAnyFlag(value: string | undefined, flag: string): unknown {
-	if (value === undefined) throw new Error(`${flag} requires a value`);
-	return JSON.parse(value) as unknown;
-}
-
-function artifactLabel(artifact: CliArtifact): string {
-	return `${artifact.alias} ${artifact.title}`;
-}
-
-function planText(plan: TaskExecutionPlan): string {
-	const byId = new Map(plan.nodes.map((node) => [node.id, node]));
-	const lines = ["Execution order:"];
-	plan.layers.forEach((layer, index) => {
-		lines.push(`  Layer ${index + 1}:`);
-		for (const id of layer) {
-			const node = byId.get(id);
-			lines.push(node ? `    [${node.state}] ${node.id} ${node.title}` : `    [unknown] ${id}`);
-		}
-	});
-	if (plan.layers.length === 0) lines.push("  (no tasks)");
-	if (plan.cycleIds.length > 0) lines.push(`  Invalid cycle: ${plan.cycleIds.join(", ")}`);
-	return lines.join("\n");
-}
-
-export async function runMigrationCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional = args.filter((arg) => arg !== "--json");
-	if (positional.length !== 1 || positional[0] !== "schema") {
-		throw new Error("migrate requires exactly `schema`");
-	}
-	const result = await client.call<Record<string, never>, MigrationResult>("system.migrate", {});
-	if (json) return JSON.stringify(result);
-	if (result.applied.length === 0) return `Schema already current at version ${result.to}.`;
-	return `Migrated schema ${result.from} → ${result.to}: ${result.applied.join(", ")}`;
-}
+export { runMigrationCli };
 
 function readIdMap(sidecarPath: string): IdMigrationPlan {
 	const raw = JSON.parse(readFileSync(sidecarPath, "utf8")) as { idMap: Record<string, string> };
@@ -390,1839 +327,20 @@ export function runIdMigrationCli(args: string[]): string {
 	throw new Error("migrate-ids requires one of: mirror, validate, promote");
 }
 
-export async function runGraphCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	const input: Record<string, unknown> = {};
-	let depth: number | undefined;
-	let maxNodes: number | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		const flags: Record<string, string> = {
-			"--id": "id",
-			"--actor": "actor",
-			"--session-id": "session_id",
-			"--since": "since",
-			"--direction": "direction",
-		};
-		if (argument in flags) {
-			const value = args[++index];
-			if (!value) throw new Error(`${argument} requires a value`);
-			input[flags[argument]!] = value;
-			continue;
-		}
-		if (argument === "--limit" || argument === "--cursor") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error(`${argument} requires a numeric value`);
-			input[argument.slice(2)] = Number(value);
-			continue;
-		}
-		if (argument === "--depth") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--depth requires a numeric value");
-			depth = Number(value);
-			continue;
-		}
-		if (argument === "--max-nodes") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--max-nodes requires a numeric value");
-			maxNodes = Number(value);
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown graph option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, first, second, third] = positional;
-	if (action === "link") {
-		if (positional.length !== 4) throw new Error("graph link requires <from> <relation> <to>");
-		const result = await client.call<Record<string, unknown>, { ok: boolean }>("graph.link", { from: first, relation: second, to: third });
-		return json ? JSON.stringify(result) : `Linked ${first} --${second}--> ${third}`;
-	}
-	if (action === "unlink") {
-		if (positional.length !== 4) throw new Error("graph unlink requires <from> <relation> <to>");
-		const result = await client.call<Record<string, unknown>, { removed: boolean }>("graph.unlink", {
-			from: first,
-			relation: second,
-			to: third,
-		});
-		if (json) return JSON.stringify(result);
-		return result.removed ? `Unlinked ${first} --${second}--> ${third}` : `No such relationship: ${first} --${second}--> ${third}`;
-	}
-	if (action === "tree") {
-		if (positional.length !== 2) throw new Error("graph tree requires exactly one artifact id");
-		const artifact = await client.call<
-			Record<string, unknown>,
-			CliArtifact & { edges?: Array<{ from: string; relation: string; to: string }> }
-		>("graph.tree", { id: first, depth, max_nodes: maxNodes });
-		if (json) return JSON.stringify(artifact);
-		const edges = artifact.edges ?? [];
-		return edges.length === 0
-			? `${artifactLabel(artifact)} — no edges`
-			: `${artifactLabel(artifact)}\n${edges.map((edge) => `  ${edge.from} --${edge.relation}--> ${edge.to}`).join("\n")}`;
-	}
-	if (action === "status") {
-		if (positional.length !== 3) throw new Error("graph status requires <id> <status>");
-		const artifact = await client.call<Record<string, unknown>, CliArtifact>("graph.status", { id: first, status: second });
-		return json ? JSON.stringify(artifact) : `Updated ${artifact.id} → [${artifact.status}]`;
-	}
-	if (action !== "history") throw new Error("graph action must be link, unlink, tree, status, or history");
-	const page = await client.call<Record<string, unknown>, import("./artifact/artifact-event.ts").ArtifactEventPage>("graph.history", input);
-	if (json) return JSON.stringify(page);
-	if (page.events.length === 0) return "No recorded events.";
-	return page.events
-		.map((event) => {
-			const transition = event.fromStatus || event.toStatus ? ` ${event.fromStatus ?? "\u2205"} \u2192 ${event.toStatus ?? "\u2205"}` : "";
-			const relation = event.relation ? ` ${event.relation} \u2192 ${event.relatedId}` : "";
-			return `${event.occurredAt} ${event.artifactId} ${event.type}${transition}${relation} \u00b7 ${event.actor}/${event.source}${event.sessionId ? ` \u00b7 ${event.sessionId}` : ""}`;
-		})
-		.join("\n");
-}
-
-export async function runDocsCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let title: string | undefined;
-	let body: string | undefined;
-	let subtype: string | undefined;
-	let labels: string[] | undefined;
-	let extra: Record<string, unknown> | undefined;
-	let templateId: string | undefined;
-	let status: string | undefined;
-	let text: string | undefined;
-	let limit: number | undefined;
-	let projectRoot: string | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--title") {
-			title = args[++index];
-			if (title === undefined) throw new Error("--title requires a value");
-			continue;
-		}
-		if (argument === "--body") {
-			body = args[++index];
-			if (body === undefined) throw new Error("--body requires a value");
-			continue;
-		}
-		if (argument === "--subtype") {
-			subtype = args[++index];
-			if (!subtype) throw new Error("--subtype requires a value");
-			continue;
-		}
-		if (argument === "--labels-json") {
-			labels = parseJsonStringArrayFlag(args[++index], "--labels-json");
-			continue;
-		}
-		if (argument === "--extra-json") {
-			extra = parseJsonObjectFlag(args[++index], "--extra-json");
-			continue;
-		}
-		if (argument === "--template-id") {
-			templateId = args[++index];
-			if (!templateId) throw new Error("--template-id requires a value");
-			continue;
-		}
-		if (argument === "--status") {
-			status = args[++index];
-			if (!status) throw new Error("--status requires a value");
-			continue;
-		}
-		if (argument === "--text") {
-			text = args[++index];
-			if (text === undefined) throw new Error("--text requires a value");
-			continue;
-		}
-		if (argument === "--project-root") {
-			projectRoot = args[++index];
-			if (!projectRoot) throw new Error("--project-root requires a value");
-			continue;
-		}
-		if (argument === "--limit") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--limit requires a numeric value");
-			limit = Number(value);
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown docs option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, id, second, third] = positional;
-	let result: unknown;
-	let human: string;
-	switch (action) {
-		case "create": {
-			if (id) throw new Error("docs create accepts no positional arguments");
-			if (!title) throw new Error("docs create requires --title");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("docs.create", {
-				title,
-				body,
-				subtype,
-				labels,
-				extra,
-				template_id: templateId,
-				project_root: projectRoot,
-			});
-			result = artifact;
-			human = `Created document: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "list": {
-			if (id) throw new Error("docs list accepts no positional arguments");
-			const rows = await client.call<Record<string, unknown>, CliArtifact[]>("docs.list", {
-				status,
-				text,
-				limit,
-				project_root: projectRoot,
-			});
-			result = rows;
-			human = rows.length === 0 ? "No documents found." : rows.map((row) => artifactLabel(row)).join("\n");
-			break;
-		}
-		case "assign-project": {
-			if (!id || third !== undefined) throw new Error("docs assign-project requires <id> [project-root]");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("docs.assign_project", { id, project_root: second });
-			result = artifact;
-			human = second ? `Assigned ${id} to ${second}` : `Unscoped ${id}`;
-			break;
-		}
-		case "show": {
-			if (!id || second) throw new Error("docs show requires exactly one document id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("docs.show", { id });
-			result = artifact;
-			human = `${artifactLabel(artifact)}\n\n${artifact.body ?? ""}`;
-			break;
-		}
-		case "activate":
-		case "archive":
-		case "reopen": {
-			if (!id || second) throw new Error(`docs ${action} requires exactly one document id`);
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>(`docs.${action}`, { id });
-			result = artifact;
-			human = `${artifactLabel(artifact)}`;
-			break;
-		}
-		case "link": {
-			if (!id || !second || !third || positional.length !== 4) throw new Error("docs link requires <id> <relation> <target-id>");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("docs.link", { id, relation: second, target_id: third });
-			result = artifact;
-			human = `Linked ${id} --${second}--> ${third}`;
-			break;
-		}
-		case "update": {
-			if (!id || second) throw new Error("docs update requires exactly one document id");
-			if (title === undefined && body === undefined && labels === undefined)
-				throw new Error("docs update requires --title, --body, or --labels-json");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("docs.update", { id, title, body, labels });
-			result = artifact;
-			human = `${artifactLabel(artifact)}`;
-			break;
-		}
-		default:
-			throw new Error("docs action must be create, list, show, activate, archive, reopen, link, assign-project, or update");
-	}
-	return json ? JSON.stringify(result) : human;
-}
-
-export async function runRulesCli(args: string[], client: TaskCliClient, projectRoot: string = process.cwd()): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let title: string | undefined;
-	let body: string | undefined;
-	let condition: string | undefined;
-	let ruleAction: string | undefined;
-	let severity: string | undefined;
-	let labels: string[] | undefined;
-	let extra: Record<string, unknown> | undefined;
-	let status: string | undefined;
-	let text: string | undefined;
-	let limit: number | undefined;
-	let ruleProjectRoot: string | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--title") {
-			title = args[++index];
-			if (title === undefined) throw new Error("--title requires a value");
-			continue;
-		}
-		if (argument === "--body") {
-			body = args[++index];
-			if (body === undefined) throw new Error("--body requires a value");
-			continue;
-		}
-		if (argument === "--condition") {
-			condition = args[++index];
-			if (condition === undefined) throw new Error("--condition requires a value");
-			continue;
-		}
-		if (argument === "--rule-action") {
-			ruleAction = args[++index];
-			if (ruleAction === undefined) throw new Error("--rule-action requires a value");
-			continue;
-		}
-		if (argument === "--severity") {
-			severity = args[++index];
-			if (!severity) throw new Error("--severity requires a value");
-			continue;
-		}
-		if (argument === "--labels-json") {
-			labels = parseJsonStringArrayFlag(args[++index], "--labels-json");
-			continue;
-		}
-		if (argument === "--extra-json") {
-			extra = parseJsonObjectFlag(args[++index], "--extra-json");
-			continue;
-		}
-		if (argument === "--status") {
-			status = args[++index];
-			if (!status) throw new Error("--status requires a value");
-			continue;
-		}
-		if (argument === "--text") {
-			text = args[++index];
-			if (text === undefined) throw new Error("--text requires a value");
-			continue;
-		}
-		if (argument === "--project-root") {
-			ruleProjectRoot = args[++index];
-			if (!ruleProjectRoot) throw new Error("--project-root requires a value");
-			continue;
-		}
-		if (argument === "--limit") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--limit requires a numeric value");
-			limit = Number(value);
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown rules option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, id, second, third] = positional;
-	let result: unknown;
-	let human: string;
-	switch (action) {
-		case "create": {
-			if (id) throw new Error("rules create accepts no positional arguments");
-			if (!title) throw new Error("rules create requires --title");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("rules.create", {
-				title,
-				body,
-				condition,
-				rule_action: ruleAction,
-				severity,
-				labels,
-				extra,
-				project_root: ruleProjectRoot,
-			});
-			result = artifact;
-			human = `Created rule: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "list": {
-			if (id) throw new Error("rules list accepts no positional arguments");
-			const rows = await client.call<Record<string, unknown>, CliArtifact[]>("rules.list", {
-				status,
-				text,
-				limit,
-				project_root: ruleProjectRoot,
-			});
-			result = rows;
-			human = rows.length === 0 ? "No rules found." : rows.map((row) => artifactLabel(row)).join("\n");
-			break;
-		}
-		case "assign-project": {
-			if (!id || third !== undefined) throw new Error("rules assign-project requires <id> [project-root]");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("rules.assign_project", { id, project_root: second });
-			result = artifact;
-			human = second ? `Assigned ${id} to ${second}` : `Unscoped ${id}`;
-			break;
-		}
-		case "show": {
-			if (!id || second) throw new Error("rules show requires exactly one rule id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("rules.show", { id });
-			result = artifact;
-			human = `${artifactLabel(artifact)}\n\n${artifact.body ?? ""}`;
-			break;
-		}
-		case "preview": {
-			if (!id || second) throw new Error("rules preview requires exactly one rule id");
-			const preview = await client.call<Record<string, unknown>, string>("rules.preview", { id });
-			result = preview;
-			human = preview;
-			break;
-		}
-		case "enable":
-		case "disable": {
-			if (!id || second) throw new Error(`rules ${action} requires exactly one rule id`);
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>(`rules.${action}`, { id });
-			result = artifact;
-			human = `${artifactLabel(artifact)}`;
-			break;
-		}
-		case "gate": {
-			if (!id || !second || positional.length !== 3) throw new Error("rules gate requires <rule-id> <task-id>");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("rules.gate", { id, task_id: second });
-			result = artifact;
-			human = `Gated ${second} with rule ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "injectable": {
-			if (id) throw new Error("rules injectable accepts no positional arguments");
-			const rows = await client.call<Record<string, unknown>, CliArtifact[]>("rules.injectable", { project_root: projectRoot });
-			result = rows;
-			human = rows.length === 0 ? "No injectable rules." : rows.map((row) => row.title).join("\n");
-			break;
-		}
-		case "update": {
-			if (!id || second) throw new Error("rules update requires exactly one rule id");
-			if (title === undefined && body === undefined && labels === undefined)
-				throw new Error("rules update requires --title, --body, or --labels-json");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("rules.update", { id, title, body, labels });
-			result = artifact;
-			human = `${artifactLabel(artifact)}`;
-			break;
-		}
-		default:
-			throw new Error("rules action must be create, list, show, preview, enable, disable, gate, injectable, assign-project, or update");
-	}
-	return json ? JSON.stringify(result) : human;
-}
-
-export async function runPlaybooksCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let title: string | undefined;
-	let body: string | undefined;
-	let trigger: string | undefined;
-	let steps: unknown;
-	let tools: string[] | undefined;
-	let labels: string[] | undefined;
-	let extra: Record<string, unknown> | undefined;
-	let playbookArguments: unknown;
-	let runId: string | undefined;
-	let status: string | undefined;
-	let text: string | undefined;
-	let limit: number | undefined;
-	let playbookProjectRoot: string | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--title") {
-			title = args[++index];
-			if (title === undefined) throw new Error("--title requires a value");
-			continue;
-		}
-		if (argument === "--body") {
-			body = args[++index];
-			if (body === undefined) throw new Error("--body requires a value");
-			continue;
-		}
-		if (argument === "--trigger") {
-			trigger = args[++index];
-			if (trigger === undefined) throw new Error("--trigger requires a value");
-			continue;
-		}
-		if (argument === "--steps-json") {
-			steps = parseJsonAnyFlag(args[++index], "--steps-json");
-			continue;
-		}
-		if (argument === "--tools-json") {
-			tools = parseJsonStringArrayFlag(args[++index], "--tools-json");
-			continue;
-		}
-		if (argument === "--labels-json") {
-			labels = parseJsonStringArrayFlag(args[++index], "--labels-json");
-			continue;
-		}
-		if (argument === "--extra-json") {
-			extra = parseJsonObjectFlag(args[++index], "--extra-json");
-			continue;
-		}
-		if (argument === "--arguments-json") {
-			playbookArguments = parseJsonAnyFlag(args[++index], "--arguments-json");
-			continue;
-		}
-		if (argument === "--run-id") {
-			runId = args[++index];
-			if (!runId) throw new Error("--run-id requires a value");
-			continue;
-		}
-		if (argument === "--status") {
-			status = args[++index];
-			if (!status) throw new Error("--status requires a value");
-			continue;
-		}
-		if (argument === "--text") {
-			text = args[++index];
-			if (text === undefined) throw new Error("--text requires a value");
-			continue;
-		}
-		if (argument === "--project-root") {
-			playbookProjectRoot = args[++index];
-			if (!playbookProjectRoot) throw new Error("--project-root requires a value");
-			continue;
-		}
-		if (argument === "--limit") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--limit requires a numeric value");
-			limit = Number(value);
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown playbooks option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, id, second] = positional;
-	let result: unknown;
-	let human: string;
-	switch (action) {
-		case "create": {
-			if (id) throw new Error("playbooks create accepts no positional arguments");
-			if (!title) throw new Error("playbooks create requires --title");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.create", {
-				title,
-				body,
-				trigger,
-				steps,
-				tools,
-				labels,
-				extra,
-				arguments: playbookArguments,
-				project_root: playbookProjectRoot,
-			});
-			result = artifact;
-			human = `Created playbook: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "list": {
-			if (id) throw new Error("playbooks list accepts no positional arguments");
-			const rows = await client.call<Record<string, unknown>, CliArtifact[]>("playbooks.list", {
-				status,
-				text,
-				limit,
-				project_root: playbookProjectRoot,
-			});
-			result = rows;
-			human = rows.length === 0 ? "No playbooks found." : rows.map((row) => artifactLabel(row)).join("\n");
-			break;
-		}
-		case "show": {
-			if (!id || second) throw new Error("playbooks show requires exactly one playbook id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.show", { id });
-			result = artifact;
-			human = `${artifactLabel(artifact)}\n\n${artifact.body ?? ""}`;
-			break;
-		}
-		case "preview": {
-			if (!id || second) throw new Error("playbooks preview requires exactly one playbook id");
-			const rendered = await client.call<Record<string, unknown>, string>("playbooks.preview", { id, arguments: playbookArguments });
-			result = rendered;
-			human = rendered;
-			break;
-		}
-		case "invoke": {
-			if (!id || second) throw new Error("playbooks invoke requires exactly one playbook id");
-			const invocation = await client.call<Record<string, unknown>, { entryTaskId: string; missingArguments?: string[] }>(
-				"playbooks.invoke",
-				{ id, arguments: playbookArguments, run_id: runId, project_root: playbookProjectRoot },
-			);
-			result = invocation;
-			human = invocation.missingArguments
-				? `Missing required argument(s): ${invocation.missingArguments.join(", ")}.`
-				: `Invoked: entry task ${invocation.entryTaskId} focused. Drive it forward with \`tasks start/submit/complete\` like any other task.`;
-			break;
-		}
-		case "enable":
-		case "disable": {
-			if (!id || second) throw new Error(`playbooks ${action} requires exactly one playbook id`);
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>(`playbooks.${action}`, { id });
-			result = artifact;
-			human = `${artifactLabel(artifact)}`;
-			break;
-		}
-		case "assign-project": {
-			if (!id || (second === undefined && positional.length > 2)) throw new Error("playbooks assign-project requires <id> [project-root]");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.assign_project", { id, project_root: second });
-			result = artifact;
-			human = second ? `Assigned ${id} to ${second}` : `Unscoped ${id}`;
-			break;
-		}
-		case "update": {
-			if (!id || second) throw new Error("playbooks update requires exactly one playbook id");
-			if (title === undefined && body === undefined && labels === undefined)
-				throw new Error("playbooks update requires --title, --body, or --labels-json");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.update", { id, title, body, labels });
-			result = artifact;
-			human = `${artifactLabel(artifact)}`;
-			break;
-		}
-		case "contain": {
-			if (!id || !second || positional.length !== 3) throw new Error("playbooks contain requires a parent id and child id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.contain", { parent_id: id, child_id: second });
-			result = artifact;
-			human = `Nested: ${second} → ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "uncontain": {
-			if (!id || !second || positional.length !== 3) throw new Error("playbooks uncontain requires a parent id and child id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.uncontain", { parent_id: id, child_id: second });
-			result = artifact;
-			human = `Removed ${second} from ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "depend": {
-			if (!id || !second || positional.length !== 3) throw new Error("playbooks depend requires a playbook id and prerequisite id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.depend", { id, dependency_id: second });
-			result = artifact;
-			human = `Dependency added: ${artifactLabel(artifact)} waits for ${second}`;
-			break;
-		}
-		case "undepend": {
-			if (!id || !second || positional.length !== 3) throw new Error("playbooks undepend requires a playbook id and prerequisite id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("playbooks.undepend", { id, dependency_id: second });
-			result = artifact;
-			human = `Dependency removed: ${artifactLabel(artifact)} no longer waits for ${second}`;
-			break;
-		}
-		default:
-			throw new Error(
-				"playbooks action must be create, list, show, invoke, preview, enable, disable, assign-project, update, contain, uncontain, depend, or undepend",
-			);
-	}
-	return json ? JSON.stringify(result) : human;
-}
-
-export async function runArtifactCli(args: string[], client: TaskCliClient, projectRoot: string = process.cwd()): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let kind: string | undefined;
-	let title: string | undefined;
-	let body: string | undefined;
-	let status: string | undefined;
-	let subtype: string | undefined;
-	let labels: string[] | undefined;
-	let extra: Record<string, unknown> | undefined;
-	let templateId: string | undefined;
-	let reason: string | undefined;
-	let text: string | undefined;
-	let limit: number | undefined;
-	let depth: number | undefined;
-	let maxNodes: number | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--kind") {
-			kind = args[++index];
-			if (!kind) throw new Error("--kind requires a value");
-			continue;
-		}
-		if (argument === "--title") {
-			title = args[++index];
-			if (title === undefined) throw new Error("--title requires a value");
-			continue;
-		}
-		if (argument === "--body") {
-			body = args[++index];
-			if (body === undefined) throw new Error("--body requires a value");
-			continue;
-		}
-		if (argument === "--status") {
-			status = args[++index];
-			if (!status) throw new Error("--status requires a value");
-			continue;
-		}
-		if (argument === "--subtype") {
-			subtype = args[++index];
-			if (!subtype) throw new Error("--subtype requires a value");
-			continue;
-		}
-		if (argument === "--labels-json") {
-			labels = parseJsonStringArrayFlag(args[++index], "--labels-json");
-			continue;
-		}
-		if (argument === "--extra-json") {
-			extra = parseJsonObjectFlag(args[++index], "--extra-json");
-			continue;
-		}
-		if (argument === "--template-id") {
-			templateId = args[++index];
-			if (!templateId) throw new Error("--template-id requires a value");
-			continue;
-		}
-		if (argument === "--reason") {
-			reason = args[++index];
-			if (reason === undefined) throw new Error("--reason requires a value");
-			continue;
-		}
-		if (argument === "--text") {
-			text = args[++index];
-			if (text === undefined) throw new Error("--text requires a value");
-			continue;
-		}
-		if (argument === "--limit") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--limit requires a numeric value");
-			limit = Number(value);
-			continue;
-		}
-		if (argument === "--depth") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--depth requires a numeric value");
-			depth = Number(value);
-			continue;
-		}
-		if (argument === "--max-nodes") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--max-nodes requires a numeric value");
-			maxNodes = Number(value);
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown artifact option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, id] = positional;
-	let result: unknown;
-	let human: string;
-	switch (action) {
-		case "create": {
-			if (id) throw new Error("artifact create accepts no positional arguments");
-			if (!kind && !templateId) throw new Error("artifact create requires --kind (or --template-id)");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("artifact.create", {
-				kind,
-				title,
-				body,
-				status,
-				subtype,
-				labels,
-				extra,
-				template_id: templateId,
-				...(kind === "task" ? { project_root: projectRoot } : {}),
-			});
-			result = artifact;
-			human = `Created: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "query": {
-			if (id) throw new Error("artifact query accepts no positional arguments");
-			const rows = await client.call<Record<string, unknown>, CliArtifact[]>("artifact.query", { kind, status, text, limit });
-			result = rows;
-			human = rows.length === 0 ? "No artifacts found." : rows.map((row) => artifactLabel(row)).join("\n");
-			break;
-		}
-		case "show": {
-			if (!id) throw new Error("artifact show requires exactly one artifact id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("artifact.show", { id, depth, max_nodes: maxNodes });
-			result = artifact;
-			human = `${artifactLabel(artifact)}\n\n${artifact.body ?? ""}`;
-			break;
-		}
-		case "remove": {
-			if (!id) throw new Error("artifact remove requires exactly one artifact id");
-			const record = await client.call<
-				Record<string, unknown>,
-				{ artifactId: string; trashedAt: string; purgeAfter: string; reason?: string }
-			>("artifact.remove", { id, reason });
-			result = record;
-			human = `Trashed ${record.artifactId}: eligible for purge at ${record.purgeAfter}`;
-			break;
-		}
-		case "remove-subtree": {
-			if (!id) throw new Error("artifact remove-subtree requires exactly one artifact id");
-			const outcome = await client.call<Record<string, unknown>, { removed: string[]; skipped: string[] }>("artifact.remove_subtree", {
-				id,
-				reason,
-			});
-			result = outcome;
-			human = `Trashed ${outcome.removed.length} artifact(s)${outcome.skipped.length > 0 ? `, skipped ${outcome.skipped.length} already-trashed` : ""}.`;
-			break;
-		}
-		case "restore": {
-			if (!id) throw new Error("artifact restore requires exactly one artifact id");
-			const outcome = await client.call<Record<string, unknown>, { restored: boolean }>("artifact.restore", { id });
-			result = outcome;
-			human = outcome.restored ? `Restored ${id}` : `${id} was not trashed`;
-			break;
-		}
-		case "trash-status": {
-			if (!id) throw new Error("artifact trash-status requires exactly one artifact id");
-			const record = await client.call<
-				Record<string, unknown>,
-				{ artifactId: string; trashedAt: string; purgeAfter: string; reason?: string } | null
-			>("artifact.trash_status", { id });
-			result = record;
-			human = record
-				? `${record.artifactId}: trashed at ${record.trashedAt}, purge eligible at ${record.purgeAfter}`
-				: `${id} is not trashed`;
-			break;
-		}
-		case "trash-list": {
-			if (id) throw new Error("artifact trash-list accepts no positional arguments");
-			const rows = await client.call<
-				Record<string, unknown>,
-				Array<{ artifactId: string; trashedAt: string; purgeAfter: string; reason?: string }>
-			>("artifact.trash_list", {});
-			result = rows;
-			human =
-				rows.length === 0 ? "Trash is empty." : rows.map((row) => `${row.artifactId}: purge eligible at ${row.purgeAfter}`).join("\n");
-			break;
-		}
-		default:
-			throw new Error("artifact action must be create, query, show, remove, remove-subtree, restore, trash-status, or trash-list");
-	}
-	return json ? JSON.stringify(result) : human;
-}
-
-export async function runGatesCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional = args.filter((arg) => arg !== "--json");
-	if (positional.length !== 2 || positional[0] !== "run") throw new Error("gates requires `run <id>`");
-	const results = await client.call<Record<string, unknown>, GateResult[]>("gates.run", { id: positional[1] });
-	if (json) return JSON.stringify(results);
-	return results.length === 0
-		? "No gates configured."
-		: results.map((gate) => `${gate.passed ? "✓" : "✗"} ${gate.gate.type}: ${gate.gate.target} — ${gate.output}`).join("\n");
-}
-
-export async function runGraphProjectionCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let batch: Record<string, unknown> | undefined;
-	let producerId: string | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--batch-json") {
-			batch = parseJsonObjectFlag(args[++index], "--batch-json");
-			continue;
-		}
-		if (argument === "--producer-id") {
-			producerId = args[++index];
-			if (!producerId) throw new Error("--producer-id requires a value");
-			continue;
-		}
-		positional.push(argument);
-	}
-	const [action] = positional;
-	if (action === "apply") {
-		if (!batch) throw new Error("graph-projection apply requires --batch-json");
-		const result = await client.call<Record<string, unknown>, unknown>("graph_projection.apply", batch);
-		return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-	}
-	if (action === "checkpoint") {
-		if (!producerId) throw new Error("graph-projection checkpoint requires --producer-id");
-		const result = await client.call<Record<string, unknown>, unknown>("graph_projection.checkpoint", { producer_id: producerId });
-		if (json) return JSON.stringify(result);
-		return result === null ? `No projection checkpoint for producer "${producerId}".` : JSON.stringify(result, null, 2);
-	}
-	throw new Error("graph-projection action must be apply or checkpoint");
-}
-
-export async function runLogCli(args: string[], client: TaskCliClient, projectRoot: string = process.cwd()): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let source: string | undefined;
-	let sourceLabel: string | undefined;
-	let level: string | undefined;
-	let message: string | undefined;
-	let operationId: string | undefined;
-	let sessionId: string | undefined;
-	let occurredAt: string | undefined;
-	let since: string | undefined;
-	let limit: number | undefined;
-	let fields: Record<string, unknown> | undefined;
-	let global = false;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--global") {
-			global = true;
-			continue;
-		}
-		if (argument === "--fields-json") {
-			fields = parseJsonObjectFlag(args[++index], "--fields-json");
-			continue;
-		}
-		if (
-			[
-				"--source",
-				"--source-label",
-				"--level",
-				"--message",
-				"--operation-id",
-				"--session-id",
-				"--occurred-at",
-				"--since",
-				"--limit",
-			].includes(argument)
-		) {
-			const value = args[++index];
-			if (value === undefined) throw new Error(`${argument} requires a value`);
-			if (argument === "--source") source = value;
-			else if (argument === "--source-label") sourceLabel = value;
-			else if (argument === "--level") level = value;
-			else if (argument === "--message") message = value;
-			else if (argument === "--operation-id") operationId = value;
-			else if (argument === "--session-id") sessionId = value;
-			else if (argument === "--occurred-at") occurredAt = value;
-			else if (argument === "--since") since = value;
-			else {
-				limit = Number(value);
-				if (!Number.isInteger(limit)) throw new Error("--limit requires an integer");
-			}
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown log option ${argument}`);
-		positional.push(argument);
-	}
-	const [action] = positional;
-	if (action === "append") {
-		if (!source) throw new Error("log append requires --source");
-		if (!level) throw new Error("log append requires --level");
-		if (!message) throw new Error("log append requires --message");
-		if (!operationId) throw new Error("log append requires --operation-id");
-		const result = await client.call("logs.append", {
-			source_id: source,
-			...(sourceLabel ? { source_label: sourceLabel } : {}),
-			...(global ? {} : { project_root: projectRoot }),
-			level,
-			message,
-			operation_id: operationId,
-			...(fields ? { fields } : {}),
-			...(sessionId ? { session_id: sessionId } : {}),
-			...(occurredAt ? { occurred_at: occurredAt } : {}),
-		});
-		return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-	}
-	if (action === "query") {
-		if (!source) throw new Error("log query requires --source");
-		const result = await client.call<Record<string, unknown>, { entries: unknown[]; truncated: boolean }>("logs.query", {
-			source_id: source,
-			...(since ? { since } : {}),
-			...(level ? { level } : {}),
-			...(limit === undefined ? {} : { limit }),
-		});
-		if (json) return JSON.stringify(result);
-		const lines = result.entries.map((entry) => JSON.stringify(entry));
-		return [...lines, result.truncated ? `(truncated -- more entries exist beyond this page)` : `(${lines.length} entries)`].join("\n");
-	}
-	throw new Error("log action must be append or query");
-}
-
-export async function runSessionIdentityCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let sessionId: string | undefined;
-	let secret: string | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--session-id") {
-			sessionId = args[++index];
-			continue;
-		}
-		if (argument === "--session-secret") {
-			secret = args[++index];
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown session option ${argument}`);
-		positional.push(argument);
-	}
-	const [action] = positional;
-	if (action === "register") {
-		if (!sessionId) throw new Error("session register requires --session-id");
-		const result = await client.call<Record<string, unknown>, { sessionId: string; secret: string }>("session.register", {
-			session_id: sessionId,
-		});
-		return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-	}
-	if (action === "release") {
-		if (!sessionId) throw new Error("session release requires --session-id");
-		const result = await client.call<Record<string, unknown>, { released: boolean }>("session.release", {
-			session_id: sessionId,
-			...(secret ? { session_secret: secret } : {}),
-		});
-		return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-	}
-	throw new Error("session action must be register or release");
-}
-
-export async function runDiscussCli(args: string[], client: TaskCliClient): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let title: string | undefined;
-	let actor: string | undefined;
-	let content: string | undefined;
-	let body: string | undefined;
-	let labels: string[] | undefined;
-	let blocksTaskIds: string[] | undefined;
-	let taskId: string | undefined;
-	let reason: string | undefined;
-	let settlement: string | undefined;
-	let state: string | undefined;
-	let afterRound: number | undefined;
-	let limit: number | undefined;
-	let options: string[] | undefined;
-	let optionsMode: string | undefined;
-	let optionDescriptions: string[] | undefined;
-	let selected: string[] | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--title") {
-			title = args[++index];
-			if (!title) throw new Error("--title requires a value");
-			continue;
-		}
-		if (argument === "--actor") {
-			actor = args[++index];
-			if (!actor) throw new Error("--actor requires a value");
-			continue;
-		}
-		if (argument === "--content") {
-			content = args[++index];
-			if (content === undefined) throw new Error("--content requires a value");
-			continue;
-		}
-		if (argument === "--body") {
-			body = args[++index];
-			if (body === undefined) throw new Error("--body requires a value");
-			continue;
-		}
-		if (argument === "--labels-json") {
-			labels = parseJsonStringArrayFlag(args[++index], "--labels-json");
-			continue;
-		}
-		if (argument === "--blocks-json") {
-			blocksTaskIds = parseJsonStringArrayFlag(args[++index], "--blocks-json");
-			continue;
-		}
-		if (argument === "--task-id") {
-			taskId = args[++index];
-			if (!taskId) throw new Error("--task-id requires a value");
-			continue;
-		}
-		if (argument === "--options-json") {
-			options = parseJsonStringArrayFlag(args[++index], "--options-json");
-			continue;
-		}
-		if (argument === "--options-mode") {
-			optionsMode = args[++index];
-			if (!optionsMode) throw new Error("--options-mode requires a value");
-			continue;
-		}
-		if (argument === "--option-descriptions-json") {
-			optionDescriptions = parseJsonStringArrayFlag(args[++index], "--option-descriptions-json");
-			continue;
-		}
-		if (argument === "--selected-json") {
-			selected = parseJsonStringArrayFlag(args[++index], "--selected-json");
-			continue;
-		}
-		if (argument === "--reason") {
-			reason = args[++index];
-			if (reason === undefined) throw new Error("--reason requires a value");
-			continue;
-		}
-		if (argument === "--settlement") {
-			settlement = args[++index];
-			if (!settlement) throw new Error("--settlement requires a value");
-			continue;
-		}
-		if (argument === "--state") {
-			state = args[++index];
-			if (!state) throw new Error("--state requires a value");
-			continue;
-		}
-		if (argument === "--after-round") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--after-round requires a numeric value");
-			afterRound = Number(value);
-			continue;
-		}
-		if (argument === "--limit") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--limit requires a numeric value");
-			limit = Number(value);
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown discuss option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, id] = positional;
-	switch (action) {
-		case "open": {
-			if (id) throw new Error("discuss open accepts no positional arguments");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.open", {
-				title,
-				actor,
-				content,
-				body,
-				labels,
-				blocks_task_ids: blocksTaskIds,
-				options,
-				options_mode: optionsMode,
-				option_descriptions: optionDescriptions,
-			});
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "reply": {
-			if (!id) throw new Error("discuss reply requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.reply", {
-				id,
-				actor,
-				content,
-				selected,
-				options,
-				options_mode: optionsMode,
-				option_descriptions: optionDescriptions,
-			});
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "defer": {
-			if (!id) throw new Error("discuss defer requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.defer", { id, reason });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "resume": {
-			if (!id) throw new Error("discuss resume requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.resume", { id });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "settle": {
-			if (!id) throw new Error("discuss settle requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.settle", { id, settlement });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "block": {
-			if (!id) throw new Error("discuss block requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.block", { id, task_id: taskId });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "unblock": {
-			if (!id) throw new Error("discuss unblock requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.unblock", { id, task_id: taskId });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "show": {
-			if (!id) throw new Error("discuss show requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.show", { id });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "rounds": {
-			if (!id) throw new Error("discuss rounds requires exactly one discussion id");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.rounds", { id, after_round: afterRound, limit });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		case "list": {
-			if (id) throw new Error("discuss list accepts no positional arguments");
-			const result = await client.call<Record<string, unknown>, unknown>("discuss.list", { state, limit });
-			return json ? JSON.stringify(result) : JSON.stringify(result, null, 2);
-		}
-		default:
-			throw new Error("discuss action must be open, reply, defer, resume, settle, block, unblock, show, rounds, or list");
-	}
-}
-
-export async function runNoteCli(args: string[], client: TaskCliClient, projectRoot: string = process.cwd()): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	let title: string | undefined;
-	let status: string | undefined;
-	let text: string | undefined;
-	let reason: string | undefined;
-	let limit: number | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (["--title", "--status", "--text", "--reason", "--limit"].includes(argument)) {
-			const value = args[++index];
-			if (value === undefined) throw new Error(`${argument} requires a value`);
-			if (argument === "--title") title = value;
-			else if (argument === "--status") status = value;
-			else if (argument === "--text") text = value;
-			else if (argument === "--reason") reason = value;
-			else {
-				limit = Number(value);
-				if (!Number.isInteger(limit)) throw new Error("--limit requires an integer");
-			}
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown notes option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, id, target] = positional;
-	let result: CliArtifact | CliArtifact[] | import("./domain/note-event.ts").NoteHistoryPage;
-	let human: string;
-	if (action === "capture") {
-		if (!id || target) throw new Error("notes capture requires exactly one request argument");
-		result = (await client.call("notes.capture", {
-			body: id,
-			...(title ? { title } : {}),
-			project_root: projectRoot,
-			actor: "human",
-			source: "cli",
-		})) as CliArtifact;
-		human = `Captured: ${artifactLabel(result)}`;
-	} else if (action === "list") {
-		if (id) throw new Error("notes list accepts no positional arguments");
-		result = (await client.call("notes.list", {
-			project_root: projectRoot,
-			...(status ? { status } : {}),
-			...(text ? { text } : {}),
-			...(limit === undefined ? {} : { limit }),
-		})) as CliArtifact[];
-		human = result.length > 0 ? result.map((note) => `[${note.status}] ${artifactLabel(note)}`).join("\n") : "No open notes.";
-	} else if (action === "show") {
-		if (!id || target) throw new Error("notes show requires exactly one note id");
-		result = (await client.call("notes.show", { id, project_root: projectRoot })) as CliArtifact;
-		human = `${artifactLabel(result)}\n\n${result.body ?? ""}`.trimEnd();
-	} else if (action === "history") {
-		if (!id || target) throw new Error("notes history requires exactly one note id");
-		const page = await client.call<Record<string, unknown>, import("./domain/note-event.ts").NoteHistoryPage>("notes.history", {
-			id,
-			project_root: projectRoot,
-			direction: "desc",
-			...(limit === undefined ? {} : { limit }),
-		});
-		result = page;
-		human =
-			page.events.length === 0
-				? `No recorded history for ${id}.`
-				: [...page.events]
-						.reverse()
-						.map(
-							(event) =>
-								`${event.occurredAt} ${event.type} · ${event.actor}/${event.source}${event.relatedId ? ` · ${event.relatedId}` : ""}${event.disposition ? ` · ${event.disposition}` : ""}${event.reason ? ` · ${event.reason}` : ""}`,
-						)
-						.join("\n");
-	} else if (action === "consume") {
-		if (!id || target) throw new Error("notes consume requires exactly one note id");
-		result = (await client.call("notes.consume", {
-			id,
-			project_root: projectRoot,
-			actor: "agent",
-			source: "cli",
-			...(reason ? { reason } : {}),
-		})) as CliArtifact;
-		human = `Consumed: ${artifactLabel(result)}`;
-	} else if (action === "promote") {
-		if (!id || !target || positional.length !== 3) throw new Error("notes promote requires a note id and target artifact id");
-		result = (await client.call("notes.promote", {
-			id,
-			target_id: target,
-			project_root: projectRoot,
-			actor: "agent",
-			source: "cli",
-			...(reason ? { reason } : {}),
-		})) as CliArtifact;
-		human = `Promoted: ${artifactLabel(result)} → ${target}`;
-	} else if (action === "archive") {
-		if (!id || !target || positional.length !== 3) throw new Error("notes archive requires a note id and disposition");
-		result = (await client.call("notes.archive", {
-			id,
-			disposition: target,
-			project_root: projectRoot,
-			actor: "human",
-			source: "cli",
-			...(reason ? { reason } : {}),
-		})) as CliArtifact;
-		human = `Archived: ${artifactLabel(result)} · ${target}`;
-	} else {
-		throw new Error("notes action must be capture, list, show, history, consume, promote, or archive");
-	}
-	return json ? JSON.stringify(result) : human;
-}
-
-export async function runTaskCli(args: string[], client: TaskCliClient, projectRoot: string = process.cwd()): Promise<string> {
-	const json = args.includes("--json");
-	const positional: string[] = [];
-	const updateInput: { title?: string; body?: string; labels?: string[]; status?: "todo" } = {};
-	let reason: string | undefined;
-	let sessionId: string | undefined;
-	let sessionSecret: string | undefined;
-	let title: string | undefined;
-	let body: string | undefined;
-	let status: string | undefined;
-	let labels: string[] | undefined;
-	let extra: Record<string, unknown> | undefined;
-	let gates: unknown[] | undefined;
-	let checklist: Record<string, unknown> | undefined;
-	let templateId: string | undefined;
-	let parentId: string | undefined;
-	let dependsOn: string[] | undefined;
-	let text: string | undefined;
-	let limit: number | undefined;
-	let listScope: "project" | "graph" | "all" | undefined;
-	let rootTaskId: string | undefined;
-	let owner: string | undefined;
-	let token: string | undefined;
-	let ttlMs: number | undefined;
-	let note: string | undefined;
-	let cursor: number | undefined;
-	let eventTypes: string[] | undefined;
-	for (let index = 0; index < args.length; index++) {
-		const argument = args[index]!;
-		if (argument === "--json") continue;
-		if (argument === "--session-id") {
-			sessionId = args[++index];
-			if (!sessionId) throw new Error("--session-id requires a value");
-			continue;
-		}
-		if (argument === "--session-secret") {
-			sessionSecret = args[++index];
-			if (!sessionSecret) throw new Error("--session-secret requires a value");
-			continue;
-		}
-		if (
-			argument === "--title" ||
-			argument === "--body" ||
-			argument === "--labels-json" ||
-			argument === "--status" ||
-			argument === "--reason"
-		) {
-			const value = args[++index];
-			if (value === undefined) throw new Error(`${argument} requires a value`);
-			if (argument === "--title") {
-				updateInput.title = value;
-				title = value;
-			} else if (argument === "--body") {
-				updateInput.body = value;
-				body = value;
-			} else if (argument === "--reason") reason = value;
-			else if (argument === "--status") {
-				status = value;
-				if (value === "todo") updateInput.status = value;
-			} else {
-				labels = parseJsonStringArrayFlag(value, "--labels-json");
-				updateInput.labels = labels;
-			}
-			continue;
-		}
-		if (argument === "--extra-json") {
-			extra = parseJsonObjectFlag(args[++index]!, "--extra-json");
-			continue;
-		}
-		if (argument === "--gates-json") {
-			const value = args[++index];
-			if (!value) throw new Error("--gates-json requires a value");
-			const parsed = JSON.parse(value) as unknown;
-			if (!Array.isArray(parsed)) throw new Error("--gates-json must be a JSON array");
-			gates = parsed;
-			continue;
-		}
-		if (argument === "--checklist-json") {
-			checklist = parseJsonObjectFlag(args[++index]!, "--checklist-json");
-			continue;
-		}
-		if (argument === "--template-id") {
-			templateId = args[++index];
-			if (!templateId) throw new Error("--template-id requires a value");
-			continue;
-		}
-		if (argument === "--parent-id") {
-			parentId = args[++index];
-			if (!parentId) throw new Error("--parent-id requires a value");
-			continue;
-		}
-		if (argument === "--depends-on-json") {
-			dependsOn = parseJsonStringArrayFlag(args[++index]!, "--depends-on-json");
-			continue;
-		}
-		if (argument === "--text") {
-			text = args[++index];
-			if (text === undefined) throw new Error("--text requires a value");
-			continue;
-		}
-		if (argument === "--limit") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--limit requires a numeric value");
-			limit = Number(value);
-			continue;
-		}
-		if (argument === "--scope") {
-			const value = args[++index];
-			if (value !== "project" && value !== "graph" && value !== "all") throw new Error("--scope must be project, graph, or all");
-			listScope = value;
-			continue;
-		}
-		if (argument === "--root-task-id") {
-			rootTaskId = args[++index];
-			if (!rootTaskId) throw new Error("--root-task-id requires a value");
-			continue;
-		}
-		if (argument === "--owner") {
-			owner = args[++index];
-			if (!owner) throw new Error("--owner requires a value");
-			continue;
-		}
-		if (argument === "--token") {
-			token = args[++index];
-			if (!token) throw new Error("--token requires a value");
-			continue;
-		}
-		if (argument === "--note") {
-			note = args[++index];
-			if (note === undefined) throw new Error("--note requires a value");
-			continue;
-		}
-		if (argument === "--ttl-ms") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--ttl-ms requires a numeric value");
-			ttlMs = Number(value);
-			continue;
-		}
-		if (argument === "--cursor") {
-			const value = args[++index];
-			if (!value || Number.isNaN(Number(value))) throw new Error("--cursor requires a numeric value");
-			cursor = Number(value);
-			continue;
-		}
-		if (argument === "--event-types-json") {
-			eventTypes = parseJsonStringArrayFlag(args[++index]!, "--event-types-json");
-			continue;
-		}
-		if (argument.startsWith("--")) throw new Error(`unknown tasks option ${argument}`);
-		positional.push(argument);
-	}
-	const [action, id, dependencyId] = positional;
-	const reasonSupportedActions = new Set(["update", "depend", "undepend", "contain", "uncontain"]);
-	if (reason !== undefined && !reasonSupportedActions.has(action ?? ""))
-		throw new Error("--reason is only supported by tasks update, depend, undepend, contain, and uncontain");
-	const sessionScope = sessionId ? { session_id: sessionId } : {};
-	// Only meaningful alongside a registered session_id (see session.register); required by the
-	// daemon only for the specific Focus-mutating operations below (focus/pause/unpause/clear_focus)
-	// once that session_id has been armored (see session-identity-service.ts assertAuthorized).
-	const sessionSecretField = sessionSecret ? { session_secret: sessionSecret } : {};
-	let result: unknown;
-	let human: string;
-	switch (action) {
-		case "active": {
-			if (id) throw new Error("tasks active accepts no positional arguments");
-			const active = await client.call<Record<string, unknown>, CliArtifact | null>("tasks.active", {
-				project_root: projectRoot,
-				...sessionScope,
-			});
-			result = active;
-			human = active ? `Active: ${artifactLabel(active)}` : "No active task.";
-			break;
-		}
-		case "focused": {
-			if (id) throw new Error("tasks focused accepts no positional arguments");
-			const focus = await client.call<
-				Record<string, unknown>,
-				{ artifact: CliArtifact; status: "active" | "paused"; updatedAt: string } | null
-			>("tasks.focused", { project_root: projectRoot, ...sessionScope });
-			result = focus;
-			human = focus ? `Focused (${focus.status}): ${artifactLabel(focus.artifact)}` : "No focused task.";
-			break;
-		}
-		case "pause":
-		case "unpause": {
-			if (id) throw new Error(`tasks ${action} accepts no positional arguments`);
-			const operation = action === "pause" ? "tasks.pause" : "tasks.unpause";
-			const focus = await client.call<Record<string, unknown>, { artifact: CliArtifact; status: string }>(operation, {
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-				...sessionSecretField,
-			});
-			result = focus;
-			human = `Focused (${focus.status}): ${artifactLabel(focus.artifact)}`;
-			break;
-		}
-		case "clear-focus": {
-			if (id) throw new Error("tasks clear-focus accepts no positional arguments");
-			const cleared = await client.call<Record<string, unknown>, { cleared: boolean }>("tasks.clear_focus", {
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-				...sessionSecretField,
-			});
-			result = cleared;
-			human = cleared.cleared ? "Task focus cleared." : "No focused task.";
-			break;
-		}
-		case "reap-stale-focus": {
-			if (id) throw new Error("tasks reap-stale-focus accepts no positional arguments");
-			const reaped = await client.call<Record<string, unknown>, { removed: number }>("tasks.reap_stale_focus", {});
-			result = reaped;
-			human = `Reaped ${reaped.removed} stale Focus scope(s).`;
-			break;
-		}
-		case "claim": {
-			if (!id || dependencyId) throw new Error("tasks claim requires exactly one task id");
-			if (!owner) throw new Error("tasks claim requires --owner");
-			const lease = await client.call<Record<string, unknown>, CliTaskLease>("tasks.claim", { id, owner, ttl_ms: ttlMs, note });
-			result = lease;
-			human = `Claimed by "${lease.owner}" until ${lease.leaseExpiresAt} (token ${lease.token}).`;
-			break;
-		}
-		case "heartbeat-lease": {
-			if (!id || dependencyId) throw new Error("tasks heartbeat-lease requires exactly one task id");
-			if (!owner || !token) throw new Error("tasks heartbeat-lease requires --owner and --token");
-			const lease = await client.call<Record<string, unknown>, CliTaskLease>("tasks.heartbeat_lease", { id, owner, token, ttl_ms: ttlMs });
-			result = lease;
-			human = `Renewed until ${lease.leaseExpiresAt}.`;
-			break;
-		}
-		case "release-lease": {
-			if (!id || dependencyId) throw new Error("tasks release-lease requires exactly one task id");
-			if (!owner || !token) throw new Error("tasks release-lease requires --owner and --token");
-			const released = await client.call<Record<string, unknown>, { released: boolean }>("tasks.release_lease", { id, owner, token });
-			result = released;
-			human = released.released ? "Lease released." : "No live lease to release.";
-			break;
-		}
-		case "lease": {
-			if (!id || dependencyId) throw new Error("tasks lease requires exactly one task id");
-			const lease = await client.call<Record<string, unknown>, CliTaskLease | null>("tasks.lease", { id });
-			result = lease;
-			human = lease ? `Leased by "${lease.owner}" until ${lease.leaseExpiresAt}.` : "No live lease.";
-			break;
-		}
-		case "reap-stale-leases": {
-			if (id) throw new Error("tasks reap-stale-leases accepts no positional arguments");
-			const reaped = await client.call<Record<string, unknown>, { removed: number }>("tasks.reap_stale_leases", {});
-			result = reaped;
-			human = `Reaped ${reaped.removed} expired lease(s).`;
-			break;
-		}
-		case "event-feed": {
-			if (id) throw new Error("tasks event-feed accepts no positional arguments");
-			const page = await client.call<Record<string, unknown>, import("./domain/task-event.ts").TaskEventFeedPage>("tasks.event_feed", {
-				cursor,
-				limit,
-				event_types: eventTypes,
-			});
-			result = page;
-			human =
-				page.events.length === 0
-					? "No events."
-					: page.events.map((event) => `${event.id} ${event.occurredAt} ${event.taskId} ${event.type}`).join("\n");
-			break;
-		}
-		case "create": {
-			if (id) throw new Error("tasks create accepts no positional arguments");
-			if (!title) throw new Error("tasks create requires --title");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.create", {
-				title,
-				body,
-				status,
-				labels,
-				extra,
-				gates,
-				checklist,
-				template_id: templateId,
-				parent_id: parentId,
-				depends_on: dependsOn,
-				project_root: projectRoot,
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-			});
-			result = artifact;
-			human = `Created task: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "list": {
-			if (id) throw new Error("tasks list accepts no positional arguments");
-			const rows = await client.call<Record<string, unknown>, CliArtifact[]>("tasks.list", {
-				status,
-				text,
-				limit,
-				labels,
-				project_root: projectRoot,
-				scope: listScope,
-				root_task_id: rootTaskId,
-				...sessionScope,
-			});
-			result = rows;
-			human = rows.length === 0 ? "No tasks found." : rows.map((row) => artifactLabel(row)).join("\n");
-			break;
-		}
-		case "show": {
-			if (!id || dependencyId) throw new Error("tasks show requires exactly one task id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.show", { id });
-			result = artifact;
-			human = `${artifactLabel(artifact)}\n\n${artifact.body ?? ""}`;
-			break;
-		}
-		case "run-gates": {
-			if (!id || dependencyId) throw new Error("tasks run-gates requires exactly one task id");
-			const results = await client.call<Record<string, unknown>, GateResult[]>("tasks.run_gates", { id, actor: "user", source: "cli" });
-			result = results;
-			human =
-				results.length === 0
-					? "No gates configured."
-					: results.map((gate) => `${gate.passed ? "✓" : "✗"} ${gate.gate.type}: ${gate.gate.target} — ${gate.output}`).join("\n");
-			break;
-		}
-		case "set-checklist": {
-			if (!id || dependencyId) throw new Error("tasks set-checklist requires exactly one task id");
-			if (!checklist) throw new Error("tasks set-checklist requires --checklist-json");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.set_checklist", { id, checklist });
-			result = artifact;
-			human = `Updated checklist: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "set-gates": {
-			if (!id || dependencyId) throw new Error("tasks set-gates requires exactly one task id");
-			if (!gates) throw new Error("tasks set-gates requires --gates-json");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.set_gates", { id, gates });
-			result = artifact;
-			human = `Updated gates: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "context": {
-			if (id) throw new Error("tasks context accepts no positional arguments");
-			const summary = await client.call<Record<string, unknown>, string | null>("tasks.context", {
-				project_root: projectRoot,
-				scope: listScope,
-				root_task_id: rootTaskId,
-				...sessionScope,
-			});
-			result = summary;
-			human = summary ?? "No open tasks.";
-			break;
-		}
-		case "contain": {
-			if (!id || !dependencyId || positional.length !== 3) throw new Error("tasks contain requires a parent id and child id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.contain", {
-				parent_id: id,
-				child_id: dependencyId,
-				actor: "user",
-				source: "cli",
-				...(reason ? { reason } : {}),
-				...sessionScope,
-			});
-			result = artifact;
-			human = `Contained: ${dependencyId} → ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "uncontain": {
-			if (!id || !dependencyId || positional.length !== 3) throw new Error("tasks uncontain requires a parent id and child id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.uncontain", {
-				parent_id: id,
-				child_id: dependencyId,
-				actor: "user",
-				source: "cli",
-				...(reason ? { reason } : {}),
-				...sessionScope,
-			});
-			result = artifact;
-			human = `Removed ${dependencyId} from ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "update": {
-			if (!id || dependencyId) throw new Error("tasks update requires exactly one task id");
-			if (status !== undefined && status !== "todo")
-				throw new Error("tasks update --status only supports todo for accidental creation recovery");
-			if (Object.keys(updateInput).length === 0) throw new Error("tasks update requires --title, --body, --labels-json, or --status todo");
-			if (updateInput.status !== undefined && !reason?.trim()) throw new Error("tasks update --status requires --reason");
-			if (reason !== undefined && updateInput.status === undefined) throw new Error("tasks update --reason requires --status todo");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.update", {
-				id,
-				...updateInput,
-				...(reason ? { reason } : {}),
-				actor: "user",
-				source: "cli",
-			});
-			result = artifact;
-			human = `Updated: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "history": {
-			if (!id || dependencyId) throw new Error("tasks history requires exactly one task id");
-			const page = await client.call<{ id: string; direction: "desc" }, import("./domain/task-event.ts").TaskHistoryPage>("tasks.history", {
-				id,
-				direction: "desc",
-			});
-			result = page;
-			human =
-				page.events.length === 0
-					? `No recorded history for ${id}.`
-					: [...page.events]
-							.reverse()
-							.map(
-								(event) =>
-									`${event.occurredAt} ${event.type} ${event.fromStatus ?? "∅"} → ${event.toStatus ?? "∅"} · ${event.actor}/${event.source}${event.reason ? ` · ${event.reason}` : ""}`,
-							)
-							.join("\n");
-			break;
-		}
-		case "scope": {
-			if (!id) {
-				const selection = await client.call<Record<string, string>, import("./domain/task-scope.ts").TaskViewSelection>("tasks.scope", {
-					project_root: projectRoot,
-				});
-				result = selection;
-				human = `Task scope: ${selection.label}`;
-				break;
-			}
-			if (id !== "project" && id !== "all" && id !== "graph") throw new Error("tasks scope mode must be project, all, or graph");
-			if (id === "graph" && !dependencyId) throw new Error("tasks scope graph requires a root task id");
-			if (id !== "graph" && dependencyId) throw new Error(`tasks scope ${id} accepts no root task id`);
-			const selection = await client.call<Record<string, unknown>, import("./domain/task-scope.ts").TaskViewSelection>("tasks.set_scope", {
-				project_root: projectRoot,
-				scope: id,
-				...(dependencyId ? { root_task_id: dependencyId } : {}),
-			});
-			result = selection;
-			human = `Task scope: ${selection.label}`;
-			break;
-		}
-		case "assign-project": {
-			if (!id || positional.length > 3) throw new Error("tasks assign-project requires a task id and optional project root");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.assign_project", {
-				id,
-				project_root: dependencyId ?? projectRoot,
-				actor: "user",
-				source: "cli",
-			});
-			result = artifact;
-			human = `Project assigned: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "focus": {
-			if (!id || dependencyId) throw new Error("tasks focus requires exactly one task id");
-			const active = await client.call<Record<string, unknown>, CliArtifact>("tasks.focus", {
-				id,
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-				...sessionSecretField,
-			});
-			result = active;
-			human = `Active: ${artifactLabel(active)}`;
-			break;
-		}
-		case "graph": {
-			if (id) throw new Error("tasks graph accepts no positional arguments");
-			const graph = await client.call<
-				Record<string, unknown>,
-				{
-					nodes: Array<{ dependencyIds: string[]; childIds: string[] }>;
-					rootIds: string[];
-				}
-			>("tasks.graph", {
-				limit: TASK_EXECUTION_MAX_NODES + 1,
-				labels,
-				project_root: projectRoot,
-				scope: listScope,
-				root_task_id: rootTaskId,
-				...sessionScope,
-			});
-			result = graph;
-			const dependencies = graph.nodes.reduce((count, node) => count + node.dependencyIds.length, 0);
-			const children = graph.nodes.reduce((count, node) => count + node.childIds.length, 0);
-			human = `Task graph: ${graph.nodes.length} nodes, ${graph.rootIds.length} roots, ${dependencies} dependencies, ${children} containment edges`;
-			break;
-		}
-		case "plan": {
-			if (id) throw new Error("tasks plan accepts no positional arguments");
-			const plan = await client.call<Record<string, unknown>, TaskExecutionPlan>("tasks.plan", {
-				project_root: projectRoot,
-				...sessionScope,
-			});
-			result = plan;
-			human = planText(plan);
-			break;
-		}
-		case "complete": {
-			if (!id || dependencyId) throw new Error("tasks complete requires exactly one task id");
-			const completion = await client.call<Record<string, unknown>, CliCompletion>("tasks.complete", {
-				id,
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-			});
-			result = completion;
-			const lines = [`${completion.completed ? "Completed" : "Rejected"}: ${artifactLabel(completion.artifact)}`];
-			if (completion.focused) lines.push(`Active: ${artifactLabel(completion.focused)}`);
-			if (completion.blocked.length > 0) {
-				lines.push(
-					`Blocked: ${completion.blocked.map((entry) => `${artifactLabel(entry.artifact)} waits for ${entry.dependencyIds.join(", ")}`).join("; ")}`,
-				);
-			}
-			for (const gate of completion.gates) lines.push(`${gate.passed ? "✓" : "✗"} ${gate.gate.type}: ${gate.gate.target} — ${gate.output}`);
-			human = lines.join("\n");
-			break;
-		}
-		case "start": {
-			if (!id || dependencyId) throw new Error("tasks start requires exactly one task id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.start", {
-				id,
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-			});
-			result = artifact;
-			human = `Started: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "submit":
-		case "reject":
-		case "retry":
-		case "cancel": {
-			if (!id || dependencyId) throw new Error(`tasks ${action} requires exactly one task id`);
-			const operation = `tasks.${action}` as "tasks.submit" | "tasks.reject" | "tasks.retry" | "tasks.cancel";
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>(operation, {
-				id,
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-			});
-			result = artifact;
-			human = `${action[0]!.toUpperCase()}${action.slice(1)}: ${artifactLabel(artifact)}`;
-			break;
-		}
-		case "cancel-subtree": {
-			if (!id || dependencyId) throw new Error("tasks cancel-subtree requires exactly one task id");
-			const outcome = await client.call<Record<string, unknown>, { canceled: string[]; skipped: string[] }>("tasks.cancel_subtree", {
-				id,
-				actor: "user",
-				source: "cli",
-				...sessionScope,
-			});
-			result = outcome;
-			human = `Canceled ${outcome.canceled.length} task(s)${outcome.skipped.length > 0 ? `, skipped ${outcome.skipped.length} already-terminal` : ""}.`;
-			break;
-		}
-		case "depend": {
-			if (!id || !dependencyId || positional.length !== 3) throw new Error("tasks depend requires a task id and prerequisite id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.depend", {
-				id,
-				dependency_id: dependencyId,
-				actor: "user",
-				source: "cli",
-				...(reason ? { reason } : {}),
-				...sessionScope,
-			});
-			result = artifact;
-			human = `Dependency added: ${artifactLabel(artifact)} waits for ${dependencyId}`;
-			break;
-		}
-		case "undepend": {
-			if (!id || !dependencyId || positional.length !== 3) throw new Error("tasks undepend requires a task id and prerequisite id");
-			const artifact = await client.call<Record<string, unknown>, CliArtifact>("tasks.undepend", {
-				id,
-				dependency_id: dependencyId,
-				actor: "user",
-				source: "cli",
-				...(reason ? { reason } : {}),
-				...sessionScope,
-			});
-			result = artifact;
-			human = `Dependency removed: ${artifactLabel(artifact)} no longer waits for ${dependencyId}`;
-			break;
-		}
-		default:
-			throw new Error(
-				"tasks action must be create, list, show, active, focused, focus, pause, unpause, clear-focus, update, graph, plan, context, history, scope, assign-project, complete, start, submit, reject, retry, cancel, cancel-subtree, depend, undepend, contain, uncontain, run-gates, set-checklist, or set-gates",
-			);
-	}
-	return json ? JSON.stringify(result) : human;
-}
+export {
+	runArtifactCli,
+	runDiscussCli,
+	runDocsCli,
+	runGatesCli,
+	runGraphCli,
+	runGraphProjectionCli,
+	runLogCli,
+	runNoteCli,
+	runPlaybooksCli,
+	runRulesCli,
+	runSessionIdentityCli,
+	runTaskCli,
+};
 
 export async function main(args: string[] = process.argv.slice(2)): Promise<void> {
 	const [command, action] = args;