@agentprojectcontext/apx 1.77.3 → 1.79.0

package/src/interfaces/cli/routes/acp.js

@@ -0,0 +1,13 @@
+// apx acp — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdAcp } from "../commands/acp.js";
+
+export default async function route(rest, { parseArgs }) {
+  // ACP server owns stdio until the client closes the pipe.
+  await cmdAcp(parseArgs(rest));
+  return;
+}

package/src/interfaces/cli/routes/agent.js

@@ -0,0 +1,27 @@
+// apx agent — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdAgentAdd, cmdAgentGet, cmdAgentImport, cmdAgentList, cmdAgentRemove, cmdAgentVaultAdd, cmdAgentVaultList, cmdAgentVaultRestore, cmdAgentVaultRm } from "../commands/agent.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "add") await cmdAgentAdd(a);
+  else if (sub === "list" || sub === "ls") cmdAgentList();
+  else if (sub === "get" || sub === "show") cmdAgentGet(a);
+  else if (sub === "remove" || sub === "rm" || sub === "delete") await cmdAgentRemove(a);
+  else if (sub === "import") await cmdAgentImport(a);
+  else if (sub === "vault") {
+    const vsub = a._[0];
+    const va = { ...a, _: a._.slice(1) };
+    if (vsub === "list" || vsub === "ls") cmdAgentVaultList(va);
+    else if (vsub === "add") await cmdAgentVaultAdd(va);
+    else if (vsub === "rm" || vsub === "remove") cmdAgentVaultRm(va);
+    else if (vsub === "restore") cmdAgentVaultRestore(va);
+    else die(`unknown vault subcommand: ${vsub || "(none)"} — try: list, add, rm, restore`);
+  }
+  else die(`unknown agent subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/artifact.js

@@ -0,0 +1,28 @@
+// apx artifact — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdArtifactCreate, cmdArtifactList, cmdArtifactPreview, cmdArtifactPreviews, cmdArtifactRemove, cmdArtifactRun, cmdArtifactShare, cmdArtifactShow, cmdArtifactStop } from "../commands/artifact.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["artifacts"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "list" || sub === "ls") await cmdArtifactList(a);
+  else if (sub === "create" || sub === "new") await cmdArtifactCreate(a);
+  else if (sub === "show" || sub === "get") await cmdArtifactShow(a);
+  else if (sub === "remove" || sub === "rm") await cmdArtifactRemove(a);
+  else if (sub === "run") await cmdArtifactRun(a);
+  else if (sub === "preview" || sub === "serve") await cmdArtifactPreview(a);
+  else if (sub === "share") await cmdArtifactShare(a);
+  else if (sub === "previews") await cmdArtifactPreviews(a);
+  else if (sub === "stop") await cmdArtifactStop(a);
+  else die(`unknown artifact subcommand: ${sub}`);
+}

package/src/interfaces/cli/routes/chat.js

@@ -0,0 +1,11 @@
+// apx chat — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdChat } from "../commands/chat.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdChat(parseArgs(rest));
+}

package/src/interfaces/cli/routes/code.js

@@ -0,0 +1,11 @@
+// apx code — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdCode } from "../commands/code.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdCode(parseArgs(rest));
+}

package/src/interfaces/cli/routes/command.js

@@ -0,0 +1,21 @@
+// apx command — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdCommandList, cmdCommandShow } from "../commands/command.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["commands"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "list" || sub === "ls") await cmdCommandList(a);
+  else if (sub === "show" || sub === "get") await cmdCommandShow(a);
+  else die(`unknown command subcommand: ${sub}`);
+}

package/src/interfaces/cli/routes/commitment.js

@@ -0,0 +1,19 @@
+// apx commitment — argument routing.
+import {
+  cmdCommitmentAdd, cmdCommitmentList, cmdCommitmentShow,
+  cmdCommitmentKept, cmdCommitmentMissed, cmdCommitmentRenegotiate,
+} from "../commands/commitment.js";
+
+export const aliases = ["commitments"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "list" || sub === "ls") await cmdCommitmentList(a);
+  else if (sub === "add" || sub === "new") await cmdCommitmentAdd(a);
+  else if (sub === "show" || sub === "get") await cmdCommitmentShow(a);
+  else if (sub === "kept" || sub === "done") await cmdCommitmentKept(a);
+  else if (sub === "missed") await cmdCommitmentMissed(a);
+  else if (sub === "renegotiate" || sub === "move") await cmdCommitmentRenegotiate(a);
+  else die(`unknown commitment subcommand: ${sub}\nUsage: apx commitment <list|add|show|kept|missed|renegotiate>`);
+}

package/src/interfaces/cli/routes/config.js

@@ -0,0 +1,16 @@
+// apx config — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdConfigSet, cmdConfigShow, cmdConfigUnset } from "../commands/config.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "show" || sub === "ls" || sub === undefined) await cmdConfigShow(a);
+  else if (sub === "set") await cmdConfigSet(a);
+  else if (sub === "unset" || sub === "rm") await cmdConfigUnset(a);
+  else die(`unknown config subcommand: ${sub}`);
+}

package/src/interfaces/cli/routes/connections.js

@@ -0,0 +1,11 @@
+// apx connections — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdConnections } from "../commands/a2a.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdConnections(parseArgs(rest));
+}

package/src/interfaces/cli/routes/conversations.js

@@ -0,0 +1,21 @@
+// apx conversations — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdConversationsGet, cmdConversationsList } from "../commands/chat.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["conv"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "list" || sub === "ls") await cmdConversationsList(a);
+  else if (sub === "get" || sub === "show") await cmdConversationsGet(a);
+  else die(`unknown conversations subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/daemon.js

@@ -0,0 +1,25 @@
+// apx daemon — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import {
+  cmdDaemonLogs, cmdDaemonReload, cmdDaemonRestart, cmdDaemonStart, cmdDaemonStatus, cmdDaemonStop,
+  cmdDaemonInstallService, cmdDaemonUninstallService, cmdDaemonServiceStatus,
+} from "../commands/daemon.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "start") await cmdDaemonStart(a);
+  else if (sub === "stop") await cmdDaemonStop(a);
+  else if (sub === "restart") await cmdDaemonRestart(a);
+  else if (sub === "reload") await cmdDaemonReload(a);
+  else if (sub === "status") await cmdDaemonStatus(a);
+  else if (sub === "logs") cmdDaemonLogs(a);
+  else if (sub === "install-service") await cmdDaemonInstallService(a);
+  else if (sub === "uninstall-service") await cmdDaemonUninstallService(a);
+  else if (sub === "service-status") await cmdDaemonServiceStatus(a);
+  else die(`unknown daemon subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/desktop.js

@@ -0,0 +1,20 @@
+// apx desktop — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdDesktopInstall, cmdDesktopRestart, cmdDesktopStart, cmdDesktopStatus, cmdDesktopStop, cmdDesktopUninstall } from "../commands/desktop.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const [sub, ...oRest] = rest;
+  const oArgs = parseArgs(oRest);
+  if (!sub || sub === "start")  { await cmdDesktopStart(oArgs); return; }
+  if (sub === "stop")           { await cmdDesktopStop(oArgs);  return; }
+  if (sub === "restart")        { await cmdDesktopRestart(oArgs); return; }
+  if (sub === "status")         { await cmdDesktopStatus(oArgs);return; }
+  if (sub === "install")        { await cmdDesktopInstall(oArgs);  return; }
+  if (sub === "uninstall")      { await cmdDesktopUninstall(oArgs);return; }
+  die(`unknown desktop sub-command: ${sub}\nUsage: apx desktop <start|stop|restart|status|install|uninstall>`);
+  return;
+}

package/src/interfaces/cli/routes/env.js

@@ -0,0 +1,13 @@
+// apx env — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdEnvDetect } from "../commands/runtime.js";
+
+export default async function route(rest, { die }) {
+  const sub = rest[0];
+  if (sub === "detect" || sub === "list") await cmdEnvDetect();
+  else die(`unknown env subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/exec.js

@@ -0,0 +1,11 @@
+// apx exec — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdExec } from "../commands/exec.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdExec(parseArgs(rest));
+}

