draken 0.5.1 → 0.7.0

package/dist/sync/summary-preparation.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summaryPreparationEnabled = void 0;
+exports.cancelSummaryPreparation = cancelSummaryPreparation;
+exports.configureAutoSummary = configureAutoSummary;
+exports.summaryPreparationSettings = summaryPreparationSettings;
+exports.warmSummaryCache = warmSummaryCache;
+const schema_1 = require("../db/schema");
+const errors_1 = require("../errors");
+const activity_1 = require("./activity");
+const service_1 = require("../memory/service");
+const store_1 = require("./store");
+const tree_1 = require("./tree");
+const normalize_1 = require("./normalize");
+const BATCH = 64;
+const FAILURE = 'Background summaries could not finish. Check provider settings, invocation limits and original session files, then explicitly enable summaries to retry. Cached work is retained.';
+const setting = (key) => (0, schema_1.getDb)().prepare('SELECT value FROM sync_settings WHERE key=?').get(key)?.value;
+function save(key, value) {
+    (0, schema_1.getDb)().prepare('INSERT INTO sync_settings(key,value) VALUES (?,?) ON CONFLICT(key) DO UPDATE SET value=excluded.value').run(key, value);
+}
+const summaryPreparationEnabled = () => setting('auto_summary') === 'true';
+exports.summaryPreparationEnabled = summaryPreparationEnabled;
+const indexingEnabled = () => setting('auto_index') === 'true';
+const idle = () => !activity_1.activity.busy && !activity_1.activity.callActive && !(0, service_1.historyProgress)().active && !(0, service_1.historyProgress)().queued;
+let consentRevision = 0;
+let active;
+/** Cancellation is irrevocable for this job even if consent is immediately re-enabled. */
+function cancelSummaryPreparation() {
+    const prior = active;
+    prior?.controller.abort();
+    // Return the owned promise, not a detached rejecting wrapper. The scheduler
+    // retains its rejection handler even when a synchronous setter only aborts.
+    return prior?.done || Promise.resolve();
+}
+/** Called by the scheduler's lifecycle owner; reads never start the scheduler. */
+function configureAutoSummary(value) {
+    if (typeof value !== 'boolean')
+        throw new errors_1.HttpError(400, 'enabled must be a boolean');
+    if (value && !indexingEnabled())
+        throw new errors_1.HttpError(409, 'Enable automatic indexing before enabling paid background summaries.');
+    consentRevision++;
+    active?.controller.abort();
+    (0, schema_1.getDb)().transaction(() => {
+        save('auto_summary', String(value));
+        if (value)
+            save('auto_summary_error', '');
+    })();
+}
+function checkpoint(input) {
+    // Canonical recipe/input hashes only; no original text, paths or provider output.
+    // SQL sequence IDs can be reassigned by a full rescan; that does not turn
+    // unchanged original records into another paid batch. Receipt identity still
+    // includes full ordering, while this delta counts canonical source changes.
+    return { keys: input.items.map(item => [(0, normalize_1.digest)(JSON.stringify([item.agent || 'pi', item.session_id, item.entry_id])),
+            (0, normalize_1.digest)(JSON.stringify([(0, normalize_1.sourceKey)(item), item.agent, item.session_id, item.cwd, item.timestamp, item.role]))]),
+        recipe: (0, tree_1.summaryPreparationKey)({ ...input, items: [] }) };
+}
+function completed() {
+    return (0, schema_1.getDb)().prepare("SELECT id,input_key,source_keys_json,cache_receipt_json,total_entries,completed_at FROM background_runs WHERE status='completed' ORDER BY id DESC LIMIT 1").get();
+}
+function matching(key) {
+    return (0, schema_1.getDb)().prepare("SELECT id,input_key,source_keys_json,cache_receipt_json,total_entries,completed_at FROM background_runs WHERE status='completed' AND input_key=? ORDER BY id DESC LIMIT 1").get(key);
+}
+function cacheIntact(value) {
+    let pairs;
+    try {
+        pairs = typeof value === 'string' ? JSON.parse(value) : value;
+    }
+    catch {
+        return false;
+    }
+    if (!Array.isArray(pairs) || !pairs.length || pairs.some(pair => !Array.isArray(pair) || pair.length !== 2 || pair.some(hash => typeof hash !== 'string' || !/^[a-f0-9]{64}$/.test(hash))))
+        return false;
+    const lookup = (0, schema_1.getDb)().prepare('SELECT output_json FROM summary_cache WHERE key=?');
+    return pairs.every(([key, hash]) => {
+        const row = lookup.get(key);
+        return row !== undefined && (0, normalize_1.digest)(row.output_json) === hash;
+    });
+}
+/** Historical progress, not a live readiness claim. Polling must not reopen
+ * transcript bodies; the preparing owner and explicit sync validate originals. */
+function summaryPreparationSettings() {
+    const enabled = (0, exports.summaryPreparationEnabled)(), error = setting('auto_summary_error') || '';
+    const last = (0, schema_1.getDb)().prepare("SELECT total_entries,completed_at FROM background_runs WHERE status='completed' ORDER BY id DESC LIMIT 1").get();
+    return { enabled, status: !enabled ? 'off' : error ? 'error' : !indexingEnabled() || !idle() || active?.controller.signal.aborted ? 'paused' : active?.working ? 'running' : 'waiting',
+        prepared_entries: last?.total_entries || 0, last_completed_at: last?.completed_at || null, error };
+}
+/** Prepare only reusable summaries. No sync identity, snapshot, briefing or verdict.
+ * A successful receipt suppresses repeated work; a failure blocks all automatic
+ * paid retries until explicit consent/retry. Cancellation retains its allowance. */
+async function warmSummaryCache(signal, onWork) {
+    if (signal.aborted || !(0, exports.summaryPreparationEnabled)() || !indexingEnabled() || !idle() || setting('auto_summary_error'))
+        return;
+    if (active)
+        return active.done;
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    signal.addEventListener('abort', abort, { once: true });
+    const revision = consentRevision;
+    const owner = { controller, done: Promise.resolve(), working: false };
+    active = owner;
+    owner.done = Promise.resolve().then(async () => {
+        let run;
+        const admitted = () => !controller.signal.aborted && (0, exports.summaryPreparationEnabled)() && indexingEnabled() && idle();
+        const check = () => { if (!admitted()) {
+            controller.abort();
+            throw new errors_1.HttpError(409, 'Background preparation paused');
+        } };
+        try {
+            check();
+            const db = (0, schema_1.getDb)();
+            // Startup recovery is responsible for interrupted ownership. A running row
+            // with no process-local job can also mean failure metadata could not be
+            // committed. Never silently replace that run with a fresh allowance.
+            const orphan = db.prepare("SELECT id,invocations,max_invocations FROM background_runs WHERE status='running' LIMIT 1").get();
+            if (orphan) {
+                run = orphan;
+                throw new Error('Background ownership was not recovered');
+            }
+            const input = (0, store_1.previewSummaryInput)();
+            (0, store_1.assertEvidenceAvailable)(input);
+            const key = (0, tree_1.summaryPreparationKey)(input);
+            const receipt = matching(key);
+            if (receipt && cacheIntact(receipt.cache_receipt_json))
+                return;
+            const sources = checkpoint(input), last = completed();
+            let prior;
+            if (last) {
+                prior = JSON.parse(last.source_keys_json);
+                if (!Array.isArray(prior.keys) || prior.keys.some(pair => !Array.isArray(pair) || pair.length !== 2 || pair.some(value => typeof value !== 'string')) || typeof prior.recipe !== 'string')
+                    throw new Error('Invalid receipt metadata');
+            }
+            const old = new Map(prior?.keys), current = new Map(sources.keys);
+            const changed = sources.keys.filter(([id, hash]) => old.get(id) !== hash).length + [...old.keys()].filter(id => !current.has(id)).length;
+            // Model/recipe/context changes need a fresh full receipt even when no IDs arrived.
+            if (input.items.length < BATCH || (!receipt && changed < BATCH && (!prior || prior.recipe === sources.recipe)))
+                return;
+            check();
+            run = db.prepare(`SELECT id,invocations,max_invocations FROM background_runs WHERE input_key=?
+        AND status IN ('cancelled','interrupted') ORDER BY id DESC LIMIT 1`).get(key);
+            // Never resurrect an older interrupted allowance after an explicitly retried attempt.
+            const latest = db.prepare('SELECT id FROM background_runs WHERE input_key=? ORDER BY id DESC LIMIT 1').get(key);
+            if (run && latest?.id !== run.id)
+                run = undefined;
+            if (run) {
+                db.prepare("UPDATE background_runs SET status='running',stage='Planning',processed_entries=0,cache_hits=0,error='',completed_at=NULL WHERE id=?").run(run.id);
+                input.models = { ...input.models, max_invocations: run.max_invocations };
+            }
+            else {
+                const result = db.prepare(`INSERT INTO background_runs(summary_model,final_model,max_invocations,total_entries,started_at,input_key,source_keys_json)
+          VALUES (?,?,?,?,?,?,?)`).run(input.models.summary, input.models.final, input.models.max_invocations, input.items.length, new Date().toISOString(), key, JSON.stringify(sources));
+                run = { id: Number(result.lastInsertRowid), invocations: 0, max_invocations: input.models.max_invocations };
+            }
+            owner.working = true;
+            onWork?.();
+            const tree = tree_1.SummaryTree.forBackground(input, run.id, controller.signal);
+            // Recheck at the last boundary before *each* provider call, including repairs
+            // and reconciliation after an await. Route-level yielding also drains this owner.
+            const call = tree.call.bind(tree);
+            tree.call = async (payload, system, final = false) => {
+                check();
+                if (final)
+                    throw new Error('Background preparation cannot request a verdict');
+                return call(payload, system, false);
+            };
+            await tree.build();
+            check();
+            // Inputs can change while a provider is in flight. Keep useful cache fragments,
+            // but never publish a receipt for sources/models no longer admitted or available.
+            const latestInput = (0, store_1.previewSummaryInput)();
+            (0, store_1.assertEvidenceAvailable)(latestInput);
+            if ((0, tree_1.summaryPreparationKey)(latestInput) !== key) {
+                controller.abort();
+                throw new Error('Input changed');
+            }
+            const cacheReceipt = tree.cacheReceipt();
+            if (!cacheIntact(cacheReceipt))
+                throw new Error('Summary cache changed before completion');
+            db.prepare("UPDATE background_runs SET status='completed',stage='Cached',error='',completed_at=?,cache_receipt_json=? WHERE id=?")
+                .run(new Date().toISOString(), JSON.stringify(cacheReceipt), run.id);
+        }
+        catch {
+            const db = (0, schema_1.getDb)();
+            const counters = run && db.prepare('SELECT invocations,max_invocations FROM background_runs WHERE id=?').get(run.id);
+            const cancelled = controller.signal.aborted;
+            // Exhausted cancellations are also blocked: do not spin a quota 409 every minute.
+            const exhausted = Boolean(counters && counters.invocations >= counters.max_invocations);
+            const status = cancelled && !exhausted ? 'cancelled' : 'failed', at = new Date().toISOString();
+            db.transaction(() => {
+                if (run)
+                    db.prepare(`UPDATE background_runs SET status=?,error=?,completed_at=?,
+          failure_events_json=json_insert(failure_events_json,'$[#]',json(?)) WHERE id=?`)
+                        .run(status, cancelled && !exhausted ? '' : FAILURE, at, JSON.stringify({ status, at }), run.id);
+                if (revision === consentRevision && (!cancelled || exhausted))
+                    save('auto_summary_error', FAILURE);
+            })();
+        }
+    }).finally(() => {
+        signal.removeEventListener('abort', abort);
+        if (active === owner)
+            active = undefined;
+    });
+    return owner.done;
+}
+//# sourceMappingURL=summary-preparation.js.map

