@rryando/arcs 3.0.0

package/dist/cli/dag-commands.js

@@ -0,0 +1,152 @@
+// ---------------------------------------------------------------------------
+// DAG CLI Command Handlers — Thin delegation shell
+// ---------------------------------------------------------------------------
+// All commands are now in the registry (src/cli/commands/*.ts).
+// This file provides backward-compatible exports for tests and the fallback
+// router in src/cli/index.ts.
+// ---------------------------------------------------------------------------
+import { parseArgs } from "./arg-parser.js";
+import { getCommand } from "./command-registry.js";
+import { isLeanMode } from "./lean-output.js";
+import { render, stripTimestamps } from "./output-envelope.js";
+import "./commands/index.js";
+function cliError(msg) {
+    console.error(msg);
+}
+function printUsage() {
+    console.log("Usage: arcs <command> [subcommand] [options]\n");
+    console.log("Run 'arcs --commands --json' for a full command list.");
+}
+// ---------------------------------------------------------------------------
+// Dispatcher — delegates all commands to the registry
+// ---------------------------------------------------------------------------
+/**
+ * Dispatches DAG CLI subcommands via the registry. Returns true if handled.
+ * Kept as export for backward compatibility with src/cli/index.ts and tests.
+ */
+export async function handleDagCommand(command, args) {
+    // Extract global flags
+    const rest = [];
+    let json = false;
+    let lean = false;
+    for (const arg of args) {
+        if (arg === "--json")
+            json = true;
+        else if (arg === "--lean")
+            lean = true;
+        else if (arg === "--dry-run") {
+            /* consumed */
+        }
+        else
+            rest.push(arg);
+    }
+    if (!lean && isLeanMode([]))
+        lean = true;
+    // Delegate to registry
+    const firstPositional = rest.find((a) => !a.startsWith("-"));
+    let registeredCmd;
+    let remaining;
+    if (firstPositional) {
+        const twoWord = `${command} ${firstPositional}`;
+        const cmd = getCommand(twoWord);
+        if (cmd) {
+            registeredCmd = cmd;
+            remaining = [];
+            let removed = false;
+            for (const a of rest) {
+                if (!removed && a === firstPositional) {
+                    removed = true;
+                    continue;
+                }
+                remaining.push(a);
+            }
+        }
+    }
+    if (!registeredCmd) {
+        const cmd = getCommand(command);
+        if (cmd) {
+            registeredCmd = cmd;
+            remaining = rest;
+        }
+    }
+    if (!registeredCmd) {
+        // Known DAG commands without a matching registry entry
+        const knownCommands = [
+            "task",
+            "plan",
+            "knowledge",
+            "diagram",
+            "doc",
+            "dependency",
+            "paths",
+            "loop",
+            "project",
+        ];
+        if (knownCommands.includes(command)) {
+            if (rest.includes("--help")) {
+                printUsage();
+            }
+            else if (firstPositional) {
+                cliError(`Error: unknown ${command} subcommand "${firstPositional}"`);
+                process.exitCode = 1;
+            }
+            else {
+                cliError(`Error: missing subcommand for "${command}". Use --help for usage.`);
+                process.exitCode = 1;
+            }
+            return true;
+        }
+        return false;
+    }
+    // Re-inject global flags for parseArgs
+    const fullArgs = [...remaining];
+    if (json)
+        fullArgs.push("--json");
+    if (lean)
+        fullArgs.push("--lean");
+    const result = parseArgs(registeredCmd, fullArgs);
+    if (!result.ok) {
+        // Format error in legacy style for backward compatibility
+        const err = result.error;
+        let errMsg;
+        if (err.code === "invalid_enum" && err.param) {
+            errMsg = `Error: invalid ${err.param} "${(fullArgs.find((a) => a.startsWith(`--${err.param}=`)) || "").split("=")[1] || ""}"`;
+            if (err.hint)
+                errMsg += `. ${err.hint}`;
+        }
+        else {
+            const hint = err.hint ? err.hint.replace(/^Usage:/, "usage:") : undefined;
+            errMsg = hint ? `${err.message} — ${hint}` : err.message;
+        }
+        cliError(errMsg);
+        process.exitCode = 1;
+        return true;
+    }
+    if (result.parsed.flags.help) {
+        // Let the main router handle --help
+        return false;
+    }
+    const cmdResult = await registeredCmd.handler(result.parsed.params, result.parsed.flags);
+    if (cmdResult.ok) {
+        const flags = result.parsed.flags;
+        if (flags.json) {
+            const data = flags.lean ? stripTimestamps(cmdResult.data) : cmdResult.data;
+            console.log(JSON.stringify(data));
+        }
+        else {
+            const data = cmdResult.data;
+            if (typeof data === "string") {
+                console.log(data);
+            }
+            else if (data !== null && data !== undefined) {
+                console.log(JSON.stringify(data, null, 2));
+            }
+        }
+        return true;
+    }
+    // Error — render via envelope for consistent error formatting
+    render(cmdResult, { json, lean });
+    process.exitCode = 1;
+    return true;
+}
+//# sourceMappingURL=dag-commands.js.map

