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.
- package/dist/helpers/transcript-project.d.ts +69 -0
- package/dist/helpers/transcript-project.d.ts.map +1 -0
- package/dist/helpers/transcript-project.js +212 -0
- package/dist/helpers/transcript-project.js.map +1 -0
- package/dist/index.d.ts +26 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +51 -3
- package/dist/index.js.map +1 -1
- package/dist/palace/awareness.d.ts +28 -0
- package/dist/palace/awareness.d.ts.map +1 -1
- package/dist/palace/awareness.js +40 -6
- package/dist/palace/awareness.js.map +1 -1
- package/dist/prompts/consolidation-prompt.d.ts.map +1 -1
- package/dist/prompts/consolidation-prompt.js +5 -0
- package/dist/prompts/consolidation-prompt.js.map +1 -1
- package/dist/retrieval/activation.d.ts +202 -0
- package/dist/retrieval/activation.d.ts.map +1 -0
- package/dist/retrieval/activation.js +313 -0
- package/dist/retrieval/activation.js.map +1 -0
- package/dist/storage/corrections.d.ts +140 -2
- package/dist/storage/corrections.d.ts.map +1 -1
- package/dist/storage/corrections.js +97 -4
- package/dist/storage/corrections.js.map +1 -1
- package/dist/storage/dream-health.d.ts +56 -8
- package/dist/storage/dream-health.d.ts.map +1 -1
- package/dist/storage/dream-health.js +130 -35
- package/dist/storage/dream-health.js.map +1 -1
- package/dist/storage/dream-yield.d.ts +81 -0
- package/dist/storage/dream-yield.d.ts.map +1 -0
- package/dist/storage/dream-yield.js +77 -0
- package/dist/storage/dream-yield.js.map +1 -0
- package/dist/storage/filelock.d.ts +10 -2
- package/dist/storage/filelock.d.ts.map +1 -1
- package/dist/storage/filelock.js +10 -2
- package/dist/storage/filelock.js.map +1 -1
- package/dist/storage/heed-tiers.d.ts +206 -0
- package/dist/storage/heed-tiers.d.ts.map +1 -0
- package/dist/storage/heed-tiers.js +318 -0
- package/dist/storage/heed-tiers.js.map +1 -0
- package/dist/supabase/sync.d.ts +1 -1
- package/dist/supabase/sync.d.ts.map +1 -1
- package/dist/supabase/sync.js +47 -11
- package/dist/supabase/sync.js.map +1 -1
- package/dist/tools-logic/association.d.ts +260 -0
- package/dist/tools-logic/association.d.ts.map +1 -0
- package/dist/tools-logic/association.js +502 -0
- package/dist/tools-logic/association.js.map +1 -0
- package/dist/tools-logic/check-action.d.ts.map +1 -1
- package/dist/tools-logic/check-action.js +14 -0
- package/dist/tools-logic/check-action.js.map +1 -1
- package/dist/tools-logic/dream-admission.d.ts +144 -0
- package/dist/tools-logic/dream-admission.d.ts.map +1 -0
- package/dist/tools-logic/dream-admission.js +537 -0
- package/dist/tools-logic/dream-admission.js.map +1 -0
- package/dist/tools-logic/implicit-harvest.d.ts +196 -0
- package/dist/tools-logic/implicit-harvest.d.ts.map +1 -0
- package/dist/tools-logic/implicit-harvest.js +675 -0
- package/dist/tools-logic/implicit-harvest.js.map +1 -0
- package/dist/tools-logic/insight-promotion.d.ts +18 -0
- package/dist/tools-logic/insight-promotion.d.ts.map +1 -1
- package/dist/tools-logic/insight-promotion.js +90 -15
- package/dist/tools-logic/insight-promotion.js.map +1 -1
- package/dist/tools-logic/retier.d.ts +274 -0
- package/dist/tools-logic/retier.d.ts.map +1 -0
- package/dist/tools-logic/retier.js +511 -0
- package/dist/tools-logic/retier.js.map +1 -0
- package/dist/tools-logic/safety-consolidation.d.ts +15 -0
- package/dist/tools-logic/safety-consolidation.d.ts.map +1 -1
- package/dist/tools-logic/safety-consolidation.js +13 -2
- package/dist/tools-logic/safety-consolidation.js.map +1 -1
- package/dist/tools-logic/session-end-reflect.d.ts.map +1 -1
- package/dist/tools-logic/session-end-reflect.js +4 -1
- package/dist/tools-logic/session-end-reflect.js.map +1 -1
- package/dist/tools-logic/session-end.d.ts +35 -0
- package/dist/tools-logic/session-end.d.ts.map +1 -1
- package/dist/tools-logic/session-end.js +26 -7
- package/dist/tools-logic/session-end.js.map +1 -1
- package/dist/tools-logic/session-start.d.ts +11 -0
- package/dist/tools-logic/session-start.d.ts.map +1 -1
- package/dist/tools-logic/session-start.js +34 -4
- package/dist/tools-logic/session-start.js.map +1 -1
- package/dist/tools-logic/smart-recall.d.ts +11 -0
- package/dist/tools-logic/smart-recall.d.ts.map +1 -1
- package/dist/tools-logic/smart-recall.js +11 -0
- package/dist/tools-logic/smart-recall.js.map +1 -1
- package/dist/tools-logic/store-doctor.d.ts.map +1 -1
- package/dist/tools-logic/store-doctor.js +7 -1
- package/dist/tools-logic/store-doctor.js.map +1 -1
- package/dist/tools-logic/transcript-audit.d.ts +128 -0
- package/dist/tools-logic/transcript-audit.d.ts.map +1 -0
- package/dist/tools-logic/transcript-audit.js +428 -0
- package/dist/tools-logic/transcript-audit.js.map +1 -0
- package/dist/types.d.ts +1 -1
- package/dist/types.js +1 -1
- package/package.json +1 -1
|
@@ -1,24 +1,51 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Dream health —
|
|
2
|
+
* Dream health — uptime AND yield for the nightly dreaming pipeline.
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
4
|
+
* History: this module originally only counted consecutive failure days from
|
|
5
|
+
* the AAM run logs ("did the log say Dream complete") — uptime. That let the
|
|
6
|
+
* broken admission math run 22+ consecutive ZERO-OUTPUT nights (2026-08-20 →
|
|
7
|
+
* 09-12) with every night green: the cron fired, the log said complete, and
|
|
8
|
+
* nothing anywhere recorded that every candidate had been silently discarded.
|
|
7
9
|
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
10
|
+
* fix10 (2026-09-12) adds the YIELD dimension. dream-admission writes one
|
|
11
|
+
* yield record per night (<root>/dreams/yield-YYYY-MM-DD.json — see
|
|
12
|
+
* storage/dream-yield.ts); this module classifies each night and keeps a
|
|
13
|
+
* zero-yield streak with a CAUSE breakdown, so a silent-empty streak is
|
|
14
|
+
* structurally impossible:
|
|
15
|
+
*
|
|
16
|
+
* "filtered" — candidates seen, math rejected them → banner at ≥3 nights
|
|
17
|
+
* "errored" — run recorded errors, zero yield → banner at ≥3 nights
|
|
18
|
+
* "no-yield-data" — run completed but wrote no yield record (SOP not yet
|
|
19
|
+
* repointed / instrumentation gap) → banner at ≥3 nights
|
|
20
|
+
* "empty-corpus" — zero candidates in the corpus → banner at ≥7 nights
|
|
21
|
+
* "already-known" — candidates seen, all already counted → banner at ≥7 nights
|
|
22
|
+
*
|
|
23
|
+
* Uptime logs: ~/.aam/dreams/run-YYYY-MM-DD.log (AAM-orchestrated dreams).
|
|
24
|
+
* A day's log "succeeded" if it contains "Dream complete"/"Dream run complete".
|
|
11
25
|
*/
|
|
12
26
|
import * as fs from "node:fs";
|
|
13
27
|
import * as path from "node:path";
|
|
14
28
|
import * as os from "node:os";
|
|
15
|
-
|
|
29
|
+
import { readDreamYield, classifyNight } from "./dream-yield.js";
|
|
30
|
+
const DEFAULT_DREAMS_DIR = path.join(os.homedir(), ".aam", "dreams");
|
|
16
31
|
const LOOKBACK_DAYS = 7;
|
|
17
32
|
const BANNER_THRESHOLD = 2; // surface when N or more consecutive failures
|
|
18
|
-
|
|
19
|
-
|
|
33
|
+
/** Yield lookback must be long enough that a 22-night silent streak can never
|
|
34
|
+
* hide inside it again. */
|
|
35
|
+
const YIELD_LOOKBACK_DAYS = 30;
|
|
36
|
+
/** Zero-yield streaks containing a "filtered", "errored" or "no-yield-data"
|
|
37
|
+
* night banner here. */
|
|
38
|
+
const ZERO_YIELD_BANNER_THRESHOLD = 3;
|
|
39
|
+
/** Pure thin-corpus / already-known streaks banner here (a quiet week is
|
|
40
|
+
* legitimate; a quiet-plus week deserves a look). */
|
|
41
|
+
const THIN_CORPUS_BANNER_THRESHOLD = 7;
|
|
42
|
+
function dateNDaysAgo(n, now) {
|
|
43
|
+
const d = new Date(now.getTime());
|
|
20
44
|
d.setDate(d.getDate() - n);
|
|
21
|
-
|
|
45
|
+
const y = d.getFullYear();
|
|
46
|
+
const m = String(d.getMonth() + 1).padStart(2, "0");
|
|
47
|
+
const day = String(d.getDate()).padStart(2, "0");
|
|
48
|
+
return `${y}-${m}-${day}`;
|
|
22
49
|
}
|
|
23
50
|
function isSuccess(logPath) {
|
|
24
51
|
try {
|
|
@@ -29,50 +56,118 @@ function isSuccess(logPath) {
|
|
|
29
56
|
return false;
|
|
30
57
|
}
|
|
31
58
|
}
|
|
32
|
-
export function getDreamHealth() {
|
|
59
|
+
export function getDreamHealth(opts = {}) {
|
|
60
|
+
const dreamsDir = opts.aamDreamsDir ?? process.env.AGENT_RECALL_AAM_DREAMS_DIR ?? DEFAULT_DREAMS_DIR;
|
|
61
|
+
const now = opts.now ?? new Date();
|
|
33
62
|
const out = {
|
|
34
63
|
consecutive_failures: 0,
|
|
35
64
|
last_failed_date: null,
|
|
36
65
|
last_success_date: null,
|
|
66
|
+
consecutive_zero_yield: 0,
|
|
67
|
+
last_night_class: null,
|
|
68
|
+
zero_yield_causes: {},
|
|
69
|
+
yield_last_night: null,
|
|
37
70
|
banner: null,
|
|
71
|
+
banner_kind: null,
|
|
38
72
|
};
|
|
39
|
-
|
|
40
|
-
return out;
|
|
73
|
+
// ── uptime streak (unchanged behavior) ──────────────────────────────────
|
|
41
74
|
// Walk yesterday → 7 days ago. Today is in-progress so we don't count it.
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
75
|
+
if (fs.existsSync(dreamsDir)) {
|
|
76
|
+
for (let i = 1; i <= LOOKBACK_DAYS; i++) {
|
|
77
|
+
const dateStr = dateNDaysAgo(i, now);
|
|
78
|
+
const logPath = path.join(dreamsDir, `run-${dateStr}.log`);
|
|
79
|
+
if (!fs.existsSync(logPath)) {
|
|
80
|
+
// No log = no run that night; treat as a failure (cron didn't fire OR
|
|
81
|
+
// it crashed before writing). Stops the streak if we'd been counting,
|
|
82
|
+
// since "no log" + "missing" are both signs of unhealthy automation.
|
|
83
|
+
if (out.last_success_date === null) {
|
|
84
|
+
out.consecutive_failures++;
|
|
85
|
+
if (out.last_failed_date === null)
|
|
86
|
+
out.last_failed_date = dateStr;
|
|
87
|
+
}
|
|
88
|
+
else {
|
|
89
|
+
break;
|
|
90
|
+
}
|
|
91
|
+
continue;
|
|
92
|
+
}
|
|
93
|
+
if (isSuccess(logPath)) {
|
|
94
|
+
if (out.last_success_date === null)
|
|
95
|
+
out.last_success_date = dateStr;
|
|
96
|
+
break; // streak ended
|
|
97
|
+
}
|
|
98
|
+
else {
|
|
50
99
|
out.consecutive_failures++;
|
|
51
100
|
if (out.last_failed_date === null)
|
|
52
101
|
out.last_failed_date = dateStr;
|
|
53
102
|
}
|
|
54
|
-
|
|
55
|
-
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
// ── yield streak (fix10) ────────────────────────────────────────────────
|
|
106
|
+
// Walk yesterday → 30 days ago. A night participates when it RAN (success
|
|
107
|
+
// log present) or left a yield record; cron-dead nights belong to the
|
|
108
|
+
// uptime streak above and neither extend nor break the yield streak.
|
|
109
|
+
let candidatesSeenInStreak = 0;
|
|
110
|
+
for (let i = 1; i <= YIELD_LOOKBACK_DAYS; i++) {
|
|
111
|
+
const dateStr = dateNDaysAgo(i, now);
|
|
112
|
+
const record = readDreamYield(dateStr);
|
|
113
|
+
const ranPerLog = fs.existsSync(path.join(dreamsDir, `run-${dateStr}.log`))
|
|
114
|
+
&& isSuccess(path.join(dreamsDir, `run-${dateStr}.log`));
|
|
115
|
+
if (!record && !ranPerLog)
|
|
116
|
+
continue; // no run that night
|
|
117
|
+
const klass = classifyNight(record);
|
|
118
|
+
if (out.last_night_class === null) {
|
|
119
|
+
out.last_night_class = klass;
|
|
120
|
+
if (record) {
|
|
121
|
+
out.yield_last_night = {
|
|
122
|
+
date: record.date,
|
|
123
|
+
candidates_seen: record.candidates_seen,
|
|
124
|
+
admitted: record.admitted,
|
|
125
|
+
promoted: record.promoted,
|
|
126
|
+
already_known: record.already_known,
|
|
127
|
+
rejected: record.rejected,
|
|
128
|
+
};
|
|
56
129
|
}
|
|
57
|
-
continue;
|
|
58
130
|
}
|
|
59
|
-
if (
|
|
60
|
-
if (out.last_success_date === null)
|
|
61
|
-
out.last_success_date = dateStr;
|
|
131
|
+
if (klass === "productive")
|
|
62
132
|
break; // streak ended
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
out.last_failed_date = dateStr;
|
|
68
|
-
}
|
|
133
|
+
out.consecutive_zero_yield++;
|
|
134
|
+
out.zero_yield_causes[klass] = (out.zero_yield_causes[klass] ?? 0) + 1;
|
|
135
|
+
if (record)
|
|
136
|
+
candidatesSeenInStreak += record.candidates_seen;
|
|
69
137
|
}
|
|
138
|
+
// ── banners (failure streak wins — a dead cron is the louder problem) ───
|
|
70
139
|
if (out.consecutive_failures >= BANNER_THRESHOLD) {
|
|
71
140
|
const lastSuccess = out.last_success_date ?? `>${LOOKBACK_DAYS} days ago`;
|
|
72
141
|
out.banner =
|
|
73
142
|
`⚠ Dream cron failed ${out.consecutive_failures} nights in a row ` +
|
|
74
143
|
`(last success: ${lastSuccess}). The awareness backfill is broken — ` +
|
|
75
|
-
`check
|
|
144
|
+
`check ${path.join(dreamsDir, `run-${out.last_failed_date}.log`)} for auth or network errors.`;
|
|
145
|
+
out.banner_kind = "failure";
|
|
146
|
+
return out;
|
|
147
|
+
}
|
|
148
|
+
const filtered = out.zero_yield_causes["filtered"] ?? 0;
|
|
149
|
+
const errored = out.zero_yield_causes["errored"] ?? 0;
|
|
150
|
+
const noData = out.zero_yield_causes["no-yield-data"] ?? 0;
|
|
151
|
+
if (out.consecutive_zero_yield >= ZERO_YIELD_BANNER_THRESHOLD && (filtered > 0 || errored > 0 || noData > 0)) {
|
|
152
|
+
const causes = [];
|
|
153
|
+
if (filtered > 0)
|
|
154
|
+
causes.push(`${filtered} night(s) the admission math rejected every candidate (${candidatesSeenInStreak} candidates seen, 0 admitted)`);
|
|
155
|
+
if (errored > 0)
|
|
156
|
+
causes.push(`${errored} night(s) ran with errors (see errors[] in the yield files)`);
|
|
157
|
+
if (noData > 0)
|
|
158
|
+
causes.push(`${noData} night(s) ran without writing a yield record (SOP not repointed to \`ar dream admit\`?)`);
|
|
159
|
+
out.banner =
|
|
160
|
+
`⚠ Dream ran ${out.consecutive_zero_yield} nights in a row with ZERO yield — ` +
|
|
161
|
+
`not a thin corpus: ${causes.join("; ")}. ` +
|
|
162
|
+
`Inspect the yield files under <root>/dreams/yield-*.json.`;
|
|
163
|
+
out.banner_kind = "zero-yield";
|
|
164
|
+
}
|
|
165
|
+
else if (out.consecutive_zero_yield >= THIN_CORPUS_BANNER_THRESHOLD) {
|
|
166
|
+
out.banner =
|
|
167
|
+
`ℹ Dream yielded nothing for ${out.consecutive_zero_yield} consecutive nights — ` +
|
|
168
|
+
`corpus genuinely thin (no candidates were filtered out). ` +
|
|
169
|
+
`Fine if activity has been low; otherwise check capture volume.`;
|
|
170
|
+
out.banner_kind = "thin-corpus";
|
|
76
171
|
}
|
|
77
172
|
return out;
|
|
78
173
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dream-health.js","sourceRoot":"","sources":["../../src/storage/dream-health.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"dream-health.js","sourceRoot":"","sources":["../../src/storage/dream-health.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dream-yield.ts — per-night YIELD accounting for the dreaming pipeline (fix10).
|
|
3
|
+
*
|
|
4
|
+
* Why this exists: dream-health.ts historically measured UPTIME only ("did the
|
|
5
|
+
* log say Dream complete") — 22 consecutive zero-output nights were all green
|
|
6
|
+
* because the broken admission math (`(obs/7) × recency ≤ 0.85` — see
|
|
7
|
+
* tools-logic/dream-admission.ts) silently discarded every candidate and
|
|
8
|
+
* nothing recorded that a candidate had even been seen.
|
|
9
|
+
*
|
|
10
|
+
* This module is the structural fix for the SILENCE half of that bug: every
|
|
11
|
+
* dream-admission run writes one DreamYieldRecord per night, and every
|
|
12
|
+
* candidate appears in it with an explicit outcome + reason. A zero-output
|
|
13
|
+
* night is now CLASSIFIABLE:
|
|
14
|
+
*
|
|
15
|
+
* "empty-corpus" — the corpus genuinely produced no candidates
|
|
16
|
+
* "filtered" — candidates were seen but the math rejected them (RED —
|
|
17
|
+
* this is exactly the failure mode that ran silent for
|
|
18
|
+
* 22 nights)
|
|
19
|
+
* "already-known" — candidates were seen but every one was already counted
|
|
20
|
+
* or already promoted (nothing NEW, but nothing hidden)
|
|
21
|
+
* "errored" — the run recorded errors (ledger corruption/write
|
|
22
|
+
* failure, promotion-pass failure, …) and produced no
|
|
23
|
+
* yield; never benign (fix10 review MEDIUM-2 — errors[]
|
|
24
|
+
* used to be invisible to classification)
|
|
25
|
+
* "no-yield-data" — the run log says the dream completed but no yield
|
|
26
|
+
* record exists (instrumentation gap — e.g. the SOP has
|
|
27
|
+
* not been repointed to `ar dream admit` yet). Flagged,
|
|
28
|
+
* never treated as healthy.
|
|
29
|
+
*
|
|
30
|
+
* File location: <root>/dreams/yield-YYYY-MM-DD.json — co-located with the
|
|
31
|
+
* dream reports the nightly agent writes to <root>/dreams/YYYY-MM-DD.md.
|
|
32
|
+
*/
|
|
33
|
+
/** One candidate's final disposition inside a night's yield record. */
|
|
34
|
+
export interface DreamYieldDecision {
|
|
35
|
+
title: string;
|
|
36
|
+
/** Final disposition after ledger dedup + index recording + promotion. */
|
|
37
|
+
outcome: "promoted" | "already-promoted" | "admitted" | "already-counted" | "rejected";
|
|
38
|
+
/** Distinct (day, project) observations inside the trailing window. */
|
|
39
|
+
observations_in_window: number;
|
|
40
|
+
/** Observations that were NEW tonight (not counted on a previous night). */
|
|
41
|
+
new_observations: number;
|
|
42
|
+
/** ALWAYS non-empty. A silent discard is structurally impossible. */
|
|
43
|
+
reason: string;
|
|
44
|
+
}
|
|
45
|
+
export interface DreamYieldCorpus {
|
|
46
|
+
journal_files?: number;
|
|
47
|
+
journal_bytes?: number;
|
|
48
|
+
corrections_new?: number;
|
|
49
|
+
notes?: string;
|
|
50
|
+
}
|
|
51
|
+
export interface DreamYieldRecord {
|
|
52
|
+
version: 1;
|
|
53
|
+
/** Run date (local calendar day the dream ran), YYYY-MM-DD. */
|
|
54
|
+
date: string;
|
|
55
|
+
generated_at: string;
|
|
56
|
+
candidates_seen: number;
|
|
57
|
+
admitted: number;
|
|
58
|
+
promoted: number;
|
|
59
|
+
already_known: number;
|
|
60
|
+
rejected: number;
|
|
61
|
+
/** reason → count, over every non-yield outcome (rejected + already-counted). */
|
|
62
|
+
discarded_by_reason: Record<string, number>;
|
|
63
|
+
decisions: DreamYieldDecision[];
|
|
64
|
+
/** Full list of titles promoteConfirmedInsights promoted this run (may
|
|
65
|
+
* include index insights confirmed by the ONLINE path, not just tonight's
|
|
66
|
+
* candidates — promotion is shared machinery). */
|
|
67
|
+
promoted_titles: string[];
|
|
68
|
+
corpus?: DreamYieldCorpus;
|
|
69
|
+
errors?: string[];
|
|
70
|
+
}
|
|
71
|
+
export type NightYieldClass = "productive" | "empty-corpus" | "filtered" | "already-known" | "errored" | "no-yield-data";
|
|
72
|
+
export declare function dreamsDir(): string;
|
|
73
|
+
export declare function dreamYieldPath(date: string): string;
|
|
74
|
+
export declare function writeDreamYield(record: DreamYieldRecord): void;
|
|
75
|
+
export declare function readDreamYield(date: string): DreamYieldRecord | null;
|
|
76
|
+
/**
|
|
77
|
+
* Classify one night. `null` = the night ran but left no yield record
|
|
78
|
+
* ("no-yield-data" — an instrumentation gap is a finding, not health).
|
|
79
|
+
*/
|
|
80
|
+
export declare function classifyNight(record: DreamYieldRecord | null): NightYieldClass;
|
|
81
|
+
//# sourceMappingURL=dream-yield.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dream-yield.d.ts","sourceRoot":"","sources":["../../src/storage/dream-yield.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAOH,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,OAAO,EACH,UAAU,GACV,kBAAkB,GAClB,UAAU,GACV,iBAAiB,GACjB,UAAU,CAAC;IACf,uEAAuE;IACvE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC;;uDAEmD;IACnD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,cAAc,GACd,UAAU,GACV,eAAe,GACf,SAAS,GACT,eAAe,CAAC;AAEpB,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAG9D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAKpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,eAAe,CAa9E"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dream-yield.ts — per-night YIELD accounting for the dreaming pipeline (fix10).
|
|
3
|
+
*
|
|
4
|
+
* Why this exists: dream-health.ts historically measured UPTIME only ("did the
|
|
5
|
+
* log say Dream complete") — 22 consecutive zero-output nights were all green
|
|
6
|
+
* because the broken admission math (`(obs/7) × recency ≤ 0.85` — see
|
|
7
|
+
* tools-logic/dream-admission.ts) silently discarded every candidate and
|
|
8
|
+
* nothing recorded that a candidate had even been seen.
|
|
9
|
+
*
|
|
10
|
+
* This module is the structural fix for the SILENCE half of that bug: every
|
|
11
|
+
* dream-admission run writes one DreamYieldRecord per night, and every
|
|
12
|
+
* candidate appears in it with an explicit outcome + reason. A zero-output
|
|
13
|
+
* night is now CLASSIFIABLE:
|
|
14
|
+
*
|
|
15
|
+
* "empty-corpus" — the corpus genuinely produced no candidates
|
|
16
|
+
* "filtered" — candidates were seen but the math rejected them (RED —
|
|
17
|
+
* this is exactly the failure mode that ran silent for
|
|
18
|
+
* 22 nights)
|
|
19
|
+
* "already-known" — candidates were seen but every one was already counted
|
|
20
|
+
* or already promoted (nothing NEW, but nothing hidden)
|
|
21
|
+
* "errored" — the run recorded errors (ledger corruption/write
|
|
22
|
+
* failure, promotion-pass failure, …) and produced no
|
|
23
|
+
* yield; never benign (fix10 review MEDIUM-2 — errors[]
|
|
24
|
+
* used to be invisible to classification)
|
|
25
|
+
* "no-yield-data" — the run log says the dream completed but no yield
|
|
26
|
+
* record exists (instrumentation gap — e.g. the SOP has
|
|
27
|
+
* not been repointed to `ar dream admit` yet). Flagged,
|
|
28
|
+
* never treated as healthy.
|
|
29
|
+
*
|
|
30
|
+
* File location: <root>/dreams/yield-YYYY-MM-DD.json — co-located with the
|
|
31
|
+
* dream reports the nightly agent writes to <root>/dreams/YYYY-MM-DD.md.
|
|
32
|
+
*/
|
|
33
|
+
import * as path from "node:path";
|
|
34
|
+
import { getRoot } from "../types.js";
|
|
35
|
+
import { ensureDir, readJsonSafe, writeJsonAtomic } from "./fs-utils.js";
|
|
36
|
+
export function dreamsDir() {
|
|
37
|
+
return path.join(getRoot(), "dreams");
|
|
38
|
+
}
|
|
39
|
+
export function dreamYieldPath(date) {
|
|
40
|
+
return path.join(dreamsDir(), `yield-${date}.json`);
|
|
41
|
+
}
|
|
42
|
+
export function writeDreamYield(record) {
|
|
43
|
+
ensureDir(dreamsDir());
|
|
44
|
+
writeJsonAtomic(dreamYieldPath(record.date), record);
|
|
45
|
+
}
|
|
46
|
+
export function readDreamYield(date) {
|
|
47
|
+
const rec = readJsonSafe(dreamYieldPath(date));
|
|
48
|
+
if (!rec || typeof rec !== "object")
|
|
49
|
+
return null;
|
|
50
|
+
if (typeof rec.date !== "string" || typeof rec.candidates_seen !== "number")
|
|
51
|
+
return null;
|
|
52
|
+
return rec;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* Classify one night. `null` = the night ran but left no yield record
|
|
56
|
+
* ("no-yield-data" — an instrumentation gap is a finding, not health).
|
|
57
|
+
*/
|
|
58
|
+
export function classifyNight(record) {
|
|
59
|
+
if (!record)
|
|
60
|
+
return "no-yield-data";
|
|
61
|
+
if (record.promoted + record.admitted > 0)
|
|
62
|
+
return "productive";
|
|
63
|
+
// MEDIUM-2: a zero-yield night that recorded errors is NEVER benign — a
|
|
64
|
+
// ledger reset or failed promotion pass must not read as "corpus thin" or
|
|
65
|
+
// "already known".
|
|
66
|
+
if ((record.errors?.length ?? 0) > 0)
|
|
67
|
+
return "errored";
|
|
68
|
+
if (record.candidates_seen === 0)
|
|
69
|
+
return "empty-corpus";
|
|
70
|
+
// Zero yield with candidates present: if the MATH rejected anything, the
|
|
71
|
+
// math is the cause; only when nothing was rejected is "everything was
|
|
72
|
+
// already known" the honest read.
|
|
73
|
+
if (record.rejected > 0)
|
|
74
|
+
return "filtered";
|
|
75
|
+
return "already-known";
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=dream-yield.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dream-yield.js","sourceRoot":"","sources":["../../src/storage/dream-yield.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAwDzE,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,IAAI,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;IACvB,eAAe,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,GAAG,YAAY,CAAmB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzF,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,IAAI,CAAC,MAAM;QAAE,OAAO,eAAe,CAAC;IACpC,IAAI,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IAC/D,wEAAwE;IACxE,0EAA0E;IAC1E,mBAAmB;IACnB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,IAAI,MAAM,CAAC,eAAe,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IACxD,yEAAyE;IACzE,uEAAuE;IACvE,kCAAkC;IAClC,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3C,OAAO,eAAe,CAAC;AACzB,CAAC"}
|
|
@@ -45,11 +45,19 @@
|
|
|
45
45
|
* Cross-process safety does not depend on the fn being sync: the mkdir lock
|
|
46
46
|
* itself excludes concurrent critical sections either way.
|
|
47
47
|
*
|
|
48
|
-
* LOCK ORDERING (deadlock discipline — the
|
|
48
|
+
* LOCK ORDERING (deadlock discipline — the complete nesting set):
|
|
49
49
|
* "awareness-state" → "awareness"
|
|
50
|
+
* "dream-admission" → "insights-index"
|
|
51
|
+
* "dream-admission" → "awareness-state" → "awareness"
|
|
50
52
|
* awareness.ts acquires "awareness" (awareness.md render) while holding
|
|
51
53
|
* "awareness-state" (awareness-state.json + awareness-archive.json RMW).
|
|
52
|
-
*
|
|
54
|
+
* fix10: dream-admission.ts wraps its whole nightly run (a long async
|
|
55
|
+
* critical section) in "dream-admission" and acquires "insights-index"
|
|
56
|
+
* (addIndexedInsight) and "awareness-state" (addInsight via
|
|
57
|
+
* promoteConfirmedInsights / the cap fallback) inside it. "dream-admission"
|
|
58
|
+
* has a SINGLE acquirer and is always the outermost lock — no cycle.
|
|
59
|
+
* Never acquire "awareness-state" while holding "awareness", and never
|
|
60
|
+
* acquire "dream-admission" while holding any other lock. Same-name
|
|
53
61
|
* nesting is a deadlock (the lock is NOT reentrant): modules expose
|
|
54
62
|
* *Unlocked internals for use inside their own critical sections instead.
|
|
55
63
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"filelock.d.ts","sourceRoot":"","sources":["../../src/storage/filelock.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"filelock.d.ts","sourceRoot":"","sources":["../../src/storage/filelock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AASH;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAQ,CAAC;AAgBnC;;;;kCAIkC;AAClC,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEtB,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;CAoBjF;AA6LD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAyBnE;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAOpF"}
|
package/dist/storage/filelock.js
CHANGED
|
@@ -45,11 +45,19 @@
|
|
|
45
45
|
* Cross-process safety does not depend on the fn being sync: the mkdir lock
|
|
46
46
|
* itself excludes concurrent critical sections either way.
|
|
47
47
|
*
|
|
48
|
-
* LOCK ORDERING (deadlock discipline — the
|
|
48
|
+
* LOCK ORDERING (deadlock discipline — the complete nesting set):
|
|
49
49
|
* "awareness-state" → "awareness"
|
|
50
|
+
* "dream-admission" → "insights-index"
|
|
51
|
+
* "dream-admission" → "awareness-state" → "awareness"
|
|
50
52
|
* awareness.ts acquires "awareness" (awareness.md render) while holding
|
|
51
53
|
* "awareness-state" (awareness-state.json + awareness-archive.json RMW).
|
|
52
|
-
*
|
|
54
|
+
* fix10: dream-admission.ts wraps its whole nightly run (a long async
|
|
55
|
+
* critical section) in "dream-admission" and acquires "insights-index"
|
|
56
|
+
* (addIndexedInsight) and "awareness-state" (addInsight via
|
|
57
|
+
* promoteConfirmedInsights / the cap fallback) inside it. "dream-admission"
|
|
58
|
+
* has a SINGLE acquirer and is always the outermost lock — no cycle.
|
|
59
|
+
* Never acquire "awareness-state" while holding "awareness", and never
|
|
60
|
+
* acquire "dream-admission" while holding any other lock. Same-name
|
|
53
61
|
* nesting is a deadlock (the lock is NOT reentrant): modules expose
|
|
54
62
|
* *Unlocked internals for use inside their own critical sections instead.
|
|
55
63
|
*
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"filelock.js","sourceRoot":"","sources":["../../src/storage/filelock.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"filelock.js","sourceRoot":"","sources":["../../src/storage/filelock.ts"],"names":[],"mappings":"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"}
|