agent-recall-core 3.4.49 → 3.4.51

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 (95) hide show
  1. package/dist/helpers/transcript-project.d.ts +69 -0
  2. package/dist/helpers/transcript-project.d.ts.map +1 -0
  3. package/dist/helpers/transcript-project.js +212 -0
  4. package/dist/helpers/transcript-project.js.map +1 -0
  5. package/dist/index.d.ts +26 -5
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +51 -3
  8. package/dist/index.js.map +1 -1
  9. package/dist/palace/awareness.d.ts +28 -0
  10. package/dist/palace/awareness.d.ts.map +1 -1
  11. package/dist/palace/awareness.js +40 -6
  12. package/dist/palace/awareness.js.map +1 -1
  13. package/dist/prompts/consolidation-prompt.d.ts.map +1 -1
  14. package/dist/prompts/consolidation-prompt.js +5 -0
  15. package/dist/prompts/consolidation-prompt.js.map +1 -1
  16. package/dist/retrieval/activation.d.ts +202 -0
  17. package/dist/retrieval/activation.d.ts.map +1 -0
  18. package/dist/retrieval/activation.js +313 -0
  19. package/dist/retrieval/activation.js.map +1 -0
  20. package/dist/storage/corrections.d.ts +140 -2
  21. package/dist/storage/corrections.d.ts.map +1 -1
  22. package/dist/storage/corrections.js +97 -4
  23. package/dist/storage/corrections.js.map +1 -1
  24. package/dist/storage/dream-health.d.ts +56 -8
  25. package/dist/storage/dream-health.d.ts.map +1 -1
  26. package/dist/storage/dream-health.js +130 -35
  27. package/dist/storage/dream-health.js.map +1 -1
  28. package/dist/storage/dream-yield.d.ts +81 -0
  29. package/dist/storage/dream-yield.d.ts.map +1 -0
  30. package/dist/storage/dream-yield.js +77 -0
  31. package/dist/storage/dream-yield.js.map +1 -0
  32. package/dist/storage/filelock.d.ts +10 -2
  33. package/dist/storage/filelock.d.ts.map +1 -1
  34. package/dist/storage/filelock.js +10 -2
  35. package/dist/storage/filelock.js.map +1 -1
  36. package/dist/storage/heed-tiers.d.ts +206 -0
  37. package/dist/storage/heed-tiers.d.ts.map +1 -0
  38. package/dist/storage/heed-tiers.js +318 -0
  39. package/dist/storage/heed-tiers.js.map +1 -0
  40. package/dist/supabase/sync.d.ts +1 -1
  41. package/dist/supabase/sync.d.ts.map +1 -1
  42. package/dist/supabase/sync.js +47 -11
  43. package/dist/supabase/sync.js.map +1 -1
  44. package/dist/tools-logic/association.d.ts +260 -0
  45. package/dist/tools-logic/association.d.ts.map +1 -0
  46. package/dist/tools-logic/association.js +502 -0
  47. package/dist/tools-logic/association.js.map +1 -0
  48. package/dist/tools-logic/check-action.d.ts.map +1 -1
  49. package/dist/tools-logic/check-action.js +14 -0
  50. package/dist/tools-logic/check-action.js.map +1 -1
  51. package/dist/tools-logic/dream-admission.d.ts +144 -0
  52. package/dist/tools-logic/dream-admission.d.ts.map +1 -0
  53. package/dist/tools-logic/dream-admission.js +537 -0
  54. package/dist/tools-logic/dream-admission.js.map +1 -0
  55. package/dist/tools-logic/implicit-harvest.d.ts +196 -0
  56. package/dist/tools-logic/implicit-harvest.d.ts.map +1 -0
  57. package/dist/tools-logic/implicit-harvest.js +675 -0
  58. package/dist/tools-logic/implicit-harvest.js.map +1 -0
  59. package/dist/tools-logic/insight-promotion.d.ts +18 -0
  60. package/dist/tools-logic/insight-promotion.d.ts.map +1 -1
  61. package/dist/tools-logic/insight-promotion.js +90 -15
  62. package/dist/tools-logic/insight-promotion.js.map +1 -1
  63. package/dist/tools-logic/retier.d.ts +274 -0
  64. package/dist/tools-logic/retier.d.ts.map +1 -0
  65. package/dist/tools-logic/retier.js +511 -0
  66. package/dist/tools-logic/retier.js.map +1 -0
  67. package/dist/tools-logic/safety-consolidation.d.ts +15 -0
  68. package/dist/tools-logic/safety-consolidation.d.ts.map +1 -1
  69. package/dist/tools-logic/safety-consolidation.js +13 -2
  70. package/dist/tools-logic/safety-consolidation.js.map +1 -1
  71. package/dist/tools-logic/session-end-reflect.d.ts.map +1 -1
  72. package/dist/tools-logic/session-end-reflect.js +4 -1
  73. package/dist/tools-logic/session-end-reflect.js.map +1 -1
  74. package/dist/tools-logic/session-end.d.ts +35 -0
  75. package/dist/tools-logic/session-end.d.ts.map +1 -1
  76. package/dist/tools-logic/session-end.js +26 -7
  77. package/dist/tools-logic/session-end.js.map +1 -1
  78. package/dist/tools-logic/session-start.d.ts +11 -0
  79. package/dist/tools-logic/session-start.d.ts.map +1 -1
  80. package/dist/tools-logic/session-start.js +34 -4
  81. package/dist/tools-logic/session-start.js.map +1 -1
  82. package/dist/tools-logic/smart-recall.d.ts +11 -0
  83. package/dist/tools-logic/smart-recall.d.ts.map +1 -1
  84. package/dist/tools-logic/smart-recall.js +11 -0
  85. package/dist/tools-logic/smart-recall.js.map +1 -1
  86. package/dist/tools-logic/store-doctor.d.ts.map +1 -1
  87. package/dist/tools-logic/store-doctor.js +7 -1
  88. package/dist/tools-logic/store-doctor.js.map +1 -1
  89. package/dist/tools-logic/transcript-audit.d.ts +128 -0
  90. package/dist/tools-logic/transcript-audit.d.ts.map +1 -0
  91. package/dist/tools-logic/transcript-audit.js +428 -0
  92. package/dist/tools-logic/transcript-audit.js.map +1 -0
  93. package/dist/types.d.ts +1 -1
  94. package/dist/types.js +1 -1
  95. package/package.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"implicit-harvest.js","sourceRoot":"","sources":["../../src/tools-logic/implicit-harvest.ts"],"names":[],"mappings":"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"}
