@ashlr/hub 2.2.0

package/dist/cli/digest.d.ts

@@ -0,0 +1,46 @@
+/**
+ * CLI handler for `ashlr digest` — M29 portfolio daily digest (Ashlr v2 pillar G).
+ *
+ * Builds a deterministic DAILY DIGEST from the read-only org-level portfolio
+ * snapshot + day-over-day deltas, ALWAYS writes a LOCAL artifact under
+ * ~/.ashlr/digests/, prints it, and — ONLY with an explicit `--notify` — sends
+ * it outward via the opt-in notify() webhook.
+ *
+ * Usage:
+ *   ashlr digest                       # build + write local + print (default)
+ *   ashlr digest --json                # emit the DigestReport as JSON
+ *   ashlr digest --window <7d|30d>     # cost/forecast window (default 7d)
+ *   ashlr digest --notify              # ALSO send via configured webhook (opt-in)
+ *   ashlr digest --narrative           # OPT-IN: attempt an optional LLM narrative (local-first)
+ *   ashlr digest --narrative --allow-cloud  # permit a CLOUD model for that narrative
+ *
+ * HARD SAFETY INVARIANTS (M29) enforced by this surface:
+ *  - READ-ONLY AGGREGATION: the digest only READS local state (via buildDigest
+ *    -> buildSnapshot) and WRITES only under ~/.ashlr/digests/ (via
+ *    deliverDigest -> saveDigest). NEVER mutates a repo, writes config, applies
+ *    a proposal, pushes, opens a PR, or deploys.
+ *  - NO OUTWARD ACTION BY DEFAULT: the default path writes a LOCAL file and
+ *    makes ZERO outward network calls. `--notify` is the ONLY outward path and
+ *    is OPT-IN; notify() is itself a no-op unless a webhook is configured.
+ *  - LOCAL-FIRST: aggregation + rendering are deterministic with NO LLM. The
+ *    optional narrative routes through getActiveClient (local-only unless
+ *    --allow-cloud + key); default path is fully on-machine.
+ *
+ * NOTE (integration — owned by the Build/Integrate phase, NOT this scaffold):
+ *   src/cli/index.ts must add a `loadDigestCmd = lazyCmd(() => import('./digest.js'),
+ *   (m) => m.cmdDigest as Cmd, 'digest command requires src/cli/digest.ts (M29 …)')`,
+ *   a `case 'digest':` in the dispatch switch, and cmdHelp + help-text entries.
+ *
+ * Exit codes: 0 success, 1 runtime error, 2 bad usage.
+ */
+/**
+ * `ashlr digest [--window <7d|30d>] [--json] [--notify] [--allow-cloud]`
+ *
+ * Default path: build the digest (deterministic, read-only), ALWAYS write the
+ * local artifact under ~/.ashlr/digests/, and print it. `--notify` is the ONLY
+ * outward path and is OPT-IN. `--allow-cloud` permits a CLOUD model for the
+ * optional narrative (off by default; local-only otherwise).
+ *
+ * Exit codes: 0 success, 1 runtime error, 2 bad usage.
+ */
+export declare function cmdDigest(args: string[]): Promise<number>;

package/dist/cli/digest.js

