@petepetrash/circuit 0.1.0

package/dist/app/history/memory-effect.js

@@ -0,0 +1,234 @@
+import { join } from 'node:path';
+import { HISTORY_AUTHORITY_NOTICE, HistoryMemoryEffectV1, } from '../../schemas/index.js';
+import { writeJsonAtomic } from '../../shared/atomic-io.js';
+import { isFailureOutcome } from '../../shared/outcome.js';
+import { HISTORY_MEMORY_EFFECT_FILE } from './indexer.js';
+import { buildMemoryMergeReport } from './memory-merge.js';
+// The conservative, honesty-preserving defaults (Slice 2 D3/D5). MIN_ARM_SIZE is
+// the floor distinguishing "literally one observation" from "a minimal repeated
+// signal", not a claim of statistical adequacy. MARGIN must clear a near-unanimous
+// split at the floor, so correlated_* is reachable only by a clean separation.
+export const DEFAULT_MIN_ARM_SIZE = 2;
+export const DEFAULT_MARGIN = 0.5;
+// The Slice 1 group_key for a linkage input: content_id when content-addressed,
+// else the unresolved:<memory_input_id> fallback. Re-derived here (the linkage
+// does not persist group_key) using the exact rule Slice 1's grouper used, so a
+// cohort partitions on group_key — keeping distinct unhashed source docs distinct
+// rather than merging every null-content item of a flow into one bucket.
+function groupKeyOf(input) {
+    return input.content_id ?? `unresolved:${input.memory_input_id}`;
+}
+function groupsUsedBy(linkage) {
+    return new Set(linkage.memory_inputs.map(groupKeyOf));
+}
+// Build one arm from a run set. Each run counts once (deduped by run_id). Rates
+// are exact count/size; an empty arm carries rate 0 and empty arrays.
+function buildArm(runs) {
+    const outcomeByRun = new Map();
+    for (const run of runs)
+        outcomeByRun.set(run.run_id, run.outcome);
+    let complete = 0;
+    let adverse = 0;
+    let neutral = 0;
+    const counts = new Map();
+    for (const outcome of outcomeByRun.values()) {
+        counts.set(outcome, (counts.get(outcome) ?? 0) + 1);
+        if (outcome === 'complete')
+            complete += 1;
+        else if (isFailureOutcome(outcome))
+            adverse += 1;
+        else
+            neutral += 1; // needs_attention | handoff — counted, neither success nor failure
+    }
+    const size = outcomeByRun.size;
+    const outcomeCounts = [...counts.entries()]
+        .map(([outcome, count]) => ({ outcome, count }))
+        .sort((left, right) => left.outcome.localeCompare(right.outcome));
+    return {
+        run_ids: [...outcomeByRun.keys()].sort(),
+        size,
+        complete_count: complete,
+        adverse_count: adverse,
+        neutral_count: neutral,
+        outcome_counts: outcomeCounts,
+        complete_rate: size === 0 ? 0 : complete / size,
+        adverse_rate: size === 0 ? 0 : adverse / size,
+    };
+}
+function fixed(value) {
+    return value.toFixed(2);
+}
+// The D5 verdict rule, self-contained and unit-testable in isolation. minArmSize
+// is an explicit parameter (not a closed-over free variable). Evaluated in strict
+// precedence order, so the result is a single enum value with no ambiguity.
+export function classifyEffect(comparison, margin, minArmSize) {
+    const { used_arm, comparable_arm, complete_rate_delta, adverse_rate_delta } = comparison;
+    if (used_arm.size < minArmSize || comparable_arm.size < minArmSize) {
+        return {
+            effect_status: 'not_enough_data',
+            effect_note: `min_arm_size gate: used arm (n=${used_arm.size}) or comparable arm (n=${comparable_arm.size}) is below the minimum arm size of ${minArmSize}; a verdict requires both arms to reach the floor.`,
+        };
+    }
+    if (complete_rate_delta >= margin && adverse_rate_delta <= 0) {
+        return {
+            effect_status: 'correlated_positive',
+            effect_note: `correlated_positive: the used arm closed complete ${fixed(complete_rate_delta)} more often (>= margin ${fixed(margin)}) and was no worse on aborts (adverse delta ${fixed(adverse_rate_delta)} <= 0).`,
+        };
+    }
+    if (complete_rate_delta <= -margin || adverse_rate_delta >= margin) {
+        return {
+            effect_status: 'correlated_negative',
+            effect_note: `correlated_negative: the used arm closed complete ${fixed(complete_rate_delta)} (<= -margin ${fixed(margin)}) or aborted ${fixed(adverse_rate_delta)} more (>= margin ${fixed(margin)}).`,
+        };
+    }
+    return {
+        effect_status: 'unresolved',
+        effect_note: `unresolved: both arms reached the floor of ${minArmSize}, but the separation (complete delta ${fixed(complete_rate_delta)}, adverse delta ${fixed(adverse_rate_delta)}) is within the margin ${fixed(margin)}.`,
+    };
+}
+function buildComparison(usedArm, comparableArm, margin, minArmSize) {
+    const completeRateDelta = usedArm.complete_rate - comparableArm.complete_rate;
+    const adverseRateDelta = usedArm.adverse_rate - comparableArm.adverse_rate;
+    const { effect_status, effect_note } = classifyEffect({
+        used_arm: usedArm,
+        comparable_arm: comparableArm,
+        complete_rate_delta: completeRateDelta,
+        adverse_rate_delta: adverseRateDelta,
+    }, margin, minArmSize);
+    return {
+        used_arm: usedArm,
+        comparable_arm: comparableArm,
+        complete_rate_delta: completeRateDelta,
+        adverse_rate_delta: adverseRateDelta,
+        effect_status,
+        effect_note,
+    };
+}
+function countStatus(statuses, status) {
+    return statuses.filter((value) => value === status).length;
+}
+// The pure core. Builds (group_key, flow_id) cohorts and per-flow on/off cohorts
+// from merge.linkages, classifies each via the D5 rule, rolls up the summary, and
+// carries merge.warnings forward. No I/O. generated_at/runs_base are taken from
+// the merge report so the effect report shares the merge's logical timestamp.
+export function aggregateMemoryEffect(merge, gates) {
+    if (!(gates.margin > 0 && gates.margin <= 1)) {
+        throw new Error(`margin must satisfy 0 < margin <= 1 (received ${gates.margin})`);
+    }
+    if (!(Number.isInteger(gates.minArmSize) && gates.minArmSize >= 1)) {
+        throw new Error(`minArmSize must be an integer >= 1 (received ${gates.minArmSize})`);
+    }
+    // Group every linkage by its (narrowed) flow_id. A linkage missing flow_id is
+    // skipped — a compile-time guard for the schema-optional field that the real
+    // Slice 1 reader never trips (it always derives a flow_id), so it emits no
+    // user-facing warning (an unreachable warning would be dead branch dressing).
+    const runsByFlow = new Map();
+    for (const linkage of merge.linkages) {
+        const flowId = linkage.flow_id;
+        if (flowId === undefined)
+            continue;
+        const bucket = runsByFlow.get(flowId);
+        if (bucket === undefined)
+            runsByFlow.set(flowId, [linkage]);
+        else
+            bucket.push(linkage);
+    }
+    // Enrichment lookup: group_key -> representative kind/source_ref/content_id from
+    // the Slice 1 memory_items (every used group has an item there).
+    const enrichment = new Map();
+    for (const item of merge.memory_items) {
+        enrichment.set(item.group_key, {
+            content_id: item.content_id,
+            ...(item.kind === undefined ? {} : { kind: item.kind }),
+            ...(item.source_ref === undefined ? {} : { source_ref: item.source_ref }),
+        });
+    }
+    // Enumerate the (group_key, flow_id) cohorts: every group used by >=1 run of a
+    // flow. Keyed with a NUL separator so the two parts cannot collide.
+    const cohorts = new Map();
+    for (const linkage of merge.linkages) {
+        const flowId = linkage.flow_id;
+        if (flowId === undefined || !linkage.memory_used)
+            continue;
+        for (const input of linkage.memory_inputs) {
+            const groupKey = groupKeyOf(input);
+            cohorts.set(`${groupKey}\u0000${flowId}`, { groupKey, flowId });
+        }
+    }
+    const itemEffects = [];
+    for (const { groupKey, flowId } of cohorts.values()) {
+        const flowRuns = runsByFlow.get(flowId) ?? [];
+        const usedRuns = flowRuns.filter((run) => groupsUsedBy(run).has(groupKey));
+        const comparableRuns = flowRuns.filter((run) => !groupsUsedBy(run).has(groupKey));
+        const comparison = buildComparison(buildArm(usedRuns), buildArm(comparableRuns), gates.margin, gates.minArmSize);
+        const enr = enrichment.get(groupKey);
+        const contentId = enr ? enr.content_id : groupKey.startsWith('unresolved:') ? null : groupKey;
+        itemEffects.push({
+            content_id: contentId,
+            group_key: groupKey,
+            flow_id: flowId,
+            ...(enr?.kind === undefined ? {} : { kind: enr.kind }),
+            ...(enr?.source_ref === undefined ? {} : { source_ref: enr.source_ref }),
+            comparison,
+        });
+    }
+    itemEffects.sort((left, right) => left.group_key.localeCompare(right.group_key) || left.flow_id.localeCompare(right.flow_id));
+    const flowContrasts = [];
+    for (const [flowId, flowRuns] of [...runsByFlow.entries()].sort((left, right) => left[0].localeCompare(right[0]))) {
+        const onRuns = flowRuns.filter((run) => run.memory_used);
+        if (onRuns.length === 0)
+            continue;
+        const offRuns = flowRuns.filter((run) => !run.memory_used);
+        const comparison = buildComparison(buildArm(onRuns), buildArm(offRuns), gates.margin, gates.minArmSize);
+        flowContrasts.push({ flow_id: flowId, comparison });
+    }
+    const itemStatuses = itemEffects.map((item) => item.comparison.effect_status);
+    const contrastStatuses = flowContrasts.map((contrast) => contrast.comparison.effect_status);
+    return HistoryMemoryEffectV1.parse({
+        api_version: 'history-memory-effect-v1',
+        schema_version: 1,
+        generated_at: merge.generated_at,
+        runs_base: merge.runs_base,
+        authority_notice: HISTORY_AUTHORITY_NOTICE,
+        min_arm_size: gates.minArmSize,
+        margin: gates.margin,
+        source_run_count: merge.run_count,
+        source_envelope_count: merge.envelope_count,
+        source_memory_run_count: merge.memory_run_count,
+        item_effects: itemEffects,
+        flow_contrasts: flowContrasts,
+        summary: {
+            items_total: itemEffects.length,
+            items_not_enough_data: countStatus(itemStatuses, 'not_enough_data'),
+            items_unresolved: countStatus(itemStatuses, 'unresolved'),
+            items_correlated_positive: countStatus(itemStatuses, 'correlated_positive'),
+            items_correlated_negative: countStatus(itemStatuses, 'correlated_negative'),
+            flow_contrasts_total: flowContrasts.length,
+            flow_contrasts_not_enough_data: countStatus(contrastStatuses, 'not_enough_data'),
+            flow_contrasts_unresolved: countStatus(contrastStatuses, 'unresolved'),
+            flow_contrasts_correlated_positive: countStatus(contrastStatuses, 'correlated_positive'),
+            flow_contrasts_correlated_negative: countStatus(contrastStatuses, 'correlated_negative'),
+        },
+        warnings: merge.warnings,
+    });
+}
+// Rebuild the Slice 1 merge report in-process and aggregate it, so a stale or
+// absent persisted memory-merge.v1.json cannot desync the two reports.
+export function buildMemoryEffectReport(options = {}) {
+    const { minArmSize, margin, ...mergeOptions } = options;
+    const merge = buildMemoryMergeReport(mergeOptions);
+    return aggregateMemoryEffect(merge, {
+        minArmSize: minArmSize ?? DEFAULT_MIN_ARM_SIZE,
+        margin: margin ?? DEFAULT_MARGIN,
+    });
+}
+// Persist under <index-dir>/memory-effect.v1.json (atomic tmp+rename, re-parsed
+// to validate before the rename commits) — identical discipline to Slice 1.
+export function writeMemoryEffectReport(report, paths) {
+    const outPath = join(paths.indexDir, HISTORY_MEMORY_EFFECT_FILE);
+    writeJsonAtomic(outPath, report, {
+        validate: (raw) => HistoryMemoryEffectV1.parse(JSON.parse(raw)),
+    });
+    return outPath;
+}
+//# sourceMappingURL=memory-effect.js.map