package/dist/cli/dag-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-commands.js","sourceRoot":"","sources":["../../src/cli/dag-commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/diagram-renderer.d.ts

@@ -0,0 +1,26 @@
+export interface InspectNode {
+    id: string;
+    label: string;
+    status: string;
+}
+export interface InspectEdge {
+    from: string;
+    to: string;
+}
+export interface InspectOutput {
+    planId: string;
+    nodes: InspectNode[];
+    edges: InspectEdge[];
+    metadata?: Record<string, {
+        skill?: string;
+        scope?: string;
+        acceptance?: string;
+        verify?: string;
+        blockedBy?: string;
+    }>;
+    statusComment?: string;
+    ready?: string[];
+}
+export declare function renderDiagramTree(inspectJson: InspectOutput): string;
+export declare function renderDiagramShow(diagramPath: string): string;
+//# sourceMappingURL=diagram-renderer.d.ts.map

package/dist/cli/diagram-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-renderer.d.ts","sourceRoot":"","sources":["../../src/cli/diagram-renderer.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAC7F,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AA+BD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,aAAa,GAAG,MAAM,CA+EpE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA0B7D"}

package/dist/cli/diagram-renderer.js

@@ -0,0 +1,118 @@
+// ---------------------------------------------------------------------------
+// Terminal-native diagram tree renderer
+// ---------------------------------------------------------------------------
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import pc from "picocolors";
+const STATUS_ICON = {
+    done: "✓",
+    inProgress: "◉",
+    blocked: "✗",
+    backlog: "○",
+};
+function colorStatus(text, status) {
+    switch (status) {
+        case "done":
+            return pc.green(text);
+        case "inProgress":
+            return pc.yellow(text);
+        case "blocked":
+            return pc.red(text);
+        default:
+            return pc.dim(text);
+    }
+}
+function buildProgressBar(nodes) {
+    const total = nodes.length;
+    const done = nodes.filter((n) => n.status === "done").length;
+    const barWidth = 7;
+    const filled = total > 0 ? Math.round((done / total) * barWidth) : 0;
+    const bar = "█".repeat(filled) + "░".repeat(barWidth - filled);
+    return `${bar} ${done}/${total}`;
+}
+export function renderDiagramTree(inspectJson) {
+    const { planId, nodes, edges, ready } = inspectJson;
+    const readySet = new Set(ready ?? []);
+    // Build adjacency: parent -> children
+    const children = new Map();
+    const incomingCount = new Map();
+    for (const node of nodes) {
+        children.set(node.id, []);
+        incomingCount.set(node.id, 0);
+    }
+    for (const edge of edges) {
+        children.get(edge.from)?.push(edge.to);
+        incomingCount.set(edge.to, (incomingCount.get(edge.to) ?? 0) + 1);
+    }
+    // Root nodes: no incoming edges
+    const roots = nodes.filter((n) => (incomingCount.get(n.id) ?? 0) === 0);
+    // Build set of done node IDs for blocked detection
+    const doneSet = new Set(nodes.filter((n) => n.status === "done").map((n) => n.id));
+    // Check if a node's dependencies are all done
+    function hasUnmetDeps(nodeId) {
+        // Find all parents (nodes that have an edge TO this node)
+        const parents = edges.filter((e) => e.to === nodeId).map((e) => e.from);
+        return parents.some((p) => !doneSet.has(p));
+    }
+    // Header
+    const status = inspectJson.statusComment ?? "planned";
+    const progress = buildProgressBar(nodes);
+    const titleLine = `─ PLAN: ${planId} `;
+    const headerWidth = 58;
+    const padRight = Math.max(0, headerWidth - titleLine.length - 1);
+    const lines = [];
+    lines.push(`┌${titleLine}${"─".repeat(padRight)}┐`);
+    lines.push(`│ Status: ${status} │ Progress: ${progress}${" ".repeat(Math.max(0, headerWidth - 14 - status.length - 14 - progress.length))}│`);
+    lines.push(`└${"─".repeat(headerWidth)}┘`);
+    lines.push("");
+    // Render tree recursively
+    const nodeMap = new Map(nodes.map((n) => [n.id, n]));
+    function renderNode(nodeId, prefix, connector) {
+        const node = nodeMap.get(nodeId);
+        if (!node)
+            return;
+        const icon = colorStatus(STATUS_ICON[node.status] ?? "○", node.status);
+        const label = colorStatus(`${node.id} │ ${node.label}`, node.status);
+        const statusTag = colorStatus(`[${node.status}]`, node.status);
+        let markers = "";
+        if (readySet.has(node.id)) {
+            markers += ` ${pc.cyan("★ READY")}`;
+        }
+        else if (node.status !== "done" && node.status !== "inProgress" && hasUnmetDeps(node.id)) {
+            markers += ` ${pc.dim("⏳")}`;
+        }
+        lines.push(`${prefix}${connector}${icon} ${label} ${statusTag}${markers}`);
+        const kids = children.get(nodeId) ?? [];
+        for (let i = 0; i < kids.length; i++) {
+            const isLast = i === kids.length - 1;
+            const childConnector = isLast ? "└─→ " : "├─→ ";
+            const childPrefix = prefix + (connector ? "    " : "  ");
+            renderNode(kids[i], childPrefix, childConnector);
+        }
+    }
+    for (const root of roots) {
+        renderNode(root.id, "  ", "");
+    }
+    return lines.join("\n");
+}
+export function renderDiagramShow(diagramPath) {
+    const localPath = resolve(import.meta.dirname, "../../opencode/arcs/skills/to-diagram/scripts/manage-diagram.mjs");
+    const configPath = resolve(homedir(), ".config/opencode/skills/arcs/to-diagram/scripts/manage-diagram.mjs");
+    const scriptPath = existsSync(localPath)
+        ? localPath
+        : existsSync(configPath)
+            ? configPath
+            : undefined;
+    if (!scriptPath) {
+        throw new Error("manage-diagram.mjs not found");
+    }
+    const output = execSync(`node "${scriptPath}" inspect "${diagramPath}"`, {
+        encoding: "utf-8",
+        timeout: 10000,
+    });
+    const inspectJson = JSON.parse(output);
+    return renderDiagramTree(inspectJson);
+}
+//# sourceMappingURL=diagram-renderer.js.map

