@ashlr/hub 2.2.0

package/dist/cli/notify.js

@@ -0,0 +1,188 @@
+/**
+ * `ashlr notify` — notification webhook subcommand.
+ *
+ * Usage:
+ *   ashlr notify test [--json]
+ *
+ * Sends a test ping to configured webhook(s) (cfg.notify.slackWebhook /
+ * cfg.notify.discordWebhook). Informative no-op (exit 0) when none configured —
+ * explains how to set one up. Never posts without a configured webhook.
+ *
+ * Exit codes:
+ *   0  test ping sent (or no webhook configured — informative)
+ *   1  test ping failed
+ *   2  bad usage
+ */
+import { makeColors, isTty } from './ui.js';
+import { loadConfig } from '../core/config.js';
+const { bold, dim, red, green, yellow, cyan } = makeColors(isTty());
+// ---------------------------------------------------------------------------
+// Lazy import — integrations built by another agent; degrade gracefully
+// ---------------------------------------------------------------------------
+async function importNotify() {
+    return import('../core/integrations/notify.js');
+}
+// ---------------------------------------------------------------------------
+// Help
+// ---------------------------------------------------------------------------
+function printNotifyHelp() {
+    console.log('');
+    console.log(bold('  ashlr notify') + dim(' — notification webhook (opt-in)'));
+    console.log('');
+    console.log('  ' + bold('Subcommands:'));
+    console.log('');
+    console.log(`    ${cyan('test [--json]')}  Send a test ping to configured webhook(s).`);
+    console.log('');
+    console.log('  ' + bold('How to configure:'));
+    console.log('');
+    console.log(`    Add ${bold('notify')} to your ${dim('~/.ashlr/config.json')}:`);
+    console.log('');
+    console.log(`    ${dim('"notify": {')}`);
+    console.log(`    ${dim('  "slackWebhook":   "https://hooks.slack.com/services/..."')}`);
+    console.log(`    ${dim('  "discordWebhook": "https://discord.com/api/webhooks/..."')}`);
+    console.log(`    ${dim('}')}`);
+    console.log('');
+    console.log('  ' + bold('Notes:'));
+    console.log('');
+    console.log(`    ${dim('• No-op (safe, informative exit 0) when no webhook is configured.')}`);
+    console.log(`    ${dim('• Posts concise summaries only — no secrets, no raw tokens.')}`);
+    console.log(`    ${dim('• Automatic posting only happens when a run/swarm completes and')}`);
+    console.log(`    ${dim('  notify is called explicitly from that flow — never from reads.')}`);
+    console.log('');
+}
+// ---------------------------------------------------------------------------
+// Subcommand: notify test
+// ---------------------------------------------------------------------------
+async function cmdNotifyTest(args) {
+    const jsonMode = args.includes('--json');
+    // Load config — degrade gracefully if unavailable
+    let cfg;
+    try {
+        cfg = loadConfig();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (jsonMode) {
+            process.stdout.write(JSON.stringify({ sent: false, detail: `config load failed: ${msg}` }, null, 2) + '\n');
+        }
+        else {
+            process.stderr.write(red('error: ') + `Could not load config: ${msg}\n`);
+        }
+        return 1;
+    }
+    // M32: opt-in desktop ping (macOS) — fired alongside the webhook test.
+    let desktopSent = false;
+    try {
+        const { desktopNotify, desktopNotifyEnabled } = await import('../core/integrations/desktop-notify.js');
+        if (desktopNotifyEnabled(cfg)) {
+            desktopSent = await desktopNotify('ashlr', 'notify test — desktop notifications are working', cfg);
+            if (!jsonMode && desktopSent) {
+                process.stdout.write('desktop notification sent ✓\n');
+            }
+        }
+    }
+    catch { /* desktop ping is best-effort */ }
+    // No webhook configured → informative no-op
+    const hasSlack = Boolean(cfg.notify?.slackWebhook);
+    const hasDiscord = Boolean(cfg.notify?.discordWebhook);
+    if (!hasSlack && !hasDiscord) {
+        if (jsonMode) {
+            process.stdout.write(JSON.stringify({
+                sent: false,
+                configured: false,
+                detail: 'no webhook configured',
+                hint: 'Add notify.slackWebhook or notify.discordWebhook to ~/.ashlr/config.json',
+            }, null, 2) + '\n');
+        }
+        else {
+            console.log('');
+            console.log(yellow('  No notification webhook configured.'));
+            console.log('');
+            console.log('  To enable notifications, add to ' + dim('~/.ashlr/config.json') + ':');
+            console.log('');
+            console.log(`    ${dim('"notify": {')}`);
+            console.log(`    ${dim('  "slackWebhook":   "https://hooks.slack.com/services/..."')}`);
+            console.log(`    ${dim('  "discordWebhook": "https://discord.com/api/webhooks/..."')}`);
+            console.log(`    ${dim('}')}`);
+            console.log('');
+            console.log(dim('  Run `ashlr notify test` again once a webhook is configured.'));
+            console.log('');
+        }
+        return 0;
+    }
+    // Load the notify module
+    let mod;
+    try {
+        mod = await importNotify();
+    }
+    catch {
+        if (jsonMode) {
+            process.stdout.write(JSON.stringify({ sent: false, detail: 'notify module not yet available' }, null, 2) + '\n');
+        }
+        else {
+            process.stderr.write(red('error: ') + 'Notify integration module not yet available.\n');
+        }
+        return 1;
+    }
+    const targets = [];
+    if (hasSlack)
+        targets.push('Slack');
+    if (hasDiscord)
+        targets.push('Discord');
+    if (!jsonMode) {
+        console.log('');
+        console.log(bold('  ashlr notify test'));
+        console.log('');
+        console.log(`  Sending test ping to: ${targets.map(t => cyan(t)).join(', ')}`);
+        console.log('');
+    }
+    const text = `ashlr notify test — connection check from ashlr-hub (${new Date().toISOString()})`;
+    let ok;
+    try {
+        ok = await mod.notify(text, cfg);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (jsonMode) {
+            process.stdout.write(JSON.stringify({ sent: false, detail: msg }, null, 2) + '\n');
+        }
+        else {
+            console.log(red(`  ✗ Failed: ${msg}`));
+            console.log('');
+        }
+        return 1;
+    }
+    if (jsonMode) {
+        process.stdout.write(JSON.stringify({ sent: ok, targets, detail: ok ? 'ping sent' : 'post failed' }, null, 2) + '\n');
+        return ok ? 0 : 1;
+    }
+    if (ok) {
+        console.log(green(`  ✓ Test ping sent to: ${targets.join(', ')}`));
+    }
+    else {
+        console.log(red('  ✗ Failed to send test ping — check webhook URL and network.'));
+    }
+    console.log('');
+    return ok ? 0 : 1;
+}
+// ---------------------------------------------------------------------------
+// cmdNotify — main entry point
+// ---------------------------------------------------------------------------
+/**
+ * `ashlr notify test` — send a test ping to configured webhook(s).
+ * Informative no-op when no webhook is configured. Returns a process exit code.
+ */
+export async function cmdNotify(args) {
+    const sub = args[0];
+    if (!sub || sub === '--help' || sub === '-h' || sub === 'help') {
+        printNotifyHelp();
+        return 0;
+    }
+    if (sub === 'test') {
+        return cmdNotifyTest(args.slice(1));
+    }
+    process.stderr.write(red('error: ') + `unknown notify subcommand: ${bold(sub)}\n`);
+    process.stderr.write(dim('Run `ashlr notify help` for usage.\n'));
+    return 2;
+}
+//# sourceMappingURL=notify.js.map

