agent-recall-core 3.4.50 → 3.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/README.md +559 -330
  2. package/dist/embeddings/config.d.ts.map +1 -1
  3. package/dist/embeddings/config.js +17 -4
  4. package/dist/embeddings/config.js.map +1 -1
  5. package/dist/helpers/alignment-patterns.d.ts +46 -0
  6. package/dist/helpers/alignment-patterns.d.ts.map +1 -1
  7. package/dist/helpers/alignment-patterns.js +103 -2
  8. package/dist/helpers/alignment-patterns.js.map +1 -1
  9. package/dist/helpers/journal-files.d.ts +12 -6
  10. package/dist/helpers/journal-files.d.ts.map +1 -1
  11. package/dist/helpers/journal-files.js +13 -7
  12. package/dist/helpers/journal-files.js.map +1 -1
  13. package/dist/helpers/transcript-project.d.ts +69 -0
  14. package/dist/helpers/transcript-project.d.ts.map +1 -0
  15. package/dist/helpers/transcript-project.js +212 -0
  16. package/dist/helpers/transcript-project.js.map +1 -0
  17. package/dist/index.d.ts +28 -7
  18. package/dist/index.d.ts.map +1 -1
  19. package/dist/index.js +62 -6
  20. package/dist/index.js.map +1 -1
  21. package/dist/palace/awareness.d.ts +6 -0
  22. package/dist/palace/awareness.d.ts.map +1 -1
  23. package/dist/palace/awareness.js +10 -4
  24. package/dist/palace/awareness.js.map +1 -1
  25. package/dist/prompts/consolidation-prompt.js +14 -14
  26. package/dist/retrieval/activation.d.ts +202 -0
  27. package/dist/retrieval/activation.d.ts.map +1 -0
  28. package/dist/retrieval/activation.js +313 -0
  29. package/dist/retrieval/activation.js.map +1 -0
  30. package/dist/retrieval/candidates.d.ts +17 -0
  31. package/dist/retrieval/candidates.d.ts.map +1 -1
  32. package/dist/retrieval/candidates.js +4 -2
  33. package/dist/retrieval/candidates.js.map +1 -1
  34. package/dist/retrieval/contradiction.d.ts +42 -0
  35. package/dist/retrieval/contradiction.d.ts.map +1 -1
  36. package/dist/retrieval/contradiction.js +126 -7
  37. package/dist/retrieval/contradiction.js.map +1 -1
  38. package/dist/retrieval/lexical-index.d.ts +150 -0
  39. package/dist/retrieval/lexical-index.d.ts.map +1 -0
  40. package/dist/retrieval/lexical-index.js +514 -0
  41. package/dist/retrieval/lexical-index.js.map +1 -0
  42. package/dist/retrieval/query-memory.d.ts +17 -7
  43. package/dist/retrieval/query-memory.d.ts.map +1 -1
  44. package/dist/retrieval/query-memory.js +274 -68
  45. package/dist/retrieval/query-memory.js.map +1 -1
  46. package/dist/storage/classification.d.ts.map +1 -1
  47. package/dist/storage/classification.js +4 -1
  48. package/dist/storage/classification.js.map +1 -1
  49. package/dist/storage/content-guard.d.ts +26 -0
  50. package/dist/storage/content-guard.d.ts.map +1 -1
  51. package/dist/storage/content-guard.js +450 -48
  52. package/dist/storage/content-guard.js.map +1 -1
  53. package/dist/storage/corrections.d.ts +140 -2
  54. package/dist/storage/corrections.d.ts.map +1 -1
  55. package/dist/storage/corrections.js +144 -70
  56. package/dist/storage/corrections.js.map +1 -1
  57. package/dist/storage/cwd-allowlist.d.ts +28 -2
  58. package/dist/storage/cwd-allowlist.d.ts.map +1 -1
  59. package/dist/storage/cwd-allowlist.js +61 -13
  60. package/dist/storage/cwd-allowlist.js.map +1 -1
  61. package/dist/storage/filelock.d.ts +26 -8
  62. package/dist/storage/filelock.d.ts.map +1 -1
  63. package/dist/storage/filelock.js +202 -26
  64. package/dist/storage/filelock.js.map +1 -1
  65. package/dist/storage/fs-utils.d.ts +51 -0
  66. package/dist/storage/fs-utils.d.ts.map +1 -1
  67. package/dist/storage/fs-utils.js +123 -2
  68. package/dist/storage/fs-utils.js.map +1 -1
  69. package/dist/storage/heed-tiers.d.ts +206 -0
  70. package/dist/storage/heed-tiers.d.ts.map +1 -0
  71. package/dist/storage/heed-tiers.js +318 -0
  72. package/dist/storage/heed-tiers.js.map +1 -0
  73. package/dist/storage/memory-protocol.js +55 -55
  74. package/dist/storage/paths.d.ts.map +1 -1
  75. package/dist/storage/paths.js +7 -2
  76. package/dist/storage/paths.js.map +1 -1
  77. package/dist/storage/project.d.ts.map +1 -1
  78. package/dist/storage/project.js +9 -2
  79. package/dist/storage/project.js.map +1 -1
  80. package/dist/storage/store-manifest.js +57 -57
  81. package/dist/supabase/embedding.d.ts.map +1 -1
  82. package/dist/supabase/embedding.js +7 -0
  83. package/dist/supabase/embedding.js.map +1 -1
  84. package/dist/supabase/sync.d.ts +1 -1
  85. package/dist/supabase/sync.d.ts.map +1 -1
  86. package/dist/supabase/sync.js +88 -28
  87. package/dist/supabase/sync.js.map +1 -1
  88. package/dist/tools-logic/association.d.ts +260 -0
  89. package/dist/tools-logic/association.d.ts.map +1 -0
  90. package/dist/tools-logic/association.js +502 -0
  91. package/dist/tools-logic/association.js.map +1 -0
  92. package/dist/tools-logic/bootstrap.d.ts.map +1 -1
  93. package/dist/tools-logic/bootstrap.js +4 -2
  94. package/dist/tools-logic/bootstrap.js.map +1 -1
  95. package/dist/tools-logic/check-action.d.ts.map +1 -1
  96. package/dist/tools-logic/check-action.js +14 -0
  97. package/dist/tools-logic/check-action.js.map +1 -1
  98. package/dist/tools-logic/check.d.ts +7 -0
  99. package/dist/tools-logic/check.d.ts.map +1 -1
  100. package/dist/tools-logic/check.js +54 -44
  101. package/dist/tools-logic/check.js.map +1 -1
  102. package/dist/tools-logic/dream-admission.js +29 -29
  103. package/dist/tools-logic/implicit-harvest.d.ts +196 -0
  104. package/dist/tools-logic/implicit-harvest.d.ts.map +1 -0
  105. package/dist/tools-logic/implicit-harvest.js +675 -0
  106. package/dist/tools-logic/implicit-harvest.js.map +1 -0
  107. package/dist/tools-logic/insight-promotion.d.ts.map +1 -1
  108. package/dist/tools-logic/insight-promotion.js +53 -1
  109. package/dist/tools-logic/insight-promotion.js.map +1 -1
  110. package/dist/tools-logic/recall-backend.d.ts.map +1 -1
  111. package/dist/tools-logic/recall-backend.js +3 -1
  112. package/dist/tools-logic/recall-backend.js.map +1 -1
  113. package/dist/tools-logic/retier.d.ts +274 -0
  114. package/dist/tools-logic/retier.d.ts.map +1 -0
  115. package/dist/tools-logic/retier.js +511 -0
  116. package/dist/tools-logic/retier.js.map +1 -0
  117. package/dist/tools-logic/session-end.d.ts +35 -0
  118. package/dist/tools-logic/session-end.d.ts.map +1 -1
  119. package/dist/tools-logic/session-end.js +26 -7
  120. package/dist/tools-logic/session-end.js.map +1 -1
  121. package/dist/tools-logic/session-start.d.ts +11 -0
  122. package/dist/tools-logic/session-start.d.ts.map +1 -1
  123. package/dist/tools-logic/session-start.js +34 -4
  124. package/dist/tools-logic/session-start.js.map +1 -1
  125. package/dist/tools-logic/smart-recall.d.ts +63 -0
  126. package/dist/tools-logic/smart-recall.d.ts.map +1 -1
  127. package/dist/tools-logic/smart-recall.js +213 -31
  128. package/dist/tools-logic/smart-recall.js.map +1 -1
  129. package/dist/tools-logic/smart-remember-vector.d.ts +3 -1
  130. package/dist/tools-logic/smart-remember-vector.d.ts.map +1 -1
  131. package/dist/tools-logic/smart-remember-vector.js +3 -1
  132. package/dist/tools-logic/smart-remember-vector.js.map +1 -1
  133. package/dist/tools-logic/smart-remember.d.ts.map +1 -1
  134. package/dist/tools-logic/smart-remember.js +6 -2
  135. package/dist/tools-logic/smart-remember.js.map +1 -1
  136. package/dist/tools-logic/transcript-audit.d.ts +128 -0
  137. package/dist/tools-logic/transcript-audit.d.ts.map +1 -0
  138. package/dist/tools-logic/transcript-audit.js +428 -0
  139. package/dist/tools-logic/transcript-audit.js.map +1 -0
  140. package/dist/types.d.ts +17 -2
  141. package/dist/types.d.ts.map +1 -1
  142. package/dist/types.js +31 -3
  143. package/dist/types.js.map +1 -1
  144. package/dist/vector/embedding.d.ts +20 -1
  145. package/dist/vector/embedding.d.ts.map +1 -1
  146. package/dist/vector/embedding.js +27 -1
  147. package/dist/vector/embedding.js.map +1 -1
  148. package/dist/vector/local-vector-backend.d.ts +4 -1
  149. package/dist/vector/local-vector-backend.d.ts.map +1 -1
  150. package/dist/vector/local-vector-backend.js +7 -3
  151. package/dist/vector/local-vector-backend.js.map +1 -1
  152. package/package.json +59 -59
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implicit-harvest.js","sourceRoot":"","sources":["../../src/tools-logic/implicit-harvest.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"insight-promotion.d.ts","sourceRoot":"","sources":["../../src/tools-logic/insight-promotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAWrG;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,SAAmC,GAAG,OAAO,CAAC,eAAe,CAAC,CAqDrH"}
1
+ {"version":3,"file":"insight-promotion.d.ts","sourceRoot":"","sources":["../../src/tools-logic/insight-promotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAWrG;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,SAAmC,GAAG,OAAO,CAAC,eAAe,CAAC,CA2GrH"}
@@ -7,7 +7,7 @@
7
7
  * Import chain: imports only from awareness.js and insights-index.js.
8
8
  * Does NOT import awareness-update.ts (would create circular dependency).
9
9
  */
10
- import { addInsight, readAwarenessState } from "../palace/awareness.js";
10
+ import { addInsight, readAwarenessState, readAwarenessArchive, AWARENESS_TOP_INSIGHTS_CAP } from "../palace/awareness.js";
11
11
  import { readInsightsIndex } from "../palace/insights-index.js";
12
12
  import { tokenizeWords, NON_ASCII_RE } from "../helpers/tokenize.js";
13
13
  /**
@@ -51,11 +51,63 @@ export async function promoteConfirmedInsights(threshold = PROMOTION_CONFIRMATIO
51
51
  const state = readAwarenessState();
52
52
  // Build set of existing awareness titles (lowercased) for dedup check
53
53
  const existingTitles = new Set((state?.topInsights ?? []).map((i) => i.title.toLowerCase()));
54
+ // Saturation churn guard (fix12 hygiene, 2026-09-12; churn first observed
55
+ // during the fix3 backfill): against a SATURATED awareness (cap reached,
56
+ // every slot outranking the candidate) addInsight resurrects the candidate
57
+ // from the archive, bumps its confirmations +1, then immediately demotes it
58
+ // back — so every session_end/`ar awareness rollup` re-attempted the same
59
+ // doomed promotion forever: two archive writes + a state write per candidate
60
+ // per run, and an ARTIFICIAL +1 confirmations escalator on the archived
61
+ // entry with no new real confirmation behind it (the insights-index entry
62
+ // is unchanged between runs).
63
+ //
64
+ // Guard — skip ONLY a provably doomed round-trip, i.e. when BOTH hold:
65
+ // (a) no new information: the archived twin already carries >= the
66
+ // candidate's confirmed_count (the archive has absorbed everything
67
+ // the index can attest), AND
68
+ // (b) no survival chance: the resurrected twin (archived + 1 — addInsight
69
+ // bumps on resurrection) still cannot outrank the CURRENT weakest
70
+ // top-insights slot (strict inequality required to survive: on a tie
71
+ // the just-pushed candidate sorts last among equals and is the one
72
+ // popped back to the archive).
73
+ // Condition (b) is the fix12 review MEDIUM-1 fix: without it, an archived
74
+ // twin whose count the pre-fix escalator had inflated (e.g. 50) blocked an
75
+ // ORGANIC promotion that would have displaced a weak slot and STAYED.
76
+ // When confirmed_count grows past the archived count, (a) fails and the
77
+ // attempt proceeds — churn stays bounded by real confirmations. When the
78
+ // twin can win the cap fight, (b) fails and the promotion goes through
79
+ // (resurrect-displace-stay, zero churn). Non-saturated awareness never hits
80
+ // the guard (a resurrected candidate simply stays).
81
+ //
82
+ // NOTE deliberately NOT changed here (owner-taste, flagged in the fix12
83
+ // report): whether a saturated top-20 should ever be displaced by a
84
+ // lower-confirmation candidate, and whether archived insights should
85
+ // re-enter spontaneously when slots free up — this guard only removes the
86
+ // wasted write cycles and the artificial counter inflation.
87
+ const saturated = (state?.topInsights?.length ?? 0) >= AWARENESS_TOP_INSIGHTS_CAP;
88
+ const archive = saturated ? readAwarenessArchive() : [];
89
+ const weakestTopConfirmations = saturated
90
+ ? Math.min(...state.topInsights.map((i) => i.confirmations ?? 0))
91
+ : -Infinity;
54
92
  const promoted = [];
55
93
  const skipped = [];
56
94
  for (const insight of index.insights) {
57
95
  if (insight.confirmed_count < threshold)
58
96
  continue;
97
+ if (saturated) {
98
+ let archivedConfirmations = -1;
99
+ for (const a of archive) {
100
+ if (titlePresentInAwareness(insight.title, [a.title.toLowerCase()])) {
101
+ archivedConfirmations = Math.max(archivedConfirmations, a.confirmations ?? 0);
102
+ }
103
+ }
104
+ const noNewInformation = archivedConfirmations >= insight.confirmed_count;
105
+ const cannotSurviveCap = archivedConfirmations + 1 <= weakestTopConfirmations;
106
+ if (archivedConfirmations >= 0 && noNewInformation && cannotSurviveCap) {
107
+ skipped.push(insight.title);
108
+ continue;
109
+ }
110
+ }
59
111
  // Title-similarity dedup: exact match first, then word overlap.
60
112
  // CJK-aware (fix #3, 2026-09-11): the pre-fix grammar was
61
113
  // `titleLower.split(/\s+/)` + `w.length > 3` — an unspaced CJK title
@@ -1 +1 @@
1
- {"version":3,"file":"insight-promotion.js","sourceRoot":"","sources":["../../src/tools-logic/insight-promotion.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"insight-promotion.js","sourceRoot":"","sources":["../../src/tools-logic/insight-promotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC1H,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAOrE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,mBAAqC;IAC1F,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACrD,KAAK,MAAM,QAAQ,IAAI,mBAAmB,EAAE,CAAC;QAC3C,IAAI,QAAQ,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAChH,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG;YAAE,OAAO,IAAI,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,SAAS,GAAG,gCAAgC;IACzF,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IAEnC,sEAAsE;IACtE,MAAM,cAAc,GAAG,IAAI,GAAG,CAC5B,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAChF,CAAC;IAEF,0EAA0E;IAC1E,yEAAyE;IACzE,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,6EAA6E;IAC7E,wEAAwE;IACxE,0EAA0E;IAC1E,8BAA8B;IAC9B,EAAE;IACF,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,mCAAmC;IACnC,4EAA4E;IAC5E,wEAAwE;IACxE,2EAA2E;IAC3E,yEAAyE;IACzE,qCAAqC;IACrC,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,wEAAwE;IACxE,yEAAyE;IACzE,uEAAuE;IACvE,4EAA4E;IAC5E,oDAAoD;IACpD,EAAE;IACF,wEAAwE;IACxE,oEAAoE;IACpE,qEAAqE;IACrE,0EAA0E;IAC1E,4DAA4D;IAC5D,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,0BAA0B,CAAC;IAClF,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,uBAAuB,GAAG,SAAS;QACvC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAEd,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,eAAe,GAAG,SAAS;YAAE,SAAS;QAElD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,qBAAqB,GAAG,CAAC,CAAC,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC;oBACpE,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC;YACD,MAAM,gBAAgB,GAAG,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC;YAC1E,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,CAAC,IAAI,uBAAuB,CAAC;YAC9E,IAAI,qBAAqB,IAAI,CAAC,IAAI,gBAAgB,IAAI,gBAAgB,EAAE,CAAC;gBACvE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;QACH,CAAC;QAED,gEAAgE;QAChE,0DAA0D;QAC1D,qEAAqE;QACrE,+DAA+D;QAC/D,qEAAqE;QACrE,+DAA+D;QAC/D,qEAAqE;QACrE,mEAAmE;QACnE,gEAAgE;QAChE,wEAAwE;QACxE,+DAA+D;QAC/D,6BAA6B;QAC7B,MAAM,cAAc,GAAG,uBAAuB,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAE9E,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,gDAAgD,OAAO,CAAC,eAAe,gBAAgB,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,GAAG;YACpJ,WAAW,EAAE,OAAO,CAAC,YAAY;YACjC,MAAM,EAAE,mBAAmB;YAC3B,cAAc,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS;SACzD,CAAC,CAAC;QAEH,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,EAAE,CAAC;YAC5B,+FAA+F;YAC/F,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7B,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"recall-backend.d.ts","sourceRoot":"","sources":["../../src/tools-logic/recall-backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAI/D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM;IACb;;;6DAGyD;IACzD,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACpC,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,SAAS,IAAI,OAAO;IAId,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,qBAAqB,EAAE,CAAC;CASpC;AAgBD,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,OAAO,CAW7C;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AASD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAmC/D;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}
1
+ {"version":3,"file":"recall-backend.d.ts","sourceRoot":"","sources":["../../src/tools-logic/recall-backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAI/D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM;IACb;;;6DAGyD;IACzD,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACpC,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,SAAS,IAAI,OAAO;IAId,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,qBAAqB,EAAE,CAAC;CASpC;AAgBD,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,OAAO,CAW7C;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AASD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAqC/D;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC"}
@@ -81,7 +81,9 @@ export async function getRecallBackend() {
81
81
  catch {
82
82
  // Supabase not configured or module not yet available (Task 8).
83
83
  }
84
- // If OPENAI_API_KEY is set and no Supabase config, use local vector backend.
84
+ // Local vector backend requires EXPLICIT opt-in (AGENT_RECALL_CLOUD_EMBEDDINGS=1
85
+ // AND OPENAI_API_KEY — see vector/embedding.ts cloudEmbeddingsEnabled). An
86
+ // ambient OPENAI_API_KEY alone never selects it (egress gate, fix 3.5.2).
85
87
  const vectorBackend = new LocalVectorRecallBackend();
86
88
  if (vectorBackend.available()) {
87
89
  _cachedBackend = vectorBackend;
@@ -1 +1 @@
1
- {"version":3,"file":"recall-backend.js","sourceRoot":"","sources":["../../src/tools-logic/recall-backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAqB7E;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAC7B,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAA2B,EAC3B,KAAa,EACb,IAAkC;QAElC,8CAA8C;QAC9C,2DAA2D;QAC3D,8DAA8D;QAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAQ,CAAC;QACrD,OAAO,GAAG,CAAC,iBAAiB,CAC1B,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAClB,CAAC;IACxC,CAAC;CACF;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,IAAI,0BAA0B,GAAG,CAAC,CAAC;AACnC,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,gFAAgF;AAChF,MAAM,UAAU,mBAAmB;IACjC,0BAA0B,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,eAAe,IAAI,0BAA0B,IAAI,iBAAiB,EAAE,CAAC;QACxE,eAAe,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uEAAuE;YACvE,GAAG,0BAA0B,qDAAqD,CACnF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB;IACjC,0BAA0B,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,wEAAwE;AACxE,IAAI,cAAc,GAAyB,IAAI,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,8DAA8D;IAC9D,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,wEAAwE;YACxE,wEAAwE;YACxE,iDAAiD;YACjD,8DAA8D;YAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,+BAAsC,CAAQ,CAAC;YACxE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAkB,CAAC;YACvE,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;gBACxB,cAAc,GAAG,OAAO,CAAC;gBACzB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;IAED,6EAA6E;IAC7E,MAAM,aAAa,GAAG,IAAI,wBAAwB,EAAE,CAAC;IACrD,IAAI,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC;QAC9B,cAAc,GAAG,aAAa,CAAC;QAC/B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,cAAc,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC1C,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,kBAAkB;IAChC,cAAc,GAAG,IAAI,CAAC;IACtB,0BAA0B,GAAG,CAAC,CAAC;IAC/B,eAAe,GAAG,KAAK,CAAC;AAC1B,CAAC"}
1
+ {"version":3,"file":"recall-backend.js","sourceRoot":"","sources":["../../src/tools-logic/recall-backend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAqB7E;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAC7B,SAAS;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAA2B,EAC3B,KAAa,EACb,IAAkC;QAElC,8CAA8C;QAC9C,2DAA2D;QAC3D,8DAA8D;QAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAQ,CAAC;QACrD,OAAO,GAAG,CAAC,iBAAiB,CAC1B,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,CAClB,CAAC;IACxC,CAAC;CACF;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,IAAI,0BAA0B,GAAG,CAAC,CAAC;AACnC,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,gFAAgF;AAChF,MAAM,UAAU,mBAAmB;IACjC,0BAA0B,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,eAAe,IAAI,0BAA0B,IAAI,iBAAiB,EAAE,CAAC;QACxE,eAAe,GAAG,IAAI,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uEAAuE;YACvE,GAAG,0BAA0B,qDAAqD,CACnF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB;IACjC,0BAA0B,GAAG,CAAC,CAAC;AACjC,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,wEAAwE;AACxE,IAAI,cAAc,GAAyB,IAAI,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,8DAA8D;IAC9D,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,IAAI,kBAAkB,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,wEAAwE;YACxE,wEAAwE;YACxE,iDAAiD;YACjD,8DAA8D;YAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,+BAAsC,CAAQ,CAAC;YACxE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,qBAAqB,CAAC,MAAM,CAAkB,CAAC;YACvE,IAAI,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;gBACxB,cAAc,GAAG,OAAO,CAAC;gBACzB,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;IAED,iFAAiF;IACjF,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,aAAa,GAAG,IAAI,wBAAwB,EAAE,CAAC;IACrD,IAAI,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC;QAC9B,cAAc,GAAG,aAAa,CAAC;QAC/B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,cAAc,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC1C,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,kBAAkB;IAChC,cAAc,GAAG,IAAI,CAAC;IACtB,0BAA0B,GAAG,CAAC,CAAC;IAC/B,eAAe,GAAG,KAAK,CAAC;AAC1B,CAAC"}
@@ -0,0 +1,274 @@
1
+ /**
2
+ * retier.ts — evolution p4 (Phase 4): the soft-constraint ladder,
3
+ * `ar corrections retier`.
4
+ *
5
+ * WHY: `severity` (p0/p1) is a binary, capture-time, NEVER-revisited label —
6
+ * once a rule is p0 it stays hard-enforced forever even if its evidence
7
+ * (heeded/recurred/retrieved) never shows up again. "Rules must die unless
8
+ * data renews them": this module adds a THREE-tier ladder — gate (hard
9
+ * enforcement) / nudge (advisory) / watch (background) — computed FRESH
10
+ * from each record's own evidence, plus an automatic, reversible one-step
11
+ * DEMOTION when that evidence goes stale. Nothing here ever deletes,
12
+ * retracts, or archives a record — see CONSTRAINTS below.
13
+ *
14
+ * ---------------------------------------------------------------------------
15
+ * tierOf — HAND-TUNED v1 formula (every constant named + justified; not fit
16
+ * to any labeled outcome set, same "chosen by feel" status as activation.ts's
17
+ * S_DECAY/ACT_ALPHA)
18
+ * ---------------------------------------------------------------------------
19
+ * gate: severity p0 AND proof_confidence ≥ GATE_MIN_PROOF_CONFIDENCE (0.7)
20
+ * AND retrieved within GATE_RETRIEVED_WITHIN_DAYS (30d) of asOfDay.
21
+ * nudge: (severity p0 that did NOT meet gate) — OR —
22
+ * (severity p1 AND proof_confidence ≥ NUDGE_P1_MIN_PROOF_CONFIDENCE
23
+ * (0.6) AND retrieved within NUDGE_RETRIEVED_WITHIN_DAYS (60d)).
24
+ * watch: everything else.
25
+ *
26
+ * `proof_confidence` is read directly off the record (it is already the
27
+ * Beta posterior `(heeded+1)/(heeded+recurred+2)` when outcomes exist, and
28
+ * already falls back to `weight` when they don't — see corrections.ts's
29
+ * `applyCorrectionDefaults`/`recordOutcome`). `proofConfidenceOf` below adds
30
+ * ONE more defensive fallback layer (mirroring `decayClassOf`/
31
+ * `effectiveConfidenceOf`'s established defensive posture in corrections.ts)
32
+ * for a raw/un-defaulted record a caller hands in directly (e.g. a truth-
33
+ * table test fixture) rather than one that went through `readCorrections()`.
34
+ *
35
+ * COLD-START (stated explicitly, per the brief): a fresh record that has
36
+ * NEVER been retrieved (`last_retrieved` absent) fails BOTH the gate's and
37
+ * the nudge-p1-branch's retrieval-recency clause regardless of its
38
+ * `proof_confidence` (which for a truly fresh record is `weight`'s prior —
39
+ * ≈1.0 for p0, ≈0.7 for p1 — NOT literally 0.5; the brief's "prior≈0.5"
40
+ * describes the SHAPE of the argument, not a required literal value, and
41
+ * the derivation below holds for ANY confidence value, 0.5 included, since
42
+ * the p0-nudge branch never even reads confidence). Mechanically:
43
+ * - a fresh P0 record: gate fails (retrieval clause) → falls to the
44
+ * UNCONDITIONAL "severity p0 not meeting gate" nudge branch → **nudge**.
45
+ * - a fresh P1 record: gate fails (wrong severity) → nudge's p1 branch
46
+ * ALSO fails (retrieval clause) → **watch**.
47
+ * This is not a special case coded separately — it is what the formula
48
+ * above already produces for any record with `last_retrieved` absent; it is
49
+ * called out here (and pinned by a truth-table test row) because it is the
50
+ * single most consequential behavior an operator needs to know before
51
+ * trusting the ladder on a corpus with many never-yet-retrieved corrections.
52
+ *
53
+ * ---------------------------------------------------------------------------
54
+ * demotionOf — automatic, one-step-down triggers (pure)
55
+ * ---------------------------------------------------------------------------
56
+ * Fires independently of (and can pull a record BELOW) the raw `tierOf`
57
+ * result — this is what keeps a P0 record that is technically "not meeting
58
+ * gate" (and would therefore sit at "nudge" forever per the formula above,
59
+ * regardless of HOW stale it gets — the p0-nudge branch has no recency
60
+ * clause of its own) from getting stuck at nudge indefinitely once it goes
61
+ * genuinely dormant.
62
+ * - `not_violated_plateau`: `not_violated_count ≥ DEMOTE_NOT_VIOLATED_MIN`
63
+ * (3) AND `heeded_count === 0 && recurrence_count === 0`. DOCUMENTED
64
+ * APPROXIMATION: the brief's literal spec is "zero heeded/recurred IN
65
+ * THE LAST 60 DAYS", but `recordOutcome` (storage/corrections.ts)
66
+ * stamps `last_outcome` for heeded, recurred, AND not_violated alike —
67
+ * one shared timestamp, no per-kind history — so a record-only pure
68
+ * function (no ledger read) cannot distinguish "heeded happened but was
69
+ * >60d ago" from "heeded never happened". This checks lifetime-zero
70
+ * instead, which is a STRICT SUBSET of the windowed check (every record
71
+ * lifetime-zero-heeded/recurred is trivially also windowed-zero; a
72
+ * record with e.g. `heeded_count:1` whose one heeded event happened
73
+ * 400 days ago would satisfy the brief's literal windowed spec but is
74
+ * SKIPPED here). Flagged, not silently narrowed: a ledger-precision
75
+ * windowed version would need `readOutcomeEventsByCorrection`, which is
76
+ * a different function's job, not this pure per-record one's.
77
+ * - `retrieval_stale_90d`: no retrieval touch within
78
+ * `DEMOTE_RETRIEVAL_STALE_DAYS` (90) of `asOfDay`. Anchor is
79
+ * `last_retrieved ?? date` (record creation date) — mirrors
80
+ * `isStaleCorrection`'s existing `last_retrieved ?? last_outcome ?? date`
81
+ * touch-anchor convention in corrections.ts, narrowed to retrieval-only
82
+ * (not outcome) because the brief names "no RETRIEVED event"
83
+ * specifically. Falling back to `date` (never `last_outcome`) means a
84
+ * record created 5 days ago with zero retrievals does NOT yet trigger
85
+ * this — there has not been a 90-day WINDOW in which retrieval could
86
+ * have happened, so there is nothing to call "stale" yet. `currentTier
87
+ * === "watch"` short-circuits to `[]` — watch is the floor; there is no
88
+ * lower tier to step down to, so computing triggers for it is a no-op
89
+ * it can skip announcing.
90
+ *
91
+ * ---------------------------------------------------------------------------
92
+ * archiveCandidates / promoteToGateCandidates — PROPOSALS ONLY
93
+ * ---------------------------------------------------------------------------
94
+ * Both are pure REPORTS, read by `--dry-run` (and always computed, never
95
+ * gated behind the flag — `--write` just additionally persists tiers).
96
+ * Neither list is ever applied, retracted, or archived by this module or by
97
+ * `--write` — there is no `--apply-proposals` flag anywhere in this file.
98
+ * `archiveCandidates`: watch-tier records with no retrieval/outcome/
99
+ * prediction touch of ANY kind in `ARCHIVE_STALE_DAYS` (180) days — a human
100
+ * decides whether "dormant this long" means retract, keep watching, or
101
+ * something else; this module has no opinion past surfacing the list.
102
+ * `promoteToGateCandidates`: records where the RAW formula (`tierOf`) says
103
+ * "gate", NO demotion trigger fires for that same record (`demotionOf`
104
+ * re-checked internally — see FIX note on the function itself: a raw-gate
105
+ * record whose `not_violated_plateau`/`retrieval_stale_90d` trigger is
106
+ * active is NOT a candidate, because `--write` would persist it one step
107
+ * BELOW gate, not at gate — see `final_tier` below), and the record's
108
+ * LAST-PERSISTED `tier` field disagrees (absent, or a lower tier — this can
109
+ * happen legitimately: a record demoted for staleness gets freshly
110
+ * retrieved again and its raw formula recovers to "gate" before the next
111
+ * `--write` run catches up). `--write` persists `final_tier` — `tierOf`'s
112
+ * raw result stepped down once if `demotionOf` fired, exactly like every
113
+ * other tier — so a promotion INTO gate is not held back by anything
114
+ * OTHER than that same demotion check (only DEMOTION out of a tier is a
115
+ * separate, escalation-style path; there is no analogous "promotion
116
+ * approval" write-gate here). Inside `runRetier`, this list is additionally
117
+ * computed against each record's tier AS OF the end of this call (the tier
118
+ * `--write` just persisted this run, if any — never the pre-write snapshot;
119
+ * see the `writtenTierThisRun` remap in `runRetier`), so a record `--write`
120
+ * already promoted to gate THIS call is never simultaneously reported as
121
+ * "still pending". What "OWNER-GATED" (the brief's own words for this list)
122
+ * means concretely in v1: this list is the visibility mechanism — a human
123
+ * reviewing `--dry-run` output sees exactly which records are ABOUT TO
124
+ * become (or already are, pending the next --write) gate-tier BEFORE
125
+ * trusting anything downstream to key off `tier==="gate"` automatically. If
126
+ * a future phase wants `--write` to hold gate promotions for explicit human
127
+ * sign-off (a real write-time gate), that is a NEW, separate flag on top of
128
+ * this reporting list, not a silent change to what `--write` does today.
129
+ *
130
+ * ---------------------------------------------------------------------------
131
+ * CHALLENGE resolution — stored `tier` vs. `tierOf()` (read contract)
132
+ * ---------------------------------------------------------------------------
133
+ * DECIDED: the stored `CorrectionRecord.tier` field is a WRITE-TIME CACHE,
134
+ * never truth. `tierOf(record, asOfDay)` is the ONE source of truth for
135
+ * "what tier is this record right now" — see the field's own doc comment in
136
+ * storage/corrections.ts. This module's own `promoteToGateCandidates` is the
137
+ * proof this is load-bearing, not decorative: it exists BECAUSE the cached
138
+ * field can legitimately disagree with a fresh computation. The
139
+ * session_start rendering tag (goal 3) recomputes fresh at render time for
140
+ * the same reason — it never reads `record.tier`. Storing nothing at all
141
+ * (compute-on-every-read, everywhere) was the alternative considered and
142
+ * REJECTED: `--dry-run`'s whole value proposition is showing "stored vs.
143
+ * computed" drift (the CLI table's `current` column) and idempotency proof
144
+ * needs SOMETHING durable to compare a second `--write` run against; a
145
+ * cache with a documented, enforced "never trust me without recomputing"
146
+ * contract gets both without inventing a second source of truth for any
147
+ * consumer that matters (there is exactly one: `promoteToGateCandidates`,
148
+ * and it already treats the field as a stale-vs-fresh SIGNAL, never as an
149
+ * answer on its own).
150
+ *
151
+ * ---------------------------------------------------------------------------
152
+ * Determinism / store-root handling
153
+ * ---------------------------------------------------------------------------
154
+ * `runRetier` is deterministic given the same `asOfDay` and unchanged
155
+ * on-disk inputs (project slugs sorted, no wall-clock read once `asOfDay`
156
+ * is fixed). Unlike `association.ts`'s `--store` (which deliberately never
157
+ * mutates the process-global root because it does its OWN raw fs
158
+ * reads/writes), `runRetier`'s `--write` path MUST reuse corrections.ts's
159
+ * locked, atomic, index-regenerating write machinery (`setCorrectionTier`)
160
+ * — the brief's own "sanctioned record-write path under the project lock"
161
+ * requirement — and that machinery is hard-wired to `getRoot()` throughout.
162
+ * Reimplementing lock+atomic-write+index-regen here to avoid a root swap
163
+ * would duplicate exactly the mechanism the brief says to reuse. So this
164
+ * module swaps `setRoot()` for the duration of one `runRetier()` call (only
165
+ * when `storeRoot` is explicitly passed) and restores the PRIOR root in a
166
+ * `finally`, even on throw — see `withStoreRoot` below. This is the SAME
167
+ * mechanism the CLI's pre-existing global `--root` flag already uses
168
+ * (types.ts's `setRoot`), just scoped to one call instead of the whole
169
+ * process lifetime.
170
+ */
171
+ import { type CorrectionRecord, type CorrectionTier } from "../storage/corrections.js";
172
+ export declare const GATE_MIN_PROOF_CONFIDENCE = 0.7;
173
+ export declare const GATE_RETRIEVED_WITHIN_DAYS = 30;
174
+ export declare const NUDGE_P1_MIN_PROOF_CONFIDENCE = 0.6;
175
+ export declare const NUDGE_RETRIEVED_WITHIN_DAYS = 60;
176
+ export declare const DEMOTE_NOT_VIOLATED_MIN = 3;
177
+ export declare const DEMOTE_RETRIEVAL_STALE_DAYS = 90;
178
+ export declare const ARCHIVE_STALE_DAYS = 180;
179
+ /**
180
+ * The soft-constraint ladder — HAND-TUNED v1 formula. See this file's header
181
+ * for the full derivation, every constant's name/value, and the cold-start
182
+ * worked example. Pure: no I/O, no wall-clock read (asOfDay is the caller's
183
+ * "now").
184
+ */
185
+ export declare function tierOf(record: Pick<CorrectionRecord, "severity" | "proof_confidence" | "weight" | "last_retrieved">, asOfDay: string): CorrectionTier;
186
+ /** One step down the ladder (gate→nudge→watch→watch — watch is the floor). */
187
+ export declare function stepDownTier(tier: CorrectionTier): CorrectionTier;
188
+ /**
189
+ * One-step-down trigger list for `record` at `currentTier`/`asOfDay`. Pure —
190
+ * returns the trigger NAMES that fired (empty = no demotion). See this
191
+ * file's header for the exact rationale of each trigger, including the
192
+ * documented not_violated windowing approximation.
193
+ */
194
+ export declare function demotionOf(record: Pick<CorrectionRecord, "not_violated_count" | "heeded_count" | "recurrence_count" | "last_retrieved" | "date">, currentTier: CorrectionTier, asOfDay: string): string[];
195
+ export interface ArchiveCandidate {
196
+ project: string;
197
+ id: string;
198
+ rule: string;
199
+ /** Most recent touch of ANY kind (retrieved/outcome/predicted), or null if truly never touched. */
200
+ last_touch: string | null;
201
+ }
202
+ /**
203
+ * watch-tier records with no retrieval/outcome/prediction touch of ANY kind
204
+ * in `ARCHIVE_STALE_DAYS` days. PROPOSAL LIST ONLY — see this file's header.
205
+ * `tierOf` is recomputed here (never reads `record.tier`) per the CHALLENGE
206
+ * resolution above.
207
+ */
208
+ export declare function archiveCandidates(records: readonly CorrectionRecord[], asOfDay: string): ArchiveCandidate[];
209
+ export interface PromoteToGateCandidate {
210
+ project: string;
211
+ id: string;
212
+ rule: string;
213
+ severity: "p0" | "p1";
214
+ }
215
+ /**
216
+ * Records where the RAW formula (`tierOf`) says "gate" but the record's
217
+ * last-PERSISTED `tier` field disagrees (absent, or a lower tier). PROPOSAL
218
+ * LIST ONLY (visibility, not a write-gate) — see this file's header.
219
+ */
220
+ export declare function promoteToGateCandidates(records: readonly CorrectionRecord[], asOfDay: string): PromoteToGateCandidate[];
221
+ export interface RetierOptions {
222
+ /** Storage root override. Defaults to core's getRoot() (AGENT_RECALL_ROOT / setRoot() / ~/.agent-recall). */
223
+ storeRoot?: string;
224
+ /** "as of" day (YYYY-MM-DD) for every recency comparison. Defaults to today (local calendar day). */
225
+ asOfDay?: string;
226
+ /** Persist the computed tier via setCorrectionTier(). Default false (dry-run — computes and reports, writes nothing). */
227
+ write?: boolean;
228
+ }
229
+ export interface RetierRow {
230
+ project: string;
231
+ id: string;
232
+ severity: "p0" | "p1";
233
+ rule: string;
234
+ /** The record's last-persisted `tier` field, or null if never retiered. */
235
+ stored_tier: CorrectionTier | null;
236
+ /** Raw tierOf() output, before any demotion adjustment. */
237
+ computed_tier: CorrectionTier;
238
+ /** computed_tier, stepped down once if any demotion trigger fired — what --write persists (or would persist). */
239
+ final_tier: CorrectionTier;
240
+ /** Demotion trigger names that fired (empty = none). */
241
+ triggers: string[];
242
+ /** final_tier !== stored_tier. */
243
+ changed: boolean;
244
+ }
245
+ export interface RetierResult {
246
+ as_of: string;
247
+ store_root: string;
248
+ dry_run: boolean;
249
+ projects_scanned: number;
250
+ rows: RetierRow[];
251
+ /** Counts by final_tier — always sums to rows.length. */
252
+ tier_distribution: Record<CorrectionTier, number>;
253
+ /** rows where a demotion trigger fired. */
254
+ demoted: RetierRow[];
255
+ promote_to_gate_candidates: PromoteToGateCandidate[];
256
+ archive_candidates: ArchiveCandidate[];
257
+ /** Records actually persisted this run (always 0 when dry_run is true). */
258
+ written: number;
259
+ /** Per-record write failures (lock contention) — see setCorrectionTier. */
260
+ write_errors: number;
261
+ }
262
+ /**
263
+ * Cross-project retier run. Dry-run by default (computes and reports,
264
+ * writes nothing); pass `{ write: true }` to persist via `setCorrectionTier`
265
+ * — see this file's header for the exact write semantics (demotion always
266
+ * applied; promotion into "gate" is the raw formula, not held back;
267
+ * archive/promote-to-gate lists are NEVER applied here regardless of
268
+ * `write`). Idempotent given unchanged inputs and the same `asOfDay`: a
269
+ * second `{ write: true }` run persists zero records (both this function's
270
+ * own `changed` pre-filter AND `setCorrectionTier`'s independent fresh-read
271
+ * check guard this).
272
+ */
273
+ export declare function runRetier(opts?: RetierOptions): Promise<RetierResult>;
274
+ //# sourceMappingURL=retier.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retier.d.ts","sourceRoot":"","sources":["../../src/tools-logic/retier.ts"],"names":[],"mappings":"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"}