instar 1.3.34 → 1.3.36

package/dist/messaging/AgentTelegramComms.d.ts.map

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

package/dist/messaging/AgentTelegramComms.js

@@ -167,4 +167,112 @@ export class CycleDetector {
         }
     }
 }
+/**
+ * Send an agent-to-agent Telegram message. Formats the marker, calls the injected
+ * adapter, writes the sent-audit row (always — even on refusal/failure), and scrubs the
+ * bot token from any error surface before returning.
+ *
+ * Anti-loop invariant (spec §Fix 2a anti-loop #1): refuses any `role` not in the caller's
+ * `allowedRoles` set at runtime — no marker is formed, no send is attempted, an audit row
+ * is written with `result: 'role-refused'`. A role-handler that consumes role X cannot
+ * therefore send role X (the import-surface lint is a backup; this is the runtime guard).
+ */
+export async function sendAgentMessage(input, deps) {
+    const now = deps.now();
+    const a2aId = input.id ?? deps.mintId();
+    const corr = input.correlationId ?? a2aId;
+    // Runtime anti-loop guard (spec §Fix 2a anti-loop #1).
+    if (!deps.allowedRoles.has(input.role)) {
+        deps.appendAudit({
+            localTs: new Date(now).toISOString(),
+            direction: 'sent',
+            fromAgent: input.fromAgent,
+            toAgent: input.toAgent,
+            role: input.role,
+            id: a2aId,
+            corr,
+            ts: now,
+            telegramFromBotId: deps.fromBotId,
+            telegramToBotId: deps.toBotId,
+            topicId: input.toTopicId,
+            result: 'role-refused',
+            reason: `role "${input.role}" not in caller's allowedRoles`,
+        });
+        return { ok: false, a2aId, reason: `role "${input.role}" not in caller's allowedRoles` };
+    }
+    let text;
+    try {
+        text = formatMarker({ from: input.fromAgent, to: input.toAgent, role: input.role, id: a2aId, corr, ts: now }, input.message);
+    }
+    catch (err) {
+        const reason = scrubToken(err instanceof Error ? err.message : String(err), deps.botToken);
+        deps.appendAudit({
+            localTs: new Date(now).toISOString(),
+            direction: 'sent',
+            fromAgent: input.fromAgent,
+            toAgent: input.toAgent,
+            role: input.role,
+            id: a2aId,
+            corr,
+            ts: now,
+            telegramFromBotId: deps.fromBotId,
+            telegramToBotId: deps.toBotId,
+            topicId: input.toTopicId,
+            result: 'failed',
+            reason: `format: ${reason}`,
+        });
+        return { ok: false, a2aId, reason: `format: ${reason}` };
+    }
+    const result = await deps.send(input.toTopicId, text);
+    const row = {
+        localTs: new Date(now).toISOString(),
+        direction: 'sent',
+        fromAgent: input.fromAgent,
+        toAgent: input.toAgent,
+        role: input.role,
+        id: a2aId,
+        corr,
+        ts: now,
+        telegramFromBotId: deps.fromBotId,
+        telegramToBotId: deps.toBotId,
+        topicId: input.toTopicId,
+        result: result.ok ? 'ok' : 'failed',
+        sentMessageId: result.ok ? result.messageId : undefined,
+        reason: result.ok ? undefined : scrubToken(stringifyError(result.error), deps.botToken),
+    };
+    deps.appendAudit(row);
+    return result.ok
+        ? { ok: true, a2aId, sentMessageId: result.messageId }
+        : { ok: false, a2aId, reason: row.reason };
+}
+/** Stringify an unknown error without crashing on weird shapes. */
+function stringifyError(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return '[unstringifiable error]';
+    }
+}
+/** Scrub the bot token from a string so it can't leak through logs / audit / DegradationReporter
+ *  (round-2 adversarial F5: Telegram 401 response bodies sometimes echo the token). The
+ *  token is fixed-length and high-entropy enough that a literal-string replace is enough;
+ *  we strip the trailing path segment defensively in case only part is echoed. */
+export function scrubToken(s, token) {
+    if (!token)
+        return s;
+    let out = s.split(token).join('[REDACTED-BOT-TOKEN]');
+    // Telegram tokens are <bot-id>:<secret>. If only the secret appears, scrub it too.
+    const colonIdx = token.indexOf(':');
+    if (colonIdx > 0) {
+        const secret = token.slice(colonIdx + 1);
+        if (secret.length >= 16)
+            out = out.split(secret).join('[REDACTED-BOT-TOKEN]');
+    }
+    return out;
+}
 //# sourceMappingURL=AgentTelegramComms.js.map

