@graphorin/memory 0.5.0

package/dist/conflict/locale-packs/en.js

@@ -0,0 +1,262 @@
+import { defineLocalePack } from "./types.js";
+
+//#region src/conflict/locale-packs/en.ts
+/**
+* Bundled English locale pack used by the multi-stage conflict
+* resolution pipeline (DEC-117 / ADR-018 ext / RB-02). The patterns
+* cover the common change signals personal-assistant scenarios surface
+* on a daily basis: relocation, job change, preference flips,
+* relationship transitions, and health updates.
+*
+* Operators supplying a different locale register their own pack via
+* {@link defineLocalePack}. The framework ships English by default so
+* the pipeline always has a working baseline.
+*
+* @packageDocumentation
+*/
+/**
+* The default English `LocalePack`. Frozen — share the singleton.
+*
+* @stable
+*/
+const enLocalePack = defineLocalePack({
+	id: "en",
+	supersedeMarkers: [
+		{
+			regex: /\bmoved (?:to|from)\b/i,
+			kind: "location",
+			confidence: .9
+		},
+		{
+			regex: /\bnow (?:live|living|based|residing) (?:in|at)\b/i,
+			kind: "location",
+			confidence: .9
+		},
+		{
+			regex: /\brelocated\b/i,
+			kind: "location",
+			confidence: .85
+		},
+		{
+			regex: /\bjust moved\b/i,
+			kind: "location",
+			confidence: .85
+		},
+		{
+			regex: /\bI live in\b/i,
+			kind: "location",
+			confidence: .7
+		},
+		{
+			regex: /\b(?:got|started|landed)(?: a)?(?: new)? job\b/i,
+			kind: "job",
+			confidence: .9
+		},
+		{
+			regex: /\bgot promoted\b/i,
+			kind: "job",
+			confidence: .9
+		},
+		{
+			regex: /\bgot fired\b/i,
+			kind: "job",
+			confidence: .9
+		},
+		{
+			regex: /\b(?:I )?quit (?:my )?job\b/i,
+			kind: "job",
+			confidence: .9
+		},
+		{
+			regex: /\bnew employer\b/i,
+			kind: "job",
+			confidence: .85
+		},
+		{
+			regex: /\bnew job\b/i,
+			kind: "job",
+			confidence: .8
+		},
+		{
+			regex: /\bswitched (?:companies|jobs|employers)\b/i,
+			kind: "job",
+			confidence: .9
+		},
+		{
+			regex: /\bnow work(?:s|ing)? (?:at|for)\b/i,
+			kind: "job",
+			confidence: .85
+		},
+		{
+			regex: /\bswitched (?:from|to)\b/i,
+			kind: "preference",
+			confidence: .85
+		},
+		{
+			regex: /\bchanged my (?:mind|preference|opinion)\b/i,
+			kind: "preference",
+			confidence: .85
+		},
+		{
+			regex: /\bused to (?:like|love|prefer|drink|eat|use)\b/i,
+			kind: "preference",
+			confidence: .85
+		},
+		{
+			regex: /\bused to (?:live|work|study|play|travel)\b/i,
+			kind: "generic",
+			confidence: .85
+		},
+		{
+			regex: /\bI prefer\b/i,
+			kind: "preference",
+			confidence: .6
+		},
+		{
+			regex: /\bgot (?:married|divorced|engaged)\b/i,
+			kind: "relationship",
+			confidence: .9
+		},
+		{
+			regex: /\bbroke up\b/i,
+			kind: "relationship",
+			confidence: .85
+		},
+		{
+			regex: /\bdiagnosed (?:with|as)\b/i,
+			kind: "health",
+			confidence: .85
+		},
+		{
+			regex: /\brecovered from\b/i,
+			kind: "health",
+			confidence: .85
+		},
+		{
+			regex: /\bformerly\b/i,
+			kind: "generic",
+			confidence: .7
+		},
+		{
+			regex: /\bpreviously\b/i,
+			kind: "generic",
+			confidence: .7
+		},
+		{
+			regex: /\bused to be\b/i,
+			kind: "generic",
+			confidence: .7
+		},
+		{
+			regex: /\bis now\b/i,
+			kind: "generic",
+			confidence: .7
+		}
+	],
+	negationMarkers: [
+		{
+			regex: /\bno longer\b/i,
+			kind: "preference",
+			confidence: .85
+		},
+		{
+			regex: /\bdoesn(?:'|\u2019)?t\b/i,
+			confidence: .6
+		},
+		{
+			regex: /\b(?:don(?:'|\u2019)?t|do not) (?:like|prefer|use|drink|eat|live|work|play|go|want)\b/i,
+			kind: "preference",
+			confidence: .85
+		},
+		{
+			regex: /\bnever\b/i,
+			confidence: .6
+		},
+		{
+			regex: /\bnot anymore\b/i,
+			kind: "preference",
+			confidence: .85
+		},
+		{
+			regex: /\bisn(?:'|\u2019)?t\b/i,
+			confidence: .6
+		},
+		{
+			regex: /\bnot (?:a fan|interested|willing|going|planning|in|into|looking) /i,
+			kind: "preference",
+			confidence: .7
+		},
+		{
+			regex: /\b(?:is|are|am|was|were) not\b/i,
+			confidence: .5
+		}
+	],
+	predicateNormalisers: [
+		"is",
+		"are",
+		"am",
+		"was",
+		"were",
+		"be",
+		"been",
+		"being",
+		"has",
+		"have",
+		"had",
+		"do",
+		"does",
+		"did",
+		"lives",
+		"live",
+		"lived",
+		"living",
+		"works",
+		"work",
+		"worked",
+		"working",
+		"plays",
+		"play",
+		"played",
+		"playing",
+		"likes",
+		"like",
+		"liked",
+		"loves",
+		"love",
+		"loved",
+		"prefers",
+		"prefer",
+		"preferred",
+		"drinks",
+		"drink",
+		"drank",
+		"drunk",
+		"eats",
+		"eat",
+		"ate",
+		"eaten",
+		"in",
+		"at",
+		"on",
+		"with",
+		"for",
+		"to"
+	],
+	subjectStopWords: [
+		"a",
+		"an",
+		"the",
+		"my",
+		"your",
+		"his",
+		"her",
+		"their",
+		"our",
+		"this",
+		"that"
+	]
+});
+
+//#endregion
+export { enLocalePack };
+//# sourceMappingURL=en.js.map

package/dist/conflict/locale-packs/en.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.js","names":["enLocalePack: LocalePack"],"sources":["../../../src/conflict/locale-packs/en.ts"],"sourcesContent":["/**\n * Bundled English locale pack used by the multi-stage conflict\n * resolution pipeline (DEC-117 / ADR-018 ext / RB-02). The patterns\n * cover the common change signals personal-assistant scenarios surface\n * on a daily basis: relocation, job change, preference flips,\n * relationship transitions, and health updates.\n *\n * Operators supplying a different locale register their own pack via\n * {@link defineLocalePack}. The framework ships English by default so\n * the pipeline always has a working baseline.\n *\n * @packageDocumentation\n */\n\nimport { defineLocalePack, type LocalePack } from './types.js';\n\n/**\n * The default English `LocalePack`. Frozen — share the singleton.\n *\n * @stable\n */\nexport const enLocalePack: LocalePack = defineLocalePack({\n  id: 'en',\n  supersedeMarkers: [\n    // Location.\n    { regex: /\\bmoved (?:to|from)\\b/i, kind: 'location', confidence: 0.9 },\n    {\n      regex: /\\bnow (?:live|living|based|residing) (?:in|at)\\b/i,\n      kind: 'location',\n      confidence: 0.9,\n    },\n    { regex: /\\brelocated\\b/i, kind: 'location', confidence: 0.85 },\n    { regex: /\\bjust moved\\b/i, kind: 'location', confidence: 0.85 },\n    { regex: /\\bI live in\\b/i, kind: 'location', confidence: 0.7 },\n\n    // Job.\n    { regex: /\\b(?:got|started|landed)(?: a)?(?: new)? job\\b/i, kind: 'job', confidence: 0.9 },\n    { regex: /\\bgot promoted\\b/i, kind: 'job', confidence: 0.9 },\n    { regex: /\\bgot fired\\b/i, kind: 'job', confidence: 0.9 },\n    { regex: /\\b(?:I )?quit (?:my )?job\\b/i, kind: 'job', confidence: 0.9 },\n    { regex: /\\bnew employer\\b/i, kind: 'job', confidence: 0.85 },\n    { regex: /\\bnew job\\b/i, kind: 'job', confidence: 0.8 },\n    { regex: /\\bswitched (?:companies|jobs|employers)\\b/i, kind: 'job', confidence: 0.9 },\n    { regex: /\\bnow work(?:s|ing)? (?:at|for)\\b/i, kind: 'job', confidence: 0.85 },\n\n    // Preference.\n    { regex: /\\bswitched (?:from|to)\\b/i, kind: 'preference', confidence: 0.85 },\n    { regex: /\\bchanged my (?:mind|preference|opinion)\\b/i, kind: 'preference', confidence: 0.85 },\n    {\n      regex: /\\bused to (?:like|love|prefer|drink|eat|use)\\b/i,\n      kind: 'preference',\n      confidence: 0.85,\n    },\n    { regex: /\\bused to (?:live|work|study|play|travel)\\b/i, kind: 'generic', confidence: 0.85 },\n    { regex: /\\bI prefer\\b/i, kind: 'preference', confidence: 0.6 },\n\n    // Relationship.\n    { regex: /\\bgot (?:married|divorced|engaged)\\b/i, kind: 'relationship', confidence: 0.9 },\n    { regex: /\\bbroke up\\b/i, kind: 'relationship', confidence: 0.85 },\n\n    // Health.\n    { regex: /\\bdiagnosed (?:with|as)\\b/i, kind: 'health', confidence: 0.85 },\n    { regex: /\\brecovered from\\b/i, kind: 'health', confidence: 0.85 },\n\n    // Generic.\n    { regex: /\\bformerly\\b/i, kind: 'generic', confidence: 0.7 },\n    { regex: /\\bpreviously\\b/i, kind: 'generic', confidence: 0.7 },\n    { regex: /\\bused to be\\b/i, kind: 'generic', confidence: 0.7 },\n    { regex: /\\bis now\\b/i, kind: 'generic', confidence: 0.7 },\n  ],\n  negationMarkers: [\n    { regex: /\\bno longer\\b/i, kind: 'preference', confidence: 0.85 },\n    { regex: /\\bdoesn(?:'|\\u2019)?t\\b/i, confidence: 0.6 },\n    {\n      regex:\n        /\\b(?:don(?:'|\\u2019)?t|do not) (?:like|prefer|use|drink|eat|live|work|play|go|want)\\b/i,\n      kind: 'preference',\n      confidence: 0.85,\n    },\n    { regex: /\\bnever\\b/i, confidence: 0.6 },\n    { regex: /\\bnot anymore\\b/i, kind: 'preference', confidence: 0.85 },\n    { regex: /\\bisn(?:'|\\u2019)?t\\b/i, confidence: 0.6 },\n    {\n      regex: /\\bnot (?:a fan|interested|willing|going|planning|in|into|looking) /i,\n      kind: 'preference',\n      confidence: 0.7,\n    },\n    { regex: /\\b(?:is|are|am|was|were) not\\b/i, confidence: 0.5 },\n  ],\n  predicateNormalisers: [\n    'is',\n    'are',\n    'am',\n    'was',\n    'were',\n    'be',\n    'been',\n    'being',\n    'has',\n    'have',\n    'had',\n    'do',\n    'does',\n    'did',\n    'lives',\n    'live',\n    'lived',\n    'living',\n    'works',\n    'work',\n    'worked',\n    'working',\n    'plays',\n    'play',\n    'played',\n    'playing',\n    'likes',\n    'like',\n    'liked',\n    'loves',\n    'love',\n    'loved',\n    'prefers',\n    'prefer',\n    'preferred',\n    'drinks',\n    'drink',\n    'drank',\n    'drunk',\n    'eats',\n    'eat',\n    'ate',\n    'eaten',\n    'in',\n    'at',\n    'on',\n    'with',\n    'for',\n    'to',\n  ],\n  subjectStopWords: ['a', 'an', 'the', 'my', 'your', 'his', 'her', 'their', 'our', 'this', 'that'],\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAaA,eAA2B,iBAAiB;CACvD,IAAI;CACJ,kBAAkB;EAEhB;GAAE,OAAO;GAA0B,MAAM;GAAY,YAAY;GAAK;EACtE;GACE,OAAO;GACP,MAAM;GACN,YAAY;GACb;EACD;GAAE,OAAO;GAAkB,MAAM;GAAY,YAAY;GAAM;EAC/D;GAAE,OAAO;GAAmB,MAAM;GAAY,YAAY;GAAM;EAChE;GAAE,OAAO;GAAkB,MAAM;GAAY,YAAY;GAAK;EAG9D;GAAE,OAAO;GAAmD,MAAM;GAAO,YAAY;GAAK;EAC1F;GAAE,OAAO;GAAqB,MAAM;GAAO,YAAY;GAAK;EAC5D;GAAE,OAAO;GAAkB,MAAM;GAAO,YAAY;GAAK;EACzD;GAAE,OAAO;GAAgC,MAAM;GAAO,YAAY;GAAK;EACvE;GAAE,OAAO;GAAqB,MAAM;GAAO,YAAY;GAAM;EAC7D;GAAE,OAAO;GAAgB,MAAM;GAAO,YAAY;GAAK;EACvD;GAAE,OAAO;GAA8C,MAAM;GAAO,YAAY;GAAK;EACrF;GAAE,OAAO;GAAsC,MAAM;GAAO,YAAY;GAAM;EAG9E;GAAE,OAAO;GAA6B,MAAM;GAAc,YAAY;GAAM;EAC5E;GAAE,OAAO;GAA+C,MAAM;GAAc,YAAY;GAAM;EAC9F;GACE,OAAO;GACP,MAAM;GACN,YAAY;GACb;EACD;GAAE,OAAO;GAAgD,MAAM;GAAW,YAAY;GAAM;EAC5F;GAAE,OAAO;GAAiB,MAAM;GAAc,YAAY;GAAK;EAG/D;GAAE,OAAO;GAAyC,MAAM;GAAgB,YAAY;GAAK;EACzF;GAAE,OAAO;GAAiB,MAAM;GAAgB,YAAY;GAAM;EAGlE;GAAE,OAAO;GAA8B,MAAM;GAAU,YAAY;GAAM;EACzE;GAAE,OAAO;GAAuB,MAAM;GAAU,YAAY;GAAM;EAGlE;GAAE,OAAO;GAAiB,MAAM;GAAW,YAAY;GAAK;EAC5D;GAAE,OAAO;GAAmB,MAAM;GAAW,YAAY;GAAK;EAC9D;GAAE,OAAO;GAAmB,MAAM;GAAW,YAAY;GAAK;EAC9D;GAAE,OAAO;GAAe,MAAM;GAAW,YAAY;GAAK;EAC3D;CACD,iBAAiB;EACf;GAAE,OAAO;GAAkB,MAAM;GAAc,YAAY;GAAM;EACjE;GAAE,OAAO;GAA4B,YAAY;GAAK;EACtD;GACE,OACE;GACF,MAAM;GACN,YAAY;GACb;EACD;GAAE,OAAO;GAAc,YAAY;GAAK;EACxC;GAAE,OAAO;GAAoB,MAAM;GAAc,YAAY;GAAM;EACnE;GAAE,OAAO;GAA0B,YAAY;GAAK;EACpD;GACE,OAAO;GACP,MAAM;GACN,YAAY;GACb;EACD;GAAE,OAAO;GAAmC,YAAY;GAAK;EAC9D;CACD,sBAAsB;EACpB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CACD,kBAAkB;EAAC;EAAK;EAAM;EAAO;EAAM;EAAQ;EAAO;EAAO;EAAS;EAAO;EAAQ;EAAO;CACjG,CAAC"}

package/dist/conflict/locale-packs/index.js

@@ -0,0 +1,4 @@
+import { defineLocalePack, evaluateMarkers } from "./types.js";
+import { enLocalePack } from "./en.js";
+
+export {  };

package/dist/conflict/locale-packs/types.d.ts

@@ -0,0 +1,103 @@
+//#region src/conflict/locale-packs/types.d.ts
+/**
+ * Public types for the per-locale heuristic packs consumed by the
+ * Stage 3 (regex) and Stage 4 (subject/predicate) stages of the
+ * multi-stage conflict resolution pipeline (DEC-117 / ADR-018 ext).
+ *
+ * @packageDocumentation
+ */
+/**
+ * Categorisation of a supersede marker. Surfaced on the audit row so
+ * downstream tooling can group conflicts by lifecycle event
+ * (relocation / job / preference / relationship / health / generic).
+ *
+ * @stable
+ */
+type LocaleSupersedeKind = 'location' | 'job' | 'preference' | 'relationship' | 'health' | 'generic';
+/**
+ * Single regex pattern bundled inside a `LocalePack`. The pipeline
+ * applies the regex to the fact body in case-insensitive mode unless
+ * the pattern was constructed with explicit flags.
+ *
+ * @stable
+ */
+interface LocalePatternEntry {
+  readonly regex: RegExp;
+  readonly kind?: LocaleSupersedeKind;
+  /**
+   * Optional confidence ∈ `[0, 1]` surfaced through the audit row's
+   * `reason` field. Defaults to `0.8`.
+   */
+  readonly confidence?: number;
+}
+/**
+ * A `LocalePack` defines the regex sets Stage 3 and the predicate
+ * verb set Stage 4 use to evaluate a candidate fact pair against the
+ * existing conflicts.
+ *
+ * The bundled English pack (`enLocalePack`) covers the most common
+ * personal-assistant change signals (relocation / job change /
+ * preference flip / relationship / health). Additional locales are
+ * registered through {@link defineLocalePack}.
+ *
+ * @stable
+ */
+interface LocalePack {
+  /** Stable lowercase identifier (`'en'`, `'fr'`, …). */
+  readonly id: string;
+  /** Patterns that explicitly mark the candidate as superseding the existing fact. */
+  readonly supersedeMarkers: ReadonlyArray<LocalePatternEntry>;
+  /** Patterns that negate the existing fact (treated as supersede in Stage 3). */
+  readonly negationMarkers: ReadonlyArray<LocalePatternEntry>;
+  /**
+   * Verbs (or verb particles) Stage 4 strips while normalising a
+   * predicate so e.g. `'lives in'` and `'living in'` collapse to the
+   * same key. Lowercase tokens.
+   */
+  readonly predicateNormalisers: ReadonlyArray<string>;
+  /** Tokens dropped from the subject before comparison (`'a'`, `'the'`, …). */
+  readonly subjectStopWords: ReadonlyArray<string>;
+}
+/**
+ * Outcome of a single locale-pack regex evaluation. Returned by
+ * `evaluateMarkers(...)` so the pipeline can propagate the matched
+ * marker into the audit row's `reason` field.
+ *
+ * @stable
+ */
+interface LocaleMatch {
+  readonly matched: boolean;
+  readonly kind?: LocaleSupersedeKind;
+  readonly confidence?: number;
+  readonly excerpt?: string;
+}
+/**
+ * Builder used by application code that wants to ship a custom pack:
+ *
+ * ```ts
+ * const ru = defineLocalePack({
+ *   id: 'ru',
+ *   supersedeMarkers: [{ regex: /\bпереехал\b/iu, kind: 'location' }],
+ *   negationMarkers: [{ regex: /\bне\b/iu }],
+ *   predicateNormalisers: ['жив', 'жил', 'живёт'],
+ *   subjectStopWords: ['я', 'ты'],
+ * });
+ * ```
+ *
+ * The builder freezes every input so the pack can be safely reused
+ * across multiple `Memory` instances without accidental mutation.
+ *
+ * @stable
+ */
+declare function defineLocalePack(input: LocalePack): LocalePack;
+/**
+ * Apply a list of patterns to the supplied text and return the
+ * highest-confidence match (first match wins on ties). Surfaced for
+ * unit tests; the pipeline calls this internally.
+ *
+ * @stable
+ */
+declare function evaluateMarkers(text: string, patterns: ReadonlyArray<LocalePatternEntry>): LocaleMatch;
+//#endregion
+export { LocaleMatch, LocalePack, LocalePatternEntry, LocaleSupersedeKind, defineLocalePack, evaluateMarkers };
+//# sourceMappingURL=types.d.ts.map

package/dist/conflict/locale-packs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/conflict/locale-packs/types.ts"],"sourcesContent":[],"mappings":";;AAeA;AAeA;AAsBA;;;;;;;;AAwBA;AAyBA;AAiBA;AAE0B,KAzGd,mBAAA,GAyGc,UAAA,GAAA,KAAA,GAAA,YAAA,GAAA,cAAA,GAAA,QAAA,GAAA,SAAA;;;;;;;;UA1FT,kBAAA;kBACC;kBACA;;;;;;;;;;;;;;;;;;;UAoBD,UAAA;;;;6BAIY,cAAc;;4BAEf,cAAc;;;;;;iCAMT;;6BAEJ;;;;;;;;;UAUZ,WAAA;;kBAEC;;;;;;;;;;;;;;;;;;;;;;iBAuBF,gBAAA,QAAwB,aAAa;;;;;;;;iBAiBrC,eAAA,yBAEJ,cAAc,sBACvB"}

package/dist/conflict/locale-packs/types.js

@@ -0,0 +1,55 @@
+//#region src/conflict/locale-packs/types.ts
+/**
+* Builder used by application code that wants to ship a custom pack:
+*
+* ```ts
+* const ru = defineLocalePack({
+*   id: 'ru',
+*   supersedeMarkers: [{ regex: /\bпереехал\b/iu, kind: 'location' }],
+*   negationMarkers: [{ regex: /\bне\b/iu }],
+*   predicateNormalisers: ['жив', 'жил', 'живёт'],
+*   subjectStopWords: ['я', 'ты'],
+* });
+* ```
+*
+* The builder freezes every input so the pack can be safely reused
+* across multiple `Memory` instances without accidental mutation.
+*
+* @stable
+*/
+function defineLocalePack(input) {
+	return Object.freeze({
+		id: input.id,
+		supersedeMarkers: Object.freeze([...input.supersedeMarkers]),
+		negationMarkers: Object.freeze([...input.negationMarkers]),
+		predicateNormalisers: Object.freeze([...input.predicateNormalisers]),
+		subjectStopWords: Object.freeze([...input.subjectStopWords])
+	});
+}
+/**
+* Apply a list of patterns to the supplied text and return the
+* highest-confidence match (first match wins on ties). Surfaced for
+* unit tests; the pipeline calls this internally.
+*
+* @stable
+*/
+function evaluateMarkers(text, patterns) {
+	let best = { matched: false };
+	for (const pattern of patterns) {
+		const m = pattern.regex.exec(text);
+		if (m === null) continue;
+		const confidence = pattern.confidence ?? .8;
+		if (best.matched && (best.confidence ?? 0) >= confidence) continue;
+		best = {
+			matched: true,
+			...pattern.kind !== void 0 ? { kind: pattern.kind } : {},
+			confidence,
+			excerpt: m[0]
+		};
+	}
+	return best;
+}
+
+//#endregion
+export { defineLocalePack, evaluateMarkers };
+//# sourceMappingURL=types.js.map

package/dist/conflict/locale-packs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["best: LocaleMatch"],"sources":["../../../src/conflict/locale-packs/types.ts"],"sourcesContent":["/**\n * Public types for the per-locale heuristic packs consumed by the\n * Stage 3 (regex) and Stage 4 (subject/predicate) stages of the\n * multi-stage conflict resolution pipeline (DEC-117 / ADR-018 ext).\n *\n * @packageDocumentation\n */\n\n/**\n * Categorisation of a supersede marker. Surfaced on the audit row so\n * downstream tooling can group conflicts by lifecycle event\n * (relocation / job / preference / relationship / health / generic).\n *\n * @stable\n */\nexport type LocaleSupersedeKind =\n  | 'location'\n  | 'job'\n  | 'preference'\n  | 'relationship'\n  | 'health'\n  | 'generic';\n\n/**\n * Single regex pattern bundled inside a `LocalePack`. The pipeline\n * applies the regex to the fact body in case-insensitive mode unless\n * the pattern was constructed with explicit flags.\n *\n * @stable\n */\nexport interface LocalePatternEntry {\n  readonly regex: RegExp;\n  readonly kind?: LocaleSupersedeKind;\n  /**\n   * Optional confidence ∈ `[0, 1]` surfaced through the audit row's\n   * `reason` field. Defaults to `0.8`.\n   */\n  readonly confidence?: number;\n}\n\n/**\n * A `LocalePack` defines the regex sets Stage 3 and the predicate\n * verb set Stage 4 use to evaluate a candidate fact pair against the\n * existing conflicts.\n *\n * The bundled English pack (`enLocalePack`) covers the most common\n * personal-assistant change signals (relocation / job change /\n * preference flip / relationship / health). Additional locales are\n * registered through {@link defineLocalePack}.\n *\n * @stable\n */\nexport interface LocalePack {\n  /** Stable lowercase identifier (`'en'`, `'fr'`, …). */\n  readonly id: string;\n  /** Patterns that explicitly mark the candidate as superseding the existing fact. */\n  readonly supersedeMarkers: ReadonlyArray<LocalePatternEntry>;\n  /** Patterns that negate the existing fact (treated as supersede in Stage 3). */\n  readonly negationMarkers: ReadonlyArray<LocalePatternEntry>;\n  /**\n   * Verbs (or verb particles) Stage 4 strips while normalising a\n   * predicate so e.g. `'lives in'` and `'living in'` collapse to the\n   * same key. Lowercase tokens.\n   */\n  readonly predicateNormalisers: ReadonlyArray<string>;\n  /** Tokens dropped from the subject before comparison (`'a'`, `'the'`, …). */\n  readonly subjectStopWords: ReadonlyArray<string>;\n}\n\n/**\n * Outcome of a single locale-pack regex evaluation. Returned by\n * `evaluateMarkers(...)` so the pipeline can propagate the matched\n * marker into the audit row's `reason` field.\n *\n * @stable\n */\nexport interface LocaleMatch {\n  readonly matched: boolean;\n  readonly kind?: LocaleSupersedeKind;\n  readonly confidence?: number;\n  readonly excerpt?: string;\n}\n\n/**\n * Builder used by application code that wants to ship a custom pack:\n *\n * ```ts\n * const ru = defineLocalePack({\n *   id: 'ru',\n *   supersedeMarkers: [{ regex: /\\bпереехал\\b/iu, kind: 'location' }],\n *   negationMarkers: [{ regex: /\\bне\\b/iu }],\n *   predicateNormalisers: ['жив', 'жил', 'живёт'],\n *   subjectStopWords: ['я', 'ты'],\n * });\n * ```\n *\n * The builder freezes every input so the pack can be safely reused\n * across multiple `Memory` instances without accidental mutation.\n *\n * @stable\n */\nexport function defineLocalePack(input: LocalePack): LocalePack {\n  return Object.freeze({\n    id: input.id,\n    supersedeMarkers: Object.freeze([...input.supersedeMarkers]),\n    negationMarkers: Object.freeze([...input.negationMarkers]),\n    predicateNormalisers: Object.freeze([...input.predicateNormalisers]),\n    subjectStopWords: Object.freeze([...input.subjectStopWords]),\n  }) as LocalePack;\n}\n\n/**\n * Apply a list of patterns to the supplied text and return the\n * highest-confidence match (first match wins on ties). Surfaced for\n * unit tests; the pipeline calls this internally.\n *\n * @stable\n */\nexport function evaluateMarkers(\n  text: string,\n  patterns: ReadonlyArray<LocalePatternEntry>,\n): LocaleMatch {\n  let best: LocaleMatch = { matched: false };\n  for (const pattern of patterns) {\n    const m = pattern.regex.exec(text);\n    if (m === null) continue;\n    const confidence = pattern.confidence ?? 0.8;\n    if (best.matched && (best.confidence ?? 0) >= confidence) continue;\n    const candidate: LocaleMatch = {\n      matched: true,\n      ...(pattern.kind !== undefined ? { kind: pattern.kind } : {}),\n      confidence,\n      excerpt: m[0],\n    };\n    best = candidate;\n  }\n  return best;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqGA,SAAgB,iBAAiB,OAA+B;AAC9D,QAAO,OAAO,OAAO;EACnB,IAAI,MAAM;EACV,kBAAkB,OAAO,OAAO,CAAC,GAAG,MAAM,iBAAiB,CAAC;EAC5D,iBAAiB,OAAO,OAAO,CAAC,GAAG,MAAM,gBAAgB,CAAC;EAC1D,sBAAsB,OAAO,OAAO,CAAC,GAAG,MAAM,qBAAqB,CAAC;EACpE,kBAAkB,OAAO,OAAO,CAAC,GAAG,MAAM,iBAAiB,CAAC;EAC7D,CAAC;;;;;;;;;AAUJ,SAAgB,gBACd,MACA,UACa;CACb,IAAIA,OAAoB,EAAE,SAAS,OAAO;AAC1C,MAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,IAAI,QAAQ,MAAM,KAAK,KAAK;AAClC,MAAI,MAAM,KAAM;EAChB,MAAM,aAAa,QAAQ,cAAc;AACzC,MAAI,KAAK,YAAY,KAAK,cAAc,MAAM,WAAY;AAO1D,SAN+B;GAC7B,SAAS;GACT,GAAI,QAAQ,SAAS,SAAY,EAAE,MAAM,QAAQ,MAAM,GAAG,EAAE;GAC5D;GACA,SAAS,EAAE;GACZ;;AAGH,QAAO"}

package/dist/conflict/pipeline.d.ts

@@ -0,0 +1,35 @@
+import { ConflictDecision, ConflictPipeline, ConflictPipelineDeps, ConflictPipelineOptions } from "./types.js";
+import { Fact } from "@graphorin/core";
+
+//#region src/conflict/pipeline.d.ts
+
+/**
+ * Reset the one-shot bypass-warning flag. Test-only helper — production
+ * callers never invoke this.
+ *
+ * @internal
+ */
+declare function _resetBypassWarningForTesting(): void;
+/**
+ * One-shot helper that mirrors RB-02 §8.1's `runConflictPipeline({...})`
+ * spec — convenient for callers that do not need to pre-build + cache
+ * the pipeline. Production wiring should still go through
+ * {@link createConflictPipeline} (`SemanticMemory` re-uses the cached
+ * instance per `Memory`).
+ *
+ * @stable
+ */
+declare function runConflictPipeline(args: {
+  readonly candidate: Fact;
+  readonly deps: ConflictPipelineDeps;
+  readonly options?: ConflictPipelineOptions;
+}): Promise<ConflictDecision>;
+/**
+ * Returns a frozen pipeline handle wired with the supplied options.
+ *
+ * @stable
+ */
+declare function createConflictPipeline(options?: ConflictPipelineOptions): ConflictPipeline;
+//#endregion
+export { _resetBypassWarningForTesting, createConflictPipeline, runConflictPipeline };
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/conflict/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","names":[],"sources":["../../src/conflict/pipeline.ts"],"sourcesContent":[],"mappings":";;;;;;;;AA+DA;;;iBA3BgB,6BAAA,CAAA;;;;;;;;;;iBAaM,mBAAA;sBACA;iBACL;qBACI;IACjB,QAAQ;;;;;;iBAUI,sBAAA,WAAgC,0BAA+B"}