package/dist/cli/diagram-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-renderer.js","sourceRoot":"","sources":["../../src/cli/diagram-renderer.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,YAAY,CAAC;AAyB5B,MAAM,WAAW,GAA2B;IAC1C,IAAI,EAAE,GAAG;IACT,UAAU,EAAE,GAAG;IACf,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,SAAS,WAAW,CAAC,IAAY,EAAE,MAAc;IAC/C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,YAAY;YACf,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,SAAS;YACZ,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB;YACE,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAoB;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;IAC7D,MAAM,QAAQ,GAAG,CAAC,CAAC;IACnB,MAAM,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,CAAC;IAC/D,OAAO,GAAG,GAAG,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAA0B;IAC1D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAEtC,sCAAsC;IACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1B,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,gCAAgC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAExE,mDAAmD;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEnF,8CAA8C;IAC9C,SAAS,YAAY,CAAC,MAAc;QAClC,0DAA0D;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS;IACT,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,IAAI,SAAS,CAAC;IACtD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,WAAW,MAAM,GAAG,CAAC;IACvC,MAAM,WAAW,GAAG,EAAE,CAAC;IACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CACR,aAAa,MAAM,gBAAgB,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,CAClI,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,0BAA0B;IAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,SAAS,UAAU,CAAC,MAAc,EAAE,MAAc,EAAE,SAAiB;QACnE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE/D,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3F,OAAO,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,IAAI,KAAK,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC,CAAC;QAE3E,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YACrC,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;YAChD,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,MAAM,SAAS,GAAG,OAAO,CACvB,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,kEAAkE,CACnE,CAAC;IACF,MAAM,UAAU,GAAG,OAAO,CACxB,OAAO,EAAE,EACT,oEAAoE,CACrE,CAAC;IACF,MAAM,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;YACtB,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,UAAU,cAAc,WAAW,GAAG,EAAE;QACvE,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,MAAM,WAAW,GAAkB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,iBAAiB,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC"}