package/dist/sync/summary-preparation.js.map

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

package/dist/sync/tree.d.ts

@@ -18,6 +18,13 @@ export declare function repairSummaryCitations(candidate: NodeSummary, value: un
     characters: number;
 }): NodeSummary;
 export declare function validateGroups(value: unknown, allowed: Set<string>): TopicGroups;
+/** Evidence and models only: background preparation does not own a sync. */
+export type SummaryInput = Pick<SyncDetail, 'items' | 'context' | 'models'>;
+declare const BACKGROUND: unique symbol;
+/** A receipt identity, not a persisted copy of the evidence. Keep this recipe
+ * version in step with planning/validation/transport changes, even when old
+ * validated leaf cache keys intentionally remain compatible. */
+export declare function summaryPreparationKey(input: SummaryInput): string;
 export declare class SummaryTree {
     private sync;
     private runId;
@@ -26,7 +33,15 @@ export declare class SummaryTree {
     private readonly sourceMap;
     private readonly primary;
     private readonly accountAggregation;
-    constructor(sync: SyncDetail, runId: number, signal: AbortSignal);
+    private readonly runTable;
+    private readonly background;
+    private readonly cacheHashes;
+    static forBackground(input: SummaryInput, runId: number, signal: AbortSignal): SummaryTree;
+    constructor(sync: SummaryInput & {
+        id?: number;
+    }, runId: number, signal: AbortSignal, mode?: typeof BACKGROUND);
+    /** Hashes of the validated outputs consumed by this background build. */
+    cacheReceipt(): [string, string][];
     private stage;
     call(payload: unknown, system: string, final?: boolean): Promise<string>;
     private register;
@@ -66,4 +81,5 @@ export declare class SummaryTree {
         topic: string;
     }[];
 }
+export {};
 //# sourceMappingURL=tree.d.ts.map

package/dist/sync/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/sync/tree.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAgDrG,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA4BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM;;;;CAAgB,GAAG,WAAW,CAoBzG;AAED,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM;;;;CAAgB,GAAG,WAAW,CAiBxI;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,WAAW,CAehF;AAoBD,qBAAa,WAAW;IAKV,OAAO,CAAC,IAAI;IAAc,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,MAAM;IAJ3E,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;gBACzB,IAAI,EAAE,UAAU,EAAU,KAAK,EAAE,MAAM,EAAU,MAAM,EAAE,WAAW;IAQxF,OAAO,CAAC,KAAK;IAKP,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAqC5E,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,IAAI;YAYE,IAAI;IAqElB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,KAAK;YAYC,UAAU;YAeV,MAAM;IAQpB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,UAAU;IAuClB,OAAO,CAAC,YAAY;YAKN,cAAc;YAed,YAAY;IAiCpB,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAmErC,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;CACpC"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/sync/tree.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAiDrG,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA4BD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM;;;;CAAgB,GAAG,WAAW,CAmBzG;AAED,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM;;;;CAAgB,GAAG,WAAW,CAiBxI;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,WAAW,CAehF;AAoBD,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;AAC5E,QAAA,MAAM,UAAU,eAA2C,CAAC;AAE5D;;gEAEgE;AAChE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAajE;AAED,qBAAa,WAAW;IAaV,OAAO,CAAC,IAAI;IAAkC,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,MAAM;IAZ/F,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,WAAW;gBAItE,IAAI,EAAE,YAAY,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,EAAU,KAAK,EAAE,MAAM,EAAU,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,UAAU;IAWtI,yEAAyE;IACzE,YAAY,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;IAElC,OAAO,CAAC,KAAK;IAOP,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAsC5E,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;YAYE,IAAI;IA4ElB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,KAAK;YAYC,UAAU;YAeV,MAAM;IAQpB,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,UAAU;IAoDlB,OAAO,CAAC,YAAY;YAKN,cAAc;YAed,YAAY;IA+BpB,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAmErC,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;CACpC"}

