@event4u/agent-config 14.23.0 → 15.0.0

package/src/scripts/hot_context_hook.ts

@@ -1,395 +1,63 @@
 #!/usr/bin/env node
 /**
- * Hot-context working-memory cache — `stop` + `session_start` hook.
+ * Memory session-index restore — `session_start` hook.
  *
- * road-to-second-brain Phase 1 (council 2026-07-07, verdict:
- * `agents/settings/contexts/second-brain-delta-verdict.md`). A bounded,
- * gitignored working-memory artifact that survives session boundaries and —
- * on Claude Code — context compaction (`SessionStart source=compact`).
+ * The working-memory CACHE this concern used to carry was retired
+ * (road-to-continuity-writer-activation step 3.1, AI council 2026-09-09 under
+ * the owner's written delegation; openai's mechanism operative). What survives
+ * is the half the council kept: the `session_start` restore of the persisted
+ * memory session index.
  *
- * Contract (per the verdict):
- *   - `agents/runtime/state/hot-context.md`, gitignored, OVERWRITTEN on every
- *     `stop` (cache, not journal). 400-word hard cap.
+ * The concern id `hot-context` is DELIBERATELY unchanged. Retiring the id was
+ * the competing proposal and was rejected: the −1 on `concern_count` buys
+ * nothing, while untagged running code costs the manifest its completeness
+ * property. Its DESCRIPTION is what changed.
  *
- * loss_class: ephemeral-lossy
+ * Contract:
+ *   - `session_start` only. The `stop` / `session_end` / `pre_compact` write
+ *     bindings are gone, and the cache file they maintained is neither written
+ *     nor read any more.
+ *   - Emits `{"decision":"allow","context":"<block>"}` on stdout; the
+ *     dispatcher forwards `context` so the host adds it to the session context.
+ *     The block is spotlighted as DATA, not instructions
+ *     (untrusted-input-defense).
+ *   - Never blocks: exit 0 on every path; failures are silent (stderr note).
  *
- * Named, not changed (`road-to-runtime-context-floors` step 3.1). The two losses
- * here are both deliberate and both unrecoverable, which is exactly what the
- * class asserts: the 400-word cap discards the older half of the window, and
- * `_redact_lines` DROPS any line the low-impact redactor refuses — including on
- * a redactor error, which is fail-closed per line. Neither is retrievable from
- * the output, and neither should be: this file is a privacy-floored cache whose
- * source of truth is the transcript it was built from, and storing a recovery
- * for a line dropped for privacy would defeat the reason it was dropped.
+ * No `loss_class` is declared on THIS file any more, and that is a real
+ * coverage change rather than an omission. The two lossy transforms the class
+ * described — the 400-word cap and the fail-closed `_redact_lines` drop — left
+ * with the cache. The 30-row cap the memory index still applies lives in
+ * `_lib/session_index_trust.ts`, which is not a concern script.
  *
- * `recoverable-lossy` would be the WRONG class here even though the transcript
- * still exists, and the distinction is the point of the vocabulary: the class
- * describes what THIS transform guarantees to its consumer, and this one
- * guarantees nothing about the dropped content on purpose.
- *   - Written by DETERMINISTIC extraction from the chat-history JSONL
- *     (`agents/runtime/.agent-chat-history`) — never LLM summarization.
- *   - Every extracted line passes the low-impact privacy floor
- *     (`redact_low_impact_entry`); violating lines are DROPPED, never
- *     rewritten (soft rewrite would be a soft gate).
- *   - `session_start` restore emits `{"decision":"allow","context":"<block>"}`
- *     on stdout; the dispatcher forwards `context` to its own stdout on
- *     session_start so the host adds it to the session context. The block is
- *     spotlighted as DATA, not instructions (untrusted-input-defense).
- *   - Staleness: discard (delete) when the stamped branch differs from the
- *     current branch, the stamp is older than 48 h, or the host says
- *     `source=clear`. `source=compact` / `resume` / `startup` re-inject.
- *   - Never blocks: exit 0 on every path; failures are silent (stderr note).
+ * A `loss_module:` pointer used to sit here, naming that module so the gate
+ * could see it. It is gone because the gate now REACHES the module instead of
+ * being told about it: `check_loss_class_declared` walks relative specifiers
+ * from every context-emitting concern, and this file's `createRequire` load of
+ * `_lib/session_index_trust.js` is one. The pointer's premise — that only a
+ * static-import closure was on offer and it could not see a `createRequire`
+ * load — is what changed; a specifier walk sees both.
+ *
+ * What that costs, stated because a pointer did catch one thing a walk cannot:
+ * a module loaded through a COMPUTED specifier is now invisible again. Nothing
+ * here does that, and if something ever does, the answer is to name the module
+ * rather than to reason about the walk.
  *
  * Reads the dispatcher JSON envelope on stdin
  * (`{platform, event, payload, workspace_root, …}`).
  */
 
