@remnic/core 1.1.12 → 1.1.13

package/dist/bootstrap.d.ts

@@ -1,13 +1,15 @@
 import { PluginConfig } from './types.js';
-import { O as Orchestrator } from './orchestrator-DDMPqU6R.js';
+import { O as Orchestrator } from './orchestrator-DuWl9Hwx.js';
 import './index-DJ9QWMw-.js';
 import './buffer.js';
 import './storage.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-CY8TU40w.js';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
+import './runtime/better-sqlite.js';
 import 'better-sqlite3';
-import './port-B6VEDIkC.js';
+import './search/port.js';
 import './transcript.js';
 import './session-integrity.js';
 import './summarizer.js';
@@ -24,10 +26,23 @@ import './memory-provenance.js';
 import './user-model.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-consolidation-ByBXb-sf.js';
-import './codex-materialize-CQlLTzke.js';
+import './semantic-VwGI14Ok.js';
+import './replay/types.js';
+import './lcm/engine.js';
+import './lcm/archive.js';
+import './lcm/summarizer.js';
+import './lcm/dag.js';
+import './lcm/queue.js';
+import './semantic-consolidation-4HkHWgeI.js';
+import './connectors/codex-materialize.js';
 import './logger.js';
+import './conversation-index/backend.js';
+import './conversation-index/chunker.js';
+import './faiss-adapter-CzPghc4C.js';
+import './runtime/child-process.js';
+import './shared-context/manager.js';
 import 'zod';
+import './compounding/engine.js';
 import './policy-runtime.js';
 import './profiling.js';
 

package/dist/boxes.d.ts