package/dist/cli/help-generator.d.ts

@@ -0,0 +1,21 @@
+import { type CommandDef } from "./command-registry.js";
+export interface CommandDiscovery {
+    commands: Array<{
+        path: string;
+        description: string;
+        params: Record<string, {
+            type: string;
+            required: boolean;
+            positional?: number;
+            default?: unknown;
+            description: string;
+            enum?: string[];
+        }>;
+        mutation?: boolean;
+    }>;
+    errorCodes: string[];
+}
+export declare function generateCommandHelp(def: CommandDef): string;
+export declare function generateCommandsDiscovery(): CommandDiscovery;
+export declare function formatCommandsDiscovery(discovery: CommandDiscovery, json: boolean): string;
+//# sourceMappingURL=help-generator.d.ts.map

package/dist/cli/help-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-generator.d.ts","sourceRoot":"","sources":["../../src/cli/help-generator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAA4C,MAAM,uBAAuB,CAAC;AAElG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CACZ,MAAM,EACN;YACE,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,OAAO,CAAC;YAClB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,WAAW,EAAE,MAAM,CAAC;YACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;SACjB,CACF,CAAC;QACF,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAqD3D;AAWD,wBAAgB,yBAAyB,IAAI,gBAAgB,CAuB5D;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAU1F"}

package/dist/cli/help-generator.js

