instar 1.3.828 → 1.3.830

package/dist/monitoring/machineCoherenceAnchors.js

@@ -0,0 +1,296 @@
+/**
+ * Machine-coherence ANCHORS — the durable, identity-independent clock layer
+ * (calm-transient-episode-alerting spec, M-P0).
+ *
+ * WHY: the confirmation engine's rowState is keyed on the N1 row identity,
+ * which EMBEDS every participant's value class — so a version advance mints a
+ * new row and wipes the clocks. The grace/ceiling/flap arms of the calm design
+ * must survive exactly that churn (plus <2-online clears, sentinel restarts,
+ * warmup, and raiser handoff), so their state lives HERE: keyed per
+ * `(dimension|key)` (NO value classes), persisted as an additive block in the
+ * episode manager's existing durable file, computed on every machine from the
+ * shared adverts.
+ *
+ * Clock model (spec M-P0): `activeSkewMs` accumulates
+ * `clamp(now − anchorLastEvaluatedAtMs, 0, K × tickMs)` and credits ONLY
+ * reconciles where the key is observed divergent AND every skew participant is
+ * present in the compared set — a suspended anchor (participant departed)
+ * freezes both the clear and the accumulator; gaps beyond K ticks are
+ * retroactively suspended time. Grace and the stall ceiling compare against
+ * `activeSkewMs`, never wall-clock-since-onset; advances can never reset it.
+ *
+ * Pure + deterministic: no I/O, no Date.now() — callers pass `nowMs`.
+ * Supervision tier: Tier 0 (deterministic bookkeeping, no LLM anywhere).
+ */
+export function emptyAnchors() {
+    return { entries: {}, calmOnsetTimestamps: [] };
+}
+export function anchorKey(dimension, key) {
+    return `${dimension}|${key}`;
+}
+const DAY_MS = 24 * 3_600_000;
+const FLAP_HISTORY_CLAMP = 64;
+/** Parse the numeric `major.minor.patch` triplet; prerelease/build ignored; null = unparseable. */
+export function parseVersionTriplet(v) {
+    const m = /^(\d+)\.(\d+)\.(\d+)/.exec(String(v ?? '').trim());
+    if (!m)
+        return null;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+/** Numeric triplet comparison: negative a<b, 0 equal, positive a>b. */
+export function compareTriplets(a, b) {
+    for (let i = 0; i < 3; i++)
+        if (a[i] !== b[i])
+            return a[i] - b[i];
+    return 0;
+}
+/**
+ * The gap-narrowing advance predicate (spec M-P0): an advance counts ONLY when
+ * the machine's version moves strictly toward the pool's max observed version —
+ * `next > prev AND next <= poolMax`. Regression, lateral, unparseable, or a
+ * jump PAST the pool max never counts.
+ */
+export function isGapNarrowingAdvance(prev, next, poolMax) {
+    if (prev === undefined)
+        return false; // first observation is a baseline, not an advance
+    const p = parseVersionTriplet(prev);
+    const n = parseVersionTriplet(next);
+    const max = parseVersionTriplet(poolMax);
+    if (!p || !n || !max)
+        return false;
+    return compareTriplets(n, p) > 0 && compareTriplets(n, max) <= 0;
+}
+/** Max observed parseable version across the compared machines ('' if none parse). */
+export function poolMaxVersion(versionsByMachine) {
+    let best = '';
+    let bestT = null;
+    for (const v of Object.values(versionsByMachine)) {
+        const t = parseVersionTriplet(v);
+        if (!t)
+            continue;
+        if (!bestT || compareTriplets(t, bestT) > 0) {
+            bestT = t;
+            best = v;
+        }
+    }
+    return best;
+}
+/**
+ * Advance the anchor block one reconcile tick. Pure: returns the (mutated-in-
+ * place) block, whether a MATERIAL change occurred (the persist dirty-check —
+ * accumulator-only drift under the 5-min bucket is NOT material), and events.
+ */
+export function reconcileAnchors(block, input) {
+    const { nowMs, tickMs, kTicks, rows, comparedMachines, versionsByMachine, resolveTicks, retireAfterMs } = input;
+    const events = [];
+    let changed = false;
+    const compared = new Set(comparedMachines);
+    const divergentByKey = new Map();
+    for (const r of rows) {
+        const k = anchorKey(r.dimension, r.key);
+        const arr = divergentByKey.get(k) ?? [];
+        arr.push(r);
+        divergentByKey.set(k, arr);
+    }
+    // ── 1. Onset / participant-union for keys divergent THIS tick ──
+    for (const [k, keyRows] of divergentByKey) {
+        let e = block.entries[k];
+        const rowParticipants = new Set();
+        for (const r of keyRows)
+            for (const p of r.participants)
+                rowParticipants.add(p);
+        if (!e) {
+            e = {
+                dimension: keyRows[0].dimension,
+                key: keyRows[0].key,
+                skewOnsetAtMs: nowMs,
+                activeSkewMs: 0,
+                anchorLastEvaluatedAtMs: nowMs,
+                participants: [...rowParticipants].sort(),
+                clearStreakTicks: 0,
+                flapHistory: [],
+                perMachine: {},
+            };
+            block.entries[k] = e;
+            changed = true;
+            events.push({ kind: 'onset', anchorKey: k });
+        }
+        else if (e.skewOnsetAtMs === 0) {
+            // Re-skew of a cleared-but-not-retired entry: fresh onset, latches + flap history survive.
+            e.skewOnsetAtMs = nowMs;
+            e.activeSkewMs = 0;
+            e.anchorLastEvaluatedAtMs = nowMs;
+            e.participants = [...rowParticipants].sort();
+            e.clearStreakTicks = 0;
+            e.absentSinceMs = undefined;
+            changed = true;
+            events.push({ kind: 'onset', anchorKey: k });
+        }
+        else {
+            // Ongoing skew: union any newly-participating machines; clear absence.
+            const before = e.participants.length;
+            const union = new Set(e.participants);
+            for (const p of rowParticipants)
+                union.add(p);
+            e.participants = [...union].sort();
+            if (e.participants.length !== before)
+                changed = true;
+            if (e.absentSinceMs !== undefined) {
+                e.absentSinceMs = undefined;
+                changed = true;
+            }
+            e.clearStreakTicks = 0;
+        }
+    }
+    // ── 2. Per-entry clock credit / clear-streak / retirement ──
+    const poolMax = poolMaxVersion(versionsByMachine);
+    for (const [k, e] of Object.entries(block.entries)) {
+        const divergentNow = divergentByKey.has(k);
+        const allParticipantsPresent = e.participants.length > 0 && e.participants.every((p) => compared.has(p));
+        const activeEpisode = e.skewOnsetAtMs !== 0;
+        // Accumulator: credit ONLY divergent-observed + all-participants-present ticks.
+        if (activeEpisode && divergentNow && allParticipantsPresent) {
+            const rawDelta = nowMs - e.anchorLastEvaluatedAtMs;
+            const credit = Math.min(Math.max(rawDelta, 0), kTicks * tickMs);
+            if (credit > 0)
+                e.activeSkewMs += credit;
+            // Dirty-check: accumulator drift persists on ≥5-min bucket boundaries only.
+            if (Math.floor((e.activeSkewMs - credit) / 300_000) !== Math.floor(e.activeSkewMs / 300_000))
+                changed = true;
+        }
+        e.anchorLastEvaluatedAtMs = nowMs;
+        // Participant-aware clear: NOT divergent + every participant present + ≥2 compared.
+        if (activeEpisode && !divergentNow) {
+            if (allParticipantsPresent && compared.size >= 2) {
+                e.clearStreakTicks += 1;
+                if (e.clearStreakTicks >= resolveTicks) {
+                    if (e.pendingFlapConfirm) {
+                        e.flapHistory.push(nowMs);
+                        e.flapHistory = e.flapHistory.filter((t) => nowMs - t < DAY_MS).slice(-FLAP_HISTORY_CLAMP);
+                        e.pendingFlapConfirm = undefined;
+                        events.push({ kind: 'flap-cycle-completed', anchorKey: k, cyclesIn24h: e.flapHistory.length });
+                    }
+                    e.skewOnsetAtMs = 0;
+                    e.activeSkewMs = 0;
+                    e.clearStreakTicks = 0;
+                    e.absentSinceMs = nowMs;
+                    changed = true;
+                    events.push({ kind: 'cleared', anchorKey: k });
+                }
+            }
+            // participant departed or <2 compared ⇒ suspended: streak frozen, never vacuous-clear.
+        }
+        // Retirement: sustained absence only (latches survive until then).
+        if (!activeEpisode && e.absentSinceMs !== undefined && nowMs - e.absentSinceMs >= retireAfterMs && !divergentNow) {
+            delete block.entries[k];
+            changed = true;
+            events.push({ kind: 'retired', anchorKey: k });
+            continue;
+        }
+        // Progress tracking (version dimension): update per-machine from adverts.
+        if (e.dimension === 'version') {
+            for (const m of comparedMachines) {
+                const v = versionsByMachine[m];
+                if (v === undefined)
+                    continue;
+                const pm = (e.perMachine[m] ??= {});
+                if (pm.lastSeenVersion !== v) {
+                    if (isGapNarrowingAdvance(pm.lastSeenVersion, v, poolMax)) {
+                        pm.lastAdvanceAtMs = nowMs;
+                        changed = true; // an observed version change is a material change
+                    }
+                    pm.lastSeenVersion = v;
+                    changed = true;
+                }
+            }
+            // Machines gone from the registry/compared set entirely for the retirement
+            // window ride the entry's own retirement; individual pruning is not needed
+            // for correctness (bounded by pool size).
+        }
+    }
+    // ── 3. Wave-backstop onset history pruning (24 h) ──
+    const beforeLen = block.calmOnsetTimestamps.length;
+    block.calmOnsetTimestamps = block.calmOnsetTimestamps.filter((t) => nowMs - t < DAY_MS);
+    if (block.calmOnsetTimestamps.length !== beforeLen)
+        changed = true;
+    return { changed, events };
+}
+/** Sentinel → anchors: a confirm transition happened on this key while skewed. */
+export function recordConfirmTransition(block, dimension, key) {
+    const e = block.entries[anchorKey(dimension, key)];
+    if (!e || e.skewOnsetAtMs === 0)
+        return false;
+    if (e.pendingFlapConfirm)
+        return false;
+    e.pendingFlapConfirm = true;
+    return true; // material change
+}
+/**
+ * Decide confirm-vs-extend for patch-only version skew (spec M-P1). Laggards =
+ * participants whose version parses BELOW the pool max; the extension applies
+ * only when EVERY laggard advanced within the window (any stalled laggard ⇒
+ * confirm — the conservative, louder direction). No anchor ⇒ fall back to the
+ * legacy grace path (fail toward today's behavior).
+ */
+export function decidePatchSkew(block, key, cfg, nowMs, versionsByMachine) {
+    const e = block.entries[anchorKey('version', key)];
+    if (!e || e.skewOnsetAtMs === 0)
+        return { confirm: false, reason: 'no-anchor' };
+    if (e.activeSkewMs < cfg.graceMs)
+        return { confirm: false, reason: 'grace' };
+    if (e.activeSkewMs >= cfg.ceilingMs)
+        return { confirm: true, reason: 'ceiling' };
+    if (!cfg.progressExtensionEnabled)
+        return { confirm: true, reason: 'no-progress' };
+    const poolMax = poolMaxVersion(versionsByMachine);
+    const maxT = parseVersionTriplet(poolMax);
+    if (!maxT)
+        return { confirm: true, reason: 'no-progress' }; // unreadable ⇒ louder
+    const laggards = e.participants.filter((m) => {
+        const t = parseVersionTriplet(versionsByMachine[m] ?? '');
+        return !t || compareTriplets(t, maxT) < 0; // unparseable counts as lagging (louder)
+    });
+    if (laggards.length === 0)
+        return { confirm: true, reason: 'no-progress' }; // divergent yet no laggard — confirm (loud)
+    const allAdvancing = laggards.every((m) => {
+        const pm = e.perMachine[m];
+        return pm?.lastAdvanceAtMs !== undefined && nowMs - pm.lastAdvanceAtMs <= cfg.progressWindowMs;
+    });
+    return allAdvancing ? { confirm: false, reason: 'extend' } : { confirm: true, reason: 'no-progress' };
+}
+/** Durable 24 h once-latch check + arm for the derived escalation raises. */
+export function tryArmDerivedLatch(block, dimension, key, which, nowMs) {
+    const e = block.entries[anchorKey(dimension, key)];
+    if (!e)
+        return false;
+    const last = which === 'stalled' ? e.lastStalledFireAtMs : e.lastRecurringFireAtMs;
+    if (last !== undefined && nowMs - last < DAY_MS)
+        return false;
+    if (which === 'stalled')
+        e.lastStalledFireAtMs = nowMs;
+    else
+        e.lastRecurringFireAtMs = nowMs;
+    return true;
+}
+/** Flap-brake trigger check: ≥threshold completed cycles in 24 h (latch NOT consumed here). */
+export function flapBrakeEligible(block, dimension, key, threshold, nowMs) {
+    const e = block.entries[anchorKey(dimension, key)];
+    if (!e)
+        return false;
+    const recent = e.flapHistory.filter((t) => nowMs - t < DAY_MS).length;
+    return recent >= threshold;
+}
+/** Record a NON-reopen calm-class onset; returns true when the wave backstop should fire (and arms its latch). */
+export function recordCalmOnsetAndCheckWave(block, nowMs, threshold) {
+    block.calmOnsetTimestamps.push(nowMs);
+    block.calmOnsetTimestamps = block.calmOnsetTimestamps.filter((t) => nowMs - t < DAY_MS);
+    if (threshold <= 0)
+        return false;
+    if (block.calmOnsetTimestamps.length < threshold)
+        return false;
+    if (block.lastWaveNoticeAtMs !== undefined && nowMs - block.lastWaveNoticeAtMs < DAY_MS)
+        return false;
+    block.lastWaveNoticeAtMs = nowMs;
+    return true;
+}
+//# sourceMappingURL=machineCoherenceAnchors.js.map

package/dist/monitoring/machineCoherenceAnchors.js.map

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

package/dist/monitoring/machineCoherenceEffectsExecutor.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Machine-coherence effects executor (calm-transient-episode-alerting M-P2).
+ *
+ * Extracted from the server.ts boot closure — the exact site of the original
+ * hardcoded-`priority: 'HIGH'` bug — into an injectable, unit-testable module.
+ * The executor is a PASS-THROUGH: priority / silent / copy decisions live in
+ * the episode manager (where dimension/stall/flap/interacted context lives);
+ * this module only carries them to the Telegram chokepoints.
+ *
+ * Fail-toward-silence: every effect executes fire-and-forget with its own
+ * catch — a Telegram fault must never crash the shared presence tick; the next
+ * reconcile re-derives from durable episode state.
+ */
+import type { EpisodeEffect } from './machineCoherenceEpisodeManager.js';
+/** The Telegram surface the executor needs (structural subset of TelegramAdapter). */
+export interface EffectsTelegram {
+    createAttentionItem(item: {
+        id: string;
+        title: string;
+        summary: string;
+        description?: string;
+        category: string;
+        priority: string;
+        sourceContext?: string;
+        silent?: boolean;
+    }): Promise<unknown>;
+    getAttentionItem(itemId: string): {
+        topicId?: number;
+    } | undefined;
+    sendToTopic(topicId: number, text: string, options?: {
+        silent?: boolean;
+    }): Promise<unknown>;
+    updateAttentionStatus(itemId: string, status: string, opts?: {
+        silent?: boolean;
+    }): Promise<boolean>;
+}
+export interface EffectsExecutorDeps {
+    /** The live adapter (null when Telegram is unavailable — effects are best-effort). */
+    telegram: () => EffectsTelegram | null;
+    /** `execute-fix` handler (the atomic config funnel lives server-side). */
+    onExecuteFix?: (eff: Extract<EpisodeEffect, {
+        kind: 'execute-fix';
+    }>) => Promise<void>;
+}
+/**
+ * Execute one batch of episode effects. Each effect runs independently
+ * (fire-and-forget, own catch) — one fault never blocks the rest.
+ */
+export declare function executeMachineCoherenceEffects(effects: EpisodeEffect[], deps: EffectsExecutorDeps): void;
+//# sourceMappingURL=machineCoherenceEffectsExecutor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"machineCoherenceEffectsExecutor.d.ts","sourceRoot":"","sources":["../../src/monitoring/machineCoherenceEffectsExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,mBAAmB,CAAC,IAAI,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QACjE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC9E,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IACnE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7F,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtG;AAED,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACvC,0EAA0E;IAC1E,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,aAAa,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,mBAAmB,GAAG,IAAI,CA8BxG"}

package/dist/monitoring/machineCoherenceEffectsExecutor.js

@@ -0,0 +1,56 @@
+/**
+ * Machine-coherence effects executor (calm-transient-episode-alerting M-P2).
+ *
+ * Extracted from the server.ts boot closure — the exact site of the original
+ * hardcoded-`priority: 'HIGH'` bug — into an injectable, unit-testable module.
+ * The executor is a PASS-THROUGH: priority / silent / copy decisions live in
+ * the episode manager (where dimension/stall/flap/interacted context lives);
+ * this module only carries them to the Telegram chokepoints.
+ *
+ * Fail-toward-silence: every effect executes fire-and-forget with its own
+ * catch — a Telegram fault must never crash the shared presence tick; the next
+ * reconcile re-derives from durable episode state.
+ */
+/**
+ * Execute one batch of episode effects. Each effect runs independently
+ * (fire-and-forget, own catch) — one fault never blocks the rest.
+ */
+export function executeMachineCoherenceEffects(effects, deps) {
+    for (const eff of effects) {
+        void (async () => {
+            try {
+                const tg = deps.telegram();
+                if (eff.kind === 'raise') {
+                    await tg?.createAttentionItem({
+                        id: eff.itemId, title: eff.title, summary: eff.summary, description: eff.description,
+                        category: 'machine-coherence',
+                        // M-P2 pass-through: the manager decides; absent = legacy HIGH.
+                        priority: eff.priority ?? 'HIGH',
+                        silent: eff.silent === true,
+                        sourceContext: 'machine-coherence-guard',
+                    });
+                }
+                else if (eff.kind === 'append') {
+                    const item = tg?.getAttentionItem(eff.itemId);
+                    if (item?.topicId !== undefined)
+                        await tg?.sendToTopic(item.topicId, eff.text, { silent: eff.silent === true });
+                }
+                else if (eff.kind === 'resolve') {
+                    const item = tg?.getAttentionItem(eff.itemId);
+                    if (item?.topicId !== undefined)
+                        await tg?.sendToTopic(item.topicId, eff.note, { silent: eff.silent === true });
+                    await tg?.updateAttentionStatus(eff.itemId, 'DONE', { silent: eff.silent === true });
+                }
+                else if (eff.kind === 'resolve-status') {
+                    // Orphan self-closeout arm: status-only DONE, no message ever.
+                    await tg?.updateAttentionStatus(eff.itemId, 'DONE', { silent: true });
+                }
+                else if (eff.kind === 'execute-fix') {
+                    await deps.onExecuteFix?.(eff);
+                }
+            }
+            catch { /* @silent-fallback-ok: episode effect execution is best-effort; a Telegram send/create fault must never crash the presence tick — the next reconcile re-derives from durable episode state */ }
+        })();
+    }
+}
+//# sourceMappingURL=machineCoherenceEffectsExecutor.js.map

package/dist/monitoring/machineCoherenceEffectsExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machineCoherenceEffectsExecutor.js","sourceRoot":"","sources":["../../src/monitoring/machineCoherenceEffectsExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsBH;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAwB,EAAE,IAAyB;IAChG,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACzB,MAAM,EAAE,EAAE,mBAAmB,CAAC;wBAC5B,EAAE,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW;wBACpF,QAAQ,EAAE,mBAAmB;wBAC7B,gEAAgE;wBAChE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,MAAM;wBAChC,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI;wBAC3B,aAAa,EAAE,yBAAyB;qBACzC,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACjC,MAAM,IAAI,GAAG,EAAE,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC9C,IAAI,IAAI,EAAE,OAAO,KAAK,SAAS;wBAAE,MAAM,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;gBAClH,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAClC,MAAM,IAAI,GAAG,EAAE,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;oBAC9C,IAAI,IAAI,EAAE,OAAO,KAAK,SAAS;wBAAE,MAAM,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;oBAChH,MAAM,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;gBACvF,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;oBACzC,+DAA+D;oBAC/D,MAAM,EAAE,EAAE,qBAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxE,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACtC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,8LAA8L,CAAC,CAAC;QAC5M,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;AACH,CAAC"}

package/dist/monitoring/machineCoherenceEpisode.d.ts

@@ -18,6 +18,7 @@
  * Supervision tier (N6): Tier 0 — deterministic file I/O, no LLM anywhere.
  */
 import type { SkewDimension } from './machineCoherenceEvaluate.js';
+import type { AnchorsBlock } from './machineCoherenceAnchors.js';
 /** The pendingFix three-state lifecycle (§4.2.1-i, R3-M6 / R4-M2). */
 export type PendingFixState = 'proposed' | 'approved-holding' | 'executing-verifying';
 /**
@@ -83,6 +84,10 @@ export interface RecurrenceBlock {
     };
     /** When the per-day-cap give-up note last fired (once per rolling 24 h). */
     capGiveupAtMs?: number;
+    /** calm-alerting M-P2 resolve-note bounding: last resolve NOTE per item id
+     *  (at most one per reopenWindowMs; latched-flapping closes are jsonl-only).
+     *  Additive. */
+    resolveNoteAtByItem?: Record<string, number>;
 }
 /** A §4.3 close reason — only `restored` may ever claim restoration. */
 export type EpisodeCloseReason = 'restored' | 'suspended-peer-offline' | 'suspended-peer-unverifiable' | 'expired-peer-gone' | 'superseded-by-takeover' | 'resolved-after-reenable' | 'manifest-changed' | 'state-rebaselined';
