@ashlr/hub 2.2.0

package/dist/core/digest/build.js

@@ -0,0 +1,230 @@
+/**
+ * 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 { buildSnapshot } from '../dashboard.js';
+import { getActiveClient } from '../run/provider-client.js';
+import { loadPreviousDigest } from './store.js';
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+/** Default cost/forecast window when none is supplied. */
+const DEFAULT_WINDOW = '7d';
+// ---------------------------------------------------------------------------
+// Empty / zeroed defaults (never-throws degradation targets)
+// ---------------------------------------------------------------------------
+/** A zeroed portfolio section used when the snapshot lacks one. */
+function emptyPortfolio(window) {
+    // TODO(M29): single source of the empty PortfolioSummary; reused by both
+    // buildDigest (degradation) and core/dashboard.ts (initial value).
+    return {
+        health: { reposScored: 0, averageScore: 0, averageGrade: 'F', worstRepos: [] },
+        goalsInFlight: [],
+        backlogTop: [],
+        cost: { window, spentUsd: 0, localSavingsUsd: 0, projectedMonthlyUsd: 0 },
+        effectiveness: null,
+        today: emptyTodayDelta(),
+    };
+}
+/** A null-filled "today" delta block (no prior digest to compare against). */
+function emptyTodayDelta() {
+    return {
+        previousAt: null,
+        pendingProposalsDelta: null,
+        dirtyReposDelta: null,
+        spendUsdDelta: null,
+        healthScoreDelta: null,
+        goalsInFlightDelta: null,
+    };
+}
+// ---------------------------------------------------------------------------
+// buildDigest
+// ---------------------------------------------------------------------------
+/**
+ * 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 async function buildDigest(cfg, opts) {
+    const window = opts?.window ?? DEFAULT_WINDOW;
+    const generatedAt = new Date().toISOString();
+    const date = generatedAt.slice(0, 10);
+    // Step 1 — read-only snapshot (never throws; degrade to a zeroed digest).
+    let portfolio = emptyPortfolio(window);
+    let repos = { total: 0, dirty: 0, stale: 0 };
+    let pendingProposals = 0;
+    let daemon = null;
+    try {
+        const snapshot = await buildSnapshot(cfg);
+        portfolio = snapshot.portfolio ?? emptyPortfolio(window);
+        repos = snapshot.repos;
+        pendingProposals = snapshot.inbox.pending;
+        daemon = snapshot.daemon
+            ? { running: snapshot.daemon.running, todaySpentUsd: snapshot.daemon.todaySpentUsd }
+            : null;
+    }
+    catch {
+        // Degrade to zeroed digest.
+    }
+    // Steps 3-4 — day-over-day deltas vs the previous digest. The prior is loaded
+    // strictly-before `generatedAt` so a freshly-saved current digest is never
+    // compared against itself. Each delta is null when there is no prior to diff.
+    try {
+        const previous = loadPreviousDigest(generatedAt);
+        portfolio.today = computeTodayDelta({ portfolio, repos, pendingProposals }, previous);
+    }
+    catch {
+        portfolio.today = emptyTodayDelta();
+    }
+    // Step 5 — deterministic headline (templated; NO LLM).
+    const headline = composeHeadline({ portfolio, repos, pendingProposals, window });
+    // Step 6 — OPTIONAL narrative. EXPLICITLY OPT-IN (mirrors M26 reflect): no
+    // model — local OR cloud — is ever constructed unless opts.narrative === true.
+    // The DEFAULT `ashlr digest` path therefore makes ZERO model calls and ZERO
+    // non-localhost connections, even when a local provider (Ollama/LM Studio)
+    // happens to be running. When narrative IS requested, getActiveClient stays
+    // local-first: it returns a localhost provider only, unless opts.allowCloud +
+    // a cloud key. Any model error is swallowed (deterministic report preserved).
+    let narrative;
+    let narrativeLocal;
+    if (opts?.narrative === true) {
+        try {
+            const client = await getActiveClient(cfg, { allowCloud: opts?.allowCloud ?? false });
+            // ALLOWLIST (not denylist): only the known local providers count as local.
+            const isLocal = client.id === 'ollama' || client.id === 'lmstudio';
+            const res = await client.chat([
+                {
+                    role: 'system',
+                    content: 'You write a brief, factual daily engineering portfolio digest. ' +
+                        'Summarize the provided metadata in 2-3 sentences. Never invent facts ' +
+                        'or numbers beyond what is given.',
+                },
+                { role: 'user', content: buildNarrativePrompt({ portfolio, repos, pendingProposals, headline }) },
+            ]);
+            const text = (res.content ?? '').trim();
+            if (text) {
+                narrative = text;
+                narrativeLocal = isLocal;
+            }
+        }
+        catch {
+            // No reachable provider / cloud refused without key / model error — keep
+            // the deterministic report with no narrative.
+        }
+    }
+    const report = {
+        generatedAt,
+        date,
+        window,
+        portfolio,
+        repos,
+        pendingProposals,
+        daemon,
+        headline,
+    };
+    if (narrative !== undefined) {
+        report.narrative = narrative;
+        report.narrativeLocal = narrativeLocal;
+    }
+    return report;
+}
+// ---------------------------------------------------------------------------
+// Deterministic helpers (pure — no I/O, no model)
+// ---------------------------------------------------------------------------
+/** Round to a fixed number of decimals to keep deltas deterministic + tidy. */
+function round(n, dp = 2) {
+    const f = 10 ** dp;
+    return Math.round(n * f) / f;
+}
+/**
+ * Compute the day-over-day `today` delta block for the current digest vs the
+ * previous persisted digest. Each field is null when there is no prior to diff.
+ * Pure function — deterministic given the same inputs.
+ */
+function computeTodayDelta(current, previous) {
+    if (previous === null)
+        return emptyTodayDelta();
+    return {
+        previousAt: previous.generatedAt,
+        pendingProposalsDelta: current.pendingProposals - previous.pendingProposals,
+        dirtyReposDelta: current.repos.dirty - previous.repos.dirty,
+        spendUsdDelta: round(current.portfolio.cost.spentUsd - previous.portfolio.cost.spentUsd),
+        healthScoreDelta: round(current.portfolio.health.averageScore - previous.portfolio.health.averageScore),
+        goalsInFlightDelta: current.portfolio.goalsInFlight.length - previous.portfolio.goalsInFlight.length,
+    };
+}
+/**
+ * Compose the deterministic, always-present headline. Templated — NO LLM.
+ * Summarizes the org view: repos, health, in-flight goals, pending proposals,
+ * and spend over the window.
+ */
+function composeHeadline(input) {
+    const { portfolio, repos, pendingProposals, window } = input;
+    const parts = [];
+    parts.push(`${repos.total} repo${repos.total === 1 ? '' : 's'}`);
+    parts.push(`${repos.dirty} dirty`);
+    if (portfolio.health.reposScored > 0) {
+        parts.push(`health ${portfolio.health.averageGrade} (${round(portfolio.health.averageScore, 0)})`);
+    }
+    parts.push(`${portfolio.goalsInFlight.length} goal${portfolio.goalsInFlight.length === 1 ? '' : 's'} in flight`);
+    parts.push(`${pendingProposals} pending`);
+    parts.push(`$${round(portfolio.cost.spentUsd)} spent (${window})`);
+    return parts.join(' · ');
+}
+/** Build the (bounded, metadata-only) prompt for the optional narrative. */
+function buildNarrativePrompt(input) {
+    const { portfolio, repos, pendingProposals, headline } = input;
+    const goals = portfolio.goalsInFlight
+        .slice(0, 5)
+        .map((g) => `- ${g.objective} (${Math.round(g.fractionDone * 100)}%)`)
+        .join('\n');
+    return [
+        `Headline: ${headline}`,
+        `Repos: ${repos.total} total, ${repos.dirty} dirty, ${repos.stale} stale.`,
+        `Health: ${portfolio.health.reposScored} scored, avg ${round(portfolio.health.averageScore, 0)} (${portfolio.health.averageGrade}).`,
+        `Pending proposals: ${pendingProposals}.`,
+        `Spend (${portfolio.cost.window}): $${round(portfolio.cost.spentUsd)}; projected monthly $${round(portfolio.cost.projectedMonthlyUsd)}.`,
+        goals ? `Goals in flight:\n${goals}` : 'No goals in flight.',
+    ].join('\n');
+}
+//# sourceMappingURL=build.js.map

