@ashlr/hub 2.2.0

package/dist/cli/help.js

@@ -0,0 +1,436 @@
+/**
+ * cli/help.ts — agent-facing docs surface (M31).
+ *
+ * `ashlr docs --agent [--json]` emits a compact, llms.txt-style cheat sheet of
+ * the agent-relevant commands: what each does, its safety class, the --json
+ * contract, and exit-code discipline. Generated from AGENT_COMMANDS so the
+ * docs can never drift from one source of truth.
+ *
+ * `claudeMdSnippet()` renders a ready-to-paste CLAUDE.md block teaching agents
+ * the CLI-first usage (consumed by `ashlr wire --claude-md`).
+ *
+ * Safety classes mirror CONTRACT-M31:
+ *   read       — read-only of local stores; always safe.
+ *   append     — append-only write under ~/.ashlr/ (genome hub).
+ *   proposal   — creates a PENDING inbox proposal; never applies anything.
+ *   human-gate — listed for awareness only; agents must NOT run it.
+ */
+import { makeColors, isTty, pad } from './ui.js';
+/**
+ * The agent-relevant command registry — the CLI-first contract. Every entry's
+ * --json output is stable (typed in src/core/types.ts) and ANSI-free.
+ * Exit codes everywhere: 0 success, 1 runtime error, 2 bad usage.
+ */
+export const AGENT_COMMANDS = [
+    {
+        usage: 'ashlr orient [--repo <path>] --json',
+        description: 'Session-start context: genome hits, health, backlog, pending proposals, attention. Run once when starting work.',
+        safety: 'read',
+        jsonShape: 'OrientResult',
+    },
+    {
+        usage: 'ashlr ask "<question>" [--json]',
+        description: 'Local RAG over the indexed portfolio; cites repo/file:line. Local models only unless --allow-cloud.',
+        safety: 'read',
+        jsonShape: 'AskResult',
+    },
+    {
+        usage: 'ashlr recall "<query>" [--json]',
+        description: 'Search shared genome memory for prior decisions/conventions/learnings.',
+        safety: 'read',
+        jsonShape: 'RecallHit[]',
+    },
+    {
+        usage: 'ashlr learn "<text>" [--title t] [--project p] [--tags a,b]',
+        description: 'Append a learning to shared memory (append-only, hub store under ~/.ashlr/).',
+        safety: 'append',
+        jsonShape: 'GenomeEntry (created)',
+    },
+    {
+        usage: 'ashlr backlog [--repo <path>] [--limit N] --json',
+        description: 'Top scored work items from the persisted portfolio backlog (read; refresh is a separate human step).',
+        safety: 'read',
+        jsonShape: 'Backlog',
+    },
+    {
+        usage: 'ashlr health [<repo>] --json',
+        description: 'Quality score for an enrolled repo (tests/docs/deps/security/debt) or the latest portfolio report.',
+        safety: 'read',
+        jsonShape: 'HealthScore | HealthReport',
+    },
+    {
+        usage: 'ashlr status',
+        description: 'Attention board: dirty/stale repos + ecosystem summary.',
+        safety: 'read',
+        jsonShape: '(human-oriented; use orient --json)',
+    },
+    {
+        usage: 'ashlr knowledge impact <target> [--json]',
+        description: 'References + dependents of a file/symbol within and across enrolled repos.',
+        safety: 'read',
+        jsonShape: 'ImpactResult',
+    },
+    {
+        usage: 'ashlr pulse [--window 1d|7d|30d] --json',
+        description: 'Token/cost/activity roll-up (sessions, tokens, est. cost, commits).',
+        safety: 'read',
+        jsonShape: 'ActivityRollup',
+    },
+    {
+        usage: 'ashlr inbox --json',
+        description: 'List proposals in the approval inbox. LISTING ONLY for agents — approve/reject is human-only.',
+        safety: 'read',
+        jsonShape: 'Proposal[]',
+    },
+    {
+        usage: 'ashlr inbox approve|reject <id>',
+        description: 'HUMAN-ONLY: the single gate through which every outward action passes. Agents must never run this.',
+        safety: 'human-gate',
+        jsonShape: 'ApplyResult',
+    },
+];
+/** Render the cheat sheet as plain text (llms.txt-style; no ANSI). */
+export function agentDocsText() {
+    const lines = [
+        '# ashlr — agent contract (CLI-first)',
+        '',
+        'ashlr is a local-first command center: portfolio memory (genome), local RAG,',
+        'work discovery (backlog), repo health, and a human-gated approval inbox.',
+        'Use the CLI below from any agent session. Every --json shape is stable and',
+        'ANSI-free; exit codes are 0 success / 1 error / 2 bad usage.',
+        '',
+        'Safety classes: read = always safe · append = append-only under ~/.ashlr/ ·',
+        'proposal = creates a PENDING inbox item (never applies) · human-gate = NEVER',
+        'run from an agent; the human approves via `ashlr inbox`.',
+        '',
+    ];
+    for (const c of AGENT_COMMANDS) {
+        lines.push(`## ${c.usage}`);
+        lines.push(`safety: ${c.safety} · json: ${c.jsonShape}`);
+        lines.push(c.description);
+        lines.push('');
+    }
+    lines.push('Equivalent MCP tools (when wired via `ashlr wire`): ashlr_orient,');
+    lines.push('ashlr_ask, ashlr_recall, ashlr_learn, ashlr_backlog, ashlr_health,');
+    lines.push('ashlr_status, ashlr_impact, ashlr_pulse, ashlr_inbox_list,');
+    lines.push('ashlr_inbox_propose. There is NO approve/apply tool by design.');
+    lines.push('');
+    return lines.join('\n');
+}
+/** Ready-to-paste CLAUDE.md block (for `ashlr wire --claude-md`). */
+export function claudeMdSnippet() {
+    return [
+        '## ashlr (portfolio command center)',
+        '',
+        'This machine runs ashlr — local-first portfolio memory, RAG, and work',
+        'discovery. Use it via Bash:',
+        '',
+        '- **Session start:** `ashlr orient --repo <repo> --json` — prior decisions,',
+        '  repo health, top backlog items, pending proposals. Read it before working.',
+        '- **Questions about any repo:** `ashlr ask "<question>" --json` (cites file:line).',
+        '- **Search prior learnings:** `ashlr recall "<query>" --json`.',
+        '- **Save a learning** (architecture decision, gotcha, convention):',
+        '  `ashlr learn "<text>" --project <name>` — append-only, safe.',
+        '- **Find work:** `ashlr backlog --repo <repo> --json`.',
+        '- **NEVER run** `ashlr inbox approve|reject` or `ashlr enroll` — those are',
+        '  human-only gates.',
+        '',
+    ].join('\n');
+}
+function printDocsHelp() {
+    const c = makeColors(isTty());
+    console.log('');
+    console.log(c.bold('  ashlr docs') + c.dim(' — generated documentation surfaces'));
+    console.log('');
+    console.log(`    ${c.cyan('ashlr docs --agent')}          ${c.dim('agent cheat sheet (llms.txt-style, plain text)')}`);
+    console.log(`    ${c.cyan('ashlr docs --agent --json')}   ${c.dim('the same registry as JSON')}`);
+    console.log(`    ${c.cyan('ashlr wire --claude-md')}      ${c.dim('CLAUDE.md snippet for agent configs')}`);
+    console.log('');
+}
+export async function cmdDocs(args) {
+    const json = args.includes('--json');
+    const agent = args.includes('--agent');
+    if (args.includes('--help') || args.includes('-h') || args[0] === 'help') {
+        printDocsHelp();
+        return 0;
+    }
+    if (!agent) {
+        printDocsHelp();
+        return 2;
+    }
+    if (json) {
+        process.stdout.write(JSON.stringify({ commands: AGENT_COMMANDS }, null, 2) + '\n');
+        return 0;
+    }
+    process.stdout.write(agentDocsText());
+    return 0;
+}
+/** Human-facing summary table for `ashlr docs` discoverability surfaces. */
+export function renderAgentTable() {
+    const c = makeColors(isTty());
+    const w = Math.max(...AGENT_COMMANDS.map((x) => x.usage.length));
+    return AGENT_COMMANDS
+        .map((x) => `    ${c.cyan(pad(x.usage, w))}  ${c.dim(`[${x.safety}]`)} ${x.description}`)
+        .join('\n');
+}
+const TOPIC_LABELS = {
+    core: 'Core — index, navigate, configure',
+    run: 'Run — local-first agent runs',
+    swarm: 'Swarm — specs + multi-agent fleets',
+    memory: 'Memory — shared genome',
+    knowledge: 'Knowledge — portfolio RAG + graph',
+    autonomy: 'Autonomy — enrollment, backlog, daemon, inbox, goals',
+    observability: 'Observability — cost, telemetry, audit',
+    integrations: 'Integrations — MCP, GitHub, Vercel, editors',
+    safety: 'Safety — sandboxes, invariants, activation',
+    web: 'Surfaces — TUI + web dashboard',
+    scaffold: 'Scaffold — new projects + shipping',
+};
+/** The full command table (the former inline cmdHelp list), topic-tagged. */
+export const HELP_ENTRIES = [
+    { cmd: 'index [--refresh]', desc: 'Build or refresh the desktop index; show counts by category.', topic: 'core' },
+    { cmd: 'go [query] [--open|--cd]', desc: 'Find a repo or item; open in editor (--open) or print path for cd (--cd).', topic: 'core' },
+    { cmd: 'status', desc: 'Attention board: dirty, off-sync, and stale repos; ecosystem summary.', topic: 'core' },
+    { cmd: 'ls [category]', desc: 'List all indexed items, optionally filtered by category.', topic: 'core' },
+    { cmd: 'open [query]', desc: 'Open the best match in your editor; no query opens an interactive picker.', topic: 'core' },
+    { cmd: 'tidy [--apply]', desc: 'Show (or apply) tidy moves for loose Desktop files.', topic: 'core' },
+    { cmd: 'config [get <k>|set <k> <v>]', desc: 'Read/write a config value. No args prints a summary.', topic: 'core' },
+    { cmd: 'config set <k> --json <v>', desc: 'Set a structured (array/object) config value as JSON.', topic: 'core' },
+    { cmd: 'config path', desc: 'Print the path to config.json.', topic: 'core' },
+    { cmd: 'doctor', desc: 'One-glance health check: config, phantom, providers, ecosystem.', topic: 'core' },
+    { cmd: 'init [--yes]', desc: 'Idempotent onboarding: ensure config, detect phantom + models, set editor.', topic: 'core' },
+    { cmd: 'update [--check] [--json]', desc: 'Safe self-update: git pull --ff-only + rebuild. --check reports only.', topic: 'core' },
+    { cmd: 'orient [--repo <r>] [--json]', desc: 'Session-start context: genome hits, health, backlog, pending proposals, attention (read-only).', topic: 'core' },
+    { cmd: 'docs --agent [--json]', desc: 'Agent cheat sheet: the CLI-first contract (commands, safety classes, JSON shapes).', topic: 'core' },
+    { cmd: 'completions zsh|bash', desc: 'Print a shell completion script to stdout.', topic: 'core' },
+    { cmd: 'plugins init|list|info|enable|disable', desc: 'Scaffold + manage plugins (~/.ashlr/plugins/) — default-off, integrity-pinned, audited (see docs/PLUGINS.md).', topic: 'core' },
+    { cmd: 'x <name> [args...]', desc: "Run an enabled plugin's command.", topic: 'core' },
+    { cmd: 'help [<topic>] [--all]', desc: 'Topic-grouped help; --all prints every command; --search <term> filters.', topic: 'core' },
+    { cmd: 'run "<goal>" [opts]', desc: 'Decompose goal into tasks; execute via local model (Ollama/LM Studio).', topic: 'run' },
+    { cmd: 'run show <id>', desc: 'Print a past run in detail.', topic: 'run' },
+    { cmd: 'runs [--json]', desc: 'List past runs (newest first).', topic: 'run' },
+    { cmd: 'models [--json]', desc: 'List local models (Ollama/LM Studio); marks the active one.', topic: 'run' },
+    { cmd: 'models pull <name> [--yes]', desc: 'Explicitly pull an Ollama model (large download; confirm first).', topic: 'run' },
+    { cmd: 'models start', desc: 'Best-effort start a locally-installed Ollama (never downloads).', topic: 'run' },
+    { cmd: 'spec new "<goal>" [--project]', desc: 'Author a versioned end-state spec artifact (local-first model).', topic: 'swarm' },
+    { cmd: 'spec list [--project <path>]', desc: 'List all spec artifacts, newest version per spec.', topic: 'swarm' },
+    { cmd: 'spec show <id>', desc: 'Print a spec artifact in full.', topic: 'swarm' },
+    { cmd: 'spec refine <id> "<note>"', desc: 'Produce a new version of a spec incorporating the note.', topic: 'swarm' },
+    { cmd: 'swarm "<goal>" [opts]', desc: 'Decompose goal into a contracts-first DAG; run a fleet of agents.', topic: 'swarm' },
+    { cmd: 'swarm <specId> [opts]', desc: 'Run a swarm against an existing spec artifact.', topic: 'swarm' },
+    { cmd: 'swarm show <id>', desc: 'Print a past swarm run in detail.', topic: 'swarm' },
+    { cmd: 'swarms [--json]', desc: 'List past swarm runs (newest first).', topic: 'swarm' },
+    { cmd: 'recall "<query>"', desc: 'Search shared genome memory; return top relevant entries with scores.', topic: 'memory' },
+    { cmd: 'learn "<text>" [opts]', desc: 'Append a note to shared genome memory (local-first, append-only).', topic: 'memory' },
+    { cmd: 'genome', desc: 'Genome status/health: entry count, projects covered, store size.', topic: 'memory' },
+    { cmd: 'knowledge build', desc: 'Index enrolled repos locally (read-only, secret-scrubbed) for portfolio RAG.', topic: 'knowledge' },
+    { cmd: 'ask "<question>"', desc: 'Local RAG across the indexed portfolio; cites repo/file:line. --allow-cloud opt-in.', topic: 'knowledge' },
+    { cmd: 'knowledge impact <target>', desc: 'Show references + dependents of a file/symbol within and across enrolled repos.', topic: 'knowledge' },
+    { cmd: 'knowledge graph', desc: 'Print the portfolio knowledge graph (repos/modules/deps + cross-repo findings).', topic: 'knowledge' },
+    { cmd: 'enroll list', desc: 'List enrolled repos + kill switch state.', topic: 'autonomy' },
+    { cmd: 'enroll add <repo>', desc: 'Enroll a repo for autonomous work.', topic: 'autonomy' },
+    { cmd: 'enroll remove <repo>', desc: 'Remove a repo from the enrollment registry.', topic: 'autonomy' },
+    { cmd: 'enroll kill on|off', desc: 'Toggle the global autonomous kill switch.', topic: 'autonomy' },
+    { cmd: 'backlog', desc: 'Scored work queue across enrolled repos (issues, TODOs, deps, docs, security).', topic: 'autonomy' },
+    { cmd: 'backlog refresh', desc: 'Re-scan all enrolled repos and rebuild the backlog.', topic: 'autonomy' },
+    { cmd: 'backlog --source <src>', desc: 'Filter backlog by source: issue|todo|test|dep|doc|security.', topic: 'autonomy' },
+    { cmd: 'backlog --repo <path>', desc: 'Filter backlog to a specific enrolled repo.', topic: 'autonomy' },
+    { cmd: 'backlog --limit <n>', desc: 'Show only the top N items.', topic: 'autonomy' },
+    { cmd: 'backlog --json', desc: 'Emit raw JSON backlog.', topic: 'autonomy' },
+    { cmd: 'inbox', desc: 'Approval inbox: list pending proposals (the outward-action gate).', topic: 'autonomy' },
+    { cmd: 'inbox show <id>', desc: 'Full detail of a proposal incl. diff (read-only).', topic: 'autonomy' },
+    { cmd: 'inbox approve <id>', desc: 'Confirm + apply an approved proposal (the ONLY outward path).', topic: 'autonomy' },
+    { cmd: 'inbox approve <id> --yes', desc: 'Approve without interactive prompt (non-TTY safe).', topic: 'autonomy' },
+    { cmd: 'inbox reject <id>', desc: 'Discard a pending proposal; applies nothing.', topic: 'autonomy' },
+    { cmd: 'inbox --json', desc: 'Emit raw JSON for inbox list / show / approve result.', topic: 'autonomy' },
+    { cmd: 'daemon start --once', desc: 'Autonomous operator: one tick — propose-only, sandboxed, enrolled repos.', topic: 'autonomy' },
+    { cmd: 'daemon start --once --dry-run', desc: 'Plan only: which backlog items WOULD be worked (no swarm/proposal).', topic: 'autonomy' },
+    { cmd: 'daemon stop', desc: 'Halt the daemon: set kill switch + clear running state.', topic: 'autonomy' },
+    { cmd: 'daemon status', desc: "Daemon roll-up: running?, today's spend vs cap, pending proposals.", topic: 'autonomy' },
+    { cmd: 'goals add <objective>', desc: 'Register a high-level OBJECTIVE (goal); decomposed into ordered milestones (local, no LLM by default).', topic: 'autonomy' },
+    { cmd: 'goals plan <id>', desc: 'Decompose a goal into ordered milestones + author/link each milestone spec (LOCAL-FIRST; --allow-cloud to use cloud).', topic: 'autonomy' },
+    { cmd: 'goals advance <id>', desc: 'Advance the next actionable milestone via a SANDBOXED, proposal-only swarm (ENROLLED repos only; emits a PENDING proposal).', topic: 'autonomy' },
+    { cmd: 'goals status [id]', desc: 'Read-only roll-up of goal/milestone progress + linked swarm/proposal state (mutates nothing).', topic: 'autonomy' },
+    { cmd: 'reflect [--since <Nd>]', desc: 'Score your OWN past runs/swarms locally; report effectiveness/cost deltas (read-only).', topic: 'autonomy' },
+    { cmd: 'reflect playbooks [--persist]', desc: 'Distill repeatable playbooks from past swarms (report-only; --persist writes them to the genome).', topic: 'autonomy' },
+    { cmd: 'reflect propose', desc: 'Emit routing/policy/prompt tuning suggestions as PENDING inbox proposals (never auto-applies).', topic: 'autonomy' },
+    { cmd: 'health', desc: 'Score every ENROLLED repo on quality (tests/docs/deps/security/debt/CI/conventions); ranked, read-only.', topic: 'autonomy' },
+    { cmd: 'health <repo>', desc: 'Per-repo health detail with the per-dimension breakdown + worst offenders (ENROLLED only).', topic: 'autonomy' },
+    { cmd: 'health propose', desc: 'Emit deterministic safe-fix advisories as PENDING inbox proposals (never auto-applies).', topic: 'autonomy' },
+    { cmd: 'digest', desc: 'Write an ORG-LEVEL portfolio digest (health, goals, costs, today) to ~/.ashlr/digests/ (LOCAL-FIRST; reads only).', topic: 'autonomy' },
+    { cmd: 'digest --notify', desc: 'Also deliver the digest via a configured Slack/Discord webhook (OPT-IN; no-op when unconfigured).', topic: 'autonomy' },
+    { cmd: 'pulse [--window 1d|7d|30d]', desc: 'Local observability dashboard: tokens, cost, sessions, commits.', topic: 'observability' },
+    { cmd: 'pulse --json', desc: 'Machine-readable ActivityRollup (+ additive .forecast field; Raycast Pulse view).', topic: 'observability' },
+    { cmd: 'pulse --project <name>', desc: 'Restrict pulse rollup to a single project.', topic: 'observability' },
+    { cmd: 'telemetry [status]', desc: 'M19: endpoint+PAT configured (bool), sink mode, local JSONL count, governance.', topic: 'observability' },
+    { cmd: 'telemetry test', desc: 'Emit a synthetic metadata-only test span; report sink+ok.', topic: 'observability' },
+    { cmd: 'audit [N] [--json] [--action <verb>] [--result <r>] [--since <when>]', desc: 'Tail the append-only audit trail (newest-first); filter by action/result/since (read-only).', topic: 'observability' },
+    { cmd: 'mcp', desc: 'Run the MCP aggregation gateway on stdio (point any agent here; includes 11 native ashlr_* tools).', topic: 'integrations' },
+    { cmd: 'mcp list', desc: 'List native ashlr tools + discovered MCP servers with per-server tool counts.', topic: 'integrations' },
+    { cmd: 'mcp doctor', desc: 'Per-server MCP health: does it start? how many tools?', topic: 'integrations' },
+    { cmd: 'mcp install <claude|ashlrcode>', desc: 'Add the ashlr gateway to a target mcpServers config (backs up first).', topic: 'integrations' },
+    { cmd: 'gh <pr|issue|ci>', desc: 'Read GitHub open PRs, issues, or CI status for the current repo (read-only).', topic: 'integrations' },
+    { cmd: 'gh pr create', desc: 'Create a PR via gh CLI — explicit + confirm-gated (the only gh mutation).', topic: 'integrations' },
+    { cmd: 'vercel <ls|logs>', desc: 'Read recent Vercel deployments or latest build logs (read-only).', topic: 'integrations' },
+    { cmd: 'wire [claude|codex|cursor|all]', desc: 'Wire ashlr MCP gateway into editor config(s); defaults to detected editors.', topic: 'integrations' },
+    { cmd: 'wire --claude-md', desc: 'Print a CLAUDE.md snippet teaching agents the CLI-first ashlr usage (read-only).', topic: 'integrations' },
+    { cmd: 'notify test', desc: 'Send a test ping to the configured webhook(s); no-op if none are set.', topic: 'integrations' },
+    { cmd: 'sandbox list', desc: 'List active git-worktree sandboxes (M21 safety foundation).', topic: 'safety' },
+    { cmd: 'sandbox diff <id>', desc: 'Show diff of a sandbox vs its base HEAD.', topic: 'safety' },
+    { cmd: 'sandbox cleanup <id>', desc: 'Remove a sandbox worktree and scratch branch.', topic: 'safety' },
+    { cmd: 'sandbox gc', desc: 'Reclaim STALE orphan sandboxes (crash leftovers); H5 explicit human repair surface for the orphan sweep.', topic: 'safety' },
+    { cmd: 'seams', desc: 'Cloud-ready seam diagnostic: every v2 store, active=local, cloud=gated (read-only).', topic: 'safety' },
+    { cmd: 'seams status', desc: 'Same as `seams`: list seams + active impl; proves local-first + cloud gated on Mason.', topic: 'safety' },
+    { cmd: 'verify-safety', desc: 'Read-only self-check of the hard safety invariants (enrollment/kill-switch/daemon/scrub/cloud-gate); mutates nothing.', topic: 'safety' },
+    { cmd: 'preflight [--json]', desc: 'Read-only first-activation readiness check: ready=true|false + blockers/warnings (model/enrollment/kill/daemon/writeable/sandbox/git/phantom); mutates nothing.', topic: 'safety' },
+    { cmd: 'onboard', desc: 'Guided first safe activation: preflight → enroll ONE repo → dry-run PLAN → point at `ashlr inbox`. TTY-aware; --yes/non-TTY prints steps. NEVER auto-applies.', topic: 'safety' },
+    { cmd: 'onboard --rollback <repo>', desc: 'One-command undo of a first activation: unenroll + sweep orphan sandboxes + optional --kill. Inward cleanup only; H6-audited.', topic: 'safety' },
+    { cmd: 'demo [--no-cleanup] [--json]', desc: 'Watch the FULL autonomous chain run on a DISPOSABLE tmp repo (isolated tmp ~/.ashlr; proposal-only; auto-cleans). NEVER touches your portfolio or applies anything.', topic: 'safety' },
+    { cmd: 'tui [--once]', desc: 'Interactive terminal dashboard (alias: dash). --once renders one frame and exits.', topic: 'web' },
+    { cmd: 'serve [--port N]', desc: 'Start local web dashboard + JSON API on 127.0.0.1 (default port 7777).', topic: 'web' },
+    { cmd: 'serve --open', desc: 'Start dashboard and open browser automatically.', topic: 'web' },
+    { cmd: 'serve --allow-dispatch', desc: 'Enable guarded POST /api/run + web inbox approve/reject (prints session token).', topic: 'web' },
+    { cmd: 'new <name> [opts]', desc: 'Scaffold a project from a template (next-app, node-cli, mcp-server, minimal).', topic: 'scaffold' },
+    { cmd: 'ship [path] [opts]', desc: 'Pre-ship gate (lint/test/build) + optional confirm-gated deploy.', topic: 'scaffold' },
+];
+/** Per-topic example blocks (relocated from the former inline cmdHelp). */
+const TOPIC_EXAMPLES = {
+    run: [
+        'ashlr run "list all open GitHub issues in this repo"',
+        'ashlr run "summarize recent commits" --budget 8000 --max-steps 5',
+        'ashlr run "audit TODOs" --no-memory          # skip genome injection',
+        'ashlr run show <id>                          # inspect a past run',
+        'ashlr run "x" --estimate                     # predict cost before running',
+    ],
+    swarm: [
+        'ashlr spec new "build a REST API with auth and tests"',
+        'ashlr swarm "build a REST API with auth" --dry-run   # plan only',
+        'ashlr swarm spec-abc123 --budget 40000 --parallel 3',
+        'ashlr swarm "refactor auth module" --background      # detached',
+    ],
+    memory: [
+        'ashlr recall "how does the orchestrator work"',
+        'ashlr learn "prefer bge-m3 for embeddings" --tags embeddings,ollama',
+        'ashlr learn "ashlr-hub uses NodeNext ESM" --project ashlr-hub',
+    ],
+    scaffold: [
+        'ashlr new my-app --template next-app',
+        'ashlr new my-tool --template node-cli --category dev-tools',
+        'ashlr ship --deploy vercel --confirm                 # gate + REAL deploy',
+    ],
+    autonomy: [
+        'ashlr enroll add ~/code/my-repo && ashlr backlog refresh',
+        'ashlr daemon start --once --dry-run                  # plan only',
+        'ashlr inbox && ashlr inbox approve <id>',
+    ],
+};
+/** Flag reference lines printed with `help run` / `help swarm` / `help --all`. */
+const FLAG_LINES = {
+    run: ['--budget N  --max-steps N  --parallel N  --engine builtin|ashlrcode|aw  --allow-cloud  --no-tools  --no-memory  --resume <id>  --estimate  --json  --over-budget'],
+    swarm: ['--budget N  --parallel N (default 3, max 8)  --background  --resume <id>  --dry-run  --estimate  --allow-cloud  --project <path>  --over-budget'],
+};
+const TOPICS = [
+    'core', 'run', 'swarm', 'memory', 'knowledge', 'autonomy',
+    'observability', 'integrations', 'safety', 'web', 'scaffold',
+];
+function renderEntries(entries) {
+    const c = makeColors(isTty());
+    const w = Math.max(...entries.map((e) => e.cmd.length));
+    return entries.map((e) => `    ${c.cyan(pad(e.cmd, w))}  ${e.desc}`).join('\n');
+}
+function renderTopic(topic) {
+    const c = makeColors(isTty());
+    const entries = HELP_ENTRIES.filter((e) => e.topic === topic);
+    console.log('');
+    console.log('  ' + c.bold(TOPIC_LABELS[topic]));
+    console.log('');
+    console.log(renderEntries(entries));
+    const flags = FLAG_LINES[topic];
+    if (flags) {
+        console.log('');
+        for (const f of flags)
+            console.log('  ' + c.bold('flags:') + ' ' + c.dim(f));
+    }
+    const examples = TOPIC_EXAMPLES[topic];
+    if (examples) {
+        console.log('');
+        console.log('  ' + c.bold('Examples:'));
+        for (const ex of examples)
+            console.log(`    ${c.cyan(ex)}`);
+    }
+    console.log('');
+}
+function renderSummary() {
+    const c = makeColors(isTty());
+    console.log('');
+    console.log(c.bold('  ashlr') + c.dim(' — local-first command center for agentic engineers'));
+    console.log('');
+    for (const topic of TOPICS) {
+        const entries = HELP_ENTRIES.filter((e) => e.topic === topic);
+        const headliners = entries.slice(0, 3).map((e) => e.cmd.split(' ')[0]);
+        const unique = [...new Set(headliners)].join(', ');
+        console.log(`    ${c.cyan(pad(topic, 14))}  ${TOPIC_LABELS[topic]} ${c.dim(`(${unique}, …)`)}`);
+    }
+    console.log('');
+    console.log('  ' + c.dim('ashlr help <topic>') + '      full table for one topic');
+    console.log('  ' + c.dim('ashlr help --search <t>') + ' find a command by keyword');
+    console.log('  ' + c.dim('ashlr help --all') + '        every command (the legacy full table)');
+    console.log('  ' + c.dim('ashlr docs --agent') + '      the agent contract cheat sheet');
+    console.log('');
+}
+function renderAll() {
+    const c = makeColors(isTty());
+    console.log('');
+    console.log(c.bold('  ashlr') + c.dim(' — every command'));
+    for (const topic of TOPICS) {
+        console.log('');
+        console.log('  ' + c.bold(TOPIC_LABELS[topic]));
+        console.log(renderEntries(HELP_ENTRIES.filter((e) => e.topic === topic)));
+    }
+    console.log('');
+    for (const [t, lines] of Object.entries(FLAG_LINES)) {
+        for (const f of lines ?? [])
+            console.log('  ' + c.bold(`${t} flags:`) + ' ' + c.dim(f));
+    }
+    console.log('');
+}
+/** `ashlr help [<topic>] [--search <term>] [--all]` — exit 0 always (help never fails the shell). */
+export async function cmdHelp(args) {
+    const c = makeColors(isTty());
+    if (args.includes('--all')) {
+        renderAll();
+        return 0;
+    }
+    const searchIdx = args.indexOf('--search');
+    if (searchIdx !== -1) {
+        const term = (args[searchIdx + 1] ?? '').toLowerCase();
+        if (!term) {
+            console.log(c.dim('usage: ashlr help --search <term>'));
+            return 0;
+        }
+        const hits = HELP_ENTRIES.filter((e) => e.cmd.toLowerCase().includes(term) || e.desc.toLowerCase().includes(term));
+        console.log('');
+        if (hits.length === 0) {
+            console.log(c.dim(`  no commands match "${term}" — try \`ashlr help --all\``));
+        }
+        else {
+            console.log(renderEntries(hits));
+        }
+        console.log('');
+        return 0;
+    }
+    const topicArg = args.find((a) => !a.startsWith('-'));
+    if (topicArg) {
+        if (TOPICS.includes(topicArg)) {
+            renderTopic(topicArg);
+            return 0;
+        }
+        console.log('');
+        console.log(c.dim(`  unknown topic "${topicArg}" — topics: ${TOPICS.join(', ')}`));
+        console.log('');
+        return 0;
+    }
+    renderSummary();
+    return 0;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

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

package/dist/cli/inbox.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `ashlr inbox` — Approval Inbox CLI (M23).
+ *
+ * The single human control plane for every proposed outward action. PENDING
+ * proposals NEVER auto-apply. The ONLY path to applyProposal is the explicit
+ * `inbox approve <id> [--yes]` subcommand, with a confirm gate.
+ *
+ * Subcommands:
+ *   inbox                    List PENDING proposals + counts by status.
+ *   inbox show <id>          Full detail of one proposal incl. diff (read-only).
+ *   inbox approve <id>       Confirm gate, setStatus approved, then applyProposal.
+ *   inbox approve <id> --yes Skip interactive prompt (requires TTY check; non-TTY
+ *                            with no --yes refuses — no silent auto-approve).
+ *   inbox reject <id>        Mark rejected; applies nothing.
+ *
+ * Flags:
+ *   --yes    Skip interactive confirm prompt (approve only; non-TTY w/o --yes refuses).
+ *   --json   Emit raw JSON for list / show / approve result.
+ *
+ * Non-TTY: approve without --yes refuses (no auto-approve, ever).
+ * READ-ONLY except for approve (which routes through the single applyProposal gate).
+ */
+/**
+ * `ashlr inbox [show|approve|reject] [id] [--yes] [--json]`
+ *
+ * Returns a process exit code (0 = success, non-zero = error/usage).
+ */
+export declare function cmdInbox(args: string[]): Promise<number>;