agent-recall-core 3.4.30 → 3.4.35

package/dist/tools-logic/safety-consolidation.js

@@ -0,0 +1,256 @@
+/**
+ * safety-consolidation.ts — the LOGIN-FREE, LLM-FREE background safety pass.
+ *
+ * The operator's #1 priority: the three maintenance steps that keep memory
+ * healthy (FSRS/salience decay, raw-archive retention, candidate graduation)
+ * must run AUTOMATICALLY and WITHOUT a Claude login or any OPENAI_API_KEY.
+ *
+ * Before this module those steps only fired when the un-cron'd overnight
+ * dreaming agent drained the async queue (`ar consolidate-async`), which fails
+ * often — so decay rarely ran, pruneRawArchive had ZERO callers (the archive
+ * grew unbounded), and crystallization candidates never graduated.
+ *
+ * This pass wires the EXISTING, already-headless primitives together:
+ *   (a) decay     → consolidateJournalToPalace (runs runDecayPass + markKeystones
+ *                   internally; pure regex/fs, no LLM)
+ *   (b) prune     → pruneRawArchive (the dead retention pass), gated by the
+ *                   `.consumed.json` marker which this pass advances by the
+ *                   deterministic "older than the retention window ⇒ distilled"
+ *                   rule (monotonic ⇒ idempotent)
+ *   (c) graduate  → findCrystallizationCandidates + a DETERMINISTIC threshold
+ *                   rule that re-titles the strongest member `CRYSTALLIZED: …`.
+ *                   No LLM-authored summary — that stays the optional dreaming
+ *                   path. Idempotent because findCrystallizationCandidates
+ *                   excludes already-CRYSTALLIZED titles.
+ *                   NOTE (sync side effect): when a candidate actually graduates,
+ *                   this step persists the mutated awareness state and calls
+ *                   renderAwareness, which (via writeAwareness) fires a GATED,
+ *                   non-blocking Supabase sync of the awareness markdown. The
+ *                   sync is a no-op unless Supabase is configured AND sync_enabled
+ *                   (readSupabaseConfig returns null otherwise), so it never
+ *                   requires a network round-trip or a login to complete the pass
+ *                   — it does NOT violate the login-free contract below. dryRun
+ *                   and "nothing graduated" paths perform NO write and NO sync.
+ *
+ * HARD contract:
+ *   - NONE of the three steps may require an LLM / OPENAI_API_KEY / Claude login.
+ *   - EACH step is wrapped in its own try/catch so one throwing does NOT abort
+ *     the others (best-effort, per-step isolation).
+ *   - dryRun computes counts but writes NOTHING.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { consolidateJournalToPalace } from "../palace/consolidate.js";
+import { runDecayPass } from "../palace/decay-pass.js";
+import { pruneRawArchive, } from "../storage/archive-prune.js";
+import { findCrystallizationCandidates, readAwarenessState, writeAwarenessState, renderAwareness, } from "../palace/awareness.js";
+import { archiveRawDir } from "../storage/paths.js";
+import { readJsonSafe, writeJsonAtomic } from "../storage/fs-utils.js";
+import { readSupabaseConfig } from "../supabase/config.js";
+import { DEFAULT_ARCHIVE_RETENTION_DAYS, resolveRetentionDays, } from "../storage/retention.js";
+const DAY_MS = 86_400_000;
+// The raw-archive retention window now lives in storage/retention.ts (single
+// source of truth shared with store-doctor.ts, so the pruner and the integrity
+// check can never disagree on the threshold). Re-exported here for barrel /
+// back-compat consumers that import it from this module.
+export { DEFAULT_ARCHIVE_RETENTION_DAYS };
+/** Deterministic graduation floor: a crystallization candidate graduates when
+ *  its members together carry at least this many confirmations. Layered on top
+ *  of findCrystallizationCandidates' own minCluster/minTotalConfirm gates so the
+ *  rule is purely numeric — NO LLM judgement. Overridable via the runSafety
+ *  opt, the AGENT_RECALL_GRADUATION_MIN_CONFIRMATIONS env var, or config.json
+ *  `graduation_min_confirmations` (resolved in that order by
+ *  resolveGraduationMinConfirmations). */
+export const DEFAULT_GRADUATION_MIN_CONFIRMATIONS = 8;
+/**
+ * Resolve the graduation confirmation floor: explicit opt >
+ * AGENT_RECALL_GRADUATION_MIN_CONFIRMATIONS env > config.json
+ * `graduation_min_confirmations` > DEFAULT_GRADUATION_MIN_CONFIRMATIONS.
+ *
+ * Mirrors resolveRetentionDays so the two numeric knobs resolve identically.
+ */
+function resolveGraduationMinConfirmations(explicit) {
+    if (typeof explicit === "number" && Number.isFinite(explicit) && explicit > 0) {
+        return explicit;
+    }
+    const env = process.env.AGENT_RECALL_GRADUATION_MIN_CONFIRMATIONS;
+    if (env) {
+        const n = Number(env);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    try {
+        const cfg = readSupabaseConfig();
+        if (cfg &&
+            typeof cfg.graduation_min_confirmations === "number" &&
+            cfg.graduation_min_confirmations > 0) {
+            return cfg.graduation_min_confirmations;
+        }
+    }
+    catch {
+        // config read is best-effort — fall through to default
+    }
+    return DEFAULT_GRADUATION_MIN_CONFIRMATIONS;
+}
+/**
+ * Advance the raw-archive `.consumed.json` marker to "now − olderThanDays".
+ *
+ * Definition of "consumed" (single agreed definition, shared verbatim with
+ * archive-prune.ts): a raw segment whose content has been folded into the palace
+ * by the (regex, login-free) journal→palace consolidation. Segments older than
+ * the retention window have necessarily already been consolidated, so they count
+ * as consumed. Advancing the marker to the age cutoff lets pruneRawArchive
+ * actually fire on those aged segments while still PROTECTING anything newer than
+ * the window (the consumed gate stays meaningful). This is the writer for the
+ * exact `mtime <= lastConsumedAt` contract pruneRawArchive reads.
+ *
+ * MONOTONIC: never moves the marker backward. This is what makes the whole pass
+ * idempotent — a re-run with no newly-aged segments advances nothing and prunes
+ * nothing. Reuses the EXISTING checkpoint file; invents no new one.
+ *
+ * Returns the lastConsumedAt the marker is (or would be, in dryRun) set to.
+ */
+function advanceConsumeMarker(slug, olderThanDays, dryRun) {
+    const dir = archiveRawDir(slug);
+    if (!fs.existsSync(dir))
+        return null;
+    const markerPath = path.join(dir, ".consumed.json");
+    const existing = readJsonSafe(markerPath);
+    const prevMs = existing?.lastConsumedAt
+        ? new Date(existing.lastConsumedAt).getTime()
+        : 0;
+    const cutoffMs = Date.now() - olderThanDays * DAY_MS;
+    // Monotonic: only advance forward. If the marker already covers the cutoff,
+    // there is nothing to do — re-runs become no-ops here.
+    if (!(cutoffMs > prevMs)) {
+        return existing?.lastConsumedAt ?? null;
+    }
+    const next = new Date(cutoffMs).toISOString();
+    if (!dryRun) {
+        writeJsonAtomic(markerPath, {
+            lastConsumedOffset: existing?.lastConsumedOffset ?? 0,
+            lastConsumedAt: next,
+        });
+    }
+    return next;
+}
+/**
+ * Step (c): graduate above-threshold crystallization candidates by re-titling
+ * the strongest member insight `CRYSTALLIZED: <title>`. Deterministic threshold
+ * ONLY — no LLM-authored summary. Idempotent: findCrystallizationCandidates
+ * excludes already-CRYSTALLIZED titles, so a graduated insight never re-graduates.
+ */
+function graduateCandidates(candidates, minConfirmations, dryRun) {
+    const eligible = candidates.filter((c) => c.total_confirmations >= minConfirmations);
+    if (eligible.length === 0)
+        return { graduated: 0, titles: [] };
+    const state = readAwarenessState();
+    if (!state)
+        return { graduated: 0, titles: [] };
+    const titles = [];
+    let mutated = false;
+    for (const cand of eligible) {
+        // Pick the strongest member (most confirmations) that is still un-graduated.
+        const members = state.topInsights
+            .filter((i) => cand.insight_ids.includes(i.id))
+            .filter((i) => !/^\s*(crystallized|critical)\b/i.test(i.title ?? ""));
+        if (members.length === 0)
+            continue; // already graduated → idempotent skip
+        members.sort((a, b) => b.confirmations - a.confirmations);
+        const lead = members[0];
+        const newTitle = `CRYSTALLIZED: ${lead.title}`;
+        titles.push(newTitle);
+        if (!dryRun) {
+            lead.title = newTitle;
+            mutated = true;
+        }
+    }
+    if (mutated && !dryRun) {
+        writeAwarenessState(state);
+        renderAwareness(state);
+    }
+    return { graduated: titles.length, titles };
+}
+/**
+ * Run the three best-effort, LOGIN-FREE, LLM-FREE safety-consolidation steps
+ * for a project. Each step is isolated in its own try/catch: one throwing never
+ * aborts the others. dryRun computes counts but writes nothing.
+ */
+export async function runSafetyConsolidation(project, opts = {}) {
+    const dryRun = opts.dryRun === true;
+    const olderThanDays = resolveRetentionDays(opts.olderThanDays);
+    const minConfirmations = resolveGraduationMinConfirmations(opts.minConfirmations);
+    const decay = { ran: false, scanned: 0, archived: 0 };
+    const pruned = {
+        ran: false,
+        scanned: 0,
+        gzipped: 0,
+        removed: 0,
+        eligible: 0,
+        consumedThrough: null,
+    };
+    const graduated = {
+        ran: false,
+        candidates: 0,
+        graduated: 0,
+        graduatedTitles: [],
+    };
+    // ── (a) decay + keystones ──────────────────────────────────────────────
+    // consolidateJournalToPalace runs runDecayPass + markKeystones internally and
+    // is pure regex/fs (no LLM). In dryRun we MUST NOT write, so call runDecayPass
+    // directly with dryRun:true instead of the full (always-writing) consolidate.
+    //
+    // Counting note: runDecayPass skips already-archived objects, so a post-write
+    // re-count would under-report. Capture the candidate count from a dryRun pass
+    // FIRST (pre-write), then run the real consolidate to apply the flags.
+    try {
+        const report = runDecayPass(project, { dryRun: true });
+        decay.scanned = report.scanned;
+        decay.archived = report.archived_candidates.length;
+        if (!dryRun) {
+            // Distill journal → palace (regex), which internally applies the decay
+            // flags. Counts already captured above (pre-write) so they stay honest.
+            consolidateJournalToPalace(project);
+        }
+        decay.ran = true;
+    }
+    catch (err) {
+        decay.error = err instanceof Error ? err.message : String(err);
+    }
+    // ── (b) prune raw archive (retention) ──────────────────────────────────
+    try {
+        // Advance the consume marker so aged, already-distilled segments become
+        // prunable (the marker is the load-bearing safety guard). Monotonic.
+        const consumedThrough = advanceConsumeMarker(project, olderThanDays, dryRun);
+        pruned.consumedThrough = consumedThrough;
+        const res = pruneRawArchive(project, {
+            olderThanDays,
+            dryRun,
+        });
+        pruned.scanned = res.scanned;
+        pruned.gzipped = res.gzipped;
+        pruned.removed = res.removed;
+        pruned.eligible = res.eligible;
+        // pruneRawArchive recomputes consumedThrough from the marker we just wrote;
+        // prefer its value when present (they agree in non-dryRun).
+        pruned.consumedThrough = res.consumedThrough ?? consumedThrough;
+        pruned.ran = true;
+    }
+    catch (err) {
+        pruned.error = err instanceof Error ? err.message : String(err);
+    }
+    // ── (c) graduate crystallization candidates (deterministic threshold) ───
+    try {
+        const candidates = findCrystallizationCandidates();
+        graduated.candidates = candidates.length;
+        const g = graduateCandidates(candidates, minConfirmations, dryRun);
+        graduated.graduated = g.graduated;
+        graduated.graduatedTitles = g.titles;
+        graduated.ran = true;
+    }
+    catch (err) {
+        graduated.error = err instanceof Error ? err.message : String(err);
+    }
+    return { project, dryRun, decay, pruned, graduated };
+}
+//# sourceMappingURL=safety-consolidation.js.map

package/dist/tools-logic/safety-consolidation.js.map

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

package/dist/tools-logic/session-end-reflect.d.ts

@@ -18,6 +18,7 @@
  * already in the conversation writes its own reflection, we just give it
  * the inputs.
  */
+import { type CrystallizationCandidate } from "../palace/awareness.js";
 export interface ReflectInput {
     project?: string;
     /** Look back this many days of journal entries. Default 7. */
@@ -43,6 +44,23 @@ export interface ReflectInputBundle {
         phase: string;
         synthesis: string;
     }>;
+    /**
+     * Wave 2: lossless raw archive segments not yet consumed by compression
+     * (files newer than the `.consumed.json` marker). The in-loop LLM is asked to
+     * distill these upward and advance the marker. Core stays deterministic — it
+     * only surfaces the raw material; it makes NO LLM call itself.
+     */
+    raw_unconsumed?: Array<{
+        file: string;
+        excerpt: string;
+        bytes: number;
+    }>;
+    /**
+     * Wave 3: clusters of related awareness insights that are candidates for
+     * crystallization into a single principle. Raw material ONLY — core does NOT
+     * synthesize the principle (the in-loop LLM does, per Decision #3).
+     */
+    crystallization_candidates?: CrystallizationCandidate[];
 }
 export interface ReflectResult {
     success: boolean;

package/dist/tools-logic/session-end-reflect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-end-reflect.d.ts","sourceRoot":"","sources":["../../src/tools-logic/session-end-reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,0DAA0D;IAC1D,kBAAkB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACpG,0DAA0D;IAC1D,aAAa,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA0DnF"}
+{"version":3,"file":"session-end-reflect.d.ts","sourceRoot":"","sources":["../../src/tools-logic/session-end-reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EAAiC,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAOtG,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,0DAA0D;IAC1D,kBAAkB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACpG,0DAA0D;IAC1D,aAAa,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E;;;;;OAKG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAwEnF"}

package/dist/tools-logic/session-end-reflect.js

@@ -22,6 +22,10 @@ import { resolveProject } from "../storage/project.js";
 import { readCorrections } from "../storage/corrections.js";
 import { listJournalFiles } from "../helpers/journal-files.js";
 import { listMilestones } from "../palace/pipeline.js";
+import { findCrystallizationCandidates } from "../palace/awareness.js";
+import { archiveRawDir } from "../storage/paths.js";
+import { readJsonSafe } from "../storage/fs-utils.js";
+import { buildConsolidationPrompt } from "../prompts/consolidation-prompt.js";
 import * as fs from "node:fs";
 import * as path from "node:path";
 const EXCERPT_CHARS = 800;
@@ -68,10 +72,23 @@ export async function sessionEndReflect(input) {
         phase: p.meta.phase,
         synthesis: p.sections.synthesis,
     }));
+    const rawUnconsumed = collectRawUnconsumed(slug);
+    // Wave 3: surface crystallization candidates (best-effort; never throws).
+    let crystallizationCandidates = [];
+    try {
+        crystallizationCandidates = findCrystallizationCandidates();
+    }
+    catch {
+        crystallizationCandidates = [];
+    }
     const bundle = {
         recent_journals: recentJournals,
         active_corrections: corrections,
         recent_phases: recentPhases,
+        ...(rawUnconsumed.length > 0 ? { raw_unconsumed: rawUnconsumed } : {}),
+        ...(crystallizationCandidates.length > 0
+            ? { crystallization_candidates: crystallizationCandidates }
+            : {}),
     };
     const prompt = buildPrompt(slug, bundle, lookback);
     const nextActions = [
@@ -81,37 +98,59 @@ export async function sessionEndReflect(input) {
     ];
     return { success: true, project: slug, bundle, prompt, next_actions: nextActions };
 }
+// Wave 5: the prompt body is now generated by the SINGLE versioned source
+// (prompts/consolidation-prompt.ts), so `ar consolidate` and `session_end_reflect`
+// render identically. This wrapper exists only to keep the call signature stable.
 function buildPrompt(slug, bundle, lookback) {
-    const lines = [];
-    lines.push(`# Reflect on ${slug} — last ${lookback} days`);
-    lines.push("");
-    lines.push("You are the agent reviewing your own recent work. Look at the inputs below and produce:");
-    lines.push("");
-    lines.push("1. **Three high-level questions** this period raised (Park 2023 style).");
-    lines.push("2. **Procedural skills** that crystallized — anything repeated ≥2x is a candidate (call skill_write).");
-    lines.push("3. **Cross-session patterns** that aren't yet in awareness — distilled insights worth promoting.");
-    lines.push("4. **Noise to archive** — corrections with low precision that should be retired.");
-    lines.push("");
-    lines.push("Be terse. One bullet per finding. Cite journal dates / phase orders / correction ids as evidence.");
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-    lines.push(`## Journals (${bundle.recent_journals.length})`);
-    for (const j of bundle.recent_journals) {
-        lines.push(`### ${j.date} — ${j.file}`);
-        lines.push(j.excerpt);
-        lines.push("");
-    }
-    lines.push(`## Active corrections (${bundle.active_corrections.length})`);
-    for (const c of bundle.active_corrections) {
-        const p = c.precision !== null ? ` p=${c.precision}` : "";
-        lines.push(`- [${c.id}] (${c.severity}${p}) ${c.rule}`);
+    return buildConsolidationPrompt(slug, bundle, lookback);
+}
+/**
+ * Wave 2: collect lossless raw-archive files newer than the `.consumed.json`
+ * marker so the reflect bundle can hand them to the LLM for distillation.
+ * Deterministic and best-effort — never throws.
+ */
+function collectRawUnconsumed(slug) {
+    const out = [];
+    try {
+        const rawDir = archiveRawDir(slug);
+        if (!fs.existsSync(rawDir))
+            return out;
+        const marker = readJsonSafe(path.join(rawDir, ".consumed.json"));
+        const cutoffMs = marker?.lastConsumedAt
+            ? new Date(marker.lastConsumedAt).getTime()
+            : 0;
+        const files = fs
+            .readdirSync(rawDir)
+            .filter((f) => f.endsWith(".md"))
+            .sort()
+            .reverse();
+        for (const file of files) {
+            const full = path.join(rawDir, file);
+            let stat;
+            try {
+                stat = fs.statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (Number.isFinite(cutoffMs) && cutoffMs > 0 && stat.mtimeMs <= cutoffMs) {
+                continue; // already consumed
+            }
+            let excerpt = "";
+            try {
+                excerpt = fs.readFileSync(full, "utf-8").slice(0, EXCERPT_CHARS);
+            }
+            catch {
+                continue;
+            }
+            out.push({ file, excerpt, bytes: stat.size });
+            if (out.length >= 5)
+                break; // cap — bound the bundle size
+        }
     }
-    lines.push("");
-    lines.push(`## Recent closed phases (${bundle.recent_phases.length})`);
-    for (const ph of bundle.recent_phases) {
-        lines.push(`- Phase ${ph.order} — ${ph.phase}: ${ph.synthesis}`);
+    catch {
+        // best-effort
     }
-    return lines.join("\n");
+    return out;
 }
 //# sourceMappingURL=session-end-reflect.js.map

package/dist/tools-logic/session-end-reflect.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-end-reflect.js","sourceRoot":"","sources":["../../src/tools-logic/session-end-reflect.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-end-reflect.js","sourceRoot":"","sources":["../../src/tools-logic/session-end-reflect.ts"],"names":[],"mappings":"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"}

package/dist/tools-logic/session-end.d.ts

@@ -39,6 +39,15 @@ export interface SessionEndInput {
         phase_name: string;
         goal: string;
     };
+    /**
+     * Wave 2: defer the inline journal→palace consolidation to the async
+     * dreaming queue instead of running it in this turn. ONLY the harness-driven
+     * Stop hook (`hook-end`) passes this true — it enqueues a consolidation job
+     * and skips the synchronous palace pass. Default false ⇒ ZERO behavior
+     * change for /arsave, /arsaveall, and the MCP session_end (they still
+     * consolidate inline). Decision #3: consolidation is async dreaming.
+     */
+    deferConsolidation?: boolean;
 }
 export interface MergeSuggestion {
     file: string;

package/dist/tools-logic/session-end.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-end.d.ts","sourceRoot":"","sources":["../../src/tools-logic/session-end.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-end.d.ts","sourceRoot":"","sources":["../../src/tools-logic/session-end.ts"],"names":[],"mappings":"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"}