@@ -0,0 +1,100 @@
+// ---------------------------------------------------------------------------
+// Help Generator — per-command help and --commands discovery
+// ---------------------------------------------------------------------------
+import { ERROR_CODES, listCommands } from "./command-registry.js";
+export function generateCommandHelp(def) {
+    const lines = [];
+    lines.push(`arcs ${def.path} — ${def.description}`);
+    lines.push("");
+    // Build usage line
+    const positionals = [];
+    const requiredFlags = [];
+    const optionalFlags = [];
+    for (const [name, p] of Object.entries(def.params)) {
+        if (p.positional != null) {
+            positionals.push([p.positional, name, p]);
+        }
+        else if (p.required) {
+            requiredFlags.push([name, p]);
+        }
+        else {
+            optionalFlags.push([name, p]);
+        }
+    }
+    positionals.sort((a, b) => a[0] - b[0]);
+    const usageParts = [`arcs ${def.path}`];
+    for (const [, name] of positionals)
+        usageParts.push(`<${name}>`);
+    for (const [name, p] of requiredFlags)
+        usageParts.push(`--${name}=${p.type.toUpperCase()}`);
+    for (const [name, p] of optionalFlags)
+        usageParts.push(`[--${name}=${p.type.toUpperCase()}]`);
+    lines.push(`Usage: ${usageParts.join(" ")}`);
+    lines.push("");
+    lines.push("Parameters:");
+    const paramLines = [];
+    for (const [, name, p] of positionals) {
+        const meta = buildMeta(p);
+        paramLines.push([`  <${name}>`, meta]);
+    }
+    for (const [name, p] of [...requiredFlags, ...optionalFlags]) {
+        const meta = buildMeta(p);
+        paramLines.push([`  --${name}=${p.type.toUpperCase()}`, meta]);
+    }
+    const maxCol = Math.max(...paramLines.map(([l]) => l.length));
+    for (const [col1, col2] of paramLines) {
+        lines.push(`${col1.padEnd(maxCol + 2)}${col2}`);
+    }
+    lines.push("");
+    lines.push("Global flags:");
+    lines.push("  --json        Output as JSON");
+    lines.push("  --lean        Strip timestamps for token efficiency");
+    lines.push("  --dry-run     Validate params without side effects");
+    lines.push("  --help        Show this help");
+    return lines.join("\n");
+}
+function buildMeta(p) {
+    const parts = [`(${p.type}`];
+    parts.push(p.required ? ", required" : ", optional");
+    if (p.default !== undefined)
+        parts.push(`, default: ${JSON.stringify(p.default)}`);
+    parts.push(`) ${p.description}`);
+    if (p.enum)
+        parts.push(` [${p.enum.join(", ")}]`);
+    return parts.join("");
+}
+export function generateCommandsDiscovery() {
+    return {
+        commands: listCommands().map((def) => ({
+            path: def.path,
+            description: def.description,
+            params: Object.fromEntries(Object.entries(def.params).map(([name, p]) => [
+                name,
+                {
+                    type: p.type,
+                    required: typeof p.required === "function" ? true : (p.required ?? false),
+                    ...(p.positional != null ? { positional: p.positional } : {}),
+                    ...(p.default !== undefined ? { default: p.default } : {}),
+                    description: p.description,
+                    ...(p.enum ? { enum: p.enum } : {}),
+                },
+            ])),
+            ...(def.mutation != null ? { mutation: def.mutation } : {}),
+            ...(def.errorCodes ? { errorCodes: def.errorCodes } : {}),
+        })),
+        errorCodes: Object.values(ERROR_CODES),
+    };
+}
+export function formatCommandsDiscovery(discovery, json) {
+    if (json)
+        return JSON.stringify(discovery, null, 2);
+    const lines = ["Available commands:"];
+    const maxPath = Math.max(...discovery.commands.map((c) => c.path.length));
+    for (const cmd of discovery.commands) {
+        lines.push(`  ${cmd.path.padEnd(maxPath + 2)}${cmd.description}`);
+    }
+    lines.push("");
+    lines.push("Use 'arcs <command> --help' for details.");
+    return lines.join("\n");
+}
+//# sourceMappingURL=help-generator.js.map

package/dist/cli/help-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-generator.js","sourceRoot":"","sources":["../../src/cli/help-generator.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+import "./commands/index.js";
+/**
+ * Entry point for `npx arcs init`, `npx arcs config`.
+ * Returns true if a CLI subcommand was handled, false if the caller
+ * should proceed with normal exit.
+ */
+export declare function handleCli(args: string[]): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAoC7B;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+DhE"}

package/dist/cli/index.js

