instar 1.3.449 → 1.3.451

package/dist/monitoring/GrowthMilestoneAnalyst.js

@@ -0,0 +1,500 @@
+// GrowthMilestoneAnalyst — the proactive "growth & milestone" analyst.
+//
+// WHY THIS EXISTS (grounded requirement, Justin 2026-06-06, topic 21624):
+// Instar built excellent *sensors* (InitiativeTracker, FeatureRolloutReconciler,
+// ApprovalLedger, CorrectionLedger) and excellent *anti-flood plumbing* — but
+// never the *analyst layer* in between that reads the tracked data, decides what
+// crosses from noise into "a concrete milestone or realization worth telling the
+// operator," and proactively surfaces it. The result was total silence on the
+// three questions the operator actually asked:
+//   1. Are initiatives being left behind?
+//   2. Are features earning their way through the maturity path (dark → enabled)?
+//   3. Are patterns being extracted from conversation data (approve-vs-change-spec
+//      rate, correction rate)?
+//
+// THE KEY DESIGN LEVER (Justin, same conversation): the incubation/maturation
+// window must stay TIGHT — a week MAX, a few days for low-risk features — and
+// **the window EXPIRING is the trigger itself**. "Left behind" becomes
+// structurally impossible because every incubating feature carries a deadline
+// that drags it in front of the operator: either it proved itself (→ promote?)
+// or it never did (→ extend / fix / kill?).
+//
+// MATURITY HONESTY (ref keystone-dormancy #905): promotion requires real
+// proof-of-life (the feature actually fired), NOT merely elapsed time. A feature
+// that sat dark and never ran is a *kill/fix* candidate, never a *promote* one.
+//
+// THIS COMPONENT ADDS NO NEW SENSORS. It composes the existing read surfaces and
+// keeps ONE piece of minimal internal bookkeeping: a stage-observation journal,
+// because the rollout engines do not cleanly stamp "entered stage X at time T"
+// for every stage (notably `dark`). The journal records the first time we
+// observed a feature in its current stage so "days in stage" is robust.
+//
+// Spec: docs/specs/PROACTIVE-GROWTH-MILESTONE-ANALYST-SPEC.md
+// Ships DARK (monitoring.growthAnalyst.enabled defaults false). This slice
+// COMPUTES findings + exposes them via read routes; it does NOT send to Telegram.
+// Sending / cadence / enabling the muted analyzers ride later slices, behind
+// their own review (they are the flood-sensitive part).
+import fs from 'node:fs';
+import path from 'node:path';
+export const DEFAULT_GROWTH_WINDOWS = {
+    lowRisk: 3,
+    standard: 7,
+    highRisk: 7,
+};
+export const DEFAULT_GROWTH_SETTINGS = {
+    enabled: false,
+    incubationWindows: { ...DEFAULT_GROWTH_WINDOWS },
+    proofOfLifeMinActivations: 1,
+    rules: {
+        promotionReady: true,
+        incubationExpired: true,
+        initiativeStalling: true,
+        specPattern: true,
+        correctionPattern: true,
+    },
+    specPatternMinTotal: 3,
+    specPatternMinChangeRatio: 0.6,
+    correctionPatternMinOccurrences: 3,
+    digestEvenWhenCalm: true,
+};
+/** Resolve raw config (possibly partial / undefined) into fully-defaulted
+ *  settings. Pure — safe to unit test, and used by both the class and routes. */
+export function resolveGrowthSettings(raw) {
+    const r = (raw ?? {});
+    const windows = (r.incubationWindows ?? {});
+    const rules = (r.rules ?? {});
+    return {
+        enabled: r.enabled === true,
+        incubationWindows: {
+            lowRisk: numOr(windows.lowRisk, DEFAULT_GROWTH_WINDOWS.lowRisk),
+            standard: numOr(windows.standard, DEFAULT_GROWTH_WINDOWS.standard),
+            highRisk: numOr(windows.highRisk, DEFAULT_GROWTH_WINDOWS.highRisk),
+        },
+        proofOfLifeMinActivations: numOr(r.proofOfLifeMinActivations, DEFAULT_GROWTH_SETTINGS.proofOfLifeMinActivations),
+        rules: {
+            promotionReady: rules.promotionReady !== false,
+            incubationExpired: rules.incubationExpired !== false,
+            initiativeStalling: rules.initiativeStalling !== false,
+            specPattern: rules.specPattern !== false,
+            correctionPattern: rules.correctionPattern !== false,
+        },
+        specPatternMinTotal: numOr(r.specPatternMinTotal, DEFAULT_GROWTH_SETTINGS.specPatternMinTotal),
+        specPatternMinChangeRatio: numOr(r.specPatternMinChangeRatio, DEFAULT_GROWTH_SETTINGS.specPatternMinChangeRatio),
+        correctionPatternMinOccurrences: numOr(r.correctionPatternMinOccurrences, DEFAULT_GROWTH_SETTINGS.correctionPatternMinOccurrences),
+        digestEvenWhenCalm: r.digestEvenWhenCalm !== false,
+    };
+}
+function numOr(v, fallback) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : fallback;
+}
+/** Whole calendar-ish days between an ISO timestamp and `now` (fractional). */
+export function daysSince(iso, now) {
+    const then = new Date(iso).getTime();
+    if (!Number.isFinite(then))
+        return 0;
+    return (now.getTime() - then) / 86_400_000;
+}
+/** Map a feature to a risk tier. Heuristic for now (overridable later via an
+ *  explicit per-feature tag). default-on/live features that already shipped are
+ *  treated 'standard'; everything dark is 'standard' unless flagged lowRisk. */
+export function riskTierForInitiative(init) {
+    // An explicit tag on the rollout's promotionCriteria wins if present.
+    const crit = init.rollout?.promotionCriteria?.toLowerCase() ?? '';
+    if (crit.includes('low-risk') || crit.includes('lowrisk'))
+        return 'lowRisk';
+    if (crit.includes('high-risk') || crit.includes('highrisk'))
+        return 'highRisk';
+    return 'standard';
+}
+/** The core verdict. PURE. `proofCount === undefined` ⇒ no evidence source wired
+ *  ⇒ proved:'unknown' ⇒ cannot be promotion-ready (honest: never promote a
+ *  feature we can't prove ran). */
+export function classifyRollout(stage, daysInStage, windowDays, proofCount, minProof) {
+    const proved = proofCount === undefined ? 'unknown' : proofCount >= minProof;
+    if (stage === 'default-on') {
+        return { classification: 'terminal', stage, daysInStage, windowDays, proved };
+    }
+    const expired = daysInStage >= windowDays;
+    if (!expired) {
+        return { classification: 'incubating', stage, daysInStage, windowDays, proved };
+    }
+    if (proved === true) {
+        return { classification: 'promotion-ready', stage, daysInStage, windowDays, proved };
+    }
+    return { classification: 'expired-unproven', stage, daysInStage, windowDays, proved };
+}
+export class GrowthMilestoneAnalyst {
+    stateDir;
+    journalPath;
+    deps;
+    settings;
+    constructor(deps) {
+        this.deps = deps;
+        this.settings = deps.settings;
+        this.stateDir = path.join(deps.stateDir, 'state', 'growth-milestone-analyst');
+        this.journalPath = path.join(this.stateDir, 'stage-journal.json');
+        try {
+            fs.mkdirSync(this.stateDir, { recursive: true });
+        }
+        catch (err) {
+            this.deps.onError?.('mkdir', err);
+        }
+    }
+    now() {
+        return this.deps.now ? this.deps.now() : new Date();
+    }
+    isEnabled() {
+        return this.settings.enabled === true;
+    }
+    // ── Stage journal persistence ──────────────────────────────────────────
+    loadJournal() {
+        try {
+            const raw = fs.readFileSync(this.journalPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            return parsed && typeof parsed === 'object' ? parsed : {};
+        }
+        catch {
+            // @silent-fallback-ok: a missing/corrupt journal → empty, then self-heals
+            // on the next observeStages write. Observe-only analyst — never gates an
+            // action, so an empty journal only means "recompute stage clocks", not a
+            // wrong decision. (No DegradationReporter: this is expected first-run state.)
+            return {};
+        }
+    }
+    saveJournal(j) {
+        try {
+            fs.writeFileSync(this.journalPath, JSON.stringify(j, null, 2));
+        }
+        catch (err) {
+            this.deps.onError?.('saveJournal', err);
+        }
+    }
+    /**
+     * Observe the current rollout stage of every staged feature and reconcile the
+     * journal: new feature → record; stage changed → reset firstObservedAt; gone →
+     * prune. Returns the updated journal (also persisted). PUBLIC so a tick can run
+     * the observation step independently of finding computation.
+     */
+    observeStages(now = this.now()) {
+        const journal = this.loadJournal();
+        const live = new Set();
+        for (const init of this.stagedInitiatives()) {
+            const stage = init.rollout.stage;
+            live.add(init.id);
+            const prev = journal[init.id];
+            if (!prev || prev.stage !== stage) {
+                journal[init.id] = { stage, firstObservedAt: now.toISOString() };
+            }
+        }
+        // Prune features no longer staged (deleted / archived away from rollout).
+        for (const id of Object.keys(journal)) {
+            if (!live.has(id))
+                delete journal[id];
+        }
+        this.saveJournal(journal);
+        return journal;
+    }
+    stagedInitiatives() {
+        let list;
+        try {
+            list = this.deps.tracker.list();
+        }
+        catch (err) {
+            // @silent-fallback-ok: input-read failure surfaced via onError; returning
+            // [] yields a smaller digest (the safe direction) for this observe-only,
+            // never-acting component — it can never cause a wrong action.
+            this.deps.onError?.('tracker.list', err);
+            return [];
+        }
+        return list.filter((i) => i.rollout && i.rollout.stage);
+    }
+    // ── Notify-rule computation ─────────────────────────────────────────────
+    /** R1 + R2: feature maturity via the tight incubation window. */
+    computeRolloutFindings(now, journal) {
+        const findings = [];
+        const s = this.settings;
+        for (const init of this.stagedInitiatives()) {
+            const obs = journal[init.id];
+            if (!obs)
+                continue; // observeStages must run first
+            const tier = riskTierForInitiative(init);
+            const windowDays = s.incubationWindows[tier];
+            const daysInStage = daysSince(obs.firstObservedAt, now);
+            let proofCount;
+            try {
+                proofCount = this.deps.evidenceCounter?.(init);
+            }
+            catch (err) {
+                // @silent-fallback-ok: surfaced via onError; undefined → proved:'unknown',
+                // the HONEST conservative result (a feature we can't prove ran can never
+                // be promotion-ready). Never a wrong action — observe-only.
+                this.deps.onError?.('evidenceCounter', err);
+                proofCount = undefined;
+            }
+            const v = classifyRollout(init.rollout.stage, daysInStage, windowDays, proofCount, s.proofOfLifeMinActivations);
+            const rounded = Math.round(daysInStage * 10) / 10;
+            if (v.classification === 'promotion-ready' && s.rules.promotionReady) {
+                findings.push({
+                    rule: 'R1',
+                    priority: 'normal',
+                    subjectId: init.id,
+                    title: `${init.title} — ready to promote`,
+                    detail: `Incubated ${rounded}d in '${v.stage}' (window ${windowDays}d) with ${proofCount} real activation(s) and no issues. Promote to the next stage?`,
+                    suggestedAction: 'promote',
+                    stage: v.stage,
+                    daysInStage: rounded,
+                    windowDays,
+                    proved: v.proved,
+                });
+            }
+            else if (v.classification === 'expired-unproven' && s.rules.incubationExpired) {
+                const provedNote = v.proved === 'unknown'
+                    ? 'no evidence source is wired, so it cannot prove it ran'
+                    : `it has not reached ${s.proofOfLifeMinActivations} activation(s)`;
+                findings.push({
+                    rule: 'R2',
+                    priority: 'normal',
+                    subjectId: init.id,
+                    title: `${init.title} — incubation expired, unproven`,
+                    detail: `Sat in '${v.stage}' ${rounded}d (window ${windowDays}d) but ${provedNote}. Extend, fix, or kill?`,
+                    suggestedAction: 'extend-fix-kill',
+                    stage: v.stage,
+                    daysInStage: rounded,
+                    windowDays,
+                    proved: v.proved,
+                });
+            }
+        }
+        return findings;
+    }
+    /** R3: initiatives left behind — reuse the tracker's own staleness digest. */
+    computeStallingFindings(now) {
+        if (!this.settings.rules.initiativeStalling)
+            return [];
+        let items;
+        try {
+            items = this.deps.tracker.digest(now).items;
+        }
+        catch (err) {
+            // @silent-fallback-ok: input-read failure surfaced via onError; [] yields a
+            // smaller digest (safe direction) for this observe-only component.
+            this.deps.onError?.('tracker.digest', err);
+            return [];
+        }
+        const findings = [];
+        for (const it of items) {
+            if (it.reason !== 'stale' && it.reason !== 'needs-user')
+                continue;
+            findings.push({
+                rule: 'R3',
+                priority: 'normal',
+                subjectId: it.initiativeId,
+                title: `${it.title} — ${it.reason === 'needs-user' ? 'waiting on you' : 'drifting'}`,
+                detail: it.detail || (it.reason === 'needs-user' ? 'An open decision is waiting on you.' : 'No update in a while.'),
+                suggestedAction: 'review',
+            });
+        }
+        return findings;
+    }
+    /** R4: spec approve-vs-change pattern — "you keep changing X the same way." */
+    computeSpecPatternFindings() {
+        if (!this.settings.rules.specPattern || !this.deps.approvalLedger)
+            return [];
+        let summaries;
+        try {
+            summaries = this.deps.approvalLedger.summarize();
+        }
+        catch (err) {
+            // @silent-fallback-ok: input-read failure surfaced via onError; [] yields a
+            // smaller digest (safe direction) for this observe-only component.
+            this.deps.onError?.('approvalLedger.summarize', err);
+            return [];
+        }
+        const s = this.settings;
+        const findings = [];
+        for (const cs of summaries) {
+            if (cs.total < s.specPatternMinTotal)
+                continue;
+            const changeRatio = cs.total > 0 ? cs.approvedWithChange / cs.total : 0;
+            if (changeRatio < s.specPatternMinChangeRatio)
+                continue;
+            const dominant = dominantDivergence(cs.divergenceCounts);
+            if (!dominant)
+                continue;
+            findings.push({
+                rule: 'R4',
+                priority: 'low',
+                subjectId: cs.decisionClass,
+                title: `Spec pattern: '${cs.decisionClass}' keeps getting changed`,
+                detail: `${cs.approvedWithChange}/${cs.total} '${cs.decisionClass}' decisions were approved-with-change, mostly '${dominant.category}' (${dominant.count}). Bake this into the default?`,
+                suggestedAction: 'bake-in-default',
+            });
+        }
+        return findings;
+    }
+    /** R5: correction pattern — a recurring correction worth surfacing. The
+     *  CORRECTION-PREFERENCE spec owns the routing; this only SURFACES it. */
+    computeCorrectionFindings(now) {
+        if (!this.settings.rules.correctionPattern || !this.deps.correctionLedger)
+            return [];
+        let records;
+        try {
+            records = this.deps.correctionLedger.list({});
+        }
+        catch (err) {
+            // @silent-fallback-ok: input-read failure surfaced via onError; [] yields a
+            // smaller digest (safe direction) for this observe-only component.
+            this.deps.onError?.('correctionLedger.list', err);
+            return [];
+        }
+        const min = this.settings.correctionPatternMinOccurrences;
+        const findings = [];
+        for (const r of records) {
+            // Only surface still-open recurring patterns (acted-on/verified are owned
+            // by the correction loop's own lifecycle).
+            if (r.status !== 'open' && r.status !== 'reopened')
+                continue;
+            if (r.occurrenceCount < min)
+                continue;
+            findings.push({
+                rule: 'R5',
+                priority: 'low',
+                subjectId: r.dedupeKey,
+                title: `Recurring correction (${r.occurrenceCount}×)`,
+                // scrubbedSummary is the only HTTP-safe text on a correction record.
+                detail: `${r.scrubbedSummary} — recurred ${r.occurrenceCount}×. Worth a durable preference or infra fix?`,
+                suggestedAction: 'route-correction',
+            });
+        }
+        return findings;
+    }
+    /** Run the full observation + computation pass. Returns all findings. */
+    computeFindings(now = this.now()) {
+        const journal = this.observeStages(now);
+        return [
+            ...this.computeRolloutFindings(now, journal),
+            ...this.computeStallingFindings(now),
+            ...this.computeSpecPatternFindings(),
+            ...this.computeCorrectionFindings(now),
+        ];
+    }
+    /** Build the operator-facing digest. Calm digests still render so the operator
+     *  knows the analyst ran (fixes the old "near-silent → never speaks" failure). */
+    buildDigest(now = this.now()) {
+        const journal = this.observeStages(now);
+        const rollout = this.computeRolloutFindings(now, journal);
+        const stalling = this.computeStallingFindings(now);
+        const spec = this.computeSpecPatternFindings();
+        const corr = this.computeCorrectionFindings(now);
+        const findings = [...rollout, ...stalling, ...spec, ...corr];
+        const counts = {
+            incubating: this.countIncubating(now, journal),
+            promotionReady: rollout.filter((f) => f.rule === 'R1').length,
+            expiredUnproven: rollout.filter((f) => f.rule === 'R2').length,
+            stalling: stalling.length,
+            specPatterns: spec.length,
+            correctionPatterns: corr.length,
+        };
+        const nextWindowClosesInDays = this.nextWindowClose(now, journal);
+        const calm = findings.length === 0;
+        const summary = calm
+            ? this.calmSummary(counts, nextWindowClosesInDays)
+            : this.activeSummary(counts);
+        return {
+            generatedAt: now.toISOString(),
+            calm,
+            summary,
+            findings,
+            counts,
+            nextWindowClosesInDays,
+        };
+    }
+    /** Lightweight status for a GET route / dashboard. */
+    getStatus(now = this.now()) {
+        const digest = this.buildDigest(now);
+        return {
+            enabled: this.isEnabled(),
+            settings: this.settings,
+            counts: digest.counts,
+            nextWindowClosesInDays: digest.nextWindowClosesInDays,
+        };
+    }
+    // ── digest helpers ──────────────────────────────────────────────────────
+    countIncubating(now, journal) {
+        let n = 0;
+        for (const init of this.stagedInitiatives()) {
+            const obs = journal[init.id];
+            if (!obs)
+                continue;
+            const tier = riskTierForInitiative(init);
+            const windowDays = this.settings.incubationWindows[tier];
+            const v = classifyRollout(init.rollout.stage, daysSince(obs.firstObservedAt, now), windowDays, this.safeProof(init), this.settings.proofOfLifeMinActivations);
+            if (v.classification === 'incubating')
+                n++;
+        }
+        return n;
+    }
+    nextWindowClose(now, journal) {
+        let soonest;
+        for (const init of this.stagedInitiatives()) {
+            const obs = journal[init.id];
+            if (!obs)
+                continue;
+            const tier = riskTierForInitiative(init);
+            const windowDays = this.settings.incubationWindows[tier];
+            const daysInStage = daysSince(obs.firstObservedAt, now);
+            if (init.rollout.stage === 'default-on')
+                continue;
+            if (daysInStage >= windowDays)
+                continue; // already expired
+            const remaining = windowDays - daysInStage;
+            if (soonest === undefined || remaining < soonest)
+                soonest = remaining;
+        }
+        return soonest === undefined ? undefined : Math.round(soonest * 10) / 10;
+    }
+    safeProof(init) {
+        try {
+            return this.deps.evidenceCounter?.(init);
+        }
+        catch {
+            // @silent-fallback-ok: count-only helper for the calm-digest incubating
+            // tally; undefined → proved:'unknown' (the honest conservative result).
+            // Observe-only — never gates an action.
+            return undefined;
+        }
+    }
+    calmSummary(counts, nextClose) {
+        const base = `All healthy — ${counts.incubating} feature(s) incubating, nothing past its window.`;
+        if (nextClose !== undefined)
+            return `${base} Next window closes in ${nextClose}d.`;
+        return base;
+    }
+    activeSummary(counts) {
+        const parts = [];
+        if (counts.promotionReady)
+            parts.push(`${counts.promotionReady} ready to promote`);
+        if (counts.expiredUnproven)
+            parts.push(`${counts.expiredUnproven} expired-unproven`);
+        if (counts.stalling)
+            parts.push(`${counts.stalling} stalling`);
+        if (counts.specPatterns)
+            parts.push(`${counts.specPatterns} spec pattern(s)`);
+        if (counts.correctionPatterns)
+            parts.push(`${counts.correctionPatterns} correction pattern(s)`);
+        return `Growth digest: ${parts.join(', ')}.`;
+    }
+}
+/** The divergence category with the highest count (ties → first by declaration),
+ *  or null when there are no divergences at all. PURE. */
+export function dominantDivergence(counts) {
+    let best = null;
+    for (const [category, count] of Object.entries(counts)) {
+        if (count <= 0)
+            continue;
+        if (!best || count > best.count)
+            best = { category, count };
+    }
+    return best;
+}
+//# sourceMappingURL=GrowthMilestoneAnalyst.js.map

package/dist/monitoring/GrowthMilestoneAnalyst.js.map

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

package/dist/permissions/AmbientContributionGate.d.ts

@@ -54,6 +54,65 @@ export interface AmbientDecision {
     /** Optional human-readable detail (e.g. the LLM's named contribution). */
     detail?: string;
 }
+/**
+ * Observability — a bounded, in-memory record of a SINGLE silence the gate is
+ * about to return. Used only to populate the near-miss ring; never affects the
+ * decision. No message text is stored — just the channel, reason, and how close
+ * the (clamped) confidence was to the threshold.
+ */
+export interface AmbientSilenceSample {
+    /** The Slack channel the silence occurred in. */
+    channelId: string;
+    /** Why the gate stayed silent. */
+    reason: AmbientDecisionReason;
+    /**
+     * The LLM's clamped confidence for this evaluation, when one was produced
+     * (only the LLM paths carry it; the channel-not-opted-in / rate-limited /
+     * no-intelligence / llm-error / llm-unparseable paths leave it undefined).
+     */
+    confidence?: number;
+    /** Whether this silence was within `nearMissDelta` below the speak threshold. */
+    nearMiss: boolean;
+    /** When the sample was taken (gate clock). */
+    at: number;
+}
+/**
+ * Per-channel ambient observability counters + a bounded ring of recent near-miss
+ * silences. Pure aggregate — NO message content, NO per-event Telegram/topic
+ * side-effect (so it can never flood). This is the read surface the observe-only
+ * live test polls to measure the ambient gate's false-positive (wrongful-silence)
+ * and false-negative (wrongful-speak) rates. Signal-only: reading or computing it
+ * NEVER changes the speak/silence verdict.
+ */
+export interface AmbientChannelStats {
+    channelId: string;
+    /** Every shouldSpeak() call for this channel (spoke + silent). */
+    evaluated: number;
+    /** Decisions that returned speak=true. */
+    spoke: number;
+    /** Decisions that returned speak=false (the FP candidates). */
+    silent: number;
+    /**
+     * Silences where the LLM's confidence was within `nearMissDelta` BELOW the
+     * speak threshold — i.e. it nearly spoke. The highest-signal subset for tuning
+     * the confidence floor.
+     */
+    nearMissSilent: number;
+    /** Per-reason silence breakdown (channel-not-opted-in, rate-limited, …). */
+    silentByReason: Partial<Record<AmbientDecisionReason, number>>;
+}
+export interface AmbientStats {
+    /** Per-channel aggregate counters. */
+    channels: AmbientChannelStats[];
+    /** Bounded ring (most-recent-first) of recent near-miss silences for spot-inspection. */
+    recentNearMisses: AmbientSilenceSample[];
+    /** The near-miss delta in use (confidence within this far below the threshold). */
+    nearMissDelta: number;
+    /** The confidence floor a "speak" verdict must clear. */
+    minConfidence: number;
+    /** Cap on the recentNearMisses ring (bounded — no unbounded growth). */
+    ringCapacity: number;
+}
 export type AmbientDecisionReason = 'channel-not-opted-in' | 'rate-limited' | 'no-intelligence' | 'llm-error' | 'llm-unparseable' | 'llm-declined' | 'low-confidence' | 'speak';
 /** Per-channel ambient configuration. Default: ambient OFF. */
 export interface AmbientChannelConfig {
@@ -72,6 +131,18 @@ export interface AmbientChannelConfig {
      * this, the gate stays silent even if the LLM said speak. Default: 0.85 (high bar).
      */
     minConfidence?: number;
+    /**
+     * Observability only — a silence whose confidence lands within this far BELOW
+     * `minConfidence` is flagged a "near-miss" (it nearly spoke). Default: 0.1. Has
+     * NO effect on the verdict; it only classifies silences for the stats surface.
+     */
+    nearMissDelta?: number;
+    /**
+     * Observability only — cap on the in-memory ring of recent near-miss silence
+     * samples kept for spot-inspection. Bounded so the gate can never grow unbounded.
+     * Default: 50.
+     */
+    nearMissRingCapacity?: number;
 }
 export interface AmbientContributionGateDeps {
     /** Per-channel ambient configuration. Absent/empty ⇒ ambient OFF everywhere. */
@@ -110,6 +181,20 @@ export declare class AmbientContributionGate {
     private readonly timeoutMs;
     private readonly onDecision?;
     private readonly now;
+    private readonly nearMissDelta;
+    private readonly nearMissRingCapacity;
+    /**
+     * Observability — bounded, in-memory aggregate of every decision, per channel.
+     * Populated in recordDecisionStats() (called from decide() AFTER the verdict is
+     * formed), so it can never change the verdict. No message content is stored. A
+     * restart resets it; this is acceptable for an FP-rate measurement surface (the
+     * durable per-decision ledger is the file-backed /permissions/decisions). The map
+     * is keyed by channelId — bounded by the set of opted-in channels, which is small
+     * and config-controlled.
+     */
+    private readonly channelStats;
+    /** Bounded ring (newest-last) of recent near-miss silences for spot-inspection. */
+    private readonly nearMissRing;
     /**
      * Rate-limit state lives HERE — a per-channel in-memory ring of the timestamps at
      * which the gate last returned speak=true. It is recorded by recordSpoke() (called
@@ -145,5 +230,20 @@ export declare class AmbientContributionGate {
     /** Count of proactive sends within the rolling window; prunes expired entries. */
     private recentCount;
     private decide;
+    /**
+     * Update the per-channel counters and (for a near-miss silence) the bounded ring.
+     * A SILENCE is a "near-miss" when the LLM produced a confidence that fell within
+     * `nearMissDelta` BELOW the speak threshold — i.e. it nearly spoke. Paths with no
+     * confidence (not-opted-in, rate-limited, no-intelligence, llm-error, unparseable)
+     * are never near-misses. Pure in-memory; no content stored; no side-effect.
+     */
+    private recordDecisionStats;
+    /**
+     * Read-only snapshot of the bounded observability aggregate. Safe to call any time
+     * (returns copies — the caller can't mutate internal state). With no opted-in
+     * channel the gate is never consulted, so `channels` stays empty and nothing is
+     * recorded. This is the surface the observe-only live test polls.
+     */
+    getStats(): AmbientStats;
 }
 //# sourceMappingURL=AmbientContributionGate.d.ts.map