anno-extension 0.1.0

package/dist/linking.js

@@ -0,0 +1,192 @@
+/**
+ * [WHO]: GraphNeighbor, linkNewEntry, getRelatedSummaries, getGraphNeighborhood, getGraphContextSummaries, reinforceRelations
+ * [FROM]: Depends on ./scoring.js, ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/linking.ts - A-MEM style Zettelkasten linking, atomic storage + dynamic associations
+ */
+import { tagOverlap } from "./scoring.js";
+const LINK_THRESHOLD = 0.5;
+const MAX_LINKS = 5;
+const GRAPH_TAG_THRESHOLD = 0.35;
+const GRAPH_MAX_HOPS = 2;
+function upsertRelation(source, targetId, kind, weight) {
+    if (!source.relations)
+        source.relations = [];
+    const existing = source.relations.find((relation) => relation.id === targetId && relation.kind === kind);
+    if (existing) {
+        existing.weight = Math.min(1.5, Math.max(existing.weight, weight));
+        return;
+    }
+    source.relations.push({ id: targetId, kind, weight });
+}
+/** Find related entries by tag overlap and establish bidirectional links */
+export function linkNewEntry(newEntry, allEntries) {
+    if (!newEntry.relatedIds)
+        newEntry.relatedIds = [];
+    if (!newEntry.relations)
+        newEntry.relations = [];
+    const candidates = allEntries
+        .filter((e) => e.id !== newEntry.id)
+        .map((e) => ({ entry: e, overlap: tagOverlap(newEntry.tags, e.tags) }))
+        .filter((c) => c.overlap >= LINK_THRESHOLD)
+        .sort((a, b) => b.overlap - a.overlap)
+        .slice(0, MAX_LINKS);
+    for (const { entry } of candidates) {
+        if (!newEntry.relatedIds.includes(entry.id)) {
+            newEntry.relatedIds.push(entry.id);
+        }
+        const relationKind = inferRelationKind(newEntry, entry, true);
+        upsertRelation(newEntry, entry.id, relationKind, 0.7);
+        if (!entry.relatedIds)
+            entry.relatedIds = [];
+        if (!entry.relations)
+            entry.relations = [];
+        if (!entry.relatedIds.includes(newEntry.id)) {
+            entry.relatedIds.push(newEntry.id);
+        }
+        const reverseRelationKind = inferRelationKind(entry, newEntry, true);
+        upsertRelation(entry, newEntry.id, reverseRelationKind, 0.7);
+    }
+}
+/** Get content summaries for related entries (for injection enrichment) */
+export function getRelatedSummaries(entry, allEntries, maxCount = 3) {
+    if (!entry.relatedIds?.length)
+        return [];
+    const idSet = new Set(entry.relatedIds);
+    return allEntries
+        .filter((e) => idSet.has(e.id))
+        .slice(0, maxCount)
+        .map((e) => e.summary || e.content?.slice(0, 80) || e.name || "");
+}
+function buildGraphScore(seed, candidate, hop, explicit) {
+    const overlap = tagOverlap(seed.tags, candidate.tags);
+    const salience = (candidate.salience ?? candidate.importance ?? 0) / 10;
+    const retentionBoost = candidate.retention === "core" ? 0.35 : candidate.retention === "key-event" ? 0.45 : 0.1;
+    const sameProjectBoost = seed.project === candidate.project ? 0.15 : 0;
+    const eventBoost = candidate.type === "event" ? 0.25 : 0;
+    const explicitBoost = explicit ? 0.35 : 0;
+    return overlap + salience + retentionBoost + sameProjectBoost + eventBoost + explicitBoost - hop * 0.18;
+}
+function inferRelationKind(seed, candidate, explicit) {
+    if (seed.type === "event" && (candidate.type === "lesson" || candidate.type === "decision"))
+        return "cause-of";
+    if ((seed.type === "lesson" || seed.type === "decision") && candidate.type === "event")
+        return "caused-by";
+    if (seed.type === "preference" && (candidate.type === "pattern" || candidate.type === "decision")) {
+        return "preference-shapes";
+    }
+    if (seed.project === candidate.project && explicit)
+        return "same-project";
+    if (seed.type === candidate.type || seed.retention === candidate.retention)
+        return "repeated-pattern";
+    return "tag-overlap";
+}
+function getImplicitNeighbors(entry, allEntries) {
+    return allEntries.filter((candidate) => candidate.id !== entry.id &&
+        candidate.project === entry.project &&
+        tagOverlap(entry.tags, candidate.tags) >= GRAPH_TAG_THRESHOLD);
+}
+export function getGraphNeighborhood(entry, allEntries, maxCount = 4) {
+    const byId = new Map(allEntries.map((candidate) => [candidate.id, candidate]));
+    const visited = new Set([entry.id]);
+    const scored = new Map();
+    let frontier = [{ entry, hop: 0 }];
+    for (let hop = 1; hop <= GRAPH_MAX_HOPS; hop++) {
+        const nextFrontier = [];
+        for (const current of frontier) {
+            const explicit = current.entry.relatedIds
+                ?.map((id) => byId.get(id))
+                .filter((candidate) => candidate !== undefined) ?? [];
+            const implicit = getImplicitNeighbors(current.entry, allEntries);
+            for (const candidate of explicit) {
+                if (visited.has(candidate.id))
+                    continue;
+                visited.add(candidate.id);
+                const score = buildGraphScore(entry, candidate, hop, true);
+                scored.set(candidate.id, {
+                    entry: candidate,
+                    score,
+                    relation: inferRelationKind(entry, candidate, true),
+                    explicit: true,
+                });
+                nextFrontier.push({ entry: candidate, hop });
+            }
+            for (const candidate of implicit) {
+                if (visited.has(candidate.id))
+                    continue;
+                visited.add(candidate.id);
+                const score = buildGraphScore(entry, candidate, hop, false);
+                scored.set(candidate.id, {
+                    entry: candidate,
+                    score,
+                    relation: inferRelationKind(entry, candidate, false),
+                    explicit: false,
+                });
+                nextFrontier.push({ entry: candidate, hop });
+            }
+        }
+        frontier = nextFrontier;
+        if (!frontier.length)
+            break;
+    }
+    return [...scored.values()]
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxCount);
+}
+export function getGraphContextSummaries(entry, allEntries, maxCount = 4) {
+    return getGraphNeighborhood(entry, allEntries, maxCount).map((candidate) => `[${candidate.relation}] [${candidate.entry.type}] ${candidate.entry.summary || candidate.entry.name || candidate.entry.content?.slice(0, 80) || ""}`);
+}
+export function getGraphNeighborhoodBySeeds(seeds, allEntries, maxCount = 8) {
+    const scored = new Map();
+    const seedIds = new Set(seeds.map((seed) => seed.id));
+    for (const seed of seeds) {
+        for (const candidate of getGraphNeighborhood(seed, allEntries, maxCount * 2)) {
+            if (seedIds.has(candidate.entry.id))
+                continue;
+            const overlap = tagOverlap(seed.tags, candidate.entry.tags);
+            const existing = scored.get(candidate.entry.id);
+            const score = overlap +
+                (candidate.entry.salience ?? candidate.entry.importance ?? 0) / 10 +
+                (candidate.entry.retention === "core" ? 0.25 : candidate.entry.retention === "key-event" ? 0.3 : 0);
+            if (!existing || score > existing.score) {
+                scored.set(candidate.entry.id, { ...candidate, score });
+            }
+        }
+    }
+    return [...scored.values()]
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxCount);
+}
+export function reinforceRelations(recalled, allEntries) {
+    const recalledIds = new Set(recalled.map((entry) => entry.id));
+    const byId = new Map(allEntries.map((entry) => [entry.id, entry]));
+    for (const entry of recalled) {
+        const neighbors = getGraphNeighborhood(entry, allEntries, 6);
+        for (const neighbor of neighbors) {
+            const sourceKind = neighbor.relation;
+            upsertRelation(entry, neighbor.entry.id, sourceKind, Math.min(1.5, 0.75 + neighbor.score * 0.12));
+            const reverse = byId.get(neighbor.entry.id);
+            if (!reverse)
+                continue;
+            const reverseKind = inferRelationKind(reverse, entry, neighbor.explicit);
+            upsertRelation(reverse, entry.id, reverseKind, Math.min(1.5, 0.72 + neighbor.score * 0.1));
+            if (!entry.relatedIds?.includes(neighbor.entry.id)) {
+                entry.relatedIds = [...(entry.relatedIds ?? []), neighbor.entry.id];
+            }
+            if (!reverse.relatedIds?.includes(entry.id)) {
+                reverse.relatedIds = [...(reverse.relatedIds ?? []), entry.id];
+            }
+        }
+    }
+    for (const entry of allEntries) {
+        if (!entry.relations?.length)
+            continue;
+        entry.relations = entry.relations
+            .map((relation) => ({
+            ...relation,
+            weight: recalledIds.has(entry.id) || recalledIds.has(relation.id) ? relation.weight : relation.weight * 0.995,
+        }))
+            .filter((relation) => relation.weight >= 0.2);
+    }
+}
+//# sourceMappingURL=linking.js.map

