@telora/daemon 0.21.26 → 0.21.82

package/dist/drift/sensor-sweep.js

@@ -0,0 +1,458 @@
+/**
+ * Deterministic whole-repo sensor sweep -- the DC baseline for artifact health.
+ *
+ * Peer of the other daemon loop ticks (drift-eval, verification, merge-back).
+ * Each tick walks every configured product's repo and, when the repo has drifted
+ * since the last snapshot, mines a deterministic snapshot into the code_metrics
+ * time series:
+ *   - git churn + hotspot mass (change frequency x a language-agnostic size /
+ *     indentation-complexity proxy over the changed set);
+ *   - lint-gate ratchet exception counts harvested from scripts/lint-config.json;
+ *   - dependency freshness derived from the package manifests;
+ *   - intent-aligned churn: the fraction of window churn whose paths fall inside
+ *     the footprint of active foci/deliveries (the paths their focus branches
+ *     touch) vs outside any declared intent -- the Telora-native differential
+ *     metric at the artifact layer (activity without intent reduction is noise).
+ *
+ * Purely deterministic: git + filesystem reads only, NO LLM and NO network
+ * beyond the local repo. Burn is drift-proportional: a product whose repo HEAD
+ * and manifest hash are unchanged since its last snapshot is skipped -- the
+ * sweep sees cold-code rot and environment drift that activity-gated sampling
+ * cannot, without re-mining an unchanged tree.
+ *
+ * All side effects (git, fs, the code_metrics query wrappers, the clock) are
+ * injected via `Deps` so the miners and the drift-skip logic are unit-testable
+ * without a real repo. Mirrors the drift-eval-loop.ts dependency-injection
+ * pattern.
+ *
+ * MINING WINDOW IS TIME-BOUNDED, NOT COUNT-BOUNDED. The churn/hotspot window is
+ * a fixed real-time span (`DEFAULT_WINDOW_DAYS`), not a fixed commit count. A
+ * count-bounded window (e.g. "last 500 commits") makes consecutive snapshots
+ * cover different lengths of real time, so cross-snapshot trends partly measure
+ * commit velocity rather than code health -- a busy month and a quiet quarter
+ * both look like "500 commits." Anchoring the window to calendar time makes
+ * consecutive snapshots cover comparable spans, so a rising/falling trend
+ * reflects the health of the code (churn, hotspot mass) independent of how fast
+ * the team happened to be committing. A large secondary commit-count SAFETY CAP
+ * (`COMMIT_SAFETY_CAP`) bounds the worst case so an extremely busy repo cannot
+ * blow up the window; it is a defensive backstop, not the primary bound.
+ *
+ * @module sensor-sweep
+ */
+import { readFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { runGitSync } from '../git/index.js';
+import { configForProduct } from '../shell/config.js';
+import { getLatestCodeMetrics, createCodeMetricsSnapshot } from '../queries/code-metrics.js';
+import { createLogger } from '../shell/log.js';
+const log = createLogger({ module: 'sensor-sweep' });
+/**
+ * Real-time span (days) that defines the churn/hotspot mining window. This is
+ * the PRIMARY bound: consecutive snapshots cover comparable calendar spans so
+ * trends measure code health, not commit velocity. 90 days is one quarter --
+ * long enough to capture a meaningful change-frequency signal, short enough to
+ * stay responsive to recent activity.
+ */
+const DEFAULT_WINDOW_DAYS = 90;
+/**
+ * Secondary defensive bound on the number of commits mined. NOT the primary
+ * window -- it only caps the worst case so an extremely busy repo (thousands of
+ * commits inside the day window) cannot blow up parsing/memory. Set far above
+ * any realistic 90-day commit count.
+ */
+const COMMIT_SAFETY_CAP = 5000;
+const MS_PER_DAY = 86_400_000;
+/**
+ * Parse `git log --since=<span> --numstat --format=COMMIT:%H %aI` output into
+ * per-file churn. Pure: no git process. Binary numstat rows (`-\t-`) are
+ * skipped. The `--format` output shape is identical regardless of whether the
+ * window was count- or time-bounded, so this parser is unchanged.
+ */
+export function parseNumstatPerFile(output) {
+    const perFile = new Map();
+    let commitMs = 0;
+    for (const rawLine of output.split('\n')) {
+        const line = rawLine.trimEnd();
+        if (!line)
+            continue;
+        if (line.startsWith('COMMIT:')) {
+            // "COMMIT:<sha> <iso8601>"
+            const rest = line.slice('COMMIT:'.length).trim();
+            const spaceIdx = rest.indexOf(' ');
+            const iso = spaceIdx >= 0 ? rest.slice(spaceIdx + 1).trim() : '';
+            const parsed = iso ? Date.parse(iso) : NaN;
+            commitMs = Number.isNaN(parsed) ? commitMs : parsed;
+            continue;
+        }
+        const parts = line.split('\t');
+        if (parts.length < 3)
+            continue;
+        const added = parts[0];
+        const removed = parts[1];
+        const file = parts[2];
+        if (!file)
+            continue;
+        if (added === '-' || removed === '-')
+            continue; // binary
+        const lines = (parseInt(added, 10) || 0) + (parseInt(removed, 10) || 0);
+        const existing = perFile.get(file);
+        if (existing) {
+            existing.changeCount += 1;
+            existing.linesChanged += lines;
+            if (commitMs > existing.lastCommitMs)
+                existing.lastCommitMs = commitMs;
+        }
+        else {
+            perFile.set(file, { changeCount: 1, linesChanged: lines, lastCommitMs: commitMs });
+        }
+    }
+    return perFile;
+}
+/**
+ * Language-agnostic complexity proxy for a file body: line count plus the sum of
+ * per-line indentation depth (leading whitespace, tabs counted as one level).
+ * Deeper, longer files score higher without any per-language AST tooling.
+ */
+export function complexityProxy(content) {
+    let score = 0;
+    for (const line of content.split('\n')) {
+        if (!line.trim())
+            continue;
+        score += 1; // one per non-blank line
+        const leading = line.length - line.trimStart().length;
+        // Normalize indentation: tabs and 2-space steps both count as ~1 level.
+        score += Math.floor(leading / 2);
+    }
+    return score;
+}
+/** Map a repo-relative path to an area = its first `depth` path segments. */
+export function areaOf(filePath, depth = 2) {
+    const segments = filePath.split('/').filter(Boolean);
+    if (segments.length <= 1)
+        return '(root)';
+    return segments.slice(0, depth).join('/');
+}
+/**
+ * Aggregate per-file churn + complexity into per-area metrics and repo totals.
+ * `complexityFor(file)` returns the size/complexity proxy for a changed file
+ * (injected so tests need no fs); a missing file falls back to its linesChanged.
+ */
+export function aggregateAreas(perFile, complexityFor, nowMs, depth = 2) {
+    const byArea = new Map();
+    let totalChurn = 0;
+    let totalHotspotMass = 0;
+    for (const [file, churn] of perFile) {
+        const complexity = complexityFor(file);
+        const sizeProxy = complexity == null ? churn.linesChanged : complexity;
+        const hotspot = churn.changeCount * sizeProxy;
+        totalChurn += churn.linesChanged;
+        totalHotspotMass += hotspot;
+        const area = areaOf(file, depth);
+        const bucket = byArea.get(area) ?? { churn: 0, hotspotMass: 0, files: new Set(), newestMs: 0 };
+        bucket.churn += churn.linesChanged;
+        bucket.hotspotMass += hotspot;
+        bucket.files.add(file);
+        if (churn.lastCommitMs > bucket.newestMs)
+            bucket.newestMs = churn.lastCommitMs;
+        byArea.set(area, bucket);
+    }
+    const areas = [...byArea.entries()]
+        .map(([area, b]) => ({
+        area,
+        churn: b.churn,
+        hotspotMass: b.hotspotMass,
+        fileCount: b.files.size,
+        ageDays: b.newestMs > 0 ? Math.max(0, Math.round((nowMs - b.newestMs) / MS_PER_DAY)) : 0,
+    }))
+        .sort((a, b) => b.hotspotMass - a.hotspotMass);
+    return { areas, totalChurn, totalHotspotMass };
+}
+/**
+ * The Telora-native differential metric at the artifact layer: what FRACTION of
+ * the window churn landed inside the footprint of active foci/deliveries
+ * (`intentPaths`) versus outside any declared intent. Activity without intent
+ * reduction is noise -- this makes that noise measurable.
+ *
+ * Pure over the injected per-file churn + the intent-path set: no git. A file is
+ * "aligned" when its exact repo-relative path is in `intentPaths` (the union of
+ * paths the active focus branches have changed). The ratio is bounded 0-1 and is
+ * scale-free, so it is comparable across snapshots regardless of absolute churn.
+ */
+export function computeIntentAlignedChurn(perFile, intentPaths) {
+    let alignedChurn = 0;
+    let totalChurn = 0;
+    for (const [file, churn] of perFile) {
+        totalChurn += churn.linesChanged;
+        if (intentPaths.has(file))
+            alignedChurn += churn.linesChanged;
+    }
+    // totalChurn === 0 -> the fraction is 0/0, undefined: unmeasured, persist null.
+    // totalChurn > 0 with alignedChurn 0 -> a genuine measurement (all churn landed
+    // outside declared intent), persist 0.
+    const alignedRatio = totalChurn > 0 ? alignedChurn / totalChurn : null;
+    return { alignedChurn, totalChurn, alignedRatio };
+}
+/**
+ * Count lint-gate ratchet exceptions from a parsed scripts/lint-config.json.
+ * Each top-level category (except `_comment`) is an array of allowlist entries;
+ * a growing count is accumulating debt the ratchet is holding back.
+ */
+export function countRatchets(lintConfig) {
+    const detail = {};
+    let total = 0;
+    if (lintConfig && typeof lintConfig === 'object') {
+        for (const [key, value] of Object.entries(lintConfig)) {
+            if (key.startsWith('_'))
+                continue;
+            if (Array.isArray(value)) {
+                detail[key] = value.length;
+                total += value.length;
+            }
+            else if (value && typeof value === 'object') {
+                // Nested { category: [...] } shapes contribute their array lengths.
+                for (const inner of Object.values(value)) {
+                    if (Array.isArray(inner))
+                        total += inner.length;
+                }
+                detail[key] = total;
+            }
+        }
+    }
+    return { total, detail };
+}
+/**
+ * Derive dependency freshness from manifests alone (no registry / network).
+ * `outdated` is a deterministic risk proxy: a dependency pinned to a pre-1.0
+ * (0.x) major, or to an unbounded/floating range (`*`, `latest`, `x`), reads as
+ * a freshness/stability risk. Also returns a stable manifest hash for the
+ * drift-skip key.
+ */
+export function analyzeManifests(manifests) {
+    const detail = {};
+    let dependencyCount = 0;
+    let dependencyOutdated = 0;
+    const hashParts = [];
+    const sorted = [...manifests].sort((a, b) => a.path.localeCompare(b.path));
+    for (const manifest of sorted) {
+        const content = manifest.content;
+        let count = 0;
+        let outdated = 0;
+        if (content && typeof content === 'object') {
+            const c = content;
+            for (const section of ['dependencies', 'devDependencies']) {
+                const deps = c[section];
+                if (deps && typeof deps === 'object' && !Array.isArray(deps)) {
+                    for (const [name, spec] of Object.entries(deps)) {
+                        const specStr = String(spec);
+                        count += 1;
+                        hashParts.push(`${manifest.path}:${name}@${specStr}`);
+                        if (isOutdatedSpec(specStr))
+                            outdated += 1;
+                    }
+                }
+            }
+        }
+        detail[manifest.path] = { count, outdated };
+        dependencyCount += count;
+        dependencyOutdated += outdated;
+    }
+    return { dependencyCount, dependencyOutdated, detail, manifestHash: fnv1a(hashParts.join('\n')) };
+}
+/** Pre-1.0 major or unbounded/floating range => a deterministic freshness risk. */
+export function isOutdatedSpec(spec) {
+    const s = spec.trim();
+    if (s === '*' || s === 'latest' || s === 'x' || s === '')
+        return true;
+    // Strip a single leading range operator, then test for a 0.x major.
+    const stripped = s.replace(/^[\^~>=<]+/, '');
+    return /^0\./.test(stripped);
+}
+/** FNV-1a 32-bit -- a small, dependency-free deterministic string hash. */
+export function fnv1a(input) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+export function defaultSensorSweepDeps() {
+    return {
+        gitNumstat: (repoPath, windowDays, commitCap) => {
+            const result = runGitSync([
+                'log',
+                `--since=${windowDays}.days.ago`,
+                `-n${commitCap}`,
+                '--numstat',
+                '--format=COMMIT:%H %aI',
+            ], repoPath, { timeoutMs: 60_000 });
+            return result.success ? (result.output ?? '') : '';
+        },
+        listTrackedFiles: (repoPath) => {
+            const result = runGitSync(['ls-files'], repoPath, { timeoutMs: 30_000 });
+            if (!result.success)
+                return [];
+            return result.output.split('\n').map((l) => l.trim()).filter(Boolean);
+        },
+        readFile: (repoPath, relPath) => {
+            try {
+                return readFileSync(join(repoPath, relPath), 'utf8');
+            }
+            catch {
+                return null;
+            }
+        },
+        readLintConfig: (repoPath) => {
+            try {
+                return JSON.parse(readFileSync(join(repoPath, 'scripts', 'lint-config.json'), 'utf8'));
+            }
+            catch {
+                return null;
+            }
+        },
+        readManifests: (repoPath) => discoverManifests(repoPath),
+        resolveHeadSha: (repoPath) => {
+            const result = runGitSync(['rev-parse', 'HEAD'], repoPath, { timeoutMs: 15_000 });
+            return result.success ? result.output.trim() : null;
+        },
+        listIntentPaths: (repoPath) => {
+            // Enumerate active focus branches (agent/<role>/<slug>-<id>) and union the
+            // paths each has changed vs the current mainline (three-dot HEAD...branch,
+            // which diffs from their merge-base). Git-only + deterministic; a repo with
+            // no active focus branches yields an empty footprint (ratio -> 0).
+            const branchResult = runGitSync(['branch', '--list', 'agent/*', '--format=%(refname:short)'], repoPath, { timeoutMs: 15_000 });
+            if (!branchResult.success)
+                return [];
+            const branches = branchResult.output
+                .split('\n')
+                .map((l) => l.trim())
+                .filter(Boolean);
+            const paths = new Set();
+            for (const branch of branches) {
+                const diff = runGitSync(['diff', '--name-only', `HEAD...${branch}`], repoPath, { timeoutMs: 30_000 });
+                if (!diff.success)
+                    continue;
+                for (const p of diff.output.split('\n').map((l) => l.trim()).filter(Boolean)) {
+                    paths.add(p);
+                }
+            }
+            return [...paths];
+        },
+        getLatest: getLatestCodeMetrics,
+        createSnapshot: createCodeMetricsSnapshot,
+        now: () => Date.now(),
+        windowDays: DEFAULT_WINDOW_DAYS,
+        commitCap: COMMIT_SAFETY_CAP,
+    };
+}
+/** Discover package.json manifests at the repo root and one level into packages/ + mcp/. */
+function discoverManifests(repoPath) {
+    const found = [];
+    const candidates = ['package.json'];
+    for (const workspace of ['packages', 'mcp']) {
+        const dir = join(repoPath, workspace);
+        if (!existsSync(dir))
+            continue;
+        let entries = [];
+        try {
+            entries = readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+        }
+        catch {
+            entries = [];
+        }
+        for (const name of entries)
+            candidates.push(join(workspace, name, 'package.json'));
+    }
+    for (const rel of candidates) {
+        const abs = join(repoPath, rel);
+        if (!existsSync(abs))
+            continue;
+        try {
+            found.push({ path: rel.split(/[\\/]/).join('/'), content: JSON.parse(readFileSync(abs, 'utf8')) });
+        }
+        catch (err) {
+            // Skip unparseable manifests -- deterministic omission, not a crash.
+            log.debug('Skip unparseable manifests -- deterministic omission, not a crash', { error: String(err?.message ?? err) });
+        }
+    }
+    return found;
+}
+/**
+ * Mine one repo into a snapshot input. Pure over the injected deps -- no global
+ * git/fs. Returns null when HEAD cannot be resolved (an unusable repo).
+ */
+export function mineRepoSnapshot(repoPath, deps) {
+    const repoHead = deps.resolveHeadSha(repoPath);
+    if (!repoHead)
+        return null;
+    const perFile = parseNumstatPerFile(deps.gitNumstat(repoPath, deps.windowDays, deps.commitCap));
+    const complexityCache = new Map();
+    const complexityFor = (file) => {
+        if (complexityCache.has(file))
+            return complexityCache.get(file) ?? null;
+        const body = deps.readFile(repoPath, file);
+        const value = body == null ? null : complexityProxy(body);
+        complexityCache.set(file, value);
+        return value;
+    };
+    const { areas, totalChurn, totalHotspotMass } = aggregateAreas(perFile, complexityFor, (deps.now ?? Date.now)());
+    const ratchets = countRatchets(deps.readLintConfig(repoPath));
+    const manifests = analyzeManifests(deps.readManifests(repoPath));
+    const fileCount = deps.listTrackedFiles(repoPath).length;
+    const intentAligned = computeIntentAlignedChurn(perFile, new Set(deps.listIntentPaths(repoPath)));
+    return {
+        repoHead,
+        manifestHash: manifests.manifestHash,
+        hotspotMass: totalHotspotMass,
+        totalChurn,
+        fileCount,
+        ratchetCount: ratchets.total,
+        dependencyCount: manifests.dependencyCount,
+        dependencyOutdated: manifests.dependencyOutdated,
+        areas,
+        ratchetDetail: ratchets.detail,
+        dependencyDetail: manifests.detail,
+        intentAlignedChurn: intentAligned.alignedChurn,
+        intentAlignedRatio: intentAligned.alignedRatio,
+    };
+}
+/**
+ * Run one sensor-sweep tick across every configured product. Drift-proportional:
+ * a product whose repo HEAD + manifest hash match its last snapshot is skipped.
+ * Per-product try/catch keeps one bad repo from aborting the sweep.
+ */
+export async function runSensorSweepTick(config, depOverrides = {}) {
+    const deps = { ...defaultSensorSweepDeps(), ...depOverrides };
+    const counts = {
+        productsScanned: 0,
+        snapshotsWritten: 0,
+        skippedUnchanged: 0,
+        errors: 0,
+    };
+    for (const product of config.products) {
+        counts.productsScanned++;
+        try {
+            const pc = configForProduct(config, product);
+            const snapshot = mineRepoSnapshot(pc.repoPath, deps);
+            if (!snapshot) {
+                counts.errors++;
+                continue;
+            }
+            const latest = await deps.getLatest(product.id);
+            if (latest && latest.repoHead === snapshot.repoHead && latest.manifestHash === snapshot.manifestHash) {
+                // Nothing drifted since the last snapshot -- skip re-mining (DC baseline
+                // is unchanged; burn stays proportional to drift, not calendar time).
+                counts.skippedUnchanged++;
+                continue;
+            }
+            await deps.createSnapshot(product.id, snapshot);
+            counts.snapshotsWritten++;
+        }
+        catch (err) {
+            counts.errors++;
+            log.warn('product tick failed:', err.message);
+        }
+    }
+    return counts;
+}
+//# sourceMappingURL=sensor-sweep.js.map

package/dist/drift/sensor-sweep.js.map

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

package/dist/drift/staleness-sensor.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Propagation-staleness sensor (focus: "Propagation Staleness Is Invisible").
+ *
+ * The differential instrument this focus is named for: it computes
+ * newest-available MINUS actually-running for a tracked target. Its first (and
+ * directly observable) target is the running daemon vs the Gitea npm registry:
+ *
+ *   running = ~/.telora/daemon.meta.json .version   (this daemon's own build)
+ *   newest  = the warm version cache .latestVersion  (Gitea registry dist-tags.latest,
+ *             kept fresh by startVersionCacheRefreshLoop)
+ *
+ * CLOSING the gap, not reporting it. The daemon-version gap is machine-closable:
+ * the safe-seam auto-update controller (auto-update.ts) already installs a newer
+ * registry version at the next batch-safe idle seam. So when the gap is beyond
+ * threshold this sensor DEFERS to that closer -- it does NOT tell a human "the
+ * daemon is stale, restart it". Telling a human about a gap the machine is
+ * already closing converts machine signal into human chore, and firing on a
+ * healthy daemon that is merely deferring to its next safe seam is exactly the
+ * failure mode this focus exists to remove.
+ *
+ * A human is involved ONLY where the machine genuinely cannot act: auto-update
+ * is disabled for this daemon (installMode=npx, or --no-auto-update /
+ * TELORA_AUTO_UPDATE=0, reflected as autoUpdateEnabled=false in daemon.meta.json).
+ * The operator opted out of automation, so the machine cannot close the gap --
+ * and even then the deliverable is a READY ACTION handed over (the exact
+ * `npm install -g` command + restart), never an inbox item that merely says a
+ * gap exists. That handover auto-resolves once the running version catches up,
+ * and is retired immediately if auto-update is re-enabled (the machine reclaims
+ * closure).
+ *
+ * Every tick leaves a trace (delegated-to-auto-update / handed-over /
+ * back-in-sync / "measured, within threshold" / "UNMEASURED"), so an ABSENT
+ * trace positively means "measured and in sync" -- never "not measured". Wedged
+ * auto-update (enabled but not running) is made visible by the SEPARATE
+ * auto-update decision heartbeat (auto-update.ts): an absent [auto-update] trace
+ * identifies a controller that is not running. That is not re-derived here.
+ *
+ * Pure decision (computeDaemonVersionDifferential / decideStalenessAction) +
+ * injected IO, mirroring ci-sensor-loop.ts, so the loop is unit-testable without
+ * a live registry or DB. Registered in LOOP_REGISTRY under the opt-out guard
+ * TELORA_STALENESS_SENSOR_LOOP.
+ *
+ * The two infra-owned targets observed 2026-07-24 (npmjs mirror serving a stale
+ * version; Opus 5 seed merged-but-maybe-not-applied) are NOT computable from
+ * this repo (no prod DB access; infra alone publishes to npmjs). They are
+ * recorded, with their operator-facing close action, in
+ * docs/runbook-propagation-staleness-targets.md -- the sensor deliberately does
+ * NOT attempt those infra actions.
+ *
+ * @module staleness-sensor
+ */
+import type { DaemonConfig } from '../types/index.js';
+/**
+ * escalation_kind for a stale daemon that the machine CANNOT auto-close (auto-update
+ * disabled). Carries a ready action, not a bare "gap exists" notice.
+ */
+export declare const PROPAGATION_STALE_ESCALATION_KIND = "propagation_stale";
+/** Stable target id for the daemon-vs-registry differential. */
+export declare const DAEMON_VERSION_TARGET = "daemon-version";
+/**
+ * Default patch-version distance that trips the signal. Any minor/major gap
+ * always trips regardless. A 1-2 patch gap is left quiet: auto-update closes it
+ * at the next idle seam, so signaling immediately would be noise. The observed
+ * failure (0.20.21 vs 0.20.28 = 7 patches) is well past this floor.
+ */
+export declare const DEFAULT_STALENESS_PATCH_THRESHOLD = 3;
+/** Component-wise magnitude of how far `running` is behind `newest` (clamped at 0). */
+export interface VersionDistance {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/** The computed newest-vs-running differential for a tracked target. */
+export interface StalenessDifferential {
+    target: string;
+    running: string;
+    newest: string;
+    /** True when `newest` is strictly newer than `running`. */
+    behind: boolean;
+    distance: VersionDistance;
+    /** True when the gap exceeds the declared threshold (any minor/major, or >= patchThreshold patches). */
+    beyondThreshold: boolean;
+}
+/**
+ * Compute the daemon-vs-registry differential. Returns null when it cannot be
+ * MEASURED (either version missing) -- the caller must then emit an explicit
+ * "UNMEASURED" trace rather than staying silent, so silence always means "in
+ * sync", never "not measured".
+ */
+export declare function computeDaemonVersionDifferential(running: string | null, newest: string | null, patchThreshold?: number): StalenessDifferential | null;
+/**
+ * What the sensor should do with the current differential.
+ *  - `delegate`   -- gap is beyond threshold and the machine closes it itself
+ *                    (auto-update enabled): defer to that closer, no human.
+ *  - `hand-over`  -- gap is beyond threshold but the machine cannot act
+ *                    (auto-update disabled): hand a human a ready action.
+ *  - `resolve`    -- an open handover exists but the machine is now closing the
+ *                    gap (back within threshold, OR auto-update re-enabled).
+ *  - `none`       -- nothing to do.
+ */
+export type StalenessAction = 'delegate' | 'hand-over' | 'resolve' | 'none';
+/**
+ * Pure decision. The pivot is `canMachineClose`: when the auto-update controller
+ * owns closing the daemon-version gap, the sensor NEVER hands a human a report --
+ * it defers (and retires any stale handover). A human is handed a ready action
+ * ONLY when the machine genuinely cannot act. A null differential (unmeasurable)
+ * never acts -- it is handled as a trace by the tick.
+ */
+export declare function decideStalenessAction(diff: StalenessDifferential | null, hasOpen: boolean, canMachineClose: boolean): StalenessAction;
+/** Minimal open-escalation row shape the sensor's dedup / resolve reads. */
+interface StalenessEscalationRow {
+    id: string;
+    status?: string | null;
+    escalationKind?: string | null;
+    metadata?: Record<string, unknown> | null;
+}
+/**
+ * Pure suppression predicate over already-fetched rows. A re-file for THIS
+ * version gap is suppressed when an open/dismissed row carries its cause key
+ * (dismissal memory -- the incident pattern where a dismissed handover re-filed
+ * every tick), or a legacy OPEN propagation_stale row with no cause_key exists
+ * (deployment-window back-compat). A catch-up stops the signal entirely; a NEW
+ * `newest` is a different cause key and re-files. Exported for direct unit test.
+ */
+export declare function isStalenessRefileSuppressed(rows: readonly StalenessEscalationRow[], params: {
+    running: string;
+    newest: string;
+}): boolean;
+/** Injected IO for the sensor tick. Defaults reach for the real implementations. */
+export interface StalenessSensorDeps {
+    readRunningVersion: () => string | null;
+    readNewestAvailable: () => string | null;
+    patchThreshold: number;
+    /**
+     * True when the auto-update controller can close the daemon-version gap itself.
+     * When true the sensor defers to that closer and never hands a human a report;
+     * when false the operator opted out and the machine genuinely cannot act.
+     */
+    canMachineCloseGap: () => boolean;
+    hasOpenStalenessEscalation: (params: {
+        running: string;
+        newest: string;
+    }) => Promise<boolean>;
+    /** Hand a human a READY ACTION when (and only when) the machine cannot act. */
+    handOverReadyAction: (params: {
+        organizationId: string;
+        productId: string;
+        diff: StalenessDifferential;
+        readyCommand: string;
+    }) => Promise<void>;
+    resolveStalenessEscalations: () => Promise<number>;
+}
+export interface StalenessSensorTickCounts {
+    /** True when the differential could be computed (both versions known). */
+    measured: boolean;
+    /** True when the daemon is behind the registry at all (any distance). */
+    behind: boolean;
+    /** True when the machine (auto-update) owns closing the measured gap this tick. */
+    delegatedToAutoUpdate: boolean;
+    /** Ready-action handovers filed -- only when the machine genuinely cannot act. */
+    handoversToOperator: number;
+    escalationsResolved: number;
+}
+/**
+ * One propagation-staleness sensor tick. Computes the global daemon-vs-registry
+ * differential once (the running daemon has a single version). When the gap is
+ * beyond threshold the sensor DEFERS to the auto-update controller if that closer
+ * is active, and hands a human a ready action ONLY when it is not. Any handover
+ * is anchored to the first configured product for inbox visibility (the fact is
+ * process-global; all products share one org).
+ *
+ * Every path emits a trace so an absent signal means "measured and in sync".
+ */
+export declare function runStalenessSensorTick(config: DaemonConfig, deps?: StalenessSensorDeps): Promise<StalenessSensorTickCounts>;
+export {};
+//# sourceMappingURL=staleness-sensor.d.ts.map

package/dist/drift/staleness-sensor.d.ts.map

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