@@ -59,7 +59,11 @@ declare class BoxBuilder {
     private cfg;
     private openBox;
     private stateLoaded;
+    private openBoxMutationChain;
+    private traceMutationChain;
     constructor(baseDir: string, cfg: BoxBuilderConfig);
+    private enqueueOpenBoxMutation;
+    private enqueueTraceMutation;
     private get boxBaseDir();
     private get stateDir();
     private get openBoxStatePath();
@@ -73,17 +77,20 @@ declare class BoxBuilder {
      * Decides whether to seal the current open box and/or start a new one.
      */
     onExtraction(event: ExtractionEvent): Promise<void>;
+    private onExtractionUnlocked;
     private newBox;
     /**
      * Seal the current open box and write it to disk.
      * Also runs trace weaving if enabled.
      */
     sealCurrent(reason: SealReason): Promise<string | null>;
+    private sealCurrentUnlocked;
     /**
      * Find an existing trace that matches box topics, or create a new trace.
      * Returns the traceId to assign to this box.
      */
     private resolveTrace;
+    private resolveTraceUnlocked;
     /**
      * Read all sealed boxes from the last N days for recall injection.
      */

package/dist/boxes.js

@@ -3,7 +3,7 @@ import {
   BoxBuilder,
   parseBoxFrontmatter,
   topicOverlapScore
-} from "./chunk-URB2WSKZ.js";
+} from "./chunk-NZL6GGQE.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/briefing.d.ts

@@ -2,9 +2,11 @@ import { StorageManager } from './storage.js';
 import { BriefingSections, BriefingFollowup, BriefingFocus, CalendarSource, CalendarEvent, MemoryFile, BriefingActiveThread, BriefingResult, EntityFile, BriefingRecentEntity } from './types.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-CY8TU40w.js';
-import 'better-sqlite3';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
 import './index-DJ9QWMw-.js';
+import './runtime/better-sqlite.js';
+import 'better-sqlite3';
 
 /**
  * Daily Context Briefing (Issue #370)
@@ -29,7 +31,7 @@ declare const BRIEFING_FORMAT_ALLOWED: readonly ["markdown", "json"];
  * Default model used for the Responses API follow-up generation call.
  * Mirrors the extraction engine default in config.ts — keep in sync.
  */
-declare const BRIEFING_FOLLOWUP_DEFAULT_MODEL = "gpt-5.2";
+declare const BRIEFING_FOLLOWUP_DEFAULT_MODEL = "gpt-5.5";
 type BriefingFormatValue = typeof BRIEFING_FORMAT_ALLOWED[number];
 /**
  * Validate a user-supplied `--format` flag value.

package/dist/briefing.js

@@ -16,22 +16,25 @@ import {
   renderBriefingMarkdown,
   resolveBriefingSaveDir,
   validateBriefingFormat
-} from "./chunk-ZVTKDVVM.js";
-import "./chunk-3B6KIRBH.js";
+} from "./chunk-VW676BEI.js";
+import "./chunk-7AAT6G4Q.js";
+import "./chunk-5UZXUTVO.js";
 import "./chunk-YNJHCGDT.js";
+import "./chunk-P7FMDTKL.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-23ZZK64Y.js";
+import "./chunk-Q7P4WJDP.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-XJKFSSDW.js";
+import "./chunk-3KW65B36.js";
+import "./chunk-3HPAPHUK.js";
 import "./chunk-PFV5C235.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
-import "./chunk-MARWOCVP.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-XIG5PDM7.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-PZ5AY32C.js";

package/dist/buffer-surprise-report.js

@@ -1,6 +1,6 @@
 import {
   reportBufferSurpriseDistribution
-} from "./chunk-ASAITVLA.js";
+} from "./chunk-YBPYIAA5.js";
 import "./chunk-PZ5AY32C.js";
 export {
   reportBufferSurpriseDistribution

package/dist/buffer.d.ts

@@ -2,11 +2,17 @@ import { StorageManager } from './storage.js';
 import { PluginConfig, BufferTurn } from './types.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './memory-projection-store-CY8TU40w.js';
-import 'better-sqlite3';
+import './memory-projection-store.js';
+import './maintenance/memory-governance.js';
 import './index-DJ9QWMw-.js';
+import './runtime/better-sqlite.js';
+import 'better-sqlite3';
 
 type TriggerDecision = "extract_now" | "extract_batch" | "keep_buffering";
+interface AddTurnOutcome {
+    decision: TriggerDecision;
+    extractionTurns?: BufferTurn[];
+}
 /**
  * Optional surprise probe injected into `SmartBuffer`.
  *
@@ -34,7 +40,9 @@ declare class SmartBuffer {
     private readonly storage;
     private state;
     private loaded;
+    private loadPromise;
     private readonly surpriseProbe;
+    private mutationChain;
     /**
      * Serialized write chain for `BUFFER_SURPRISE` telemetry events.
      *
@@ -51,11 +59,13 @@ declare class SmartBuffer {
      */
     private surpriseTelemetryWriteChain;
     constructor(config: PluginConfig, storage: StorageManager, surpriseProbe?: BufferSurpriseProbe | null);
+    private enqueueMutation;
     private entryFor;
     private peekEntry;
     private normalizeState;
     private entryActivityAt;
     private pruneEntries;
+    private loadUnlocked;
     load(): Promise<void>;
     /**
      * Reset the buffer to an empty, usable state.
@@ -63,8 +73,12 @@ declare class SmartBuffer {
      * so the buffer can still accept new turns for the rest of the session.
      */
     resetToEmpty(): void;
+    private saveUnlocked;
     save(): Promise<void>;
     addTurn(bufferKey: string, turn: BufferTurn): Promise<TriggerDecision>;
+    addTurnWithOutcome(bufferKey: string, turn: BufferTurn): Promise<AddTurnOutcome>;
+    private recordTurnUnlocked;
+    private getExtractionTurnsIfTurnSnapshotStillCurrent;
     /**
      * Enqueue a telemetry append on the serialized write chain.
      *
@@ -115,7 +129,7 @@ declare class SmartBuffer {
     getRetainedDeferredTurns(bufferKey?: string): BufferTurn[];
     findBufferKeyForSession(sessionKey: string): Promise<string | null>;
     findBufferKeysForSession(sessionKey: string): Promise<string[]>;
-    clearAfterExtraction(bufferKey?: string): Promise<void>;
+    clearAfterExtraction(bufferKey?: string, extractedTurns?: readonly BufferTurn[]): Promise<void>;
     getExtractionCount(bufferKey?: string): number;
     /**
      * Await any pending `BUFFER_SURPRISE` telemetry writes.
@@ -132,4 +146,4 @@ declare class SmartBuffer {
     flushSurpriseTelemetry(): Promise<void>;
 }
 
-export { type BufferSurpriseProbe, SmartBuffer, type TriggerDecision };
+export { type AddTurnOutcome, type BufferSurpriseProbe, SmartBuffer, type TriggerDecision };

package/dist/buffer.js

@@ -1,6 +1,6 @@
 import {
   SmartBuffer
-} from "./chunk-JBMSGZEQ.js";
+} from "./chunk-5RGLBDQF.js";
 import "./chunk-XYIK4LF6.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";

package/dist/calibration.js

@@ -1,13 +1,13 @@
 import {
   FallbackLlmClient
-} from "./chunk-AQJNPMOA.js";
-import "./chunk-PH4C2U43.js";
+} from "./chunk-DINWEURR.js";
+import "./chunk-FLTNHQK6.js";
 import "./chunk-7SI52C65.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-UZB5KHKX.js";
 import "./chunk-RK6F44Y6.js";
-import "./chunk-IXEJRKCZ.js";
-import "./chunk-MARWOCVP.js";
+import "./chunk-QRNI5JBH.js";
+import "./chunk-XIG5PDM7.js";
 import {
   log
 } from "./chunk-2ODBA7MQ.js";

package/dist/capsule-cli.d.ts

@@ -55,15 +55,15 @@ declare function parseCapsuleSince(raw: unknown): string | undefined;
  */
 declare function parseCapsuleIncludeKinds(raw: unknown): string[] | undefined;
 /**
- * Parse a comma-separated `--peers` value into an array of peer ids.
+ * Parse a comma-separated peer id value into an array of peer ids.
  */
-declare function parseCapsulePeers(raw: unknown): string[] | undefined;
+declare function parseCapsulePeers(raw: unknown, optionName?: string): string[] | undefined;
 interface CapsuleExportOptions {
     name: string;
-    out: string | undefined;
+    outDir: string | undefined;
     since: string | undefined;
     includeKinds: string[] | undefined;
-    peers: string[] | undefined;
+    peerIds: string[] | undefined;
 }
 interface CapsuleImportOptions {
     archive: string;

package/dist/capsule-cli.js

@@ -13,7 +13,7 @@ import {
   parseCapsuleSince,
   renderCapsuleInspect,
   renderCapsuleList
-} from "./chunk-74EMIVE4.js";
+} from "./chunk-ZY2MNJR6.js";
 import "./chunk-PZ5AY32C.js";
 export {
   defaultCapsulesDir,

package/dist/capsule-crypto-5CYAGVC5.js

@@ -0,0 +1,18 @@
+import {
+  decryptCapsuleFile,
+  decryptCapsuleFileInMemory,
+  encryptCapsuleFile,
+  isEncryptedCapsuleFile
+} from "./chunk-KNKUID7G.js";
+import "./chunk-BJMBJZ2Y.js";
+import "./chunk-UKJAGEXH.js";
+import "./chunk-FP2373TW.js";
+import "./chunk-A6XUJE5D.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  decryptCapsuleFile,
+  decryptCapsuleFileInMemory,
+  encryptCapsuleFile,
+  isEncryptedCapsuleFile
+};
+//# sourceMappingURL=capsule-crypto-5CYAGVC5.js.map

package/dist/capsule-merge-4MGKE7C5.js

@@ -0,0 +1,189 @@
+import {
+  createVersion
+} from "./chunk-FAAFWE4G.js";
+import {
+  parseExportBundle
+} from "./chunk-WEHSQBFR.js";
+import {
+  assertIsDirectoryNotSymlink,
+  assertRealpathInsideRoot,
+  fromPosixRelPath,
+  isPathInsideRoot,
+  sha256String
+} from "./chunk-AGZQD76C.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/transfer/capsule-merge.ts
+import { lstat, mkdir, readFile, realpath, stat, writeFile } from "fs/promises";
+import path from "path";
+import { gunzipSync } from "zlib";
+async function mergeCapsule(opts) {
+  const archiveAbs = path.resolve(opts.sourceArchive);
+  const rootAbs = path.resolve(opts.targetRoot);
+  await assertIsDirectoryNotSymlink(rootAbs, "mergeCapsule", "targetRoot");
+  const conflictMode = opts.conflictMode ?? "skip-conflicts";
+  if (conflictMode !== "skip-conflicts" && conflictMode !== "prefer-source" && conflictMode !== "prefer-local") {
+    throw new Error(
+      `mergeCapsule: unknown conflictMode ${JSON.stringify(conflictMode)}; expected "skip-conflicts", "prefer-source", or "prefer-local"`
+    );
+  }
+  const raw = await readFile(archiveAbs);
+  let json;
+  try {
+    json = gunzipSync(raw).toString("utf-8");
+  } catch (cause) {
+    throw new Error(
+      `mergeCapsule: archive is not a valid gzip file: ${archiveAbs}`,
+      { cause }
+    );
+  }
+  let parsedJson;
+  try {
+    parsedJson = JSON.parse(json);
+  } catch (cause) {
+    throw new Error(
+      `mergeCapsule: archive is not valid JSON after gunzip: ${archiveAbs}`,
+      { cause }
+    );
+  }
+  const parsed = parseExportBundle(parsedJson);
+  if (parsed.capsuleVersion !== 2) {
+    throw new Error(
+      "mergeCapsule: archive is V1; only V2 capsule archives are supported"
+    );
+  }
+  const bundle = parsed.bundle;
+  const manifest = bundle.manifest;
+  const capsule = manifest.capsule;
+  const manifestIndex = /* @__PURE__ */ new Map();
+  for (const f of manifest.files) {
+    manifestIndex.set(f.path, f);
+  }
+  if (manifestIndex.size !== manifest.files.length) {
+    throw new Error("mergeCapsule: manifest contains duplicate file paths");
+  }
+  const recordPaths = /* @__PURE__ */ new Set();
+  for (const rec of bundle.records) {
+    if (recordPaths.has(rec.path)) {
+      throw new Error(
+        `mergeCapsule: bundle contains duplicate record path: ${rec.path}`
+      );
+    }
+    recordPaths.add(rec.path);
+  }
+  const rootReal = await realpath(rootAbs).catch(() => rootAbs);
+  const seenTargetPaths = /* @__PURE__ */ new Map();
+  for (const rec of bundle.records) {
+    const entry = manifestIndex.get(rec.path);
+    if (!entry) {
+      throw new Error(
+        `mergeCapsule: archive checksum mismatch (record without manifest entry: ${rec.path})`
+      );
+    }
+    const { sha256, bytes } = sha256String(rec.content);
+    if (sha256 !== entry.sha256 || bytes !== entry.bytes) {
+      throw new Error(
+        `mergeCapsule: archive checksum mismatch for ${rec.path}: expected sha256=${entry.sha256} bytes=${entry.bytes}, got sha256=${sha256} bytes=${bytes}`
+      );
+    }
+    if (rec.path.includes("\\")) {
+      throw new Error(
+        `mergeCapsule: record path contains backslash separators (Windows-style paths are not allowed): ${rec.path}`
+      );
+    }
+    const posixNormalized = path.posix.normalize(rec.path);
+    if (rec.path.startsWith("/") || rec.path.split("/").some((seg) => seg === "..") || posixNormalized.startsWith("..") || posixNormalized.startsWith("/")) {
+      throw new Error(
+        `mergeCapsule: record path escapes target root: ${rec.path}`
+      );
+    }
+    const targetAbs = path.join(rootReal, fromPosixRelPath(rec.path));
+    if (!isPathInsideRoot(rootReal, targetAbs)) {
+      throw new Error(
+        `mergeCapsule: record path escapes target root: ${rec.path}`
+      );
+    }
+    await assertRealpathInsideRoot(rootReal, targetAbs, rec.path, "mergeCapsule");
+    const targetLstat = await lstat(targetAbs).catch(() => null);
+    if (targetLstat !== null && targetLstat.isSymbolicLink()) {
+      throw new Error(
+        `mergeCapsule: record target is a symlink and cannot be written to safely: ${rec.path}`
+      );
+    }
+    const dedupKey = targetAbs.toLowerCase();
+    const firstSourcePath = seenTargetPaths.get(dedupKey);
+    if (firstSourcePath !== void 0) {
+      throw new Error(
+        `mergeCapsule: manifest contains two entries that resolve to the same target path: "${firstSourcePath}" and "${rec.path}" both map to "${rec.path}"`
+      );
+    }
+    seenTargetPaths.set(dedupKey, rec.path);
+  }
+  for (const f of manifest.files) {
+    if (!recordPaths.has(f.path)) {
+      throw new Error(
+        `mergeCapsule: archive checksum mismatch (manifest entry without record: ${f.path})`
+      );
+    }
+  }
+  const merged = [];
+  const skipped = [];
+  const conflicts = [];
+  const sortedRecords = [...bundle.records].sort(
+    (a, b) => a.path.localeCompare(b.path)
+  );
+  for (const rec of sortedRecords) {
+    const targetAbs = path.join(rootReal, fromPosixRelPath(rec.path));
+    const entry = manifestIndex.get(rec.path);
+    const localContent = await readLocalFile(targetAbs);
+    if (localContent === null) {
+      await mkdir(path.dirname(targetAbs), { recursive: true });
+      await writeFile(targetAbs, rec.content, "utf-8");
+      merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted: false });
+      continue;
+    }
+    const { sha256: localSha256 } = sha256String(localContent);
+    if (localSha256 === entry.sha256) {
+      skipped.push({ path: rec.path, reason: "identical" });
+      continue;
+    }
+    const { sha256: archiveSha256 } = sha256String(rec.content);
+    conflicts.push({
+      path: rec.path,
+      archiveSha256,
+      localSha256
+    });
+    if (conflictMode === "skip-conflicts" || conflictMode === "prefer-local") {
+      skipped.push({ path: rec.path, reason: "conflict" });
+      continue;
+    }
+    let snapshotted = false;
+    if (opts.versioning && opts.versioning.enabled) {
+      await createVersion(
+        targetAbs,
+        localContent,
+        "manual",
+        opts.versioning,
+        opts.log,
+        `capsule-merge: ${capsule.id}`,
+        rootReal
+      );
+      snapshotted = true;
+    }
+    await writeFile(targetAbs, rec.content, "utf-8");
+    merged.push({ sourcePath: rec.path, targetPath: rec.path, snapshotted });
+  }
+  merged.sort((a, b) => a.sourcePath.localeCompare(b.sourcePath));
+  skipped.sort((a, b) => a.path.localeCompare(b.path));
+  conflicts.sort((a, b) => a.path.localeCompare(b.path));
+  return { merged, skipped, conflicts, manifest };
+}
+async function readLocalFile(absPath) {
+  const st = await stat(absPath).catch(() => null);
+  if (!st || !st.isFile()) return null;
+  return readFile(absPath, "utf-8");
+}
+export {
+  mergeCapsule
+};
+//# sourceMappingURL=capsule-merge-4MGKE7C5.js.map

