@ashlr/hub 2.2.0

package/dist/cli/completions.js

@@ -0,0 +1,156 @@
+/**
+ * cli/completions.ts — `ashlr completions zsh|bash` (M31).
+ *
+ * Emits a STATIC shell-completion script generated from the top-level command
+ * table. Install:
+ *   zsh:  ashlr completions zsh  > ~/.zsh/completions/_ashlr   (fpath dir)
+ *   bash: ashlr completions bash > ~/.local/share/bash-completion/completions/ashlr
+ *
+ * Read-only: prints to stdout, writes nothing. Exit codes: 0 / 2 bad usage.
+ */
+import { makeColors, isTty } from './ui.js';
+/** Top-level commands (kept in sync by test/m31.cli-agent.test.ts). */
+export const TOP_LEVEL_COMMANDS = [
+    'index', 'go', 'status', 'ls', 'open', 'tidy', 'config', 'doctor', 'init',
+    'mcp', 'run', 'runs', 'pulse', 'new', 'ship', 'recall', 'learn', 'genome',
+    'update', 'spec', 'swarm', 'swarms', 'tui', 'dash', 'serve', 'models',
+    'gh', 'vercel', 'wire', 'notify', 'telemetry', 'sandbox', 'audit',
+    'enroll', 'backlog', 'inbox', 'daemon', 'ask', 'knowledge', 'reflect',
+    'health', 'goals', 'digest', 'seams', 'verify-safety', 'preflight',
+    'onboard', 'demo', 'orient', 'docs', 'completions', 'plugins', 'x', 'help',
+];
+/** Subcommands per top-level command (first-position completion only). */
+const SUBCOMMANDS = {
+    config: ['get', 'set', 'path'],
+    mcp: ['list', 'doctor', 'install'],
+    run: ['show'],
+    spec: ['new', 'list', 'show', 'refine'],
+    swarm: ['show'],
+    models: ['pull', 'start'],
+    gh: ['pr', 'issue', 'ci'],
+    vercel: ['ls', 'logs'],
+    wire: ['claude', 'codex', 'cursor', 'all'],
+    notify: ['test'],
+    telemetry: ['status', 'test'],
+    sandbox: ['list', 'diff', 'cleanup', 'gc'],
+    enroll: ['add', 'remove', 'list', 'kill'],
+    backlog: ['refresh'],
+    inbox: ['show', 'approve', 'reject'],
+    daemon: ['start', 'stop', 'status'],
+    knowledge: ['build', 'impact', 'graph'],
+    reflect: ['playbooks', 'propose'],
+    health: ['propose'],
+    goals: ['add', 'plan', 'advance', 'status'],
+    seams: ['status'],
+    completions: ['zsh', 'bash'],
+    plugins: ['init', 'list', 'info', 'enable', 'disable'],
+};
+function zshScript() {
+    const subcases = Object.entries(SUBCOMMANDS)
+        .map(([cmd, subs]) => `      ${cmd}) _values 'subcommand' ${subs.map((s) => `'${s}'`).join(' ')} ;;`)
+        .join('\n');
+    return `#compdef ashlr
+# ashlr zsh completions — generated by \`ashlr completions zsh\`.
+_ashlr() {
+  local -a _ashlr_cmds
+  _ashlr_cmds=(${TOP_LEVEL_COMMANDS.map((c) => `'${c}'`).join(' ')})
+  if (( CURRENT == 2 )); then
+    _values 'ashlr command' "\${_ashlr_cmds[@]}"
+  elif (( CURRENT == 3 )); then
+    case "\${words[2]}" in
+${subcases}
+      *) _files ;;
+    esac
+  else
+    _files
+  fi
+}
+_ashlr "$@"
+`;
+}
+function bashScript() {
+    const subcases = Object.entries(SUBCOMMANDS)
+        .map(([cmd, subs]) => `      ${cmd}) COMPREPLY=( $(compgen -W "${subs.join(' ')}" -- "$cur") ) ;;`)
+        .join('\n');
+    return `# ashlr bash completions — generated by \`ashlr completions bash\`.
+_ashlr_completions() {
+  local cur prev
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  if [ "$COMP_CWORD" -eq 1 ]; then
+    COMPREPLY=( $(compgen -W "${TOP_LEVEL_COMMANDS.join(' ')}" -- "$cur") )
+    return 0
+  fi
+  if [ "$COMP_CWORD" -eq 2 ]; then
+    case "\${COMP_WORDS[1]}" in
+${subcases}
+      *) COMPREPLY=() ;;
+    esac
+    return 0
+  fi
+  COMPREPLY=()
+}
+complete -F _ashlr_completions ashlr
+`;
+}
+export async function cmdCompletions(args) {
+    const shell = args[0];
+    if (shell === 'zsh') {
+        process.stdout.write(zshScript());
+        return 0;
+    }
+    if (shell === 'bash') {
+        process.stdout.write(bashScript());
+        return 0;
+    }
+    const c = makeColors(isTty());
+    console.log('');
+    console.log(c.bold('  ashlr completions') + c.dim(' — shell completion scripts'));
+    console.log('');
+    console.log(`    ${c.cyan('ashlr completions zsh')}    ${c.dim('print zsh completion (_ashlr) to stdout')}`);
+    console.log(`    ${c.cyan('ashlr completions bash')}   ${c.dim('print bash completion to stdout')}`);
+    console.log('');
+    return shell === undefined || shell === '--help' || shell === '-h' || shell === 'help' ? 0 : 2;
+}
+// ---------------------------------------------------------------------------
+// "did you mean" (used by the dispatcher's unknown-command path)
+// ---------------------------------------------------------------------------
+/** Bounded Levenshtein distance (small strings only; zero-dep). */
+function editDistance(a, b) {
+    const m = a.length;
+    const n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    let prev = Array.from({ length: n + 1 }, (_v, j) => j);
+    for (let i = 1; i <= m; i++) {
+        const cur = [i, ...new Array(n).fill(0)];
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            cur[j] = Math.min((cur[j - 1] ?? 0) + 1, (prev[j] ?? 0) + 1, (prev[j - 1] ?? 0) + cost);
+        }
+        prev = cur;
+    }
+    return prev[n] ?? 0;
+}
+/**
+ * Closest known command for a typo, or null when nothing is plausibly close
+ * (distance must be ≤ 2 and less than half the input length).
+ */
+export function didYouMean(input) {
+    let best = null;
+    let bestDist = Infinity;
+    for (const cmd of TOP_LEVEL_COMMANDS) {
+        const d = editDistance(input.toLowerCase(), cmd);
+        if (d < bestDist) {
+            bestDist = d;
+            best = cmd;
+        }
+    }
+    if (best !== null && bestDist <= 2 && bestDist < Math.max(2, input.length / 2) + 1) {
+        return best;
+    }
+    return null;
+}
+//# sourceMappingURL=completions.js.map

