@ouro.bot/cli 0.1.0-alpha.731 → 0.1.0-alpha.732

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.732",
+      "changes": [
+        "Doctor distinguishes a completed partial hosted-mail cache sync from stale divergence, preserving repair guidance only for actionable cache faults."
+      ]
+    },
     {
       "version": "0.1.0-alpha.731",
       "changes": [

package/dist/heart/daemon/doctor.js

@@ -1144,12 +1144,17 @@ async function hostedMailCacheAuthorityCheck(deps, agentDir, store) {
         }
         documentsById.set(document.messageId, document);
     }
-    let mismatched = 0;
+    let missing = 0;
+    let stale = 0;
     let invalidKeyProvenance = 0;
     for (const record of observation.records) {
         const document = documentsById.get(record.id);
-        if (!document || !(0, hosted_cache_sync_1.mailSearchCacheDocumentMatchesRecord)(document, record, true)) {
-            mismatched += 1;
+        if (!document) {
+            missing += 1;
+            continue;
+        }
+        if (!(0, hosted_cache_sync_1.mailSearchCacheDocumentMatchesRecord)(document, record, true)) {
+            stale += 1;
             continue;
         }
         if (!document.decryptionKeyId || !store.privateKeyIds.has(document.decryptionKeyId)) {
@@ -1168,11 +1173,23 @@ async function hostedMailCacheAuthorityCheck(deps, agentDir, store) {
         && coverage.cachedMessageCount === expectedCachedCount
         && coverage.decryptableMessageCount === expectedCachedCount
         && coverage.skippedMessageCount === observation.snapshot.visibleMessageCount - expectedCachedCount;
-    if (malformedOrNoncanonical > 0 || mismatched > 0 || invalidKeyProvenance > 0 || !coverageMatches) {
+    if (coverageMatches
+        && coverage.skippedMessageCount > 0
+        && missing === coverage.skippedMessageCount
+        && stale === 0
+        && malformedOrNoncanonical === 0
+        && invalidKeyProvenance === 0) {
+        return {
+            ...base,
+            status: "warn",
+            detail: `hosted authority is sound; the last completed sync skipped ${missing} hosted message(s), so local search remains incomplete; retry only if conditions have changed since that sync`,
+        };
+    }
+    if (malformedOrNoncanonical > 0 || missing > 0 || stale > 0 || invalidKeyProvenance > 0 || !coverageMatches) {
         return {
             ...base,
             status: "warn",
-            detail: `hosted authority is sound but cache diverges: ${mismatched} missing/stale canonical document(s), ${malformedOrNoncanonical} malformed/orphan/noncanonical/duplicate file(s), ${invalidKeyProvenance} invalid key provenance document(s), all-scope coverage ${coverageMatches ? "matches" : "missing/malformed/stale"}; run \`ouro mail sync-cache --agent ${agentName}\``,
+            detail: `hosted authority is sound but cache diverges: ${missing + stale} missing/stale canonical document(s), ${malformedOrNoncanonical} malformed/orphan/noncanonical/duplicate file(s), ${invalidKeyProvenance} invalid key provenance document(s), all-scope coverage ${coverageMatches ? "matches" : "missing/malformed/stale"}; run \`ouro mail sync-cache --agent ${agentName}\``,
         };
     }
     const count = observation.records.length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.731",
+  "version": "0.1.0-alpha.732",
   "engines": {
     "node": ">=22"
   },