@telora/daemon 0.21.26 → 0.21.82

package/dist/staleness.js

@@ -1,249 +0,0 @@
-/**
- * Staleness signal: is the RUNNING daemon behind the latest published release?
- *
- * Consumed by `telora-daemon status` and `telora-daemon session-state` to
- * surface a one-line warning when the running daemon version is behind the
- * latest published @telora/daemon. The CLI binary executing those commands may
- * be a DIFFERENT install than the running daemon (repo checkout vs npx cache),
- * so the running version comes from daemon.meta.json -- stamped by the daemon
- * itself at startup -- never from the CLI's own package.json.
- *
- * Design constraints:
- * - Silent degradation: never writes to stdout; any failure (no meta, legacy
- *   meta without a version stamp, daemon not running, registry unreachable)
- *   returns null so callers print their normal output unchanged. The
- *   underlying checkForUpdates console.warns on failure -- that goes to
- *   stderr, which the session-state stdout contract tolerates.
- * - Cached: the registry answer is cached in the global state dir
- *   (version-check-cache.json) with a 6h TTL. An EXPIRED cache is never used
- *   as a fallback -- a failed refresh returns null rather than reporting
- *   staleness from old data (no stale-cache false positives).
- * - Latency split: session-state is CACHE-ONLY (zero network -- the
- *   SessionStart hook blocks Claude Code on this command, and an unreachable
- *   registry would otherwise hang it for the full fetch timeout). The async
- *   half of "async or cached" lives in the RUNNING DAEMON, which refreshes
- *   the cache on a timer (startVersionCacheRefreshLoop) in every install
- *   mode, including npx with auto-update disabled -- the case the signal
- *   exists for. `status` keeps the live registry fallback: it is an
- *   interactive command where a few seconds for a fresh answer is fine.
- */
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { ensureGlobalStateDir, getDaemonStatus, readDaemonMeta, resolveGlobalStateDir, } from './daemon-process.js';
-import { checkForUpdates, isNewerVersion } from './version-check.js';
-import { createLogger } from './log.js';
-const log = createLogger({ module: 'staleness' });
-/** Cache freshness window. Within this, no network call is made. */
-export const VERSION_CHECK_CACHE_TTL_MS = 6 * 60 * 60 * 1000;
-/** Cache file name within the global state dir (~/.telora/). */
-export const VERSION_CHECK_CACHE_FILE = 'version-check-cache.json';
-// ---------------------------------------------------------------------------
-// Cache file helpers (default deps)
-// ---------------------------------------------------------------------------
-export function resolveVersionCheckCachePath() {
-    return join(resolveGlobalStateDir(), VERSION_CHECK_CACHE_FILE);
-}
-/**
- * Read the version-check cache only when it is FRESH (within the TTL).
- *
- * The running daemon keeps this cache warm via {@link startVersionCacheRefreshLoop};
- * the auto-update controller reads the candidate version from here instead of
- * issuing a registry call on every idle edge, so rapid idle flapping cannot
- * produce a registry-call storm. An expired cache returns null -- a stale
- * answer must never drive an update decision.
- */
-export function readFreshVersionCache(now = Date.now) {
-    const cache = readCacheFile();
-    if (!cache)
-        return null;
-    const checkedAtMs = Date.parse(cache.checkedAt);
-    if (!Number.isFinite(checkedAtMs))
-        return null;
-    if (now() - checkedAtMs >= VERSION_CHECK_CACHE_TTL_MS)
-        return null;
-    return cache;
-}
-function readCacheFile() {
-    const path = resolveVersionCheckCachePath();
-    if (!existsSync(path))
-        return null;
-    try {
-        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
-        if (typeof parsed.checkedAt !== 'string' || typeof parsed.latestVersion !== 'string') {
-            return null;
-        }
-        return { checkedAt: parsed.checkedAt, latestVersion: parsed.latestVersion };
-    }
-    catch {
-        return null;
-    }
-}
-function writeCacheFile(cache) {
-    try {
-        ensureGlobalStateDir();
-        writeFileSync(resolveVersionCheckCachePath(), JSON.stringify(cache, null, 2) + '\n', { mode: 0o600 });
-    }
-    catch (err) {
-        // Best-effort cache: an unwritable state dir must not break the signal.
-        log.debug('Best-effort cache: an unwritable state dir must not break the signal', { error: String(err?.message ?? err) });
-    }
-}
-/**
- * Compute staleness info for the running daemon, with injected dependencies.
- *
- * Returns null whenever the signal cannot be established with confidence:
- * no meta file, legacy meta without a version stamp, daemon not running,
- * or no fresh latest-version answer (expired cache + failed registry check,
- * or expired cache in cacheOnly mode).
- */
-export async function getStalenessInfoCore(deps, opts = {}) {
-    const meta = deps.readMeta();
-    if (!meta || typeof meta.version !== 'string' || meta.version.length === 0)
-        return null;
-    if (!deps.isDaemonRunning())
-        return null;
-    const runningVersion = meta.version;
-    // Resolve the latest published version: fresh cache first, registry second.
-    let latestVersion = null;
-    const cache = deps.readCache();
-    if (cache) {
-        const checkedAtMs = Date.parse(cache.checkedAt);
-        if (Number.isFinite(checkedAtMs) && deps.now() - checkedAtMs < VERSION_CHECK_CACHE_TTL_MS) {
-            latestVersion = cache.latestVersion;
-        }
-    }
-    if (latestVersion === null) {
-        if (opts.cacheOnly)
-            return null; // No fresh cache and no network allowed -- silent.
-        const result = await deps.checkForUpdates(runningVersion);
-        if (!result)
-            return null; // Registry unreachable -- silent, no stale-cache fallback.
-        latestVersion = result.latestVersion;
-        deps.writeCache({
-            checkedAt: new Date(deps.now()).toISOString(),
-            latestVersion,
-        });
-    }
-    return {
-        runningVersion,
-        latestVersion,
-        updateAvailable: isNewerVersion(latestVersion, runningVersion),
-        ...(meta.installMode !== undefined ? { installMode: meta.installMode } : {}),
-        ...(meta.autoUpdateEnabled !== undefined ? { autoUpdateEnabled: meta.autoUpdateEnabled } : {}),
-    };
-}
-/**
- * Compute staleness info for the running daemon (production deps).
- * Never throws; never writes stdout. Returns null when no signal applies.
- */
-export async function getStalenessInfo(opts = {}) {
-    try {
-        return await getStalenessInfoCore({
-            readMeta: readDaemonMeta,
-            isDaemonRunning: () => getDaemonStatus().running,
-            readCache: readCacheFile,
-            writeCache: writeCacheFile,
-            checkForUpdates,
-            now: Date.now,
-        }, opts);
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Refresh the version-check cache when it is missing or expired.
- * Returns true when a fresh registry answer was written, false when the
- * cache was already fresh or the registry was unreachable (no write -- an
- * expired cache stays expired rather than being re-stamped with old data).
- */
-export async function maybeRefreshVersionCheckCacheCore(deps, currentVersion) {
-    const cache = deps.readCache();
-    if (cache) {
-        const checkedAtMs = Date.parse(cache.checkedAt);
-        const withinTtl = Number.isFinite(checkedAtMs) && deps.now() - checkedAtMs < VERSION_CHECK_CACHE_TTL_MS;
-        // A cache entry whose latestVersion is at/below the running version carries
-        // zero actionable signal. After a self-update restart the running version can
-        // leapfrog the cached latest (e.g. running 0.17.53 > cached 0.17.48); the TTL
-        // would otherwise keep that semantically-dead entry authoritative for up to 6h,
-        // blinding the daemon to every subsequently-published release. Force a refresh
-        // in the leapfrog case regardless of cache age -- the startup prime tick then
-        // self-heals the cache on the next boot. The equal case (latest == running, the
-        // up-to-date steady state) still honors the TTL, so registry traffic does not
-        // increase for daemons that are already current.
-        const leapfrogged = isNewerVersion(currentVersion, cache.latestVersion);
-        if (withinTtl && !leapfrogged) {
-            return false; // Fresh and actionable -- nothing to do.
-        }
-    }
-    const result = await deps.checkForUpdates(currentVersion);
-    if (!result)
-        return false;
-    deps.writeCache({
-        checkedAt: new Date(deps.now()).toISOString(),
-        latestVersion: result.latestVersion,
-    });
-    return true;
-}
-/** Production wrapper for {@link maybeRefreshVersionCheckCacheCore}. Never throws. */
-export async function maybeRefreshVersionCheckCache(currentVersion) {
-    try {
-        return await maybeRefreshVersionCheckCacheCore({
-            readCache: readCacheFile,
-            writeCache: writeCacheFile,
-            checkForUpdates,
-            now: Date.now,
-        }, currentVersion);
-    }
-    catch {
-        return false;
-    }
-}
-/** Default interval for the daemon-side cache refresh loop (1h, like auto-update). */
-export const VERSION_CACHE_REFRESH_INTERVAL_MS = 60 * 60 * 1000;
-/**
- * Start the daemon-side version-cache refresh loop.
- *
- * Runs in EVERY install mode regardless of the auto-update flag -- npx with
- * auto-update disabled is precisely the configuration the staleness signal
- * exists for. Each tick refreshes the cache only when it is missing/expired
- * (the TTL throttles registry traffic to ~one fetch per 6h). The unref'd
- * timer never blocks process exit. Returns a cleanup function.
- */
-export function startVersionCacheRefreshLoop(currentVersion, intervalMs = VERSION_CACHE_REFRESH_INTERVAL_MS) {
-    let stopped = false;
-    const tick = () => {
-        if (stopped)
-            return;
-        void maybeRefreshVersionCheckCache(currentVersion);
-    };
-    tick(); // Prime at startup so the first session-state of the day has data.
-    const timer = setInterval(tick, intervalMs);
-    timer.unref();
-    return () => {
-        stopped = true;
-        clearInterval(timer);
-    };
-}
-// ---------------------------------------------------------------------------
-// Warning-line formatting (shared by status + session-state)
-// ---------------------------------------------------------------------------
-/**
- * Format the one-line staleness warning, or null when no warning applies.
- *
- * When the daemon runs from an npx cache with auto-update disabled, the line
- * carries the explicit escape hatch: self-update cannot replace an npx-cached
- * binary in place, so a global install + restart is the fix.
- */
-export function formatStalenessWarning(info) {
-    if (!info || !info.updateAvailable)
-        return null;
-    let line = `Update available: v${info.runningVersion} running, v${info.latestVersion} published.`;
-    if (info.installMode === 'npx' && info.autoUpdateEnabled === false) {
-        line +=
-            ' Daemon runs from an npx cache with auto-update disabled; self-update cannot replace an npx-cached binary.' +
-                ' Install globally (npm install -g @telora/daemon) and run `telora-daemon restart`.';
-    }
-    return line;
-}
-//# sourceMappingURL=staleness.js.map

package/dist/staleness.js.map

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

package/dist/stall-detector-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stall-detector-config.d.ts","sourceRoot":"","sources":["../src/stall-detector-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,uEAAuE;AACvE,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wFAAwF;AACxF,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,IAAI,MAAM,CAElD"}

package/dist/stall-detector-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stall-detector-config.js","sourceRoot":"","sources":["../src/stall-detector-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,uEAAuE;AACvE,MAAM,UAAU,sBAAsB;IACpC,OAAO,aAAa,EAAE,CAAC,kCAAkC,CAAC;AAC5D,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,6BAA6B;IAC3C,OAAO,aAAa,EAAE,CAAC,gCAAgC,CAAC;AAC1D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB;IACnC,OAAO,aAAa,EAAE,CAAC,uBAAuB,CAAC;AACjD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,yBAAyB;IACvC,OAAO,aAAa,EAAE,CAAC,4BAA4B,CAAC;AACtD,CAAC"}

package/dist/stall-detectors.d.ts

@@ -1,196 +0,0 @@
-/**
- * Targeted daemon-owned stall detectors.
- *
- * The lifecycle-aware no-progress predicate (completion/event.ts) makes the
- * generic watchdog PATIENT: it no longer trips on healthy review/verify/requeue
- * latency. That patience is only safe if the genuinely-wedged daemon-owned
- * cases it would otherwise have (noisily) surfaced are caught by dedicated
- * detectors with their own actionable reasons. This module is that safety
- * backfill:
- *
- *   1. verify_failed cycle cap -- a delivery whose verify_failed re-code cycle
- *      count (iteration_count) exceeds TELORA_VERIFY_FAILED_ITERATION_CAP is
- *      stuck in an unbounded re-code loop the verify gate will never clear. File
- *      ONE verify_gate_unclearable escalation (needs_operator) carrying the
- *      gate_state / last failing condition -- not a generic no-progress ping.
- *
- *   2. review-window staleness -- a focus stuck in the `reviewing` phase whose
- *      review_requested_at has sat past TELORA_REVIEW_WINDOW_STALE_HOURS with no
- *      active review team (a completed review would have cleared
- *      review_requested_at) is wedged. File ONE review_window_stalled escalation
- *      (needs_operator).
- *
- * BOTH detectors are PER-FOCUS and operate on state the caller already has --
- * they do NOT fan out their own getActiveFocuses / getFocusDeliveries pass.
- * They are driven from state-cascade.ts's runCascadeChecks loop, which already
- * iterates active focuses, fetches each focus's deliveries, and computes the
- * review phase: the detectors RIDE that existing review-handling seam (so there
- * is no redundant per-poll fan-out, and the review-window detector is wired into
- * the same review handling that owns review_requested_at). Each files AT MOST
- * ONE open escalation per entity (per delivery / per focus), mirroring the
- * merge-back stuck_focus_branch idempotency: the dedup queries the DB so it
- * survives a daemon restart. Pure over injected deps so the four cases
- * (under-cap, over-cap, fresh window, stale window) unit-test without
- * Supabase/MCP.
- */
-import type { FocusDeliveryInfo } from './types.js';
-import { type FileEscalationIdempotentParams, type FileEscalationIdempotentResult } from './queries/escalation-suppression.js';
-/**
- * escalation_kind discriminators for the two stall detectors. Declared as
- * daemon-local string constants (not imported from @telora/daemon-core's
- * ESCALATION_KINDS) on purpose: the daemon consumes the registry-PUBLISHED
- * daemon-core, so it cannot reference newly-added enum members until a build
- * that depends on a daemon-core publish carrying them. They ARE now in
- * daemon-core (ESCALATION_KINDS.VERIFY_GATE_UNCLEARABLE / .REVIEW_WINDOW_STALLED)
- * for other consumers, but the daemon keeps the local strings so this code does
- * not depend on publish ordering. The DB CHECK -- loosened by the
- * agent_escalations_kind_stall_detectors migration -- is the real constraint.
- */
-export declare const VERIFY_GATE_UNCLEARABLE_KIND = "verify_gate_unclearable";
-export declare const REVIEW_WINDOW_STALLED_KIND = "review_window_stalled";
-/** The per-focus context both detectors need to anchor an escalation. */
-export interface FocusStallContext {
-    organizationId: string;
-    focusId: string;
-    focusName: string;
-}
-export interface VerifyFailedCapDeps {
-    /**
-     * File the verify_gate_unclearable escalation through the cause-keyed idempotent
-     * gate: at most one open row per delivery, and a dismissed one keeps the same
-     * unclearable delivery silent (dismissal memory) until it moves on.
-     */
-    fileEscalation: (params: FileEscalationIdempotentParams) => Promise<FileEscalationIdempotentResult>;
-    /** Override the cap for tests; defaults to the resolved env-config value. */
-    cap?: number;
-}
-/**
- * True when `gateState.blocking` carries at least one guard verdict -- i.e. a
- * guard is ACTUALLY rejecting the work right now.
- *
- * Only the `blocking` array counts. operatorHold / externalHold / shortfallProposalIds
- * are carried OUTSIDE `blocking` (queries/deliveries.ts DeliveryGateState) because a
- * hold is not a guard verdict. Treating operatorHold as a block here would
- * reintroduce the very fixpoint the sibling operator-hold exclusion removes: the
- * verify_gate_unclearable alarm writes gate_state with `blocking: []` + a populated
- * operatorHold, and if that counted as "still blocking" the detector would keep
- * re-firing on its own alarm. So the guard-verdict array is the sole live-block
- * signal. (verify_evidence_unavailable DOES populate `blocking` with its own guard,
- * but it consumes no iteration_count, so it can never by itself push over the cap.)
- *
- * Defensive over the `unknown` gate_state shape (FocusDeliveryInfo.gateState). Pure
- * -- exported for direct unit testing.
- */
-export declare function hasLiveBlockingGuard(gateState: unknown): boolean;
-/**
- * Pure decision: does this delivery exceed the verify_failed re-code cap AND is a
- * guard still actively rejecting it?
- *
- * iteration_count is a MONOTONIC proxy for "the gate keeps rejecting this work",
- * but the condition it proxies is NOT monotonic: the counter never decreases while
- * the gate can go clear. Keying only on the counter let the detector assert "the
- * gate keeps rejecting the work" at a moment when gate_state.blocking was empty and
- * the gate was rejecting nothing (observed 2026-07-26). So the counter remains the
- * TRIGGER (it is the right bounded-loop signal -- a delivery that has re-coded N
- * times is the thing worth escalating), but the LIVE gate must also show a blocking
- * guard for the claim to be true by construction. A terminal delivery
- * (done/cancelled) is never escalated -- it has stopped cycling.
- *
- * Exported for direct unit testing.
- */
-export declare function exceedsVerifyFailedCap(delivery: Pick<FocusDeliveryInfo, 'executionStatus' | 'iterationCount' | 'gateState'>, cap: number): boolean;
-/**
- * Check ONE focus's ALREADY-FETCHED deliveries for any whose iteration_count
- * exceeds the verify_failed re-code cap, filing a verify_gate_unclearable
- * escalation (needs_operator) for each -- at most one open per delivery.
- * Operates on the deliveries the caller (runCascadeChecks) already loaded; it
- * does NOT fetch.
- */
-export declare function checkVerifyFailedCapForFocus(ctx: FocusStallContext, deliveries: FocusDeliveryInfo[], deps?: VerifyFailedCapDeps): Promise<void>;
-export interface ReviewWindowDeps {
-    /**
-     * File the review_window_stalled escalation through the cause-keyed idempotent
-     * gate: at most one open row per focus, and a dismissed one keeps the same stale
-     * review window silent (dismissal memory) until the focus's review state changes.
-     */
-    fileEscalation: (params: FileEscalationIdempotentParams) => Promise<FileEscalationIdempotentResult>;
-    /** Focus IDs that currently have an active REVIEW team. Defaults to live teams. */
-    activeReviewFocusIds: () => Set<string>;
-    /** Current epoch ms; injectable for tests. Defaults to Date.now. */
-    now: () => number;
-    /** Override the staleness threshold (hours) for tests; defaults to env-config. */
-    thresholdHours?: number;
-}
-/** Focus IDs that currently have an active REVIEW team (live default). */
-export declare function activeReviewFocusIds(): Set<string>;
-/**
- * Pure decision: is this focus's review window stale? True when a
- * review_requested_at exists, is older than `thresholdMs`, and the focus has no
- * active review team. A completed review clears review_requested_at, so a
- * still-set timestamp older than the threshold with no active review team means
- * the review never ran (or never finished). Exported for direct unit testing.
- */
-export declare function isReviewWindowStale(reviewRequestedAt: string | null, hasActiveReview: boolean, nowMs: number, thresholdMs: number): boolean;
-/**
- * Check ONE focus for a stale review window and file a review_window_stalled
- * escalation (needs_operator) -- at most one open per focus. The caller
- * (runCascadeChecks) passes the focus's review_requested_at, so this rides the
- * existing review-handling seam rather than fanning out its own focus scan.
- */
-export declare function checkReviewWindowStaleForFocus(ctx: FocusStallContext, reviewRequestedAt: string | null, deps?: ReviewWindowDeps): Promise<void>;
-export interface IdleTeamStallDeps {
-    /**
-     * The team's per-team last-activity epoch ms, or null when nothing has been
-     * recorded yet (a team still initializing before its first agent event).
-     */
-    getLastActivityAt: (focusId: string) => number | null;
-    /**
-     * True when the focus has a live team ELIGIBLE for idle recovery: it exists in
-     * activeTeams and is in the `executing` phase. A team already tearing down
-     * (shutting_down/terminated) must not be re-recovered every tick -- once
-     * recovery flips it to shutting_down this returns false, so terminateTeam is
-     * not re-issued on each 30s cascade pass until the reap clears the clock.
-     */
-    isTeamRecoverable: (focusId: string) => boolean;
-    /**
-     * Recover the stalled team. The default terminates it via terminateTeam (a
-     * controlled `teardown`), which the normal completion path then reaps: the
-     * activeTeams entry is dropped (un-blocking merge-back on active_team), the
-     * governor slot returns via the exactly-once release, and a verify_failed
-     * delivery re-enters the executor's normal queue. Returns true if a team was
-     * actually terminated.
-     */
-    recoverTeam: (focusId: string) => boolean;
-    /** Current epoch ms; injectable for tests. Defaults to Date.now. */
-    now: () => number;
-    /** Override the threshold (hours) for tests; defaults to env-config. */
-    thresholdHours?: number;
-}
-/** Default: a focus is recoverable when its team is live and `executing`. */
-export declare function isTeamRecoverable(focusId: string): boolean;
-/**
- * Pure decision: has this team's activity clock frozen past the threshold?
- *
- * False when no activity has been recorded yet (null) -- a team still
- * initializing has not stalled, it just has not produced its first event. The
- * gap is measured against the LAST agent event, not spawn, so a team that keeps
- * producing events never trips (its idle age stays under the threshold). The
- * observed park kept phase=executing while the last-activity clock stayed frozen
- * for 16h37m -- exactly what this predicate catches. Exported for direct unit
- * testing.
- */
-export declare function isTeamIdleStalled(lastActivityMs: number | null, nowMs: number, thresholdMs: number): boolean;
-/**
- * Check ONE focus's team for an idle stall and RECOVER it (terminate so the
- * daemon's normal execution/release paths resume) when its last agent event is
- * older than the threshold. Reads the per-team last-activity clock the caller's
- * seam does not need to load.
- *
- * Files NO escalation: the ask -- recover the parked team -- names an act the
- * daemon performs itself, so this detector ACTS rather than routing a human an
- * item that can only wait ("A hold must name a human act"). A genuinely working
- * team is never recovered: its clock keeps advancing, so its idle age stays
- * under the threshold.
- */
-export declare function checkIdleTeamStallForFocus(ctx: FocusStallContext, deps?: IdleTeamStallDeps): void;
-//# sourceMappingURL=stall-detectors.d.ts.map

package/dist/stall-detectors.d.ts.map

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