@@ -110,6 +115,24 @@ export interface EpisodeState {
     escalationAppended?: boolean;
     /** Re-open count carried on the episode (§4.5 damper). */
     reopenCount?: number;
+    /**
+     * Derived escalation item ids raised for this episode (`<itemId>:stalled` /
+     * `<itemId>:recurring`) — the close path resolves EVERY one (calm-alerting
+     * M-P2 derived-item lifecycle); doubles as the restart-proof per-episode
+     * once-per-class raise record. Additive.
+     */
+    derivedItemIds?: string[];
+    /** calm-alerting: episode classified calm at open (all rows patch-only version
+     *  skew under the calm gate) — drives silent narration + close mode. Additive. */
+    calmClass?: boolean;
+    /**
+     * Durable operator-interaction bit (calm-alerting M-P2): set ONLY by
+     * evidence-carrying operator actions (fix approval / explicit ack), NEVER
+     * derived from pendingFix presence (auto-created at raise, cleared on every
+     * fix path). Interacted episodes close with a notifying resolve note; a
+     * reopen does NOT carry it. Additive.
+     */
+    operatorInteracted?: boolean;
     recurrence: RecurrenceBlock;
 }
 /** The on-disk file shape: the open episode (or null) + the outliving recurrence. */
@@ -119,6 +142,13 @@ export interface EpisodeFile {
     episode: EpisodeState | null;
     /** Outlives episode close — the reopen window's memory (R2-N2). */
     recurrence: RecurrenceBlock;
+    /**
+     * The M-P0 identity-independent clock layer (calm-transient-episode-alerting
+     * spec) — STRICTLY ADDITIVE: `version` stays 1, the reader is lenient to it,
+     * and a binary rollback treats it as inert. Absent on files written before
+     * the calm-alerting feature.
+     */
+    anchors?: AnchorsBlock;
 }
 /** The result of a durable read — absent / ok / corrupt (§4.6 re-baseline gate). */
 export type EpisodeReadResult = {

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

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

package/dist/monitoring/machineCoherenceEpisode.js.map

@@ -1 +1 @@
-{"version":3,"file":"machineCoherenceEpisode.js","sourceRoot":"","sources":["../../src/monitoring/machineCoherenceEpisode.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"machineCoherenceEpisode.js","sourceRoot":"","sources":["../../src/monitoring/machineCoherenceEpisode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AA+I7B,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,MAAM,UAAU,EAAE,CAAC;AAC5B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,gCAAgC,CAAC,CAAC;AACxE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe;IAC7B,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACnD,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAiB,CAAW,CAAC,OAAO,EAAE,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACjG,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;IAClG,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACtH,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;IACvB,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;QACvF,MAAM,CAAC,GAAG,EAA6B,CAAC;QACxC,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC/G,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,UAAqC,CAAC;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAChF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAA6B,EAAE,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAAiB;IAClE,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACrC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACpD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/monitoring/machineCoherenceEpisodeManager.d.ts

@@ -21,25 +21,39 @@
  * (reply recognition, when it lands in b3, lives in the CONVERSATIONAL agent,
  * never here — D17 intact).
  */
-import type { SkewRow } from './machineCoherenceEvaluate.js';
+import type { SkewRow, SkewDimension } from './machineCoherenceEvaluate.js';
 import type { MachineCoherenceResolvedConfig } from './MachineCoherenceSentinel.js';
 import { type EpisodeCloseReason, type EpisodeState, type PendingFixState } from './machineCoherenceEpisode.js';
+import { type AnchorsBlock, type PatchSkewDecision } from './machineCoherenceAnchors.js';
 /** One effect the sentinel/server executes (the manager never does I/O beyond
- *  its own durable file + jsonl — telegram effects are the caller's). */
+ *  its own durable file + jsonl — telegram effects are the caller's).
+ *  calm-alerting M-P2: `priority` + `silent` ride the effect (the consumer is a
+ *  pass-through — the decision lives HERE, where dimension/stall/flap/interacted
+ *  context lives); absent fields mean legacy behavior (HIGH, notifying). */
 export type EpisodeEffect = {
     kind: 'raise';
     itemId: string;
     title: string;
     summary: string;
     description: string;
+    priority?: 'NORMAL' | 'HIGH';
+    silent?: boolean;
 } | {
     kind: 'append';
     itemId: string;
     text: string;
+    silent?: boolean;
 } | {
     kind: 'resolve';
     itemId: string;
     note: string;
+    silent?: boolean;
+}
+/** Status-only DONE (no message) — the orphan self-closeout arm: every machine
+ *  transitions its OWN items on every close reason, regardless of speaks(). */
+ | {
+    kind: 'resolve-status';
+    itemId: string;
 } | {
     kind: 'execute-fix';
     itemId: string;
@@ -72,6 +86,11 @@ export interface EpisodeReconcileInput {
     /** machineId → operator-facing nickname (registry display label; escaped at render). */
     nicknameOf: (machineId: string) => string;
     now: number;
+    /** calm-alerting M-P0 feed (consumed only under cfg.calmEnabled): this tick's
+     *  POST-M6-suppression raw divergent rows + raw advertised versions + cadence. */
+    rawRows?: SkewRow[];
+    versionsByMachine?: Record<string, string>;
+    tickMs?: number;
 }
 /** Observability counters (surfaced on the sentinel status snapshot / route). */
 export interface EpisodeManagerCounters {
@@ -107,6 +126,38 @@ export declare class MachineCoherenceEpisodeManager {
      * the effects the caller executes; the durable file + jsonl are written here.
      */
     reconcile(input: EpisodeReconcileInput): EpisodeEffect[];
+    /** The last raw versions seen (derived-raise laggard naming + calm decisions). */
+    private lastVersionsByMachine;
+    /** M-P1 patch-only confirmation decision over the durable anchors. */
+    decidePatchSkewConfirmation(key: string, nowMs: number, versionsByMachine: Record<string, string>): PatchSkewDecision;
+    /** Sentinel → flap accounting: a confirm transition on (dimension, key). */
+    noteConfirmTransition(dimension: SkewDimension, key: string): void;
+    /** Read-only anchors view (status route / tests). */
+    anchorsView(): AnchorsBlock | null;
+    /** An episode is calm-class iff EVERY row is patch-only version skew (set at
+     *  open; a joined non-calm row upgrades the episode to loud via joinRows). */
+    private classifyCalm;
+    /**
+     * M-P2 derived escalations on an OPEN episode: the stall ceiling (`:stalled`)
+     * and the flap brake (`:recurring`). Both are notifying HIGH raises under
+     * derived ids — cap-exempt by construction (≤1 per key per 24 h via the
+     * durable anchor latches + ≤1 per class per episode via derivedItemIds).
+     * The fail-loud invariant: an armed latch whose raise cannot be emitted
+     * (no base item id) increments escalationRaiseFailed and logs.
+     */
+    private maybeDerivedEscalations;
+    /** calm-alerting observability counters (surfaced on the status route). */
+    readonly countersCalm: {
+        progressExtensions: number;
+        ceilingConfirms: number;
+        flapBrakeFires: number;
+        calmRaises: number;
+        calmRaisesSilent: number;
+        silentResolves: number;
+        resolveNotesSuppressed: number;
+        waveBackstopFires: number;
+        escalationRaiseFailed: number;
+    };
     private episodeParticipants;
     /** A row's manifest key retired from the intersection (only meaningful for flag rows). */
     private rowKeyRetired;
@@ -166,13 +217,24 @@ export declare class MachineCoherenceEpisodeManager {
     private applyResume;
     private maybeEscalate;
     private closeEpisode;
+    /** Any version key on these rows already past the stall ceiling (anchors read). */
+    private anyVersionKeyPastCeiling;
+    /**
+     * Calm-copy body (calm-alerting M-P2): the observed skew + self-heal-in-
+     * progress + will-escalate-if-stalled. Deliberately NO fix-it/leave-it prompt
+     * — a decision prompt on a self-healing notice is the contradictory UX the
+     * round-1 review flagged; the prompt arrives with the stall/flap escalation.
+     */
+    private renderCalmBody;
     private closeNote;
     /**
      * Set (or clear) the durable operator "leave it" ack (§4.2 / R4-N2). Called by
      * the conversational reply path. Suppresses the §4.4 escalation for this
      * episode; cleared on a genuine §4.5 recurrence re-open (b2).
      */
-    setOperatorAck(ack: boolean): void;
+    setOperatorAck(ack: boolean, opts?: {
+        verifiedOperator?: boolean;
+    }): void;
     /** A suspended episode past the expiry closes `expired-peer-gone` (§4.3). Called each tick by the sentinel. */
     expireIfStale(now: number, nicknameOf: (m: string) => string): EpisodeEffect[];
     status(): {