@ashlr/hub 2.2.0

package/dist/cli/audit.js

@@ -0,0 +1,199 @@
+/**
+ * `ashlr audit` — READ-ONLY audit-trail viewer (Ashlr v2.1 MILESTONE H6, PART A).
+ *
+ * Tails the append-only JSONL audit trail (newest-first) written by
+ * `core/sandbox/audit.ts`. MUTATES NOTHING. No outward call. No model. The only
+ * thing this command does is READ `~/.ashlr/audit/<date>.jsonl` via `readAudit()`
+ * and print / filter it — see docs/contracts/CONTRACT-H6.md §A.3.
+ *
+ * H6 MOVES the viewer here from `cli/sandbox.ts` (where a minimal `cmdAudit`
+ * lived) and EXTENDS it with `--action` / `--result` / `--since` filters. The
+ * dispatcher's `loadAuditCmd` (src/cli/index.ts) is re-pointed at this module;
+ * the old `cmdAudit`/`formatAuditEntry`/`loadAuditModule` block in
+ * `cli/sandbox.ts` is removed in the implementation step.
+ *
+ * Flags (ALL read-only):
+ *   --limit N | -n N | N   Cap to the newest N records (applied AFTER filters).
+ *   --json                 Emit the records as a JSON array.
+ *   --action <verb>        Filter by action; `--action enroll` matches `enroll:*`,
+ *                          `--action kill:on` matches exactly.            [H6 NEW]
+ *   --result <ok|refused|error>  Filter by outcome.                        [H6 NEW]
+ *   --since <ISO|YYYY-MM-DD>     Drop records with ts strictly before this. [H6 NEW]
+ *
+ * Returns 0 on success, 2 on bad args (unknown flag / unparseable --since),
+ * 1 when the audit core module is not built.
+ */
+import { makeColors, isTty } from './ui.js';
+// ---------------------------------------------------------------------------
+// ANSI helpers (non-TTY safe) — same palette as cli/sandbox.ts
+// ---------------------------------------------------------------------------
+const { bold, dim, red, green, yellow } = makeColors(isTty());
+let _readAudit = undefined;
+async function loadReadAudit() {
+    if (_readAudit === undefined) {
+        try {
+            const mod = (await import('../core/sandbox/audit.js'));
+            _readAudit = mod.readAudit;
+        }
+        catch {
+            _readAudit = null;
+        }
+    }
+    return _readAudit ?? null;
+}
+function moduleNotBuilt() {
+    console.error(red('error: ') + 'audit requires src/core/sandbox/ (M21 module not yet built).');
+}
+/**
+ * Parse argv into AuditViewOptions. Returns `{ error }` for bad args so the
+ * caller can print usage + return 2 (read NOTHING — never touch disk on bad args).
+ *
+ * The action/result/since values parsed here drive the read-only post-filter in
+ * applyFilters(). See docs/contracts/CONTRACT-H6.md §A.3.
+ */
+function parseArgs(args) {
+    const opts = { json: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if ((a === '--limit' || a === '-n') && args[i + 1] !== undefined) {
+            const n = parseInt(args[i + 1], 10);
+            if (!isNaN(n) && n > 0) {
+                opts.limit = n;
+                i++;
+            }
+            else {
+                return { error: `invalid --limit value: ${args[i + 1]}` };
+            }
+        }
+        else if (a === '--json') {
+            opts.json = true;
+        }
+        else if (a === '--action' && args[i + 1] !== undefined) {
+            opts.action = args[i + 1];
+            i++;
+        }
+        else if (a === '--result' && args[i + 1] !== undefined) {
+            const v = args[i + 1];
+            if (v !== 'ok' && v !== 'refused' && v !== 'error') {
+                return { error: `invalid --result value: ${v} (expected ok|refused|error)` };
+            }
+            opts.result = v;
+            i++;
+        }
+        else if (a === '--since' && args[i + 1] !== undefined) {
+            const v = args[i + 1];
+            const ms = Date.parse(v);
+            if (isNaN(ms)) {
+                return { error: `invalid --since value: ${v} (expected ISO timestamp or YYYY-MM-DD)` };
+            }
+            opts.sinceMs = ms;
+            i++;
+        }
+        else if (/^\d+$/.test(a ?? '')) {
+            // Positional numeric shorthand: `ashlr audit 20`
+            opts.limit = parseInt(a, 10);
+        }
+        else {
+            return { error: `unknown argument: ${a}` };
+        }
+    }
+    return opts;
+}
+// ---------------------------------------------------------------------------
+// Filtering (READ-ONLY post-filter over readAudit() output)
+// ---------------------------------------------------------------------------
+/**
+ * Apply the H6 action/result/since filters to an already-loaded record list,
+ * THEN cap to `limit` (so the result is "newest N MATCHING"). Read-only — never
+ * touches disk.
+ *
+ * Filter order: action → result → since, then slice(0, limit) LAST so the
+ * result is "newest N MATCHING". See docs/contracts/CONTRACT-H6.md §A.3.
+ */
+function applyFilters(entries, opts) {
+    // READ-ONLY post-filter over readAudit()'s output — touches NO disk. Filters
+    // are applied FIRST (action → result → since), THEN `--limit` last, so the
+    // result is "the newest N records MATCHING the filters". See CONTRACT-H6 §A.3.
+    let out = entries;
+    if (opts.action !== undefined) {
+        const want = opts.action;
+        // A bare verb (no ':') matches every `verb:*` sub-action (e.g. `enroll`
+        // matches `enroll:add` + `enroll:remove`); a `verb:sub` value matches exactly.
+        const prefixMatch = !want.includes(':');
+        out = out.filter((e) => prefixMatch ? e.action === want || e.action.startsWith(`${want}:`) : e.action === want);
+    }
+    if (opts.result !== undefined) {
+        out = out.filter((e) => e.result === opts.result);
+    }
+    if (opts.sinceMs !== undefined) {
+        const floor = opts.sinceMs;
+        // Drop records whose ts is STRICTLY before the bound. An unparseable ts in a
+        // record is treated as not-after-the-floor and dropped (it cannot prove it is
+        // newer); readAudit() only yields string `ts`, so this is defensive.
+        out = out.filter((e) => {
+            const t = Date.parse(e.ts);
+            return !isNaN(t) && t >= floor;
+        });
+    }
+    // `--limit` LAST: newest-N of the already-filtered set (readAudit() is newest-first).
+    return opts.limit !== undefined ? out.slice(0, opts.limit) : out;
+}
+// ---------------------------------------------------------------------------
+// Pretty printer (non-TTY safe) — carried over from cli/sandbox.ts
+// ---------------------------------------------------------------------------
+// READ-TIME TRUST CONTRACT (H6 review finding, §A.3): this viewer prints
+// entry.summary / entry.repo / entry.sandboxId verbatim (and re-emits all fields
+// in --json) WITHOUT re-running stripSecrets on read. That is correct by design:
+// the SOLE secret-scrub enforcement point is audit() WRITE-TIME
+// (core/sandbox/audit.ts) which runs stripSecrets() over `summary` before append.
+// `repo`/`sandboxId` are METADATA-ONLY by the audit() contract (an abs repo path
+// or a sandbox id — never a token), so re-scrubbing on read would be redundant on
+// `summary` and would not cover `repo`/`sandboxId` anyway. The invariant the
+// viewer relies on: every audit() CALL SITE (current and future) MUST keep tokens
+// out of `repo`/`sandboxId`; the H6 sites pass repo=abs-path, sandboxId=null.
+function formatAuditEntry(entry) {
+    const resultColor = entry.result === 'ok'
+        ? green(entry.result)
+        : entry.result === 'refused'
+            ? yellow(entry.result)
+            : red(entry.result);
+    const ts = dim(entry.ts.replace('T', ' ').replace(/\.\d+Z$/, 'Z'));
+    const action = bold(entry.action);
+    const repo = entry.repo ? dim(` repo=${entry.repo}`) : '';
+    const sbId = entry.sandboxId ? dim(` sandbox=${entry.sandboxId}`) : '';
+    return `${ts}  [${resultColor}]  ${action}  ${entry.summary}${repo}${sbId}`;
+}
+// ---------------------------------------------------------------------------
+// cmdAudit — the command entry point
+// ---------------------------------------------------------------------------
+export async function cmdAudit(args) {
+    const parsed = parseArgs(args);
+    if ('error' in parsed) {
+        console.error(red('error: ') + parsed.error);
+        console.error(dim('Usage: ashlr audit [N | --limit N] [--json] [--action <verb>] ' +
+            '[--result ok|refused|error] [--since <ISO|YYYY-MM-DD>]'));
+        return 2;
+    }
+    const readAudit = await loadReadAudit();
+    if (!readAudit) {
+        moduleNotBuilt();
+        return 1;
+    }
+    // Read ALL records (limit is applied AFTER filtering in applyFilters), then
+    // filter read-only. readAudit() itself is unchanged + never throws.
+    const all = readAudit();
+    const entries = applyFilters(all, parsed);
+    if (parsed.json) {
+        console.log(JSON.stringify(entries, null, 2));
+        return 0;
+    }
+    if (entries.length === 0) {
+        console.log(dim('No audit entries found.'));
+        return 0;
+    }
+    for (const entry of entries) {
+        console.log(formatAuditEntry(entry));
+    }
+    return 0;
+}
+//# sourceMappingURL=audit.js.map