package/dist/core/digest/build.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * core/digest/deliver.ts — M29 digest rendering + delivery.
+ *
+ * renderDigestText(report) produces the human-readable (markdown) body.
+ * deliverDigest(report, cfg, opts) ALWAYS writes the local artifact (via the
+ * store) and calls notify() ONLY when opts.notify === true (opt-in).
+ *
+ * HARD SAFETY INVARIANTS (M29) enforced here:
+ *  - NO OUTWARD ACTION BY DEFAULT: deliverDigest writes a LOCAL file by default.
+ *    The ONLY outward path is notify(), reached ONLY when opts.notify === true.
+ *    notify() is itself a strict no-op unless a Slack/Discord webhook is
+ *    configured — so the default path makes ZERO outward network calls. The
+ *    verifier proves it by asserting notify is NEVER invoked unless notify:true.
+ *  - READ-ONLY AGGREGATION: the only write is the digest artifact under
+ *    ~/.ashlr/digests/ (delegated to saveDigest). Never mutates a repo, never
+ *    writes config, never applies/approves a proposal, never pushes/PRs/deploys.
+ *  - BOUNDED + NEVER-THROWS: rendering + delivery are wrapped; a failed write or
+ *    a failed notify degrades to a result flagging what happened, never throws.
+ */
+import type { AshlrConfig, DigestDeliveryResult, DigestReport } from '../types.js';
+/**
+ * Render a DigestReport as a deterministic markdown body. Pure function — no
+ * I/O, no model, no secrets. Used both for the persisted `<stem>.md` artifact
+ * and as the notify() payload when delivery is opted in.
+ *
+ * Sections: headline; repos roll-up; pending proposals; health summary (avg +
+ * worst repos); in-flight goals; top backlog; cost + forecast; effectiveness
+ * headline; the "today" day-over-day delta block; optional narrative.
+ *
+ * METADATA ONLY — every field rendered is a count/score/title/path label that
+ * already lives in the (secret-free) DigestReport. Lists are bounded upstream.
+ */
+export declare function renderDigestText(report: DigestReport): string;
+/**
+ * Deliver a digest. ALWAYS writes the local JSON + markdown artifact (via
+ * saveDigest). Calls notify() ONLY when opts.notify === true (opt-in) — that is
+ * the SINGLE outward path; everything else stops at local disk.
+ *
+ * Contract:
+ *  - NEVER throws — failures degrade into the returned DigestDeliveryResult.
+ *  - Default (no opts.notify) => `notified:false`, ZERO outward network calls.
+ *  - notify() is itself a no-op unless a webhook is configured, so even with
+ *    opts.notify:true `notified` is false when nothing is configured.
+ */
+export declare function deliverDigest(report: DigestReport, cfg: AshlrConfig, opts?: {
+    notify?: boolean;
+}): Promise<DigestDeliveryResult>;