@@ -0,0 +1,95 @@
+import "./commands/index.js"; // Trigger command registrations
+import { parseArgs } from "./arg-parser.js";
+import { getCommand } from "./command-registry.js";
+import { handleDagCommand } from "./dag-commands.js";
+import { formatCommandsDiscovery, generateCommandHelp, generateCommandsDiscovery, } from "./help-generator.js";
+import { render } from "./output-envelope.js";
+import { runSetup } from "./setup.js";
+// ---------------------------------------------------------------------------
+// CLI Subcommand Router
+// ---------------------------------------------------------------------------
+/**
+ * Determine the longest-match command path from raw args.
+ * Tries two-word path first (e.g. "task transition"), then single word.
+ */
+function determineCommandPath(args) {
+    if (args.length >= 2) {
+        const twoWord = `${args[0]} ${args[1]}`;
+        if (getCommand(twoWord)) {
+            return { path: twoWord, remaining: args.slice(2) };
+        }
+    }
+    if (args.length >= 1) {
+        const oneWord = args[0];
+        if (getCommand(oneWord)) {
+            return { path: oneWord, remaining: args.slice(1) };
+        }
+    }
+    return undefined;
+}
+/**
+ * Entry point for `npx arcs init`, `npx arcs config`.
+ * Returns true if a CLI subcommand was handled, false if the caller
+ * should proceed with normal exit.
+ */
+export async function handleCli(args) {
+    const command = args[0];
+    // --commands discovery
+    if (args.includes("--commands")) {
+        const json = args.includes("--json");
+        const discovery = generateCommandsDiscovery();
+        if (json) {
+            console.log(JSON.stringify({ ok: true, data: discovery }));
+        }
+        else {
+            console.log(formatCommandsDiscovery(discovery, false));
+        }
+        return true;
+    }
+    // Registry-first routing
+    const match = determineCommandPath(args);
+    if (match) {
+        const registeredCmd = getCommand(match.path);
+        const result = parseArgs(registeredCmd, match.remaining);
+        if (!result.ok) {
+            const flags = {
+                json: match.remaining.includes("--json"),
+                lean: match.remaining.includes("--lean"),
+            };
+            render(result.error, flags, match.path);
+            process.exitCode = 1;
+            return true;
+        }
+        if (result.parsed.flags.help) {
+            console.log(generateCommandHelp(registeredCmd));
+            return true;
+        }
+        const cmdResult = await registeredCmd.handler(result.parsed.params, result.parsed.flags);
+        render(cmdResult, result.parsed.flags, match.path);
+        if (!cmdResult.ok)
+            process.exitCode = 1;
+        return true;
+    }
+    switch (command) {
+        case "init":
+            await runSetup("init");
+            return true;
+        case "config":
+            await runSetup("config");
+            return true;
+        case "task":
+        case "plan":
+        case "knowledge":
+        case "diagram":
+        case "project":
+        case "doc":
+        case "dependency":
+        case "paths":
+        case "loop":
+        case "graph":
+            return handleDagCommand(command, args.slice(1));
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/cli/instructions.d.ts

@@ -0,0 +1,53 @@
+import type { ModelTierConfig } from "./config.js";
+/**
+ * Formats a short summary of an IDE config path for display.
+ * Replaces $HOME with ~ for readability.
+ */
+export declare function displayPath(p: string): string;
+/**
+ * The OpenCode agent entry for ARCS orchestrator.
+ */
+export declare const ARCS_AGENT_ENTRY: {
+    description: string;
+    mode: "primary";
+    prompt: string;
+    color: string;
+};
+/**
+ * The OpenCode agent entry for ARCS Caveman — same capabilities as ARCS
+ * Orchestrator, but with caveman speech layered on top for token efficiency.
+ */
+export declare const ARCS_CAVEMAN_AGENT_ENTRY: {
+    description: string;
+    mode: "primary";
+    prompt: string;
+    color: string;
+};
+/**
+ * Checks whether the ARCS agent is already registered in opencode.json.
+ */
+export declare function opencodeHasAgent(): boolean;
+export interface AgentWriteResult {
+    configPath: string;
+    promptPath: string;
+    cavemanPromptPath: string;
+    action: "created" | "updated";
+    alreadyConfigured: boolean;
+}
+/**
+ * Registers the ARCS orchestrator agents (standard + Caveman) as primary
+ * agents in opencode.json. Also writes both prompt text files to
+ * ~/.config/opencode/prompts/.
+ *
+ * Both agents share full ARCS tool access and workflow rules; ARCS Caveman
+ * layers caveman-speak on top for token-efficient chat output.
+ */
+export declare function writeOpencodeAgent(modelConfig?: ModelTierConfig): AgentWriteResult;
+/**
+ * Applies ModelTierConfig to all known agent entries in opencode.json.
+ * Each agent (primary or sub-agent) listed in AGENT_TIER_MAP gets a `model`
+ * field resolved from its tier. perAgent overrides always win.
+ * Call this AFTER bundle install so it overwrites hardcoded manifest models.
+ */
+export declare function applyAgentModelConfig(modelConfig: ModelTierConfig): void;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/cli/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/cli/instructions.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAsEnD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7C;AA0BD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;CAK5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;CAKpC,CAAC;AAQF;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAa1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,eAAe,GAAG,gBAAgB,CAiElF;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI,CAmBxE"}