package/dist/cli/completions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.js","sourceRoot":"","sources":["../../src/cli/completions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAE5C,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM;IACzE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ;IACzE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ;IACrE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO;IACjE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS;IACrE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW;IAClE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM;CAC3E,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,GAA6B;IAC5C,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;IAC9B,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;IAClC,GAAG,EAAE,CAAC,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;IACvC,KAAK,EAAE,CAAC,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC;IAC1C,MAAM,EAAE,CAAC,MAAM,CAAC;IAChB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC;IAC1C,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IACpC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;IACvC,OAAO,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IACjC,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;IAC3C,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC;CACvD,CAAC;AAEF,SAAS,SAAS;IAChB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,GAAG,0BAA0B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;SACpG,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;;;;iBAIQ,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;;;;;EAKhE,QAAQ;;;;;;;;CAQT,CAAC;AACF,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,SAAS,GAAG,+BAA+B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC;SAClG,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;;;;;;gCAMuB,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC;;;;;EAK1D,QAAQ;;;;;;;;CAQT,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,yCAAyC,CAAC,EAAE,CAAC,CAAC;IAC7G,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,iCAAiC,CAAC,EAAE,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,mEAAmE;AACnE,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACxC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,GAAG,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;YACjB,QAAQ,GAAG,CAAC,CAAC;YACb,IAAI,GAAG,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/daemon.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `ashlr daemon` — the M24 autonomous operator CLI surface.
+ *
+ * The daemon pulls the highest-value backlog items for ENROLLED repos and
+ * dispatches SANDBOXED swarms whose output becomes PENDING PROPOSALS in the
+ * Approval Inbox. It is SAFE BY CONSTRUCTION: it can ONLY propose; it has NO
+ * path to apply / push / PR / deploy / mutate.
+ *
+ * Subcommands:
+ *   daemon start [--once] [--dry-run] [--budget <usd>] [--interval <ms>]
+ *                [--parallel <n>]
+ *       Load cfg, merge flags over cfg.daemon defaults into a DaemonConfig,
+ *       call runDaemon. --dry-run => plan only (which items WOULD be worked;
+ *       NO swarm/proposal). REFUSES (nonzero, clear message) when
+ *       ASHLR_IN_DAEMON / ASHLR_IN_SWARM is set (no fork bomb).
+ *   daemon stop
+ *       Set the kill switch + clear running state. Idempotent.
+ *   daemon status
+ *       Print running?, last tick, today's spend vs cap, items processed,
+ *       pending proposals (M23 pendingCount). READ-ONLY.
+ *
+ * This file has NO outward-action path: it never applies, pushes, opens a PR,
+ * or deploys. Its only inbox interaction is the READ-ONLY pendingCount() (for
+ * status); all proposal creation happens inside the sandboxed swarm.
+ */
+/**
+ * `ashlr daemon [start|stop|status] [flags]`
+ *
+ * Returns a process exit code (0 = success, non-zero = error/usage).
+ */
+export declare function cmdDaemon(args: string[]): Promise<number>;