package/dist/cli/audit.js.map

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

package/dist/cli/backlog.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `ashlr backlog` — Work Discovery CLI (M22).
+ *
+ * Commands:
+ *   backlog              List current scored backlog (load from disk or build if missing).
+ *   backlog refresh      Re-scan all enrolled repos via buildBacklog(), then list.
+ *
+ * Flags:
+ *   --repo <path>        Filter items to a specific enrolled repo.
+ *   --source <source>    Filter by WorkSource (issue|todo|test|dep|doc|security).
+ *   --limit <n>          Cap the number of rows shown.
+ *   --json               Emit raw JSON (the full filtered Backlog object).
+ *
+ * Non-TTY safe. READ-ONLY — this CLI only reads the backlog; all mutations are
+ * performed by buildBacklog() in core/portfolio/backlog.ts (which is itself
+ * READ-ONLY with respect to the scanned repos).
+ *
+ * Enrollment-scoped: only enrolled repos are ever scanned. When no repos are
+ * enrolled (DEFAULT EMPTY) the backlog is empty and a friendly hint is shown.
+ */
+/**
+ * `ashlr backlog [refresh] [--repo <path>] [--source <src>] [--limit <n>] [--json]`
+ *
+ * Returns process exit code (0 = success, 1 = error, 2 = usage error).
+ */
+export declare function cmdBacklog(args: string[]): Promise<number>;

