@mneme-ai/core 2.19.61 → 2.19.62

package/dist/phoenix/organs.d.ts

@@ -0,0 +1,110 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — 3 priority-1 organ bots.
+ *
+ * From the user's PHOENIX P5 spec — these are the first 3 bots, the
+ * minimum viable swarm. The remaining 5 (Forager, Scholar, Pulse-bot,
+ * Lighthouse, Vampire) ship in future sprints.
+ *
+ * The pattern: each organ is a PURE-FUNCTION step that:
+ *   1. Reads its inputs (HMAC ledger, OS handle table, latency metrics)
+ *   2. Computes a verdict (cleanup needed? integrity breached? restart?)
+ *   3. Returns structured result (no side effects unless explicitly committed)
+ *   4. Caller (daemon loop) decides whether to act on the verdict
+ *
+ * This separation means the organs are TESTABLE without spawning real
+ * processes + composable into custom schedulers.
+ */
+declare const PROTOCOL_VERSION = 1;
+export interface CustodianReport {
+    v: typeof PROTOCOL_VERSION;
+    organ: "custodian";
+    ts: string;
+    tmpDirsSwept: number;
+    tmpBytesReclaimed: number;
+    globalOrphansSwept: number;
+    totalReclaimedBytes: number;
+    durationMs: number;
+}
+/** Custodian cycle — sweeps stale per-PID tmp dirs + orphan .locked-* +
+ *  expired vaccines + fragmented logs. Safe to call from any interval.
+ *  Idempotent + non-throwing.
+ *
+ *  Default period 5min per spec; the daemon's tickAllOrgans loop drives
+ *  the scheduling, this function just runs one cycle. */
+export declare function runCustodianCycle(): CustodianReport;
+export interface SentinelReport {
+    v: typeof PROTOCOL_VERSION;
+    organ: "sentinel";
+    ts: string;
+    hmacChainOk: boolean;
+    hmacChainBrokenAt?: number;
+    handleCount: number;
+    handleBaseline: number;
+    handleLeakDetected: boolean;
+    durationMs: number;
+    recommendation: "healthy" | "warn-handle-leak" | "critical-chain-broken";
+}
+export interface SentinelOptions {
+    /** Function that returns current open-handle count (process-specific).
+     *  Caller injects this so the organ stays platform-agnostic. */
+    handleCounter?: () => number;
+    /** Baseline handle count to compare against. Default 50. */
+    handleBaseline?: number;
+    /** HMAC chain verifier — caller passes a function that checks their
+     *  existing chain (lineage / shepherd state / etc). Returns the chain
+     *  result so Sentinel can include it in the report. */
+    verifyHmacChain?: () => {
+        ok: boolean;
+        brokenAt?: number;
+    };
+}
+/** Sentinel cycle — verifies HMAC chain integrity + checks for handle
+ *  leaks. Pure function; no side effects. Caller decides escalation
+ *  (enter quarantine, alert, etc) based on verdict. */
+export declare function runSentinelCycle(opts?: SentinelOptions): SentinelReport;
+export interface OrganLatencyStats {
+    /** Organ name (e.g. "indexer", "embedder", "scan"). */
+    name: string;
+    /** Recent p99 latency in ms. */
+    p99Ms: number;
+    /** Historical baseline p99 in ms. */
+    baselineMs: number;
+    /** Optional: consecutive failure count. */
+    consecutiveFailures?: number;
+}
+export interface SurgeonReport {
+    v: typeof PROTOCOL_VERSION;
+    organ: "surgeon";
+    ts: string;
+    organsExamined: number;
+    organsToRestart: Array<{
+        name: string;
+        reason: string;
+        degradationFactor: number;
+    }>;
+    durationMs: number;
+}
+/** Surgeon cycle — examines per-organ latency stats + flags organs whose
+ *  p99 exceeds 3× baseline OR have 3+ consecutive failures. Returns a
+ *  list of organs caller should restart. Pure verdict; caller commits. */
+export declare function runSurgeonCycle(stats: OrganLatencyStats[], opts?: {
+    degradationFactor?: number;
+    maxConsecutiveFailures?: number;
+}): SurgeonReport;
+export interface AllOrgansReport {
+    v: typeof PROTOCOL_VERSION;
+    ts: string;
+    custodian: CustodianReport;
+    sentinel: SentinelReport;
+    surgeon: SurgeonReport;
+    durationMs: number;
+}
+/** Run all 3 priority-1 organs in one cycle. Used by daemon's tickAllOrgans
+ *  loop and the mneme.phoenix.organs_tick MCP tool. */
+export declare function runAllOrgans(opts?: {
+    sentinel?: SentinelOptions;
+    surgeonStats?: OrganLatencyStats[];
+    surgeonOpts?: Parameters<typeof runSurgeonCycle>[1];
+}): AllOrgansReport;
+export { PROTOCOL_VERSION };
+//# sourceMappingURL=organs.d.ts.map