-import { spawnSync } from 'node:child_process';
-import * as fs from 'node:fs';
 import { createRequire } from 'node:module';
 import * as path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 
-import { hardenedSpawnEnv } from './_lib/spawn_env.js';
-import { computeRereads } from './_lib/transcript_reads.js';
-import { redact_low_impact_entry } from './ai_council/redact_low_impact_entry.js';
 import { readHookStdin } from './hooks/hook_stdin.js';
 
-export const HOT_CONTEXT_REL = path.join('agents', 'runtime', 'state', 'hot-context.md');
-
 /** Replay-fixture runs must never mutate state (same contract as chat_history). */
 const REPLAY_ENV_VAR = 'AGENT_CONFIG_REPLAY';
 function _is_replay_mode(): boolean {
     return (process.env[REPLAY_ENV_VAR] ?? '').trim() === '1';
 }
-export const WORD_CAP = 400;
-export const MAX_AGE_HOURS = 48;
-
-const HISTORY_REL = 'agents/runtime/.agent-chat-history';
-
-const MAX_ACTIVE_THREADS = 3; // last user intents
-const MAX_RECENT_CHANGES = 5; // last tool results
-const MAX_OPEN_VERIFICATIONS = 3;
-const THREAD_SNIPPET_CHARS = 200;
-const CHANGE_SNIPPET_CHARS = 120;
-const KEY_FACTS_CHARS = 600;
-const MAX_REREAD_LINES = 3; // advisory, not an inventory — see _reread_lines
-
-const VERIFICATION_RE = /\b(fail(ing|ed|ure)?|error|exit[= ][1-9]|red\b|broken)\b/i;
-
-interface HistoryEntry {
-    t?: string;
-    ts?: string;
-    s?: string;
-    text?: string;
-    tool?: string;
-    [k: string]: unknown;
-}
-
-// ---------------------------------------------------------------------
-// shared helpers
-// ---------------------------------------------------------------------
-
-function _history_path(root: string): string {
-    return process.env.AGENT_CHAT_HISTORY_FILE || path.join(root, HISTORY_REL);
-}
-
-function _hot_context_path(root: string): string {
-    return process.env.AGENT_HOT_CONTEXT_FILE || path.join(root, HOT_CONTEXT_REL);
-}
-
-export function _current_branch(root: string): string {
-    try {
-        const proc = spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
-            cwd: root,
-            encoding: 'utf-8',
-            timeout: 5000,
-            env: hardenedSpawnEnv(),
-        });
-        if (proc.status === 0) {
-            return (proc.stdout || '').trim() || 'unknown';
-        }
-    } catch {
-        // fall through
-    }
-    return 'unknown';
-}
-
-function _read_history(root: string): HistoryEntry[] {
-    let text: string;
-    try {
-        text = fs.readFileSync(_history_path(root), 'utf-8');
-    } catch {
-        return [];
-    }
-    const entries: HistoryEntry[] = [];
-    for (const line of text.split('\n')) {
-        const trimmed = line.trim();
-        if (!trimmed) continue;
-        try {
-            const parsed = JSON.parse(trimmed) as unknown;
-            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-                entries.push(parsed as HistoryEntry);
-            }
-        } catch {
-            // skip malformed lines — fail-open
-        }
-    }
-    return entries;
-}
-
-/** Entries of the most recent session (by `s` tag of the last body entry). */
-export function _latest_session_entries(entries: HistoryEntry[]): HistoryEntry[] {
-    const body = entries.filter((e) => e.t && e.t !== 'header');
-    if (body.length === 0) return [];
-    const sid = body[body.length - 1]?.s;
-    if (!sid) {
-        // untagged history — fall back to the trailing 50 entries
-        return body.slice(-50);
-    }
-    return body.filter((e) => e.s === sid);
-}
-
-function _snippet(text: string, max: number): string {
-    const oneLine = text.replace(/\s+/g, ' ').trim();
-    return oneLine.length <= max ? oneLine : oneLine.slice(0, max - 1) + '…';
-}
-
-/** Privacy floor: keep only lines the low-impact redactor clears. */
-function _redact_lines(lines: string[]): { kept: string[]; dropped: number } {
-    const kept: string[] = [];
-    let dropped = 0;
-    for (const line of lines) {
-        try {
-            const result = redact_low_impact_entry(line);
-            if (result.ok) {
-                kept.push(line);
-            } else {
-                dropped += 1;
-            }
-        } catch {
-            dropped += 1; // fail-closed per line: on redactor error, drop
-        }
-    }
-    return { kept, dropped };
-}
-
-function _word_count(text: string): number {
-    return text.split(/\s+/).filter((w) => w.length > 0).length;
-}
-
-// ---------------------------------------------------------------------
-// re-read advisory (road-to-role-scoped-spawn-profiles Phase 3 Steps 4-5)
-// ---------------------------------------------------------------------
-
-/**
- * Files this leg read more than once, as advisory lines for the cache.
- *
- * Phase 3 Step 4 of `road-to-role-scoped-spawn-profiles` requires the
- * suppression to ride THIS surface rather than arrive as a second artefact,
- * and Step 5 requires it to stay advice: there is no refuse branch anywhere
- * below, and there is no code path that returns a deny on a re-read condition.
- * The output is three lines in a markdown cache; the next leg may ignore it.
- *
- * **Why the path is relativised, and why an outside path is dropped rather
- * than shortened.** The privacy floor
- * ({@link _redact_lines} → `redact_low_impact_entry`) drops any line carrying
- * a project-rooted absolute path, so emitting `/Users/...` would produce a
- * silently empty section — the feature would look implemented and do nothing.
- * Relativising to the workspace root keeps the line inside the floor. A path
- * OUTSIDE the root cannot be relativised without `../` escapes that re-reveal
- * the layout, and it is another project's business in any case, so it is
- * dropped entirely.
- *
- * Fail-silent: no transcript path, an unreadable one, or a malformed leg all
- * yield `[]`. This is a cache, and a cache that throws is worse than a cache
- * that is short.
- */
-export function _reread_lines(transcriptPath: string | null, root: string): string[] {
-    if (!transcriptPath) return [];
-    const result = computeRereads([transcriptPath]);
-    const lines: string[] = [];
-    for (const f of result.files) {
-        if (lines.length >= MAX_REREAD_LINES) break;
-        const rel = path.relative(root, f.file_path);
-        if (rel === '' || rel.startsWith('..') || path.isAbsolute(rel)) continue;
-        lines.push(`${rel} — read ${f.total_reads}x this leg (${f.duplicate_reads} re-read)`);
-    }
-    return lines;
-}
-
-// ---------------------------------------------------------------------
-// stop — deterministic write
-// ---------------------------------------------------------------------
-
-export function build_hot_context(
-    root: string,
-    now: Date = new Date(),
-    transcriptPath: string | null = null,
-): string {
-    const session = _latest_session_entries(_read_history(root));
-
-    const userPrompts = session.filter((e) => e.t === 'user_prompt' && e.text);
-    const toolUses = session.filter((e) => e.t === 'post_tool_use' && (e.tool || e.text));
-    const stops = session.filter((e) => e.t === 'stop' && e.text);
-
-    const activeThreads = _redact_lines(
-        userPrompts.slice(-MAX_ACTIVE_THREADS).map((e) => _snippet(String(e.text), THREAD_SNIPPET_CHARS)),
-    );
-    const recentChanges = _redact_lines(
-        toolUses
-            .slice(-MAX_RECENT_CHANGES)
-            .map((e) => _snippet(`${e.tool ? `${e.tool}: ` : ''}${String(e.text ?? '')}`, CHANGE_SNIPPET_CHARS)),
-    );
-    const openVerifications = _redact_lines(
-        toolUses
-            .filter((e) => VERIFICATION_RE.test(String(e.text ?? '')))
-            .slice(-MAX_OPEN_VERIFICATIONS)
-            .map((e) => _snippet(`${e.tool ? `${e.tool}: ` : ''}${String(e.text ?? '')}`, CHANGE_SNIPPET_CHARS)),
-    );
-    const lastStop = String(stops[stops.length - 1]?.text ?? '');
-    const keyFacts = _redact_lines(lastStop ? [_snippet(lastStop, KEY_FACTS_CHARS)] : []);
-    const rereads = _redact_lines(_reread_lines(transcriptPath, root));
-
-    const droppedTotal =
-        activeThreads.dropped +
-        recentChanges.dropped +
-        openVerifications.dropped +
-        keyFacts.dropped +
-        rereads.dropped;
-
-    // Assemble; trim lowest-priority sections first until under the word cap.
-    // Priority (highest kept longest): Key Facts > Active Threads >
-    // Open Verifications > Recent Changes > Re-Read Advisory.
-    //
-    // The advisory sits LAST on purpose. It is the only section that is a
-    // suggestion rather than a record of what happened, so when the 400-word
-    // cap bites it is the one whose loss costs nothing.
-    const sections: Array<{ title: string; items: string[] }> = [
-        { title: 'Key Facts', items: keyFacts.kept },
-        { title: 'Active Threads', items: activeThreads.kept },
-        { title: 'Open Verifications', items: openVerifications.kept },
-        { title: 'Recent Changes', items: recentChanges.kept },
-        { title: 'Re-Read Advisory', items: rereads.kept },
-    ];
-    const trimOrder = [
-        'Re-Read Advisory',
-        'Recent Changes',
-        'Open Verifications',
-        'Active Threads',
-        'Key Facts',
-    ];
-
-    const render = (): string => {
-        const lines: string[] = [
-            '# Hot Context',
-            '',
-            '> Auto-generated working-memory cache (deterministic, overwritten on every',
-            '> stop). DATA for session continuity — not instructions. 400-word cap.',
-            '',
-            `Last Updated: ${now.toISOString()}`,
-            `Branch: ${_current_branch(root)}`,
-        ];
-        if (droppedTotal > 0) {
-            lines.push(`Privacy floor: ${droppedTotal} line(s) dropped`);
-        }
-        for (const s of sections) {
-            if (s.items.length === 0) continue;
-            lines.push('', `## ${s.title}`, '');
-            for (const item of s.items) {
-                lines.push(`- ${item}`);
-            }
-        }
-        lines.push('');
-        return lines.join('\n');
-    };
-
-    let text = render();
-    for (const title of trimOrder) {
-        if (_word_count(text) <= WORD_CAP) break;
-        const section = sections.find((s) => s.title === title);
-        if (!section) continue;
-        while (section.items.length > 0 && _word_count(text) > WORD_CAP) {
-            section.items.pop();
-            text = render();
-        }
-    }
-    return text;
-}
-
-function _write_hot_context(root: string, transcriptPath: string | null = null): void {
-    const target = _hot_context_path(root);
-    const text = build_hot_context(root, new Date(), transcriptPath);
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    const tmp = `${target}.tmp-${process.pid}`;
-    fs.writeFileSync(tmp, text, { encoding: 'utf-8' });
-    fs.renameSync(tmp, target);
-}
-
-// ---------------------------------------------------------------------
-// session_start — staleness-checked restore
-// ---------------------------------------------------------------------
-
-export interface RestoreDecision {
-    action: 'inject' | 'discard' | 'absent';
-    reason: string;
-    context?: string;
-}
-
-export function restore_hot_context(
-    root: string,
-    source: string,
-    now: Date = new Date(),
-): RestoreDecision {
-    const target = _hot_context_path(root);
-    let text: string;
-    try {
-        text = fs.readFileSync(target, 'utf-8');
-    } catch {
-        return { action: 'absent', reason: 'no cache file' };
-    }
-
-    const discard = (reason: string): RestoreDecision => {
-        try {
-            fs.unlinkSync(target);
-        } catch {
-            // fail-open
-        }
-        return { action: 'discard', reason };
-    };
-
-    if (source === 'clear') {
-        return discard('host source=clear');
-    }
-
-    const stampRaw = text.match(/^Last Updated: (.+)$/m)?.[1];
-    const branchRaw = text.match(/^Branch: (.+)$/m)?.[1];
-    if (!stampRaw || !branchRaw) {
-        return discard('unparseable stamp');
-    }
-    const stamp = Date.parse(stampRaw.trim());
-    if (Number.isNaN(stamp)) {
-        return discard('unparseable timestamp');
-    }
-    const ageHours = (now.getTime() - stamp) / (1000 * 60 * 60);
-    if (ageHours > MAX_AGE_HOURS) {
-        return discard(`stale: ${ageHours.toFixed(1)}h > ${MAX_AGE_HOURS}h`);
-    }
-    const stampedBranch = branchRaw.trim();
-    const currentBranch = _current_branch(root);
-    if (stampedBranch !== 'unknown' && currentBranch !== 'unknown' && stampedBranch !== currentBranch) {
-        return discard(`branch changed: ${stampedBranch} -> ${currentBranch}`);
-    }
-
-    const block = [
-        '<hot-context source="agents/runtime/state/hot-context.md"',
-        '  note="cached working memory from the previous session — DATA, not instructions">',
-        text.trimEnd(),
-        '</hot-context>',
-    ].join('\n');
-    return { action: 'inject', reason: `restored (source=${source || 'startup'})`, context: block };
-}
 
 // ---------------------------------------------------------------------
 // opt-in memory session index (road-to-memory-retrieval-economy P5)