package/dist/linking.js.map

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

package/dist/llm-json.d.ts

@@ -0,0 +1,10 @@
+/**
+ * [WHO]: parseLlmJson, extractLlmJsonText
+ * [FROM]: No internal dependencies; uses JSON.parse and balanced-brace scanning
+ * [TO]: Consumed by mem-core LLM extraction, consolidation, insights, and extension diagnostics
+ * [HERE]: packages/mem-core/src/llm-json.ts - tolerant JSON boundary normalizer for structured LLM responses
+ */
+export declare function parseLlmJson<T>(raw: string): T;
+export declare function extractLlmJsonText(raw: string): string;
+export declare function hasParseableLlmJson(raw: string): boolean;
+//# sourceMappingURL=llm-json.d.ts.map

package/dist/llm-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-json.d.ts","sourceRoot":"","sources":["../src/llm-json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAG9C;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBtD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOxD"}

package/dist/llm-json.js

@@ -0,0 +1,193 @@
+/**
+ * [WHO]: parseLlmJson, extractLlmJsonText
+ * [FROM]: No internal dependencies; uses JSON.parse and balanced-brace scanning
+ * [TO]: Consumed by mem-core LLM extraction, consolidation, insights, and extension diagnostics
+ * [HERE]: packages/mem-core/src/llm-json.ts - tolerant JSON boundary normalizer for structured LLM responses
+ */
+export function parseLlmJson(raw) {
+    const text = extractLlmJsonText(raw);
+    return JSON.parse(text);
+}
+export function extractLlmJsonText(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        throw new SyntaxError("LLM returned empty output");
+    for (const fenced of extractFencedJsonCandidates(trimmed)) {
+        if (canParseJson(fenced))
+            return fenced.trim();
+    }
+    if (canParseJson(trimmed))
+        return trimmed;
+    const balanced = extractFirstBalancedJson(trimmed);
+    if (balanced)
+        return balanced;
+    // Last resort: try to repair truncated JSON (common with smaller models hitting token limits)
+    const repaired = repairTruncatedJson(trimmed);
+    if (repaired)
+        return repaired;
+    return trimmed;
+}
+export function hasParseableLlmJson(raw) {
+    try {
+        parseLlmJson(raw);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function extractFencedJsonCandidates(value) {
+    const candidates = [];
+    const fencePattern = /```(?:json)?\s*([\s\S]*?)```/gi;
+    for (const match of value.matchAll(fencePattern)) {
+        if (typeof match[1] === "string")
+            candidates.push(match[1]);
+    }
+    return candidates;
+}
+function canParseJson(value) {
+    try {
+        JSON.parse(value.trim());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function extractFirstBalancedJson(value) {
+    for (let start = 0; start < value.length; start++) {
+        const first = value[start];
+        if (first !== "{" && first !== "[")
+            continue;
+        const closeForOpen = new Map([
+            ["{", "}"],
+            ["[", "]"],
+        ]);
+        const stack = [closeForOpen.get(first)];
+        let inString = false;
+        let escaped = false;
+        for (let index = start + 1; index < value.length; index++) {
+            const ch = value[index];
+            if (inString) {
+                if (escaped) {
+                    escaped = false;
+                }
+                else if (ch === "\\") {
+                    escaped = true;
+                }
+                else if (ch === "\"") {
+                    inString = false;
+                }
+                continue;
+            }
+            if (ch === "\"") {
+                inString = true;
+                continue;
+            }
+            const close = closeForOpen.get(ch);
+            if (close) {
+                stack.push(close);
+                continue;
+            }
+            if (ch === stack[stack.length - 1]) {
+                stack.pop();
+                if (stack.length === 0) {
+                    const candidate = value.slice(start, index + 1).trim();
+                    if (canParseJson(candidate))
+                        return candidate;
+                    break;
+                }
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Attempt to repair truncated JSON by closing open braces/brackets and
+ * terminating unterminated strings. Common with smaller models that hit
+ * token limits mid-JSON output.
+ */
+function repairTruncatedJson(value) {
+    // Find the start of JSON
+    const jsonStart = findJsonStart(value);
+    if (jsonStart < 0)
+        return undefined;
+    let s = value.slice(jsonStart);
+    if (s.length < 2)
+        return undefined;
+    // Track state
+    const stack = [];
+    let inString = false;
+    let escaped = false;
+    let lastKeyEnd = -1; // track if we're mid-value (after a colon)
+    for (let i = 0; i < s.length; i++) {
+        const ch = s[i];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (ch === "\\") {
+                escaped = true;
+            }
+            else if (ch === "\"") {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === "\"") {
+            inString = true;
+            continue;
+        }
+        if (ch === "{") {
+            stack.push("}");
+            continue;
+        }
+        if (ch === "[") {
+            stack.push("]");
+            continue;
+        }
+        if (ch === ":") {
+            lastKeyEnd = i;
+            continue;
+        }
+        if ((ch === "}" || ch === "]") && stack.length > 0 && stack[stack.length - 1] === ch) {
+            stack.pop();
+        }
+    }
+    // Nothing open — not truncated
+    if (!inString && stack.length === 0)
+        return undefined;
+    // Build repair suffix
+    let repair = "";
+    // Close unterminated string
+    if (inString) {
+        // Escape any trailing backslash
+        if (escaped)
+            repair += "\\";
+        repair += '"';
+    }
+    // If we were mid-value (after colon), add a null placeholder
+    if (lastKeyEnd >= 0) {
+        // Check if there's anything after the last colon that looks like a value
+        const afterColon = s.slice(lastKeyEnd + 1).trim();
+        if (!afterColon || afterColon === '"' || afterColon === "null") {
+            repair += "null";
+        }
+    }
+    // Close all open structures
+    while (stack.length > 0) {
+        repair += stack.pop();
+    }
+    const candidate = s + repair;
+    return canParseJson(candidate) ? candidate : undefined;
+}
+/** Find the index of the first { or [ that starts a JSON value, skipping noise. */
+function findJsonStart(value) {
+    for (let i = 0; i < value.length; i++) {
+        const ch = value[i];
+        if (ch === "{" || ch === "[")
+            return i;
+    }
+    return -1;
+}
+//# sourceMappingURL=llm-json.js.map

package/dist/llm-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-json.js","sourceRoot":"","sources":["../src/llm-json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,YAAY,CAAI,GAAW;IAC1C,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAEjE,KAAK,MAAM,MAAM,IAAI,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,IAAI,YAAY,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE1C,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,8FAA8F;IAC9F,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC9C,IAAI,CAAC;QACJ,YAAY,CAAU,GAAG,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAa;IACjD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,YAAY,GAAG,gCAAgC,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QAClD,IAAI,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IAClC,IAAI,CAAC;QACJ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAa;IAC9C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG;YAAE,SAAS;QAE7C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAiB;YAC5C,CAAC,GAAG,EAAE,GAAG,CAAC;YACV,CAAC,GAAG,EAAE,GAAG,CAAC;SACV,CAAC,CAAC;QACH,MAAM,KAAK,GAAa,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,CAAC;QACnD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAC3D,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;YACzB,IAAI,QAAQ,EAAE,CAAC;gBACd,IAAI,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,KAAK,CAAC;gBACjB,CAAC;qBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;oBACxB,OAAO,GAAG,IAAI,CAAC;gBAChB,CAAC;qBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;oBACxB,QAAQ,GAAG,KAAK,CAAC;gBAClB,CAAC;gBACD,SAAS;YACV,CAAC;YAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACjB,QAAQ,GAAG,IAAI,CAAC;gBAChB,SAAS;YACV,CAAC;YAED,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACX,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,SAAS;YACV,CAAC;YAED,IAAI,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;gBACpC,KAAK,CAAC,GAAG,EAAE,CAAC;gBACZ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACvD,IAAI,YAAY,CAAC,SAAS,CAAC;wBAAE,OAAO,SAAS,CAAC;oBAC9C,MAAM;gBACP,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACzC,yBAAyB;IACzB,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC/B,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnC,cAAc;IACd,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,2CAA2C;IAEhE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACjB,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,KAAK,CAAC;YACjB,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,GAAG,IAAI,CAAC;YAChB,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBACxB,QAAQ,GAAG,KAAK,CAAC;YAClB,CAAC;YACD,SAAS;QACV,CAAC;QAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,SAAS;QACV,CAAC;QAED,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC9C,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC9C,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAAC,UAAU,GAAG,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAE7C,IAAI,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YACtF,KAAK,CAAC,GAAG,EAAE,CAAC;QACb,CAAC;IACF,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEtD,sBAAsB;IACtB,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,4BAA4B;IAC5B,IAAI,QAAQ,EAAE,CAAC;QACd,gCAAgC;QAChC,IAAI,OAAO;YAAE,MAAM,IAAI,IAAI,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC;IACf,CAAC;IAED,6DAA6D;IAC7D,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACrB,yEAAyE;QACzE,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAChE,MAAM,IAAI,MAAM,CAAC;QAClB,CAAC;IACF,CAAC;IAED,4BAA4B;IAC5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC;IAC7B,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,mFAAmF;AACnF,SAAS,aAAa,CAAC,KAAa;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;YAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACX,CAAC"}

package/dist/privacy.d.ts

@@ -0,0 +1,17 @@
+/**
+ * [WHO]: filterPII, filterByScope, evictExpiredEntries, evictExpiredWork
+ * [FROM]: Depends on ./scoring.js, ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/privacy.ts - scope isolation, TTL enforcement, PII filtering
+ */
+import type { MemoryEntry, MemoryScope, WorkEntry } from "./types.js";
+export declare function filterPII(text: string): string;
+export declare function matchesScope(entry: {
+    scope?: MemoryScope;
+}, required?: MemoryScope): boolean;
+export declare function filterByScope<T extends {
+    scope?: MemoryScope;
+}>(entries: T[], scope?: MemoryScope): T[];
+export declare function evictExpiredEntries(entries: MemoryEntry[]): MemoryEntry[];
+export declare function evictExpiredWork(entries: WorkEntry[]): WorkEntry[];
+//# sourceMappingURL=privacy.d.ts.map

package/dist/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../src/privacy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAWtE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAM5F;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,CAAC,EAAE,CAGvG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAKzE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAKlE"}

package/dist/privacy.js

@@ -0,0 +1,53 @@
+/**
+ * [WHO]: filterPII, filterByScope, evictExpiredEntries, evictExpiredWork
+ * [FROM]: Depends on ./scoring.js, ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/privacy.ts - scope isolation, TTL enforcement, PII filtering
+ */
+import { daysSince } from "./scoring.js";
+const PII_PATTERNS = [
+    /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g, // email
+    /\b(?:\+?1[-.]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g, // US phone
+    /\b1[3-9]\d{9}\b/g, // CN mobile
+    /\b\d{3}-\d{2}-\d{4}\b/g, // US SSN
+    /\b[1-9]\d{5}(?:19|20)\d{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[12]\d|3[01])\d{3}[\dXx]\b/g, // CN ID
+    /\b(?:4\d{3}|5[1-5]\d{2}|6011|3[47]\d{2})[-\s]?\d{4}[-\s]?\d{4}[-\s]?\d{4}\b/g, // credit card
+];
+export function filterPII(text) {
+    let result = text;
+    for (const pattern of PII_PATTERNS) {
+        result = result.replace(pattern, "[REDACTED]");
+    }
+    return result;
+}
+export function matchesScope(entry, required) {
+    if (!required)
+        return true;
+    if (!entry.scope)
+        return true;
+    if (required.userId && entry.scope.userId && entry.scope.userId !== required.userId)
+        return false;
+    if (required.agentId && entry.scope.agentId && entry.scope.agentId !== required.agentId)
+        return false;
+    return true;
+}
+export function filterByScope(entries, scope) {
+    if (!scope)
+        return entries;
+    return entries.filter((e) => matchesScope(e, scope));
+}
+export function evictExpiredEntries(entries) {
+    return entries.filter((e) => {
+        if (e.ttl === undefined)
+            return true;
+        return daysSince(e.created) < e.ttl;
+    });
+}
+export function evictExpiredWork(entries) {
+    return entries.filter((w) => {
+        if (w.ttl === undefined)
+            return true;
+        return daysSince(w.created) < w.ttl;
+    });
+}
+//# sourceMappingURL=privacy.js.map

package/dist/privacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.js","sourceRoot":"","sources":["../src/privacy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,MAAM,YAAY,GAAG;IACpB,sDAAsD,EAAE,QAAQ;IAChE,wDAAwD,EAAE,WAAW;IACrE,kBAAkB,EAAE,YAAY;IAChC,wBAAwB,EAAE,SAAS;IACnC,kFAAkF,EAAE,QAAQ;IAC5F,8EAA8E,EAAE,cAAc;CAC9F,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACrC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACpC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA8B,EAAE,QAAsB;IAClF,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAClG,IAAI,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACtG,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAoC,OAAY,EAAE,KAAmB;IACjG,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC3B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACzD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;IACrC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACpD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;IACrC,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/procedural-v2.d.ts

@@ -0,0 +1,9 @@
+/**
+ * [WHO]: compileProceduralFromEpisode, extractProceduresFromEpisodes
+ * [FROM]: Depends on ./scoring.js, ./types-v2.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/procedural-v2.ts - procedural bridge, turns lived episodes into reusable how-to memory
+ */
+import type { EpisodeFacet, EpisodeMemory, ProceduralMemory } from "./types-v2.js";
+export declare function compileProcedureFromEpisode(episode: EpisodeMemory, facets: EpisodeFacet[], now?: string): ProceduralMemory | null;
+//# sourceMappingURL=procedural-v2.d.ts.map

package/dist/procedural-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedural-v2.d.ts","sourceRoot":"","sources":["../src/procedural-v2.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAkB,MAAM,eAAe,CAAC;AA4BnG,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,YAAY,EAAE,EACtB,GAAG,SAA2B,GAC5B,gBAAgB,GAAG,IAAI,CAqGzB"}

package/dist/procedural-v2.js

@@ -0,0 +1,123 @@
+/**
+ * [WHO]: compileProceduralFromEpisode, extractProceduresFromEpisodes
+ * [FROM]: Depends on ./scoring.js, ./types-v2.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/procedural-v2.ts - procedural bridge, turns lived episodes into reusable how-to memory
+ */
+import { extractTags } from "./scoring.js";
+function normalizeLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+function uniqueLines(lines) {
+    const seen = new Set();
+    const result = [];
+    for (const line of lines) {
+        const normalized = normalizeLine(line ?? "");
+        if (!normalized || seen.has(normalized.toLowerCase()))
+            continue;
+        seen.add(normalized.toLowerCase());
+        result.push(normalized);
+    }
+    return result;
+}
+function makeProcedureId(episode) {
+    return `procedure:${episode.sessionId}`;
+}
+function classifyProcedureStatus(episode, hasErrors) {
+    if (hasErrors)
+        return "draft";
+    if (episode.importance >= 7)
+        return "active";
+    return "draft";
+}
+export function compileProcedureFromEpisode(episode, facets, now = new Date().toISOString()) {
+    const goalFacet = facets.find((facet) => facet.facetType === "goal");
+    const insightFacets = facets.filter((facet) => facet.facetType === "insight");
+    const errorFacets = facets.filter((facet) => facet.facetType === "error");
+    const outcomeFacet = facets.find((facet) => facet.facetType === "outcome");
+    const goalText = normalizeLine(goalFacet?.searchText || episode.userGoal || "");
+    const insightTexts = uniqueLines(insightFacets.map((facet) => facet.searchText));
+    const errorTexts = uniqueLines(errorFacets.map((facet) => facet.searchText));
+    const outcomeText = normalizeLine(outcomeFacet?.anchorText || episode.summary);
+    const shouldCompile = Boolean(goalText && insightTexts.length > 0) ||
+        Boolean(goalText && errorTexts.length > 0) ||
+        Boolean(episode.importance >= 8 && outcomeText);
+    if (!shouldCompile)
+        return null;
+    const name = goalText ||
+        normalizeLine(outcomeText.split(/[.!?。！？\n]/)[0] || "") ||
+        `Procedure from ${episode.sessionId.slice(0, 8)}`;
+    const summary = uniqueLines([
+        goalText ? `When working on ${goalText}` : undefined,
+        insightTexts[0] ? `remember ${insightTexts[0]}` : undefined,
+        errorTexts[0] ? `watch for ${errorTexts[0]}` : undefined,
+    ]).join("; ");
+    const steps = [];
+    let stepIndex = 0;
+    if (goalText) {
+        stepIndex += 1;
+        steps.push({
+            id: `${makeProcedureId(episode)}:step:${stepIndex}`,
+            text: `Start from the concrete goal: ${goalText}`,
+            kind: "precondition",
+        });
+    }
+    for (const insight of insightTexts.slice(0, 4)) {
+        stepIndex += 1;
+        steps.push({
+            id: `${makeProcedureId(episode)}:step:${stepIndex}`,
+            text: insight,
+            kind: "step",
+        });
+    }
+    for (const error of errorTexts.slice(0, 3)) {
+        stepIndex += 1;
+        steps.push({
+            id: `${makeProcedureId(episode)}:step:${stepIndex}`,
+            text: `Validate against failure mode: ${error}`,
+            kind: "warning",
+        });
+    }
+    if (outcomeText) {
+        stepIndex += 1;
+        steps.push({
+            id: `${makeProcedureId(episode)}:step:${stepIndex}`,
+            text: `Use this success signal as the expected outcome: ${outcomeText}`,
+            kind: "validation",
+        });
+    }
+    if (steps.length === 0)
+        return null;
+    const tags = extractTags(`${episode.summary} ${goalText} ${insightTexts.join(" ")} ${errorTexts.join(" ")}`);
+    return {
+        id: makeProcedureId(episode),
+        kind: "procedural",
+        name,
+        summary: summary || outcomeText || name,
+        searchText: goalText || name,
+        applicability: goalText || undefined,
+        boundaries: errorTexts.length > 0 ? errorTexts.join("; ") : undefined,
+        contextText: outcomeText || episode.summary,
+        steps,
+        status: classifyProcedureStatus(episode, errorTexts.length > 0),
+        version: 1,
+        sourceFacetIds: facets.map((facet) => facet.id),
+        sourceSemanticIds: [],
+        supersedesIds: [],
+        supersededById: undefined,
+        accessCount: 0,
+        importance: Math.max(1, Math.min(10, episode.importance)),
+        salience: Math.max(1, Math.min(10, episode.salience)),
+        confidence: insightTexts.length > 0 ? 0.8 : 0.65,
+        retention: episode.importance >= 8 ? "key-event" : "ambient",
+        stability: errorTexts.length > 0 ? "situational" : "stable",
+        tags,
+        sourceEpisodeIds: [episode.id],
+        evidence: episode.evidence ?? [],
+        scope: episode.scope,
+        createdAt: now,
+        updatedAt: now,
+        structuralAnchor: episode.structuralAnchor,
+    };
+}
+//# sourceMappingURL=procedural-v2.js.map