package/dist/cli/daemon.js

@@ -0,0 +1,334 @@
+/**
+ * `ashlr daemon` — the M24 autonomous operator CLI surface.
+ *
+ * The daemon pulls the highest-value backlog items for ENROLLED repos and
+ * dispatches SANDBOXED swarms whose output becomes PENDING PROPOSALS in the
+ * Approval Inbox. It is SAFE BY CONSTRUCTION: it can ONLY propose; it has NO
+ * path to apply / push / PR / deploy / mutate.
+ *
+ * Subcommands:
+ *   daemon start [--once] [--dry-run] [--budget <usd>] [--interval <ms>]
+ *                [--parallel <n>]
+ *       Load cfg, merge flags over cfg.daemon defaults into a DaemonConfig,
+ *       call runDaemon. --dry-run => plan only (which items WOULD be worked;
+ *       NO swarm/proposal). REFUSES (nonzero, clear message) when
+ *       ASHLR_IN_DAEMON / ASHLR_IN_SWARM is set (no fork bomb).
+ *   daemon stop
+ *       Set the kill switch + clear running state. Idempotent.
+ *   daemon status
+ *       Print running?, last tick, today's spend vs cap, items processed,
+ *       pending proposals (M23 pendingCount). READ-ONLY.
+ *
+ * This file has NO outward-action path: it never applies, pushes, opens a PR,
+ * or deploys. Its only inbox interaction is the READ-ONLY pendingCount() (for
+ * status); all proposal creation happens inside the sandboxed swarm.
+ */
+import { makeColors } from './ui.js';
+async function importLoop() {
+    try {
+        const mod = (await import('../core/daemon/loop.js'));
+        return { runDaemon: mod.runDaemon, stopDaemon: mod.stopDaemon };
+    }
+    catch {
+        return null;
+    }
+}
+async function importState() {
+    try {
+        const mod = (await import('../core/daemon/state.js'));
+        return { loadDaemonState: mod.loadDaemonState };
+    }
+    catch {
+        return null;
+    }
+}
+async function importPendingCount() {
+    try {
+        const mod = (await import('../core/inbox/store.js'));
+        return mod.pendingCount;
+    }
+    catch {
+        return null;
+    }
+}
+async function importConfig() {
+    try {
+        const mod = (await import('../core/config.js'));
+        return mod.loadConfig;
+    }
+    catch {
+        return null;
+    }
+}
+/** Parse a numeric flag value; returns undefined when missing/invalid. */
+function parseNum(v) {
+    if (v === undefined)
+        return undefined;
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+function parseStartFlags(args) {
+    const flags = { once: false, dryRun: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        switch (a) {
+            case '--once':
+                flags.once = true;
+                break;
+            case '--dry-run':
+                flags.dryRun = true;
+                break;
+            case '--budget': {
+                const v = parseNum(args[++i]);
+                if (v === undefined)
+                    return { flags, err: '--budget requires a positive number (USD)' };
+                flags.budgetUsd = v;
+                break;
+            }
+            case '--interval': {
+                const v = parseNum(args[++i]);
+                if (v === undefined)
+                    return { flags, err: '--interval requires a positive number (ms)' };
+                flags.intervalMs = v;
+                break;
+            }
+            case '--parallel': {
+                const v = parseNum(args[++i]);
+                if (v === undefined)
+                    return { flags, err: '--parallel requires a positive integer' };
+                flags.parallel = Math.floor(v);
+                break;
+            }
+            default:
+                if (a?.startsWith('-'))
+                    return { flags, err: `Unknown flag: ${a}` };
+                // ignore stray positionals
+                break;
+        }
+    }
+    return { flags };
+}
+/**
+ * Merge CLI flags over cfg.daemon into the config passed to runDaemon.
+ * cfg.daemon grants NO authority — it only tunes the caps (budget/interval/
+ * parallel). The daemon remains proposal-only by construction regardless.
+ */
+function mergeDaemonConfig(cfg, flags) {
+    const existing = cfg.daemon ?? {};
+    const merged = { ...existing };
+    if (flags.budgetUsd !== undefined)
+        merged.dailyBudgetUsd = flags.budgetUsd;
+    if (flags.intervalMs !== undefined)
+        merged.intervalMs = flags.intervalMs;
+    if (flags.parallel !== undefined)
+        merged.parallel = flags.parallel;
+    return { ...cfg, daemon: merged };
+}
+// ---------------------------------------------------------------------------
+// Display helpers
+// ---------------------------------------------------------------------------
+/** Relative age string from an ISO timestamp. */
+function relAge(iso) {
+    if (!iso)
+        return 'never';
+    try {
+        const ms = Date.now() - new Date(iso).getTime();
+        if (ms < 60_000)
+            return 'just now';
+        if (ms < 3_600_000)
+            return `${Math.floor(ms / 60_000)}m ago`;
+        if (ms < 86_400_000)
+            return `${Math.floor(ms / 3_600_000)}h ago`;
+        return `${Math.floor(ms / 86_400_000)}d ago`;
+    }
+    catch {
+        return iso;
+    }
+}
+// ---------------------------------------------------------------------------
+// Subcommand: start
+// ---------------------------------------------------------------------------
+async function cmdDaemonStart(args) {
+    const tty = process.stdout.isTTY === true;
+    const col = makeColors(tty);
+    // ── Re-entrancy guard (clear, nonzero refusal) ──────────────────────────
+    // runDaemon ALSO refuses internally; we surface a friendly message here so
+    // the user gets a non-silent explanation and a nonzero exit code.
+    if (process.env['ASHLR_IN_DAEMON'] || process.env['ASHLR_IN_SWARM']) {
+        const which = process.env['ASHLR_IN_DAEMON'] ? 'ASHLR_IN_DAEMON' : 'ASHLR_IN_SWARM';
+        console.error(col.red('error: ') +
+            `daemon start refused: ${which} is set — no daemon-inside-daemon / daemon-inside-swarm.`);
+        return 1;
+    }
+    const { flags, err } = parseStartFlags(args);
+    if (err) {
+        console.error(col.red('error: ') + err);
+        console.error(col.dim('Usage: ashlr daemon start [--once] [--dry-run] [--budget <usd>] [--interval <ms>] [--parallel <n>]'));
+        return 2;
+    }
+    const loadConfig = await importConfig();
+    if (!loadConfig) {
+        console.error(col.red('error: ') + 'daemon requires src/core/config.ts.');
+        return 1;
+    }
+    const loop = await importLoop();
+    if (!loop) {
+        console.error(col.red('error: ') + 'daemon requires src/core/daemon/loop.ts (M24 module not yet built).');
+        return 1;
+    }
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch (e) {
+        console.error(col.red('error: ') + 'Failed to load config: ' + (e instanceof Error ? e.message : String(e)));
+        return 1;
+    }
+    const merged = mergeDaemonConfig(cfg, flags);
+    console.log('');
+    console.log(col.bold('  ashlr daemon') +
+        col.dim(` — ${flags.dryRun ? 'dry-run plan' : 'operator'}${flags.once ? ' · single tick' : ' · loop'}`));
+    if (flags.budgetUsd !== undefined) {
+        console.log(col.dim(`  daily budget cap: $${flags.budgetUsd}`));
+    }
+    console.log(col.dim('  proposal-only · sandboxed · enrollment-only'));
+    console.log('');
+    // runDaemon never throws by contract; it REFUSES on re-entrancy (handled
+    // above) and stops on kill switch / budget exhaustion. It ONLY produces
+    // PENDING inbox proposals — never applies/pushes/PRs/deploys/mutates.
+    const finalState = await loop.runDaemon(merged, { once: flags.once, dryRun: flags.dryRun });
+    // Summarize the most-recent tick (if any) for human feedback.
+    const lastTick = finalState.ticks[finalState.ticks.length - 1];
+    if (lastTick) {
+        const reasonColor = lastTick.reason === 'ok'
+            ? col.green
+            : lastTick.reason === 'dry-run'
+                ? col.cyan
+                : col.yellow;
+        console.log('  ' +
+            col.bold('last tick: ') +
+            reasonColor(lastTick.reason) +
+            col.dim(`  ·  considered ${lastTick.itemsConsidered}  ·  proposals ${lastTick.proposalsCreated}  ·  $${lastTick.spentUsd.toFixed(4)}`));
+    }
+    else {
+        console.log('  ' + col.dim('no tick recorded.'));
+    }
+    console.log('  ' + col.dim(`today's spend: $${finalState.todaySpentUsd.toFixed(4)}`));
+    console.log('  ' + col.dim('Use `ashlr inbox` to review PENDING proposals (never auto-applied).'));
+    console.log('');
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Subcommand: stop
+// ---------------------------------------------------------------------------
+async function cmdDaemonStop() {
+    const tty = process.stdout.isTTY === true;
+    const col = makeColors(tty);
+    const loop = await importLoop();
+    if (!loop) {
+        console.error(col.red('error: ') + 'daemon requires src/core/daemon/loop.ts (M24 module not yet built).');
+        return 1;
+    }
+    loop.stopDaemon();
+    console.log('');
+    console.log(col.green('  ✓ daemon stopped') + col.dim(' — kill switch set; running state cleared.'));
+    console.log(col.dim('  Any running loop halts on its next tick.'));
+    console.log(col.dim('  Re-enable with `ashlr sandbox kill --off` before starting again.'));
+    console.log('');
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Subcommand: status (READ-ONLY)
+// ---------------------------------------------------------------------------
+async function cmdDaemonStatus(jsonMode) {
+    const tty = process.stdout.isTTY === true;
+    const col = makeColors(tty);
+    const stateMod = await importState();
+    if (!stateMod) {
+        console.error(col.red('error: ') + 'daemon requires src/core/daemon/state.ts (M24 module not yet built).');
+        return 1;
+    }
+    const state = stateMod.loadDaemonState();
+    // pendingCount is READ-ONLY; degrade to 0 if the inbox store is absent.
+    const pendingCount = await importPendingCount();
+    let pending = 0;
+    try {
+        if (pendingCount)
+            pending = pendingCount();
+    }
+    catch {
+        pending = 0;
+    }
+    // Resolve the configured daily cap for display (best-effort).
+    let dailyCap;
+    const loadConfig = await importConfig();
+    if (loadConfig) {
+        try {
+            dailyCap = loadConfig().daemon?.dailyBudgetUsd;
+        }
+        catch {
+            dailyCap = undefined;
+        }
+    }
+    if (jsonMode) {
+        console.log(JSON.stringify({
+            running: state.running,
+            pid: state.pid,
+            startedAt: state.startedAt,
+            lastTickAt: state.lastTickAt,
+            todayDate: state.todayDate,
+            todaySpentUsd: state.todaySpentUsd,
+            dailyBudgetUsd: dailyCap ?? null,
+            itemsProcessed: state.itemsProcessed,
+            pendingProposals: pending,
+        }, null, 2));
+        return 0;
+    }
+    console.log('');
+    console.log(col.bold('  ashlr daemon status'));
+    console.log('');
+    console.log('  ' +
+        col.bold('running:        ') +
+        (state.running ? col.green('yes') + col.dim(` (pid ${state.pid ?? '?'})`) : col.dim('no (idle)')));
+    console.log('  ' + col.bold('started:        ') + col.dim(relAge(state.startedAt)));
+    console.log('  ' + col.bold('last tick:      ') + col.dim(relAge(state.lastTickAt)));
+    const capStr = dailyCap !== undefined ? ` / $${dailyCap}` : '';
+    console.log('  ' + col.bold("today's spend:  ") + col.dim(`$${state.todaySpentUsd.toFixed(4)}${capStr}`));
+    console.log('  ' + col.bold('items processed:') + ' ' + col.dim(String(state.itemsProcessed)));
+    console.log('  ' +
+        col.bold('pending props:  ') +
+        (pending > 0 ? col.yellow(String(pending)) : col.dim('0')));
+    console.log('');
+    if (pending > 0) {
+        console.log(col.dim('  Review with `ashlr inbox` — proposals are NEVER auto-applied.'));
+        console.log('');
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+/**
+ * `ashlr daemon [start|stop|status] [flags]`
+ *
+ * Returns a process exit code (0 = success, non-zero = error/usage).
+ */
+export async function cmdDaemon(args) {
+    const tty = process.stdout.isTTY === true;
+    const col = makeColors(tty);
+    const sub = args[0] ?? 'status';
+    const rest = args.slice(1);
+    switch (sub) {
+        case 'start':
+            return cmdDaemonStart(rest);
+        case 'stop':
+            return cmdDaemonStop();
+        case 'status':
+            return cmdDaemonStatus(rest.includes('--json'));
+        default:
+            console.error(col.red('error: ') + `Unknown daemon subcommand: ${sub}`);
+            console.error(col.dim('Usage: ashlr daemon [start|stop|status] [--once] [--dry-run] [--budget <usd>] [--interval <ms>] [--parallel <n>] [--json]'));
+            return 2;
+    }
+}
+//# sourceMappingURL=daemon.js.map

package/dist/cli/daemon.js.map

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

package/dist/cli/demo-sandbox.d.ts

@@ -0,0 +1,78 @@
+/**
+ * src/cli/demo-sandbox.ts — H8 shared isolation module for `ashlr demo`.
+ *
+ * MILESTONE H8 "Harden & Prove" (FINAL). This module factors the
+ * DISPOSABLE-repo + ISOLATED-tmp-`~/.ashlr` setup/teardown out of `demo.ts`
+ * (and away from `test/`) so the demo applies the EXACT same isolation discipline
+ * the H1 testkit encodes (`test/helpers/h1-fixture.ts:makeFixture`) — but as a
+ * shippable CLI helper rather than a test-only one. See
+ * docs/contracts/CONTRACT-H8.md (BUILD ITEM 1).
+ *
+ * ───────────────────────────────────────────────────────────────────────────
+ * ABSOLUTE SAFETY RULES (paramount — encoded directly in these helpers):
+ *   - HOME is relocated to a FRESH os.tmpdir() dir so every state read/write
+ *     resolves to an ISOLATED ~/.ashlr — NEVER the real one. The real portfolio
+ *     (~/.ashlr/enrollment.json = { repos: [] }) is NEVER touched. The prior
+ *     HOME + re-entrancy env (ASHLR_IN_DAEMON / ASHLR_IN_SWARM) are snapshotted
+ *     and RESTORED on dispose().
+ *   - A sanity guard asserts homedir() resolves to the tmp HOME before the demo
+ *     proceeds; if relocation did not take effect it RESTORES + ABORTS rather
+ *     than risk mutating the real ~/.ashlr (mirrors makeFixture's guard).
+ *   - The throwaway repo is a real git repo under os.tmpdir(), seeded with a
+ *     `// TODO:` marker so the backlog scan finds work. dispose() unenrolls it,
+ *     sweeps its sandboxes, rm -rf's the repo + the tmp HOME, and restores env.
+ *   - dispose() is IDEMPOTENT and NEVER throws (best-effort teardown), so the
+ *     demo's try/finally + signal handler can always clean up safely.
+ *
+ * IMPLEMENTATION NOTE: this module encodes the SAME disposable-repo + TODO-seed
+ * isolation discipline the H1 testkit (`test/helpers/h1-fixture.ts`) uses, but
+ * SELF-CONTAINED in `src/` — a shipped CLI module cannot import from `test/`
+ * (the build's `rootDir` is `src/`). The handful of git/seed primitives are tiny
+ * and use node builtins + git only, so duplicating them here (rather than
+ * importing a test helper) is the correct seam per docs/contracts/CONTRACT-H8.md ("factors them
+ * out of `test/` into a shippable module"). No new runtime dep is added.
+ */
+/**
+ * A live, ISOLATED demo context: a fresh tmp HOME (so `~/.ashlr` is isolated)
+ * plus a single DISPOSABLE git repo seeded with a TODO so the backlog finds
+ * work. Obtain via {@link makeDemoContext}; always tear down via
+ * {@link DemoContext.dispose} (idempotent, never throws).
+ */
+export interface DemoContext {
+    /** Absolute path of the isolated tmp HOME (process.env.HOME for the demo). */
+    readonly home: string;
+    /** Absolute path of the isolated ~/.ashlr under the tmp HOME. */
+    readonly ashlrDir: string;
+    /** Absolute path of the DISPOSABLE git repo (under os.tmpdir()). */
+    readonly repoDir: string;
+    /**
+     * Tear down: unenroll the tmp repo, sweep its sandboxes, restore HOME + the
+     * re-entrancy env, and (unless {@link MakeDemoContextOptions.keep}) rm -rf the
+     * tmp repo + tmp HOME. Idempotent; never throws. When `keep` is set, the tmp
+     * dir is preserved (still under os.tmpdir()) for inspection.
+     */
+    dispose(): void;
+}
+/** Options for {@link makeDemoContext}. */
+export interface MakeDemoContextOptions {
+    /**
+     * When true (`ashlr demo --no-cleanup`), dispose() still unenrolls + restores
+     * env but does NOT rm -rf the tmp dir — it is kept (still under os.tmpdir())
+     * for inspection. Default false (auto-clean).
+     */
+    keep?: boolean;
+}
+/**
+ * Create an ISOLATED demo context: snapshot + relocate `process.env.HOME` to a
+ * fresh os.tmpdir() dir, clear the re-entrancy env, ASSERT homedir() now
+ * resolves to the tmp HOME (else restore + throw), then create a DISPOSABLE git
+ * repo seeded with a `// TODO:` marker.
+ *
+ * The returned context's `dispose()` performs the guaranteed auto-cleanup. The
+ * caller MUST invoke it in a `try/finally` (and from a SIGINT/SIGTERM handler)
+ * so the tmp state is always reclaimed.
+ *
+ * @throws if HOME relocation does not take effect (isolation broken) — fails
+ *   loudly rather than risk touching the real ~/.ashlr.
+ */
+export declare function makeDemoContext(opts?: MakeDemoContextOptions): DemoContext;