package/dist/phoenix/organs.d.ts.map

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

package/dist/phoenix/organs.js

@@ -0,0 +1,154 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — 3 priority-1 organ bots.
+ *
+ * From the user's PHOENIX P5 spec — these are the first 3 bots, the
+ * minimum viable swarm. The remaining 5 (Forager, Scholar, Pulse-bot,
+ * Lighthouse, Vampire) ship in future sprints.
+ *
+ * The pattern: each organ is a PURE-FUNCTION step that:
+ *   1. Reads its inputs (HMAC ledger, OS handle table, latency metrics)
+ *   2. Computes a verdict (cleanup needed? integrity breached? restart?)
+ *   3. Returns structured result (no side effects unless explicitly committed)
+ *   4. Caller (daemon loop) decides whether to act on the verdict
+ *
+ * This separation means the organs are TESTABLE without spawning real
+ * processes + composable into custom schedulers.
+ */
+import { sweepOrphanTmpDirs } from "./dll_extraction.js";
+import { readdirSync, statSync, existsSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const PROTOCOL_VERSION = 1;
+/** Custodian cycle — sweeps stale per-PID tmp dirs + orphan .locked-* +
+ *  expired vaccines + fragmented logs. Safe to call from any interval.
+ *  Idempotent + non-throwing.
+ *
+ *  Default period 5min per spec; the daemon's tickAllOrgans loop drives
+ *  the scheduling, this function just runs one cycle. */
+export function runCustodianCycle() {
+    const t0 = Date.now();
+    // Sweep our own tmp dirs that belong to dead PIDs
+    const sweep = sweepOrphanTmpDirs();
+    // Sweep stale .locked-* files in ~/.mneme-global/
+    let globalOrphansSwept = 0;
+    try {
+        const organDir = join(homedir(), ".mneme-global");
+        if (existsSync(organDir)) {
+            const sweepLocked = (dir) => {
+                try {
+                    for (const entry of readdirSync(dir)) {
+                        const path = join(dir, entry);
+                        try {
+                            const st = statSync(path);
+                            if (st.isDirectory()) {
+                                sweepLocked(path); // recurse one level
+                                continue;
+                            }
+                            if (/\.locked-\d+-\d+$/.test(entry)) {
+                                try {
+                                    unlinkSync(path);
+                                    globalOrphansSwept++;
+                                }
+                                catch { /* */ }
+                            }
+                        }
+                        catch { /* */ }
+                    }
+                }
+                catch { /* */ }
+            };
+            sweepLocked(organDir);
+        }
+    }
+    catch { /* */ }
+    return {
+        v: PROTOCOL_VERSION,
+        organ: "custodian",
+        ts: new Date().toISOString(),
+        tmpDirsSwept: sweep.swept,
+        tmpBytesReclaimed: sweep.bytesReclaimed,
+        globalOrphansSwept,
+        totalReclaimedBytes: sweep.bytesReclaimed,
+        durationMs: Date.now() - t0,
+    };
+}
+/** Sentinel cycle — verifies HMAC chain integrity + checks for handle
+ *  leaks. Pure function; no side effects. Caller decides escalation
+ *  (enter quarantine, alert, etc) based on verdict. */
+export function runSentinelCycle(opts) {
+    const t0 = Date.now();
+    const baseline = opts?.handleBaseline ?? 50;
+    const handleCount = opts?.handleCounter ? opts.handleCounter() : -1;
+    const handleLeakDetected = handleCount > baseline * 2;
+    const chain = opts?.verifyHmacChain ? opts.verifyHmacChain() : { ok: true };
+    let recommendation = "healthy";
+    if (!chain.ok)
+        recommendation = "critical-chain-broken";
+    else if (handleLeakDetected)
+        recommendation = "warn-handle-leak";
+    return {
+        v: PROTOCOL_VERSION,
+        organ: "sentinel",
+        ts: new Date().toISOString(),
+        hmacChainOk: chain.ok,
+        ...(chain.brokenAt !== undefined ? { hmacChainBrokenAt: chain.brokenAt } : {}),
+        handleCount,
+        handleBaseline: baseline,
+        handleLeakDetected,
+        durationMs: Date.now() - t0,
+        recommendation,
+    };
+}
+/** Surgeon cycle — examines per-organ latency stats + flags organs whose
+ *  p99 exceeds 3× baseline OR have 3+ consecutive failures. Returns a
+ *  list of organs caller should restart. Pure verdict; caller commits. */
+export function runSurgeonCycle(stats, opts) {
+    const t0 = Date.now();
+    const degradationFactor = opts?.degradationFactor ?? 3;
+    const maxConsecutiveFailures = opts?.maxConsecutiveFailures ?? 3;
+    const organsToRestart = [];
+    for (const stat of stats) {
+        const factor = stat.baselineMs > 0 ? stat.p99Ms / stat.baselineMs : 0;
+        if (factor >= degradationFactor) {
+            organsToRestart.push({
+                name: stat.name,
+                reason: `p99 ${stat.p99Ms}ms is ${factor.toFixed(1)}x baseline ${stat.baselineMs}ms (threshold ${degradationFactor}x)`,
+                degradationFactor: factor,
+            });
+            continue;
+        }
+        if ((stat.consecutiveFailures ?? 0) >= maxConsecutiveFailures) {
+            organsToRestart.push({
+                name: stat.name,
+                reason: `${stat.consecutiveFailures} consecutive failures (threshold ${maxConsecutiveFailures})`,
+                degradationFactor: 0,
+            });
+        }
+    }
+    return {
+        v: PROTOCOL_VERSION,
+        organ: "surgeon",
+        ts: new Date().toISOString(),
+        organsExamined: stats.length,
+        organsToRestart,
+        durationMs: Date.now() - t0,
+    };
+}
+/** Run all 3 priority-1 organs in one cycle. Used by daemon's tickAllOrgans
+ *  loop and the mneme.phoenix.organs_tick MCP tool. */
+export function runAllOrgans(opts) {
+    const t0 = Date.now();
+    const custodian = runCustodianCycle();
+    const sentinel = runSentinelCycle(opts?.sentinel);
+    const surgeon = runSurgeonCycle(opts?.surgeonStats ?? [], opts?.surgeonOpts);
+    return {
+        v: PROTOCOL_VERSION,
+        ts: new Date().toISOString(),
+        custodian,
+        sentinel,
+        surgeon,
+        durationMs: Date.now() - t0,
+    };
+}
+export { PROTOCOL_VERSION };
+//# sourceMappingURL=organs.js.map

package/dist/phoenix/organs.js.map

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

package/dist/phoenix/organs.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * v2.19.62 PHOENIX P5 — 3 priority-1 organs deep tests.
+ *
+ * Custodian / Sentinel / Surgeon — each is a pure function returning a
+ * verdict. Tests cover: shape of reports, threshold semantics, idempotence,
+ * composability via runAllOrgans.
+ */
+export {};
+//# sourceMappingURL=organs.test.d.ts.map

package/dist/phoenix/organs.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organs.test.d.ts","sourceRoot":"","sources":["../../src/phoenix/organs.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/phoenix/organs.test.js

@@ -0,0 +1,189 @@
+/**
+ * v2.19.62 PHOENIX P5 — 3 priority-1 organs deep tests.
+ *
+ * Custodian / Sentinel / Surgeon — each is a pure function returning a
+ * verdict. Tests cover: shape of reports, threshold semantics, idempotence,
+ * composability via runAllOrgans.
+ */
+import { describe, it, expect } from "vitest";
+import { runCustodianCycle, runSentinelCycle, runSurgeonCycle, runAllOrgans, PROTOCOL_VERSION, } from "./organs.js";
+describe("v2.19.62 organs PROTOCOL_VERSION", () => {
+    it("is 1", () => {
+        expect(PROTOCOL_VERSION).toBe(1);
+    });
+});
+describe("v2.19.62 Custodian organ", () => {
+    it("returns structured CustodianReport", () => {
+        const r = runCustodianCycle();
+        expect(r.v).toBe(1);
+        expect(r.organ).toBe("custodian");
+        expect(typeof r.ts).toBe("string");
+        expect(r.tmpDirsSwept).toBeGreaterThanOrEqual(0);
+        expect(r.tmpBytesReclaimed).toBeGreaterThanOrEqual(0);
+        expect(r.globalOrphansSwept).toBeGreaterThanOrEqual(0);
+        expect(r.totalReclaimedBytes).toBeGreaterThanOrEqual(0);
+        expect(r.durationMs).toBeGreaterThanOrEqual(0);
+    });
+    it("never throws on missing ~/.mneme-global", () => {
+        expect(() => runCustodianCycle()).not.toThrow();
+    });
+    it("idempotent — second cycle finds nothing new", () => {
+        const r1 = runCustodianCycle();
+        const r2 = runCustodianCycle();
+        expect(r2.tmpDirsSwept).toBeLessThanOrEqual(r1.tmpDirsSwept + 5); // best-effort
+    });
+});
+describe("v2.19.62 Sentinel organ", () => {
+    it("returns healthy when no opts provided", () => {
+        const r = runSentinelCycle();
+        expect(r.organ).toBe("sentinel");
+        expect(r.hmacChainOk).toBe(true);
+        expect(r.handleCount).toBe(-1); // No counter injected
+        expect(r.handleBaseline).toBe(50);
+        expect(r.handleLeakDetected).toBe(false);
+        expect(r.recommendation).toBe("healthy");
+    });
+    it("detects handle leak when count > baseline×2", () => {
+        const r = runSentinelCycle({ handleCounter: () => 200, handleBaseline: 50 });
+        expect(r.handleCount).toBe(200);
+        expect(r.handleLeakDetected).toBe(true);
+        expect(r.recommendation).toBe("warn-handle-leak");
+    });
+    it("does NOT flag leak when count == baseline×2 (strict >)", () => {
+        const r = runSentinelCycle({ handleCounter: () => 100, handleBaseline: 50 });
+        expect(r.handleLeakDetected).toBe(false);
+        expect(r.recommendation).toBe("healthy");
+    });
+    it("escalates to critical when HMAC chain broken", () => {
+        const r = runSentinelCycle({
+            verifyHmacChain: () => ({ ok: false, brokenAt: 42 }),
+        });
+        expect(r.hmacChainOk).toBe(false);
+        expect(r.hmacChainBrokenAt).toBe(42);
+        expect(r.recommendation).toBe("critical-chain-broken");
+    });
+    it("critical chain-broken takes precedence over handle leak", () => {
+        const r = runSentinelCycle({
+            handleCounter: () => 500,
+            handleBaseline: 50,
+            verifyHmacChain: () => ({ ok: false }),
+        });
+        expect(r.recommendation).toBe("critical-chain-broken");
+    });
+    it("custom baseline respected", () => {
+        const r = runSentinelCycle({ handleCounter: () => 250, handleBaseline: 200 });
+        expect(r.handleBaseline).toBe(200);
+        // 250 not > 200×2=400, so no leak
+        expect(r.handleLeakDetected).toBe(false);
+    });
+});
+describe("v2.19.62 Surgeon organ", () => {
+    it("returns empty restart list when all healthy", () => {
+        const stats = [
+            { name: "indexer", p99Ms: 100, baselineMs: 90 },
+            { name: "embedder", p99Ms: 50, baselineMs: 40 },
+        ];
+        const r = runSurgeonCycle(stats);
+        expect(r.organsExamined).toBe(2);
+        expect(r.organsToRestart).toEqual([]);
+    });
+    it("flags organ with 3× p99 degradation", () => {
+        const stats = [
+            { name: "indexer", p99Ms: 3000, baselineMs: 1000 },
+        ];
+        const r = runSurgeonCycle(stats);
+        expect(r.organsToRestart.length).toBe(1);
+        expect(r.organsToRestart[0].name).toBe("indexer");
+        expect(r.organsToRestart[0].degradationFactor).toBeCloseTo(3, 1);
+    });
+    it("does NOT flag organ at 2.9× degradation (under threshold)", () => {
+        const stats = [
+            { name: "borderline", p99Ms: 2900, baselineMs: 1000 },
+        ];
+        const r = runSurgeonCycle(stats);
+        expect(r.organsToRestart.length).toBe(0);
+    });
+    it("custom degradationFactor respected", () => {
+        const stats = [
+            { name: "loose-threshold", p99Ms: 1500, baselineMs: 1000 },
+        ];
+        const r = runSurgeonCycle(stats, { degradationFactor: 1.4 });
+        expect(r.organsToRestart.length).toBe(1);
+    });
+    it("flags organ on consecutive failures even when latency healthy", () => {
+        const stats = [
+            { name: "flaky", p99Ms: 100, baselineMs: 90, consecutiveFailures: 5 },
+        ];
+        const r = runSurgeonCycle(stats);
+        expect(r.organsToRestart.length).toBe(1);
+        expect(r.organsToRestart[0].reason).toContain("consecutive failures");
+    });
+    it("custom maxConsecutiveFailures respected", () => {
+        const stats = [
+            { name: "borderline-flake", p99Ms: 100, baselineMs: 90, consecutiveFailures: 2 },
+        ];
+        const r1 = runSurgeonCycle(stats);
+        expect(r1.organsToRestart.length).toBe(0); // default 3
+        const r2 = runSurgeonCycle(stats, { maxConsecutiveFailures: 2 });
+        expect(r2.organsToRestart.length).toBe(1);
+    });
+    it("avoids divide-by-zero when baseline=0", () => {
+        const stats = [
+            { name: "no-baseline", p99Ms: 10000, baselineMs: 0 },
+        ];
+        expect(() => runSurgeonCycle(stats)).not.toThrow();
+        const r = runSurgeonCycle(stats);
+        // baseline=0 short-circuits the ratio check to 0, no restart unless failures hit
+        expect(r.organsToRestart.length).toBe(0);
+    });
+    it("handles empty stats array", () => {
+        const r = runSurgeonCycle([]);
+        expect(r.organsExamined).toBe(0);
+        expect(r.organsToRestart).toEqual([]);
+    });
+    it("reports include precise reason string", () => {
+        const stats = [
+            { name: "slow", p99Ms: 5000, baselineMs: 1000 },
+        ];
+        const r = runSurgeonCycle(stats);
+        expect(r.organsToRestart[0].reason).toContain("5000ms");
+        expect(r.organsToRestart[0].reason).toContain("1000ms");
+        expect(r.organsToRestart[0].reason).toContain("5.0x");
+    });
+});
+describe("v2.19.62 runAllOrgans composed cycle", () => {
+    it("returns all 3 reports in one call", () => {
+        const r = runAllOrgans();
+        expect(r.custodian.organ).toBe("custodian");
+        expect(r.sentinel.organ).toBe("sentinel");
+        expect(r.surgeon.organ).toBe("surgeon");
+        expect(r.durationMs).toBeGreaterThanOrEqual(0);
+    });
+    it("passes through Sentinel options", () => {
+        const r = runAllOrgans({
+            sentinel: { handleCounter: () => 999, handleBaseline: 10 },
+        });
+        expect(r.sentinel.handleCount).toBe(999);
+        expect(r.sentinel.handleLeakDetected).toBe(true);
+    });
+    it("passes through Surgeon stats", () => {
+        const r = runAllOrgans({
+            surgeonStats: [{ name: "x", p99Ms: 10000, baselineMs: 1000 }],
+        });
+        expect(r.surgeon.organsExamined).toBe(1);
+        expect(r.surgeon.organsToRestart.length).toBe(1);
+    });
+    it("composed duration is sum-or-less of individual organs", () => {
+        const r = runAllOrgans();
+        expect(r.durationMs).toBeGreaterThanOrEqual(0);
+        // Each sub-organ duration should be ≤ total
+        expect(r.custodian.durationMs).toBeLessThanOrEqual(r.durationMs + 10);
+        expect(r.sentinel.durationMs).toBeLessThanOrEqual(r.durationMs + 10);
+        expect(r.surgeon.durationMs).toBeLessThanOrEqual(r.durationMs + 10);
+    });
+    it("never throws on bad input", () => {
+        expect(() => runAllOrgans({ surgeonStats: [] })).not.toThrow();
+        expect(() => runAllOrgans({ sentinel: {} })).not.toThrow();
+    });
+});
+//# sourceMappingURL=organs.test.js.map

package/dist/phoenix/organs.test.js.map

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

package/dist/phoenix/scout.d.ts

@@ -0,0 +1,74 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — SCOUT (P4 step 1: passive npm registry probe).
+ *
+ * The first step of the PHOENIX Auto-Upgrade Protocol. Scout's only job is
+ * to passively observe the npm registry — never to spawn npm install, never
+ * to mutate the filesystem, never to interrupt the daemon. Read-only by
+ * design so it can run on every daemon tick without amplifying load.
+ *
+ * Behavior:
+ *   1. Hit https://registry.npmjs.org/mneme-ai/latest (HTTP HEAD-or-GET)
+ *   2. Compare returned `version` to the running version (passed by caller)
+ *   3. Cache result for `cacheTtlMs` (default 5min) so repeated calls don't
+ *      hammer the registry
+ *   4. Return verdict: up-to-date | upgrade-available | unreachable
+ *
+ * Pure observation. Caller (daemon or PHOENIX Queen in Phase 2) decides
+ * what to do with the verdict — start a cocoon, push an inbox alert, or
+ * sit on the data until conditions are right.
+ *
+ * Cache is in-memory only. Persistent state (last-checked timestamp,
+ * upgrade history) belongs in the daemon's heartbeat ledger, not here.
+ *
+ * Network-failure semantics: ALL failures return `unreachable` — never
+ * throw. The daemon must remain alive even when offline.
+ */
+declare const PROTOCOL_VERSION = 1;
+export type ScoutVerdict = "up-to-date" | "upgrade-available" | "unreachable";
+export interface ScoutReport {
+    v: typeof PROTOCOL_VERSION;
+    organ: "scout";
+    ts: string;
+    verdict: ScoutVerdict;
+    packageName: string;
+    runningVersion: string;
+    latestVersion: string | null;
+    cacheHit: boolean;
+    cacheAgeMs: number;
+    durationMs: number;
+    reachability: {
+        registry: string;
+        httpStatus?: number;
+        error?: string;
+    };
+}
+export interface ScoutOptions {
+    packageName?: string;
+    registry?: string;
+    cacheTtlMs?: number;
+    timeoutMs?: number;
+    /** Inject a fetcher for tests. Should return the parsed registry response
+     *  ({version: "x.y.z", ...}) or throw on failure. */
+    fetchLatest?: (registry: string, packageName: string, timeoutMs: number) => Promise<{
+        version: string;
+        httpStatus?: number;
+    }>;
+    /** Optional explicit clock for tests (ms since epoch). */
+    now?: () => number;
+}
+/** Compare two semver-ish strings. Returns positive when `a > b`, 0 when
+ *  equal, negative when `a < b`. Strips leading "v" and any pre-release
+ *  suffix after the first hyphen. Safe-default — non-numeric segments
+ *  compared as 0. */
+export declare function compareVersions(a: string, b: string): number;
+/** Probe the npm registry for the latest version of a package. Returns a
+ *  structured verdict. Never throws — failures become `unreachable` so the
+ *  daemon loop is undisturbed. */
+export declare function runScoutCycle(runningVersion: string, opts?: ScoutOptions): Promise<ScoutReport>;
+/** Clear Scout's in-memory cache. Used by tests + after a successful
+ *  upgrade so the next probe sees fresh state. */
+export declare function clearScoutCache(): void;
+/** Inspect current cache size (testing/debug). */
+export declare function scoutCacheSize(): number;
+export { PROTOCOL_VERSION };
+//# sourceMappingURL=scout.d.ts.map

package/dist/phoenix/scout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scout.d.ts","sourceRoot":"","sources":["../../src/phoenix/scout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,QAAA,MAAM,gBAAgB,IAAI,CAAC;AAM3B,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,mBAAmB,GACnB,aAAa,CAAC;AAElB,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,OAAO,gBAAgB,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;yDACqD;IACrD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9H,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAYD;;;qBAGqB;AACrB,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5D;AAuCD;;kCAEkC;AAClC,wBAAsB,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAwDrG;AAED;kDACkD;AAClD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}