package/dist/cli/notify.js.map

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

package/dist/cli/onboard.d.ts

@@ -0,0 +1,85 @@
+/**
+ * CLI handler for `ashlr onboard` — a TTY-aware GUIDED first-activation
+ * walkthrough + one-command rollback. See docs/contracts/CONTRACT-H7.md
+ * (BUILD ITEM 3, 4, 5).
+ *
+ * H7 ABSOLUTE RULES (proven by test/h7.onboard.test.ts + test/h7.rollback.test.ts):
+ *  - ONBOARD-NEVER-AUTO-APPLIES: onboard chains ONLY the pre-existing human
+ *    gates — preflight (read-only) → enroll ONE repo (the explicit enrollment
+ *    gate, H6-audited) → daemon --dry-run --once (read-only, creates NO proposal)
+ *    → print a human-readable PLAN → point the user at `ashlr inbox` (review
+ *    only). It NEVER applies/approves a proposal, NEVER pushes/PRs/deploys, and
+ *    NEVER runs a live (non-dry) daemon. It imports NO outward primitive.
+ *  - ROLLBACK-INWARD-ONLY: `--rollback <repo>` only narrows state — unenroll +
+ *    sweepRepoSandboxes (scoped to the repo; a LIVE owner is never reclaimed) +
+ *    (opt-in --kill) setKill(true). The full trail is audited by the H6 audit()
+ *    inside policy.ts.
+ *  - Non-interactive (--yes OR non-TTY): prints the numbered steps as guidance
+ *    WITHOUT prompting and WITHOUT enrolling (mirrors cmdInit yesMode).
+ *  - No new runtime deps; node builtins + existing modules only.
+ *
+ * Wiring: BUILD/INTEGRATION adds `case 'onboard'` + a `loadOnboardCmd` lazy
+ * loader in src/cli/index.ts + a cmdHelp entry (+ optional `unenroll` alias).
+ */
+import type { AshlrConfig } from '../core/types.js';
+/** Interactive readline confirm (y/N). Resolves false when stdin is not a TTY. */
+export declare function promptConfirm(question: string): Promise<boolean>;
+/**
+ * Test seam: cmdOnboard calls the confirm prompt THROUGH this indirection object
+ * so a unit test can override `confirm` without a live TTY (a direct
+ * module-internal call to the exported `promptConfirm` cannot be spied across
+ * the ESM boundary). Production always uses the real `promptConfirm`.
+ */
+export declare const _internals: {
+    confirm: (question: string) => Promise<boolean>;
+};
+/**
+ * Render a HUMAN-READABLE dry-run PLAN (BUILD ITEM 5). Re-derives the same
+ * would-run selection the dry-run uses (listEnrolled → buildBacklog → top-K) and
+ * runs tick(cfg,{dryRun:true}) for the authoritative count. Creates NO proposal,
+ * spends $0, takes NO outward action.
+ *
+ * WRITE NOTE (not strictly side-effect-free): the authoritative
+ * tick(cfg,{dryRun:true}) persists the daemon RUN-STATE via saveDaemonState
+ * before returning (loop.ts dry-run branch). That write is the pre-existing,
+ * H6-audited dry-run behavior — it persists the H5-self-healed run-state flag
+ * (it NEVER sets running:true and NEVER creates a proposal), is bounded to the
+ * (isolated-in-tests) ~/.ashlr/daemon.json, and is never an outward action.
+ * Everything else here (listEnrolled / loadBacklog / buildBacklog) is a pure
+ * read.
+ *
+ * Sequence:
+ *   1. enrolled = listEnrolled()                 (read)
+ *   2. tick(cfg,{dryRun:true}) — authoritative itemsConsidered (NO proposal, $0;
+ *      persists daemon run-state only — never an outward action)
+ *   3. loadBacklog()/buildBacklog({repos:enrolled}) — the SAME scan the tick
+ *      used, for titles (read)
+ *   4. format `N item(s) across M repo(s)` + a bulleted list of the top-K titles,
+ *      explicitly labelled a PLAN that creates NO proposals.
+ *
+ * Never throws — degrades to a legible "0 item(s)" plan on any read error.
+ */
+export declare function renderDryRunPlan(cfg: AshlrConfig): Promise<string>;
+/**
+ * ROLLBACK (BUILD ITEM 4) — INWARD CLEANUP ONLY. In order:
+ *   1. unenroll(repo)                  (H6-audited enroll:remove)
+ *   2. sweepRepoSandboxes(repo)        (SCOPED to this repo; a LIVE owner is
+ *                                       NEVER reclaimed; the age guard is
+ *                                       dropped so a fresh crash-leftover from
+ *                                       the very activation being undone IS
+ *                                       reclaimed — true one-command undo)
+ *   3. opts.kill ⇒ setKill(true)       (opt-in; H6-audited kill:on)
+ * Returns 0. NEVER widens access; NEVER an outward action.
+ */
+export declare function rollback(repo: string, opts: {
+    kill: boolean;
+}): Promise<number>;
+/**
+ * `ashlr onboard` — guided first-activation walkthrough.
+ *   - `--rollback <repo> [--kill]` routes to rollback().
+ *   - else: preflight → (TTY) confirm + enroll ONE repo → dry-run PLAN →
+ *     point at `ashlr inbox` → offer rollback.
+ *   - `--yes` OR non-TTY: print the numbered steps WITHOUT prompting/enrolling.
+ * Returns 0 on success, non-zero when preflight blocks.
+ */
+export declare function cmdOnboard(args: string[]): Promise<number>;