package/src/interfaces/cli/routes/identity.js

@@ -0,0 +1,11 @@
+// apx identity — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdIdentity } from "../commands/identity.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdIdentity(parseArgs(rest));
+}

package/src/interfaces/cli/routes/index.js

@@ -0,0 +1,75 @@
+// Command registry: name (and alias) -> lazy loader for its route module.
+//
+// Lazy on purpose. cli/index.js used to eagerly import 165 symbols from 38
+// command modules just to reach a 457-line switch, so `apx status` paid to
+// load the Electron desktop wiring, the MCP runner and the session scanner.
+// Now one command loads one module.
+//
+// Aliases live next to their command (see the `aliases` export in each route
+// module); this map is generated from them.
+export const ROUTES = Object.freeze({
+  "init": () => import("./init.js"),
+  "project": () => import("./project.js"),
+  "agent": () => import("./agent.js"),
+  "memory": () => import("./memory.js"),
+  "session": () => import("./session.js"),
+  "sessions": () => import("./sessions.js"),
+  "mcp": () => import("./mcp.js"),
+  "obsidian": () => import("./obsidian.js"),
+  "daemon": () => import("./daemon.js"),
+  "pair": () => import("./pair.js"),
+  "telegram": () => import("./telegram.js"),
+  "messages": () => import("./messages.js"),
+  "log": () => import("./log.js"),
+  "logs": () => import("./log.js"),
+  "exec": () => import("./exec.js"),
+  "acp": () => import("./acp.js"),
+  "search": () => import("./search.js"),
+  "chat": () => import("./chat.js"),
+  "code": () => import("./code.js"),
+  "conversations": () => import("./conversations.js"),
+  "conv": () => import("./conversations.js"),
+  "run": () => import("./run.js"),
+  "env": () => import("./env.js"),
+  "send": () => import("./send.js"),
+  "connections": () => import("./connections.js"),
+  "config": () => import("./config.js"),
+  "permission": () => import("./permission.js"),
+  "model": () => import("./model.js"),
+  "plugins": () => import("./plugins.js"),
+  "plugin": () => import("./plugins.js"),
+  "routine": () => import("./routine.js"),
+  "routines": () => import("./routine.js"),
+  "artifact": () => import("./artifact.js"),
+  "artifacts": () => import("./artifact.js"),
+  "task": () => import("./task.js"),
+  "tasks": () => import("./task.js"),
+  "commitment": () => import("./commitment.js"),
+  "commitments": () => import("./commitment.js"),
+  "panel": () => import("./panel.js"),
+  "profile": () => import("./profile.js"),
+  "profiles": () => import("./profile.js"),
+  "nudge": () => import("./nudge.js"),
+  "nudges": () => import("./nudge.js"),
+  "command": () => import("./command.js"),
+  "commands": () => import("./command.js"),
+  "org": () => import("./org.js"),
+  "organization": () => import("./org.js"),
+  "skills": () => import("./skills.js"),
+  "identity": () => import("./identity.js"),
+  "status": () => import("./status.js"),
+  "setup": () => import("./setup.js"),
+  "install": () => import("./setup.js"),
+  "update": () => import("./update.js"),
+  "upgrade": () => import("./update.js"),
+  "restart": () => import("./restart.js"),
+  "overlay": () => import("./overlay.js"),
+  "desktop": () => import("./desktop.js"),
+  "voice": () => import("./voice.js"),
+});
+
+export function resolveRoute(cmd) {
+  return ROUTES[cmd] || null;
+}
+
+export const COMMAND_NAMES = Object.freeze(Object.keys(ROUTES));

