opensquid 0.5.395

package/dist/runtime/wedge/automation_buffer.js

@@ -0,0 +1,202 @@
+/**
+ * Automation buffer pattern — file-driven, session-scoped, append-only sink
+ * for lesson candidates captured during full-automation runs.
+ *
+ * Authoritative source: `docs/opensquid-real-design.md` §"Automation buffer
+ * pattern" + §"Directory layout" + §"Four buffer categories" +
+ * `project_opensquid_automation_buffer_pattern` (memory).
+ *
+ * The buffer resolves the conflict between full-automation throughput and
+ * the wedge gate's capture-time validation requirement: during automation,
+ * the agent dumps candidate lessons into one of four category subdirs and
+ * appends a one-line index entry to `BUFFER.md`. At end-of-automation, the
+ * user walks the buffer through the cycle (triage → validate → persist →
+ * proceed) — nothing auto-promotes silently.
+ *
+ * Layout produced:
+ *
+ *   ~/.opensquid/sessions/<id>/pending-lessons/
+ *     potential-lessons/   <ts>_<id>.md
+ *     keep-as-context/     <ts>_<id>.md
+ *     preferences/         <ts>_<id>.md
+ *     new-rag-pointers/    <ts>_<id>.md
+ *     BUFFER.md            ← chronological index, one bullet per write
+ *
+ * Atomic write: tmp + rename pattern. If the process crashes mid-write, the
+ * `.tmp` file remains on disk (no partial reads), and the canonical filename
+ * never appeared — so `walkBuffer` skips the half-written entry. BUFFER.md
+ * is intentionally non-atomic (append-only) — its job is human-readable
+ * progress, not source-of-truth. Source of truth is the per-entry file.
+ *
+ * Frontmatter parser: minimal regex-based, single-line string fields only.
+ * No nesting, no dates, no anchors — `gray-matter` would be overkill (per
+ * risk callout 1). The shape is locked at write-time, so the parser only
+ * needs to handle what we ourselves emit. The `sourceContext` multiline
+ * value uses YAML's `|-` block scalar (literal, strip-final-newline) with
+ * two-space indentation — the parser strips the leading indent on read.
+ *
+ * Imports from: node:fs/promises, node:path, ./capture, ./types.
+ * Imported by: src/runtime/wedge/index.ts, end-of-automation cycle UI.
+ */
+import { appendFile, mkdir, readFile, readdir, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { pendingLessonsDir, safeTimestamp } from './capture.js';
+const CATEGORY_ORDER = [
+    'potential-lessons',
+    'keep-as-context',
+    'preferences',
+    'new-rag-pointers',
+];
+// ---------------------------------------------------------------------------
+// bufferDir — public so tests + callers can resolve sibling paths
+// (e.g. BUFFER.md) without duplicating the layout.
+// ---------------------------------------------------------------------------
+export function bufferDir(sessionId) {
+    return pendingLessonsDir(sessionId);
+}
+// ---------------------------------------------------------------------------
+// appendBufferEntry — write an entry atomically + update BUFFER.md index.
+//
+// Failure semantics: if `rename` fails (target locked, fs full, etc.), the
+// `.tmp` file is left on disk for inspection. The BUFFER.md append is skipped
+// in that path — the index never references a non-existent file.
+// ---------------------------------------------------------------------------
+export async function appendBufferEntry(sessionId, entry) {
+    const dir = join(bufferDir(sessionId), entry.category);
+    await mkdir(dir, { recursive: true });
+    const safeTs = safeTimestamp(entry.frontmatter.timestamp);
+    const filename = `${safeTs}_${entry.id}.md`;
+    const path = join(dir, filename);
+    const tmp = `${path}.tmp`;
+    // Format frontmatter. `sourceContext` may contain newlines — emit as YAML
+    // block scalar with `|-` (literal, strip trailing newline) and 2-space
+    // indent. Empty strings emit as `''`.
+    const ctxLines = entry.frontmatter.sourceContext.split('\n');
+    const ctxBlock = entry.frontmatter.sourceContext.length === 0
+        ? "''"
+        : '|-\n' + ctxLines.map((l) => '  ' + l).join('\n');
+    const fm = [
+        '---',
+        `id: ${entry.id}`,
+        `timestamp: ${entry.frontmatter.timestamp}`,
+        `proposedCategory: ${entry.frontmatter.proposedCategory}`,
+        `confidence: ${entry.frontmatter.confidence}`,
+        `sourceContext: ${ctxBlock}`,
+        '---',
+        '',
+        entry.body,
+        '',
+    ].join('\n');
+    // Atomic: write tmp, then rename. Rename is atomic on POSIX + NTFS.
+    await writeFile(tmp, fm, 'utf8');
+    await rename(tmp, path);
+    // BUFFER.md index — chronological, one entry per write. Non-atomic by
+    // design (it's human-readable progress, not source-of-truth).
+    const indexLine = `- [${entry.category}/${entry.id}](${entry.category}/${filename})\n`;
+    await appendFile(join(bufferDir(sessionId), 'BUFFER.md'), indexLine, 'utf8');
+    return path;
+}
+// ---------------------------------------------------------------------------
+// walkBuffer — async iterator over all entries in category order.
+//
+// Within a category, entries are sorted lexicographically by filename — which,
+// thanks to `safeTimestamp` writing ISO timestamps first, equals chronological
+// order. ENOENT on a category subdir means "no entries in this category" —
+// the walk simply skips it (an empty buffer yields nothing, not throws).
+//
+// `.tmp` files are skipped — they represent in-flight or crashed writes that
+// never completed their rename. Only canonical filenames yield.
+// ---------------------------------------------------------------------------
+export async function* walkBuffer(sessionId) {
+    for (const cat of CATEGORY_ORDER) {
+        const dir = join(bufferDir(sessionId), cat);
+        let entries = [];
+        try {
+            entries = await readdir(dir);
+        }
+        catch (e) {
+            if (e.code === 'ENOENT')
+                continue;
+            throw e;
+        }
+        for (const f of entries.filter((x) => !x.endsWith('.tmp')).sort()) {
+            const raw = await readFile(join(dir, f), 'utf8');
+            yield parseEntry(raw, cat);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// parseEntry — minimal frontmatter parser.
+//
+// Recognizes:
+//   - simple `key: value` pairs
+//   - `key: |-` block scalar followed by 2-space-indented lines
+//   - `key: ''` empty-string sentinel
+//
+// Does NOT recognize:
+//   - nested keys
+//   - dates / typed values (everything is string, caller coerces)
+//   - YAML anchors / tags / multi-doc
+//
+// The frontmatter writer above is the only producer, so the parser only
+// needs to cover what we ourselves emit.
+// ---------------------------------------------------------------------------
+function parseEntry(raw, category) {
+    const m = /^---\n([\s\S]*?)\n---\n\n?([\s\S]*)$/.exec(raw);
+    const fmText = m?.[1] ?? '';
+    const body = (m?.[2] ?? '').replace(/\n+$/, '');
+    const fmLines = fmText.split('\n');
+    const fm = {};
+    for (let i = 0; i < fmLines.length; i++) {
+        const line = fmLines[i] ?? '';
+        const kv = /^(\w+):\s*(.*)$/.exec(line);
+        if (!kv)
+            continue;
+        const key = kv[1] ?? '';
+        const rawVal = (kv[2] ?? '').trim();
+        if (rawVal === "''") {
+            fm[key] = '';
+            continue;
+        }
+        if (rawVal === '|-') {
+            // Consume subsequent indented lines.
+            const blockLines = [];
+            let j = i + 1;
+            while (j < fmLines.length) {
+                const next = fmLines[j] ?? '';
+                if (/^ {2}/.test(next)) {
+                    blockLines.push(next.replace(/^ {2}/, ''));
+                    j++;
+                }
+                else if (next === '') {
+                    // Empty line inside block — preserve.
+                    blockLines.push('');
+                    j++;
+                }
+                else {
+                    break;
+                }
+            }
+            // Trim trailing empty lines to honor `|-` strip semantics.
+            while (blockLines.length > 0 && blockLines[blockLines.length - 1] === '') {
+                blockLines.pop();
+            }
+            fm[key] = blockLines.join('\n');
+            i = j - 1;
+            continue;
+        }
+        fm[key] = rawVal;
+    }
+    return {
+        id: fm.id ?? 'unknown',
+        category,
+        body,
+        frontmatter: {
+            timestamp: fm.timestamp ?? '',
+            proposedCategory: fm.proposedCategory ?? category,
+            sourceContext: fm.sourceContext ?? '',
+            confidence: Number(fm.confidence ?? 0),
+        },
+    };
+}
+//# sourceMappingURL=automation_buffer.js.map

package/dist/runtime/wedge/automation_buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation_buffer.js","sourceRoot":"","sources":["../../../src/runtime/wedge/automation_buffer.ts"],"names":[],"mappings":"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"}

package/dist/runtime/wedge/capture.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Stage 1 capture gate — writes pending lessons to the session-scoped buffer
+ * on disk for later user validation (per the context-clearing cycle).
+ *
+ * Authoritative source: `docs/opensquid-real-design.md` §"Two-stage wedge gate"
+ * Stage 1 + §"Automation buffer pattern" §"Directory layout" + §"Context-
+ * clearing cycle".
+ *
+ * Layout produced:
+ *
+ *   ~/.opensquid/sessions/<session-id>/pending-lessons/potential-lessons/
+ *     <ts>_<type>_<id>.md
+ *
+ * Filename ordering: `<ISO-timestamp-with-colons-replaced>_<type>_<id>.md`.
+ * Colons in ISO timestamps break Windows paths, so they collapse to `-`
+ * (per spec risk callout 1). The deterministic ordering lets `walkBuffer`
+ * (Task 7.2) iterate by chronological proposal order without sorting on
+ * parsed frontmatter.
+ *
+ * Frontmatter is a strict subset of YAML — no nested keys, no multiline
+ * values. The `sourceContext` and `content` fields are written into the
+ * Markdown body (under headings) NOT the frontmatter — that sidesteps the
+ * "body contains `---`" risk callout (a stray `---` in the lesson text
+ * cannot break a frontmatter parser that doesn't try to match the body).
+ *
+ * Validation interface: this module exposes `validatePendingLesson(lesson)`
+ * — callers MUST run it before calling `capturePendingLesson`. The function
+ * surface is intentionally split (rather than auto-validating in capture) so
+ * the caller can choose what to do with invalid input (drop silently, route
+ * to the user, raise) without the file-writer making policy decisions.
+ *
+ * Imports from: node:fs/promises, node:path, ../paths, ./types.
+ * Imported by: src/runtime/wedge/index.ts.
+ */
+import type { PendingLesson } from './types.js';
+export declare function pendingLessonsDir(sessionId: string): string;
+export declare function validatePendingLesson(lesson: PendingLesson): string | null;
+export declare function safeTimestamp(iso: string): string;
+export declare function capturePendingLesson(sessionId: string, lesson: PendingLesson): Promise<string>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/runtime/wedge/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/runtime/wedge/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAOH,OAAO,KAAK,EAAc,aAAa,EAAE,MAAM,YAAY,CAAC;AAS5D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAsBD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAgB1E;AAQD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAWD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/runtime/wedge/capture.js

@@ -0,0 +1,127 @@
+/**
+ * Stage 1 capture gate — writes pending lessons to the session-scoped buffer
+ * on disk for later user validation (per the context-clearing cycle).
+ *
+ * Authoritative source: `docs/opensquid-real-design.md` §"Two-stage wedge gate"
+ * Stage 1 + §"Automation buffer pattern" §"Directory layout" + §"Context-
+ * clearing cycle".
+ *
+ * Layout produced:
+ *
+ *   ~/.opensquid/sessions/<session-id>/pending-lessons/potential-lessons/
+ *     <ts>_<type>_<id>.md
+ *
+ * Filename ordering: `<ISO-timestamp-with-colons-replaced>_<type>_<id>.md`.
+ * Colons in ISO timestamps break Windows paths, so they collapse to `-`
+ * (per spec risk callout 1). The deterministic ordering lets `walkBuffer`
+ * (Task 7.2) iterate by chronological proposal order without sorting on
+ * parsed frontmatter.
+ *
+ * Frontmatter is a strict subset of YAML — no nested keys, no multiline
+ * values. The `sourceContext` and `content` fields are written into the
+ * Markdown body (under headings) NOT the frontmatter — that sidesteps the
+ * "body contains `---`" risk callout (a stray `---` in the lesson text
+ * cannot break a frontmatter parser that doesn't try to match the body).
+ *
+ * Validation interface: this module exposes `validatePendingLesson(lesson)`
+ * — callers MUST run it before calling `capturePendingLesson`. The function
+ * surface is intentionally split (rather than auto-validating in capture) so
+ * the caller can choose what to do with invalid input (drop silently, route
+ * to the user, raise) without the file-writer making policy decisions.
+ *
+ * Imports from: node:fs/promises, node:path, ../paths, ./types.
+ * Imported by: src/runtime/wedge/index.ts.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { OPENSQUID_HOME } from '../paths.js';
+// ---------------------------------------------------------------------------
+// pendingLessonsDir — single source of truth for the directory layout.
+//
+// Exported so Task 7.2's `automation_buffer.ts` can join siblings (e.g.
+// `keep-as-context/`) onto the same parent without duplicating the prefix.
+// ---------------------------------------------------------------------------
+export function pendingLessonsDir(sessionId) {
+    return join(OPENSQUID_HOME(), 'sessions', sessionId, 'pending-lessons');
+}
+// ---------------------------------------------------------------------------
+// validatePendingLesson — pure predicate, returns null on OK, error message
+// otherwise. Caller decides what to do with the message.
+//
+// Rules:
+//   - `id` non-empty (filename component).
+//   - `type` is one of the three known values (TS already narrows, but
+//     runtime input may be loose).
+//   - `confidence` in [0, 1] (callers that store outside this range will
+//     produce non-comparable buffers).
+//   - `proposedAt` is a parseable ISO 8601 timestamp.
+// ---------------------------------------------------------------------------
+const LESSON_TYPES = new Set([
+    'workflow',
+    'preference',
+    'skill_upgrade',
+    'schedule_outcome',
+]);
+export function validatePendingLesson(lesson) {
+    if (!lesson.id || lesson.id.length === 0)
+        return 'lesson.id must be non-empty';
+    if (!LESSON_TYPES.has(lesson.type))
+        return `lesson.type unknown: ${String(lesson.type)}`;
+    if (typeof lesson.confidence !== 'number' ||
+        !Number.isFinite(lesson.confidence) ||
+        lesson.confidence < 0 ||
+        lesson.confidence > 1) {
+        return 'lesson.confidence must be a finite number in [0, 1]';
+    }
+    // Date.parse is intentionally lax; we accept anything node can read back.
+    if (Number.isNaN(Date.parse(lesson.proposedAt))) {
+        return `lesson.proposedAt is not parseable as a date: ${lesson.proposedAt}`;
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// safeTimestamp — ISO timestamp with `:` → `-` (Windows-safe filename
+// component). Public so Task 7.2 can reuse the same conversion for buffer
+// filenames + BUFFER.md index entries.
+// ---------------------------------------------------------------------------
+export function safeTimestamp(iso) {
+    return iso.replaceAll(':', '-');
+}
+// ---------------------------------------------------------------------------
+// capturePendingLesson — writes the lesson to potential-lessons/.
+//
+// Throws on validation failure (callers that want silent-drop behavior
+// should run `validatePendingLesson` first and skip). The throw is what
+// satisfies the "no silent acceptance" acceptance criterion: a malformed
+// lesson hitting this function fails loudly, not silently.
+// ---------------------------------------------------------------------------
+export async function capturePendingLesson(sessionId, lesson) {
+    const err = validatePendingLesson(lesson);
+    if (err)
+        throw new Error(`invalid PendingLesson: ${err}`);
+    const dir = join(pendingLessonsDir(sessionId), 'potential-lessons');
+    await mkdir(dir, { recursive: true });
+    const path = join(dir, `${safeTimestamp(lesson.proposedAt)}_${lesson.type}_${lesson.id}.md`);
+    const author = lesson.author ?? 'agent';
+    const fileBody = [
+        '---',
+        `id: ${lesson.id}`,
+        `type: ${lesson.type}`,
+        `confidence: ${lesson.confidence}`,
+        `proposedAt: ${lesson.proposedAt}`,
+        `author: ${author}`,
+        '---',
+        '',
+        '## Source context',
+        '',
+        lesson.sourceContext,
+        '',
+        '## Lesson',
+        '',
+        lesson.content,
+        '',
+    ].join('\n');
+    await writeFile(path, fileBody, 'utf8');
+    return path;
+}
+//# sourceMappingURL=capture.js.map

package/dist/runtime/wedge/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/runtime/wedge/capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7C,8EAA8E;AAC9E,uEAAuE;AACvE,EAAE;AACF,wEAAwE;AACxE,2EAA2E;AAC3E,8EAA8E;AAE9E,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAC1E,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,yDAAyD;AACzD,EAAE;AACF,SAAS;AACT,2CAA2C;AAC3C,uEAAuE;AACvE,mCAAmC;AACnC,yEAAyE;AACzE,uCAAuC;AACvC,sDAAsD;AACtD,8EAA8E;AAE9E,MAAM,YAAY,GAA4B,IAAI,GAAG,CAAa;IAChE,UAAU;IACV,YAAY;IACZ,eAAe;IACf,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,6BAA6B,CAAC;IAC/E,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,wBAAwB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACzF,IACE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QACrC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,CAAC;QACrB,MAAM,CAAC,UAAU,GAAG,CAAC,EACrB,CAAC;QACD,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IACD,0EAA0E;IAC1E,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QAChD,OAAO,iDAAiD,MAAM,CAAC,UAAU,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,sEAAsE;AACtE,0EAA0E;AAC1E,uCAAuC;AACvC,8EAA8E;AAE9E,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,kEAAkE;AAClE,EAAE;AACF,uEAAuE;AACvE,wEAAwE;AACxE,yEAAyE;AACzE,2DAA2D;AAC3D,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,MAAqB;IAErB,MAAM,GAAG,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,CAAC,CAAC;IAE1D,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACpE,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IAE7F,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC;IACxC,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,OAAO,MAAM,CAAC,EAAE,EAAE;QAClB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,eAAe,MAAM,CAAC,UAAU,EAAE;QAClC,eAAe,MAAM,CAAC,UAAU,EAAE;QAClC,WAAW,MAAM,EAAE;QACnB,KAAK;QACL,EAAE;QACF,mBAAmB;QACnB,EAAE;QACF,MAAM,CAAC,aAAa;QACpB,EAAE;QACF,WAAW;QACX,EAAE;QACF,MAAM,CAAC,OAAO;QACd,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/wedge/compress_candidates.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CMP.3 — compression-candidate collector (wedge extension, Seam 1).
+ *
+ * Authoritative spec: `docs/tasks/T-compression.md` CMP.3 + pre-research
+ * §3 Seam 1 (`docs/research/T-compression-pre-research-2026-05-27.md`).
+ *
+ * The locked design: compression IS lesson-formation, so it rides the
+ * SAME wedge cadence. After a lesson is PROMOTED (Stage 2), the memory
+ * ids cited in that lesson's causal narrative (the engine's
+ * `EvidenceRef::Memory` evidence refs, surfaced via `lesson.promote`'s
+ * `cited_memory_ids`) are nominated as compression candidates: those
+ * memories have now "earned a gist" by contributing to a graduated
+ * lesson. The orchestrator (CMP.4) later reads these windows — gated by
+ * the satisfaction probe (CMP.2) — and compresses them.
+ *
+ * OFF THE CRITICAL PATH: a candidate-collection failure must NEVER fail
+ * or delay a lesson promotion. The caller wraps `collectCandidates` in a
+ * best-effort try/catch; this module itself only ever appends to a
+ * buffer (it does not promote, delete, or call the engine).
+ *
+ * Dedup: ids within a single window are deduped; the orchestrator
+ * additionally dedups across windows in a group when it reads.
+ *
+ * Storage: `~/.opensquid/sessions/<sessionId>/compression-candidates.jsonl`
+ * (OPENSQUID_HOME-overridable so tests isolate to a mkdtemp). Same
+ * append-only automation-buffer pattern as the satisfaction probe.
+ *
+ * Imports from: node:fs/promises, node:path, ../paths.js.
+ * Imported by: src/functions/lessons.ts (emit after promote);
+ *   src/runtime/compression_orchestrator.ts (read path, CMP.4).
+ */
+/**
+ * One compression-candidate window: the memory ids cited by a promoted
+ * lesson, keyed by the feature group so the orchestrator can release
+ * them when that group's satisfaction probe comes back "satisfied".
+ */
+export interface CompressionCandidateWindow {
+    group: string;
+    ids: string[];
+    promotedLessonId: string;
+    collected_at: string;
+}
+/** Buffer path. OPENSQUID_HOME-aware so tests isolate to mkdtemp. */
+export declare function candidatesBufferPath(sessionId: string): string;
+/**
+ * Collect a promoted lesson's cited memory ids into a candidate window
+ * appended to the per-session buffer. NO-OP when the lesson cites no
+ * memories (no window emitted — nothing to compress). Ids are deduped
+ * within the window. Append-only; never blocks; never touches the
+ * engine.
+ */
+export declare function collectCandidates(sessionId: string, lesson: {
+    id: string;
+    citedMemoryIds: string[];
+    group: string;
+}, nowIso?: () => string): Promise<void>;
+/**
+ * Read the candidate windows for `group` — what the orchestrator
+ * (CMP.4) consumes. `[]` on absent/malformed buffer (fail-closed →
+ * nothing to compress).
+ */
+export declare function readCandidates(sessionId: string, group: string): Promise<CompressionCandidateWindow[]>;
+//# sourceMappingURL=compress_candidates.d.ts.map

package/dist/runtime/wedge/compress_candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress_candidates.d.ts","sourceRoot":"","sources":["../../../src/runtime/wedge/compress_candidates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAOH;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9D;AAwCD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC/D,MAAM,GAAE,MAAM,MAAuC,GACpD,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAGvC"}

package/dist/runtime/wedge/compress_candidates.js

@@ -0,0 +1,109 @@
+/**
+ * CMP.3 — compression-candidate collector (wedge extension, Seam 1).
+ *
+ * Authoritative spec: `docs/tasks/T-compression.md` CMP.3 + pre-research
+ * §3 Seam 1 (`docs/research/T-compression-pre-research-2026-05-27.md`).
+ *
+ * The locked design: compression IS lesson-formation, so it rides the
+ * SAME wedge cadence. After a lesson is PROMOTED (Stage 2), the memory
+ * ids cited in that lesson's causal narrative (the engine's
+ * `EvidenceRef::Memory` evidence refs, surfaced via `lesson.promote`'s
+ * `cited_memory_ids`) are nominated as compression candidates: those
+ * memories have now "earned a gist" by contributing to a graduated
+ * lesson. The orchestrator (CMP.4) later reads these windows — gated by
+ * the satisfaction probe (CMP.2) — and compresses them.
+ *
+ * OFF THE CRITICAL PATH: a candidate-collection failure must NEVER fail
+ * or delay a lesson promotion. The caller wraps `collectCandidates` in a
+ * best-effort try/catch; this module itself only ever appends to a
+ * buffer (it does not promote, delete, or call the engine).
+ *
+ * Dedup: ids within a single window are deduped; the orchestrator
+ * additionally dedups across windows in a group when it reads.
+ *
+ * Storage: `~/.opensquid/sessions/<sessionId>/compression-candidates.jsonl`
+ * (OPENSQUID_HOME-overridable so tests isolate to a mkdtemp). Same
+ * append-only automation-buffer pattern as the satisfaction probe.
+ *
+ * Imports from: node:fs/promises, node:path, ../paths.js.
+ * Imported by: src/functions/lessons.ts (emit after promote);
+ *   src/runtime/compression_orchestrator.ts (read path, CMP.4).
+ */
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { OPENSQUID_HOME } from '../paths.js';
+/** Buffer path. OPENSQUID_HOME-aware so tests isolate to mkdtemp. */
+export function candidatesBufferPath(sessionId) {
+    return join(OPENSQUID_HOME(), 'sessions', sessionId, 'compression-candidates.jsonl');
+}
+/** Parse the buffer into windows; `[]` on absent/malformed (no throw). */
+async function readWindows(sessionId) {
+    let raw;
+    try {
+        raw = await readFile(candidatesBufferPath(sessionId), 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed === 'object' &&
+                parsed !== null &&
+                typeof parsed.group === 'string' &&
+                Array.isArray(parsed.ids) &&
+                typeof parsed.promotedLessonId === 'string' &&
+                typeof parsed.collected_at === 'string') {
+                const o = parsed;
+                const ids = o.ids.filter((x) => typeof x === 'string');
+                out.push({
+                    group: o.group,
+                    ids,
+                    promotedLessonId: o.promotedLessonId,
+                    collected_at: o.collected_at,
+                });
+            }
+        }
+        catch {
+            // Skip a single malformed line rather than failing the whole read.
+        }
+    }
+    return out;
+}
+/**
+ * Collect a promoted lesson's cited memory ids into a candidate window
+ * appended to the per-session buffer. NO-OP when the lesson cites no
+ * memories (no window emitted — nothing to compress). Ids are deduped
+ * within the window. Append-only; never blocks; never touches the
+ * engine.
+ */
+export async function collectCandidates(sessionId, lesson, nowIso = () => new Date().toISOString()) {
+    if (!lesson.group.trim())
+        return;
+    const ids = [...new Set(lesson.citedMemoryIds.filter((s) => typeof s === 'string' && s.trim()))];
+    if (ids.length === 0)
+        return; // a lesson citing no memories → no window
+    const window = {
+        group: lesson.group,
+        ids,
+        promotedLessonId: lesson.id,
+        collected_at: nowIso(),
+    };
+    const path = candidatesBufferPath(sessionId);
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, JSON.stringify(window) + '\n', 'utf8');
+}
+/**
+ * Read the candidate windows for `group` — what the orchestrator
+ * (CMP.4) consumes. `[]` on absent/malformed buffer (fail-closed →
+ * nothing to compress).
+ */
+export async function readCandidates(sessionId, group) {
+    const windows = await readWindows(sessionId);
+    return windows.filter((w) => w.group === group);
+}
+//# sourceMappingURL=compress_candidates.js.map

package/dist/runtime/wedge/compress_candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress_candidates.js","sourceRoot":"","sources":["../../../src/runtime/wedge/compress_candidates.ts"],"names":[],"mappings":"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"}

package/dist/runtime/wedge/compression_deps.d.ts

@@ -0,0 +1,12 @@
+import { type ConsolidateOutcome } from '../../rag/memory/consolidate.js';
+export interface ConsolidateRunner {
+    run: (ids: string[]) => Promise<ConsolidateOutcome>;
+    close: () => Promise<void>;
+}
+/**
+ * Build a consolidate runner over the live backend + a fresh libSQL client. Throws if the resolved
+ * backend has no `dbUrl` (the memory-store accessors need a libSQL DB — the default libsql-fastembed
+ * backend always supplies one). The caller `close()`s the runner after use.
+ */
+export declare function makeConsolidateRunner(): Promise<ConsolidateRunner>;
+//# sourceMappingURL=compression_deps.d.ts.map

package/dist/runtime/wedge/compression_deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression_deps.d.ts","sourceRoot":"","sources":["../../../src/runtime/wedge/compression_deps.ts"],"names":[],"mappings":"AAmBA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,iCAAiC,CAAC;AAIzC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpD,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA0CxE"}

package/dist/runtime/wedge/compression_deps.js

@@ -0,0 +1,63 @@
+/**
+ * Compression consolidate-runner wiring (retire-Rust RES-4c). Binds the RES-4b `consolidate()` deps
+ * to the LIVE stack: the RagBackend (recall / deleteLesson / embed), a libSQL client for the
+ * memory-store accessors (getMemoryById / insertMemory + the additive compression columns), and the
+ * host LLM via `resolveStrategy('reasoning')` for the raw-text summarize. The compression
+ * orchestrator (a thin policy caller) takes the returned `run` fn — it stays ignorant of this wiring.
+ * The runner owns its libSQL client; the caller `close()`s it after the session's windows.
+ *
+ * Imports from: @libsql/client, ../../rag/backend_factory.js, ../../rag/config.js,
+ *   ../../rag/memory/{consolidate,compress,store}.js, ../../models/{load_config,dispatcher}.js.
+ * Imported by: src/runtime/hooks/session-end.ts.
+ */
+import { createClient } from '@libsql/client';
+import { createBackend } from '../../rag/backend_factory.js';
+import { resolveBackendConfig } from '../../rag/config.js';
+import { resolveRecallScope } from '../../rag/scope.js';
+import { resolveStrategy } from '../../models/dispatcher.js';
+import { loadModelsConfig } from '../../models/load_config.js';
+import { consolidate, } from '../../rag/memory/consolidate.js';
+import { ensureCompressionColumns, getMemoryById, insertMemory } from '../../rag/memory/store.js';
+/**
+ * Build a consolidate runner over the live backend + a fresh libSQL client. Throws if the resolved
+ * backend has no `dbUrl` (the memory-store accessors need a libSQL DB — the default libsql-fastembed
+ * backend always supplies one). The caller `close()`s the runner after use.
+ */
+export async function makeConsolidateRunner() {
+    const cfg = await resolveBackendConfig();
+    if (!('dbUrl' in cfg)) {
+        throw new Error(`compression: backend kind "${cfg.kind}" has no dbUrl — cannot consolidate`);
+    }
+    const dbUrl = cfg.dbUrl; // narrowed to a libsql-* variant
+    // File-first source-of-truth (only the fastembed variant carries it) so a consolidated memory
+    // survives rebuildLibsqlIndex — see T-fix-compression-durability.
+    const sourceDir = 'sourceDir' in cfg ? cfg.sourceDir : undefined;
+    const backend = createBackend(cfg);
+    await backend.init();
+    const client = createClient({ url: dbUrl });
+    await ensureCompressionColumns(client);
+    const models = await loadModelsConfig();
+    const reasoningCfg = models.reasoning;
+    const deps = {
+        getMemoryById: (id) => getMemoryById(client, id),
+        insertMemory: (m) => insertMemory(client, m, sourceDir),
+        recallIds: (query, k) => resolveRecallScope().then((scope) => backend.recall(query, k, scope).then((hits) => hits.map((h) => h.lesson.id))),
+        deleteMemory: (id) => backend.deleteLesson(id, { force: true }).then(() => undefined),
+        summarize: (prompt) => {
+            if (reasoningCfg === undefined) {
+                return Promise.reject(new Error('compression: no "reasoning" model alias configured'));
+            }
+            return resolveStrategy('reasoning', reasoningCfg).call(prompt);
+        },
+        embed: (text) => backend.embed(text),
+        now: () => new Date(),
+    };
+    return {
+        run: (ids) => consolidate(deps, ids),
+        close: () => {
+            client.close();
+            return Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=compression_deps.js.map