package/dist/app/history/memory-effect.js.map

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

package/dist/app/history/memory-identity.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryInputV0 } from '../../schemas/index.js';
+export declare function contentIdentityOf(memory: MemoryInputV0): {
+    readonly contentId: string | null;
+    readonly unhashedSource: boolean;
+};
+export declare function groupKeyForMemory(memory: MemoryInputV0): string;
+//# sourceMappingURL=memory-identity.d.ts.map

package/dist/app/history/memory-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-identity.d.ts","sourceRoot":"","sources":["../../../src/app/history/memory-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAuB5D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC,CAOA;AAOD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAG/D"}

package/dist/app/history/memory-identity.js

@@ -0,0 +1,39 @@
+import { sha256Hex } from '../../shared/connector-relay.js';
+// The content-addressed, run-independent identity of a memory item, shared by the
+// Slice 1 merge reader and the Slice 3/4 injection/pull gates so the cross-run
+// join key cannot drift between producer and consumer (a contract test pins
+// parity). It hashes only the cited source artifact (kind, path, content sha),
+// deliberately excluding run_id / flow_id / step_id and the run-scoped memory_id
+// string, so two runs that recalled the same source artifact share one
+// content_id.
+//
+// When no content hash is available we return null rather than hashing the path
+// alone. contentSha is source.ref.sha256 ?? source.sha256; we reach the null
+// branch only when both are absent. A path alone (e.g. a trace ref's
+// trace.ndjson#sequence=5) is identical across runs, so hashing it without a
+// content sha would falsely conflate genuinely distinct artifacts into one
+// cross-run group. Content-bearing ref kinds (report, evidence, ...) are
+// schema-required to carry ref.sha256 and so are always content-addressed; a
+// hashless kind reaches the null branch unless it independently carries
+// source.sha256.
+//
+// This computation must stay STABLE: changing the hash basis silently re-buckets
+// every cross-run comparison.
+export function contentIdentityOf(memory) {
+    const contentSha = memory.source.ref.sha256 ?? memory.source.sha256 ?? null;
+    if (contentSha === null) {
+        return { contentId: null, unhashedSource: true };
+    }
+    const basis = JSON.stringify([memory.source.ref.kind, memory.source.ref.ref, contentSha]);
+    return { contentId: `mem-c-${sha256Hex(basis).slice(0, 16)}`, unhashedSource: false };
+}
+// The Slice 1/2/3/4 grouping key: content_id when content-addressed, else the
+// unresolved:<memory_id> fallback. memory_id is source-doc-scoped (stable across
+// recalling runs), so two same-flow runs recalling the same unhashed source doc
+// share one unresolved group. Centralized here so every consumer forms the key
+// identically.
+export function groupKeyForMemory(memory) {
+    const { contentId } = contentIdentityOf(memory);
+    return contentId ?? `unresolved:${memory.memory_id}`;
+}
+//# sourceMappingURL=memory-identity.js.map

