@ashlr/hub 2.2.0

package/dist/core/dashboard.js

@@ -0,0 +1,463 @@
+/**
+ * core/dashboard.ts — M13 DashboardSnapshot aggregator.
+ *
+ * Builds a single bounded, read-only DashboardSnapshot by calling the
+ * existing data-source modules. Called on every TUI refresh tick (~2s) and
+ * by Raycast views; must be fast (<1s) and NEVER throw.
+ *
+ * MCP health strategy: discoverMcpServers() is synchronous and fast (file
+ * reads only). probeServer() is async and spawns child processes — far too
+ * slow to call on every tick. We use the discovered spec list as a
+ * "last-known configured" proxy: each server is reported ok:true, tools:0
+ * (configured but tool count unknown without probing). This keeps the
+ * snapshot bounded and sub-second while still surfacing which servers are
+ * configured.
+ *
+ * Genome strategy: we call loadGenome() directly (bounded, never-throws, no
+ * child process) and derive entry + distinct-project counts from it. We do
+ * NOT call genomeHealth() because it invokes probeEmbeddingsSync(), which
+ * runs execFileSync('curl', ...) with a ~2.5s timeout — a synchronous child
+ * spawn that would block the event loop (and thus keypress handling) on the
+ * ~2s refresh tick. loadGenome keeps the snapshot sub-second and non-blocking.
+ *
+ * All partial failures degrade to zeroed/empty fields — snapshot is always
+ * returned, never null.
+ */
+import { loadIndex } from './index-engine.js';
+import { getToolsRegistry } from './tools-registry.js';
+import { buildRollup } from './observability/rollup.js';
+import { listRuns } from './run/orchestrator.js';
+import { listSwarms } from './swarm/store.js';
+import { discoverMcpServers } from './mcp-registry.js';
+import { loadGenome } from './genome/store.js';
+import { pendingCount as inboxPendingCount } from './inbox/store.js';
+// M29: portfolio roll-up sources — all READ-ONLY + enrollment/index-scoped.
+// quality/store.loadPreviousReport (M27) reads the latest PERSISTED HealthReport
+// from ~/.ashlr/quality/ — a bounded file read, NO child process, NO network,
+// NO scan; tick-safe (we never run the live scanners here, see buildPortfolio).
+// listGoals/progressOf/nextActionableMilestone (M28) read
+// ~/.ashlr/goals. loadBacklog (M22) reads ~/.ashlr/backlog.json (no scan; null
+// when absent). buildForecast (M19) reads the local observability rollup.
+// listReports (M26) reads the latest persisted reflection snapshot.
+//
+// These are imported LAZILY (dynamic import inside each sub-block below) rather
+// than statically, so the portfolio sources never enter dashboard.ts's static
+// module graph. This (a) keeps the base buildSnapshot path lean, and (b) avoids
+// pulling a source's transitive module-load side effects (e.g. forecast.ts's
+// top-level binding off observability/rollup.js) into every existing
+// buildSnapshot test — those pre-M29 tests mock only the base sources, so a
+// static import here would crash them at module-load before any try/catch runs.
+// Each call below is wrapped in its own try/catch and degrades to its empty/
+// zeroed default; NO new disk scan is introduced, the M13 index roll-up stands.
+// M24: load daemon state for snapshot — bounded, never-throws
+// Import is a lazy dynamic require so the module resolves only at runtime;
+// if core/daemon/state.ts is absent (e.g. earlier milestone) it degrades to
+// undefined via the try/catch below.
+import { loadDaemonState } from './daemon/state.js';
+// ---------------------------------------------------------------------------
+// Caps — keep snapshot fast and memory-bounded
+// ---------------------------------------------------------------------------
+/** Max recent runs to include in the snapshot. */
+const MAX_RUNS = 8;
+/** Max recent swarms to include in the snapshot. */
+const MAX_SWARMS = 8;
+// ── M29 portfolio caps (keep the org roll-up bounded + sub-second) ──────────
+/** Max worst-scoring repos surfaced in the portfolio health summary. */
+const MAX_WORST_REPOS = 5;
+/** Max in-flight goals surfaced in the portfolio. */
+const MAX_GOALS_IN_FLIGHT = 8;
+/** Max top backlog items surfaced in the portfolio. */
+const MAX_BACKLOG_TOP = 8;
+/** Cost/forecast window used for the portfolio cost block (matches the 7d activity window). */
+const PORTFOLIO_WINDOW = '7d';
+// ---------------------------------------------------------------------------
+// M29: empty/zeroed portfolio defaults (never-throws degradation targets)
+// ---------------------------------------------------------------------------
+/** A zeroed health summary — the default on empty enrollment or M27 failure. */
+function emptyPortfolioHealth() {
+    return { reposScored: 0, averageScore: 0, averageGrade: 'F', worstRepos: [] };
+}
+/**
+ * A fully zeroed/empty PortfolioSummary. Each sub-source overwrites its own
+ * field on success; on failure the field keeps this default. The `today` delta
+ * block is left null-filled here — the snapshot has no prior to diff against;
+ * buildDigest fills it against loadPreviousDigest().
+ */
+function emptyPortfolio() {
+    return {
+        health: emptyPortfolioHealth(),
+        goalsInFlight: [],
+        backlogTop: [],
+        cost: { window: PORTFOLIO_WINDOW, spentUsd: 0, localSavingsUsd: 0, projectedMonthlyUsd: 0 },
+        effectiveness: null,
+        today: {
+            previousAt: null,
+            pendingProposalsDelta: null,
+            dirtyReposDelta: null,
+            spendUsdDelta: null,
+            healthScoreDelta: null,
+            goalsInFlightDelta: null,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// M29: portfolio aggregation — READ-ONLY org roll-up over already-local state.
+//
+// SAFETY: each sub-source is wrapped in its own try/catch (the buildSnapshot
+// model) and degrades to its empty/zeroed default; the whole block can never
+// fail the snapshot. The health source reads the latest PERSISTED snapshot only
+// (no live scan); the goals source is ENROLLMENT-SCOPED (empty enrollment =>
+// empty sections, NO portfolio disk scan). NOTHING here writes —
+// no proposal apply/approve, no config write, no repo mutation, no outward call.
+// ---------------------------------------------------------------------------
+/**
+ * Build the OPTIONAL portfolio section. Async only because each sub-source is
+ * imported lazily (dynamic import); all the source reads themselves are
+ * synchronous, bounded file reads — NO child process, NO network. NEVER throws.
+ */
+async function buildPortfolio(cfg) {
+    const portfolio = emptyPortfolio();
+    // ── Health (M27) — TICK-SAFE: read the LATEST PERSISTED snapshot, never run
+    //    the live scanners. computeReport() -> computeHealth() -> runScanners()
+    //    spawns ~6 child processes PER ENROLLED REPO (rg/grep, `npm outdated`,
+    //    `npm audit` — both NETWORK to the npm registry, `gh run list`, `find`).
+    //    buildSnapshot is invoked on EVERY ~2s TUI refresh tick, so recomputing
+    //    here would hammer the machine and silently break the "sub-1s / no child
+    //    process spawns" snapshot contract AND invariant #4 (zero non-localhost
+    //    connections on the default path). Instead we read the persisted
+    //    HealthReport (a bounded file read; no child process, no network) —
+    //    mirroring how the genome/MCP sections were made tick-safe. Empty / no
+    //    prior snapshot => reposScored:0, worstRepos:[], NO scan. The live
+    //    computeReport() is reserved for the on-demand `ashlr health` run.
+    try {
+        const { loadPreviousReport } = await import('./quality/store.js');
+        const report = loadPreviousReport();
+        const reposScored = report ? report.scores.length : 0;
+        if (report && reposScored > 0) {
+            // computeReport ranks scores worst-first; take the worst N defensively.
+            const worst = [...report.scores].sort((a, b) => a.score - b.score).slice(0, MAX_WORST_REPOS);
+            portfolio.health = {
+                reposScored,
+                averageScore: report.averageScore,
+                averageGrade: report.averageGrade,
+                worstRepos: worst.map((s) => ({ repo: s.repo, score: s.score, grade: s.grade })),
+            };
+        }
+        else {
+            portfolio.health = emptyPortfolioHealth();
+        }
+    }
+    catch {
+        portfolio.health = emptyPortfolioHealth();
+    }
+    // ── In-flight goals (M28) — active goals only, bounded; most-progressed first.
+    try {
+        const { listGoals } = await import('./goals/store.js');
+        const { progressOf, nextActionableMilestone } = await import('./goals/advance.js');
+        const active = listGoals({ status: 'active' });
+        const inFlight = [];
+        for (const goal of active) {
+            const progress = progressOf(goal);
+            const next = nextActionableMilestone(goal);
+            inFlight.push({
+                goalId: goal.id,
+                objective: goal.objective,
+                status: goal.status,
+                fractionDone: progress.fractionDone,
+                proposed: progress.proposed,
+                totalMilestones: progress.total,
+                nextActionable: next ? next.title : null,
+            });
+        }
+        inFlight.sort((a, b) => b.fractionDone - a.fractionDone);
+        portfolio.goalsInFlight = inFlight.slice(0, MAX_GOALS_IN_FLIGHT);
+    }
+    catch {
+        portfolio.goalsInFlight = [];
+    }
+    // ── Top backlog items (M22) — highest score first, bounded. null => empty.
+    try {
+        const { loadBacklog } = await import('./portfolio/backlog.js');
+        const backlog = loadBacklog();
+        if (backlog) {
+            const top = [...backlog.items]
+                .sort((a, b) => b.score - a.score)
+                .slice(0, MAX_BACKLOG_TOP)
+                .map((item) => ({
+                title: item.title,
+                repo: item.repo ?? null,
+                score: item.score,
+            }));
+            portfolio.backlogTop = top;
+        }
+    }
+    catch {
+        portfolio.backlogTop = [];
+    }
+    // ── Cost + forecast (M19) — buildForecast is synchronous + never-throws,
+    //    but wrap defensively. Reads the local observability rollup only.
+    try {
+        const { buildForecast } = await import('./observability/forecast.js');
+        const forecast = buildForecast(PORTFOLIO_WINDOW, cfg);
+        portfolio.cost = {
+            window: forecast.window,
+            spentUsd: forecast.spentUsd,
+            localSavingsUsd: forecast.localSavingsUsd,
+            projectedMonthlyUsd: forecast.projectedMonthlyUsd,
+        };
+    }
+    catch {
+        portfolio.cost = { window: PORTFOLIO_WINDOW, spentUsd: 0, localSavingsUsd: 0, projectedMonthlyUsd: 0 };
+    }
+    // ── Effectiveness headline (M26) — latest reflection report, or null.
+    try {
+        const { listReports } = await import('./learn/store.js');
+        const reports = listReports();
+        const latest = reports[0];
+        if (latest) {
+            const eff = {
+                successRate: latest.successRate,
+                effectivenessDeltaPct: latest.delta?.effectivenessPct ?? null,
+                headline: latest.delta?.headline ?? '',
+            };
+            portfolio.effectiveness = eff;
+        }
+    }
+    catch {
+        portfolio.effectiveness = null;
+    }
+    return portfolio;
+}
+// ---------------------------------------------------------------------------
+// buildSnapshot
+// ---------------------------------------------------------------------------
+/**
+ * Aggregate a DashboardSnapshot from all hub data sources.
+ *
+ * Calls: loadIndex, getToolsRegistry, buildRollup('7d'), listRuns,
+ * listSwarms, discoverMcpServers, loadGenome.
+ *
+ * Contract:
+ *  - Async (callers can await without blocking the event loop for I/O).
+ *  - NEVER throws — any failure degrades its field to zero/empty.
+ *  - Fast: all underlying calls are synchronous file reads + no child
+ *    process spawns (MCP probing is skipped; genome embedding probe is
+ *    skipped). Sub-1s on typical machines.
+ */
+export async function buildSnapshot(cfg) {
+    const generatedAt = new Date().toISOString();
+    // ── Repos roll-up (from index) ──────────────────────────────────────────
+    let reposTotal = 0;
+    let reposDirty = 0;
+    let reposStale = 0;
+    try {
+        const index = loadIndex();
+        if (index) {
+            for (const item of index.items) {
+                if (item.kind !== 'repo')
+                    continue;
+                reposTotal++;
+                if ((item.git?.dirty ?? 0) > 0)
+                    reposDirty++;
+                if (!item.active)
+                    reposStale++;
+            }
+        }
+    }
+    catch {
+        // Degrade to zeros.
+    }
+    // ── Tools roll-up ────────────────────────────────────────────────────────
+    let toolsInstalled = 0;
+    let toolsTotal = 0;
+    try {
+        const registry = getToolsRegistry();
+        toolsInstalled = registry.installedCount;
+        toolsTotal = registry.tools.length;
+    }
+    catch {
+        // Degrade to zeros.
+    }
+    // ── Activity roll-up (7d observability) ─────────────────────────────────
+    let activitySessions = 0;
+    let activityTokens = 0;
+    let activityCostUsd = 0;
+    let activityCommits = 0;
+    try {
+        const rollup = buildRollup('7d', cfg);
+        activitySessions = rollup.totals.sessions;
+        activityTokens = rollup.totals.tokensIn + rollup.totals.tokensOut;
+        activityCostUsd = rollup.totals.estCostUsd;
+        activityCommits = rollup.totals.commits;
+    }
+    catch {
+        // Degrade to zeros.
+    }
+    // ── Recent runs ─────────────────────────────────────────────────────────
+    const runs = [];
+    try {
+        const allRuns = listRuns();
+        for (const run of allRuns.slice(0, MAX_RUNS)) {
+            runs.push({
+                id: run.id,
+                goal: run.goal,
+                status: run.status,
+                tokens: (run.usage?.tokensIn ?? 0) + (run.usage?.tokensOut ?? 0),
+            });
+        }
+    }
+    catch {
+        // Degrade to empty array.
+    }
+    // ── Recent swarms ────────────────────────────────────────────────────────
+    const swarms = [];
+    try {
+        const allSwarms = listSwarms();
+        for (const swarm of allSwarms.slice(0, MAX_SWARMS)) {
+            // Compute burndown from per-task execution state.
+            const tasksDone = swarm.tasks.filter((t) => t.status === 'done' || t.status === 'skipped').length;
+            const tasksTotal = swarm.tasks.length;
+            // Current phase: the phase of the first running task, or the last
+            // non-pending phase seen (i.e. the most advanced phase in progress).
+            let currentPhase;
+            const runningTask = swarm.tasks.find((t) => t.status === 'running');
+            if (runningTask) {
+                currentPhase = runningTask.phase;
+            }
+            else {
+                // Pick the phase of the most recently completed/failed task.
+                for (let i = swarm.tasks.length - 1; i >= 0; i--) {
+                    const t = swarm.tasks[i];
+                    if (t.status === 'done' || t.status === 'failed') {
+                        currentPhase = t.phase;
+                        break;
+                    }
+                }
+            }
+            swarms.push({
+                id: swarm.id,
+                goal: swarm.goal,
+                status: swarm.status,
+                tasksDone,
+                tasksTotal,
+                ...(currentPhase !== undefined ? { phase: currentPhase } : {}),
+            });
+        }
+    }
+    catch {
+        // Degrade to empty array.
+    }
+    // ── MCP servers (discovered, not probed) ─────────────────────────────────
+    // We use the fast synchronous discovery path only. Each configured server
+    // is reported ok:true (configured = likely functional), tools:0 (unknown
+    // without spawning). This keeps the snapshot sub-second.
+    const mcp = [];
+    try {
+        const registry = discoverMcpServers();
+        for (const server of registry.servers) {
+            mcp.push({
+                name: server.name,
+                ok: true,
+                tools: 0,
+            });
+        }
+    }
+    catch {
+        // Degrade to empty array.
+    }
+    // ── Genome roll-up ───────────────────────────────────────────────────────
+    // Use the probe-free loadGenome() (bounded, never-throws, no child
+    // process) rather than genomeHealth(), which would synchronously spawn
+    // curl to probe Ollama embeddings and block the refresh/keypress loop.
+    let genomeEntries = 0;
+    let genomeProjects = 0;
+    try {
+        const entries = loadGenome(cfg);
+        genomeEntries = entries.length;
+        const projectSet = new Set();
+        for (const e of entries) {
+            if (e.project)
+                projectSet.add(e.project);
+        }
+        genomeProjects = projectSet.size;
+    }
+    catch {
+        // Degrade to zeros.
+    }
+    // ── Inbox roll-up (M23) ──────────────────────────────────────────────────
+    // pendingCount() is bounded, synchronous, never-throws — returns 0 on any
+    // error. We wrap defensively anyway since snapshot must never throw.
+    let inboxPending = 0;
+    try {
+        inboxPending = inboxPendingCount();
+    }
+    catch {
+        // Degrade to 0.
+    }
+    // ── Daemon roll-up (M24) ─────────────────────────────────────────────────
+    // loadDaemonState() is bounded, synchronous, never-throws — returns a
+    // fresh zeroed state on missing/corrupt file. We wrap defensively anyway.
+    // We reuse inboxPendingCount() already computed above for pendingProposals.
+    let daemonRunning = false;
+    let daemonSpentUsd = 0;
+    try {
+        const ds = loadDaemonState();
+        daemonRunning = ds.running;
+        daemonSpentUsd = ds.todaySpentUsd;
+    }
+    catch {
+        // Degrade to zeroed fields — daemon not yet initialised.
+    }
+    // ── M29 portfolio roll-up (OPTIONAL org view) ────────────────────────────
+    // Runs after all base sections. READ-ONLY aggregation, enrollment-scoped,
+    // never-throws — buildPortfolio wraps every sub-source and degrades to its
+    // empty/zeroed default. We still wrap the whole call defensively so the base
+    // snapshot (and all pre-M29 producers/tests) is unaffected on any failure.
+    let portfolio;
+    try {
+        portfolio = await buildPortfolio(cfg);
+    }
+    catch {
+        // Leave portfolio undefined — absent => "not populated", base snapshot intact.
+        portfolio = undefined;
+    }
+    return {
+        generatedAt,
+        repos: {
+            total: reposTotal,
+            dirty: reposDirty,
+            stale: reposStale,
+        },
+        tools: {
+            installed: toolsInstalled,
+            total: toolsTotal,
+        },
+        activity: {
+            sessions: activitySessions,
+            tokens: activityTokens,
+            estCostUsd: activityCostUsd,
+            commits: activityCommits,
+        },
+        runs,
+        swarms,
+        mcp,
+        genome: {
+            entries: genomeEntries,
+            projects: genomeProjects,
+        },
+        inbox: {
+            pending: inboxPending,
+        },
+        // M24: daemon status — READ-ONLY surface; absent == not running / no spend.
+        daemon: {
+            running: daemonRunning,
+            todaySpentUsd: daemonSpentUsd,
+            pendingProposals: inboxPending,
+        },
+        // M29: OPTIONAL portfolio section — omitted entirely when the roll-up
+        // could not be built, so existing producers/tests (which never set it)
+        // stay valid and `portfolio === undefined` reads as "not populated".
+        ...(portfolio !== undefined ? { portfolio } : {}),
+    };
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/core/dashboard.js.map

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

package/dist/core/digest/build.d.ts

@@ -0,0 +1,51 @@
+/**
+ * core/digest/build.ts — M29 deterministic daily digest builder.
+ *
+ * buildDigest(cfg, opts) computes a deterministic DAILY DIGEST from the M13/M24
+ * DashboardSnapshot (incl. its M29 `portfolio` section, populated by
+ * core/dashboard.ts) plus day-over-day deltas vs the previous persisted digest
+ * (loadPreviousDigest). An OPTIONAL LLM narrative is OFF unless opts.narrative
+ * is explicitly set; when on it routes through getActiveClient — local-only
+ * unless allowCloud + a key.
+ *
+ * HARD SAFETY INVARIANTS (M29) enforced here:
+ *  - READ-ONLY AGGREGATION: reads ONLY buildSnapshot(cfg) (which itself only
+ *    reads local state) + loadPreviousDigest() (local disk). Writes NOTHING —
+ *    persistence is deliver.ts's job. Never mutates a repo, never writes config.
+ *  - NO OUTWARD ACTION BY DEFAULT: building a digest makes ZERO non-localhost
+ *    connections on the default path. Narrative is the only egress and only when
+ *    opts.allowCloud + a cloud key; local providers are localhost-only.
+ *  - ENROLLMENT-SCOPED: the portfolio's health/goals sub-sections are sourced
+ *    from buildSnapshot, which is enrollment-scoped (empty enrollment => empty).
+ *    buildDigest introduces NO new path scan of its own.
+ *  - LOCAL-FIRST: all numeric aggregation + the headline are deterministic with
+ *    NO model. Narrative is EXPLICITLY OPT-IN (opts.narrative); the default path
+ *    constructs NO model at all (not even a reachable local one). When opted in,
+ *    it routes through getActiveClient(cfg, { allowCloud }) — local-only unless
+ *    allowCloud + a cloud key (mirror M26 reflect's `narrative` gate).
+ *  - BOUNDED + NEVER-THROWS: every step is wrapped; a missing snapshot/portfolio
+ *    degrades to a zeroed digest. List sizes are inherited from the snapshot's
+ *    already-capped portfolio lists.
+ */
+import type { AshlrConfig, DigestOptions, DigestReport } from '../types.js';
+/**
+ * Build a deterministic DigestReport for "today".
+ *
+ * Contract:
+ *  - Async; NEVER throws — any failed step degrades to its zeroed default.
+ *  - Default path (no allowCloud) makes ZERO non-localhost connections.
+ *  - Deterministic given the same snapshot + prior digest.
+ *
+ * Steps (TODO bodies):
+ *  1. snapshot = await buildSnapshot(cfg) (read-only; never throws).
+ *  2. portfolio = snapshot.portfolio ?? emptyPortfolio(window).
+ *  3. previous = loadPreviousDigest(generatedAt) — the prior day's digest.
+ *  4. Compute portfolio.today deltas vs `previous` (pending/dirty/spend/health/
+ *     goals); leave each null when there is no prior.
+ *  5. Compose the deterministic `headline` (templated; no LLM).
+ *  6. OPTIONAL narrative — ONLY when opts.narrative === true (else NO model is
+ *     constructed). Then getActiveClient(cfg, { allowCloud }) opens a provider
+ *     (local-only unless allowCloud + key); set narrative + narrativeLocal.
+ *     On any model error keep the deterministic report (no narrative).
+ */
+export declare function buildDigest(cfg: AshlrConfig, opts?: DigestOptions): Promise<DigestReport>;