@cello-protocol/cli 0.0.43 → 0.0.45

package/dist/arg-parse.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared argv parsing primitives.
+ *
+ * Extracted from cli-args.ts (DOD-CLI-PARITY-1 Phase 0) so that BOTH the registry (which parses a
+ * command's args inside its run()) and cli-args (which validates them before dispatch) can use it
+ * without an import cycle: cli-args → registry → arg-parse, never back.
+ */
+/**
+ * Split a subcommand's argv into the `--agent <name>` flag and the remaining positionals.
+ *
+ * Extracted originally (MONIKER-1 review Finding 1) because the old inline filter used
+ * `i === agentIdx + 1` unguarded: with --agent ABSENT, agentIdx is -1 and the predicate silently
+ * dropped positional index 0 — `cello moniker set Bob` / `cello contact list` printed usage instead
+ * of dispatching. The flag's value is excluded ONLY when the flag exists.
+ */
+export declare function splitAgentFlag(args: string[]): {
+    agent: string | undefined;
+    positional: string[];
+};
+//# sourceMappingURL=arg-parse.d.ts.map

package/dist/arg-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-parse.d.ts","sourceRoot":"","sources":["../src/arg-parse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAalG"}

package/dist/arg-parse.js

@@ -0,0 +1,30 @@
+/**
+ * Shared argv parsing primitives.
+ *
+ * Extracted from cli-args.ts (DOD-CLI-PARITY-1 Phase 0) so that BOTH the registry (which parses a
+ * command's args inside its run()) and cli-args (which validates them before dispatch) can use it
+ * without an import cycle: cli-args → registry → arg-parse, never back.
+ */
+/**
+ * Split a subcommand's argv into the `--agent <name>` flag and the remaining positionals.
+ *
+ * Extracted originally (MONIKER-1 review Finding 1) because the old inline filter used
+ * `i === agentIdx + 1` unguarded: with --agent ABSENT, agentIdx is -1 and the predicate silently
+ * dropped positional index 0 — `cello moniker set Bob` / `cello contact list` printed usage instead
+ * of dispatching. The flag's value is excluded ONLY when the flag exists.
+ */
+export function splitAgentFlag(args) {
+    // POSIX `--` end-of-flags terminator (review F1): everything after the first `--` is a positional
+    // VALUE, verbatim — so a value that starts with `-` (a negative number, or an away text like
+    // "- back Monday") can be passed. --agent is recognized only BEFORE the terminator.
+    const ddIdx = args.indexOf("--");
+    const flagScan = ddIdx === -1 ? args : args.slice(0, ddIdx);
+    const afterTerminator = ddIdx === -1 ? [] : args.slice(ddIdx + 1);
+    const agentIdx = flagScan.indexOf("--agent");
+    const agent = agentIdx !== -1 ? flagScan[agentIdx + 1] : undefined;
+    const positional = flagScan
+        .filter((a, i) => !(a === "--agent" || (agentIdx !== -1 && i === agentIdx + 1)))
+        .concat(afterTerminator);
+    return { agent, positional };
+}
+//# sourceMappingURL=arg-parse.js.map

package/dist/arg-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-parse.js","sourceRoot":"","sources":["../src/arg-parse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,kGAAkG;IAClG,6FAA6F;IAC7F,oFAAoF;IACpF,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5D,MAAM,eAAe,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,MAAM,UAAU,GAAG,QAAQ;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;SAC/E,MAAM,CAAC,eAAe,CAAC,CAAC;IAC3B,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC/B,CAAC"}

package/dist/bin/cello.d.ts

@@ -2,11 +2,14 @@
 /**
  * cello — the CELLO CLI binary.
  *
- * Commands:
- *   cello login    — Start the daemon (or connect to existing), exit 0
- *   cello logout   — Send shutdown command to daemon
- *   cello status   — Query daemon and print structured JSON response
- *   cello register — Register a loaded agent with the directory (ML-DSA + FROST DKG)
+ * DOD-CLI-PARITY-1 Phase 0: this file no longer contains a dispatch switch. Every command lives in
+ * the registry (src/registry.ts), which is also what renders `cello --help` and per-command help —
+ * so dispatch, the command table, and the help text cannot drift apart. Adding a command means
+ * adding one registry entry; this binary does not change.
+ *
+ * The bash-adapter contract (§3): a command's JSON result goes to stdout, a structured failure goes
+ * to stderr VERBATIM, and the exit code branches on it — so any bash-capable agent can drive a
+ * CELLO node with `cello <cmd> | jq` and `$?`, with no MCP dependency.
  */
 export {};
 //# sourceMappingURL=cello.d.ts.map

package/dist/bin/cello.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cello.d.ts","sourceRoot":"","sources":["../../src/bin/cello.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}
+{"version":3,"file":"cello.d.ts","sourceRoot":"","sources":["../../src/bin/cello.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/bin/cello.js

@@ -2,17 +2,20 @@
 /**
  * cello — the CELLO CLI binary.
  *
- * Commands:
- *   cello login    — Start the daemon (or connect to existing), exit 0
- *   cello logout   — Send shutdown command to daemon
- *   cello status   — Query daemon and print structured JSON response
- *   cello register — Register a loaded agent with the directory (ML-DSA + FROST DKG)
+ * DOD-CLI-PARITY-1 Phase 0: this file no longer contains a dispatch switch. Every command lives in
+ * the registry (src/registry.ts), which is also what renders `cello --help` and per-command help —
+ * so dispatch, the command table, and the help text cannot drift apart. Adding a command means
+ * adding one registry entry; this binary does not change.
+ *
+ * The bash-adapter contract (§3): a command's JSON result goes to stdout, a structured failure goes
+ * to stderr VERBATIM, and the exit code branches on it — so any bash-capable agent can drive a
+ * CELLO node with `cello <cmd> | jq` and `$?`, with no MCP dependency.
  */
 import { homedir } from "node:os";
 import { join, dirname } from "node:path";
 import { createRequire } from "node:module";
-import { login, logout, status, register, createAgent, removeAgent, refreshShares, relayReceipts, sessions, contactAdd, contactRemove, contactList, monikerSet, telegramSetToken } from "../commands.js";
-import { USAGE, KNOWN_COMMANDS, checkArgs, helpForCommand, splitAgentFlag } from "../cli-args.js";
+import { KNOWN_COMMANDS, USAGE, checkArgs, helpForCommand } from "../cli-args.js";
+import { findCommand } from "../registry.js";
 const logger = {
     debug(event, context) {
         const line = JSON.stringify({ level: "debug", event, ...context, ts: new Date().toISOString() });
@@ -38,173 +41,40 @@ const require = createRequire(import.meta.url);
 const daemonPkgPath = require.resolve("@cello-protocol/daemon/package.json");
 const daemonBin = join(dirname(daemonPkgPath), "dist/bin/cello-daemon.js");
 async function main() {
-    let result;
-    // M8B F2: answer --help/-h on every subcommand and REJECT unknown flags before
-    // dispatch, so a flag can never be coerced into a positional argument (previously
-    // `cello register --help` tried to register an agent literally named "--help").
-    if (command && KNOWN_COMMANDS.has(command)) {
-        const check = checkArgs(command, process.argv.slice(3));
-        if (check.kind === "help") {
-            process.stdout.write(helpForCommand(command) + "\n");
-            process.exit(0);
-            return;
-        }
-        if (check.kind === "unknown_flag") {
-            process.stderr.write(`Unknown flag '${check.flag}' for 'cello ${command}'.\n`);
-            process.stdout.write(helpForCommand(command) + "\n");
-            process.exit(1);
-            return;
-        }
+    const spec = command ? findCommand(command) : undefined;
+    if (!spec || !KNOWN_COMMANDS.has(command)) {
+        // No command, or one we don't have: print the described command table.
+        process.stdout.write(USAGE + "\n");
+        process.exit(command ? 1 : 0);
+        return;
+    }
+    const args = process.argv.slice(3);
+    // M8B F2: answer --help/-h on every subcommand and REJECT unknown flags BEFORE dispatch, so a
+    // flag can never be coerced into a positional argument.
+    const check = checkArgs(command, args);
+    if (check.kind === "help") {
+        process.stdout.write(helpForCommand(command) + "\n");
+        process.exit(0);
+        return;
     }
-    switch (command) {
-        case "login":
-            result = await login(celloDir, daemonBin, logger);
-            break;
-        case "logout":
-            // DOD-LOGOUT-WAIT-1: logout now WAITS for the daemon to actually die before claiming
-            // "Daemon stopped." — the immediate progress line tells the operator the command
-            // activated and the short pause is expected.
-            result = await logout(celloDir, (line) => process.stdout.write(line + "\n"));
-            break;
-        case "status":
-            result = await status(celloDir);
-            break;
-        case "register": {
-            // cello register <agent> [preAuthToken]  (token falls back to CELLO_PREAUTH_TOKEN
-            // so it need not appear in shell history). Optional phone stub follows.
-            const agent = process.argv[3] ?? "";
-            const preAuthToken = process.argv[4] ?? process.env.CELLO_PREAUTH_TOKEN ?? "";
-            const phoneStub = process.argv[5] ?? "";
-            // M8C-ONBOARD-WARN-1 (revised 2026-07-06, Andre): the pre-auth exposure "note" is REMOVED
-            // entirely. A single-use, 24h, consumed-on-success token has no meaningful exposure risk, so
-            // the note only drew attention to a non-issue ("this thing you weren't worried about? don't
-            // worry about it") — pure noise on the core onboarding path. No warning at all is correct.
-            result = await register(celloDir, agent, preAuthToken, phoneStub);
-            break;
-        }
-        case "create-agent": {
-            // cello create-agent <name> — create a fresh local agent identity (PERSIST-002 AC-004).
-            const name = process.argv[3] ?? "";
-            result = await createAgent(celloDir, name);
-            break;
-        }
-        case "remove-agent": {
-            // cello remove-agent <name> — retire a local agent (one-way) and free its name (REMOVE-001).
-            const name = process.argv[3] ?? "";
-            result = await removeAgent(celloDir, name);
-            break;
-        }
-        case "refresh": {
-            // cello refresh <name> — proactive share refresh / epoch rollover (M8B DOD-REFRESH-1).
-            const name = process.argv[3] ?? "";
-            result = await refreshShares(celloDir, name);
-            break;
-        }
-        case "receipts": {
-            // cello receipts <name> — list the agent's stored relay ordering receipts (M8B DOD-RELAYSIG-1).
-            const name = process.argv[3] ?? "";
-            result = await relayReceipts(celloDir, name);
-            break;
-        }
-        case "sessions": {
-            // cello sessions [--open|--closed|--failed|--all] [--limit N] — the full session history.
-            // Defaults to open (live + resumable) so failed/closed don't flood it; the daemon caps the
-            // count. (`cello status` only ever shows live/resumable, never this full list.)
-            const args = process.argv.slice(3);
-            let filter;
-            if (args.includes("--all"))
-                filter = "all";
-            else if (args.includes("--closed"))
-                filter = "closed";
-            else if (args.includes("--failed"))
-                filter = "failed";
-            else if (args.includes("--open"))
-                filter = "open";
-            const limitIdx = args.indexOf("--limit");
-            let limit;
-            if (limitIdx !== -1 && args[limitIdx + 1] !== undefined) {
-                const n = Number(args[limitIdx + 1]);
-                if (Number.isFinite(n) && n > 0)
-                    limit = Math.floor(n);
-            }
-            result = await sessions(celloDir, { filter, limit });
-            break;
-        }
-        case "contact": {
-            // cello contact add <pubkey> [--agent <name>] | remove <pubkey> [--agent <name>] | list [--agent <name>]
-            const { agent, positional } = splitAgentFlag(process.argv.slice(3));
-            const [sub, pubkey] = positional;
-            if (sub === "add" && pubkey) {
-                result = await contactAdd(celloDir, pubkey, agent);
-            }
-            else if (sub === "remove" && pubkey) {
-                result = await contactRemove(celloDir, pubkey, agent);
-            }
-            else if (sub === "list") {
-                result = await contactList(celloDir, agent);
-            }
-            else {
-                result = { exitCode: 1, output: "Usage: cello contact add|remove <pubkey> [--agent <name>] | cello contact list [--agent <name>]" };
-            }
-            break;
-        }
-        case "moniker": {
-            // cello moniker set <name> [--agent <agent>] | cello moniker clear [--agent <agent>] (MONIKER-1)
-            const { agent, positional } = splitAgentFlag(process.argv.slice(3));
-            const [sub, name] = positional;
-            if (sub === "set" && name) {
-                result = await monikerSet(celloDir, name, agent);
-            }
-            else if (sub === "clear" && !name) {
-                result = await monikerSet(celloDir, null, agent);
-            }
-            else {
-                result = { exitCode: 1, output: helpForCommand("moniker") };
-            }
-            break;
-        }
-        case "telegram": {
-            // cello telegram set-token <bot_token> <allowlisted_chat_id>
-            const sub = process.argv[3];
-            const botToken = process.argv[4];
-            const chatId = process.argv[5];
-            if (sub === "set-token" && botToken && chatId) {
-                result = await telegramSetToken(celloDir, botToken, chatId);
-            }
-            else {
-                result = { exitCode: 1, output: "Usage: cello telegram set-token <bot_token> <allowlisted_chat_id>" };
-            }
-            break;
-        }
-        case "install": {
-            // cello install hermes --agent <name> [--hermes-home <path>] (HERMES-001)
-            const args = process.argv.slice(3);
-            const agentIdx = args.indexOf("--agent");
-            const homeIdx = args.indexOf("--hermes-home");
-            // Find the target positional, excluding both flags AND their values — so
-            // `cello install --agent alice hermes` still resolves target=hermes (mirrors
-            // the `contact` case's positional filter).
-            const target = args.find((a, i) => !a.startsWith("-") &&
-                !(agentIdx !== -1 && i === agentIdx + 1) &&
-                !(homeIdx !== -1 && i === homeIdx + 1));
-            if (target !== "hermes") {
-                result = { exitCode: 1, output: helpForCommand("install") };
-                break;
-            }
-            const { installHermes } = await import("../hermes/install-hermes.js");
-            result = await installHermes({
-                agentName: agentIdx !== -1 ? (args[agentIdx + 1] ?? "") : "",
-                hermesHome: homeIdx !== -1 ? args[homeIdx + 1] : undefined,
-            });
-            break;
-        }
-        default:
-            // M8B F1: the usage string lists EVERY command (refresh/receipts were missing).
-            process.stdout.write(USAGE + "\n");
-            process.exit(command ? 1 : 0);
-            return;
+    if (check.kind === "unknown_flag") {
+        process.stderr.write(`Unknown flag '${check.flag}' for 'cello ${command}'.\n`);
+        process.stdout.write(helpForCommand(command) + "\n");
+        process.exit(1);
+        return;
     }
-    process.stdout.write(result.output + "\n");
+    const ctx = {
+        celloDir,
+        daemonBin,
+        logger,
+        onProgress: (line) => process.stdout.write(line + "\n"),
+    };
+    const result = await spec.run(ctx, args);
+    // Report the outcome, never the intent: stdout carries the result, stderr the structured failure.
+    if (result.stdout.length > 0)
+        process.stdout.write(result.stdout + "\n");
+    if (result.stderr.length > 0)
+        process.stderr.write(result.stderr + "\n");
     process.exit(result.exitCode);
 }
 main().catch((err) => {

package/dist/bin/cello.js.map

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

package/dist/cli-args.d.ts

@@ -1,15 +1,31 @@
 /**
- * M8B riders F1/F2 — CLI argument handling, extracted from src/bin/cello.ts so the
+ * CLI argument handling — validation that runs BEFORE dispatch, kept out of src/bin/cello.ts so the
  * usage surface is testable without spawning the binary.
  *
- * F1: USAGE lists EVERY dispatchable command (refresh and receipts were missing).
- * F2: every subcommand answers --help/-h, and an unrecognized flag is REJECTED
- *     instead of being coerced into a positional argument (previously
- *     `cello register --help` tried to register an agent literally named "--help").
+ * M8B riders F1/F2 (原): USAGE lists EVERY dispatchable command; every subcommand answers --help/-h;
+ * an unrecognized flag is REJECTED rather than coerced into a positional (previously
+ * `cello register --help` tried to register an agent literally named "--help").
+ *
+ * DOD-CLI-PARITY-1 Phase 0: this module no longer OWNS the command list, the help text, or the flag
+ * table — it DERIVES all three from the registry (registry.ts), the single source of truth. That is
+ * what makes drift between dispatch, `cello --help`, and `cello <cmd> --help` structurally
+ * impossible rather than merely discouraged.
+ */
+import { COMMANDS } from "./registry.js";
+export { splitAgentFlag } from "./arg-parse.js";
+/** Every dispatchable command — derived, so it cannot fall out of step with the registry. */
+export declare const KNOWN_COMMANDS: ReadonlySet<string>;
+export type KnownCommand = string;
+/**
+ * The top-level `cello --help`.
+ *
+ * CC-7 (P2-5 / DOD-ONBOARD-HELP-1): opens with what CELLO is + the onboarding path a first-time
+ * user needs. DOD-CLI-PARITY-1 §7 closes the remaining gap — the command list is now a DESCRIBED
+ * table rendered from each registry entry's `summary` (it used to be a single pipe-delimited blob
+ * with no per-command descriptions). Arguments stay in per-command `--help`.
  */
-export declare const KNOWN_COMMANDS: Set<"login" | "logout" | "status" | "register" | "create-agent" | "remove-agent" | "refresh" | "receipts" | "sessions" | "contact" | "moniker" | "telegram" | "install">;
-export type KnownCommand = typeof KNOWN_COMMANDS extends Set<infer T> ? T : never;
 export declare const USAGE: string;
+/** Per-command help — the registry entry's own text, verbatim. */
 export declare function helpForCommand(command: string): string;
 export type ArgsCheck = {
     kind: "ok";
@@ -22,21 +38,13 @@ export type ArgsCheck = {
 /**
  * F2: validate a subcommand's arguments BEFORE dispatch.
  *  - --help / -h ANYWHERE → help. This is a dedicated pre-scan so help wins even when it
- *    follows an unknown flag or sits where --limit would consume its value — asking for
+ *    follows an unknown flag or sits where a value-consuming flag would swallow it — asking for
  *    help must never be masked by another argument error.
  *  - any other dash-prefixed token the command does not recognize → unknown_flag
  *    (never silently coerced into a positional).
+ *  - after a POSIX `--` terminator, everything is a positional VALUE, verbatim.
  */
-/**
- * Split a subcommand's argv into the `--agent <name>` flag and the remaining positionals.
- * Extracted (MONIKER-1 review Finding 1) because the old inline filter used
- * `i === agentIdx + 1` unguarded: with --agent ABSENT, agentIdx is -1 and the predicate
- * silently dropped positional index 0 — `cello moniker set Bob` / `cello contact list`
- * printed usage instead of dispatching. The flag's value is excluded ONLY when the flag exists.
- */
-export declare function splitAgentFlag(args: string[]): {
-    agent: string | undefined;
-    positional: string[];
-};
 export declare function checkArgs(command: string, args: string[]): ArgsCheck;
+/** The registry, re-exported for callers that want to enumerate commands (e.g. the dispatcher). */
+export { COMMANDS };
 //# sourceMappingURL=cli-args.d.ts.map

package/dist/cli-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,cAAc,0KAchB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAIlF,eAAO,MAAM,KAAK,QAO0C,CAAC;AA8C7D,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAUD,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;;;;;;GAOG;AACH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAKlG;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAWpE"}
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAA4D,MAAM,eAAe,CAAC;AAInG,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,6FAA6F;AAC7F,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAA2B,CAAC;AAE3E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,QAiBiF,CAAC;AAEpG,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAapE;AAED,mGAAmG;AACnG,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/cli-args.js

@@ -1,117 +1,78 @@
 /**
- * M8B riders F1/F2 — CLI argument handling, extracted from src/bin/cello.ts so the
+ * CLI argument handling — validation that runs BEFORE dispatch, kept out of src/bin/cello.ts so the
  * usage surface is testable without spawning the binary.
  *
- * F1: USAGE lists EVERY dispatchable command (refresh and receipts were missing).
- * F2: every subcommand answers --help/-h, and an unrecognized flag is REJECTED
- *     instead of being coerced into a positional argument (previously
- *     `cello register --help` tried to register an agent literally named "--help").
+ * M8B riders F1/F2 (原): USAGE lists EVERY dispatchable command; every subcommand answers --help/-h;
+ * an unrecognized flag is REJECTED rather than coerced into a positional (previously
+ * `cello register --help` tried to register an agent literally named "--help").
+ *
+ * DOD-CLI-PARITY-1 Phase 0: this module no longer OWNS the command list, the help text, or the flag
+ * table — it DERIVES all three from the registry (registry.ts), the single source of truth. That is
+ * what makes drift between dispatch, `cello --help`, and `cello <cmd> --help` structurally
+ * impossible rather than merely discouraged.
+ */
+import { COMMANDS, commandNames, findCommand, flagsFor, renderCommandsTable } from "./registry.js";
+// Re-exported for the dispatch layer and existing callers (its home is arg-parse.ts, which both
+// this module and the registry depend on — see the import-cycle note there).
+export { splitAgentFlag } from "./arg-parse.js";
+/** Every dispatchable command — derived, so it cannot fall out of step with the registry. */
+export const KNOWN_COMMANDS = new Set(commandNames());
+/**
+ * The top-level `cello --help`.
+ *
+ * CC-7 (P2-5 / DOD-ONBOARD-HELP-1): opens with what CELLO is + the onboarding path a first-time
+ * user needs. DOD-CLI-PARITY-1 §7 closes the remaining gap — the command list is now a DESCRIBED
+ * table rendered from each registry entry's `summary` (it used to be a single pipe-delimited blob
+ * with no per-command descriptions). Arguments stay in per-command `--help`.
  */
-import { MONIKER_RE } from "@cello-protocol/protocol-types";
-export const KNOWN_COMMANDS = new Set([
-    "login",
-    "logout",
-    "status",
-    "register",
-    "create-agent",
-    "remove-agent",
-    "refresh",
-    "receipts",
-    "sessions",
-    "contact",
-    "moniker",
-    "telegram",
-    "install",
-]);
-// CC-7 (P2-5 / DOD-ONBOARD-HELP-1): the top level opens with what CELLO is + the onboarding path a
-// first-time user needs, then the command list. (Per-command `cello <cmd> --help` was already good.)
 export const USAGE = "CELLO — a peer-to-peer identity & trust layer for agent-to-agent communication.\n" +
     "\n" +
     "First-time setup:  cello login  →  cello create-agent <name>  →  cello register <name> <token>  →  cello status\n" +
     "  (get <token> from the CELLO Operations Agent on Telegram; 'cello login' starts the local daemon.)\n" +
     "\n" +
-    "Usage: cello <login|logout|status|register|create-agent|remove-agent|refresh|receipts|sessions|contact|moniker|telegram|install>\n" +
-    "Run 'cello <command> --help' for details on any command.";
-/** Per-command usage lines (the same text the commands print on bad input). */
-const COMMAND_HELP = {
-    login: "Usage: cello login  — start the daemon (or connect to an existing one).",
-    logout: "Usage: cello logout  — send shutdown to the running daemon.",
-    status: "Usage: cello status  — query the daemon and print the structured status JSON.",
-    register: "Usage: cello register <agent> <pre-auth-token>  — register a LOCAL agent with the directory.\n" +
-        "  The two-step onboarding: (1) 'cello create-agent <name>' makes the local identity; (2) 'cello register <name> <token>' registers it with the directory.\n" +
-        "  The token is a single-use pre-authorization ticket from the CELLO Operations Agent on Telegram, format 'CELLO-' + 33 characters, valid 24h.\n" +
-        "  Example:  cello register alice CELLO-3xY7...\n" +
-        "  Env-var form (avoids retyping):  CELLO_PREAUTH_TOKEN=CELLO-3xY7... cello register alice\n" +
-        "  Quoting is only needed if a value contains spaces (agent names and tokens never do).",
-    "create-agent": "Usage: cello create-agent <name>  — create a new LOCAL agent identity (does not touch the directory).\n" +
-        // MONIKER-0 AC2: the regex text is DERIVED from the shared constant, never hand-typed.
-        `  Name rule: 1–64 characters, letters/digits/'-'/'_' only, no spaces (regex ${MONIKER_RE.source}).\n` +
-        "  Next step: 'cello register <name> <pre-auth-token>' to register it with the directory.",
-    "remove-agent": "Usage: cello remove-agent <name>  — retires a local agent (one-way) and frees its name.",
-    refresh: "Usage: cello refresh <name>  — proactively refresh the agent's threshold shares (new epoch).",
-    receipts: "Usage: cello receipts <name>  — list the agent's stored relay ordering receipts.",
-    sessions: "Usage: cello sessions [--open|--closed|--failed|--all] [--limit N]  — list session history (defaults to open).",
-    contact: "Usage: cello contact add <pubkey> [--agent <name>] | cello contact remove <pubkey> [--agent <name>] | cello contact list [--agent <name>]\n" +
-        "  Per-agent contact whitelist (M8C-CONTACT-1). --agent defaults to the current/sole-online agent.\n" +
-        "  Contacts are added automatically too: initiating a session to X, or accepting X's inbound request, adds X.\n" +
-        "  Example:  cello contact list --agent alice",
-    moniker: "Usage: cello moniker set <name> [--agent <agent>] | cello moniker clear [--agent <agent>]\n" +
-        "  The agent's OUTBOUND name — what a counterparty's doorbell shows (MONIKER-1). Defaults to the agent name; 'set' stores an override, 'clear' restores the default.\n" +
-        // MONIKER-0 AC2: the regex text is DERIVED from the shared constant, never hand-typed.
-        `  Name rule: 1–64 characters, letters/digits/'-'/'_' only, no spaces (regex ${MONIKER_RE.source}).\n` +
-        "  Local-only: never sent to the directory; the receiver treats it as an unverified hint (like caller ID).\n" +
-        "  Example:  cello moniker set Wonderland_Alice --agent alice",
-    telegram: "Usage: cello telegram set-token <bot_token> <allowlisted_chat_id>  — configure the daemon-owned Telegram doorbell (M8C-TGDOOR-1).\n" +
-        "  Starts a single long-lived poller immediately; the operator chat given is the ONLY one that ever receives doorbell events.",
-    install: "Usage: cello install hermes --agent <name> [--hermes-home <path>]  — wire the local CELLO daemon into a Hermes Agent installation.\n" +
-        "  Scaffolds the CELLO platform-adapter plugin into the Hermes home (default ~/.hermes), binds CELLO_AGENT_NAME in its .env,\n" +
-        "  and registers via 'hermes plugins enable cello' + 'hermes mcp add cello'. Idempotent — re-run to upgrade.\n" +
-        "  After installing, restart the gateway: hermes gateway restart",
-};
+    "Usage: cello <command> [args]\n" +
+    "\n" +
+    renderCommandsTable() +
+    "\n" +
+    "\n" +
+    "Run 'cello <command> --help' for details on any command.\n" +
+    // Scoped deliberately: only the parity commands (jsonOut) honor the full §3 contract — JSON on
+    // stdout, structured error on stderr. The older commands (login, register, …) still print human
+    // text, and their failures go to stdout. Claiming the contract for EVERY command would be a
+    // promise the binary does not keep, made to precisely the reader who would script against it.
+    "The session and agent commands (agents, use-agent, initiate, send, receive, close, …) print JSON\n" +
+    "and exit non-zero on failure, so any bash-capable agent can drive CELLO with no MCP dependency.";
+/** Per-command help — the registry entry's own text, verbatim. */
 export function helpForCommand(command) {
-    return COMMAND_HELP[command] ?? USAGE;
+    return findCommand(command)?.help ?? USAGE;
 }
-/** Flags each command recognizes. `--limit` consumes the following value. */
-const COMMAND_FLAGS = {
-    sessions: new Set(["--open", "--closed", "--failed", "--all", "--limit"]),
-    contact: new Set(["--agent"]),
-    moniker: new Set(["--agent"]),
-    install: new Set(["--agent", "--hermes-home"]),
-};
 /**
  * F2: validate a subcommand's arguments BEFORE dispatch.
  *  - --help / -h ANYWHERE → help. This is a dedicated pre-scan so help wins even when it
- *    follows an unknown flag or sits where --limit would consume its value — asking for
+ *    follows an unknown flag or sits where a value-consuming flag would swallow it — asking for
  *    help must never be masked by another argument error.
  *  - any other dash-prefixed token the command does not recognize → unknown_flag
  *    (never silently coerced into a positional).
+ *  - after a POSIX `--` terminator, everything is a positional VALUE, verbatim.
  */
-/**
- * Split a subcommand's argv into the `--agent <name>` flag and the remaining positionals.
- * Extracted (MONIKER-1 review Finding 1) because the old inline filter used
- * `i === agentIdx + 1` unguarded: with --agent ABSENT, agentIdx is -1 and the predicate
- * silently dropped positional index 0 — `cello moniker set Bob` / `cello contact list`
- * printed usage instead of dispatching. The flag's value is excluded ONLY when the flag exists.
- */
-export function splitAgentFlag(args) {
-    const agentIdx = args.indexOf("--agent");
-    const agent = agentIdx !== -1 ? args[agentIdx + 1] : undefined;
-    const positional = args.filter((a, i) => !(a === "--agent" || (agentIdx !== -1 && i === agentIdx + 1)));
-    return { agent, positional };
-}
 export function checkArgs(command, args) {
     if (args.some((a) => a === "--help" || a === "-h"))
         return { kind: "help" };
-    const known = COMMAND_FLAGS[command] ?? new Set();
+    const known = flagsFor(command);
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
+        if (arg === "--")
+            break; // POSIX end-of-flags — everything after is a positional value
         if (arg.startsWith("-")) {
-            if (!known.has(arg))
+            const spec = known.get(arg);
+            if (!spec)
                 return { kind: "unknown_flag", flag: arg };
-            if (arg === "--limit")
-                i++; // consumes its value
+            if (spec.consumesValue)
+                i++; // its value is not itself a flag
         }
     }
     return { kind: "ok" };
 }
+/** The registry, re-exported for callers that want to enumerate commands (e.g. the dispatcher). */
+export { COMMANDS };
 //# sourceMappingURL=cli-args.js.map

package/dist/cli-args.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEnG,gGAAgG;AAChG,6EAA6E;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;AAI3E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAChB,mFAAmF;IACnF,IAAI;IACJ,mHAAmH;IACnH,uGAAuG;IACvG,IAAI;IACJ,iCAAiC;IACjC,IAAI;IACJ,mBAAmB,EAAE;IACrB,IAAI;IACJ,IAAI;IACJ,4DAA4D;IAC5D,+FAA+F;IAC/F,gGAAgG;IAChG,4FAA4F;IAC5F,8FAA8F;IAC9F,oGAAoG;IACpG,iGAAiG,CAAC;AAEpG,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,KAAK,CAAC;AAC7C,CAAC;AAOD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAc;IACvD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5E,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,IAAI;YAAE,MAAM,CAAC,8DAA8D;QACvF,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;YACtD,IAAI,IAAI,CAAC,aAAa;gBAAE,CAAC,EAAE,CAAC,CAAC,iCAAiC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,mGAAmG;AACnG,OAAO,EAAE,QAAQ,EAAE,CAAC"}