package/dist/messaging/AgentTelegramComms.js.map

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

package/dist/monitoring/ReleaseReadinessSentinel.d.ts

@@ -0,0 +1,172 @@
+/**
+ * ReleaseReadinessSentinel — Layer B of the release-readiness-visibility spec.
+ *
+ * Watches whether a release is blocked/stalling and makes it impossible to miss.
+ * The original incident (2026-05-27): npm publishing silently stalled since
+ * v1.3.26 — green merges, green CI, no published release, no alert. The publish
+ * workflow's NEXT.md gate is a *silent skip*: a stalled release is
+ * indistinguishable from "nothing to publish". This sentinel is the missing
+ * visibility — a recurring, near-silent check that surfaces a stuck release as
+ * a single, deduped, escalating Attention item.
+ *
+ * Design (spec §4.2):
+ *   - Reads canonical `main` (FETCH_HEAD), not the local checkout, so a stale
+ *     dev branch can't produce a false "all clear".
+ *   - "Blocked" is decoupled from NEXT.md state (so Layer A's auto-draft can't
+ *     silence the alarm by clearing the file): unreleased feature/fix commits
+ *     exist AND the guide can't publish (missing/template/unreviewed), OR the
+ *     analyzer reports critical/high coverage gaps.
+ *   - Near-silent: silent below threshold (state + log only); ONE Attention
+ *     item per stall episode above it, keyed on the OLDEST unreleased commit
+ *     SHA (stable across ticks — not a resettable per-tick id), priority scaled
+ *     by backlog age, 12h hysteresis on re-raise after an auto-resolve.
+ *   - Fail-loud: any evaluation failure (fetch error, analyzer error) raises a
+ *     low-priority Attention item — never a silent catch (that would re-create
+ *     the exact bug this fixes).
+ *   - Lifecycle owner: detect → surface → auto-resolve → reap, with
+ *     resolveEpisodesInRange consulted by the publish-finalize path.
+ *   - Repo-gated: needs an analyzable instar git repo (dev/maintainer env). On
+ *     an npm-installed agent with no such repo the deps make the check inert.
+ *   - Supervision: Tier 0 (mechanical computation + fixed-template wording).
+ */
+import { EventEmitter } from 'node:events';
+/** Parsed subset of `analyze-release.js --json` the sentinel needs. */
+export interface AnalyzerReport {
+    lastTag: string;
+    commitCount: number;
+    analysis: {
+        commitClassification: {
+            features: number;
+            fixes: number;
+        };
+    };
+    guideCoverage: {
+        criticalGaps: number;
+        highGaps: number;
+    };
+}
+export interface OldestCommit {
+    sha: string;
+    dateMs: number;
+}
+export interface ReadinessEpisode {
+    /** Stable key: SHA of the oldest unreleased commit at first detection. */
+    oldestSha: string;
+    firstDetectedMs: number;
+    /** Set when an Attention item was raised (age crossed the threshold). */
+    openedMs?: number;
+    attentionId?: string;
+    lastPriority?: ReadinessPriority;
+    resolvedMs?: number;
+    resolvedReason?: 'published' | 'stale' | 'rolled-back' | 'cleared';
+}
+export interface ReadinessState {
+    episodes: ReadinessEpisode[];
+    /** Episodes resolved recently — used for the re-raise hysteresis window. */
+    recentResolves: Array<{
+        oldestSha: string;
+        resolvedMs: number;
+    }>;
+    /** Last failure-episode key we signaled, to dedupe fail-loud notices. */
+    lastFailureKey?: string;
+    lastTickAt?: number;
+    lastSignalAt?: number;
+    cacheHeadSha?: string;
+    canonicalRemoteOverridden?: boolean;
+    /** Runtime kill-switch set by POST /release-readiness/rollback. When true,
+     *  tick() no-ops without evaluating. Cleared by /release-readiness/enable. */
+    disabled?: boolean;
+    rollbackHistory?: Array<{
+        ts: number;
+        sessionId?: string;
+        sourceIp?: string;
+        reason?: string;
+    }>;
+}
+export type ReadinessPriority = 'LOW' | 'MEDIUM' | 'HIGH';
+export interface AttentionItem {
+    id: string;
+    title: string;
+    summary: string;
+    category?: string;
+    priority?: string;
+}
+export interface ReleaseReadinessSentinelDeps {
+    /** Fetch canonical main; resolve FETCH_HEAD sha. ok:false ⇒ unreachable. */
+    fetchCanonical(): Promise<{
+        ok: boolean;
+        headSha?: string;
+    }>;
+    /** Run analyze-release.js --json --ref against the canonical ref. null ⇒ error. */
+    runAnalyzer(ref: string): Promise<AnalyzerReport | null>;
+    /** Oldest unreleased feature/fix commit relative to lastTag..ref. */
+    oldestUnreleasedCommit(lastTag: string, ref: string): Promise<OldestCommit | null>;
+    /** True when the publish gate would refuse the guide (missing/template/unreviewed). */
+    guideBlocksPublish(): Promise<boolean>;
+    /** Best-effort: seed NEXT.md via Layer A (analyze-release.js --draft-guide). */
+    draftGuide(ref: string): Promise<void>;
+    /** Post an Attention item; resolves to true on delivery. */
+    postAttention(item: AttentionItem): Promise<boolean>;
+    /** Resolve an open Attention item by id. */
+    resolveAttention(id: string, reason: string): Promise<boolean>;
+    /** Load persisted state (or a fresh empty state). */
+    loadState(): ReadinessState;
+    /** Persist state atomically. */
+    saveState(state: ReadinessState): void;
+    /** Is `sha` an ancestor of `ref`? (for resolveEpisodesInRange) */
+    isAncestor(sha: string, ref: string): Promise<boolean>;
+    /** Append a structured audit line (sentinel-events.jsonl). */
+    audit(event: Record<string, unknown>): void;
+    now(): number;
+}
+export interface ReleaseReadinessSentinelConfig {
+    enabled?: boolean;
+    tickIntervalMs?: number;
+    backlogAgeDaysSilent?: number;
+    backlogAgeDaysLow?: number;
+    backlogAgeDaysMedium?: number;
+    backlogAgeDaysHigh?: number;
+    hysteresisHours?: number;
+    staleEpisodeTtlDays?: number;
+}
+export declare class ReleaseReadinessSentinel extends EventEmitter {
+    private readonly deps;
+    private readonly cfg;
+    private tickHandle;
+    constructor(deps: ReleaseReadinessSentinelDeps, cfg?: ReleaseReadinessSentinelConfig);
+    start(): void;
+    stop(): void;
+    /** Priority for a given backlog age, or null when below the silent threshold. */
+    priorityForAge(ageDays: number): ReadinessPriority | null;
+    /** The cron entry point. Top-level catch converts any error into a loud signal. */
+    tick(): Promise<void>;
+    /** Read-only snapshot of current state (for GET /release-readiness). */
+    snapshot(): ReadinessState;
+    /**
+     * Runtime kill-switch (POST /release-readiness/rollback). Disables future
+     * ticks, resolves all open Attention items, and is ITSELF loud — raises a
+     * HIGH-priority Attention item + audits — so the rollback can never be a
+     * silent way to mute the alarm (iter-3 Adversarial V5).
+     */
+    rollback(meta?: {
+        sessionId?: string;
+        sourceIp?: string;
+    }): Promise<void>;
+    /** Re-arm after a rollback. */
+    enable(): void;
+    private evaluate;
+    private isBlocked;
+    private raiseGapOnly;
+    private failLoud;
+    private resolveAll;
+    /**
+     * Called by the publish-finalize path (and the /rollback route via 'rolled-back').
+     * Resolves every open episode whose oldestSha is an ancestor of newTagSha —
+     * correct even when the oldest-unreleased SHA churned during the open window.
+     */
+    resolveEpisodesInRange(newTagSha: string, reason?: ReadinessEpisode['resolvedReason']): Promise<void>;
+    /** TTL-reap episodes/resolves so state doesn't grow unbounded. */
+    private reap;
+    static emptyState(): ReadinessState;
+}
+//# sourceMappingURL=ReleaseReadinessSentinel.d.ts.map