package/dist/cli/backlog.js

@@ -0,0 +1,322 @@
+/**
+ * `ashlr backlog` — Work Discovery CLI (M22).
+ *
+ * Commands:
+ *   backlog              List current scored backlog (load from disk or build if missing).
+ *   backlog refresh      Re-scan all enrolled repos via buildBacklog(), then list.
+ *
+ * Flags:
+ *   --repo <path>        Filter items to a specific enrolled repo.
+ *   --source <source>    Filter by WorkSource (issue|todo|test|dep|doc|security).
+ *   --limit <n>          Cap the number of rows shown.
+ *   --json               Emit raw JSON (the full filtered Backlog object).
+ *
+ * Non-TTY safe. READ-ONLY — this CLI only reads the backlog; all mutations are
+ * performed by buildBacklog() in core/portfolio/backlog.ts (which is itself
+ * READ-ONLY with respect to the scanned repos).
+ *
+ * Enrollment-scoped: only enrolled repos are ever scanned. When no repos are
+ * enrolled (DEFAULT EMPTY) the backlog is empty and a friendly hint is shown.
+ */
+import { makeColors, pad } from './ui.js';
+let _buildBacklog;
+let _loadBacklog;
+async function getBuildBacklog() {
+    if (_buildBacklog === undefined) {
+        try {
+            const mod = await import('../core/portfolio/backlog.js');
+            _buildBacklog = mod.buildBacklog;
+            _loadBacklog = mod.loadBacklog;
+        }
+        catch {
+            _buildBacklog = null;
+            _loadBacklog = null;
+        }
+    }
+    return _buildBacklog;
+}
+async function getLoadBacklog() {
+    // Ensure the module load attempt has been made.
+    await getBuildBacklog();
+    return _loadBacklog ?? null;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const SOURCE_LABELS = {
+    issue: 'issue',
+    todo: 'todo',
+    test: 'test',
+    dep: 'dep',
+    doc: 'doc',
+    security: 'security',
+    plugin: 'plugin', // M33
+};
+const SOURCE_COLORS = {
+    issue: 'blue',
+    todo: 'yellow',
+    test: 'red',
+    dep: 'magenta',
+    doc: 'cyan',
+    security: 'red',
+    plugin: 'cyan', // M33
+};
+/** Shorten an absolute repo path: replace $HOME with ~, truncate if long. */
+function shortRepo(repo) {
+    const home = process.env['HOME'] ?? '';
+    const s = home ? repo.replace(home, '~') : repo;
+    // Keep last two segments for readability.
+    const parts = s.split('/');
+    return parts.length > 3 ? '…/' + parts.slice(-2).join('/') : s;
+}
+/** Score bar: 5 filled blocks out of 5, proportional. */
+function scoreBar(score) {
+    // score = value/effort, typically 0.2..5.0
+    // Map to 0-5 blocks (each 0.2 wide steps → 1 block per integer score up to 5).
+    const filled = Math.max(0, Math.min(5, Math.round(score)));
+    return '█'.repeat(filled) + '░'.repeat(5 - filled);
+}
+/** Print the backlog as a human-readable aligned table. */
+function printTable(items, tty) {
+    const col = makeColors(tty);
+    if (items.length === 0) {
+        console.log(col.dim('  (no items)'));
+        return;
+    }
+    // Column widths (computed from data).
+    const scoreW = 7; // "  5.00 " fits; fixed
+    const barW = 5; // 5 blocks; fixed
+    const srcW = 8; // longest source is "security"
+    const repoW = Math.min(30, Math.max(10, ...items.map(i => shortRepo(i.repo).length)));
+    const veW = 6; // "V5/E5" fits
+    const titleW = Math.min(60, Math.max(10, ...items.map(i => i.title.length)));
+    // Header.
+    const hdr = [
+        col.bold(pad('SCORE', scoreW)),
+        col.bold(pad('', barW)),
+        col.bold(pad('SRC', srcW)),
+        col.bold(pad('REPO', repoW)),
+        col.bold(pad('V/E', veW)),
+        col.bold('TITLE'),
+    ].join('  ');
+    console.log('');
+    console.log('  ' + hdr);
+    console.log('  ' + col.dim('─'.repeat(scoreW + barW + srcW + repoW + veW + titleW + 10)));
+    for (const item of items) {
+        const srcColor = SOURCE_COLORS[item.source] ?? 'cyan';
+        // makeColors returns an object; access by key.
+        const colorFn = col[srcColor];
+        const scoreFmt = item.score.toFixed(2);
+        const bar = tty ? col.green(scoreBar(item.score)) : scoreBar(item.score);
+        const src = colorFn(pad(SOURCE_LABELS[item.source] ?? item.source, srcW));
+        const repo = col.dim(pad(shortRepo(item.repo), repoW));
+        const ve = col.dim(`V${item.value}/E${item.effort}`);
+        // Truncate long titles.
+        const title = item.title.length > titleW
+            ? item.title.slice(0, titleW - 1) + '…'
+            : item.title;
+        const row = [
+            col.bold(pad(scoreFmt, scoreW)),
+            bar,
+            src,
+            repo,
+            pad(ve, veW),
+            title,
+        ].join('  ');
+        console.log('  ' + row);
+    }
+    console.log('');
+}
+/** Print a brief summary line after a refresh. */
+function printSummary(repos, items, col) {
+    const counts = {};
+    for (const item of items) {
+        counts[item.source] = (counts[item.source] ?? 0) + 1;
+    }
+    const breakdown = Object.entries(counts)
+        .sort((a, b) => b[1] - a[1])
+        .map(([src, n]) => `${n} ${src}`)
+        .join(', ');
+    console.log(col.green('✓') + ' Backlog refreshed — ' +
+        col.bold(String(items.length)) + ' item' + (items.length !== 1 ? 's' : '') +
+        ' across ' + col.bold(String(repos.length)) + ' repo' + (repos.length !== 1 ? 's' : '') +
+        (breakdown ? col.dim(' (' + breakdown + ')') : ''));
+}
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+/**
+ * `ashlr backlog [refresh] [--repo <path>] [--source <src>] [--limit <n>] [--json]`
+ *
+ * Returns process exit code (0 = success, 1 = error, 2 = usage error).
+ */
+export async function cmdBacklog(args) {
+    const tty = process.stdout.isTTY === true;
+    const col = makeColors(tty);
+    // ── Parse arguments ──────────────────────────────────────────────────────
+    let subcommand = 'list';
+    let filterRepo;
+    let filterSource;
+    let limit;
+    let jsonMode = false;
+    const validSources = new Set(['issue', 'todo', 'test', 'dep', 'doc', 'security']);
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === 'refresh') {
+            subcommand = 'refresh';
+        }
+        else if (a === '--json') {
+            jsonMode = true;
+        }
+        else if (a === '--repo') {
+            filterRepo = args[++i];
+            if (!filterRepo) {
+                console.error(col.red('error: ') + '--repo requires a path argument');
+                return 2;
+            }
+        }
+        else if (a === '--source') {
+            const raw = args[++i];
+            if (!raw || !validSources.has(raw)) {
+                console.error(col.red('error: ') + `--source requires one of: ${[...validSources].join('|')}, got: ${raw ?? '(missing)'}`);
+                return 2;
+            }
+            filterSource = raw;
+        }
+        else if (a === '--limit') {
+            const raw = args[++i];
+            const n = raw !== undefined ? parseInt(raw, 10) : NaN;
+            if (isNaN(n) || n <= 0) {
+                console.error(col.red('error: ') + `--limit requires a positive integer, got: ${raw ?? '(missing)'}`);
+                return 2;
+            }
+            limit = n;
+        }
+        else if (a === 'list') {
+            // explicit 'list' subcommand — no-op, it's the default
+        }
+        else if (a?.startsWith('-')) {
+            console.error(col.red('error: ') + `Unknown flag: ${a}`);
+            console.error(col.dim('Usage: ashlr backlog [refresh] [--repo <path>] [--source <src>] [--limit <n>] [--json]'));
+            return 2;
+        }
+    }
+    // ── Load portfolio modules ───────────────────────────────────────────────
+    const buildBacklog = await getBuildBacklog();
+    const loadBacklog = await getLoadBacklog();
+    if (!buildBacklog || !loadBacklog) {
+        console.error(col.red('error: ') + 'backlog command requires src/core/portfolio/backlog.ts (M22 module not yet built).');
+        return 1;
+    }
+    // ── Execute subcommand ───────────────────────────────────────────────────
+    let backlog = null;
+    if (subcommand === 'refresh') {
+        if (!jsonMode) {
+            process.stdout.write(col.dim('Scanning enrolled repos…') + (tty ? '\r' : '\n'));
+        }
+        try {
+            backlog = await buildBacklog();
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(col.red('error: ') + msg);
+            return 1;
+        }
+        if (!jsonMode) {
+            // Clear the scanning line on TTY.
+            if (tty)
+                process.stdout.write('\x1b[2K\r');
+            printSummary(backlog.repos, backlog.items, col);
+        }
+    }
+    else {
+        // Default: list — load from disk; build if missing.
+        backlog = loadBacklog();
+        if (!backlog) {
+            if (!jsonMode) {
+                process.stdout.write(col.dim('No backlog found — building now…') + (tty ? '\r' : '\n'));
+            }
+            try {
+                backlog = await buildBacklog();
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(col.red('error: ') + msg);
+                return 1;
+            }
+            if (!jsonMode && tty) {
+                process.stdout.write('\x1b[2K\r');
+            }
+        }
+    }
+    // ── No enrolled repos ────────────────────────────────────────────────────
+    if (backlog.repos.length === 0 && backlog.items.length === 0) {
+        if (jsonMode) {
+            console.log(JSON.stringify(backlog, null, 2));
+            return 0;
+        }
+        console.log('');
+        console.log(col.yellow('No repos enrolled.'));
+        console.log(col.dim('  Enroll a repo to start discovering work:'));
+        console.log('  ' + col.cyan('ashlr enroll add <path-to-repo>'));
+        console.log('');
+        return 0;
+    }
+    // ── Apply filters ────────────────────────────────────────────────────────
+    let items = backlog.items;
+    if (filterRepo) {
+        // Normalize: support both absolute and partial matches.
+        const norm = filterRepo.replace(/\/$/, '');
+        items = items.filter(i => i.repo === norm || i.repo.endsWith('/' + norm) || i.repo.includes(norm));
+    }
+    if (filterSource) {
+        items = items.filter(i => i.source === filterSource);
+    }
+    if (limit !== undefined) {
+        items = items.slice(0, limit);
+    }
+    // ── Output ───────────────────────────────────────────────────────────────
+    if (jsonMode) {
+        const out = {
+            generatedAt: backlog.generatedAt,
+            repos: backlog.repos,
+            items,
+        };
+        console.log(JSON.stringify(out, null, 2));
+        return 0;
+    }
+    // Human-readable header.
+    const age = (() => {
+        try {
+            const ms = Date.now() - new Date(backlog.generatedAt).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 backlog.generatedAt;
+        }
+    })();
+    console.log('');
+    console.log(col.bold('  ashlr backlog') +
+        col.dim(` — ${items.length} item${items.length !== 1 ? 's' : ''}` +
+            (filterRepo || filterSource || limit !== undefined ? ' (filtered)' : '') +
+            `  ·  generated ${age}` +
+            `  ·  ${backlog.repos.length} repo${backlog.repos.length !== 1 ? 's' : ''}`));
+    printTable(items, tty);
+    if (items.length === 0 && (filterRepo || filterSource)) {
+        console.log(col.dim('  No items match the current filters.'));
+        console.log('');
+    }
+    // Hint: how to refresh.
+    if (subcommand === 'list') {
+        console.log(col.dim('  Run `ashlr backlog refresh` to re-scan.'));
+        console.log('');
+    }
+    return 0;
+}
+//# sourceMappingURL=backlog.js.map

package/dist/cli/backlog.js.map

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

package/dist/cli/completions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+/** Top-level commands (kept in sync by test/m31.cli-agent.test.ts). */
+export declare const TOP_LEVEL_COMMANDS: string[];
+export declare function cmdCompletions(args: string[]): Promise<number>;
+/**
+ * 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 declare function didYouMean(input: string): string | null;