@@ -11,6 +11,24 @@ export interface PromotionResult {
11
11
  promoted: string[];
12
12
  skipped: string[];
13
13
  }
14
+ /**
15
+ * The promotion bar. ONE constant, TWO entry points: the online path
16
+ * (session_end → promoteConfirmedInsights default) and the offline dream
17
+ * (dream-admission.ts re-exports it as DREAM_PROMOTION_THRESHOLD). fix10
18
+ * LOW-4: previously duplicated as two literals — raising one silently forked
19
+ * the bar.
20
+ */
21
+ export declare const PROMOTION_CONFIRMATION_THRESHOLD = 3;
22
+ /**
23
+ * The awareness-presence predicate promoteConfirmedInsights uses for its
24
+ * dedup skip — exported (fix10 HIGH-1) so dream-admission can verify a
25
+ * bar-clearing candidate ACTUALLY landed in awareness instead of inferring
26
+ * "already present" from mere absence in `promoted` (which also happens on
27
+ * quality-gate rejection or a thrown promotion pass).
28
+ *
29
+ * `existingTitlesLower` must be LOWERCASED awareness titles.
30
+ */
31
+ export declare function titlePresentInAwareness(title: string, existingTitlesLower: Iterable<string>): boolean;
14
32
  /**
15
33
  * Promote insights from insights-index into awareness when confirmed_count >= threshold.
16
34
  * @param threshold minimum confirmations required (default 3)
@@ -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;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,SAAS,SAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CA4DtF"}
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,23 +7,107 @@
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
+ /**
14
+ * The promotion bar. ONE constant, TWO entry points: the online path
15
+ * (session_end → promoteConfirmedInsights default) and the offline dream
16
+ * (dream-admission.ts re-exports it as DREAM_PROMOTION_THRESHOLD). fix10
17
+ * LOW-4: previously duplicated as two literals — raising one silently forked
18
+ * the bar.
19
+ */
20
+ export const PROMOTION_CONFIRMATION_THRESHOLD = 3;
21
+ /**
22
+ * The awareness-presence predicate promoteConfirmedInsights uses for its
23
+ * dedup skip — exported (fix10 HIGH-1) so dream-admission can verify a
24
+ * bar-clearing candidate ACTUALLY landed in awareness instead of inferring
25
+ * "already present" from mere absence in `promoted` (which also happens on
26
+ * quality-gate rejection or a thrown promotion pass).
27
+ *
28
+ * `existingTitlesLower` must be LOWERCASED awareness titles.
29
+ */
30
+ export function titlePresentInAwareness(title, existingTitlesLower) {
31
+ const titleLower = title.toLowerCase();
32
+ const words = tokenizeWords(title, { minLength: 0 });
33
+ for (const existing of existingTitlesLower) {
34
+ if (existing === titleLower)
35
+ return true;
36
+ const existingWords = tokenizeWords(existing, { minLength: 0 });
37
+ if (words.length === 0 || existingWords.length === 0)
38
+ continue;
39
+ const overlap = words.filter((w) => existingWords.includes(w) && (w.length > 3 || NON_ASCII_RE.test(w))).length;
40
+ if (overlap / Math.max(existingWords.length, words.length) > 0.5)
41
+ return true;
42
+ }
43
+ return false;
44
+ }
13
45
  /**
14
46
  * Promote insights from insights-index into awareness when confirmed_count >= threshold.
15
47
  * @param threshold minimum confirmations required (default 3)
16
48
  */