package/dist/cli/onboard.js

@@ -0,0 +1,305 @@
+/**
+ * CLI handler for `ashlr onboard` — a TTY-aware GUIDED first-activation
+ * walkthrough + one-command rollback. See docs/contracts/CONTRACT-H7.md
+ * (BUILD ITEM 3, 4, 5).
+ *
+ * H7 ABSOLUTE RULES (proven by test/h7.onboard.test.ts + test/h7.rollback.test.ts):
+ *  - ONBOARD-NEVER-AUTO-APPLIES: onboard chains ONLY the pre-existing human
+ *    gates — preflight (read-only) → enroll ONE repo (the explicit enrollment
+ *    gate, H6-audited) → daemon --dry-run --once (read-only, creates NO proposal)
+ *    → print a human-readable PLAN → point the user at `ashlr inbox` (review
+ *    only). It NEVER applies/approves a proposal, NEVER pushes/PRs/deploys, and
+ *    NEVER runs a live (non-dry) daemon. It imports NO outward primitive.
+ *  - ROLLBACK-INWARD-ONLY: `--rollback <repo>` only narrows state — unenroll +
+ *    sweepRepoSandboxes (scoped to the repo; a LIVE owner is never reclaimed) +
+ *    (opt-in --kill) setKill(true). The full trail is audited by the H6 audit()
+ *    inside policy.ts.
+ *  - Non-interactive (--yes OR non-TTY): prints the numbered steps as guidance
+ *    WITHOUT prompting and WITHOUT enrolling (mirrors cmdInit yesMode).
+ *  - No new runtime deps; node builtins + existing modules only.
+ *
+ * Wiring: BUILD/INTEGRATION adds `case 'onboard'` + a `loadOnboardCmd` lazy
+ * loader in src/cli/index.ts + a cmdHelp entry (+ optional `unenroll` alias).
+ */
+import { resolve } from 'node:path';
+import { loadConfig } from '../core/config.js';
+import { buildReadiness } from '../core/readiness.js';
+import { enroll, unenroll, setKill, listEnrolled } from '../core/sandbox/policy.js';
+import { tick } from '../core/daemon/loop.js';
+import { loadBacklog, buildBacklog } from '../core/portfolio/backlog.js';
+import { sweepRepoSandboxes } from '../core/sandbox/worktree.js';
+import { makeColors, isTty } from './ui.js';
+const { bold, dim, red, green, yellow, cyan } = makeColors(isTty());
+// ---------------------------------------------------------------------------
+// Prompt — readline y/N confirm. Exported so tests can spy/mock it without
+// touching a live TTY. Resolves false when stdin is not a TTY (so a non-TTY
+// run NEVER enrolls; the caller's yesMode short-circuits before this anyway).
+// ---------------------------------------------------------------------------
+/** Interactive readline confirm (y/N). Resolves false when stdin is not a TTY. */
+export async function promptConfirm(question) {
+    if (!process.stdin.isTTY)
+        return false;
+    const readline = await import('node:readline');
+    return new Promise((resolveP) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(question + ' [y/N] ', (answer) => {
+            rl.close();
+            resolveP(answer.trim().toLowerCase() === 'y');
+        });
+    });
+}
+/**
+ * Test seam: cmdOnboard calls the confirm prompt THROUGH this indirection object
+ * so a unit test can override `confirm` without a live TTY (a direct
+ * module-internal call to the exported `promptConfirm` cannot be spied across
+ * the ESM boundary). Production always uses the real `promptConfirm`.
+ */
+export const _internals = {
+    confirm: promptConfirm,
+};
+// ---------------------------------------------------------------------------
+// renderDryRunPlan (BUILD ITEM 5) — human-readable, dry-run (NO outward action)
+// ---------------------------------------------------------------------------
+/**
+ * Render a HUMAN-READABLE dry-run PLAN (BUILD ITEM 5). Re-derives the same
+ * would-run selection the dry-run uses (listEnrolled → buildBacklog → top-K) and
+ * runs tick(cfg,{dryRun:true}) for the authoritative count. Creates NO proposal,
+ * spends $0, takes NO outward action.
+ *
+ * WRITE NOTE (not strictly side-effect-free): the authoritative
+ * tick(cfg,{dryRun:true}) persists the daemon RUN-STATE via saveDaemonState
+ * before returning (loop.ts dry-run branch). That write is the pre-existing,
+ * H6-audited dry-run behavior — it persists the H5-self-healed run-state flag
+ * (it NEVER sets running:true and NEVER creates a proposal), is bounded to the
+ * (isolated-in-tests) ~/.ashlr/daemon.json, and is never an outward action.
+ * Everything else here (listEnrolled / loadBacklog / buildBacklog) is a pure
+ * read.
+ *
+ * Sequence:
+ *   1. enrolled = listEnrolled()                 (read)
+ *   2. tick(cfg,{dryRun:true}) — authoritative itemsConsidered (NO proposal, $0;
+ *      persists daemon run-state only — never an outward action)
+ *   3. loadBacklog()/buildBacklog({repos:enrolled}) — the SAME scan the tick
+ *      used, for titles (read)
+ *   4. format `N item(s) across M repo(s)` + a bulleted list of the top-K titles,
+ *      explicitly labelled a PLAN that creates NO proposals.
+ *
+ * Never throws — degrades to a legible "0 item(s)" plan on any read error.
+ */
+export async function renderDryRunPlan(cfg) {
+    const enrolled = listEnrolled();
+    // (2) Authoritative count from the existing read-only dry-run path. The
+    // dry-run branch of tick() returns proposalsCreated:0, spentUsd:0,
+    // reason:'dry-run' — it creates NO proposal and spends nothing.
+    let itemsConsidered = 0;
+    try {
+        const t = await tick(cfg, { dryRun: true });
+        itemsConsidered = t.itemsConsidered;
+    }
+    catch {
+        itemsConsidered = 0;
+    }
+    // (3) The matching titles. Prefer the PERSISTED backlog (loadBacklog reads
+    // ~/.ashlr/backlog.json — the same scored, top-score-first set the daemon last
+    // computed; pure read, never throws). If none is persisted yet, fall back to a
+    // fresh read-only buildBacklog scan over the enrolled repos. Both are
+    // read-only and create no proposal.
+    let items = [];
+    try {
+        const persisted = loadBacklog();
+        if (persisted && persisted.items.length > 0) {
+            items = persisted.items;
+        }
+        else {
+            const backlog = await buildBacklog({ repos: enrolled });
+            items = backlog.items;
+        }
+    }
+    catch {
+        items = [];
+    }
+    // Present exactly the top-`itemsConsidered` titles the dry-run would work.
+    const planned = items.slice(0, itemsConsidered);
+    const repoCount = new Set(planned.map((i) => i.repo)).size;
+    const lines = [];
+    lines.push(bold('  Dry-run plan') + dim('  (preview only — creates NO proposals, spends $0)'));
+    lines.push('');
+    if (planned.length === 0) {
+        lines.push(`  ${dim('0 item(s) would run')}` +
+            `${enrolled.length === 0 ? dim(' — no repo enrolled yet') : dim(' — backlog is empty for enrolled repo(s)')}`);
+    }
+    else {
+        lines.push(`  ${green(String(planned.length))} item(s) would run across ` +
+            `${green(String(repoCount))} repo(s):`);
+        for (const it of planned) {
+            lines.push(`    ${cyan('•')} ${it.title}${it.detail ? dim(` — ${it.detail}`) : ''}`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// rollback (BUILD ITEM 4) — INWARD CLEANUP ONLY
+// ---------------------------------------------------------------------------
+/**
+ * ROLLBACK (BUILD ITEM 4) — INWARD CLEANUP ONLY. In order:
+ *   1. unenroll(repo)                  (H6-audited enroll:remove)
+ *   2. sweepRepoSandboxes(repo)        (SCOPED to this repo; a LIVE owner is
+ *                                       NEVER reclaimed; the age guard is
+ *                                       dropped so a fresh crash-leftover from
+ *                                       the very activation being undone IS
+ *                                       reclaimed — true one-command undo)
+ *   3. opts.kill ⇒ setKill(true)       (opt-in; H6-audited kill:on)
+ * Returns 0. NEVER widens access; NEVER an outward action.
+ */
+export async function rollback(repo, opts) {
+    const abs = resolve(repo);
+    // 1. Narrow the enrollment gate. Idempotent; H6-audited enroll:remove.
+    unenroll(abs);
+    // 2. Reclaim THIS repo's crash-leftover sandboxes (scoped). The scoped sweep
+    //    drops the 6h age guard (so a FRESH leftover from the activation being
+    //    undone is reclaimed too) but KEEPS the ownerAlive guard, so it NEVER
+    //    force-removes a LIVE in-flight worktree; each removal inherits
+    //    removeSandbox's full containment guards.
+    let swept = [];
+    try {
+        swept = sweepRepoSandboxes(abs);
+    }
+    catch {
+        swept = [];
+    }
+    // 3. Opt-in: pause ALL autonomy in the same step (H6-audited kill:on).
+    if (opts.kill)
+        setKill(true);
+    console.log('');
+    console.log(bold('  ashlr onboard --rollback'));
+    console.log('');
+    console.log(`  ${green('✓')} unenrolled ${dim(abs)}`);
+    console.log(`  ${green('✓')} swept ${swept.length} leftover sandbox(es) for this repo ` +
+        dim('(a live in-flight worktree is never reclaimed)'));
+    if (opts.kill) {
+        console.log(`  ${yellow('!')} kill switch ON ${dim('— all autonomy paused')}`);
+    }
+    console.log('');
+    console.log(`  ${dim('Re-enable any time with')} ${cyan('ashlr onboard')}.`);
+    console.log('');
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Blocker / guidance rendering
+// ---------------------------------------------------------------------------
+function printBlockers(report) {
+    console.log('');
+    console.log(bold('  ashlr onboard') + dim('  — preflight'));
+    console.log('');
+    console.log(`  ${red('✗')} ${bold('not ready')} ${dim('— resolve the blocker(s) below, then re-run.')}`);
+    console.log('');
+    for (const b of report.blockers) {
+        console.log(`  ${red('✗')} ${b.detail}${b.fix ? `\n      ${dim('fix:')} ${cyan(b.fix)}` : ''}`);
+    }
+    console.log('');
+}
+/**
+ * Non-interactive guidance: print the numbered FIRST-ACTIVATION steps WITHOUT
+ * prompting and WITHOUT enrolling. Mirrors cmdInit's yesMode — it DESCRIBES the
+ * activation; the human still runs the explicit enroll/inbox steps themselves.
+ */
+function printSteps(repoHint) {
+    console.log('');
+    console.log(bold('  ashlr onboard') + dim('  — first safe activation (steps)'));
+    console.log('');
+    console.log(`  ${dim('Run these in order. Each step is the explicit human gate — nothing runs on its own.')}`);
+    console.log('');
+    console.log(`  ${cyan('1.')} ${bold('Preflight')}   ${dim('ashlr preflight')}                      ${dim('— read-only readiness check')}`);
+    console.log(`  ${cyan('2.')} ${bold('Enroll ONE')}  ${dim(`ashlr sandbox enroll ${repoHint}`)}   ${dim('— the explicit enrollment gate')}`);
+    console.log(`  ${cyan('3.')} ${bold('Dry-run')}     ${dim('ashlr daemon start --dry-run --once')}    ${dim('— preview the plan; NO proposal, $0')}`);
+    console.log(`  ${cyan('4.')} ${bold('Review')}      ${dim('ashlr inbox')}                          ${dim('— review + approve; NEVER auto-applied')}`);
+    console.log(`  ${cyan('5.')} ${bold('Rollback')}    ${dim(`ashlr onboard --rollback ${repoHint}`)}  ${dim('— one-command undo')}`);
+    console.log('');
+    console.log(`  ${dim('Re-run interactively (a TTY, no --yes) to be guided through steps 1–3 automatically.')}`);
+    console.log('');
+}
+// ---------------------------------------------------------------------------
+// cmdOnboard — the dispatcher entry point
+// ---------------------------------------------------------------------------
+/**
+ * `ashlr onboard` — guided first-activation walkthrough.
+ *   - `--rollback <repo> [--kill]` routes to rollback().
+ *   - else: preflight → (TTY) confirm + enroll ONE repo → dry-run PLAN →
+ *     point at `ashlr inbox` → offer rollback.
+ *   - `--yes` OR non-TTY: print the numbered steps WITHOUT prompting/enrolling.
+ * Returns 0 on success, non-zero when preflight blocks.
+ */
+export async function cmdOnboard(args) {
+    const cfg = loadConfig();
+    // ── Rollback route ────────────────────────────────────────────────────────
+    if (args.includes('--rollback')) {
+        const idx = args.indexOf('--rollback');
+        // The repo is the positional right after --rollback, else the first
+        // non-flag positional, else cwd.
+        const positional = args.filter((a, i) => !a.startsWith('--') && i !== idx + 1);
+        const repo = args[idx + 1] && !args[idx + 1].startsWith('--')
+            ? args[idx + 1]
+            : positional[0] ?? process.cwd();
+        const kill = args.includes('--kill');
+        return rollback(repo, { kill });
+    }
+    // ── yesMode = non-interactive guidance (NO prompt, NO enroll) ──────────────
+    const yesMode = args.includes('--yes') || !process.stdin.isTTY;
+    // Candidate repo: first positional arg, else cwd.
+    const repoArg = args.find((a) => !a.startsWith('--'));
+    const candidate = resolve(repoArg ?? process.cwd());
+    // ── Step 1: Preflight (READ-ONLY). Blockers ⇒ STOP, do nothing else. ───────
+    const report = await buildReadiness(cfg);
+    if (!report.ready) {
+        printBlockers(report);
+        return 1;
+    }
+    // Non-interactive: print the numbered steps and STOP — never enroll, never
+    // dry-run on the user's behalf. The human runs the explicit gates.
+    if (yesMode) {
+        printSteps(repoArg ?? candidate);
+        return 0;
+    }
+    // ── Interactive walkthrough ────────────────────────────────────────────────
+    console.log('');
+    console.log(bold('  ashlr onboard') + dim('  — first safe activation'));
+    console.log('');
+    console.log(`  ${green('✓')} ${bold('ready')}` +
+        (report.warnings.length ? dim(`  (${report.warnings.length} warning(s) — non-blocking)`) : ''));
+    for (const w of report.warnings) {
+        console.log(`    ${yellow('!')} ${dim(w.detail)}`);
+    }
+    for (const note of report.info) {
+        console.log(`    ${dim('•')} ${dim(note.detail)}`);
+    }
+    console.log('');
+    // ── Step 2: Enroll ONE repo (the explicit human gate; H6-audited) ──────────
+    const before = listEnrolled();
+    const confirmed = await _internals.confirm(`  Enroll ${cyan(candidate)} for autonomous work?`);
+    if (!confirmed) {
+        console.log('');
+        console.log(`  ${dim('No repo enrolled. Re-run when ready, or run')} ${cyan('ashlr preflight')} ${dim('to re-check.')}`);
+        console.log('');
+        return 0;
+    }
+    enroll(candidate); // idempotent; the ONLY mutating call in the whole flow
+    const after = listEnrolled();
+    console.log('');
+    console.log(`  ${green('✓')} enrolled ${dim(candidate)} ${dim(`(${before.length} → ${after.length} repo(s))`)}`);
+    console.log('');
+    // ── Step 3: Dry-run PLAN (READ-ONLY — NO proposal, $0 spend) ───────────────
+    const plan = await renderDryRunPlan(cfg);
+    console.log(plan);
+    // ── Step 4: Point at the inbox (REVIEW ONLY — never auto-approve/apply) ─────
+    console.log(`  ${bold('Next:')} review what would run with ${cyan('ashlr inbox')} ${dim('— nothing is applied until YOU approve it there.')}`);
+    console.log('');
+    // ── Step 5: Offer the one-command rollback ─────────────────────────────────
+    console.log(`  ${dim('Undo this activation any time:')} ${cyan(`ashlr onboard --rollback ${candidate}`)}${dim(' [--kill]')}`);
+    console.log('');
+    return 0;
+}
+//# sourceMappingURL=onboard.js.map

package/dist/cli/onboard.js.map

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

package/dist/cli/open.d.ts

@@ -0,0 +1,38 @@
+/**
+ * cli/open.ts — Launch items in editor, Finder, or Terminal.
+ *
+ * All launchers use spawn (detached, unref'd) so the CLI process exits
+ * immediately. Errors are swallowed — never throw; open operations are
+ * best-effort UI conveniences.
+ */
+import type { AshlrConfig } from '../core/types.js';
+/**
+ * Open `path` in the configured editor using a deep link URL.
+ *
+ * Strategy:
+ *  1. Cursor  → `open "cursor://file/<abs>"`
+ *     Fallback: `open -a Cursor <path>`
+ *  2. VSCode  → `open "vscode://file/<abs>"`
+ *     Fallback: `open -a "Visual Studio Code" <path>`
+ *
+ * The deep link is tried first; if the URL scheme handler is not registered
+ * (e.g. app not installed) macOS silently does nothing, so we do not attempt
+ * explicit fallback detection — callers are welcome to retry via openInFinder.
+ */
+export declare function openInEditor(path: string, cfg: AshlrConfig): void;
+/**
+ * Reveal `path` in macOS Finder.
+ * Uses `open <path>` which opens directories in Finder and files with their
+ * default app. For "reveal in Finder" semantics on a file, callers can pass
+ * the parent directory instead.
+ */
+export declare function openInFinder(path: string): void;
+/**
+ * Open a new Terminal window cd'd to `path` (best-effort).
+ *
+ * Uses `open -a Terminal <path>`. On macOS this opens a new Terminal window
+ * at the given directory when path is a directory. For files, Terminal opens
+ * at the parent directory. No guarantee for iTerm2 or other terminals — this
+ * targets the system Terminal.app only.
+ */
+export declare function openInTerminal(path: string): void;