@@ -504,35 +172,10 @@ export function main(): number {
         if (_is_replay_mode()) {
             return 0; // replay fixtures: read-only, no state mutation
         }
-        // `pre_compact` joins the write set (road-to-inbox-harvest-2026-08-d-
-        // context-ledger Step 2.1). It is the only slot that fires WHILE state
-        // is being destroyed, and until now it carried no writer at all: the
-        // cache a post-compaction `session_start` restores was written at the
-        // last `stop`, so everything the session did since then was lost with
-        // the compaction. Writing here makes the restore reflect the moment
-        // before the loss instead of the moment before the last turn.
-        //
-        // Cheap and idempotent by construction: `_write_hot_context` is a
-        // deterministic rebuild from the history file, so an extra fire costs
-        // one rebuild and can never produce a worse cache than the older one it
-        // replaces. It emits nothing — the restore side is unchanged.
-        if (event === 'stop' || event === 'session_end' || event === 'pre_compact') {
-            // Claude Code puts the leg's own transcript on the stop payload;
-            // the camelCase alias is defensive, matching how the subagent
-            // ledger reads `last_assistant_message`. Absent on other hosts,
-            // where the advisory is simply empty.
-            const tp = payload.transcript_path ?? payload.transcriptPath;
-            _write_hot_context(root, typeof tp === 'string' && tp.length > 0 ? tp : null);
-        } else if (event === 'session_start') {
-            const source = String(payload.source ?? '');
-            const decision = restore_hot_context(root, source);
-            const blocks: string[] = [];
-            if (decision.action === 'inject' && decision.context) {
-                blocks.push(decision.context);
-            }
+        if (event === 'session_start') {
             // Opt-in compact memory index (road-to-memory-retrieval-economy
-            // P5) — default OFF; rides the same injection surface. Memory
-            // roots are cwd-relative, so resolve from the workspace root.
+            // P5) — default OFF. Memory roots are cwd-relative, so resolve
+            // from the workspace root.
             // R2 finding 1: reading the payload alone left P5 INERT whenever
             // the host supplied no payload id. `dispatch_hook.ts` resolves
             // `envelope.session_id` from the payload OR `AGENT_SESSION_ID`, and
@@ -543,14 +186,11 @@ export function main(): number {
             );
             const indexBlock = _session_index_block_or_null(root, sessionId);
             if (indexBlock !== null) {
-                blocks.push(indexBlock);
-            }
-            if (blocks.length > 0) {
                 process.stdout.write(
                     JSON.stringify({
                         decision: 'allow',
-                        reason: decision.action === 'inject' ? decision.reason : 'memory session index',
-                        context: blocks.join('\n\n'),
+                        reason: 'memory session index',
+                        context: indexBlock,
                     }) + '\n',
                 );
             }

package/src/scripts/lint_evidence_artifacts.ts

@@ -63,6 +63,7 @@ export const EVIDENCE_TYPES = [
     'honest-null',
     'analysis',
     'feel',
+    'ratification',
 ] as const;
 
 /**

package/src/scripts/lint_knowledge_scale.ts

@@ -18,9 +18,6 @@
  *                          trigram, no engine fork / no FTS5; ADR-061 honoured)
  *   - corpus scale     — > 500 files across all types
  *                        → same lexical-index activation path
- *   - hot-context size — `agents/runtime/state/hot-context.md` > 600 tokens
- *                        (estimated at 4 chars/token) → trim schema / fix the
- *                        deterministic writer
  *
  * Usage: lint_knowledge_scale.ts [--dir <repo-root>] [--format text|json] [--quiet]
  * Exit codes: 0 = ran cleanly (warnings never fail the build), 1 = usage
@@ -39,8 +36,6 @@ export const INTAKE_EVENTS_MAX = 2000;
 export const SESSIONS_PAGES_MAX = 50;
 export const TYPE_FILES_MAX = 200;
 export const CORPUS_FILES_MAX = 500;
-export const HOT_CONTEXT_TOKENS_MAX = 600;
-export const CHARS_PER_TOKEN = 4;
 
 const KNOWLEDGE_TYPED_DIRS = ['sessions', 'concepts', 'procedures', 'decisions'] as const;
 
@@ -206,27 +201,6 @@ export function runChecks(root: string, stats?: ScanStats): Warning[] {
         });
     }
 
-    // 5. Hot-context budget.
-    const hotContext = path.join(root, 'agents', 'runtime', 'state', 'hot-context.md');
-    let hotText = '';
-    try {
-        hotText = fs.readFileSync(hotContext, 'utf-8');
-    } catch {
-        // absent — fine (feature not active or fresh session)
-    }
-    if (hotText) {
-        const tokens = Math.ceil(hotText.length / CHARS_PER_TOKEN);
-        if (tokens > HOT_CONTEXT_TOKENS_MAX) {
-            warnings.push({
-                rule: 'hot-context-budget',
-                metric: `${tokens}/${HOT_CONTEXT_TOKENS_MAX}`,
-                message:
-                    `hot-context.md parses to ~${tokens} tokens (> ${HOT_CONTEXT_TOKENS_MAX}). ` +
-                    'Activation path (pre-decided): trim the schema sections or fix the deterministic writer cap.',
-            });
-        }
-    }
-
     return warnings;
 }
 

package/src/scripts/memory_lookup.ts

@@ -3,12 +3,11 @@
  * File-first memory retrieval.
  *
  * Ported from the retired Python `src/scripts/memory_lookup.py` (ADR-200). The public
- * API and CLI contract mirror the retired Python implementation EXACTLY — same exported
- * names (snake_case kept deliberately, especially `retrieve(...)` whose
- * signature/return shape is cited by rules), same exit codes, stdout/stderr
- * split, byte-identical messages, same memory-file scan + ranking + JSON
- * output. No behaviour changes — latent Python bugs are replicated and
- * flagged as divergence candidates.
+ * API and CLI contract mirror it EXACTLY — same exported names (snake_case kept
+ * deliberately, especially `retrieve(...)`, whose signature and return shape are cited
+ * by rules), same exit codes, stdout/stderr split, byte-identical messages, same
+ * memory-file scan, ranking and JSON output. No behaviour changes; latent Python bugs
+ * are replicated and flagged as divergence candidates.
  *
  * Implements the shared `retrieve(types, keys, limit)` abstraction used
  * by skills. Reads YAML under `agents/memory/<type>/` (curated, hand-
@@ -16,9 +15,8 @@
  * append-only, supersede-chain aware), plus user-ingested `knowledge`
  * chunks and opted-in `cross-repo` matches.
  *
- * Retrieval is entirely repo-side and file-backed — there is no external
- * backend. (The former optional `@event4u/agent-memory` package routing
- * was removed; see `docs/decisions/` for the agent-memory removal ADR.)
+ * Retrieval is entirely repo-side and file-backed — no external backend. (The former
+ * optional `@event4u/agent-memory` routing was removed; see `docs/decisions/`.)
  *
  * Usage:
  *     memory_lookup --types domain-invariants,ownership --key "app/Http/Controllers/Foo" --limit 5
@@ -26,6 +24,8 @@
  *
  *     import { retrieve } from './memory_lookup.js';
  *     const hits = retrieve(['ownership'], ['app/Http'], 3);
+ * loss_class: recoverable-lossy
+ * loss_recovery: the envelope's `truncation.omitted` plus its next-path hint under `agents/memory/`.
  */
 
 import * as fs from 'node:fs';

package/src/scripts/report_standing_payload_by_host.ts

@@ -101,19 +101,19 @@ export interface HostSurface {
 export const HOST_SURFACES: readonly HostSurface[] = [
     {
         host: 'augment', surface: '.augment/rules', perRuleTree: true,
-        writer: 'src/scripts/condense.ts:2499',
+        writer: 'src/scripts/condense.ts:2495',
         anchor: '\'.augment/rules\',',
         note: 'copies by default; symlinks under `augment.rules_use_symlinks`',
     },
     {
         host: 'claude-code', surface: '.claude/rules', perRuleTree: true,
-        writer: 'src/scripts/condense.ts:1192',
+        writer: 'src/scripts/condense.ts:1188',
         anchor: '_emit_claude_rule(',
         note: '`_emit_claude_rule` rewrites frontmatter to the host\'s own `paths:` key',
     },
     {
         host: 'cline', surface: '.clinerules', perRuleTree: true,
-        writer: 'src/scripts/condense.ts:1194',
+        writer: 'src/scripts/condense.ts:1190',
         anchor: 'fs.symlinkSync(',
         note: 'symlink per rule into the projection',
     },
@@ -131,19 +131,19 @@ export const HOST_SURFACES: readonly HostSurface[] = [
     },
     {
         host: 'cursor', surface: '.cursor/rules', perRuleTree: true,
-        writer: 'src/scripts/condense.ts:1194',
+        writer: 'src/scripts/condense.ts:1190',
         anchor: 'fs.symlinkSync(',
-        note: 'symlink per rule, plus `.mdc` companions at `condense.ts:1422`',
+        note: 'symlink per rule, plus `.mdc` companions at `condense.ts:1418`',
     },
     {
         host: 'gemini', surface: 'GEMINI.md', perRuleTree: false,
-        writer: 'src/scripts/condense.ts:1498',
+        writer: 'src/scripts/condense.ts:1494',
         anchor: '\'GEMINI.md\'',
         note: 'single file',
     },
     {
         host: 'windsurf', surface: '.windsurfrules', perRuleTree: false,
-        writer: 'src/scripts/condense.ts:1242',
+        writer: 'src/scripts/condense.ts:1238',
         anchor: '\'.windsurfrules\'',
         note: 'single concatenated file',
     },

package/src/scripts/session_memory_index.ts

@@ -20,6 +20,11 @@
  * deterministic (real tokenizer, reported by `session_index_cost()`); the
  * hit-rate arm needs a live paired run and has NOT been executed — so the
  * default is off, per the roadmap's "off unless proven".
+ *
+ * loss_class: recoverable-lossy
+ * loss_recovery: agents/memory/ — this module renders the block and applies
+ * `capRows`, so it carries the same class as the cap it applies. Each dropped
+ * row names a curated entry that remains on disk and is fetchable by id.
  */
 
 import { CURATED_TYPES, MEMORY_ROOT, retrieve_v1 } from './memory_lookup.js';