package/dist/app/history/memory-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-identity.js","sourceRoot":"","sources":["../../../src/app/history/memory-identity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAE5D,kFAAkF;AAClF,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,iFAAiF;AACjF,uEAAuE;AACvE,cAAc;AACd,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAC7E,qEAAqE;AACrE,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,6EAA6E;AAC7E,wEAAwE;AACxE,iBAAiB;AACjB,EAAE;AACF,iFAAiF;AACjF,8BAA8B;AAC9B,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IAIrD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;IAC5E,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;IAC1F,OAAO,EAAE,SAAS,EAAE,SAAS,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;AACxF,CAAC;AAED,8EAA8E;AAC9E,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,eAAe;AACf,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,MAAM,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,SAAS,IAAI,cAAc,MAAM,CAAC,SAAS,EAAE,CAAC;AACvD,CAAC"}

package/dist/app/history/memory-merge.d.ts

@@ -0,0 +1,16 @@
+import { type HistoryMemoryMergeV1 as HistoryMemoryMerge, type HistoryWarningV1, MemoryMergeRunLinkageV1 } from '../../schemas/index.js';
+import { type HistoryPathOptions, type HistoryPaths } from './indexer.js';
+declare const RUN_ENVELOPE_RELATIVE_PATH = "reports/run-envelope.json";
+declare const RECALL_REPORT_RELATIVE_PATH = "reports/history/recall.json";
+export interface BuildMemoryMergeReportOptions extends HistoryPathOptions {
+    readonly now?: () => Date;
+}
+export interface RunMemoryLinkageResult {
+    readonly linkage?: MemoryMergeRunLinkageV1;
+    readonly warnings: readonly HistoryWarningV1[];
+}
+export declare function extractRunMemoryLinkage(runFolder: string): RunMemoryLinkageResult;
+export declare function buildMemoryMergeReport(options?: BuildMemoryMergeReportOptions): HistoryMemoryMerge;
+export declare function writeMemoryMergeReport(report: HistoryMemoryMerge, paths: HistoryPaths): string;
+export { RUN_ENVELOPE_RELATIVE_PATH, RECALL_REPORT_RELATIVE_PATH };
+//# sourceMappingURL=memory-merge.d.ts.map

