@mono-agent/agent-app 0.11.2 → 0.11.4

package/dist/cli-commands.js

@@ -0,0 +1,306 @@
+#!/usr/bin/env node
+// Internal command implementation; `cli.ts` remains the stable public/bin facade.
+import { basename, resolve } from "node:path";
+import process from "node:process";
+import { runAuditRuns } from "./audit-runs.js";
+import { runBackfill } from "./backfill.js";
+import { MANAGED_BACKGROUND_WORKER_ENV, sanitizeManagedBackgroundWorkerEnvironment, } from "./background-runtime.js";
+import { isBackgroundOperationalEnvName } from "./background-environment.js";
+import { readCliDotenvFile } from "./first-run-readiness.js";
+import { loadCliEnvFile, parseCliArgs } from "./cli-args.js";
+export { loadCliEnvFile, parseCliArgs } from "./cli-args.js";
+import { monoAgentVersion, renderHelp } from "./cli-help.js";
+export { monoAgentVersion, renderHelp } from "./cli-help.js";
+import { runInstallSkill } from "./cli-install-skill-command.js";
+import { runConfig, runPresets, runValidate } from "./cli-validate-config-command.js";
+export { renderConfigView, renderPresetList, renderPresetShow, } from "./cli-validate-config-command.js";
+import { runAuth, runInit } from "./cli-init-command.js";
+export { identityRoleDisplayLine, initChangeDisplayRows, readApiKeyFromStdin, resolvePiAuthPathForLogin, runProviderSetupBeforeInit, secretChecklistDisplayRows, shouldRunInitWizard, } from "./cli-init-command.js";
+import { runBackgroundCommand, runLaunchdLogMaintenanceCommand, runStart, } from "./cli-background-command.js";
+export { describeChannelStatus, ensureStartable, printAppStatus, waitForShutdownSignal, } from "./cli-background-command.js";
+import { runMetrics } from "./metrics.js";
+import { INTERNAL_LAUNCHD_LOG_MAINTENANCE_COMMAND, MANAGED_LAUNCHD_LOG_MAINTENANCE_ENV, } from "./launchd.js";
+import { runSandboxCommand } from "./cli-sandbox-command.js";
+export { runSandboxCommand } from "./cli-sandbox-command.js";
+import * as ui from "./ui.js";
+function resolveValidateContext(args, invocationCwd) {
+    const cwd = resolve(invocationCwd, args.consumerPath ?? ".");
+    return {
+        cwd,
+        configPath: resolve(cwd, args.configPath ?? "mono-agent.config.json"),
+        envFilePath: resolve(cwd, args.envFile ?? ".env"),
+        allowFilesystemWrites: args.consumerPath === undefined,
+    };
+}
+export async function runCli(argv) {
+    let args;
+    try {
+        args = parseCliArgs(argv);
+    }
+    catch (error) {
+        if (argv[0] === "memory" && argv.includes("adopt-replay")) {
+            const { writeReplayAdoptionCliFailure } = await import("./memory-command.js");
+            writeReplayAdoptionCliFailure(argv.includes("--json"), "replay_adoption_usage");
+            return 2;
+        }
+        if (argv[0] === "memory" && argv.includes("forget")) {
+            const { writeMemoryForgetFailure } = await import("./memory-command.js");
+            const operationIndex = argv.indexOf("forget") + 1;
+            writeMemoryForgetFailure(argv.includes("--json"), argv[operationIndex] ?? "unknown", "forget_usage");
+            return 2;
+        }
+        process.stderr.write(ui.errorLine(error instanceof Error ? error.message : String(error)));
+        process.stdout.write(`\n${renderHelp()}`);
+        return 2;
+    }
+    const managedLaunchdLogMaintenance = args.command === INTERNAL_LAUNCHD_LOG_MAINTENANCE_COMMAND
+        && process.env[MANAGED_LAUNCHD_LOG_MAINTENANCE_ENV] === "1";
+    if (args.command === INTERNAL_LAUNCHD_LOG_MAINTENANCE_COMMAND) {
+        if (!managedLaunchdLogMaintenance) {
+            process.stderr.write(ui.errorLine("The launchd log maintenance command is reserved for its managed LaunchAgent."));
+            return 2;
+        }
+        sanitizeManagedLaunchdLogMaintenanceEnvironment(process.env);
+        return await runLaunchdLogMaintenanceCommand(args);
+    }
+    if (process.env[MANAGED_LAUNCHD_LOG_MAINTENANCE_ENV] === "1") {
+        process.stderr.write(ui.errorLine("The managed log-maintenance marker cannot authorize another CLI command."));
+        return 2;
+    }
+    writeCliDeprecationHints(argv[0], args);
+    // Only the internal launchd foreground shape may honor the managed-worker
+    // marker. A hostile/global launchctl environment must not sanitize unrelated
+    // commands such as `mono-agent validate` or `mono-agent status`.
+    const managedBackgroundWorker = args.command === "start" && args.foreground && process.env[MANAGED_BACKGROUND_WORKER_ENV] === "1";
+    if (args.expectedBackgroundSnapshot !== undefined && !managedBackgroundWorker) {
+        process.stderr.write(ui.errorLine("--expected-background-snapshot is reserved for the managed LaunchAgent worker."));
+        return 2;
+    }
+    if (managedBackgroundWorker && args.expectedBackgroundSnapshot === undefined) {
+        process.stderr.write(ui.errorLine("Managed LaunchAgent worker is missing its approved background snapshot."));
+        return 0;
+    }
+    if (managedBackgroundWorker) {
+        sanitizeManagedBackgroundWorkerEnvironment(process.env);
+    }
+    if (args.command === "memory"
+        && args.positionals[0] === "adopt-replay"
+        && hasUnsupportedReplayAdoptionFlag(argv)) {
+        const { writeReplayAdoptionCliFailure } = await import("./memory-command.js");
+        writeReplayAdoptionCliFailure(args.json === true, "replay_adoption_usage");
+        return 2;
+    }
+    if (args.command === "memory"
+        && args.positionals[0] === "forget"
+        && hasUnsupportedMemoryForgetFlag(argv)) {
+        const { writeMemoryForgetFailure } = await import("./memory-command.js");
+        writeMemoryForgetFailure(args.json === true, args.positionals[1] ?? "unknown", "forget_usage");
+        return 2;
+    }
+    const invocationCwd = process.cwd();
+    // Capture the exported shell before dotenv loading. Guided init retains only
+    // worker-operational values and reports shell/background credential drift;
+    // normal CLI commands still get the established shell-over-dotenv precedence.
+    const shellEnv = { ...process.env };
+    const envFilePath = args.command === "validate"
+        ? resolveValidateContext(args, invocationCwd).envFilePath
+        : resolve(invocationCwd, args.envFile ?? ".env");
+    let dotenvEnv = {};
+    if (args.command === "init") {
+        try {
+            dotenvEnv = await readCliDotenvFile(envFilePath);
+        }
+        catch (error) {
+            process.stderr.write(ui.errorLine(`Cannot read ${envFilePath}: ${error instanceof Error ? error.message : String(error)}`));
+            return 1;
+        }
+    }
+    loadCliEnvFile(envFilePath);
+    switch (args.command) {
+        case "help":
+            process.stdout.write(renderHelp());
+            return 0;
+        case "version":
+            process.stdout.write(`mono-agent ${monoAgentVersion()}\n`);
+            return 0;
+        case "init":
+            return await runInit(args, { shellEnv, dotenvEnv, dotenvPath: envFilePath });
+        case "validate":
+            return await runValidate(args);
+        case "auth":
+            return await runAuth(args);
+        case "sandbox":
+            return await runSandboxCommand(args);
+        case "config":
+            return await runConfig(args);
+        case "presets":
+            return runPresets(args);
+        case "start":
+            return await runStart(args, undefined, managedBackgroundWorker);
+        case "restart":
+        case "stop":
+        case "status":
+        case "logs":
+            return await runBackgroundCommand(args, args.command);
+        case "tui": {
+            // Lazy import: the operator console (and pi-tui) load only on demand.
+            const { runTui } = await import("./tui-command.js");
+            return await runTui({
+                configPath: resolve(process.cwd(), args.configPath ?? "mono-agent.config.json"),
+                cwd: process.cwd(),
+                env: process.env,
+                ...(args.envFile === undefined ? {} : { envFile: args.envFile }),
+                ...(args.agent === undefined ? {} : { agent: args.agent }),
+                ...(args.conversation === undefined ? {} : { conversationId: args.conversation }),
+                ...(args.local === true ? { local: true } : {}),
+                ...(args.configure === true ? { configure: true } : {}),
+            });
+        }
+        case "web": {
+            // Lazy import: the web server (and express/session-web) load only on demand.
+            const { runWeb } = await import("./web-command.js");
+            return await runWeb({
+                configPath: resolve(process.cwd(), args.configPath ?? "mono-agent.config.json"),
+                cwd: process.cwd(),
+                env: process.env,
+                ...(args.host === undefined ? {} : { host: args.host }),
+                ...(args.port === undefined ? {} : { port: args.port }),
+                ...(args.open === undefined ? {} : { open: args.open }),
+                ...(args.allowNonLoopback === undefined ? {} : { allowNonLoopback: args.allowNonLoopback }),
+                ...(args.showAuthUrl === undefined ? {} : { showAuthUrl: args.showAuthUrl }),
+                includeMemory: args.includeMemory,
+                ...(args.maxRunsPerInstance === undefined ? {} : { maxRunsPerInstance: args.maxRunsPerInstance }),
+            });
+        }
+        case "install-skill":
+            return await runInstallSkill(args);
+        case "continuations": {
+            const { runContinuationCommand } = await import("./continuation-command.js");
+            return await runContinuationCommand({
+                cwd: process.cwd(),
+                configPath: resolve(process.cwd(), args.configPath ?? "mono-agent.config.json"),
+                env: process.env,
+                positionals: args.positionals,
+                ...(args.json === true ? { json: true } : {}),
+                ...(args.limit === undefined ? {} : { limit: args.limit }),
+                ...(args.cursor === undefined ? {} : { cursor: args.cursor }),
+            });
+        }
+        case "backfill":
+            return await runBackfill({
+                ...(args.configPath === undefined ? {} : { configPath: args.configPath }),
+                ...(args.run === undefined ? {} : { run: args.run }),
+                all: args.all,
+                ...(args.since === undefined ? {} : { since: args.since }),
+                ...(args.until === undefined ? {} : { until: args.until }),
+                dryRun: args.dryRun,
+                includeMemory: args.includeMemory,
+            });
+        case "audit-runs":
+            return await runAuditRuns({
+                ...(args.configPath === undefined ? {} : { configPath: args.configPath }),
+                ...(args.artifactDir === undefined ? {} : { artifactDir: args.artifactDir }),
+                ...(args.consumerPath === undefined ? {} : { consumerPath: args.consumerPath }),
+                ...(args.staleAfterMs === undefined ? {} : { staleAfterMs: args.staleAfterMs }),
+                json: args.json === true,
+                includeMemory: args.includeMemory,
+            });
+        case "metrics":
+            return await runMetrics({
+                ...(args.configPath === undefined ? {} : { configPath: args.configPath }),
+                ...(args.artifactDir === undefined ? {} : { artifactDir: args.artifactDir }),
+                ...(args.since === undefined ? {} : { since: args.since }),
+                ...(args.until === undefined ? {} : { until: args.until }),
+                ...(args.groupBy === undefined ? {} : { groupBy: args.groupBy }),
+                json: args.json === true,
+                includeMemory: args.includeMemory,
+            });
+        case "memory": {
+            // Lazy import: the memory preview path pulls SQLite/backend clients only on demand.
+            const { runMemoryCommand } = await import("./memory-command.js");
+            return await runMemoryCommand({
+                cwd: process.cwd(),
+                env: process.env,
+                ...(args.configPath === undefined ? {} : { configPath: args.configPath }),
+                positionals: args.positionals,
+                json: args.json === true,
+                strict: args.strict === true,
+                ...(args.limit === undefined ? {} : { limit: args.limit }),
+                ...(args.idsFile === undefined ? {} : { idsFile: args.idsFile }),
+                ...(args.reason === undefined ? {} : { reason: args.reason }),
+                ...(args.planPath === undefined ? {} : { planPath: args.planPath }),
+                ...(args.backupPath === undefined ? {} : { backupPath: args.backupPath }),
+            });
+        }
+    }
+}
+function writeCliDeprecationHints(originalCommand, args) {
+    if (originalCommand === "recipes") {
+        process.stderr.write(ui.hint("`mono-agent recipes` is deprecated and will be removed in v2.0.0; use `mono-agent presets`."));
+    }
+    if (args.recipe !== undefined) {
+        process.stderr.write(ui.hint("`--recipe` is deprecated and will be removed in v2.0.0; use `--preset`."));
+    }
+    if (args.fallbackModels !== undefined) {
+        process.stderr.write(ui.hint("`--fallback-models` is deprecated and will be removed in v2.0.0; repeat `--fallback <ref>` instead."));
+    }
+}
+function sanitizeManagedLaunchdLogMaintenanceEnvironment(env) {
+    for (const name of Object.keys(env)) {
+        if (name !== MANAGED_LAUNCHD_LOG_MAINTENANCE_ENV && !isBackgroundOperationalEnvName(name)) {
+            delete env[name];
+        }
+    }
+    delete env[MANAGED_LAUNCHD_LOG_MAINTENANCE_ENV];
+}
+/**
+ * `adopt-replay` is a stopped-store trust boundary, so command-global flags
+ * must never be silently ignored. In particular, `--dry-run` cannot be parsed
+ * successfully and then execute the mutation. Validate the raw invocation so
+ * future parser flags also fail closed unless they are explicitly admitted.
+ */
+function hasUnsupportedReplayAdoptionFlag(argv) {
+    for (let index = 1; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token === "--config" || token === "--env-file") {
+            index += 1;
+            continue;
+        }
+        if (token === "--json")
+            continue;
+        if (token?.startsWith("-") === true)
+            return true;
+    }
+    return false;
+}
+/** Forget is mutating, so every accepted command-global flag is explicit. */
+function hasUnsupportedMemoryForgetFlag(argv) {
+    const valueFlags = new Set(["--config", "--env-file", "--ids-file", "--reason", "--plan", "--backup"]);
+    for (let index = 1; index < argv.length; index += 1) {
+        const token = argv[index];
+        if (token !== undefined && valueFlags.has(token)) {
+            index += 1;
+            continue;
+        }
+        if (token === "--json")
+            continue;
+        if (token?.startsWith("-") === true)
+            return true;
+    }
+    return false;
+}
+const cliEntryName = process.argv[1] === undefined ? undefined : basename(process.argv[1]);
+const isDirectCliInvocation = cliEntryName === "cli.js" || cliEntryName === "mono-agent";
+if (isDirectCliInvocation) {
+    runCli(process.argv.slice(2))
+        .then((code) => {
+        if (code !== 0) {
+            process.exitCode = code;
+        }
+    })
+        .catch((error) => {
+        process.stderr.write(`${ui.style.red("✗")} ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli-commands.js.map

package/dist/cli-commands.js.map

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

package/dist/cli-help.d.ts

@@ -0,0 +1,11 @@
+/** Build the colorized help screen (plain text when color is disabled). */
+export declare function renderHelp(): string;
+/**
+ * The published CLI version, read from this package's own package.json at
+ * runtime. `../package.json` resolves the same from both `src/cli.ts` (tests) and
+ * the built `dist/cli.js` (one level below the package root in both layouts), and
+ * npm always ships package.json in the tarball. Best-effort: a read failure yields
+ * "unknown" rather than crashing `--version`.
+ */
+export declare function monoAgentVersion(): string;
+//# sourceMappingURL=cli-help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAkPA,2EAA2E;AAC3E,wBAAgB,UAAU,IAAI,MAAM,CAgBnC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAOzC"}

package/dist/cli-help.js

@@ -0,0 +1,262 @@
+import { createRequire } from "node:module";
+import { EFFORT_LEVELS } from "@mono-agent/config";
+import { readinessProbeTimeoutDescription } from "./readiness-probe.js";
+import * as ui from "./ui.js";
+const HELP_COMMANDS = [
+    {
+        signature: "mono-agent init [--preset <id>] [--with <csv>] [--yes] [--auth] [--dry-run]\n" +
+            "                [--name <display-name>] [--model <ref>] [--effort <level>]\n" +
+            "                [--fallback <ref> [--fallback-effort <provider-default|level>]]...\n" +
+            "                [--fallback-models <csv>] [--route-safety uniform|per-route-native]\n" +
+            "                [--codex-auth browser|device] [--memory lite|journal|bujo]",
+        lines: [
+            "Fast scaffold-only path: flags or non-TTY input; without explicit --auth,",
+            "it makes no provider call and never claims readiness. Bare init on a TTY runs",
+            "a real no-tool model call per selected route before committing the scaffold,",
+            `with timeouts of ${readinessProbeTimeoutDescription()}.`,
+            "--preset seeds a blueprint; --with adds channels.",
+            `Effort levels: ${EFFORT_LEVELS.join(", ")}; an omitted fallback effort uses that provider's default.`,
+            "--fallback-models is deprecated and will be removed in v2.0.0; repeat --fallback for new scripts.",
+            "Reasoning-capable pi:* maps ultra to LOW; Pi without reasoning uses OFF; direct codex:* forwards ultra unchanged.",
+            "Mono-agent rejects ultra on its Claude SDK route because the pinned SDK public contract ends at max (the SDK JavaScript itself forwards the value).",
+            "The Claude CLI route passes --effort ultra, but both tested Claude Code binaries (SDK-bundled 2.1.206 and local 2.1.210) warn that it is unknown, ignore it, and use default effort.",
+            "Direct OpenCode rejects explicit effort. Ranking above max only prevents keyword downgrade.",
+            "--auth runs supported provider auth/preflight before writing; --codex-auth device supports headless hosts.",
+            "--dry-run previews only. Existing scaffold/config files are not overwritten;",
+            "guided secret setup may securely update .env and .gitignore after explicit review.",
+        ],
+    },
+    {
+        signature: "mono-agent setup",
+        lines: ["Alias of `init`."],
+    },
+    {
+        signature: "mono-agent presets list | show <id>",
+        lines: [
+            "List the built-in setup presets, or show one's generated config,",
+            ".env.example, and follow-up checklist.",
+        ],
+    },
+    {
+        signature: "mono-agent validate [--preset <id>] [--consumer <path>] [--config <path>] [--env-file <path>] [--json]",
+        lines: [
+            "Load every config section and report what would run, wait, or fail.",
+            "--consumer validates another agent folder read-only, including its .env.",
+            "With --preset, also report whether the preset's capabilities are live.",
+            "`mono-agent doctor` is an alias for this command.",
+        ],
+    },
+    {
+        signature: "mono-agent auth login <provider|codex> [--pi-auth-path <path>] [--api-key-stdin]\n" +
+            "                       [--codex-auth browser|device] [--config <path>]",
+        lines: [
+            "Run a supported bundled Pi provider login, or direct Codex browser/device login.",
+            "Pi credentials are promoted with owner-only no-clobber checks.",
+            "API-key providers prompt securely on a TTY; --api-key-stdin explicitly reads a redirected secret.",
+            "Path precedence: --pi-auth-path, MONO_AGENT_PI_AUTH_PATH, providers.piAuthPath, then Pi's default.",
+            "Supported Pi targets: anthropic, github-copilot, openai-codex, and opencode-go.",
+        ],
+    },
+    {
+        signature: "mono-agent sandbox status | setup | check",
+        lines: [
+            "Inspect, install, or functionally prove the pinned SRT sandbox runtime.",
+            "Managed setup is macOS-only and installs into the user's cache; it never changes PATH,",
+            "global npm packages, system packages, or another user's files.",
+        ],
+    },
+    {
+        signature: "mono-agent config [--config <path>] [--env-file <path>]",
+        lines: [
+            "Print the resolved config field-by-field, tagging each value with where",
+            "it came from (env / json / default), plus the channel summary. Read-only.",
+        ],
+    },
+    {
+        signature: "mono-agent start [--config <path>] [--env-file <path>] [--foreground|-f]",
+        lines: [
+            "Start the agent as a background macOS service (launchd), print its",
+            "instance info, and return. Re-running restarts the running instance.",
+            "Refuses to start without a valid mono-agent.config.json in the folder.",
+            "Use --foreground (-f) to run in the blocking foreground instead.",
+        ],
+    },
+    {
+        signature: "mono-agent restart [--config <path>] [--force]",
+        lines: [
+            "Restart the background instance for this config (starts it if stopped).",
+            "--force clears persisted pi sessions and active conversation history so",
+            "the agent starts fresh. Durable memory and run artifacts are untouched.",
+        ],
+    },
+    {
+        signature: "mono-agent stop [--config <path>]",
+        lines: ["Stop the background instance and remove its LaunchAgent."],
+    },
+    {
+        signature: "mono-agent status [--config <path>]",
+        lines: ["Show this config's instance plus any other running instances."],
+    },
+    {
+        signature: "mono-agent logs [--config <path>] [--follow|-f] [--lines <n>]",
+        lines: ["Print (and optionally follow) the background instance's log files."],
+    },
+    {
+        signature: "mono-agent tui [--agent <label|sourceId>] [--conversation <id>]\n" +
+            "               [--configure | --local]",
+        lines: [
+            "Open the operator console from any directory: live chat with structured",
+            "thinking/tool/telemetry insight, recorded-run replay, and config view.",
+            "Discovers running agents via the trace-source registry; one running",
+            "agent connects directly, several open a picker.",
+            "--configure opens the guided configuration chat on the authoritative",
+            "background agent; --local is an ordinary in-process chat only.",
+        ],
+    },
+    {
+        signature: "mono-agent web [--host <addr>] [--port <n>] [--no-open] [--allow-non-loopback] [--show-auth-url] [--include-memory] [--max-runs <n>] [--config <path>] [--env-file <path>]",
+        lines: [
+            "Serve the read-only Session Recorder web PWA from any directory: a live",
+            "flight-recorder over every agent's runs (prompt, reasoning, tools, cost).",
+            "Discovers running agents via the trace-source registry — the same",
+            "mechanism as `tui` — and streams new/updated runs in real time.",
+            "--include-memory also shows memory-maintenance runs. --max-runs (default",
+            "200) bounds the in-memory working set; the UI still pages the full",
+            "on-disk history via \"Load older\".",
+            "Non-loopback service use requires MONO_AGENT_WEB_AUTH_TOKEN; an",
+            "interactive run may generate one. --show-auth-url reveals a configured",
+            "token only to an interactive terminal. Authenticated URLs are not",
+            "auto-opened through process arguments.",
+        ],
+    },
+    {
+        signature: "mono-agent install-skill [--target claude|codex|both] [--force]\n" +
+            "                         --project (--check|--update)",
+        lines: [
+            "Copy the bundled mono-agent-composer skill into ~/.claude/skills and",
+            "~/.agents/skills (default: both). Refuses to overwrite without --force.",
+            "Project mode checks or safely updates the two managed skills generated",
+            "by init; modified copies are never overwritten and updates retain backups.",
+        ],
+    },
+    {
+        signature: "mono-agent backfill (--run <id> | --all) [--since <iso>] [--until <iso>]\n" +
+            "                    [--include-memory] [--dry-run] [--config <path>] [--env-file <path>]",
+        lines: [
+            "Export already-recorded agent-run artifacts to the configured Phoenix exporter",
+            "with their historical timestamps. Trace ids are deterministic per run, so",
+            "re-running overwrites rather than duplicating. --dry-run maps and",
+            "serializes without sending. --include-memory adds memory-run artifacts",
+            "for --all; explicit --run can target a memory run directly.",
+        ],
+    },
+    {
+        signature: "mono-agent audit-runs [--artifact-dir <path> | --consumer <path>]\n" +
+            "                      [--include-memory] [--config <path>] [--env-file <path>] [--stale-after-ms <n>] [--json]",
+        lines: [
+            "Read local agent-run summary artifacts without rewriting them. Reports parse",
+            "failures, status and failure-kind histograms, stale running summaries,",
+            "and per-failure-kind rates. --include-memory includes memory-run artifacts.",
+        ],
+    },
+    {
+        signature: "mono-agent metrics [--artifacts <path>] [--since <iso>] [--until <iso>]\n" +
+            "                   [--include-memory] [--by model|channel|failureKind] [--json] [--config <path>] [--env-file <path>]",
+        lines: [
+            "Aggregate local agent-run summaries into status rates, failure-kind rates,",
+            "duration percentiles, and total/per-run cost. Read-only and offline.",
+            "--include-memory includes memory-run artifacts.",
+        ],
+    },
+    {
+        signature: "mono-agent memory [stats|today|show <date>|search <query>|top|audit|inspect [id]|retry [id]|resolve <id> <reason>|rebuild|rollback|adopt-replay]\n" +
+            "mono-agent memory forget prepare --ids-file <file> --reason <slug> --plan <file>\n" +
+            "mono-agent memory forget apply --plan <file> | forget restore --backup <dir>\n" +
+            "                  [--limit <n>] [--strict] [--json] [--config <path>] [--env-file <path>]",
+        lines: [
+            "Preview the configured memory store from an agent folder. Reads the",
+            "memory block from mono-agent.config.json, not the standalone memory-bujo",
+            "env workflow. Human-first output by default; audit --strict --json is a",
+            "metadata-only health gate. Intake inspect/retry/resolve never print payload content.",
+            "adopt-replay is an explicit stopped-agent, SSH-safe BuJo trust-on-first-use",
+            "operation. It returns metadata only and requires rebuild before restart.",
+            "forget uses an explicit, content-free plan plus a full owner-private backup;",
+            "apply and restore require the configured agent to be stopped.",
+        ],
+    },
+    {
+        signature: "mono-agent continuations [list [--limit <n>] [--cursor <opaque>]|health|retry <id>|cancel <id>|resolve <id> delivered|not-delivered|dead-lettered [delivery-id]] [--json]",
+        lines: [
+            "Inspect and operate the authenticated durable-continuation service.",
+            "Ambiguous delivery cannot be retried until it is explicitly resolved;",
+            "no command accepts or changes a channel destination.",
+        ],
+    },
+];
+const HELP_NOTES = `Background mode runs the agent under launchd, keeping it alive across logins
+(auto-restarting only on crash) until you run stop. Secrets are read from the
+.env file in the working directory, the same as foreground mode. The background
+commands require macOS; elsewhere use start --foreground.
+
+Init model references look like pi:<provider>:<model>, claude:claude-sonnet-4-6,
+codex:gpt-5.6-terra, codex:gpt-5.6-sol, or opencode:<provider>:<model>. The init wizard
+selects the live provider-declared default when available and falls back offline to
+codex:gpt-5.6-terra. Direct and Pi OpenAI-Codex Sol choices remain selectable.
+Direct GPT-5.6 routes require Codex CLI 0.144.0 or newer. Guided Pi authentication
+covers Anthropic, GitHub Copilot, OpenAI Codex, and OpenCode-Go. Claude remains selectable;
+direct opencode:<provider>:<model> refs are for
+hand-authored runtime backend config and are rejected by guided selection/readiness.
+
+Mixed fallback chains are allowed. runtime.routeSafety=uniform (the default)
+requires one compatibility-preserving contract across every route;
+per-route-native makes each route's exact safety boundary explicit (Pi SRT,
+Claude provider-owned permissions, Codex native sandbox, or OpenCode native).
+
+Native mono-agent srt policy is enforced by Pi-owned tools. In uniform mode,
+Claude, direct Codex, and direct OpenCode cannot silently weaken that policy.
+In per-route-native mode, validate reports each provider-owned safety contract
+and rejects capabilities that the selected route cannot represent.
+Direct OpenCode's bridge cannot enforce an explicit runtime.effort; omit effort and
+configure runtime.permissionMode deliberately for hand-authored direct routes.
+It is per-run/non-resumable and rejects MCP (including auto-provisioned memory
+or send tools), positive maxTurns, index skill disclosure, structured output,
+live input, fast mode, and native subagents instead of silently dropping them.
+
+A .env file in the current folder is loaded automatically when present;
+already-exported shell variables take precedence.
+`;
+/** Build the colorized help screen (plain text when color is disabled). */
+export function renderHelp() {
+    let out = ui.banner("mono-agent", "config-first agent host") + "\n";
+    out += ui.heading("Usage");
+    for (const entry of HELP_COMMANDS) {
+        const [first, ...rest] = entry.signature.split("\n");
+        out += `  ${ui.style.bold(ui.style.cyan(first ?? ""))}\n`;
+        for (const cont of rest) {
+            out += `  ${ui.style.cyan(cont)}\n`;
+        }
+        for (const line of entry.lines) {
+            out += `      ${ui.style.dim(line)}\n`;
+        }
+        out += "\n";
+    }
+    out += ui.style.dim(HELP_NOTES);
+    return out;
+}
+/**
+ * The published CLI version, read from this package's own package.json at
+ * runtime. `../package.json` resolves the same from both `src/cli.ts` (tests) and
+ * the built `dist/cli.js` (one level below the package root in both layouts), and
+ * npm always ships package.json in the tarball. Best-effort: a read failure yields
+ * "unknown" rather than crashing `--version`.
+ */
+export function monoAgentVersion() {
+    try {
+        const pkg = createRequire(import.meta.url)("../package.json");
+        return typeof pkg.version === "string" && pkg.version.length > 0 ? pkg.version : "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+//# sourceMappingURL=cli-help.js.map

package/dist/cli-help.js.map

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