@ouro.bot/cli 0.1.0-alpha.662 → 0.1.0-alpha.664

package/dist/heart/daemon/agent-config-check.js

@@ -318,6 +318,8 @@ async function checkAgentConfigWithProviderHealth(agentName, bundlesRoot, deps =
         return selectionResult.result;
     if (selectionResult.disabled)
         return { ok: true };
+    const agentRoot = agentRootFor(agentName, bundlesRoot);
+    const shouldRecordReadiness = deps.recordReadiness !== false;
     deps.onProgress?.(selectedProviderPlan(agentName, selectionResult.bindings));
     const ping = deps.pingProvider ?? (await Promise.resolve().then(() => __importStar(require("../provider-ping")))).pingProvider;
     const providers = selectedProvidersForBindings(selectionResult.bindings);
@@ -375,32 +377,38 @@ async function checkAgentConfigWithProviderHealth(agentName, bundlesRoot, deps =
     for (const { group, result } of pingResults) {
         if (!result.ok) {
             for (const lane of group.lanes) {
+                if (shouldRecordReadiness) {
+                    (0, provider_readiness_cache_1.recordProviderLaneReadiness)({
+                        agentRoot,
+                        agentName,
+                        lane,
+                        provider: group.provider,
+                        model: group.model,
+                        credentialRevision: group.record.revision,
+                        status: "failed",
+                        checkedAt: new Date().toISOString(),
+                        error: result.message,
+                        attempts: pingAttemptCount(result),
+                    });
+                }
+            }
+            firstFailure ??= failedPingResult(agentName, group.lanes[0], group.provider, group.model, result);
+            continue;
+        }
+        for (const lane of group.lanes) {
+            if (shouldRecordReadiness) {
                 (0, provider_readiness_cache_1.recordProviderLaneReadiness)({
+                    agentRoot,
                     agentName,
                     lane,
                     provider: group.provider,
                     model: group.model,
                     credentialRevision: group.record.revision,
-                    status: "failed",
+                    status: "ready",
                     checkedAt: new Date().toISOString(),
-                    error: result.message,
                     attempts: pingAttemptCount(result),
                 });
             }
-            firstFailure ??= failedPingResult(agentName, group.lanes[0], group.provider, group.model, result);
-            continue;
-        }
-        for (const lane of group.lanes) {
-            (0, provider_readiness_cache_1.recordProviderLaneReadiness)({
-                agentName,
-                lane,
-                provider: group.provider,
-                model: group.model,
-                credentialRevision: group.record.revision,
-                status: "ready",
-                checkedAt: new Date().toISOString(),
-                attempts: pingAttemptCount(result),
-            });
         }
     }
     if (firstFailure)

package/dist/heart/daemon/cli-exec.js

@@ -76,6 +76,7 @@ const provider_credentials_1 = require("../provider-credentials");
 const runtime_credentials_1 = require("../runtime-credentials");
 const provider_binding_resolver_1 = require("../provider-binding-resolver");
 const provider_visibility_1 = require("../provider-visibility");
+const context_loss_sentinel_1 = require("../context-loss-sentinel");
 const machine_identity_1 = require("../machine-identity");
 const provider_models_1 = require("../provider-models");
 const ouro_version_manager_1 = require("../versioning/ouro-version-manager");
@@ -110,6 +111,7 @@ const stale_bundle_prune_1 = require("./stale-bundle-prune");
 const up_progress_1 = require("./up-progress");
 const provider_ping_progress_1 = require("./provider-ping-progress");
 const provider_ping_1 = require("../provider-ping");
+const provider_readiness_cache_1 = require("../provider-readiness-cache");
 const agent_discovery_1 = require("./agent-discovery");
 const boot_sync_probe_1 = require("./boot-sync-probe");
 const connect_bay_1 = require("./connect-bay");
@@ -368,6 +370,8 @@ function agentResolutionFailureMode(command) {
         case "attention.history":
         case "work.card":
         case "work.gauntlet":
+        case "work.sentinel":
+        case "work.sentinel.refresh":
         case "inner.status":
         case "session.list":
             return "return-message";
@@ -4628,6 +4632,11 @@ function credentialPingConfig(record) {
         ...record.config,
     };
 }
+function pingAttemptCount(result) {
+    if (Array.isArray(result.attempts))
+        return result.attempts.length;
+    return undefined;
+}
 async function readProviderCredentialRecord(agent, provider, _deps, options = {}) {
     const poolResult = await (0, provider_credentials_1.refreshProviderCredentialPool)(agent, { ...options, providers: [provider] });
     if (poolResult.ok) {
@@ -4764,7 +4773,8 @@ async function executeProviderCheck(command, deps) {
         return message;
     };
     try {
-        const { config } = (0, auth_flow_1.readAgentConfigForAgent)(command.agent, deps.bundlesRoot);
+        const { config, configPath } = (0, auth_flow_1.readAgentConfigForAgent)(command.agent, deps.bundlesRoot);
+        const agentRoot = path.dirname(configPath);
         const binding = providerConfigBinding(config, command.lane);
         progress.startPhase(`reading ${binding.provider} credentials`);
         const credential = await readProviderCredentialRecord(command.agent, binding.provider, deps, {
@@ -4788,6 +4798,19 @@ async function executeProviderCheck(command, deps) {
         });
         const status = pingResult.ok ? "ready" : `failed (${pingResult.message})`;
         progress.completePhase(`checking ${binding.provider} / ${binding.model}`, status);
+        const attempts = pingAttemptCount(pingResult);
+        (0, provider_readiness_cache_1.recordProviderLaneReadiness)({
+            agentRoot,
+            agentName: command.agent,
+            lane: command.lane,
+            provider: binding.provider,
+            model: binding.model,
+            credentialRevision: credential.record.revision,
+            status: pingResult.ok ? "ready" : "failed",
+            checkedAt: new Date().toISOString(),
+            ...(pingResult.ok ? {} : { error: pingResult.message }),
+            ...(attempts === undefined ? {} : { attempts }),
+        });
         const message = `${command.agent} ${command.lane} ${binding.provider} / ${binding.model}: ${status}`;
         (0, runtime_1.emitNervesEvent)({
             component: "daemon",
@@ -5573,6 +5596,40 @@ function resolveClonePath(options, checkExists, deps) {
     return cloneTarget;
 }
 /* v8 ignore stop */
+const HOOK_SENTINEL_LOCK_TIMEOUT_MS = 500;
+function hookSentinelGitStatus() {
+    return {
+        ok: false,
+        error: "skipped during session-start hook to keep lifecycle hook bounded; run `ouro work sentinel refresh --agent <agent>` for full bundle git status",
+    };
+}
+async function refreshHookSentinel(command, deps) {
+    if (command.event !== "session-start")
+        return;
+    const bundlesRoot = deps.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)();
+    const bundleRoot = path.join(bundlesRoot, `${command.agent}.ouro`);
+    try {
+        await (0, context_loss_sentinel_1.refreshContextLossSentinel)(command.agent, bundleRoot, {
+            trigger: "session_start",
+            lockTimeoutMs: HOOK_SENTINEL_LOCK_TIMEOUT_MS,
+            gitStatus: hookSentinelGitStatus,
+        });
+    }
+    catch (error) {
+        (0, runtime_1.emitNervesEvent)({
+            level: "warn",
+            component: "daemon",
+            event: "daemon.hook_sentinel_refresh_error",
+            message: "claude code hook Sentinel refresh failed",
+            meta: {
+                agent: command.agent,
+                eventType: command.event,
+                lockTimeoutMs: HOOK_SENTINEL_LOCK_TIMEOUT_MS,
+                error: error instanceof Error ? error.message : String(error),
+            },
+        });
+    }
+}
 // ── Main CLI execution ──
 async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDeps)()) {
     if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
@@ -5622,6 +5679,9 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
         throw new Error(resolvedCommand.message);
     }
     let command = resolvedCommand.command;
+    if (command.kind === "hook") {
+        await refreshHookSentinel(command, deps);
+    }
     if (args.length === 0) {
         const discovered = await Promise.resolve(deps.listDiscoveredAgents ? deps.listDiscoveredAgents() : (0, cli_defaults_1.defaultListDiscoveredAgents)());
         /* v8 ignore start -- the interactive home shell is exercised extensively in daemon-cli tests; V8 miscounts this orchestrator because it chains through recursive command handoffs and early chat health exits @preserve */
@@ -7343,6 +7403,22 @@ async function runOuroCli(args, deps = (0, cli_defaults_1.createDefaultOuroCliDe
         deps.writeStdout(message);
         return message;
     }
+    // ── context-loss Sentinel (local, no daemon socket needed) ──
+    if (command.kind === "work.sentinel" || command.kind === "work.sentinel.refresh") {
+        const { formatContextLossSentinelJson, formatContextLossSentinelText, readContextLossSentinelView, refreshContextLossSentinel, } = await Promise.resolve().then(() => __importStar(require("../context-loss-sentinel")));
+        if (!command.agent)
+            throw new Error("work sentinel requires --agent <name>");
+        const bundlesRoot = deps.bundlesRoot ?? (0, identity_1.getAgentBundlesRoot)();
+        const agentRoot = deps.agentBundleRoot ?? path.join(bundlesRoot, `${command.agent}.ouro`);
+        const sentinel = command.kind === "work.sentinel.refresh"
+            ? await refreshContextLossSentinel(command.agent, agentRoot, { trigger: "manual_cli", homeDir: deps.homeDir })
+            : readContextLossSentinelView(agentRoot, { limit: 20 });
+        const message = command.format === "json"
+            ? formatContextLossSentinelJson(sentinel)
+            : formatContextLossSentinelText(sentinel);
+        deps.writeStdout(message);
+        return message;
+    }
     // ── inner dialog status (local, no daemon socket needed) ──
     /* v8 ignore start -- inner status handler: requires real agent state on disk @preserve */
     if (command.kind === "inner.status") {

package/dist/heart/daemon/cli-help.js

@@ -153,10 +153,10 @@ exports.COMMAND_REGISTRY = {
     },
     work: {
         category: "Tasks",
-        description: "Show durable Arc work state or run the context-loss gauntlet.",
-        usage: "ouro work card|gauntlet [--agent <name>] [--format text|json|--json]",
-        example: "ouro work gauntlet --agent slugger --format json",
-        subcommands: ["card", "gauntlet"],
+        description: "Show durable Arc work state, recovery Sentinel state, or run the context-loss gauntlet.",
+        usage: "ouro work card|gauntlet|sentinel [refresh] [--agent <name>] [--format text|json|--json]",
+        example: "ouro work sentinel --agent slugger --format json",
+        subcommands: ["card", "gauntlet", "sentinel"],
     },
     "work card": {
         category: "Tasks",
@@ -172,6 +172,13 @@ exports.COMMAND_REGISTRY = {
         example: "ouro work gauntlet --agent slugger --format json",
         hidden: true,
     },
+    "work sentinel": {
+        category: "Tasks",
+        description: "Show read-only Arc Sentinel recovery state, or explicitly refresh it.",
+        usage: "ouro work sentinel [refresh] [--agent <name>] [--format text|json|--json]",
+        example: "ouro work sentinel refresh --agent slugger --format json",
+        hidden: true,
+    },
     "migrate-to-desk": {
         category: "Tasks",
         description: "Migrate a legacy `tasks/` tree into the new `desk/` shape (copy semantics — source untouched).",

package/dist/heart/daemon/cli-parse.js

@@ -114,7 +114,7 @@ function usage() {
         "  ouro friend create --name <name> [--trust <level>] [--agent <name>]",
         "  ouro friend update <id> --trust <level> [--agent <name>]",
         "  ouro thoughts [--last <n>] [--json] [--follow] [--agent <name>]",
-        "  ouro work card|gauntlet [--agent <name>] [--format text|json|--json]",
+        "  ouro work card|gauntlet|sentinel [refresh] [--agent <name>] [--format text|json|--json]",
         "  ouro inner [--agent <name>]",
         "  ouro friend link <agent> --friend <id> --provider <p> --external-id <eid>",
         "  ouro friend unlink <agent> --friend <id> --provider <p> --external-id <eid>",
@@ -985,11 +985,13 @@ function parseProviderCheckCommand(args) {
 }
 function parseProviderCommand(args) {
     const sub = args[0];
+    if (sub === "check")
+        return parseProviderCheckCommand(args.slice(1));
     const { agent, rest } = extractAgentFlag(args.slice(1));
     if (sub === "refresh" && rest.length === 0) {
         return { kind: "provider.refresh", ...(agent ? { agent } : {}) };
     }
-    throw new Error("Usage: ouro provider refresh [--agent <name>]");
+    throw new Error("Usage: ouro provider refresh [--agent <name>] OR ouro provider check [--agent <name>] --lane outward|inner");
 }
 function parseSessionCommand(args) {
     const { agent, rest: cleaned } = extractAgentFlag(args);
@@ -1011,28 +1013,42 @@ function parseAttentionCommand(args) {
     }
     return { kind: "attention.list", ...(agent ? { agent } : {}) };
 }
-function parseWorkCommand(args) {
-    const { agent, rest: cleaned } = extractAgentFlag(args);
-    const sub = cleaned[0];
-    if (sub !== "card" && sub !== "gauntlet") {
-        throw new Error("Usage: ouro work card|gauntlet [--agent <name>] [--format text|json|--json]");
-    }
+function parseWorkFormat(args, usageText) {
     let format = "text";
-    for (let i = 1; i < cleaned.length; i += 1) {
-        if (cleaned[i] === "--json") {
+    for (let i = 0; i < args.length; i += 1) {
+        if (args[i] === "--json") {
             format = "json";
             continue;
         }
-        if (cleaned[i] === "--format" && cleaned[i + 1]) {
-            const value = cleaned[++i];
+        if (args[i] === "--format" && args[i + 1]) {
+            const value = args[++i];
             if (value !== "text" && value !== "json") {
                 throw new Error("--format must be text or json");
             }
             format = value;
             continue;
         }
-        throw new Error(`Usage: ouro work ${sub} [--agent <name>] [--format text|json|--json]`);
+        throw new Error(usageText);
+    }
+    return format;
+}
+function parseWorkCommand(args) {
+    const { agent, rest: cleaned } = extractAgentFlag(args);
+    const sub = cleaned[0];
+    if (sub === "sentinel") {
+        const refresh = cleaned[1] === "refresh";
+        const usageText = "Usage: ouro work sentinel [refresh] [--agent <name>] [--format text|json|--json]";
+        const format = parseWorkFormat(cleaned.slice(refresh ? 2 : 1), usageText);
+        return {
+            kind: refresh ? "work.sentinel.refresh" : "work.sentinel",
+            ...(agent ? { agent } : {}),
+            ...(format !== "text" ? { format } : {}),
+        };
+    }
+    if (sub !== "card" && sub !== "gauntlet") {
+        throw new Error("Usage: ouro work card|gauntlet|sentinel [refresh] [--agent <name>] [--format text|json|--json]");
     }
+    const format = parseWorkFormat(cleaned.slice(1), `Usage: ouro work ${sub} [--agent <name>] [--format text|json|--json]`);
     return { kind: sub === "card" ? "work.card" : "work.gauntlet", ...(agent ? { agent } : {}), ...(format !== "text" ? { format } : {}) };
 }
 function parseThoughtsCommand(args) {

package/dist/heart/daemon/daemon-entry.js

@@ -62,6 +62,7 @@ const pulse_1 = require("./pulse");
 const socket_client_1 = require("./socket-client");
 const bundle_manifest_1 = require("../../mind/bundle-manifest");
 const mcp_canary_1 = require("./mcp-canary");
+const context_loss_sentinel_1 = require("../context-loss-sentinel");
 function parseSocketPath(argv) {
     const socketIndex = argv.indexOf("--socket");
     if (socketIndex >= 0) {
@@ -92,6 +93,31 @@ if (mode === "dev") {
     });
 }
 const managedAgents = (0, agent_discovery_1.listEnabledBundleAgents)();
+function sentinelHealthStatus(receipt) {
+    if (receipt.verdict === "ready")
+        return "ok";
+    if (receipt.verdict === "watch")
+        return "warn";
+    return "critical";
+}
+async function refreshDaemonSentinel(agent, trigger, daemonHealthResults = []) {
+    const bundleRoot = path.join((0, identity_1.getAgentBundlesRoot)(), `${agent}.ouro`);
+    try {
+        const receipt = await (0, context_loss_sentinel_1.refreshContextLossSentinel)(agent, bundleRoot, { trigger, daemonHealthResults });
+        return {
+            name: `context-loss-sentinel:${agent}`,
+            status: sentinelHealthStatus(receipt),
+            message: `Sentinel ${receipt.verdict}: ${receipt.summary}`,
+        };
+    }
+    catch (error) {
+        return {
+            name: `context-loss-sentinel:${agent}`,
+            status: "critical",
+            message: `Sentinel refresh failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
 const processManager = new process_manager_1.DaemonProcessManager({
     agents: managedAgents.map((agent) => ({
         name: agent,
@@ -133,6 +159,7 @@ const senseManager = new sense_manager_1.DaemonSenseManager({
 const healthMonitor = new health_monitor_1.HealthMonitor({
     processManager,
     scheduler,
+    sentinelChecker: (resultsSoFar) => Promise.all(managedAgents.map((agent) => refreshDaemonSentinel(agent, "daemon_health", resultsSoFar))),
     senseProbeProvider: () => [
         ...senseManager.listHealthProbes(),
         ...managedAgents.map((agent) => (0, mcp_canary_1.createMcpStatusCanaryProbe)({
@@ -349,11 +376,12 @@ function writeStopCommandHealthState() {
     }
 }
 /* v8 ignore start -- habit wiring: lambdas delegate to processManager/fs; tested via HabitScheduler unit tests @preserve */
-void daemon.start().then(() => {
+void daemon.start().then(async () => {
     const bundlesRoot = (0, identity_1.getAgentBundlesRoot)();
     const ouroPath = (0, os_cron_deps_1.resolveOuroBinaryPath)();
     const osCronDeps = (0, os_cron_deps_1.createRealOsCronDeps)();
     for (const agent of managedAgents) {
+        await refreshDaemonSentinel(agent, "daemon_startup");
         const bundleRoot = path.join(bundlesRoot, `${agent}.ouro`);
         const habitsDir = path.join(bundleRoot, "habits");
         const degradedComponent = `habits:${agent}`;

package/dist/heart/daemon/health-monitor.js

@@ -7,6 +7,7 @@ class HealthMonitor {
     scheduler;
     alertSink;
     diskUsagePercent;
+    sentinelChecker;
     onCriticalAgent;
     onCriticalSense;
     senseProbes;
@@ -18,6 +19,7 @@ class HealthMonitor {
         this.scheduler = options.scheduler;
         this.alertSink = options.alertSink ?? (() => undefined);
         this.diskUsagePercent = options.diskUsagePercent ?? (() => 0);
+        this.sentinelChecker = options.sentinelChecker ?? (() => []);
         this.onCriticalAgent = options.onCriticalAgent ?? (() => undefined);
         this.onCriticalSense = options.onCriticalSense ?? (() => undefined);
         this.senseProbes = options.senseProbes ?? [];
@@ -178,6 +180,7 @@ class HealthMonitor {
                 });
             }
         }
+        results.push(...await this.sentinelChecker(results.map((result) => ({ ...result }))));
         this.lastResults = results.map((result) => ({ ...result }));
         for (const result of results) {
             (0, runtime_1.emitNervesEvent)({

package/dist/heart/hatch/hatch-flow.js

@@ -125,6 +125,8 @@ function writeRecordScaffold(bundleRoot) {
     fs.writeFileSync(recordPaths.entitiesPath, "{}\n", "utf-8");
     fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "events"), { recursive: true });
     fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "habit-receipts"), { recursive: true });
+    fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "context-loss-sentinel", "history"), { recursive: true });
+    fs.mkdirSync(path.join(bundleRoot, "arc", "flight-recorder", "context-loss-sentinel", "receipts"), { recursive: true });
     fs.mkdirSync(path.join(bundleRoot, "arc", "claims"), { recursive: true });
 }
 function writeHatchlingAgentConfig(bundleRoot, input) {

package/dist/heart/mailbox/mailbox-http-hooks.js

@@ -55,6 +55,7 @@ function createMailboxHttpReadHooks(options) {
         readAgentChanges: options.readAgentChanges ?? ((agentName) => (0, mailbox_read_1.readChangesView)(agentRoot(agentName))),
         readAgentSelfFix: options.readAgentSelfFix ?? ((agentName) => (0, mailbox_read_1.readSelfFixView)(agentRoot(agentName))),
         readAgentContextLossGauntlet: options.readAgentContextLossGauntlet ?? ((agentName) => (0, mailbox_read_1.readContextLossGauntletView)(agentRoot(agentName), agentName)),
+        readAgentSentinel: options.readAgentSentinel ?? ((agentName) => (0, mailbox_read_1.readSentinelView)(agentRoot(agentName))),
         readAgentNoteDecisions: options.readAgentNoteDecisions ?? ((agentName) => (0, mailbox_read_1.readNoteDecisionView)(agentRoot(agentName))),
         readAgentHabits: options.readAgentHabits ?? ((agentName) => (0, mailbox_read_1.readHabitView)(agentRoot(agentName))),
         readAgentMail: options.readAgentMail ?? ((agentName) => (0, mailbox_read_1.readMailView)(agentName)),

package/dist/heart/mailbox/mailbox-http-routes.js

@@ -176,6 +176,10 @@ async function handleAgentRoute(request, response, context) {
         (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentContextLossGauntlet(agent));
         return;
     }
+    if (surface === "sentinel") {
+        (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentSentinel(agent));
+        return;
+    }
     if (surface === "note-decisions") {
         (0, mailbox_http_response_1.writeJson)(response, 200, options.hooks.readAgentNoteDecisions(agent));
         return;

package/dist/heart/mailbox/mailbox-read.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readSelfFixView = exports.readMailboxContinuity = exports.readOrientationView = exports.readObligationDetailView = exports.readNoteDecisionView = exports.readContextLossGauntletView = exports.readChangesView = exports.readNeedsMeView = exports.readNotesView = exports.readLogView = exports.readHabitView = exports.readFriendView = exports.readDeskPrefs = exports.readDaemonHealthDeep = exports.readCodingDeep = exports.readBridgeInventory = exports.readAttentionView = exports.readMailView = exports.readMailMessageView = exports.readSessionTranscript = exports.readSessionInventory = exports.readMailboxMachineState = exports.readMailboxAgentState = exports.readObligationSummary = void 0;
+exports.readSelfFixView = exports.readMailboxContinuity = exports.readOrientationView = exports.readObligationDetailView = exports.readNoteDecisionView = exports.readSentinelView = exports.readContextLossGauntletView = exports.readChangesView = exports.readNeedsMeView = exports.readNotesView = exports.readLogView = exports.readHabitView = exports.readFriendView = exports.readDeskPrefs = exports.readDaemonHealthDeep = exports.readCodingDeep = exports.readBridgeInventory = exports.readAttentionView = exports.readMailView = exports.readMailMessageView = exports.readSessionTranscript = exports.readSessionInventory = exports.readMailboxMachineState = exports.readMailboxAgentState = exports.readObligationSummary = void 0;
 var agent_machine_1 = require("./readers/agent-machine");
 Object.defineProperty(exports, "readObligationSummary", { enumerable: true, get: function () { return agent_machine_1.readObligationSummary; } });
 Object.defineProperty(exports, "readMailboxAgentState", { enumerable: true, get: function () { return agent_machine_1.readMailboxAgentState; } });
@@ -25,6 +25,7 @@ Object.defineProperty(exports, "readNeedsMeView", { enumerable: true, get: funct
 var continuity_readers_1 = require("./readers/continuity-readers");
 Object.defineProperty(exports, "readChangesView", { enumerable: true, get: function () { return continuity_readers_1.readChangesView; } });
 Object.defineProperty(exports, "readContextLossGauntletView", { enumerable: true, get: function () { return continuity_readers_1.readContextLossGauntletView; } });
+Object.defineProperty(exports, "readSentinelView", { enumerable: true, get: function () { return continuity_readers_1.readSentinelView; } });
 Object.defineProperty(exports, "readNoteDecisionView", { enumerable: true, get: function () { return continuity_readers_1.readNoteDecisionView; } });
 Object.defineProperty(exports, "readObligationDetailView", { enumerable: true, get: function () { return continuity_readers_1.readObligationDetailView; } });
 Object.defineProperty(exports, "readOrientationView", { enumerable: true, get: function () { return continuity_readers_1.readOrientationView; } });

package/dist/heart/mailbox/readers/continuity-readers.js

@@ -39,6 +39,7 @@ exports.readObligationDetailView = readObligationDetailView;
 exports.readChangesView = readChangesView;
 exports.readSelfFixView = readSelfFixView;
 exports.readContextLossGauntletView = readContextLossGauntletView;
+exports.readSentinelView = readSentinelView;
 exports.readNoteDecisionView = readNoteDecisionView;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -50,6 +51,7 @@ const presence_1 = require("../../../arc/presence");
 const active_work_1 = require("../../active-work");
 const session_activity_1 = require("../../session-activity");
 const context_loss_gauntlet_1 = require("../../context-loss-gauntlet");
+const context_loss_sentinel_1 = require("../../context-loss-sentinel");
 const agent_machine_1 = require("./agent-machine");
 function sortOpenObligations(obligations) {
     const statusPriority = {
@@ -295,6 +297,9 @@ function readSelfFixView(_agentRoot) {
 function readContextLossGauntletView(agentRoot, agentName) {
     return (0, context_loss_gauntlet_1.runContextLossGauntlet)(agentName, agentRoot);
 }
+function readSentinelView(agentRoot) {
+    return (0, context_loss_sentinel_1.readContextLossSentinelView)(agentRoot, { limit: 20 });
+}
 function readNoteDecisionView(agentRoot, limit = 50) {
     const logPath = path.join(agentRoot, "state", "mailbox", "note-decisions.jsonl");
     const legacyLogPath = path.join(agentRoot, "state", "outlook", "note-decisions.jsonl");

package/dist/heart/provider-binding-resolver.js

@@ -153,7 +153,7 @@ function resolveCredential(poolResult, provider, agentName) {
         warnings: [missingCredentialWarning(provider)],
     };
 }
-function resolveReadiness(agentName, lane, provider, model, credential) {
+function resolveReadiness(agentName, agentRoot, lane, provider, model, credential) {
     if (credential.status === "missing") {
         return { status: "unknown", reason: "credential-missing" };
     }
@@ -162,6 +162,7 @@ function resolveReadiness(agentName, lane, provider, model, credential) {
     }
     if (credential.status === "present") {
         const cached = (0, provider_readiness_cache_1.readProviderLaneReadiness)({
+            agentRoot,
             agentName,
             lane,
             provider,
@@ -239,7 +240,7 @@ function resolveEffectiveProviderBinding(input) {
     }
     const poolResult = (0, provider_credentials_1.readProviderCredentialPool)(input.agentName);
     const credentialResult = resolveCredential(poolResult, agentConfigResult.provider, input.agentName);
-    const readiness = resolveReadiness(input.agentName, laneResolution.lane, agentConfigResult.provider, agentConfigResult.model, credentialResult.credential);
+    const readiness = resolveReadiness(input.agentName, input.agentRoot, laneResolution.lane, agentConfigResult.provider, agentConfigResult.model, credentialResult.credential);
     const warnings = [
         ...laneResolution.warnings,
         ...credentialResult.warnings,

package/dist/heart/provider-readiness-cache.js

@@ -1,15 +1,91 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.recordProviderLaneReadiness = recordProviderLaneReadiness;
 exports.readProviderLaneReadiness = readProviderLaneReadiness;
 exports.clearProviderReadinessCache = clearProviderReadinessCache;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const runtime_1 = require("../nerves/runtime");
 const readinessByLane = new Map();
 function cacheKey(agentName, lane) {
     return `${agentName}\0${lane}`;
 }
-function recordProviderLaneReadiness(entry) {
+function readinessStorePath(agentRoot) {
+    return path.join(agentRoot, "state", "providers", "readiness.json");
+}
+function defaultReadinessStore() {
+    return { schemaVersion: 1, updatedAt: new Date(0).toISOString(), lanes: {} };
+}
+function readReadinessStore(agentRoot) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(readinessStorePath(agentRoot), "utf-8"));
+        if (parsed.schemaVersion === 1 && parsed.lanes && typeof parsed.lanes === "object")
+            return parsed;
+    }
+    catch {
+        return defaultReadinessStore();
+    }
+    return defaultReadinessStore();
+}
+function writeReadinessStore(agentRoot, entry) {
+    const storePath = readinessStorePath(agentRoot);
+    const store = readReadinessStore(agentRoot);
+    const updated = {
+        schemaVersion: 1,
+        updatedAt: entry.checkedAt,
+        lanes: { ...store.lanes, [entry.lane]: entry },
+    };
+    fs.mkdirSync(path.dirname(storePath), { recursive: true });
+    fs.writeFileSync(storePath, `${JSON.stringify(updated, null, 2)}\n`, "utf-8");
+}
+function matchesLookup(entry, input) {
+    return entry.agentName === input.agentName
+        && entry.lane === input.lane
+        && entry.provider === input.provider
+        && entry.model === input.model
+        && entry.credentialRevision === input.credentialRevision;
+}
+function isNewerReadiness(candidate, existing) {
+    return Date.parse(candidate.checkedAt) > Date.parse(existing.checkedAt);
+}
+function recordProviderLaneReadiness(input) {
+    const { agentRoot, ...entry } = input;
     readinessByLane.set(cacheKey(entry.agentName, entry.lane), { ...entry });
+    if (agentRoot)
+        writeReadinessStore(agentRoot, entry);
     (0, runtime_1.emitNervesEvent)({
         component: "config/identity",
         event: "config.provider_readiness_recorded",
@@ -25,15 +101,18 @@ function recordProviderLaneReadiness(entry) {
 }
 function readProviderLaneReadiness(input) {
     const entry = readinessByLane.get(cacheKey(input.agentName, input.lane));
-    if (!entry)
-        return null;
-    if (entry.provider !== input.provider)
-        return null;
-    if (entry.model !== input.model)
-        return null;
-    if (entry.credentialRevision !== input.credentialRevision)
+    if (!input.agentRoot)
+        return entry && matchesLookup(entry, input) ? { ...entry } : null;
+    const durable = readReadinessStore(input.agentRoot).lanes[input.lane];
+    const memoryMatch = entry && matchesLookup(entry, input) ? entry : null;
+    const durableMatch = durable && matchesLookup(durable, input) ? durable : null;
+    const selected = memoryMatch && durableMatch
+        ? (isNewerReadiness(durableMatch, memoryMatch) ? durableMatch : memoryMatch)
+        : (durableMatch ?? memoryMatch);
+    if (!selected)
         return null;
-    return { ...entry };
+    readinessByLane.set(cacheKey(selected.agentName, selected.lane), { ...selected });
+    return { ...selected };
 }
 function clearProviderReadinessCache() {
     readinessByLane.clear();