@rryando/arcs 4.2.0 → 5.0.0

package/dist/cli/commands/proposal-doc.js

@@ -0,0 +1,382 @@
+// ---------------------------------------------------------------------------
+// proposal-doc commands — human-in-the-loop design proposal documents
+// Proposals live as repo-local markdown files under docs/proposals/
+// ---------------------------------------------------------------------------
+import { existsSync, readdirSync } from "node:fs";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import { resolveProject } from "../../utils/project-resolver.js";
+import { normalizeIdentifier } from "../../utils/slug.js";
+import { readStdin } from "../../utils/stdin.js";
+import { defineCommand, ERROR_CODES, } from "../command-registry.js";
+import { failure, success } from "../output-envelope.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const PROPOSALS_DIR = "docs/proposals";
+function proposalDocPath(workspaceRoot, id) {
+    return resolve(workspaceRoot, PROPOSALS_DIR, `${id}.proposal.md`);
+}
+function proposalDocAcceptedPath(workspaceRoot, id) {
+    return resolve(workspaceRoot, PROPOSALS_DIR, `${id}.accepted.md`);
+}
+/** List all `.proposal.md` files and return their base names (without extension). */
+function listProposalIds(workspaceRoot) {
+    const dir = resolve(workspaceRoot, PROPOSALS_DIR);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith(".proposal.md"))
+        .map((f) => basename(f, ".proposal.md"))
+        .sort();
+}
+const PROPOSAL_TEMPLATE = (title) => `# ${title}
+
+## Motivation / Non-goals
+
+
+## Current state
+
+
+## Proposed design
+
+
+## Impact & risks
+
+
+## Acceptance criteria
+
+
+## Decision
+
+*Approved: _when_ — rationale: _rejected alternative summaries_*
+`;
+// ---------------------------------------------------------------------------
+// proposal-doc create
+// ---------------------------------------------------------------------------
+const proposalDocCreateParams = {
+    slug: {
+        type: "string",
+        required: true,
+        positional: 0,
+        description: "Project slug to create proposal doc for",
+    },
+    title: {
+        type: "string",
+        required: true,
+        positional: 1,
+        description: "Proposal title (also used for the identifier)",
+    },
+    body: { type: "string", description: "Inline markdown body (overrides template)" },
+    "body-file": { type: "string", description: "Path to markdown file with proposal body" },
+    "body-stdin": { type: "boolean", description: "Read body from stdin" },
+};
+defineCommand({
+    path: "proposal-doc create",
+    description: "Scaffold a new proposal document in docs/proposals/",
+    mutation: true,
+    params: proposalDocCreateParams,
+    handler: handleProposalDocCreate,
+});
+async function handleProposalDocCreate(params, flags) {
+    const slug = params.slug;
+    const title = params.title;
+    const bodyInline = params.body;
+    const bodyFile = params["body-file"];
+    const bodyStdin = params["body-stdin"];
+    const resolved = await resolveProject(slug);
+    if (!resolved.ok)
+        return resolved.result;
+    const workspaceRoot = resolved.workspacePath;
+    if (!workspaceRoot) {
+        return failure("no_workspace_path", `Project "${slug}" has no workspace path configured — cannot write proposal doc`);
+    }
+    const id = normalizeIdentifier(title);
+    if (flags.dryRun) {
+        return success({
+            dryRun: true,
+            wouldCreate: {
+                slug,
+                title,
+                id,
+                path: `docs/proposals/${id}.proposal.md`,
+                hasBody: !!(bodyInline || bodyFile || bodyStdin),
+            },
+        });
+    }
+    const filePath = proposalDocPath(workspaceRoot, id);
+    if (existsSync(filePath)) {
+        return failure(ERROR_CODES.CREATE_ERROR, `Proposal doc already exists: docs/proposals/${id}.proposal.md`, {
+            hint: `Use 'arcs proposal-doc edit ${slug} ${id}' to update it.`,
+        });
+    }
+    // Resolve body content: inline > file > stdin > template
+    let body;
+    if (bodyInline) {
+        body = bodyInline;
+    }
+    else if (bodyFile) {
+        if (!existsSync(bodyFile)) {
+            return failure(ERROR_CODES.ENTITY_NOT_FOUND, `Body file not found: ${bodyFile}`);
+        }
+        body = await readFile(bodyFile, "utf-8");
+    }
+    else if (bodyStdin) {
+        body = await readStdin();
+    }
+    else {
+        body = PROPOSAL_TEMPLATE(title);
+    }
+    // Ensure directory exists
+    const dir = resolve(workspaceRoot, PROPOSALS_DIR);
+    await mkdir(dir, { recursive: true });
+    await writeFile(filePath, body, "utf-8");
+    return success({
+        slug,
+        id,
+        path: `docs/proposals/${id}.proposal.md`,
+        fullPath: filePath,
+    });
+}
+// ---------------------------------------------------------------------------
+// proposal-doc list
+// ---------------------------------------------------------------------------
+const proposalDocListParams = {
+    slug: {
+        type: "string",
+        required: true,
+        positional: 0,
+        description: "Project slug",
+    },
+};
+defineCommand({
+    path: "proposal-doc list",
+    description: "List pending proposal documents",
+    params: proposalDocListParams,
+    handler: handleProposalDocList,
+});
+async function handleProposalDocList(params, _flags) {
+    const slug = params.slug;
+    const resolved = await resolveProject(slug);
+    if (!resolved.ok)
+        return resolved.result;
+    const workspaceRoot = resolved.workspacePath;
+    if (!workspaceRoot) {
+        return success({ slug, proposals: [] });
+    }
+    const ids = listProposalIds(workspaceRoot);
+    const proposals = ids.map((id) => {
+        return { id, path: `docs/proposals/${id}.proposal.md` };
+    });
+    return success({ slug, proposals });
+}
+// ---------------------------------------------------------------------------
+// proposal-doc get — view a proposal doc body
+// ---------------------------------------------------------------------------
+const proposalDocGetParams = {
+    slug: {
+        type: "string",
+        required: true,
+        positional: 0,
+        description: "Project slug",
+    },
+    id: {
+        type: "string",
+        required: true,
+        positional: 1,
+        description: "Proposal doc identifier (without .proposal.md)",
+    },
+};
+defineCommand({
+    path: "proposal-doc get",
+    description: "View the body of a proposal document",
+    params: proposalDocGetParams,
+    handler: handleProposalDocGet,
+});
+async function handleProposalDocGet(params, _flags) {
+    const slug = params.slug;
+    const id = params.id;
+    const resolved = await resolveProject(slug);
+    if (!resolved.ok)
+        return resolved.result;
+    const workspaceRoot = resolved.workspacePath;
+    if (!workspaceRoot) {
+        return failure("no_workspace_path", `Project "${slug}" has no workspace path configured`);
+    }
+    // Try .proposal.md first, then .accepted.md
+    let filePath = proposalDocPath(workspaceRoot, id);
+    let status = "pending";
+    if (!existsSync(filePath)) {
+        filePath = proposalDocAcceptedPath(workspaceRoot, id);
+        status = "accepted";
+        if (!existsSync(filePath)) {
+            return failure(ERROR_CODES.ENTITY_NOT_FOUND, `Proposal doc not found: ${id} (tried .proposal.md and .accepted.md)`, {
+                hint: `Run 'arcs proposal-doc list ${slug}' to see available proposals.`,
+            });
+        }
+    }
+    const body = await readFile(filePath, "utf-8");
+    return success({
+        slug,
+        id,
+        status,
+        path: `docs/proposals/${id}.${status}.md`,
+        body,
+    });
+}
+// ---------------------------------------------------------------------------
+// proposal-doc edit — replace body of a proposal doc
+// ---------------------------------------------------------------------------
+const proposalDocEditParams = {
+    slug: {
+        type: "string",
+        required: true,
+        positional: 0,
+        description: "Project slug",
+    },
+    id: {
+        type: "string",
+        required: true,
+        positional: 1,
+        description: "Proposal doc identifier (without .proposal.md)",
+    },
+    body: { type: "string", description: "Inline markdown body (replaces content)" },
+    "body-file": { type: "string", description: "Path to markdown file with proposal body" },
+    "body-stdin": { type: "boolean", description: "Read body from stdin" },
+};
+defineCommand({
+    path: "proposal-doc edit",
+    description: "Replace the body of a proposal document",
+    mutation: true,
+    params: proposalDocEditParams,
+    handler: handleProposalDocEdit,
+});
+async function handleProposalDocEdit(params, flags) {
+    const slug = params.slug;
+    const id = params.id;
+    const bodyInline = params.body;
+    const bodyFile = params["body-file"];
+    const bodyStdin = params["body-stdin"];
+    if (!bodyInline && !bodyFile && !bodyStdin) {
+        return failure(ERROR_CODES.MISSING_PARAM, "Provide --body, --body-file, or --body-stdin", {
+            hint: "Use --body=<content>, --body-file=<path>, or --body-stdin to supply replacement content.",
+        });
+    }
+    const resolved = await resolveProject(slug);
+    if (!resolved.ok)
+        return resolved.result;
+    const workspaceRoot = resolved.workspacePath;
+    if (!workspaceRoot) {
+        return failure("no_workspace_path", `Project "${slug}" has no workspace path configured`);
+    }
+    // Try .proposal.md first, then .accepted.md
+    let filePath = proposalDocPath(workspaceRoot, id);
+    let status = "pending";
+    if (!existsSync(filePath)) {
+        filePath = proposalDocAcceptedPath(workspaceRoot, id);
+        status = "accepted";
+        if (!existsSync(filePath)) {
+            return failure(ERROR_CODES.ENTITY_NOT_FOUND, `Proposal doc not found: ${id}`, {
+                hint: `Run 'arcs proposal-doc list ${slug}' to see available proposals.`,
+            });
+        }
+    }
+    let body;
+    if (bodyInline) {
+        body = bodyInline;
+    }
+    else if (bodyFile) {
+        if (!existsSync(bodyFile)) {
+            return failure(ERROR_CODES.ENTITY_NOT_FOUND, `Body file not found: ${bodyFile}`);
+        }
+        body = await readFile(bodyFile, "utf-8");
+    }
+    else {
+        body = await readStdin();
+    }
+    if (flags.dryRun) {
+        return success({
+            dryRun: true,
+            slug,
+            id,
+            wouldUpdate: { path: `docs/proposals/${id}.${status}.md`, bodyLength: body.length },
+        });
+    }
+    await writeFile(filePath, body, "utf-8");
+    return success({
+        slug,
+        id,
+        status,
+        path: `docs/proposals/${id}.${status}.md`,
+        bodyLength: body.length,
+    });
+}
+// ---------------------------------------------------------------------------
+// proposal-doc promote — convert approved proposal into an ARCS plan
+// ---------------------------------------------------------------------------
+const proposalDocPromoteParams = {
+    slug: {
+        type: "string",
+        required: true,
+        positional: 0,
+        description: "Project slug",
+    },
+    id: {
+        type: "string",
+        required: true,
+        positional: 1,
+        description: "Proposal doc identifier (from filename, without .proposal.md)",
+    },
+};
+defineCommand({
+    path: "proposal-doc promote",
+    description: "Promote an approved proposal doc into an ARCS plan",
+    mutation: true,
+    params: proposalDocPromoteParams,
+    handler: handleProposalDocPromote,
+});
+async function handleProposalDocPromote(params, flags) {
+    const slug = params.slug;
+    const id = params.id;
+    const resolved = await resolveProject(slug);
+    if (!resolved.ok)
+        return resolved.result;
+    const workspaceRoot = resolved.workspacePath;
+    if (!workspaceRoot) {
+        return failure("no_workspace_path", `Project "${slug}" has no workspace path configured`);
+    }
+    const filePath = proposalDocPath(workspaceRoot, id);
+    if (!existsSync(filePath)) {
+        return failure(ERROR_CODES.ENTITY_NOT_FOUND, `Proposal doc not found: docs/proposals/${id}.proposal.md`, {
+            hint: `Run 'arcs proposal-doc list ${slug}' to see available proposals.`,
+        });
+    }
+    // Read the proposal body and infer a title from the first heading
+    const body = await readFile(filePath, "utf-8");
+    const titleLine = body.split("\n").find((l) => l.startsWith("# "));
+    const title = titleLine ? titleLine.replace(/^#\s+/, "").trim() : id;
+    if (flags.dryRun) {
+        return success({
+            dryRun: true,
+            slug,
+            wouldPromote: {
+                id,
+                title,
+                planAction: `arcs plan create ${slug} "${title}" --body-file="${filePath}"`,
+                docAction: "rename .proposal.md -> .accepted.md",
+            },
+        });
+    }
+    // Rename .proposal.md → .accepted.md so the content survives for plan creation.
+    // The skill orchestrator calls `arcs plan create --body-file=<accepted-path>` next.
+    const acceptedPath = proposalDocAcceptedPath(workspaceRoot, id);
+    await rename(filePath, acceptedPath);
+    return success({
+        slug,
+        id,
+        title,
+        docPath: `docs/proposals/${id}.accepted.md`,
+        planCommand: `arcs plan create ${slug} "${title}" --body-file="${acceptedPath}"`,
+    });
+}
+//# sourceMappingURL=proposal-doc.js.map

package/dist/cli/commands/proposal-doc.js.map

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

package/dist/cli/commands/web.js

@@ -2,14 +2,15 @@
 // web — Start the ARCS web UI (knowledge base visualizer and manager)
 // ---------------------------------------------------------------------------
 import pc from "picocolors";
-import { DEFAULT_WEB_HOST, DEFAULT_WEB_PORT } from "../../utils/hook-contract.js";
 import { defineCommand, } from "../command-registry.js";
 import { failure, success } from "../output-envelope.js";
+/** Loopback only: `arcs web` refuses to bind anything else. */
+const DEFAULT_WEB_HOST = "127.0.0.1";
+/** Default `arcs web` port. */
+const DEFAULT_WEB_PORT = 4173;
 const webParams = {
     port: {
         type: "number",
-        // Shared with the hook contract: an installed hook posts to this port, so
-        // the two defaults must move together or every hook silently misses.
         default: DEFAULT_WEB_PORT,
         description: `Port to listen on (default ${DEFAULT_WEB_PORT})`,
     },
@@ -50,13 +51,6 @@ async function handleWeb(params, _flags) {
         ];
         // Banner on stderr keeps --json stdout clean.
         console.error(banner.join("\n"));
-        // Checked against the address actually bound, not `params.port`: the two
-        // differ whenever port 0 was requested. Runs after listen, so it can only
-        // add output — it never delays or fails the server coming up.
-        const { hookUrlMismatchWarning } = await import("./hooks.js");
-        const mismatch = await hookUrlMismatchWarning({ host: handle.host, port: handle.port });
-        if (mismatch)
-            console.error(`${pc.yellow(mismatch)}\n`);
         return success({ url: handle.url, port: handle.port, host: handle.host });
     }
     catch (err) {

package/dist/cli/commands/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/cli/commands/web.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/cli/commands/web.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E;AAE9E,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAGL,aAAa,GAGd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEzD,+DAA+D;AAC/D,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAErC,+BAA+B;AAC/B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,gBAAgB;QACzB,WAAW,EAAE,8BAA8B,gBAAgB,GAAG;KAC/D;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,gBAAgB;QACzB,WAAW,EAAE,8BAA8B,gBAAgB,GAAG;KAC/D;IACD,SAAS,EAAE;QACT,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,8BAA8B;KAC5C;CAC0C,CAAC;AAE9C,aAAa,CAAC;IACZ,IAAI,EAAE,KAAK;IACX,WAAW,EAAE,+DAA+D;IAC5E,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;CACnB,CAAC,CAAC;AAEH,KAAK,UAAU,SAAS,CACtB,MAAsC,EACtC,MAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACrE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QAE5D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC;YAClC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;SACzB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG;YACb,EAAE;YACF,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,4BAA4B,CAAC,EAAE;YACtF,KAAK,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;YAClD,KAAK,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,UAAU,EAAE,EAAE;YAC3C,KAAK,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO;YAClI,KAAK,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE;YAC/B,EAAE;SACH,CAAC;QACF,8CAA8C;QAC9C,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjC,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,iBAAiB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/cli/dag-commands.d.ts

@@ -1,4 +1,13 @@
 import "./commands/index.js";
+/**
+ * Command prefixes that route to handleDagCommand for descriptive error messages.
+ * These are commands with subcommands (e.g. "plan create") but no single-word
+ * registry entry — registry-first routing in index.ts catches the two-word forms,
+ * this list provides helpful errors when the user types just the prefix.
+ *
+ * Keep sorted. The same list is used in index.ts for the switch/case fallback.
+ */
+export declare const KNOWN_DAG_COMMANDS: readonly ["dependency", "diagram", "doc", "graph", "knowledge", "loop", "paths", "plan", "project", "proposal", "proposal-doc", "task"];
 /**
  * Dispatches DAG CLI subcommands via the registry. Returns true if handled.
  * Kept as export for backward compatibility with src/cli/index.ts and tests.

package/dist/cli/dag-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dag-commands.d.ts","sourceRoot":"","sources":["../../src/cli/dag-commands.ts"],"names":[],"mappings":"AAYA,OAAO,qBAAqB,CAAC;AAe7B;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA6HxF"}
+{"version":3,"file":"dag-commands.d.ts","sourceRoot":"","sources":["../../src/cli/dag-commands.ts"],"names":[],"mappings":"AAYA,OAAO,qBAAqB,CAAC;AAe7B;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,yIAaO,CAAC;AAEvC;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAiHxF"}

package/dist/cli/dag-commands.js

@@ -20,6 +20,28 @@ function printUsage() {
 // ---------------------------------------------------------------------------
 // Dispatcher — delegates all commands to the registry
 // ---------------------------------------------------------------------------
+/**
+ * Command prefixes that route to handleDagCommand for descriptive error messages.
+ * These are commands with subcommands (e.g. "plan create") but no single-word
+ * registry entry — registry-first routing in index.ts catches the two-word forms,
+ * this list provides helpful errors when the user types just the prefix.
+ *
+ * Keep sorted. The same list is used in index.ts for the switch/case fallback.
+ */
+export const KNOWN_DAG_COMMANDS = [
+    "dependency",
+    "diagram",
+    "doc",
+    "graph",
+    "knowledge",
+    "loop",
+    "paths",
+    "plan",
+    "project",
+    "proposal",
+    "proposal-doc",
+    "task",
+];
 /**
  * Dispatches DAG CLI subcommands via the registry. Returns true if handled.
  * Kept as export for backward compatibility with src/cli/index.ts and tests.
@@ -42,23 +64,22 @@ export async function handleDagCommand(command, args) {
     }
     if (!lean && isLeanMode([]))
         lean = true;
-    // Delegate to registry
+    // Delegate to registry — try N-word paths from remaining args
     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);
+        // Find the longest command path that matches: command + up to 2 sub-words
+        const posIdx = rest.indexOf(firstPositional);
+        const suffixArgs = rest.slice(posIdx);
+        const maxWords = Math.min(suffixArgs.length, 2);
+        for (let n = maxWords; n >= 1; n--) {
+            const candidate = `${command} ${suffixArgs.slice(0, n).join(" ")}`;
+            const cmd = getCommand(candidate);
+            if (cmd) {
+                registeredCmd = cmd;
+                remaining = [...rest.slice(0, posIdx), ...rest.slice(posIdx + n)];
+                break;
             }
         }
     }
@@ -71,18 +92,7 @@ export async function handleDagCommand(command, args) {
     }
     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 (KNOWN_DAG_COMMANDS.includes(command)) {
             if (rest.includes("--help")) {
                 printUsage();
             }

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

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

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAiC7B;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAsDhE"}

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 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 { handleDagCommand, KNOWN_DAG_COMMANDS } from "./dag-commands.js";
 import { formatCommandsDiscovery, generateCommandHelp, generateCommandsDiscovery, } from "./help-generator.js";
 import { render } from "./output-envelope.js";
 import { runSetup } from "./setup.js";
@@ -10,19 +10,16 @@ import { runSetup } from "./setup.js";
 // ---------------------------------------------------------------------------
 /**
  * Determine the longest-match command path from raw args.
- * Tries two-word path first (e.g. "task transition"), then single word.
+ * Tries 3-word, 2-word, then 1-word path. This handles commands like
+ * `knowledge search bm25` or `proposal-doc create` as registry entries.
  */
 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) };
+    // Try at most 3 words as the command path (e.g. "knowledge search bm25")
+    const maxWords = Math.min(args.length, 3);
+    for (let n = maxWords; n >= 1; n--) {
+        const path = args.slice(0, n).join(" ");
+        if (getCommand(path)) {
+            return { path, remaining: args.slice(n) };
         }
     }
     return undefined;
@@ -77,18 +74,10 @@ export async function handleCli(args) {
         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:
+            if (KNOWN_DAG_COMMANDS.includes(command)) {
+                return handleDagCommand(command, args.slice(1));
+            }
             return false;
     }
 }