17
- export async function promoteConfirmedInsights(threshold = 3) {
49
+ export async function promoteConfirmedInsights(threshold = PROMOTION_CONFIRMATION_THRESHOLD) {
18
50
  const index = readInsightsIndex();
19
51
  const state = readAwarenessState();
20
52
  // Build set of existing awareness titles (lowercased) for dedup check
21
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;
22
92
  const promoted = [];
23
93
  const skipped = [];
24
94
  for (const insight of index.insights) {
25
95
  if (insight.confirmed_count < threshold)
26
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
+ }
27
111
  // Title-similarity dedup: exact match first, then word overlap.
28
112
  // CJK-aware (fix #3, 2026-09-11): the pre-fix grammar was
29
113
  // `titleLower.split(/\s+/)` + `w.length > 3` — an unspaced CJK title
@@ -33,19 +117,10 @@ export async function promoteConfirmedInsights(threshold = 3) {
33
117
  // (Intl.Segmenter) and lowercases/whitespace-splits the rest exactly
34
118
  // like the old grammar did for ASCII; the length floor now exempts
35
119
  // non-ASCII tokens (NON_ASCII_RE — the floor is English-tuned).
36
- const titleLower = insight.title.toLowerCase();
37
- const words = tokenizeWords(insight.title, { minLength: 0 });
38
- const alreadyPresent = [...existingTitles].some((existing) => {
39
- // Exact title match (fast path)
40
- if (existing === titleLower)
41
- return true;
42
- // Word-overlap similarity (same logic as addIndexedInsight)
43
- const existingWords = tokenizeWords(existing, { minLength: 0 });
44
- if (words.length === 0 || existingWords.length === 0)
45
- return false;
46
- const overlap = words.filter((w) => existingWords.includes(w) && (w.length > 3 || NON_ASCII_RE.test(w))).length;
47
- return overlap / Math.max(existingWords.length, words.length) > 0.5;
48
- });
120
+ // fix10 HIGH-1: the predicate is extracted (titlePresentInAwareness) so
121
+ // dream-admission applies the IDENTICAL check when verifying a
122
+ // promotion actually landed.
123
+ const alreadyPresent = titlePresentInAwareness(insight.title, existingTitles);
49
124
  if (alreadyPresent) {
50
125
  skipped.push(insight.title);
51
126
  continue;
@@ -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":"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"}
@@ -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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"}