package/dist/causal-behavior.d.ts

@@ -1,35 +1,15 @@
 import { CausalChainIndex } from './causal-chain.js';
-import { MemoryCategory } from './types.js';
+import { ConsolidatedPreference } from './compounding/preference-consolidator.js';
 import './causal-trajectory.js';
 import './objective-state.js';
+import './types.js';
 import './index-DJ9QWMw-.js';
-
-/**
- * preference-consolidator.ts — IRC Preference Consolidation for Engram
- *
- * Post-extraction pass that synthesizes preference and correction memories
- * into explicit preference statements. These statements are formatted to
- * match the expected answer patterns in memory benchmarks (e.g., LongMemEval)
- * and provide clear behavioral context during recall.
- *
- * The key insight: Engram extracts preferences as factual statements like
- * "The user uses Adobe Premiere Pro for video editing." But benchmarks
- * expect preference statements like "The user would prefer resources
- * specifically tailored to Adobe Premiere Pro." This module bridges that gap.
- */
-
-interface ConsolidatedPreference {
-    /** Synthesized preference statement */
-    statement: string;
-    /** Source memory IDs */
-    sourceIds: string[];
-    /** Category of the source memories */
-    category: MemoryCategory;
-    /** Confidence (max of sources) */
-    confidence: number;
-    /** Keywords for matching during recall */
-    keywords: string[];
-}
+import './lcm/engine.js';
+import './lcm/archive.js';
+import 'better-sqlite3';
+import './lcm/summarizer.js';
+import './lcm/dag.js';
+import './lcm/queue.js';
 
 /**
  * causal-behavior.ts — CMC Phase 4: Implicit Behavioral Preference Learning

package/dist/causal-behavior.js

@@ -1,8 +1,11 @@
 import {
   readChainIndex,
   resolveChainsDir
-} from "./chunk-XMHBH5H6.js";
-import "./chunk-URB2WSKZ.js";
+} from "./chunk-VLXA6PI2.js";
+import "./chunk-NZL6GGQE.js";
+import {
+  resolveCausalTrajectoryStoreDir
+} from "./chunk-MY6TPVXW.js";
 import {
   normalizeRecallTokens
 } from "./chunk-DT5TVLJE.js";
@@ -155,7 +158,7 @@ function computeCausalImpactScore(memoryId, chainIndex) {
 async function extractCausalBehaviorSignals(options) {
   try {
     const { memoryDir, causalTrajectoryStoreDir, config: behaviorConfig } = options;
-    const root = causalTrajectoryStoreDir ? path.join(memoryDir, causalTrajectoryStoreDir) : path.join(memoryDir, "state", "causal-trajectories");
+    const root = resolveCausalTrajectoryStoreDir(memoryDir, causalTrajectoryStoreDir);
     const trajectoriesDir = path.join(root, "trajectories");
     const files = await listJsonFiles(trajectoriesDir).catch(() => []);
     const trajectories = [];

package/dist/causal-behavior.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/causal-behavior.ts"],"sourcesContent":["/**\n * causal-behavior.ts — CMC Phase 4: Implicit Behavioral Preference Learning\n *\n * Extracts behavioral signals from causal chain analysis. Unlike explicit\n * preference extraction (which reads text), this derives preferences from\n * patterns of action: what goals recur, what actions succeed repeatedly,\n * what outcomes are consistently pursued.\n *\n * Key insight: \"Preferences are recurring causal pathways.\"\n */\n\nimport type { CausalTrajectoryRecord } from \"./causal-trajectory.js\";\nimport type { CausalChainIndex } from \"./causal-chain.js\";\nimport { readChainIndex, resolveChainsDir } from \"./causal-chain.js\";\nimport { normalizeRecallTokens } from \"./recall-tokenization.js\";\nimport { topicOverlapScore } from \"./boxes.js\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport type { ConsolidatedPreference } from \"./compounding/preference-consolidator.js\";\nimport path from \"node:path\";\nimport { log } from \"./logger.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport type CausalBehaviorSignalType =\n  | \"topic_revisitation\"\n  | \"action_pattern\"\n  | \"outcome_preference\"\n  | \"phrasing_style\";\n\nexport interface CausalBehaviorSignal {\n  signalType: CausalBehaviorSignalType;\n  pattern: string;\n  frequency: number;\n  sessionCount: number;\n  confidence: number;\n  trajectoryIds: string[];\n}\n\nexport interface BehaviorConfig {\n  minFrequency: number;\n  minSessions: number;\n  confidenceThreshold: number;\n}\n\n// ─── Signal Extraction ───────────────────────────────────────────────────────\n\n/**\n * Detect topic revisitation: same goal fingerprint appearing in 3+ sessions.\n */\nfunction detectTopicRevisitation(\n  trajectories: CausalTrajectoryRecord[],\n  config: BehaviorConfig,\n): CausalBehaviorSignal[] {\n  const goalGroups = new Map<string, { sessions: Set<string>; trajectoryIds: string[]; goal: string }>();\n\n  for (const t of trajectories) {\n    const tokens = normalizeRecallTokens(t.goal, []).sort().join(\" \");\n    if (!tokens) continue;\n    const group = goalGroups.get(tokens) ?? { sessions: new Set(), trajectoryIds: [], goal: t.goal };\n    group.sessions.add(t.sessionKey);\n    group.trajectoryIds.push(t.trajectoryId);\n    goalGroups.set(tokens, group);\n  }\n\n  const signals: CausalBehaviorSignal[] = [];\n  for (const [_key, group] of goalGroups) {\n    if (group.trajectoryIds.length < config.minFrequency) continue;\n    if (group.sessions.size < config.minSessions) continue;\n\n    signals.push({\n      signalType: \"topic_revisitation\",\n      pattern: group.goal,\n      frequency: group.trajectoryIds.length,\n      sessionCount: group.sessions.size,\n      confidence: Math.min(1, 0.5 + (group.sessions.size / 10)),\n      trajectoryIds: group.trajectoryIds.slice(0, 10),\n    });\n  }\n\n  return signals;\n}\n\n/**\n * Detect action patterns: same action with >= 80% success rate, 4+ occurrences.\n */\nfunction detectActionPatterns(\n  trajectories: CausalTrajectoryRecord[],\n  config: BehaviorConfig,\n): CausalBehaviorSignal[] {\n  const actionGroups = new Map<string, {\n    sessions: Set<string>;\n    trajectoryIds: string[];\n    action: string;\n    successCount: number;\n    totalCount: number;\n  }>();\n\n  for (const t of trajectories) {\n    const tokens = normalizeRecallTokens(t.actionSummary, []).sort().join(\" \");\n    if (!tokens) continue;\n    const group = actionGroups.get(tokens) ?? {\n      sessions: new Set(),\n      trajectoryIds: [],\n      action: t.actionSummary,\n      successCount: 0,\n      totalCount: 0,\n    };\n    group.sessions.add(t.sessionKey);\n    group.trajectoryIds.push(t.trajectoryId);\n    group.totalCount++;\n    if (t.outcomeKind === \"success\") group.successCount++;\n    actionGroups.set(tokens, group);\n  }\n\n  const signals: CausalBehaviorSignal[] = [];\n  for (const [_key, group] of actionGroups) {\n    if (group.totalCount < Math.max(config.minFrequency, 4)) continue;\n    if (group.sessions.size < config.minSessions) continue;\n    const successRate = group.successCount / group.totalCount;\n    if (successRate < 0.8) continue;\n\n    signals.push({\n      signalType: \"action_pattern\",\n      pattern: group.action,\n      frequency: group.totalCount,\n      sessionCount: group.sessions.size,\n      confidence: Math.min(1, 0.6 + (successRate * 0.3)),\n      trajectoryIds: group.trajectoryIds.slice(0, 10),\n    });\n  }\n\n  return signals;\n}\n\n/**\n * Detect outcome preferences: consistent retry patterns leading to success.\n * When a trajectory fails and is retried (via chain edges) successfully,\n * it indicates a strong preference for that outcome.\n */\nfunction detectOutcomePreferences(\n  trajectories: CausalTrajectoryRecord[],\n  chainIndex: CausalChainIndex,\n  config: BehaviorConfig,\n): CausalBehaviorSignal[] {\n  const retrySuccesses = new Map<string, {\n    sessions: Set<string>;\n    trajectoryIds: string[];\n    goal: string;\n    count: number;\n  }>();\n\n  const trajectoryMap = new Map(trajectories.map((t) => [t.trajectoryId, t]));\n\n  for (const [edgeId, edge] of Object.entries(chainIndex.edges)) {\n    if (edge.edgeType !== \"retry\") continue;\n\n    const from = trajectoryMap.get(edge.fromTrajectoryId);\n    const to = trajectoryMap.get(edge.toTrajectoryId);\n    if (!from || !to) continue;\n    if (from.outcomeKind !== \"failure\" || to.outcomeKind !== \"success\") continue;\n\n    const goalTokens = normalizeRecallTokens(from.goal, []).sort().join(\" \");\n    const group = retrySuccesses.get(goalTokens) ?? {\n      sessions: new Set(),\n      trajectoryIds: [],\n      goal: from.goal,\n      count: 0,\n    };\n    group.sessions.add(from.sessionKey);\n    group.sessions.add(to.sessionKey);\n    group.trajectoryIds.push(from.trajectoryId, to.trajectoryId);\n    group.count++;\n    retrySuccesses.set(goalTokens, group);\n  }\n\n  const signals: CausalBehaviorSignal[] = [];\n  for (const [_key, group] of retrySuccesses) {\n    if (group.count < config.minFrequency) continue;\n    if (group.sessions.size < config.minSessions) continue;\n\n    signals.push({\n      signalType: \"outcome_preference\",\n      pattern: group.goal,\n      frequency: group.count,\n      sessionCount: group.sessions.size,\n      confidence: Math.min(1, 0.7 + (group.count / 20)),\n      trajectoryIds: [...new Set(group.trajectoryIds)].slice(0, 10),\n    });\n  }\n\n  return signals;\n}\n\n// ─── Preference Synthesis ────────────────────────────────────────────────────\n\n/**\n * Convert behavioral signals into ConsolidatedPreference entries\n * that can be merged with existing IRC preference output.\n */\nexport function synthesizeCausalPreferences(\n  signals: CausalBehaviorSignal[],\n  confidenceThreshold: number,\n): ConsolidatedPreference[] {\n  const preferences: ConsolidatedPreference[] = [];\n\n  for (const signal of signals) {\n    if (signal.confidence < confidenceThreshold) continue;\n\n    let statement: string;\n    switch (signal.signalType) {\n      case \"topic_revisitation\":\n        statement = `The user frequently works on: ${signal.pattern}. This topic has been revisited across ${signal.sessionCount} sessions.`;\n        break;\n      case \"action_pattern\":\n        statement = `The user prefers this approach: ${signal.pattern}. This action pattern has been successful ${signal.frequency} times.`;\n        break;\n      case \"outcome_preference\":\n        statement = `The user persistently pursues: ${signal.pattern}. They retry until successful, indicating strong preference.`;\n        break;\n      case \"phrasing_style\":\n        statement = `The user's phrasing pattern: ${signal.pattern}`;\n        break;\n    }\n\n    preferences.push({\n      statement,\n      sourceIds: signal.trajectoryIds.slice(0, 5),\n      category: \"preference\",\n      confidence: signal.confidence,\n      keywords: normalizeRecallTokens(signal.pattern, []).slice(0, 10),\n    });\n  }\n\n  return preferences;\n}\n\n// ─── Causal Impact Score ─────────────────────────────────────────────────────\n\n/**\n * Compute the causal impact score for a memory based on its\n * presence in causal chains. Used in lifecycle heat/decay.\n *\n * Formula: 0.1 * incomingEdges + 0.15 * outgoingEdges, clamped to [0, 0.3]\n */\nexport function computeCausalImpactScore(\n  memoryId: string,\n  chainIndex: CausalChainIndex,\n): number {\n  // Memory IDs don't directly map to trajectory IDs, but trajectory-based\n  // memories may reference their source trajectory ID. For now, check\n  // if the memoryId appears as a trajectory ID in the chain index.\n  const incoming = chainIndex.incoming[memoryId]?.length ?? 0;\n  const outgoing = chainIndex.outgoing[memoryId]?.length ?? 0;\n  const raw = 0.1 * incoming + 0.15 * outgoing;\n  return Math.min(0.3, Math.max(0, raw));\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Extract all behavioral signals from causal trajectories and chain analysis.\n */\nexport async function extractCausalBehaviorSignals(options: {\n  memoryDir: string;\n  causalTrajectoryStoreDir?: string;\n  config: BehaviorConfig;\n}): Promise<CausalBehaviorSignal[]> {\n  try {\n    const { memoryDir, causalTrajectoryStoreDir, config: behaviorConfig } = options;\n\n    // Read all trajectories\n    const root = causalTrajectoryStoreDir\n      ? path.join(memoryDir, causalTrajectoryStoreDir)\n      : path.join(memoryDir, \"state\", \"causal-trajectories\");\n    const trajectoriesDir = path.join(root, \"trajectories\");\n    const files = await listJsonFiles(trajectoriesDir).catch(() => [] as string[]);\n\n    const trajectories: CausalTrajectoryRecord[] = [];\n    for (const filePath of files) {\n      try {\n        const raw = await readJsonFile(filePath);\n        if (isRecord(raw) && typeof raw.trajectoryId === \"string\") {\n          trajectories.push(raw as unknown as CausalTrajectoryRecord);\n        }\n      } catch {\n        // skip\n      }\n    }\n\n    if (trajectories.length === 0) return [];\n\n    // Read chain index\n    const chainsDir = resolveChainsDir(memoryDir, causalTrajectoryStoreDir);\n    const chainIndex = await readChainIndex(chainsDir);\n\n    // Extract all signal types\n    const signals: CausalBehaviorSignal[] = [\n      ...detectTopicRevisitation(trajectories, behaviorConfig),\n      ...detectActionPatterns(trajectories, behaviorConfig),\n      ...detectOutcomePreferences(trajectories, chainIndex, behaviorConfig),\n    ];\n\n    log.debug(`[cmc] extracted ${signals.length} behavioral signal(s) from ${trajectories.length} trajectories`);\n    return signals;\n  } catch (error) {\n    log.warn(`[cmc] behavioral signal extraction failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/causal-behavior.ts"],"sourcesContent":["/**\n * causal-behavior.ts — CMC Phase 4: Implicit Behavioral Preference Learning\n *\n * Extracts behavioral signals from causal chain analysis. Unlike explicit\n * preference extraction (which reads text), this derives preferences from\n * patterns of action: what goals recur, what actions succeed repeatedly,\n * what outcomes are consistently pursued.\n *\n * Key insight: \"Preferences are recurring causal pathways.\"\n */\n\nimport { resolveCausalTrajectoryStoreDir, type CausalTrajectoryRecord } from \"./causal-trajectory.js\";\nimport type { CausalChainIndex } from \"./causal-chain.js\";\nimport { readChainIndex, resolveChainsDir } from \"./causal-chain.js\";\nimport { normalizeRecallTokens } from \"./recall-tokenization.js\";\nimport { topicOverlapScore } from \"./boxes.js\";\nimport { listJsonFiles, readJsonFile } from \"./json-store.js\";\nimport { isRecord } from \"./store-contract.js\";\nimport type { ConsolidatedPreference } from \"./compounding/preference-consolidator.js\";\nimport path from \"node:path\";\nimport { log } from \"./logger.js\";\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport type CausalBehaviorSignalType =\n  | \"topic_revisitation\"\n  | \"action_pattern\"\n  | \"outcome_preference\"\n  | \"phrasing_style\";\n\nexport interface CausalBehaviorSignal {\n  signalType: CausalBehaviorSignalType;\n  pattern: string;\n  frequency: number;\n  sessionCount: number;\n  confidence: number;\n  trajectoryIds: string[];\n}\n\nexport interface BehaviorConfig {\n  minFrequency: number;\n  minSessions: number;\n  confidenceThreshold: number;\n}\n\n// ─── Signal Extraction ───────────────────────────────────────────────────────\n\n/**\n * Detect topic revisitation: same goal fingerprint appearing in 3+ sessions.\n */\nfunction detectTopicRevisitation(\n  trajectories: CausalTrajectoryRecord[],\n  config: BehaviorConfig,\n): CausalBehaviorSignal[] {\n  const goalGroups = new Map<string, { sessions: Set<string>; trajectoryIds: string[]; goal: string }>();\n\n  for (const t of trajectories) {\n    const tokens = normalizeRecallTokens(t.goal, []).sort().join(\" \");\n    if (!tokens) continue;\n    const group = goalGroups.get(tokens) ?? { sessions: new Set(), trajectoryIds: [], goal: t.goal };\n    group.sessions.add(t.sessionKey);\n    group.trajectoryIds.push(t.trajectoryId);\n    goalGroups.set(tokens, group);\n  }\n\n  const signals: CausalBehaviorSignal[] = [];\n  for (const [_key, group] of goalGroups) {\n    if (group.trajectoryIds.length < config.minFrequency) continue;\n    if (group.sessions.size < config.minSessions) continue;\n\n    signals.push({\n      signalType: \"topic_revisitation\",\n      pattern: group.goal,\n      frequency: group.trajectoryIds.length,\n      sessionCount: group.sessions.size,\n      confidence: Math.min(1, 0.5 + (group.sessions.size / 10)),\n      trajectoryIds: group.trajectoryIds.slice(0, 10),\n    });\n  }\n\n  return signals;\n}\n\n/**\n * Detect action patterns: same action with >= 80% success rate, 4+ occurrences.\n */\nfunction detectActionPatterns(\n  trajectories: CausalTrajectoryRecord[],\n  config: BehaviorConfig,\n): CausalBehaviorSignal[] {\n  const actionGroups = new Map<string, {\n    sessions: Set<string>;\n    trajectoryIds: string[];\n    action: string;\n    successCount: number;\n    totalCount: number;\n  }>();\n\n  for (const t of trajectories) {\n    const tokens = normalizeRecallTokens(t.actionSummary, []).sort().join(\" \");\n    if (!tokens) continue;\n    const group = actionGroups.get(tokens) ?? {\n      sessions: new Set(),\n      trajectoryIds: [],\n      action: t.actionSummary,\n      successCount: 0,\n      totalCount: 0,\n    };\n    group.sessions.add(t.sessionKey);\n    group.trajectoryIds.push(t.trajectoryId);\n    group.totalCount++;\n    if (t.outcomeKind === \"success\") group.successCount++;\n    actionGroups.set(tokens, group);\n  }\n\n  const signals: CausalBehaviorSignal[] = [];\n  for (const [_key, group] of actionGroups) {\n    if (group.totalCount < Math.max(config.minFrequency, 4)) continue;\n    if (group.sessions.size < config.minSessions) continue;\n    const successRate = group.successCount / group.totalCount;\n    if (successRate < 0.8) continue;\n\n    signals.push({\n      signalType: \"action_pattern\",\n      pattern: group.action,\n      frequency: group.totalCount,\n      sessionCount: group.sessions.size,\n      confidence: Math.min(1, 0.6 + (successRate * 0.3)),\n      trajectoryIds: group.trajectoryIds.slice(0, 10),\n    });\n  }\n\n  return signals;\n}\n\n/**\n * Detect outcome preferences: consistent retry patterns leading to success.\n * When a trajectory fails and is retried (via chain edges) successfully,\n * it indicates a strong preference for that outcome.\n */\nfunction detectOutcomePreferences(\n  trajectories: CausalTrajectoryRecord[],\n  chainIndex: CausalChainIndex,\n  config: BehaviorConfig,\n): CausalBehaviorSignal[] {\n  const retrySuccesses = new Map<string, {\n    sessions: Set<string>;\n    trajectoryIds: string[];\n    goal: string;\n    count: number;\n  }>();\n\n  const trajectoryMap = new Map(trajectories.map((t) => [t.trajectoryId, t]));\n\n  for (const [edgeId, edge] of Object.entries(chainIndex.edges)) {\n    if (edge.edgeType !== \"retry\") continue;\n\n    const from = trajectoryMap.get(edge.fromTrajectoryId);\n    const to = trajectoryMap.get(edge.toTrajectoryId);\n    if (!from || !to) continue;\n    if (from.outcomeKind !== \"failure\" || to.outcomeKind !== \"success\") continue;\n\n    const goalTokens = normalizeRecallTokens(from.goal, []).sort().join(\" \");\n    const group = retrySuccesses.get(goalTokens) ?? {\n      sessions: new Set(),\n      trajectoryIds: [],\n      goal: from.goal,\n      count: 0,\n    };\n    group.sessions.add(from.sessionKey);\n    group.sessions.add(to.sessionKey);\n    group.trajectoryIds.push(from.trajectoryId, to.trajectoryId);\n    group.count++;\n    retrySuccesses.set(goalTokens, group);\n  }\n\n  const signals: CausalBehaviorSignal[] = [];\n  for (const [_key, group] of retrySuccesses) {\n    if (group.count < config.minFrequency) continue;\n    if (group.sessions.size < config.minSessions) continue;\n\n    signals.push({\n      signalType: \"outcome_preference\",\n      pattern: group.goal,\n      frequency: group.count,\n      sessionCount: group.sessions.size,\n      confidence: Math.min(1, 0.7 + (group.count / 20)),\n      trajectoryIds: [...new Set(group.trajectoryIds)].slice(0, 10),\n    });\n  }\n\n  return signals;\n}\n\n// ─── Preference Synthesis ────────────────────────────────────────────────────\n\n/**\n * Convert behavioral signals into ConsolidatedPreference entries\n * that can be merged with existing IRC preference output.\n */\nexport function synthesizeCausalPreferences(\n  signals: CausalBehaviorSignal[],\n  confidenceThreshold: number,\n): ConsolidatedPreference[] {\n  const preferences: ConsolidatedPreference[] = [];\n\n  for (const signal of signals) {\n    if (signal.confidence < confidenceThreshold) continue;\n\n    let statement: string;\n    switch (signal.signalType) {\n      case \"topic_revisitation\":\n        statement = `The user frequently works on: ${signal.pattern}. This topic has been revisited across ${signal.sessionCount} sessions.`;\n        break;\n      case \"action_pattern\":\n        statement = `The user prefers this approach: ${signal.pattern}. This action pattern has been successful ${signal.frequency} times.`;\n        break;\n      case \"outcome_preference\":\n        statement = `The user persistently pursues: ${signal.pattern}. They retry until successful, indicating strong preference.`;\n        break;\n      case \"phrasing_style\":\n        statement = `The user's phrasing pattern: ${signal.pattern}`;\n        break;\n    }\n\n    preferences.push({\n      statement,\n      sourceIds: signal.trajectoryIds.slice(0, 5),\n      category: \"preference\",\n      confidence: signal.confidence,\n      keywords: normalizeRecallTokens(signal.pattern, []).slice(0, 10),\n    });\n  }\n\n  return preferences;\n}\n\n// ─── Causal Impact Score ─────────────────────────────────────────────────────\n\n/**\n * Compute the causal impact score for a memory based on its\n * presence in causal chains. Used in lifecycle heat/decay.\n *\n * Formula: 0.1 * incomingEdges + 0.15 * outgoingEdges, clamped to [0, 0.3]\n */\nexport function computeCausalImpactScore(\n  memoryId: string,\n  chainIndex: CausalChainIndex,\n): number {\n  // Memory IDs don't directly map to trajectory IDs, but trajectory-based\n  // memories may reference their source trajectory ID. For now, check\n  // if the memoryId appears as a trajectory ID in the chain index.\n  const incoming = chainIndex.incoming[memoryId]?.length ?? 0;\n  const outgoing = chainIndex.outgoing[memoryId]?.length ?? 0;\n  const raw = 0.1 * incoming + 0.15 * outgoing;\n  return Math.min(0.3, Math.max(0, raw));\n}\n\n// ─── Public API ──────────────────────────────────────────────────────────────\n\n/**\n * Extract all behavioral signals from causal trajectories and chain analysis.\n */\nexport async function extractCausalBehaviorSignals(options: {\n  memoryDir: string;\n  causalTrajectoryStoreDir?: string;\n  config: BehaviorConfig;\n}): Promise<CausalBehaviorSignal[]> {\n  try {\n    const { memoryDir, causalTrajectoryStoreDir, config: behaviorConfig } = options;\n\n    // Read all trajectories\n    const root = resolveCausalTrajectoryStoreDir(memoryDir, causalTrajectoryStoreDir);\n    const trajectoriesDir = path.join(root, \"trajectories\");\n    const files = await listJsonFiles(trajectoriesDir).catch(() => [] as string[]);\n\n    const trajectories: CausalTrajectoryRecord[] = [];\n    for (const filePath of files) {\n      try {\n        const raw = await readJsonFile(filePath);\n        if (isRecord(raw) && typeof raw.trajectoryId === \"string\") {\n          trajectories.push(raw as unknown as CausalTrajectoryRecord);\n        }\n      } catch {\n        // skip\n      }\n    }\n\n    if (trajectories.length === 0) return [];\n\n    // Read chain index\n    const chainsDir = resolveChainsDir(memoryDir, causalTrajectoryStoreDir);\n    const chainIndex = await readChainIndex(chainsDir);\n\n    // Extract all signal types\n    const signals: CausalBehaviorSignal[] = [\n      ...detectTopicRevisitation(trajectories, behaviorConfig),\n      ...detectActionPatterns(trajectories, behaviorConfig),\n      ...detectOutcomePreferences(trajectories, chainIndex, behaviorConfig),\n    ];\n\n    log.debug(`[cmc] extracted ${signals.length} behavioral signal(s) from ${trajectories.length} trajectories`);\n    return signals;\n  } catch (error) {\n    log.warn(`[cmc] behavioral signal extraction failed (non-fatal): ${error instanceof Error ? error.message : String(error)}`);\n    return [];\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/causal-chain.js

@@ -6,8 +6,9 @@ import {
   stitchCausalChain,
   validateCausalEdge,
   writeChainIndex
-} from "./chunk-XMHBH5H6.js";
-import "./chunk-URB2WSKZ.js";
+} from "./chunk-VLXA6PI2.js";
+import "./chunk-NZL6GGQE.js";
+import "./chunk-MY6TPVXW.js";
 import "./chunk-DT5TVLJE.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-DGXUHMOV.js";

package/dist/causal-consolidation.d.ts

@@ -1,5 +1,5 @@
 import { GatewayConfig, PluginConfig, MemoryFile } from './types.js';
-import { R as RolloutSummaryInput, M as MaterializeResult } from './codex-materialize-CQlLTzke.js';
+import { RolloutSummaryInput, MaterializeResult } from './connectors/codex-materialize.js';
 import './index-DJ9QWMw-.js';
 
 /**