package/dist/sync/tree.js

@@ -4,9 +4,11 @@ exports.SummaryTree = void 0;
 exports.validateSummary = validateSummary;
 exports.repairSummaryCitations = repairSummaryCitations;
 exports.validateGroups = validateGroups;
+exports.summaryPreparationKey = summaryPreparationKey;
 const schema_1 = require("../db/schema");
 const normalize_1 = require("./normalize");
 const store_1 = require("./store");
+const errors_1 = require("../errors");
 const pi_1 = require("./pi");
 const references_1 = require("./references");
 const summary_budget_1 = require("./summary-budget");
@@ -87,7 +89,6 @@ function validateSummary(value, allowed, limits = LEGACY_OUTPUT) {
     const result = { observations, limitations };
     if (JSON.stringify(result).length > limits.characters)
         throw new Error('Summary is too large');
-    // Check ALL schema fields and source membership before considering a citation-only repair.
     if (observations.some(item => item.evidence.length > MAX_EVIDENCE))
         throw new CitationLimitError(result);
     return result;
@@ -148,7 +149,7 @@ function pack(items, cost, maxChars, maxItems) {
     for (const item of items) {
         const chars = cost(item);
         if (chars > maxChars)
-            throw new store_1.HttpError(400, 'One summary input exceeds the safety limit; it was not silently dropped.');
+            throw new errors_1.HttpError(400, 'One summary input exceeds the safety limit; it was not silently dropped.');
         if (group.length && (size + chars > maxChars || group.length >= maxItems)) {
             groups.push(group);
             group = [];
@@ -164,6 +165,24 @@ function pack(items, cost, maxChars, maxItems) {
 function sourceData(item, background = false) {
     return { ...(item.agent && item.agent !== 'pi' ? { agent: item.agent } : {}), id: (0, normalize_1.sourceKey)(item), workspace: item.cwd, timestamp: item.timestamp, sequence: item.sequence, role: item.role, background, text: (0, normalize_1.cleanText)(item.text, Number.MAX_SAFE_INTEGER) };
 }
+const BACKGROUND = Symbol('background summary preparation');
+/** A receipt identity, not a persisted copy of the evidence. Keep this recipe
+ * version in step with planning/validation/transport changes, even when old
+ * validated leaf cache keys intentionally remain compatible. */
+function summaryPreparationKey(input) {
+    const sources = (items, background) => items.map(item => ({
+        session: item.session_id, label: item.session_name, ...sourceData(item, background),
+    }));
+    return (0, normalize_1.digest)(JSON.stringify({
+        recipe: 'summary-preparation-v1-stable-prefix',
+        prompts: { PROMPT_VERSION, legacySummarySystem, summarySystem, batchSummarySystem, citationRepairSystem, groupingSystem },
+        budgets: { CHUNK_CHARS, MERGE_CHARS, OUTPUT_CHARS, BATCH_OUTPUT, LEGACY_OUTPUT, MAX_EVIDENCE, LUNA_BATCH: summary_budget_1.LUNA_BATCH },
+        // Versions of the shared normalization, short-label transport and token estimator.
+        dependencies: ['normalization-v2', 'references-v2', 'o200k_base-gpt-tokenizer-4.1.0', 'prompt-headroom-1.2-8192'],
+        models: { summary: input.models.summary, final: input.models.final, max_invocations: input.models.max_invocations },
+        items: sources(input.items, false), context: sources(input.context, true),
+    }));
+}
 class SummaryTree {
     sync;
     runId;
@@ -172,51 +191,68 @@ class SummaryTree {
     sourceMap;
     primary;
     accountAggregation;
-    constructor(sync, runId, signal) {
+    runTable;
+    background;
+    cacheHashes = new Map();
+    static forBackground(input, runId, signal) {
+        return new SummaryTree(input, runId, signal, BACKGROUND);
+    }
+    constructor(sync, runId, signal, mode) {
         this.sync = sync;
         this.runId = runId;
         this.signal = signal;
+        this.background = mode === BACKGROUND;
+        this.runTable = this.background ? 'background_runs' : 'sync_runs';
+        if (!this.background && !Number.isSafeInteger(sync.id))
+            throw new Error('Foreground summary preparation requires a sync ID');
         (0, store_1.assertEvidenceAvailable)(sync);
-        this.accountAggregation = this.db.prepare('SELECT question FROM sync_runs WHERE id=?').get(runId)?.question === null;
+        this.accountAggregation = this.background || this.db.prepare('SELECT question FROM sync_runs WHERE id=?').get(runId)?.question === null;
         this.sourceMap = new Map([...sync.context, ...sync.items].map(item => [(0, normalize_1.sourceKey)(item), item]));
         this.primary = new Set(sync.items.map(normalize_1.sourceKey));
         if (this.primary.size !== sync.items.length)
             throw new Error('Duplicate canonical source IDs in snapshot');
     }
-    stage(stage) {
+    /** Hashes of the validated outputs consumed by this background build. */
+    cacheReceipt() { return [...this.cacheHashes]; }
+    stage(stage, detail) {
         if (this.signal.aborted)
-            throw new store_1.HttpError(409, 'Generation cancelled');
-        this.db.prepare('UPDATE sync_runs SET stage = ? WHERE id = ?').run(stage, this.runId);
+            throw new errors_1.HttpError(409, 'Generation cancelled');
+        // Background accounting must never retain session titles, paths or model prose.
+        const label = !this.background && detail ? `${stage}: ${detail}` : stage;
+        this.db.prepare(`UPDATE ${this.runTable} SET stage = ? WHERE id = ?`).run(label, this.runId);
     }
     async call(payload, system, final = false) {
+        if (this.background && final)
+            throw new errors_1.HttpError(409, 'Background preparation cannot call the final provider');
         if (this.signal.aborted)
-            throw new store_1.HttpError(409, 'Generation cancelled');
+            throw new errors_1.HttpError(409, 'Generation cancelled');
         const model = final ? this.sync.models.final : this.sync.models.summary;
         const large = !final && (0, summary_budget_1.isBatchSummaryModel)(model);
         const prompt = JSON.stringify(payload);
         const estimatedTokens = (0, summary_budget_1.promptTokens)(prompt, system);
         if (large && estimatedTokens > summary_budget_1.LUNA_BATCH.requestTokens)
-            throw new store_1.HttpError(400, 'Summary request exceeds its token safety budget; cached work is intact.');
+            throw new errors_1.HttpError(400, 'Summary request exceeds its token safety budget; cached work is intact.');
         if (final && (0, summary_budget_1.isBatchSummaryModel)(this.sync.models.summary) && estimatedTokens > summary_budget_1.LUNA_BATCH.finalTokens)
-            throw new store_1.HttpError(400, 'The final input exceeds its compact token budget; no larger or more expensive request was substituted. Cached summaries are intact.');
-        // Reserve one invocation for the final verdict. Retries count against the same ceiling.
-        const limit = this.sync.models.max_invocations - (final ? 0 : 1);
+            throw new errors_1.HttpError(400, 'The final input exceeds its compact token budget; no larger or more expensive request was substituted. Cached summaries are intact.');
+        const limit = this.sync.models.max_invocations - (final || this.background ? 0 : 1);
         const started = Date.now(), request = payload;
         const pending = { started_at: new Date(started).toISOString(), task: request.task || 'unknown', stage: request.stage || null,
             repair: Boolean(request.repair), model, elapsed_ms: 0, input_characters: prompt.length, input_tokens_estimate: estimatedTokens,
             output_characters: null, output_tokens_estimate: null, status: 'running' };
         // Reserve budget and the timestamped metadata slot atomically. An interrupted
         // request remains explicitly unpriced rather than disappearing from usage.
-        const claimed = this.db.prepare(`UPDATE sync_runs SET invocations=invocations+1,
+        const claimed = this.db.prepare(`UPDATE ${this.runTable} SET invocations=invocations+1,
       metrics_json=json_insert(metrics_json,'$[#]',json(?)) WHERE id=? AND invocations<?
       RETURNING json_array_length(metrics_json)-1 AS metric_index`).get(JSON.stringify(pending), this.runId, limit);
         if (!claimed)
-            throw new store_1.HttpError(409, 'Invocation budget reached. Completed summaries are cached. Raise the limit and retry; nothing was marked covered.');
+            throw new errors_1.HttpError(409, 'Invocation budget reached. Completed summaries are cached. Raise the limit and retry; nothing was marked covered.');
         let response;
         let accounting;
         try {
             response = await (0, pi_1.invokePi)(prompt, { model, system, signal: this.signal, thinking: final ? 'medium' : 'off', largeSummary: large,
                 onAccounting: this.accountAggregation ? value => { accounting = value; } : undefined });
+            if (this.signal.aborted)
+                throw new errors_1.HttpError(409, 'Generation cancelled');
             return response;
         }
         finally {
@@ -224,12 +260,14 @@ class SummaryTree {
                 elapsed_ms: Date.now() - started, input_characters: prompt.length,
                 input_tokens_estimate: estimatedTokens, output_characters: response?.length ?? null,
                 output_tokens_estimate: response === undefined ? null : (0, summary_budget_1.summaryTokens)(response),
-                status: response !== undefined ? 'completed' : this.signal.aborted ? 'cancelled' : 'failed' };
+                status: this.signal.aborted ? 'cancelled' : response !== undefined ? 'completed' : 'failed' };
             // Metadata only: no prompts, rejected prose, source text, paths or credentials.
-            this.db.prepare('UPDATE sync_runs SET metrics_json=json_set(metrics_json,?,json(?)) WHERE id=?').run(`$[${claimed.metric_index}]`, JSON.stringify(metric), this.runId);
+            this.db.prepare(`UPDATE ${this.runTable} SET metrics_json=json_set(metrics_json,?,json(?)) WHERE id=?`).run(`$[${claimed.metric_index}]`, JSON.stringify(metric), this.runId);
         }
     }
     register(spec) {
+        if (this.background)
+            return;
         this.db.prepare(`INSERT OR IGNORE INTO sync_tree_nodes(sync_id, key, kind, label, children_json, source_count)
       VALUES (?, ?, ?, ?, ?, ?)`).run(this.sync.id, spec.key, spec.kind, spec.label, JSON.stringify(spec.children), spec.sources.length);
     }
@@ -248,13 +286,22 @@ class SummaryTree {
     async node(spec, validate, derived) {
         this.register(spec);
         const limits = spec.batch ? BATCH_OUTPUT : LEGACY_OUTPUT;
-        const setStatus = (status, error = '') => this.db.prepare('UPDATE sync_tree_nodes SET status = ?, error = ? WHERE sync_id = ? AND key = ?').run(status, error, this.sync.id, spec.key);
+        const setStatus = (status, error = '') => {
+            if (!this.background)
+                this.db.prepare('UPDATE sync_tree_nodes SET status = ?, error = ? WHERE sync_id = ? AND key = ?').run(status, error, this.sync.id, spec.key);
+        };
         const finish = (cached) => {
+            if (this.background) {
+                const row = this.db.prepare('SELECT output_json FROM summary_cache WHERE key=?').get(spec.key);
+                if (!row)
+                    throw new Error('A validated summary cache entry disappeared');
+                this.cacheHashes.set(spec.key, (0, normalize_1.digest)(row.output_json));
+            }
             setStatus(cached ? 'cached' : 'done');
-            this.db.prepare('UPDATE sync_runs SET cache_hits = cache_hits + ?, processed_entries = processed_entries + ? WHERE id = ?')
+            this.db.prepare(`UPDATE ${this.runTable} SET cache_hits = cache_hits + ?, processed_entries = processed_entries + ? WHERE id = ?`)
                 .run(Number(cached), spec.kind === 'chunk' ? spec.sources.length : 0, this.runId);
         };
-        this.stage(`${spec.kind}: ${spec.label}`);
+        this.stage(spec.kind, spec.label);
         for (const cacheKey of [spec.key, spec.legacyKey].filter((key) => Boolean(key))) {
             const cache = this.db.prepare('SELECT output_json FROM summary_cache WHERE key = ?').get(cacheKey);
             if (!cache)
@@ -287,7 +334,7 @@ class SummaryTree {
                 let parsed;
                 for (let attempt = 0; attempt < 2; attempt++) {
                     if (attempt)
-                        this.stage(`Repairing ${spec.kind}: ${spec.label} (attempt 2 of 2)`);
+                        this.stage(`Repairing ${spec.kind}`, `${spec.label} (attempt 2 of 2)`);
                     const citationRepair = attempt > 0 && citationCandidate !== undefined;
                     const response = await this.call({ task: citationRepair ? 'repair_summary_citations' : spec.kind === 'topics' ? 'group_topics' : 'summarize', stage: spec.kind,
                         input: wire.input,
@@ -307,11 +354,11 @@ class SummaryTree {
                     }
                 }
                 if (parsed === undefined)
-                    throw new store_1.HttpError(502, `Summary validation failed: ${validationError}. Valid chunks are cached for retry.`);
+                    throw new errors_1.HttpError(502, `Summary validation failed: ${validationError}. Valid chunks are cached for retry.`);
                 output = parsed;
             }
             if (this.signal.aborted)
-                throw new store_1.HttpError(409, 'Generation cancelled');
+                throw new errors_1.HttpError(409, 'Generation cancelled');
             this.db.prepare(`INSERT OR REPLACE INTO summary_cache(key, kind, model, prompt_version, output_json, created_at)
         VALUES (?, ?, ?, ?, ?, ?)`).run(spec.key, spec.kind, this.sync.models.summary, spec.batch ? summary_budget_1.LUNA_BATCH.version : PROMPT_VERSION, JSON.stringify(output), new Date().toISOString());
             finish(false);
@@ -376,7 +423,7 @@ class SummaryTree {
             next.push({ key: spec.key, kind, label: spec.label, sources, summary });
         }
         if (nodes.length > 1 && next.length >= nodes.length)
-            throw new store_1.HttpError(400, 'Summaries did not fit a merge. No input was discarded.');
+            throw new errors_1.HttpError(400, 'Summaries did not fit a merge. No input was discarded.');
         return next;
     }
     async reduce(nodes, kind, label) {
@@ -405,13 +452,13 @@ class SummaryTree {
         let current = [], tokens = 0, bytes = 0;
         for (const item of items) {
             if (this.signal.aborted)
-                throw new store_1.HttpError(409, 'Generation cancelled');
+                throw new errors_1.HttpError(409, 'Generation cancelled');
             const json = JSON.stringify(body(item));
             // Per-item overhead covers delimiters and the separate allowed-ID list.
             // The complete wire request is checked again before invoking the model.
             const count = (0, summary_budget_1.summaryTokens)(json) + 32, size = Buffer.byteLength(json) + 64;
             if (count > summary_budget_1.LUNA_BATCH.inputTokens || size > summary_budget_1.LUNA_BATCH.inputBytes)
-                throw new store_1.HttpError(400, 'One summary input exceeds the token/byte budget; no evidence was dropped.');
+                throw new errors_1.HttpError(400, 'One summary input exceeds the token/byte budget; no evidence was dropped.');
             if (current.length && (tokens + count > summary_budget_1.LUNA_BATCH.inputTokens || bytes + size > summary_budget_1.LUNA_BATCH.inputBytes || current.length >= summary_budget_1.LUNA_BATCH.entries)) {
                 batches.push(current);
                 current = [];
@@ -439,18 +486,33 @@ class SummaryTree {
                 const first = positions.get((0, normalize_1.sourceKey)(batch[0]));
                 const background = first ? items.slice(Math.max(0, first - 2), first).map(item => sourceData(item, true))
                     : this.sync.context.filter(item => item.session_id === session).slice(-6).map(item => sourceData(item, true));
-                // No sync ID, E-reference or display ordinal in the cache key.
                 const input = { session, workspace: batch[0].cwd, evidence: batch.map(item => sourceData(item)), background };
                 const allowed = new Set([...input.evidence, ...background].map(item => item.id));
-                const wire = (0, references_1.prepareModelInput)('chunk', input, allowed);
-                const prompt = JSON.stringify({ task: 'summarize', stage: 'chunk', allowed_source_ids: [...wire.allowed], input: wire.input });
-                if ((0, summary_budget_1.promptTokens)(prompt, batchSummarySystem) > summary_budget_1.LUNA_BATCH.plannedRequestTokens ||
-                    Buffer.byteLength(prompt) + Buffer.byteLength(batchSummarySystem) > summary_budget_1.LUNA_BATCH.inputBytes) {
-                    if (batch.length === 1)
-                        throw new store_1.HttpError(400, 'One entry and its background exceed the summary budget; no evidence was dropped.');
-                    const middle = Math.ceil(batch.length / 2);
-                    append(batch.slice(0, middle));
-                    append(batch.slice(middle));
+                const fits = (length) => {
+                    const prefix = { ...input, evidence: input.evidence.slice(0, length) };
+                    const refs = new Set([...prefix.evidence, ...background].map(item => item.id));
+                    const wire = (0, references_1.prepareModelInput)('chunk', prefix, refs);
+                    const prompt = JSON.stringify({ task: 'summarize', stage: 'chunk', allowed_source_ids: [...wire.allowed], input: wire.input });
+                    return (0, summary_budget_1.promptTokens)(prompt, batchSummarySystem) <= summary_budget_1.LUNA_BATCH.plannedRequestTokens &&
+                        Buffer.byteLength(prompt) + Buffer.byteLength(batchSummarySystem) <= summary_budget_1.LUNA_BATCH.inputBytes;
+                };
+                if (!fits(batch.length)) {
+                    if (!fits(1))
+                        throw new errors_1.HttpError(400, 'One entry and its background exceed the summary budget; no evidence was dropped.');
+                    // Never bisect by the current tail length: its midpoint moves when
+                    // history is appended, invalidating completed large leaves. Fill a
+                    // deterministic prefix instead, then plan the remainder with its
+                    // own adjacent evidence. Existing unsplit keys remain unchanged.
+                    let low = 1, high = batch.length;
+                    while (low + 1 < high) {
+                        const middle = Math.floor((low + high) / 2);
+                        if (fits(middle))
+                            low = middle;
+                        else
+                            high = middle;
+                    }
+                    append(batch.slice(0, low));
+                    append(batch.slice(low));
                     return;
                 }
                 result.push(this.spec('chunk', `${batch[0].session_name || batch[0].cwd} · batch ${first + 1}–${first + batch.length}`, input, allowed, batch.map(normalize_1.sourceKey), [], true));
@@ -498,24 +560,22 @@ class SummaryTree {
         const missing = specs.filter(spec => !this.cached(spec)).length;
         // A lower bound: reconciliation may add calls, or reuse a cached parent.
         // Do not reject an all-cached tree that only needs its reserved final slot.
-        const minimum = missing + 1;
+        const minimum = missing + (this.background ? 0 : 1);
         if (minimum > this.sync.models.max_invocations)
-            throw new store_1.HttpError(409, `At least ${minimum} invocations are needed for uncached batches and the verdict, before any uncached reconciliation. Raise the invocation limit; no model calls have been made.`);
+            throw new errors_1.HttpError(409, `At least ${minimum} invocations are needed for uncached batches${this.background ? '' : ' and the verdict'}, before any uncached reconciliation. Raise the invocation limit; no model calls have been made.`);
         let nodes = [];
         for (const spec of specs)
             nodes.push({ key: spec.key, kind: 'chunk', label: spec.label, sources: spec.sources,
                 summary: await this.node(spec, (value, refs) => validateSummary(value, refs, spec.batch ? BATCH_OUTPUT : LEGACY_OUTPUT)) });
-        const processed = this.db.prepare('SELECT processed_entries FROM sync_runs WHERE id=?').get(this.runId).processed_entries;
+        const processed = this.db.prepare(`SELECT processed_entries FROM ${this.runTable} WHERE id=?`).get(this.runId).processed_entries;
         if (processed !== this.sync.items.length)
             throw new Error('Incomplete source coverage: refusing to generate a final verdict');
-        // One global Luna reconciliation instead of session merges → routing →
-        // topic merges. Add a level only when the combined input exceeds a budget.
         for (let depth = 0; nodes.length > 1; depth++) {
             if (depth > 20)
                 throw new Error('Summary tree depth exceeded');
             const groups = this.tokenBatches(nodes, node => this.mergePayload([node], true));
             if (groups.length >= nodes.length)
-                throw new store_1.HttpError(400, 'Summaries cannot be safely reconciled within the input budget. Cached results are intact.');
+                throw new errors_1.HttpError(400, 'Summaries cannot be safely reconciled within the input budget. Cached results are intact.');
             const next = [];
             for (const [index, group] of groups.entries())
                 next.push(group.length === 1 ? group[0] : await this.reconcileBatch(group, `Global reconciliation ${depth + 1} · part ${index + 1}`));
@@ -527,8 +587,8 @@ class SummaryTree {
         if (nodes.length && !this.compactRoots(nodes))
             nodes = [await this.reconcileBatch(nodes, 'Compact final input', true)];
         if (!this.compactRoots(nodes))
-            throw new store_1.HttpError(400, 'The reconciled summary cannot fit the compact final budget. Cached results remain inspectable; no evidence was marked reviewed.');
-        this.stage('Final verdict');
+            throw new errors_1.HttpError(400, 'The reconciled summary cannot fit the compact final budget. Cached results remain inspectable; no evidence was marked reviewed.');
+        this.stage(this.background ? 'Summaries prepared' : 'Final verdict');
         return nodes;
     }
     async build() {
@@ -536,9 +596,10 @@ class SummaryTree {
             return this.buildBatched();
         // Unknown/operator-selected models retain their established conservative limits.
         const specs = this.chunkSpecs();
-        const missing = [...specs.values()].flat().filter(spec => !this.db.prepare('SELECT 1 FROM summary_cache WHERE key = ? OR key = ?').get(spec.key, spec.legacyKey || spec.key)).length;
-        if (missing + 1 > this.sync.models.max_invocations)
-            throw new store_1.HttpError(409, `At least ${missing + 1} invocations are needed just for uncached chunks and the verdict, before merges. Raise the invocation limit; no model calls have been made.`);
+        const missing = [...specs.values()].flat().filter(spec => !this.cached(spec)).length;
+        const minimum = missing + (this.background ? 0 : 1);
+        if (minimum > this.sync.models.max_invocations)
+            throw new errors_1.HttpError(409, `At least ${minimum} invocations are needed just for uncached chunks${this.background ? '' : ' and the verdict'}, before merges. Raise the invocation limit; no model calls have been made.`);
         const sessionRoots = [];
         // Deliberately serial for predictable quotas/cancellation. Cached nodes are instant.
         for (const [session, chunks] of specs) {
@@ -547,7 +608,7 @@ class SummaryTree {
                 nodes.push({ key: spec.key, kind: 'chunk', label: spec.label, sources: spec.sources, summary: await this.node(spec, validateSummary) });
             sessionRoots.push(await this.reduce(nodes, 'session', `Session ${session.slice(0, 8)}`));
         }
-        const processed = this.db.prepare('SELECT processed_entries FROM sync_runs WHERE id = ?').get(this.runId).processed_entries;
+        const processed = this.db.prepare(`SELECT processed_entries FROM ${this.runTable} WHERE id = ?`).get(this.runId).processed_entries;
         if (processed !== this.sync.items.length)
             throw new Error('Incomplete source coverage: refusing to generate a final verdict');
         const descriptors = sessionRoots.flatMap(node => node.summary.observations.map((observation, index) => ({
@@ -571,7 +632,6 @@ class SummaryTree {
         const topics = [];
         for (const group of topicGroups.values()) {
             const members = group.members.map(id => descriptorMap.get(id));
-            // Input observations have been partitioned exactly once by validateGroups.
             const pieces = members.map(item => ({ ...item.node, key: item.id,
                 summary: { observations: [item.observation], limitations: item.node.summary.limitations } }));
             const chunks = pack(pieces, item => JSON.stringify(this.mergePayload([item])).length, MERGE_CHARS, 12);
@@ -594,7 +654,7 @@ class SummaryTree {
                 throw new Error('Cross-topic tree depth exceeded');
             roots = await this.mergeLevel(roots, 'overview', `Cross-topic reconciliation ${depth + 1}`);
         }
-        this.stage('Final verdict');
+        this.stage(this.background ? 'Summaries prepared' : 'Final verdict');
         return roots;
     }
     // Final verification records supply roles/session/sequence once per distinct