package/dist/core/digest/deliver.js

@@ -0,0 +1,230 @@
+/**
+ * core/digest/deliver.ts — M29 digest rendering + delivery.
+ *
+ * renderDigestText(report) produces the human-readable (markdown) body.
+ * deliverDigest(report, cfg, opts) ALWAYS writes the local artifact (via the
+ * store) and calls notify() ONLY when opts.notify === true (opt-in).
+ *
+ * HARD SAFETY INVARIANTS (M29) enforced here:
+ *  - NO OUTWARD ACTION BY DEFAULT: deliverDigest writes a LOCAL file by default.
+ *    The ONLY outward path is notify(), reached ONLY when opts.notify === true.
+ *    notify() is itself a strict no-op unless a Slack/Discord webhook is
+ *    configured — so the default path makes ZERO outward network calls. The
+ *    verifier proves it by asserting notify is NEVER invoked unless notify:true.
+ *  - READ-ONLY AGGREGATION: the only write is the digest artifact under
+ *    ~/.ashlr/digests/ (delegated to saveDigest). Never mutates a repo, never
+ *    writes config, never applies/approves a proposal, never pushes/PRs/deploys.
+ *  - BOUNDED + NEVER-THROWS: rendering + delivery are wrapped; a failed write or
+ *    a failed notify degrades to a result flagging what happened, never throws.
+ */
+import { notify } from '../integrations/notify.js';
+import { saveDigest } from './store.js';
+// ---------------------------------------------------------------------------
+// Render helpers (pure, deterministic — no I/O, no model, no secrets)
+// ---------------------------------------------------------------------------
+/** Format a USD figure with two decimals, e.g. `$12.34`. */
+function usd(n) {
+    const v = Number.isFinite(n) ? n : 0;
+    return `$${v.toFixed(2)}`;
+}
+/** Format a 0..1 fraction as a whole-percent string, e.g. `73%`. */
+function pct(frac) {
+    const v = Number.isFinite(frac) ? frac : 0;
+    return `${Math.round(v * 100)}%`;
+}
+/**
+ * Render one signed "today" delta line, or null to omit it when the prior is
+ * missing (null delta) or the movement is zero (suppress noise). `digits`
+ * controls fractional precision; `money` renders the magnitude as USD.
+ */
+function deltaLine(label, value, opts) {
+    if (value === null || !Number.isFinite(value) || value === 0)
+        return null;
+    const digits = opts?.digits ?? 0;
+    const sign = value > 0 ? '+' : '-';
+    const mag = Math.abs(value);
+    const body = opts?.money ? usd(mag) : mag.toFixed(digits);
+    return `- ${label}: ${sign}${body}`;
+}
+/** Render the "today" delta block, or a single line when there is no prior. */
+function renderToday(today) {
+    if (!today.previousAt) {
+        return ['## Today', '', '- No prior digest to compare against yet.'];
+    }
+    const lines = [
+        deltaLine('Pending proposals', today.pendingProposalsDelta),
+        deltaLine('Dirty repos', today.dirtyReposDelta),
+        deltaLine('Window spend', today.spendUsdDelta, { money: true }),
+        deltaLine('Avg health score', today.healthScoreDelta, { digits: 1 }),
+        deltaLine('In-flight goals', today.goalsInFlightDelta),
+    ];
+    const movements = lines.filter((l) => l !== null);
+    const body = movements.length > 0 ? movements : ['- No material change since the prior digest.'];
+    return ['## Today', `_since ${today.previousAt}_`, '', ...body];
+}
+// ---------------------------------------------------------------------------
+// Render
+// ---------------------------------------------------------------------------
+/**
+ * Render a DigestReport as a deterministic markdown body. Pure function — no
+ * I/O, no model, no secrets. Used both for the persisted `<stem>.md` artifact
+ * and as the notify() payload when delivery is opted in.
+ *
+ * Sections: headline; repos roll-up; pending proposals; health summary (avg +
+ * worst repos); in-flight goals; top backlog; cost + forecast; effectiveness
+ * headline; the "today" day-over-day delta block; optional narrative.
+ *
+ * METADATA ONLY — every field rendered is a count/score/title/path label that
+ * already lives in the (secret-free) DigestReport. Lists are bounded upstream.
+ */
+export function renderDigestText(report) {
+    const p = report.portfolio;
+    const out = [];
+    // Header + headline.
+    out.push(`# Ashlr Digest — ${report.date}`);
+    out.push('');
+    out.push(report.headline || 'Daily portfolio digest.');
+    out.push('');
+    // Repos roll-up + pending proposals + operator.
+    out.push('## Overview');
+    out.push('');
+    out.push(`- Repos: ${report.repos.total} total, ${report.repos.dirty} dirty, ${report.repos.stale} stale`);
+    out.push(`- Pending proposals: ${report.pendingProposals}`);
+    if (report.daemon) {
+        out.push(`- Daemon: ${report.daemon.running ? 'running' : 'stopped'} (today spend ${usd(report.daemon.todaySpentUsd)})`);
+    }
+    out.push('');
+    // Health summary.
+    out.push('## Health');
+    out.push('');
+    if (p.health.reposScored > 0) {
+        out.push(`- ${p.health.reposScored} repos scored — avg ${Math.round(p.health.averageScore)} (${p.health.averageGrade})`);
+        if (p.health.worstRepos.length > 0) {
+            out.push('- Lowest scoring:');
+            for (const r of p.health.worstRepos) {
+                out.push(`  - ${r.repo}: ${Math.round(r.score)} (${r.grade})`);
+            }
+        }
+    }
+    else {
+        out.push('- No enrolled repos scored.');
+    }
+    out.push('');
+    // In-flight goals.
+    out.push('## Goals in flight');
+    out.push('');
+    if (p.goalsInFlight.length > 0) {
+        for (const g of p.goalsInFlight) {
+            const next = g.nextActionable ? ` — next: ${g.nextActionable}` : '';
+            out.push(`- ${g.objective} [${g.status}] ${pct(g.fractionDone)} (${g.proposed}/${g.totalMilestones} proposed)${next}`);
+        }
+    }
+    else {
+        out.push('- No active goals.');
+    }
+    out.push('');
+    // Top backlog.
+    out.push('## Backlog (top)');
+    out.push('');
+    if (p.backlogTop.length > 0) {
+        for (const b of p.backlogTop) {
+            const repo = b.repo ? ` (${b.repo})` : '';
+            out.push(`- [${b.score}] ${b.title}${repo}`);
+        }
+    }
+    else {
+        out.push('- Backlog empty.');
+    }
+    out.push('');
+    // Cost + forecast.
+    out.push('## Cost');
+    out.push('');
+    out.push(`- Spend (${p.cost.window}): ${usd(p.cost.spentUsd)}`);
+    out.push(`- Local savings: ${usd(p.cost.localSavingsUsd)}`);
+    out.push(`- Projected monthly: ${usd(p.cost.projectedMonthlyUsd)}`);
+    out.push('');
+    // Effectiveness headline (only when a reflection report exists).
+    if (p.effectiveness) {
+        out.push('## Effectiveness');
+        out.push('');
+        const delta = p.effectiveness.effectivenessDeltaPct === null
+            ? ''
+            : ` (${p.effectiveness.effectivenessDeltaPct >= 0 ? '+' : ''}${p.effectiveness.effectivenessDeltaPct.toFixed(1)} pts)`;
+        out.push(`- Success rate: ${pct(p.effectiveness.successRate)}${delta}`);
+        out.push(`- ${p.effectiveness.headline}`);
+        out.push('');
+    }
+    // Today day-over-day deltas.
+    out.push(...renderToday(p.today));
+    out.push('');
+    // Optional narrative (already produced by a model upstream; metadata-free text).
+    if (report.narrative) {
+        out.push('## Summary');
+        out.push('');
+        out.push(report.narrative);
+        if (report.narrativeLocal === false) {
+            out.push('');
+            out.push('_(narrative generated by a cloud model)_');
+        }
+        out.push('');
+    }
+    // Trim trailing blank lines for a clean artifact.
+    while (out.length > 0 && out[out.length - 1] === '')
+        out.pop();
+    return out.join('\n') + '\n';
+}
+// ---------------------------------------------------------------------------
+// Deliver
+// ---------------------------------------------------------------------------
+/**
+ * Deliver a digest. ALWAYS writes the local JSON + markdown artifact (via
+ * saveDigest). Calls notify() ONLY when opts.notify === true (opt-in) — that is
+ * the SINGLE outward path; everything else stops at local disk.
+ *
+ * Contract:
+ *  - NEVER throws — failures degrade into the returned DigestDeliveryResult.
+ *  - Default (no opts.notify) => `notified:false`, ZERO outward network calls.
+ *  - notify() is itself a no-op unless a webhook is configured, so even with
+ *    opts.notify:true `notified` is false when nothing is configured.
+ */
+export async function deliverDigest(report, cfg, opts) {
+    // 1. Render the deterministic markdown body (pure; no I/O, no model, no secrets).
+    let markdown = '';
+    try {
+        markdown = renderDigestText(report);
+    }
+    catch {
+        // Degrade to an empty body rather than throwing; the artifact still persists.
+        markdown = '';
+    }
+    // 2. ALWAYS write the local artifact. The store writes ONLY under digestsDir()
+    //    (~/.ashlr/digests/) via atomic tmp+rename, and is contractually non-throwing.
+    let jsonPath = null;
+    let markdownPath = null;
+    try {
+        const paths = saveDigest(report, markdown);
+        jsonPath = paths.jsonPath;
+        markdownPath = paths.markdownPath;
+    }
+    catch {
+        // Belt-and-suspenders: saveDigest already degrades internally.
+        jsonPath = null;
+        markdownPath = null;
+    }
+    // 3. Outward delivery is OPT-IN ONLY. The default path NEVER references notify(),
+    //    so it makes ZERO outward network calls. notify() is itself a strict no-op
+    //    unless a Slack/Discord webhook is configured, so even with notify:true
+    //    `notified` stays false when nothing is configured.
+    let notified = false;
+    if (opts?.notify === true) {
+        try {
+            notified = await notify(markdown, cfg);
+        }
+        catch {
+            // notify() never throws, but degrade defensively to a false outcome.
+            notified = false;
+        }
+    }
+    return { jsonPath, markdownPath, notified };
+}
+//# sourceMappingURL=deliver.js.map