package/dist/app/history/memory-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-merge.d.ts","sourceRoot":"","sources":["../../../src/app/history/memory-merge.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,oBAAoB,IAAI,kBAAkB,EAG/C,KAAK,gBAAgB,EAIrB,uBAAuB,EAGxB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAGlB,MAAM,cAAc,CAAC;AAQtB,QAAA,MAAM,0BAA0B,8BAA8B,CAAC;AAC/D,QAAA,MAAM,2BAA2B,gCAAgC,CAAC;AAKlE,MAAM,WAAW,6BAA8B,SAAQ,kBAAkB;IACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAChD;AAwFD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB,CAmDjF;AAgED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,6BAAkC,GAC1C,kBAAkB,CA2BpB;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAM9F;AAED,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/app/history/memory-merge.js

@@ -0,0 +1,224 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { HISTORY_AUTHORITY_NOTICE, HistoryMemoryMergeV1, HistoryRecallReportV1, MemoryMergeRunLinkageV1, RunEnvelopeRecord, } from '../../schemas/index.js';
+import { writeJsonAtomic } from '../../shared/atomic-io.js';
+import { isFailureOutcome } from '../../shared/outcome.js';
+import { HISTORY_MEMORY_MERGE_FILE, listCandidateRunFolders, resolveHistoryPaths, } from './indexer.js';
+import { contentIdentityOf } from './memory-identity.js';
+// Stable on-disk contract paths. Held as local constants rather than imported
+// from the run-envelope / run-start-recall modules so this reader does not
+// couple to the in-flight architecture-hardening file layout. The design's rule
+// is "target stable contracts, not current file locations"; a contract test
+// asserts these equal the canonical exports so any drift is caught loudly.
+const RUN_ENVELOPE_RELATIVE_PATH = 'reports/run-envelope.json';
+const RECALL_REPORT_RELATIVE_PATH = 'reports/history/recall.json';
+const EFFECT_NOTE = 'Report-only linkage (Slice 1). Effect requires cross-run aggregation over comparable runs (Slice 2).';
+// The content-addressed, run-independent identity now lives in
+// ./memory-identity.ts (contentIdentityOf) so the Slice 3/4 injection and pull
+// gates compute the exact same content_id; a parity contract test pins it.
+// Best-effort objective signals honestly retrievable from the envelope today:
+// the binary-ish outcome (recorded by the caller) and an abort reason from the
+// first blocked/failed attempt. Token counts and elapsed time are not captured
+// anywhere today, so they are deliberately omitted rather than faked.
+function deriveAbortReason(envelope) {
+    const attempt = envelope.process_attempts.find((entry) => isFailureOutcome(entry.outcome));
+    if (attempt === undefined)
+        return undefined;
+    return attempt.blocked_reason ?? attempt.summary;
+}
+function readRecallInputs(runFolder, warnings) {
+    const recallPath = join(runFolder, RECALL_REPORT_RELATIVE_PATH);
+    if (!existsSync(recallPath)) {
+        warnings.push({
+            code: 'recall_report_missing',
+            message: 'memory was used but no recall report was found; content identity is unavailable',
+            run_folder: runFolder,
+            source_path: RECALL_REPORT_RELATIVE_PATH,
+        });
+        return undefined;
+    }
+    try {
+        const recall = HistoryRecallReportV1.parse(JSON.parse(readFileSync(recallPath, 'utf8')));
+        return new Map(recall.memory_inputs.map((memory) => [memory.memory_id, memory]));
+    }
+    catch (error) {
+        warnings.push({
+            code: 'source_invalid',
+            message: `recall report unreadable: ${error instanceof Error ? error.message : String(error)}`,
+            run_folder: runFolder,
+            source_path: RECALL_REPORT_RELATIVE_PATH,
+        });
+        return undefined;
+    }
+}
+function resolveInput(memoryInputId, recallInputs, runFolder, warnings) {
+    const memory = recallInputs?.get(memoryInputId);
+    if (memory === undefined) {
+        // Distinguish "recall unavailable" (already warned at the file level) from
+        // "recall present but this id is absent" — the latter is a real linkage gap
+        // (e.g. a recall report capped after the envelope recorded the id set), so
+        // surface it loudly rather than emitting a silent null.
+        if (recallInputs !== undefined) {
+            warnings.push({
+                code: 'memory_input_unmatched',
+                message: `memory ${memoryInputId} is absent from the recall report; content identity is unavailable`,
+                run_folder: runFolder,
+                source_path: RECALL_REPORT_RELATIVE_PATH,
+            });
+        }
+        return { memory_input_id: memoryInputId, content_id: null, resolved_from_recall: false };
+    }
+    const { contentId, unhashedSource } = contentIdentityOf(memory);
+    if (unhashedSource) {
+        warnings.push({
+            code: 'content_id_unhashed_source',
+            message: `memory ${memoryInputId} cites a source with no content hash; it cannot be content-addressed`,
+            run_folder: runFolder,
+            source_path: RECALL_REPORT_RELATIVE_PATH,
+        });
+    }
+    return {
+        memory_input_id: memoryInputId,
+        content_id: contentId,
+        kind: memory.kind,
+        source_ref: memory.source.ref,
+        staleness: memory.staleness.status,
+        resolved_from_recall: true,
+    };
+}
+// Read one completed run folder and produce its linkage row. Returns no linkage
+// (only warnings) when the folder has no readable run.envelope@v0 record — that
+// is the resume / non-source-run coverage gap, surfaced as a warning.
+export function extractRunMemoryLinkage(runFolder) {
+    const warnings = [];
+    const envelopePath = join(runFolder, RUN_ENVELOPE_RELATIVE_PATH);
+    if (!existsSync(envelopePath)) {
+        warnings.push({
+            code: 'envelope_missing',
+            message: 'no run.envelope@v0 record (resume or non-source run); skipped from linkage',
+            run_folder: runFolder,
+            source_path: RUN_ENVELOPE_RELATIVE_PATH,
+        });
+        return { warnings };
+    }
+    let envelope;
+    try {
+        envelope = RunEnvelopeRecord.parse(JSON.parse(readFileSync(envelopePath, 'utf8')));
+    }
+    catch (error) {
+        warnings.push({
+            code: 'source_invalid',
+            message: `run envelope unreadable: ${error instanceof Error ? error.message : String(error)}`,
+            run_folder: runFolder,
+            source_path: RUN_ENVELOPE_RELATIVE_PATH,
+        });
+        return { warnings };
+    }
+    const memoryUsed = envelope.memory_context.used;
+    const memoryInputIds = envelope.memory_context.memory_input_ids;
+    // Only read the recall report when there is something to resolve, so a
+    // memory-used-but-no-ids run does not raise a spurious missing-recall warning.
+    const recallInputs = memoryUsed && memoryInputIds.length > 0 ? readRecallInputs(runFolder, warnings) : undefined;
+    const memoryInputs = memoryUsed
+        ? memoryInputIds.map((id) => resolveInput(id, recallInputs, runFolder, warnings))
+        : [];
+    const flowId = envelope.process_attempts[0]?.process_id ??
+        envelope.process_plan.planned_attempts[0]?.process_id;
+    const abortReason = deriveAbortReason(envelope);
+    const linkage = MemoryMergeRunLinkageV1.parse({
+        run_id: envelope.run_id,
+        ...(flowId === undefined ? {} : { flow_id: flowId }),
+        operator_intent: envelope.operator_intent,
+        outcome: envelope.outcome,
+        ...(abortReason === undefined ? {} : { abort_reason: abortReason }),
+        memory_used: memoryUsed,
+        memory_inputs: memoryInputs,
+    });
+    return { linkage, warnings };
+}
+function groupMemoryItems(linkages) {
+    const accumulators = new Map();
+    for (const linkage of linkages) {
+        if (!linkage.memory_used)
+            continue;
+        for (const input of linkage.memory_inputs) {
+            const groupKey = input.content_id ?? `unresolved:${input.memory_input_id}`;
+            let acc = accumulators.get(groupKey);
+            if (acc === undefined) {
+                acc = {
+                    group_key: groupKey,
+                    content_id: input.content_id,
+                    ...(input.kind === undefined ? {} : { kind: input.kind }),
+                    ...(input.source_ref === undefined ? {} : { source_ref: input.source_ref }),
+                    memory_input_ids: new Set(),
+                    runOutcomes: new Map(),
+                };
+                accumulators.set(groupKey, acc);
+            }
+            acc.memory_input_ids.add(input.memory_input_id);
+            acc.runOutcomes.set(linkage.run_id, linkage.outcome);
+        }
+    }
+    const items = [];
+    for (const acc of accumulators.values()) {
+        const counts = new Map();
+        for (const outcome of acc.runOutcomes.values()) {
+            counts.set(outcome, (counts.get(outcome) ?? 0) + 1);
+        }
+        items.push({
+            group_key: acc.group_key,
+            content_id: acc.content_id,
+            memory_input_ids: [...acc.memory_input_ids].sort(),
+            ...(acc.kind === undefined ? {} : { kind: acc.kind }),
+            ...(acc.source_ref === undefined ? {} : { source_ref: acc.source_ref }),
+            used_by_run_ids: [...acc.runOutcomes.keys()].sort(),
+            outcome_counts: [...counts.entries()]
+                .map(([outcome, count]) => ({ outcome, count }))
+                .sort((left, right) => left.outcome.localeCompare(right.outcome)),
+            effect_status: 'not_enough_data',
+            effect_note: EFFECT_NOTE,
+        });
+    }
+    return items.sort((left, right) => left.group_key.localeCompare(right.group_key));
+}
+// Scan every completed run folder under runs_base and assemble the cross-run,
+// report-only memory-merge artifact. Throws HistoryCommandError if runs_base is
+// missing or unreadable (consistent with the rest of the history surface).
+export function buildMemoryMergeReport(options = {}) {
+    const paths = resolveHistoryPaths(options);
+    const now = options.now ?? (() => new Date());
+    const runFolders = listCandidateRunFolders(paths.runsBase);
+    const linkages = [];
+    const warnings = [];
+    for (const runFolder of runFolders) {
+        const result = extractRunMemoryLinkage(runFolder);
+        warnings.push(...result.warnings);
+        if (result.linkage !== undefined)
+            linkages.push(result.linkage);
+    }
+    linkages.sort((left, right) => left.run_id.localeCompare(right.run_id));
+    return HistoryMemoryMergeV1.parse({
+        api_version: 'history-memory-merge-v1',
+        schema_version: 1,
+        generated_at: now().toISOString(),
+        runs_base: paths.runsBase,
+        authority_notice: HISTORY_AUTHORITY_NOTICE,
+        run_count: runFolders.length,
+        envelope_count: linkages.length,
+        memory_run_count: linkages.filter((linkage) => linkage.memory_used).length,
+        linkages,
+        memory_items: groupMemoryItems(linkages),
+        warnings,
+    });
+}
+// Persist a report under <index-dir>/memory-merge.v1.json (atomic tmp+rename,
+// re-parsed to validate before the rename commits).
+export function writeMemoryMergeReport(report, paths) {
+    const outPath = join(paths.indexDir, HISTORY_MEMORY_MERGE_FILE);
+    writeJsonAtomic(outPath, report, {
+        validate: (raw) => HistoryMemoryMergeV1.parse(JSON.parse(raw)),
+    });
+    return outPath;
+}
+export { RUN_ENVELOPE_RELATIVE_PATH, RECALL_REPORT_RELATIVE_PATH };
+//# sourceMappingURL=memory-merge.js.map

package/dist/app/history/memory-merge.js.map

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

package/dist/app/history/memory-preview.d.ts

@@ -0,0 +1,10 @@
+import { type HistoryMemoryInputPreviewV1 as HistoryMemoryInputPreview, type HistoryQueryHitV1 as HistoryQueryHit, type HistoryWarningV1 } from '../../schemas/index.js';
+export declare function historyMemoryInputPreview(input: {
+    readonly query: string;
+    readonly indexState: 'fresh' | 'possibly_stale';
+    readonly rebuilt: boolean;
+    readonly warnings: readonly HistoryWarningV1[];
+    readonly hits: readonly HistoryQueryHit[];
+    readonly capturedAt?: string;
+}): HistoryMemoryInputPreview;
+//# sourceMappingURL=memory-preview.d.ts.map

package/dist/app/history/memory-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-preview.d.ts","sourceRoot":"","sources":["../../../src/app/history/memory-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,IAAI,yBAAyB,EAE7D,KAAK,iBAAiB,IAAI,eAAe,EACzC,KAAK,gBAAgB,EAEtB,MAAM,wBAAwB,CAAC;AAuChC,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,yBAAyB,CAkE5B"}