@@ -0,0 +1,352 @@
+/**
+ * CLI handler for `ashlr digest` — M29 portfolio daily digest (Ashlr v2 pillar G).
+ *
+ * Builds a deterministic DAILY DIGEST from the read-only org-level portfolio
+ * snapshot + day-over-day deltas, ALWAYS writes a LOCAL artifact under
+ * ~/.ashlr/digests/, prints it, and — ONLY with an explicit `--notify` — sends
+ * it outward via the opt-in notify() webhook.
+ *
+ * Usage:
+ *   ashlr digest                       # build + write local + print (default)
+ *   ashlr digest --json                # emit the DigestReport as JSON
+ *   ashlr digest --window <7d|30d>     # cost/forecast window (default 7d)
+ *   ashlr digest --notify              # ALSO send via configured webhook (opt-in)
+ *   ashlr digest --narrative           # OPT-IN: attempt an optional LLM narrative (local-first)
+ *   ashlr digest --narrative --allow-cloud  # permit a CLOUD model for that narrative
+ *
+ * HARD SAFETY INVARIANTS (M29) enforced by this surface:
+ *  - READ-ONLY AGGREGATION: the digest only READS local state (via buildDigest
+ *    -> buildSnapshot) and WRITES only under ~/.ashlr/digests/ (via
+ *    deliverDigest -> saveDigest). NEVER mutates a repo, writes config, applies
+ *    a proposal, pushes, opens a PR, or deploys.
+ *  - NO OUTWARD ACTION BY DEFAULT: the default path writes a LOCAL file and
+ *    makes ZERO outward network calls. `--notify` is the ONLY outward path and
+ *    is OPT-IN; notify() is itself a no-op unless a webhook is configured.
+ *  - LOCAL-FIRST: aggregation + rendering are deterministic with NO LLM. The
+ *    optional narrative routes through getActiveClient (local-only unless
+ *    --allow-cloud + key); default path is fully on-machine.
+ *
+ * NOTE (integration — owned by the Build/Integrate phase, NOT this scaffold):
+ *   src/cli/index.ts must add a `loadDigestCmd = lazyCmd(() => import('./digest.js'),
+ *   (m) => m.cmdDigest as Cmd, 'digest command requires src/cli/digest.ts (M29 …)')`,
+ *   a `case 'digest':` in the dispatch switch, and cmdHelp + help-text entries.
+ *
+ * Exit codes: 0 success, 1 runtime error, 2 bad usage.
+ */
+import { makeColors, isTty, pad } from './ui.js';
+let _core = undefined;
+async function importCore() {
+    if (_core === undefined) {
+        try {
+            const [build, deliver, config] = await Promise.all([
+                import('../core/digest/build.js'),
+                import('../core/digest/deliver.js'),
+                import('../core/config.js'),
+            ]);
+            _core = {
+                buildDigest: build.buildDigest,
+                renderDigestText: deliver.renderDigestText,
+                deliverDigest: deliver.deliverDigest,
+                loadConfig: config.loadConfig,
+            };
+        }
+        catch {
+            _core = null;
+        }
+    }
+    return _core ?? null;
+}
+function parseDigestArgs(args) {
+    let json = false;
+    let notify = false;
+    let narrative = false;
+    let allowCloud = false;
+    let window = '7d';
+    let help = false;
+    let error;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === undefined)
+            continue;
+        if (a === '--help' || a === '-h') {
+            help = true;
+        }
+        else if (a === '--json') {
+            json = true;
+        }
+        else if (a === '--notify') {
+            notify = true;
+        }
+        else if (a === '--narrative') {
+            narrative = true;
+        }
+        else if (a === '--allow-cloud') {
+            allowCloud = true;
+        }
+        else if (a === '--window') {
+            const v = args[i + 1];
+            if (v === '7d' || v === '30d') {
+                window = v;
+                i++;
+            }
+            else {
+                error = `--window expects 7d or 30d (got: ${v ?? '<missing>'})`;
+                break;
+            }
+        }
+        else if (a.startsWith('--')) {
+            error = `Unknown flag: ${a}`;
+            break;
+        }
+        else {
+            error = `Unexpected argument: ${a}`;
+            break;
+        }
+    }
+    return { json, notify, narrative, allowCloud, window, help, error };
+}
+// ─── Help ─────────────────────────────────────────────────────────────────────
+function printHelp() {
+    const tty = isTty();
+    const { bold, cyan, dim, gray } = makeColors(tty);
+    const out = (s = '') => process.stdout.write(s + '\n');
+    out('');
+    out(bold('  ashlr digest') + dim(' — org-level daily portfolio digest (read-only; local by default)'));
+    out('');
+    out('  ' + bold('Usage:'));
+    out(`    ${cyan('ashlr digest')} [--window <7d|30d>] [--json] [--notify] [--narrative] [--allow-cloud]`);
+    out('');
+    out('  ' + bold('Options:'));
+    const opts = [
+        ['--window <7d|30d>', 'Cost/forecast window for the digest. Default 7d.'],
+        ['--json', 'Emit the DigestReport as JSON instead of human-readable output.'],
+        ['--notify', 'ALSO send the digest via a configured Slack/Discord webhook (OPT-IN; the only outward path).'],
+        ['--narrative', 'Attempt an OPTIONAL LLM narrative (local-first). Off by default (deterministic-only).'],
+        ['--allow-cloud', 'With --narrative, permit a CLOUD model. Off by default (local-only). No effect without --narrative.'],
+        ['--help', 'Show this help.'],
+    ];
+    const w = Math.max(...opts.map(([f]) => f.length));
+    for (const [flag, desc] of opts)
+        out(`    ${cyan(pad(flag, w))}  ${desc}`);
+    out('');
+    out('  ' + gray('The digest ALWAYS writes a LOCAL artifact under ~/.ashlr/digests/ and prints it.'));
+    out('  ' + gray('It makes ZERO outward network calls unless you pass --notify AND a webhook is configured.'));
+    out('  ' + gray('Aggregation + rendering are deterministic and local-only; the narrative is opt-in via --narrative.'));
+    out('');
+}
+// ─── Human-readable output ─────────────────────────────────────────────────────
+/** Short basename-ish label for a repo path (last non-empty path segment). */
+function repoLabel(repo) {
+    if (!repo)
+        return '—';
+    const parts = repo.split('/').filter(Boolean);
+    return parts.length > 0 ? parts[parts.length - 1] : repo;
+}
+/**
+ * Format a signed numeric delta with an arrow ('▲ +5', '▼ -3', '· 0'), or '—'
+ * when there is no prior digest to compare against (null). `digits` controls
+ * fixed-point precision for non-integer figures (e.g. spend in USD).
+ */
+function signedDelta(n, digits = 0) {
+    if (n === null)
+        return '—';
+    const v = digits > 0 ? Number(n.toFixed(digits)) : Math.round(n);
+    if (v > 0)
+        return `▲ +${digits > 0 ? v.toFixed(digits) : v}`;
+    if (v < 0)
+        return `▼ ${digits > 0 ? v.toFixed(digits) : v}`;
+    return '· 0';
+}
+/**
+ * Render a DigestReport for the terminal. Deterministic, READ-ONLY display of
+ * the already-built digest (mirrors the health/reflect human output). Prints
+ * the headline, the repo roll-up + pending proposals, the portfolio health /
+ * in-flight goals / top backlog / cost+forecast / effectiveness sections, the
+ * "today" day-over-day delta block, and an optional narrative when present.
+ */
+function printDigestHuman(report) {
+    const tty = isTty();
+    const { bold, cyan, dim, gray, green, yellow } = makeColors(tty);
+    const out = (s = '') => process.stdout.write(s + '\n');
+    const p = report.portfolio;
+    out('');
+    out(bold('  Digest') + gray(` [${report.date} · ${report.window}]`));
+    out('');
+    // Headline — the load-bearing one-line summary.
+    out('  ' + bold(report.headline || 'No activity to report.'));
+    out('');
+    // Repos + pending + daemon roll-up.
+    const rows = [
+        ['Repos', `${report.repos.total} total · ${report.repos.dirty} dirty · ${report.repos.stale} stale`],
+        ['Pending proposals', String(report.pendingProposals)],
+        [
+            'Cost',
+            `$${p.cost.spentUsd.toFixed(4)} (${p.cost.window}) · ~$${p.cost.projectedMonthlyUsd.toFixed(2)}/mo · saved $${p.cost.localSavingsUsd.toFixed(4)} local`,
+        ],
+    ];
+    if (report.daemon) {
+        rows.push([
+            'Operator',
+            `${report.daemon.running ? 'running' : 'stopped'} · $${report.daemon.todaySpentUsd.toFixed(4)} today`,
+        ]);
+    }
+    const w = Math.max(...rows.map(([k]) => k.length));
+    for (const [k, v] of rows)
+        out(`    ${cyan(pad(k, w))}  ${v}`);
+    out('');
+    // Health summary (ENROLLMENT-SCOPED — empty when nothing enrolled).
+    if (p.health.reposScored > 0) {
+        out('  ' + bold('Health') + gray(` — ${p.health.averageScore}/100 (${p.health.averageGrade}) over ${p.health.reposScored} repo(s)`));
+        for (const r of p.health.worstRepos) {
+            out(`    ${yellow('•')} ${cyan(repoLabel(r.repo))}  ${pad(`${r.score}/100`, 7, 'right')}  ${bold(r.grade)}`);
+        }
+        out('');
+    }
+    // In-flight goals (M28).
+    if (p.goalsInFlight.length > 0) {
+        out('  ' + bold('Goals in flight') + gray(` (${p.goalsInFlight.length})`));
+        for (const g of p.goalsInFlight) {
+            const next = g.nextActionable ? gray(` → ${g.nextActionable}`) : '';
+            out(`    ${green(`${Math.round(g.fractionDone * 100)}%`)}  ${g.objective}${next}`);
+        }
+        out('');
+    }
+    // Top backlog (M22).
+    if (p.backlogTop.length > 0) {
+        out('  ' + bold('Top backlog'));
+        for (const item of p.backlogTop) {
+            const where = item.repo ? gray(`  (${repoLabel(item.repo)})`) : '';
+            out(`    ${dim(pad(String(item.score), 4, 'right'))}  ${item.title}${where}`);
+        }
+        out('');
+    }
+    // Effectiveness headline (M26).
+    if (p.effectiveness) {
+        out('  ' + bold('Effectiveness') + gray(` — ${p.effectiveness.headline}`));
+        out('');
+    }
+    // "Today" day-over-day deltas vs the previous digest.
+    const t = p.today;
+    if (t.previousAt) {
+        out('  ' + bold('Today') + gray(` (vs ${t.previousAt})`));
+        out(`    ${cyan(pad('Pending', 14))}  ${signedDelta(t.pendingProposalsDelta)}`);
+        out(`    ${cyan(pad('Dirty repos', 14))}  ${signedDelta(t.dirtyReposDelta)}`);
+        out(`    ${cyan(pad('Spend', 14))}  ${signedDelta(t.spendUsdDelta, 4)}`);
+        out(`    ${cyan(pad('Health score', 14))}  ${signedDelta(t.healthScoreDelta)}`);
+        out(`    ${cyan(pad('Goals', 14))}  ${signedDelta(t.goalsInFlightDelta)}`);
+        out('');
+    }
+    else {
+        out(dim('  No prior digest yet — day-over-day deltas appear from the next run.'));
+        out('');
+    }
+    // Optional narrative (present only when explicitly requested + reachable).
+    if (report.narrative) {
+        out('  ' + bold('Summary') + (report.narrativeLocal ? gray(' (local model)') : ''));
+        for (const line of report.narrative.split('\n'))
+            out('    ' + line);
+        out('');
+    }
+}
+// ─── Main export ─────────────────────────────────────────────────────────────
+/**
+ * `ashlr digest [--window <7d|30d>] [--json] [--notify] [--allow-cloud]`
+ *
+ * Default path: build the digest (deterministic, read-only), ALWAYS write the
+ * local artifact under ~/.ashlr/digests/, and print it. `--notify` is the ONLY
+ * outward path and is OPT-IN. `--allow-cloud` permits a CLOUD model for the
+ * optional narrative (off by default; local-only otherwise).
+ *
+ * Exit codes: 0 success, 1 runtime error, 2 bad usage.
+ */
+export async function cmdDigest(args) {
+    const parsed = parseDigestArgs(args);
+    if (parsed.help) {
+        printHelp();
+        return 0;
+    }
+    if (parsed.error) {
+        process.stderr.write('error: ' + parsed.error + '\n');
+        process.stderr.write('Run `ashlr digest --help` for usage.\n');
+        return 2;
+    }
+    const tty = isTty();
+    const { red, yellow, green, dim, gray, cyan } = makeColors(tty);
+    const core = await importCore();
+    if (!core) {
+        process.stderr.write(red('error: ') +
+            'digest command requires src/core/digest/* (M29 modules not yet built).\n');
+        return 1;
+    }
+    // Privacy notice for --allow-cloud (mirrors reflect.ts / health.ts). Only the
+    // OPTIONAL narrative can ever touch a model; all digest numbers are local.
+    // Suppressed under --json so the JSON payload on stdout stays clean (the
+    // warning goes to stderr regardless, but we keep parity with reflect.ts).
+    if (parsed.narrative && parsed.allowCloud && !parsed.json) {
+        process.stderr.write(yellow('warning: ') +
+            '--narrative + --allow-cloud are set — the OPTIONAL digest narrative MAY be synthesized by a cloud model.\n' +
+            '         All digest figures are always computed locally. Omit --allow-cloud to keep the narrative on-machine.\n');
+    }
+    const cfg = core.loadConfig();
+    // 1. Build the digest — deterministic, READ-ONLY aggregation. buildDigest
+    //    never throws (degrades to a zeroed report), but guard defensively so a
+    //    surprise rejection surfaces as exit 1 rather than an unhandled rejection.
+    let report;
+    try {
+        report = await core.buildDigest(cfg, {
+            window: parsed.window,
+            narrative: parsed.narrative,
+            allowCloud: parsed.allowCloud,
+        });
+    }
+    catch (err) {
+        process.stderr.write(red('error: ') + (err instanceof Error ? err.message : String(err)) + '\n');
+        return 1;
+    }
+    // 2. Deliver — ALWAYS writes the LOCAL artifact under ~/.ashlr/digests/. The
+    //    notify() webhook is the SINGLE outward path and is reached ONLY when the
+    //    user explicitly passed --notify (opt-in). deliverDigest never throws.
+    let result;
+    try {
+        result = await core.deliverDigest(report, cfg, { notify: parsed.notify });
+    }
+    catch (err) {
+        process.stderr.write(red('error: ') + (err instanceof Error ? err.message : String(err)) + '\n');
+        return 1;
+    }
+    // 3. Output the report itself.
+    if (parsed.json) {
+        process.stdout.write(JSON.stringify(report) + '\n');
+    }
+    else {
+        printDigestHuman(report);
+    }
+    // 4. Surface what delivery actually did (human mode only — JSON callers read
+    //    `result` is not part of the report payload, so we keep stdout clean).
+    if (!parsed.json) {
+        const out = (s = '') => process.stdout.write(s + '\n');
+        if (result.jsonPath) {
+            out('  ' + gray('Saved ') + cyan(result.jsonPath));
+        }
+        else {
+            out('  ' + yellow('warning: ') + dim('could not write the local digest artifact.'));
+        }
+        if (parsed.notify) {
+            // --notify was opted in. notify() is itself a strict no-op (returns false,
+            // ZERO network calls) when no webhook is configured — surface that plainly
+            // so the user knows nothing went outward.
+            if (result.notified) {
+                out('  ' + green('✓ ') + dim('delivered via the configured webhook.'));
+            }
+            else {
+                out('  ' + dim('--notify was set but no webhook is configured — nothing was sent (local-only).'));
+            }
+        }
+        else {
+            out('  ' + dim('Local only — pass ') + cyan('--notify') + dim(' to also send via a configured webhook.'));
+        }
+        out('');
+    }
+    return 0;
+}
+//# sourceMappingURL=digest.js.map