package/dist/monitoring/ReleaseReadinessSentinel.d.ts.map

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

package/dist/monitoring/ReleaseReadinessSentinel.js

@@ -0,0 +1,315 @@
+/**
+ * ReleaseReadinessSentinel — Layer B of the release-readiness-visibility spec.
+ *
+ * Watches whether a release is blocked/stalling and makes it impossible to miss.
+ * The original incident (2026-05-27): npm publishing silently stalled since
+ * v1.3.26 — green merges, green CI, no published release, no alert. The publish
+ * workflow's NEXT.md gate is a *silent skip*: a stalled release is
+ * indistinguishable from "nothing to publish". This sentinel is the missing
+ * visibility — a recurring, near-silent check that surfaces a stuck release as
+ * a single, deduped, escalating Attention item.
+ *
+ * Design (spec §4.2):
+ *   - Reads canonical `main` (FETCH_HEAD), not the local checkout, so a stale
+ *     dev branch can't produce a false "all clear".
+ *   - "Blocked" is decoupled from NEXT.md state (so Layer A's auto-draft can't
+ *     silence the alarm by clearing the file): unreleased feature/fix commits
+ *     exist AND the guide can't publish (missing/template/unreviewed), OR the
+ *     analyzer reports critical/high coverage gaps.
+ *   - Near-silent: silent below threshold (state + log only); ONE Attention
+ *     item per stall episode above it, keyed on the OLDEST unreleased commit
+ *     SHA (stable across ticks — not a resettable per-tick id), priority scaled
+ *     by backlog age, 12h hysteresis on re-raise after an auto-resolve.
+ *   - Fail-loud: any evaluation failure (fetch error, analyzer error) raises a
+ *     low-priority Attention item — never a silent catch (that would re-create
+ *     the exact bug this fixes).
+ *   - Lifecycle owner: detect → surface → auto-resolve → reap, with
+ *     resolveEpisodesInRange consulted by the publish-finalize path.
+ *   - Repo-gated: needs an analyzable instar git repo (dev/maintainer env). On
+ *     an npm-installed agent with no such repo the deps make the check inert.
+ *   - Supervision: Tier 0 (mechanical computation + fixed-template wording).
+ */
+import { EventEmitter } from 'node:events';
+const DEFAULTS = {
+    enabled: false,
+    tickIntervalMs: 6 * 60 * 60 * 1000, // 6h
+    backlogAgeDaysSilent: 2,
+    backlogAgeDaysLow: 2,
+    backlogAgeDaysMedium: 4,
+    backlogAgeDaysHigh: 7,
+    hysteresisHours: 12,
+    staleEpisodeTtlDays: 30,
+};
+const DAY_MS = 24 * 60 * 60 * 1000;
+const HOUR_MS = 60 * 60 * 1000;
+export class ReleaseReadinessSentinel extends EventEmitter {
+    deps;
+    cfg;
+    tickHandle = null;
+    constructor(deps, cfg = {}) {
+        super();
+        this.deps = deps;
+        this.cfg = { ...DEFAULTS, ...cfg };
+    }
+    start() {
+        if (!this.cfg.enabled || this.tickHandle)
+            return;
+        this.tickHandle = setInterval(() => {
+            void this.tick();
+        }, this.cfg.tickIntervalMs);
+        if (typeof this.tickHandle.unref === 'function')
+            this.tickHandle.unref();
+    }
+    stop() {
+        if (this.tickHandle) {
+            clearInterval(this.tickHandle);
+            this.tickHandle = null;
+        }
+    }
+    /** Priority for a given backlog age, or null when below the silent threshold. */
+    priorityForAge(ageDays) {
+        if (ageDays >= this.cfg.backlogAgeDaysHigh)
+            return 'HIGH';
+        if (ageDays >= this.cfg.backlogAgeDaysMedium)
+            return 'MEDIUM';
+        if (ageDays >= this.cfg.backlogAgeDaysLow)
+            return 'LOW';
+        return null;
+    }
+    /** The cron entry point. Top-level catch converts any error into a loud signal. */
+    async tick() {
+        const state = this.deps.loadState();
+        state.lastTickAt = this.deps.now();
+        if (state.disabled) {
+            this.deps.audit({ kind: 'release-readiness', event: 'tick-skipped-disabled' });
+            this.deps.saveState(state);
+            return;
+        }
+        try {
+            await this.evaluate(state);
+            this.deps.saveState(state);
+        }
+        catch (err) {
+            // Fail-loud — a silent catch here would re-create the very silent-failure
+            // bug this sentinel exists to fix.
+            await this.failLoud(state, 'tick', err);
+            this.deps.saveState(state);
+        }
+    }
+    /** Read-only snapshot of current state (for GET /release-readiness). */
+    snapshot() {
+        return this.deps.loadState();
+    }
+    /**
+     * Runtime kill-switch (POST /release-readiness/rollback). Disables future
+     * ticks, resolves all open Attention items, and is ITSELF loud — raises a
+     * HIGH-priority Attention item + audits — so the rollback can never be a
+     * silent way to mute the alarm (iter-3 Adversarial V5).
+     */
+    async rollback(meta = {}) {
+        const state = this.deps.loadState();
+        state.disabled = true;
+        await this.resolveAll(state, 'rolled-back');
+        state.rollbackHistory ??= [];
+        state.rollbackHistory.push({ ts: this.deps.now(), sessionId: meta.sessionId, sourceIp: meta.sourceIp, reason: 'rollback' });
+        this.deps.audit({ kind: 'release-readiness', event: 'rollback', sessionId: meta.sessionId, sourceIp: meta.sourceIp });
+        await this.deps.postAttention({
+            id: 'release-readiness-rolled-back',
+            title: 'Release-readiness alarm disabled',
+            summary: `The release-readiness watchdog was disabled via /release-readiness/rollback${meta.sessionId ? ` by session ${meta.sessionId}` : ''} at ${new Date(this.deps.now()).toISOString()}. Re-enable via POST /release-readiness/enable.`,
+            category: 'degradation',
+            priority: 'HIGH',
+        });
+        this.deps.saveState(state);
+    }
+    /** Re-arm after a rollback. */
+    enable() {
+        const state = this.deps.loadState();
+        state.disabled = false;
+        this.deps.audit({ kind: 'release-readiness', event: 'enabled' });
+        this.deps.saveState(state);
+    }
+    async evaluate(state) {
+        const fetched = await this.deps.fetchCanonical();
+        if (!fetched.ok) {
+            await this.failLoud(state, 'fetch', new Error('canonical ref unreachable'));
+            return;
+        }
+        state.cacheHeadSha = fetched.headSha;
+        const ref = fetched.headSha ?? 'FETCH_HEAD';
+        // Keep NEXT.md seeded (Layer A). Best-effort: a draft failure is not a
+        // readiness failure.
+        try {
+            await this.deps.draftGuide(ref);
+        }
+        catch {
+            /* draft is advisory; the readiness signal below is what matters */
+        }
+        const report = await this.deps.runAnalyzer(ref);
+        if (!report) {
+            await this.failLoud(state, 'analyzer', new Error('analyze-release returned no report'));
+            return;
+        }
+        const blocked = this.isBlocked(report, await this.deps.guideBlocksPublish());
+        if (!blocked) {
+            // Backlog clear — resolve any open episodes.
+            await this.resolveAll(state, 'cleared');
+            // A successful evaluation clears any prior fail-loud episode.
+            state.lastFailureKey = undefined;
+            this.reap(state);
+            return;
+        }
+        const oldest = await this.deps.oldestUnreleasedCommit(report.lastTag, ref);
+        if (!oldest) {
+            // Blocked by coverage gaps but no datable commit — surface at LOW.
+            await this.raiseGapOnly(state, report);
+            this.reap(state);
+            return;
+        }
+        const ageDays = (this.deps.now() - oldest.dateMs) / DAY_MS;
+        const priority = this.priorityForAge(ageDays);
+        let episode = state.episodes.find((e) => e.oldestSha === oldest.sha && !e.resolvedMs);
+        if (!episode) {
+            episode = { oldestSha: oldest.sha, firstDetectedMs: this.deps.now() };
+            state.episodes.push(episode);
+        }
+        if (!priority) {
+            // Below the silent threshold — recorded, no message.
+            this.reap(state);
+            return;
+        }
+        // Hysteresis: don't re-raise the same sha within the window of a recent resolve.
+        const recent = state.recentResolves.find((r) => r.oldestSha === oldest.sha);
+        if (recent && this.deps.now() - recent.resolvedMs < this.cfg.hysteresisHours * HOUR_MS && !episode.openedMs) {
+            this.reap(state);
+            return;
+        }
+        if (!episode.openedMs || episode.lastPriority !== priority) {
+            const id = episode.attentionId ?? `release-readiness-${oldest.sha.slice(0, 12)}`;
+            const days = Math.floor(ageDays);
+            const delivered = await this.deps.postAttention({
+                id,
+                title: 'Release blocked — unreleased work is piling up',
+                summary: `${report.analysis.commitClassification.features + report.analysis.commitClassification.fixes} ` +
+                    `unreleased feature/fix commit(s) since ${report.lastTag}; oldest is ${days} day(s) old and publishing is blocked ` +
+                    `(NEXT.md needs review/coverage). Oldest commit ${oldest.sha.slice(0, 12)}.`,
+                category: 'degradation',
+                priority,
+            });
+            episode.openedMs = episode.openedMs ?? this.deps.now();
+            episode.attentionId = id;
+            episode.lastPriority = priority;
+            state.lastSignalAt = this.deps.now();
+            this.deps.audit({ kind: 'release-readiness', event: 'signal', oldestSha: oldest.sha, priority, ageDays: days, delivered });
+            this.emit('signal', { oldestSha: oldest.sha, priority });
+        }
+        this.reap(state);
+    }
+    isBlocked(report, guideBlocks) {
+        const featureOrFix = report.analysis.commitClassification.features + report.analysis.commitClassification.fixes;
+        const backlogBlocked = featureOrFix > 0 && guideBlocks;
+        const coverageBlocked = report.guideCoverage.criticalGaps + report.guideCoverage.highGaps > 0;
+        return backlogBlocked || coverageBlocked;
+    }
+    async raiseGapOnly(state, report) {
+        const id = 'release-readiness-coverage-gaps';
+        let episode = state.episodes.find((e) => e.oldestSha === id && !e.resolvedMs);
+        if (!episode) {
+            episode = { oldestSha: id, firstDetectedMs: this.deps.now() };
+            state.episodes.push(episode);
+        }
+        if (!episode.openedMs) {
+            const delivered = await this.deps.postAttention({
+                id,
+                title: 'Release blocked — upgrade-guide coverage gaps',
+                summary: `analyze-release reports ${report.guideCoverage.criticalGaps + report.guideCoverage.highGaps} critical/high coverage gap(s) in the upgrade guide. Publishing is blocked until they are addressed.`,
+                category: 'degradation',
+                priority: 'LOW',
+            });
+            episode.openedMs = this.deps.now();
+            episode.attentionId = id;
+            episode.lastPriority = 'LOW';
+            state.lastSignalAt = this.deps.now();
+            this.deps.audit({ kind: 'release-readiness', event: 'signal-gaps', delivered });
+        }
+    }
+    async failLoud(state, stage, err) {
+        const key = `failure:${stage}`;
+        this.deps.audit({ kind: 'release-readiness', event: 'eval-failed', stage, error: String(err) });
+        if (state.lastFailureKey === key)
+            return; // dedupe per failure episode
+        state.lastFailureKey = key;
+        await this.deps.postAttention({
+            id: `release-readiness-eval-failure-${stage}`,
+            title: 'Release-readiness check could not evaluate',
+            summary: `The release-readiness check failed at the "${stage}" stage: ${String(err)}. Last evaluated ${state.lastSignalAt ? new Date(state.lastSignalAt).toISOString() : 'never'}.`,
+            category: 'degradation',
+            priority: 'LOW',
+        });
+        state.lastSignalAt = this.deps.now();
+        this.emit('eval-failed', { stage });
+    }
+    async resolveAll(state, reason) {
+        for (const e of state.episodes) {
+            if (e.resolvedMs)
+                continue;
+            if (e.attentionId)
+                await this.deps.resolveAttention(e.attentionId, reason ?? 'cleared');
+            e.resolvedMs = this.deps.now();
+            e.resolvedReason = reason;
+            state.recentResolves.push({ oldestSha: e.oldestSha, resolvedMs: this.deps.now() });
+            this.deps.audit({ kind: 'release-readiness', event: 'resolved', oldestSha: e.oldestSha, reason });
+        }
+    }
+    /**
+     * Called by the publish-finalize path (and the /rollback route via 'rolled-back').
+     * Resolves every open episode whose oldestSha is an ancestor of newTagSha —
+     * correct even when the oldest-unreleased SHA churned during the open window.
+     */
+    async resolveEpisodesInRange(newTagSha, reason = 'published') {
+        const state = this.deps.loadState();
+        let changed = false;
+        for (const e of state.episodes) {
+            if (e.resolvedMs)
+                continue;
+            if (e.oldestSha.startsWith('release-readiness-'))
+                continue; // synthetic (gap) episodes
+            const ancestor = await this.deps.isAncestor(e.oldestSha, newTagSha);
+            if (ancestor) {
+                if (e.attentionId)
+                    await this.deps.resolveAttention(e.attentionId, reason ?? 'published');
+                e.resolvedMs = this.deps.now();
+                e.resolvedReason = reason;
+                state.recentResolves.push({ oldestSha: e.oldestSha, resolvedMs: this.deps.now() });
+                this.deps.audit({ kind: 'release-readiness', event: 'resolved-in-range', oldestSha: e.oldestSha, newTagSha, reason });
+                changed = true;
+            }
+        }
+        if (changed)
+            this.deps.saveState(state);
+    }
+    /** TTL-reap episodes/resolves so state doesn't grow unbounded. */
+    reap(state) {
+        const ttl = this.cfg.staleEpisodeTtlDays * DAY_MS;
+        const now = this.deps.now();
+        for (const e of state.episodes) {
+            if (!e.resolvedMs && now - e.firstDetectedMs > ttl) {
+                // Backlog vanished without a finalize (e.g. branch abandoned) — reap loudly.
+                e.resolvedMs = now;
+                e.resolvedReason = 'stale';
+                if (e.attentionId)
+                    void this.deps.resolveAttention(e.attentionId, 'stale');
+                this.deps.audit({ kind: 'release-readiness', event: 'reaped-stale', oldestSha: e.oldestSha });
+            }
+        }
+        state.episodes = state.episodes.filter((e) => !e.resolvedMs || now - (e.resolvedMs ?? 0) < ttl);
+        state.recentResolves = state.recentResolves.filter((r) => now - r.resolvedMs < this.cfg.hysteresisHours * HOUR_MS * 2);
+        if ((state.rollbackHistory?.length ?? 0) > 50) {
+            state.rollbackHistory = state.rollbackHistory.slice(-50);
+        }
+    }
+    static emptyState() {
+        return { episodes: [], recentResolves: [] };
+    }
+}
+//# sourceMappingURL=ReleaseReadinessSentinel.js.map