package/dist/core/digest/deliver.js.map

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

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

@@ -0,0 +1,57 @@
+/**
+ * core/digest/store.ts — M29 digest artifact persistence.
+ *
+ * Pure FS layer under `~/.ashlr/digests/`. Mirrors the M26 learn store / M27
+ * quality store: atomic tmp-write + rename, never throws on reads, filename
+ * stems are epoch-ms so lexicographic order == chronological order, and the
+ * read path is bounded by MAX_DIGESTS.
+ *
+ * HARD SAFETY INVARIANTS (M29) enforced here:
+ *  - READ-ONLY AGGREGATION: this module WRITES only under digestsDir()
+ *    (~/.ashlr/digests/). It NEVER writes CONFIG_PATH, never mutates a repo
+ *    working tree, never applies/approves a proposal. The verifier proves it by
+ *    asserting every write target resolves under digestsDir().
+ *  - NO OUTWARD ACTION: persistence is local disk only. ZERO network calls.
+ *  - BOUNDED + NEVER-THROWS: every read/write is wrapped; failures degrade to
+ *    null / []. listDigests reads at most MAX_DIGESTS files.
+ *
+ * Each digest is persisted as TWO sibling artifacts sharing a stem:
+ *   <stem>.json  — the canonical DigestReport (used as the prior for deltas).
+ *   <stem>.md    — the human-readable markdown rendering (renderDigestText).
+ * The markdown is advisory; loadPreviousDigest reads only the JSON.
+ */
+import type { DigestReport } from '../types.js';
+/**
+ * Re-export of {@link digestsDir} for store-local convenience and to mirror the
+ * `reportsDir()` shape of the learn/quality stores. `~/.ashlr/digests`.
+ * Created lazily by {@link saveDigest} — this function does NOT create it.
+ */
+export declare function digestsDirPath(): string;
+/**
+ * Persist a DigestReport (JSON) + its markdown rendering under
+ * `~/.ashlr/digests/`. Atomic tmp-write + rename for each artifact.
+ *
+ * MUST NOT write anywhere outside digestsDir(). Returns the absolute paths of
+ * the artifacts written (null on failure). Never throws.
+ *
+ * @param report   the digest to persist.
+ * @param markdown the pre-rendered markdown body (from renderDigestText).
+ */
+export declare function saveDigest(report: DigestReport, markdown: string): {
+    jsonPath: string | null;
+    markdownPath: string | null;
+};
+/**
+ * List persisted DigestReport snapshots, most-recent first by `generatedAt`.
+ * Reads at most MAX_DIGESTS JSON files. Never throws; returns [] on any error
+ * and silently skips unreadable/malformed files.
+ */
+export declare function listDigests(): DigestReport[];
+/**
+ * Load the most recent previously-persisted digest (the prior used to compute
+ * day-over-day deltas), or null when none exists.
+ *
+ * `before` (optional ISO ts) excludes digests at/after it so a freshly-saved
+ * current digest is not compared against itself.
+ */
+export declare function loadPreviousDigest(before?: string): DigestReport | null;