package/dist/cli/digest.js.map

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

package/dist/cli/doctor-init.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CLI handlers for `ashlr doctor` and `ashlr init`.
+ *
+ * doctor — one-glance health report (color terminal output or --json).
+ *          --fix applies safe, local, non-destructive remediations via
+ *          fixDoctor(); --fix --json emits FixAction[].
+ * init   — full idempotent onboarding via onboard(). NON-TTY safe: no prompts
+ *          when stdin is not a TTY. --wire wires detected editors (backup-first).
+ *          --json emits OnboardResult (with doctorSummary for compat).
+ */
+/**
+ * `ashlr doctor` — print a health report. Exits 1 if any check fails.
+ *
+ * Flags:
+ *   --json   Emit the DoctorReport as JSON on stdout (no color).
+ *   --fix    Apply safe automated fixes for fixable checks, then re-run doctor.
+ *            With --json, emits FixAction[] instead of DoctorReport.
+ */
+export declare function cmdDoctor(args: string[]): Promise<number>;
+/**
+ * `ashlr init` — full idempotent onboarding via onboard().
+ *
+ * Flags:
+ *   --wire   Wire detected editors (backup-first, idempotent).
+ *   --yes    Accept all defaults (implied when stdin is not a TTY).
+ *   --json   Emit OnboardResult as JSON (with doctorSummary for compat).
+ */
+export declare function cmdInit(args: string[]): Promise<number>;