@remnic/core 9.69.56 → 9.69.58

package/dist/dedup/merge-content.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Merged-content acceptance check (issue #2330).
+ *
+ * A judge-merged body that is blank, a runaway continuation, or text the
+ * storage sanitizer would rewrite is refused so the write path can fall back
+ * to create. `mergedContent` arrives from a model and gets a typed refusal;
+ * non-string `incomingContent`/`targetContent` is a caller bug and throws.
+ * Internal helper; wiring into the write path is a later slice.
+ */
+export declare const MERGE_CONTENT_LENGTH_FACTOR = 4;
+export type MergeContentCheck = {
+    ok: true;
+    content: string;
+} | {
+    ok: false;
+    reason: "empty" | "oversized" | "unsafe";
+    limit: number;
+};
+export declare function checkMergedContent(input: {
+    mergedContent: unknown;
+    incomingContent: string;
+    targetContent: string;
+}): MergeContentCheck;
+//# sourceMappingURL=merge-content.d.ts.map

package/dist/dedup/merge-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-content.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAS3E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,iBAAiB,CAyBpB"}

package/dist/dedup/merge-count.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Merge-candidate counter (issue #2330 leftover).
+ *
+ * Unique ids after dropping empty strings. Does not mutate input.
+ */
+export declare function countMergeCandidates(ids: readonly string[]): number;
+//# sourceMappingURL=merge-count.d.ts.map

package/dist/dedup/merge-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-count.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-count.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMnE"}

package/dist/dedup/merge-decision.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pure create/update/skip decision for merge-on-write (issue #2330 slice).
+ *
+ * No I/O, no LLM. Invalid thresholds throw RangeError; bad candidates are
+ * ignored, never thrown on. `below_threshold` is reserved for a later slice.
+ */
+export type MergeDecision = {
+    action: "create";
+} | {
+    action: "update";
+    targetId: string;
+} | {
+    action: "skip";
+    reason: "duplicate" | "below_threshold";
+};
+export interface MergeCandidate {
+    id: string;
+    similarity: number;
+    updatedAt: string;
+}
+export interface MergeDecisionOptions {
+    updateThreshold: number;
+    duplicateThreshold: number;
+}
+export declare function decideMergeOnWrite(candidates: readonly MergeCandidate[], options: MergeDecisionOptions): MergeDecision;
+//# sourceMappingURL=merge-decision.d.ts.map

package/dist/dedup/merge-decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-decision.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-decision.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GACpB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAA;CAAE,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAwBD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,cAAc,EAAE,EACrC,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CA6Bf"}

package/dist/dedup/merge-dup.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Merge-id duplicate detector (issue #2330 leftover).
+ *
+ * True if any non-empty id appears twice. Empty strings are ignored.
+ * Does not mutate the input list.
+ */
+export declare function hasDuplicateMergeIds(ids: readonly string[]): boolean;
+//# sourceMappingURL=merge-dup.d.ts.map

package/dist/dedup/merge-dup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-dup.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-dup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAQpE"}

package/dist/dedup/merge-empty.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Merge-id empty-set guard (issue #2330 leftover).
+ *
+ * Empty list → empty_set. Any empty string → empty_id.
+ * Otherwise returns the same ids in order. Does not mutate input.
+ */
+export type RejectEmptyMergeIdsResult = {
+    ok: true;
+    ids: readonly string[];
+} | {
+    ok: false;
+    error: "empty_set" | "empty_id";
+};
+export declare function rejectEmptyMergeIds(ids: readonly string[]): RejectEmptyMergeIdsResult;
+//# sourceMappingURL=merge-empty.d.ts.map

package/dist/dedup/merge-empty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-empty.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-empty.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAAA;CAAE,CAAC;AAEnD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,yBAAyB,CAMrF"}

package/dist/dedup/merge-id.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Merge-target id picker (issue #2330 leftover).
+ *
+ * Empty candidates return null. Otherwise the lowest id by localeCompare.
+ * Does not mutate the input list.
+ */
+export declare function pickMergeTargetId(candidates: readonly string[]): string | null;
+//# sourceMappingURL=merge-id.d.ts.map

package/dist/dedup/merge-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-id.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAM9E"}

package/dist/dedup/merge-judge.d.ts

@@ -0,0 +1,33 @@
+/**
+ * LLM merge judge for create-or-update merge-on-write (issue #2330, step 2).
+ *
+ * One structured-output call deciding whether a NEW memory describes the
+ * same underlying concept as one of a handful of EXISTING in-band
+ * candidates. Routing mirrors `extraction-judge.ts`: local LLM first
+ * (unless `modelSource` is "gateway"), then the shared fallback client
+ * with the gateway task-chain options. No raw OpenAI client here.
+ *
+ * The verdict is returned UNVALIDATED; `decideSemanticMerge` in
+ * `dedup/merge.ts` hard-validates targetId and mergedContent before any
+ * caller acts on them. A null return (no backend answered) is a
+ * `judge_error` → create.
+ */
+import type { LocalLlmClient } from "../local-llm.js";
+import { FallbackLlmClient } from "../fallback-llm.js";
+import type { PluginConfig } from "../types.js";
+import type { MergeCandidate, MergeJudgeRawVerdict } from "./merge.js";
+export interface MergeJudgeCallOptions {
+    content: string;
+    category: string;
+    candidates: readonly MergeCandidate[];
+    config: PluginConfig;
+    localLlm: LocalLlmClient | null;
+    fallbackLlm: FallbackLlmClient | null;
+}
+/**
+ * Ask the merge judge. Returns the raw verdict, or null when no backend
+ * answered or the answer failed schema validation — callers treat null as
+ * judge-error and fail closed to create.
+ */
+export declare function callMergeJudge(options: MergeJudgeCallOptions): Promise<MergeJudgeRawVerdict | null>;
+//# sourceMappingURL=merge-judge.d.ts.map

package/dist/dedup/merge-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-judge.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-judge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EACL,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAsBvE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACvC;AA2BD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA0DtC"}

package/dist/dedup/merge-min-score.d.ts

@@ -0,0 +1,2 @@
+export declare function parseMinMergeScore(value: unknown): number;
+//# sourceMappingURL=merge-min-score.d.ts.map

package/dist/dedup/merge-min-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-min-score.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-min-score.ts"],"names":[],"mappings":"AAcA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOzD"}

package/dist/dedup/merge-on-write-wire.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Persist seam for merge-on-write (issue #2330 leftover slice).
+ *
+ * Default off. Failures and disabled gates create. Persist callers inject
+ * writeMerged / writeNew. This module does not touch extraction-persist.
+ */
+import { type MergeJudge, type MergeOnWritePair } from "./merge-on-write.js";
+export declare function applyMergeOnWriteAtPersist<T>(opts: {
+    enabled?: boolean;
+    pair: MergeOnWritePair;
+    judge: MergeJudge;
+    mergeMin?: number;
+    skipThreshold?: number;
+    writeMerged: (id: string) => T | Promise<T>;
+    writeNew: () => T | Promise<T>;
+}): Promise<T>;
+//# sourceMappingURL=merge-on-write-wire.d.ts.map

package/dist/dedup/merge-on-write-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-on-write-wire.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-on-write-wire.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAE7B,wBAAsB,0BAA0B,CAAC,CAAC,EAAE,IAAI,EAAE;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,CAAC,CAAC,CAYb"}

package/dist/dedup/merge-on-write.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Isolated merge-on-write judge (issue #2330 first slice).
+ *
+ * Default off. Persist wiring comes later. Failures create.
+ */
+export declare const DEFAULT_MERGE_MIN = 0.8;
+export declare const DEFAULT_SKIP_THRESHOLD = 0.92;
+export declare const REFUSED_MERGE_CATEGORIES: readonly ["procedure", "reasoning_trace", "moment", "correction"];
+export type MergeOnWriteDecision = "merge" | "create";
+export type MergeJudgeVerdict = MergeOnWriteDecision | "uncertain";
+export interface MergeOnWritePair {
+    category: string;
+    score: number;
+    incomingContent?: string;
+    existingContent?: string;
+    existingId?: string;
+}
+export type MergeJudge = (pair: MergeOnWritePair) => Promise<MergeJudgeVerdict> | MergeJudgeVerdict;
+export declare function shouldConsiderMerge(opts: {
+    score: number;
+    skipThreshold?: number;
+    mergeMin?: number;
+}): boolean;
+export declare function judgeMergeDecision(pair: MergeOnWritePair, judge: MergeJudge): Promise<MergeOnWriteDecision>;
+export declare function applyMergeOnWrite(opts: {
+    pair: MergeOnWritePair;
+    judge: MergeJudge;
+    enabled?: boolean;
+    mergeMin?: number;
+    skipThreshold?: number;
+}): Promise<MergeOnWriteDecision>;
+//# sourceMappingURL=merge-on-write.d.ts.map

package/dist/dedup/merge-on-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-on-write.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-on-write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,eAAO,MAAM,wBAAwB,mEAK3B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,QAAQ,CAAC;AACtD,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,GAAG,WAAW,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,IAAI,EAAE,gBAAgB,KACnB,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAMV;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAO/B;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAahC"}

package/dist/dedup/merge-pair.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Merge-pair id orderer (issue #2330 leftover).
+ *
+ * Returns [lower, higher] by localeCompare. Same id returns [id, id].
+ * Empty id throws.
+ */
+export declare function orderMergePair(aId: string, bId: string): [string, string];
+//# sourceMappingURL=merge-pair.d.ts.map

package/dist/dedup/merge-pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-pair.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-pair.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKzE"}

package/dist/dedup/merge-provenance.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Merge frontmatter builder (issue #2330).
+ *
+ * On a create-or-update merge the target keeps its own provenance and gains
+ * the incoming fact's, so a merge can never erase where a claim came from.
+ *
+ * Fields here match the canonical schema in `types.ts` deliberately: the
+ * serializer rejects a `derived_via` outside its allow-list and drops keys
+ * `MemoryFrontmatter` does not define, so an invented operator name or
+ * counter would vanish on write. Pure — no I/O, no clock.
+ */
+/** The serializer's allow-listed operator for a create-or-update merge. */
+export declare const MERGE_DERIVED_VIA: "merge";
+/**
+ * Structural mirror of `ProvenanceSource` (types.ts). `sessionKey`,
+ * `observedAt`, and `quote` are required; `turnId` and the character
+ * offsets are optional and MUST survive a merge untouched.
+ */
+export interface MergeProvenanceSource {
+    sessionKey: string;
+    observedAt: string;
+    quote: string;
+    turnId?: string;
+    charStart?: number;
+    charEnd?: number;
+}
+export interface MergeFrontmatterUpdate {
+    updated: string;
+    derived_via: typeof MERGE_DERIVED_VIA;
+    /** Follows the `reinforcement_count` convention; the serializer requires > 0. */
+    reinforcement_count: number;
+    sources: MergeProvenanceSource[];
+}
+export declare function buildMergeFrontmatterUpdate(input: {
+    /** Existing sources already on the merge target. */
+    targetSources?: readonly MergeProvenanceSource[];
+    /** Sources from the incoming fact being merged in. */
+    incomingSources: readonly MergeProvenanceSource[];
+    /** Existing reinforcement_count on the target, if any. */
+    targetReinforcementCount?: number;
+    nowIso: string;
+}): MergeFrontmatterUpdate;
+//# sourceMappingURL=merge-provenance.d.ts.map

package/dist/dedup/merge-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-provenance.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-provenance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAG,OAAgB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,iBAAiB,CAAC;IACtC,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AA0ED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,oDAAoD;IACpD,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACjD,sDAAsD;IACtD,eAAe,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,0DAA0D;IAC1D,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,sBAAsB,CAiCzB"}

package/dist/dedup/merge-score.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Merge-score comparator (issue #2330 leftover).
+ *
+ * Higher score wins. NaN or non-finite scores throw.
+ */
+export declare function compareMergeScore(a: number, b: number): -1 | 0 | 1;
+//# sourceMappingURL=merge-score.d.ts.map

package/dist/dedup/merge-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-score.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-score.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAOlE"}

package/dist/dedup/merge-self.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Merge-self guard (issue #2330 leftover).
+ *
+ * Same id → self_merge. Empty id throws. Otherwise ok.
+ */
+export type RejectSelfMergeResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: "self_merge";
+};
+export declare function rejectSelfMerge(aId: string, bId: string): RejectSelfMergeResult;
+//# sourceMappingURL=merge-self.d.ts.map

package/dist/dedup/merge-self.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-self.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-self.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAEvC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAM/E"}

package/dist/dedup/merge-threshold.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Merge-judge skip predicate (issue #2330 leftover).
+ *
+ * Pure. Disabled merge skips the judge (create). skipThreshold 0 never
+ * skips on score. score >= skipThreshold skips. Invalid units throw.
+ */
+export interface MergeThresholdInput {
+    enabled: boolean;
+    score: number;
+    skipThreshold: number;
+}
+export declare function shouldSkipMergeJudge(input: MergeThresholdInput): boolean;
+//# sourceMappingURL=merge-threshold.d.ts.map

package/dist/dedup/merge-threshold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-threshold.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-threshold.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAQD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAMxE"}

package/dist/dedup/merge-tie.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Merge-tie breaker (issue #2330 leftover).
+ *
+ * Returns the lower id by localeCompare. Same id returns aId.
+ * Empty id throws.
+ */
+export declare function breakMergeTie(aId: string, bId: string): string;
+//# sourceMappingURL=merge-tie.d.ts.map

package/dist/dedup/merge-tie.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-tie.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-tie.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9D"}

package/dist/dedup/merge-unique.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unique merge-id list (issue #2330 leftover).
+ *
+ * Drops empty strings, dedupes, sorts with localeCompare. Does not mutate input.
+ */
+export declare function uniqueMergeIds(ids: readonly string[]): string[];
+//# sourceMappingURL=merge-unique.d.ts.map

package/dist/dedup/merge-unique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-unique.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-unique.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAM/D"}

package/dist/dedup/merge-verdict.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Strict parser for free-form merge-judge verdicts (issue #2330 slice).
+ *
+ * Keeps "unparseable answer" distinguishable from a deliberate "create"
+ * while still failing closed: every failure carries decision "create".
+ */
+export declare const MERGE_JUDGE_VERDICTS: readonly ["merge", "create", "uncertain"];
+export type MergeJudgeVerdictName = (typeof MERGE_JUDGE_VERDICTS)[number];
+export type ParseMergeVerdictResult = {
+    ok: true;
+    verdict: MergeJudgeVerdictName;
+    decision: "merge" | "create";
+} | {
+    ok: false;
+    error: "empty_verdict" | "unknown_verdict";
+    decision: "create";
+};
+export declare function parseMergeJudgeVerdict(raw: unknown): ParseMergeVerdictResult;
+//# sourceMappingURL=merge-verdict.d.ts.map

package/dist/dedup/merge-verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-verdict.d.ts","sourceRoot":"","sources":["../../src/dedup/merge-verdict.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,oBAAoB,2CAA4C,CAAC;AAC9E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAC;IAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAE,GAC1E;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAElF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,uBAAuB,CAgB5E"}

package/dist/dedup/merge.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Judge-mediated merge-on-write decision (issue #2330, harmonic 2/5).
+ *
+ * A new candidate fact that is semantically close — but NOT near-duplicate
+ * close — to an existing active memory is offered to an LLM merge judge.
+ * On a "merge" verdict the caller updates the existing entry in place
+ * instead of writing a new fragment. Every failure mode fails closed to
+ * "create": the unsafe default is always the unchanged write path.
+ *
+ * The near-duplicate skip path (similarity >= the semantic dedup
+ * threshold) is untouched — this module only sees the band
+ * `[minSimilarity, dedupThreshold)`.
+ */
+import type { SemanticMergeConfig } from "../types.js";
+import type { SemanticDedupLookup } from "./semantic.js";
+/** An existing memory considered as a merge target. */
+export interface MergeCandidate {
+    memoryId: string;
+    content: string;
+    category: string;
+    similarity: number;
+    /** Frontmatter status; only `active` (or absent) memories are eligible. */
+    status: string;
+}
+/**
+ * Raw (parsed but UNVALIDATED) judge verdict. `decideSemanticMerge`
+ * hard-validates before trusting any field — an LLM-fabricated targetId
+ * must never survive (issue #2330 step 2).
+ */
+export interface MergeJudgeRawVerdict {
+    decision: "merge" | "create" | "contradicts";
+    targetId?: string | null;
+    mergedContent?: string | null;
+    reason?: string | null;
+}
+/** The judge call injected by the caller (LLM-backed in production). */
+export type MergeJudge = (input: {
+    content: string;
+    category: string;
+    candidates: readonly MergeCandidate[];
+}) => Promise<MergeJudgeRawVerdict>;
+/** Resolves candidate metadata for a lookup hit id; null = unknown memory. */
+export type MergeCandidateResolver = (memoryId: string) => Promise<{
+    content: string;
+    category: string;
+    status: string;
+} | null>;
+/** Why a candidate fell through to the unchanged create path. */
+export type MergeCreateReason = "disabled" | "no_candidates" | "judge_create" | "judge_contradicts" | "judge_invalid" | "judge_error" | "backend_unavailable";
+export type MergeDecision = {
+    action: "create";
+    reason: MergeCreateReason;
+} | {
+    action: "merge";
+    targetId: string;
+    mergedContent: string;
+    /**
+     * The target body the judge actually merged. The persist side must
+     * compare it against the target it is about to write and fall back to
+     * create when it differs: in a multi-writer deployment another
+     * extraction can update the target between this decision and the write,
+     * and `mergedContent` was computed from the older body.
+     */
+    targetContent: string;
+    reason: "judge_merge";
+};
+export interface DecideSemanticMergeOptions {
+    content: string;
+    category: string;
+    lookup: SemanticDedupLookup;
+    judge: MergeJudge;
+    config: SemanticMergeConfig;
+    /** Upper bound of the merge band: the semantic-dedup threshold. */
+    dedupThreshold: number;
+    resolveCandidate: MergeCandidateResolver;
+    /**
+     * Provenance connector of the INCOMING fact. Merge selection is stricter
+     * than the novelty and semantic-dedup gates (`connector-scope.ts`): a merge
+     * may only pair an unscoped fact with an unscoped target, or a
+     * provenance-bearing fact with a neighbor from the same connector. A merge
+     * rewrites the target's body, so any other pairing would relabel one side's
+     * claims under the other's `sourceConnector` frontmatter (finding B).
+     */
+    sourceConnector?: string;
+}
+export declare function decideSemanticMerge(options: DecideSemanticMergeOptions): Promise<MergeDecision>;
+export declare const DEFAULT_SEMANTIC_MERGE_CATEGORIES: readonly ["fact", "preference", "decision", "relationship", "skill"];
+/**
+ * The categories `semanticMerge.categories` may name: every known memory
+ * category except the episodic/immutable ones `REFUSED_MERGE_CATEGORIES`
+ * excludes at runtime — listing a refused category configures a gate that
+ * can never fire, and an unknown string (a typo like "facts") silently
+ * disables merging for every category, so both are rejected at parse time.
+ */
+export declare const MERGEABLE_MEMORY_CATEGORIES: readonly string[];
+export declare const DEFAULT_SEMANTIC_MERGE_MIN = 0.8;
+export declare const DEFAULT_SEMANTIC_MERGE_CANDIDATES = 3;
+/**
+ * Parse the `semanticMerge` block (issue #2330). Follows the `procedural.*`
+ * worked example: strict booleans that reject unrecognized values, CLI
+ * string coercion for numbers ("0" is zero, never coerced upward), and
+ * parse-time rejection of an empty merge band (`minSimilarity` must be
+ * strictly below the semantic-dedup threshold that owns the band's top).
+ * Invalid input is rejected, never silently defaulted or reinterpreted: a
+ * present block that is not an object, a present-but-`undefined` or
+ * unparseable field (`enabled`, `shadowMode`, `minSimilarity`,
+ * `maxCandidates` "abc"/an object/NaN/infinity, or a malformed `categories`
+ * array) each throw. Presence is OWN-property presence (checklist #46): a
+ * key inherited through the prototype chain never applies, and only a key
+ * absent from `Object.getOwnPropertyNames` means "use the defaults".
+ *
+ * The band check applies only when it can describe a real misconfiguration:
+ * merging is enabled, or `minSimilarity` was set explicitly. A deployment
+ * that predates this block and lowered `semanticDedupThreshold` to <= the
+ * default merge minimum must keep starting — the disabled feature performs
+ * no band lookup at all, so rejecting that config would be a gratuitous
+ * backward-compatibility break.
+ */
+export declare function parseSemanticMergeConfig(cfg: Record<string, unknown>): {
+    semanticMerge: SemanticMergeConfig;
+};
+//# sourceMappingURL=merge.d.ts.map

package/dist/dedup/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/dedup/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMvD,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAK3E,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;CACvC,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEpC,8EAA8E;AAC9E,MAAM,MAAM,sBAAsB,GAAG,CACnC,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAE3E,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,eAAe,GACf,aAAa,GACb,qBAAqB,CAAC;AAE1B,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC/C;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEN,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,sBAAsB,CAAC;IACzC;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAUD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,aAAa,CAAC,CA6GxB;AAID,eAAO,MAAM,iCAAiC,sEAMpC,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAExD,CAAC;AAEF,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAoBnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B;IAAE,aAAa,EAAE,mBAAmB,CAAA;CAAE,CAyFxC"}

package/dist/dedup/novelty-gate.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Embedding-density novelty gate (issue #1953, SAGE).
+ *
+ * score = 1 - mean(cosine of k nearest). Higher score = more novel.
+ *   score >= noveltyAddThreshold  → add (skip semantic/LLM dedup)
+ *   score <= noveltyNoopThreshold → noop (drop; do not touch contentHashIndex)
+ *   else                          → uncertain (fall through to semantic dedup)
+ *
+ * Defaults keep a wide UNCERTAIN band. noveltyGateEnabled defaults false.
+ * Backend failure is not handled here — callers treat a thrown lookup as uncertain.
+ */
+export declare const DEFAULT_NOVELTY_ADD_THRESHOLD = 0.55;
+export declare const DEFAULT_NOVELTY_NOOP_THRESHOLD = 0.15;
+export declare const DEFAULT_NOVELTY_K = 5;
+export interface NoveltyNeighbor {
+    id: string;
+    embedding: number[];
+}
+export interface NoveltyDecision {
+    score: number;
+    decision: "add" | "noop" | "uncertain";
+    neighborId?: string;
+}
+export interface NoveltyThresholds {
+    addThreshold?: number;
+    noopThreshold?: number;
+    k?: number;
+}
+export interface WritePathDedupConfig {
+    semanticDedupEnabled: boolean;
+    semanticDedupThreshold: number;
+    semanticDedupCandidates: number;
+    noveltyGateEnabled: boolean;
+    noveltyAddThreshold: number;
+    noveltyNoopThreshold: number;
+}
+/** The semantic-dedup threshold exactly as `parseWritePathDedupConfig` resolves it. */
+export declare function semanticDedupThresholdFrom(cfg: Record<string, unknown>): number;
+export declare function parseWritePathDedupConfig(cfg: Record<string, unknown>): WritePathDedupConfig;
+export declare function embeddingsFromCosineHits(hits: ReadonlyArray<{
+    id: string;
+    score: number;
+    sourceConnector?: string;
+}>, opts?: {
+    candidateConnector?: string;
+}): {
+    embedding: number[];
+    neighborhood: NoveltyNeighbor[];
+};
+export declare function scoreNovelty(embedding: number[], neighborhood: NoveltyNeighbor[], thresholds?: NoveltyThresholds): NoveltyDecision;
+export declare function applyNoveltyGate(opts: {
+    enabled: boolean;
+    addThreshold: number;
+    noopThreshold: number;
+    lookup: () => Promise<{
+        embedding: number[];
+        neighborhood: NoveltyNeighbor[];
+    }>;
+}): Promise<NoveltyDecision>;
+//# sourceMappingURL=novelty-gate.d.ts.map

package/dist/dedup/novelty-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"novelty-gate.d.ts","sourceRoot":"","sources":["../../src/dedup/novelty-gate.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,8BAA8B,OAAO,CAAC;AACnD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAyBD,uFAAuF;AACvF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE/E;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAqB5F;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5E,IAAI,GAAE;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAO,GACzC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,eAAe,EAAE,CAAA;CAAE,CAe1D;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,EAAE,eAAe,EAAE,EAC/B,UAAU,GAAE,iBAAsB,GACjC,eAAe,CAyBjB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC,CAAC;CACjF,GAAG,OAAO,CAAC,eAAe,CAAC,CAa3B"}