package/src/interfaces/cli/routes/init.js

@@ -0,0 +1,11 @@
+// apx init — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdInit } from "../commands/init.js";
+
+export default async function route(rest, { parseArgs }) {
+  cmdInit(parseArgs(rest));
+}

package/src/interfaces/cli/routes/log.js

@@ -0,0 +1,20 @@
+// apx log — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdLog } from "../commands/log.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["logs"];
+
+export default async function route(rest, { parseArgs }) {
+  // `apx log` is the unified daemon log (everything: telegram, whisper,
+  // super-agent, tools, desktop). For just the legacy stdout sink,
+  // use `apx daemon logs`. `apx log -f` follows; `--errors` filters.
+  await cmdLog(parseArgs(rest));
+}

package/src/interfaces/cli/routes/mcp.js

@@ -0,0 +1,22 @@
+// apx mcp — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdMcpAdd, cmdMcpCheck, cmdMcpDisable, cmdMcpEnable, cmdMcpList, cmdMcpLogs, cmdMcpRemove, cmdMcpRun, cmdMcpTools } from "../commands/mcp.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "list" || sub === "ls") await cmdMcpList(a);
+  else if (sub === "add") await cmdMcpAdd(a);
+  else if (sub === "remove" || sub === "rm") await cmdMcpRemove(a);
+  else if (sub === "enable") await cmdMcpEnable(a);
+  else if (sub === "disable") await cmdMcpDisable(a);
+  else if (sub === "run") await cmdMcpRun(a);
+  else if (sub === "tools") await cmdMcpTools(a);
+  else if (sub === "logs") await cmdMcpLogs(a);
+  else if (sub === "check") await cmdMcpCheck(a);
+  else die(`unknown mcp subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/memory.js

@@ -0,0 +1,19 @@
+// apx memory — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdMemory, cmdMemoryNotebook, cmdMemoryConsolidate, cmdMemoryRevert } from "../commands/memory.js";
+
+export default async function route(rest, { parseArgs }) {
+  // `apx memory <agent-slug>` is the original form and stays the default, so
+  // these three names are reserved. An agent literally called "notebook" would
+  // be shadowed; that is a trade worth making for a readable command.
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "notebook") return cmdMemoryNotebook(a);
+  if (sub === "consolidate") return cmdMemoryConsolidate(a);
+  if (sub === "revert") return cmdMemoryRevert(a);
+  return cmdMemory(parseArgs(rest));
+}

package/src/interfaces/cli/routes/messages.js

@@ -0,0 +1,16 @@
+// apx messages — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdMessagesChat, cmdMessagesSearch, cmdMessagesTail } from "../commands/messages.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "tail") await cmdMessagesTail(a);
+  else if (sub === "chat") await cmdMessagesChat(a);
+  else if (sub === "search") await cmdMessagesSearch(a);
+  else die(`unknown messages subcommand: ${sub || "(none)"}`);
+}

package/src/interfaces/cli/routes/model.js

@@ -0,0 +1,11 @@
+// apx model — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdModel } from "../commands/model.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdModel(parseArgs(rest));
+}

package/src/interfaces/cli/routes/nudge.js

@@ -0,0 +1,17 @@
+// apx nudge — argument routing for the interruption budget.
+import {
+  cmdNudgeStatus, cmdNudgeList, cmdNudgeSet, cmdNudgeCheck, cmdNudgeFeedback,
+} from "../commands/nudge.js";
+
+export const aliases = ["nudges"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "status") await cmdNudgeStatus(a);
+  else if (sub === "list" || sub === "ls") await cmdNudgeList(a);
+  else if (sub === "set" || sub === "config") await cmdNudgeSet(a);
+  else if (sub === "check") await cmdNudgeCheck(a);
+  else if (sub === "feedback") await cmdNudgeFeedback(a);
+  else die(`unknown nudge subcommand: ${sub}\nUsage: apx nudge <status|list|set|check|feedback>`);
+}

package/src/interfaces/cli/routes/obsidian.js

@@ -0,0 +1,17 @@
+// apx obsidian — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdObsidianRemove, cmdObsidianSet, cmdObsidianStatus, cmdObsidianSync } from "../commands/obsidian.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "status" || sub === "show") await cmdObsidianStatus(a);
+  else if (sub === "set" || sub === "connect" || sub === "add") await cmdObsidianSet(a);
+  else if (sub === "sync") await cmdObsidianSync(a);
+  else if (sub === "remove" || sub === "rm" || sub === "disconnect") await cmdObsidianRemove(a);
+  else die(`unknown obsidian subcommand: ${sub}\nUsage: apx obsidian <set|status|sync|remove> [--global|--project <p>]`);
+}

package/src/interfaces/cli/routes/org.js

@@ -0,0 +1,34 @@
+// apx org — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdOrgAreaAdd, cmdOrgAreaRm, cmdOrgRoleAdd, cmdOrgRoleRm, cmdOrgShow } from "../commands/org.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["organization"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  // `apx org area add ...` / `apx org role rm ...` — the resource verb is
+  // the first positional, the action the second.
+  if (!sub || sub === "show" || sub === "list") await cmdOrgShow(a);
+  else if (sub === "area") {
+    const action = rest[1];
+    const aa = parseArgs(rest.slice(1)); // keep `area` as _[0] for name parsing
+    if (action === "add" || action === "new") await cmdOrgAreaAdd(aa);
+    else if (action === "rm" || action === "remove" || action === "delete") await cmdOrgAreaRm(aa);
+    else die("usage: apx org area <add|rm> ...");
+  } else if (sub === "role") {
+    const action = rest[1];
+    const ra = parseArgs(rest.slice(1));
+    if (action === "add" || action === "new") await cmdOrgRoleAdd(ra);
+    else if (action === "rm" || action === "remove" || action === "delete") await cmdOrgRoleRm(ra);
+    else die("usage: apx org role <add|rm> ...");
+  } else die(`unknown org subcommand: ${sub}\nUsage: apx org <show|area|role> ...`);
+}

package/src/interfaces/cli/routes/overlay.js

@@ -0,0 +1,10 @@
+// apx overlay — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+export default async function route(_rest, _ctx) {
+  console.error("  apx overlay has been renamed to apx desktop — forwarding.");
+  /* falls through */
+}

package/src/interfaces/cli/routes/pair.js

@@ -0,0 +1,17 @@
+// apx pair — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdPair, cmdPairList, cmdPairRevoke, cmdPairWeb } from "../commands/pair.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "new" || sub === "device" || sub === "deck") await cmdPair(a);
+  else if (sub === "web") await cmdPairWeb(a);
+  else if (sub === "list" || sub === "ls") await cmdPairList();
+  else if (sub === "revoke" || sub === "rm") await cmdPairRevoke(a);
+  else die(`unknown pair subcommand: ${sub} — try: (no arg)/deck, web, list, revoke <id>`);
+}

package/src/interfaces/cli/routes/panel.js

@@ -0,0 +1,16 @@
+// apx panel — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdPanelShare, cmdPanelStatus, cmdPanelUnshare } from "../commands/panel.js";
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (!sub || sub === "status") await cmdPanelStatus(a);
+  else if (sub === "share") await cmdPanelShare(a);
+  else if (sub === "unshare") await cmdPanelUnshare(a);
+  else die(`unknown panel subcommand: ${sub}\nUsage: apx panel <status|share|unshare>`);
+}

package/src/interfaces/cli/routes/permission.js

@@ -0,0 +1,11 @@
+// apx permission — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdPermission } from "../commands/config.js";
+
+export default async function route(rest, { parseArgs }) {
+  await cmdPermission(parseArgs(rest));
+}

package/src/interfaces/cli/routes/plugins.js

@@ -0,0 +1,21 @@
+// apx plugins — argument routing.
+//
+// Extracted from the 457-line dispatch() switch in cli/index.js. Each command
+// owns its own routing and imports only the command functions it calls, so the
+// CLI no longer loads all 38 command modules to run one of them.
+
+import { cmdPluginStatus, cmdPluginsList } from "../commands/plugins.js";
+
+// Aliases accepted for this command. Declared here, next to the command
+// itself — a global alias table would be wrong, since the same word means
+// different things under different commands ("rm" is remove under `agent`,
+// unset under `project config`, revoke under `pair`).
+export const aliases = ["plugin"];
+
+export default async function route(rest, { parseArgs, die }) {
+  const sub = rest[0];
+  const a = parseArgs(rest.slice(1));
+  if (sub === "list" || sub === "ls" || sub === undefined) await cmdPluginsList();
+  else if (sub === "status") await cmdPluginStatus(a);
+  else die(`unknown plugins subcommand: ${sub}`);
+}