anno-extension 0.1.0

package/dist/update.d.ts

@@ -0,0 +1,31 @@
+/**
+ * [WHO]: contentSimilarity, applyExtraction, checkConsolidationEntry, checkWorkDuplicate, applyWorkExtraction
+ * [FROM]: Depends on ./config.js, ./linking.js, ./privacy.js, ./scoring.js, ./store.js, ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/update.ts - Mem0 four-operation pipeline (ADD/UPDATE/DELETE/NOOP)
+ */
+import type { NanomemConfig } from "./config.js";
+import type { ExtractedItem, MemoryEntry, WorkEntry } from "./types.js";
+/** Simple content similarity check using character overlap — exported for dedup/consolidation */
+export declare function contentSimilarity(a: string, b: string): number;
+/** Process a single extracted item through the Mem0 pipeline */
+export declare function applyExtraction(entries: MemoryEntry[], item: ExtractedItem, project: string, cfg: NanomemConfig): void;
+/** Check if consolidation candidate is duplicate or update of existing. Used before pushing to knowledge/lessons. */
+export declare function checkConsolidationEntry(target: MemoryEntry[], candidate: MemoryEntry, allExisting: MemoryEntry[]): {
+    action: "skip";
+} | {
+    action: "update";
+    index: number;
+} | {
+    action: "add";
+};
+/** Check if work candidate is duplicate or update of existing work entries. */
+export declare function checkWorkDuplicate(entries: WorkEntry[], candidate: WorkEntry): {
+    action: "skip";
+} | {
+    action: "update";
+    index: number;
+} | {
+    action: "add";
+};
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAoC,SAAS,EAAE,MAAM,YAAY,CAAC;AAU1G,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAc9D;AA6ED,gEAAgE;AAChE,wBAAgB,eAAe,CAC9B,OAAO,EAAE,WAAW,EAAE,EACtB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,aAAa,GAChB,IAAI,CAkFN;AAmCD,qHAAqH;AACrH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,WAAW,EAAE,EACrB,SAAS,EAAE,WAAW,EACtB,WAAW,EAAE,WAAW,EAAE,GACxB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAO9E;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,SAAS,EAAE,EACpB,SAAS,EAAE,SAAS,GAClB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,CAc9E"}

package/dist/update.js

@@ -0,0 +1,250 @@
+/**
+ * [WHO]: contentSimilarity, applyExtraction, checkConsolidationEntry, checkWorkDuplicate, applyWorkExtraction
+ * [FROM]: Depends on ./config.js, ./linking.js, ./privacy.js, ./scoring.js, ./store.js, ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/update.ts - Mem0 four-operation pipeline (ADD/UPDATE/DELETE/NOOP)
+ */
+import { linkNewEntry } from "./linking.js";
+import { filterPII } from "./privacy.js";
+import { extractTags, tagOverlap } from "./scoring.js";
+import { deriveNameFromContent, deriveSummaryFromContent } from "./store.js";
+const UPDATE_OVERLAP_THRESHOLD = 0.7;
+const NOOP_SIMILARITY_THRESHOLD = 0.8;
+const CONTENT_SIMILARITY_THRESHOLD = 0.85;
+function makeId() {
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+/** Simple content similarity check using character overlap — exported for dedup/consolidation */
+export function contentSimilarity(a, b) {
+    const aLower = a.toLowerCase().trim();
+    const bLower = b.toLowerCase().trim();
+    if (aLower === bLower)
+        return 1;
+    const shorter = aLower.length < bLower.length ? aLower : bLower;
+    const longer = aLower.length >= bLower.length ? aLower : bLower;
+    if (longer.includes(shorter))
+        return shorter.length / longer.length;
+    // Simple word overlap
+    const aWords = new Set(aLower.split(/\s+/).filter((w) => w.length > 2));
+    const bWords = new Set(bLower.split(/\s+/).filter((w) => w.length > 2));
+    if (aWords.size === 0 || bWords.size === 0)
+        return 0;
+    let overlap = 0;
+    for (const w of aWords)
+        if (bWords.has(w))
+            overlap++;
+    return (2 * overlap) / (aWords.size + bWords.size);
+}
+/** Check if new content is too similar to an existing entry of same type */
+function isDuplicate(entries, type, tags, nameSummary) {
+    return entries.some((e) => {
+        if (e.type !== type)
+            return false;
+        const existingNameSummary = `${e.name || ""} ${e.summary || e.content || ""}`.trim();
+        // Check both tag overlap and content similarity
+        const tagMatch = tagOverlap(e.tags, tags) >= NOOP_SIMILARITY_THRESHOLD;
+        const contentMatch = contentSimilarity(existingNameSummary, nameSummary) >= CONTENT_SIMILARITY_THRESHOLD;
+        return tagMatch || contentMatch;
+    });
+}
+/** Find existing entry with high tag overlap for UPDATE */
+function findUpdateCandidate(entries, type, tags) {
+    return entries.findIndex((e) => e.type === type && tagOverlap(e.tags, tags) >= UPDATE_OVERLAP_THRESHOLD);
+}
+function inferRetention(item) {
+    if (item.retention)
+        return item.retention;
+    if (item.stability === "situational" || item.stateData)
+        return "ambient";
+    switch (item.type) {
+        case "preference":
+        case "pattern":
+            return "core";
+        case "lesson":
+        case "struggle":
+        case "decision":
+        case "event":
+            return "key-event";
+        default:
+            return "ambient";
+    }
+}
+function inferStability(item) {
+    if (item.stability)
+        return item.stability;
+    if (item.stateData)
+        return "situational";
+    switch (item.type) {
+        case "preference":
+        case "pattern":
+            return "stable";
+        case "event":
+            return item.eventData?.kind === "milestone" ? "stable" : "situational";
+        default:
+            return "stable";
+    }
+}
+function inferSalience(item) {
+    if (typeof item.salience === "number") {
+        return Math.max(1, Math.min(10, item.salience));
+    }
+    switch (item.type) {
+        case "event":
+        case "struggle":
+            return 9;
+        case "lesson":
+        case "decision":
+            return 8;
+        case "pattern":
+            return 7;
+        case "preference":
+            return 6;
+        default:
+            return 4;
+    }
+}
+function inferTtl(item, cfg, retention, salience) {
+    if (item.stability === "situational" || item.stateData)
+        return Math.min(14, cfg.forgetting.ambientTtlDays);
+    if (retention !== "ambient")
+        return undefined;
+    if (item.type === "fact" && salience <= 5)
+        return cfg.forgetting.ambientTtlDays;
+    return undefined;
+}
+/** Process a single extracted item through the Mem0 pipeline */
+export function applyExtraction(entries, item, project, cfg) {
+    if (item.type === "retract") {
+        applyDelete(entries, item.detail || item.content || item.summary || "");
+        return;
+    }
+    const memType = mapType(item.type);
+    const rawDetail = item.detail || item.content || "";
+    const detail = filterPII(rawDetail);
+    const name = item.name || deriveNameFromContent(detail);
+    const summary = item.summary || deriveSummaryFromContent(detail);
+    const tags = extractTags(`${name} ${summary} ${detail}`);
+    const nameSummary = `${name} ${summary}`;
+    const retention = inferRetention(item);
+    const salience = inferSalience(item);
+    const stability = inferStability(item);
+    if (isDuplicate(entries, memType, tags, nameSummary))
+        return;
+    const updateIdx = findUpdateCandidate(entries, memType, tags);
+    if (updateIdx >= 0) {
+        const existing = entries[updateIdx];
+        entries[updateIdx] = {
+            ...existing,
+            name,
+            summary,
+            detail,
+            content: detail,
+            tags,
+            lastAccessed: new Date().toISOString(),
+            retention: existing.retention === "core" || retention === "core"
+                ? "core"
+                : existing.retention === "key-event" || retention === "key-event"
+                    ? "key-event"
+                    : "ambient",
+            salience: Math.max(existing.salience ?? existing.importance, salience),
+            eventData: item.eventData ?? existing.eventData,
+            stateData: item.stateData ?? existing.stateData,
+            stability: existing.stability === "stable" || stability === "stable" ? "stable" : "situational",
+            ttl: inferTtl(item, cfg, retention, salience) ?? existing.ttl,
+        };
+        return;
+    }
+    const now = new Date().toISOString();
+    const newEntry = {
+        id: makeId(),
+        type: memType,
+        name,
+        summary,
+        detail,
+        content: detail,
+        tags,
+        project,
+        importance: item.type === "struggle"
+            ? 9
+            : item.type === "lesson"
+                ? 8
+                : item.type === "pattern"
+                    ? 7
+                    : item.type === "preference"
+                        ? 6
+                        : 5,
+        strength: cfg.halfLife[memType] ?? 30,
+        created: now,
+        eventTime: now,
+        accessCount: 0,
+        relatedIds: [],
+        scope: cfg.defaultScope,
+        facetData: item.facetData,
+        eventData: item.eventData,
+        retention,
+        salience,
+        stability,
+        stateData: item.stateData,
+        ttl: inferTtl(item, cfg, retention, salience),
+    };
+    linkNewEntry(newEntry, entries);
+    entries.push(newEntry);
+}
+function applyDelete(entries, text) {
+    const tags = extractTags(text);
+    const idx = entries.findIndex((e) => (e.type === "fact" || e.type === "preference") && tagOverlap(e.tags, tags) >= UPDATE_OVERLAP_THRESHOLD);
+    if (idx >= 0)
+        entries.splice(idx, 1);
+}
+function mapType(t) {
+    switch (t) {
+        case "preference":
+            return "preference";
+        case "lesson":
+            return "lesson";
+        case "decision":
+            return "decision";
+        case "pattern":
+            return "pattern";
+        case "struggle":
+            return "struggle";
+        case "event":
+            return "event";
+        default:
+            return "fact";
+    }
+}
+// ─── Dedup helpers for consolidation & work ────────────────────────────────
+const WORK_DEDUP_TAG_THRESHOLD = 0.75;
+const WORK_DEDUP_CONTENT_THRESHOLD = 0.8;
+const WORK_UPDATE_TAG_THRESHOLD = 0.65;
+/** Check if consolidation candidate is duplicate or update of existing. Used before pushing to knowledge/lessons. */
+export function checkConsolidationEntry(target, candidate, allExisting) {
+    const nameSummary = `${candidate.name || ""} ${candidate.summary || ""}`.trim();
+    const sameTypeExisting = allExisting.filter((e) => e.type === candidate.type);
+    if (isDuplicate(sameTypeExisting, candidate.type, candidate.tags, nameSummary))
+        return { action: "skip" };
+    const updateIdx = findUpdateCandidate(target, candidate.type, candidate.tags);
+    if (updateIdx >= 0)
+        return { action: "update", index: updateIdx };
+    return { action: "add" };
+}
+/** Check if work candidate is duplicate or update of existing work entries. */
+export function checkWorkDuplicate(entries, candidate) {
+    const candidateText = `${candidate.goal} ${candidate.summary}`.trim();
+    for (let i = 0; i < entries.length; i++) {
+        const e = entries[i];
+        const existingText = `${e.goal} ${e.summary}`.trim();
+        const tagMatch = tagOverlap(e.tags, candidate.tags) >= WORK_DEDUP_TAG_THRESHOLD;
+        const contentMatch = contentSimilarity(existingText, candidateText) >= WORK_DEDUP_CONTENT_THRESHOLD;
+        if (tagMatch || contentMatch)
+            return { action: "skip" };
+    }
+    for (let i = 0; i < entries.length; i++) {
+        const e = entries[i];
+        if (tagOverlap(e.tags, candidate.tags) >= WORK_UPDATE_TAG_THRESHOLD)
+            return { action: "update", index: i };
+    }
+    return { action: "add" };
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAG7E,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AACtC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAE1C,SAAS,MAAM;IACd,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,iBAAiB,CAAC,CAAS,EAAE,CAAS;IACrD,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IACpE,sBAAsB;IACtB,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACrD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,MAAM;QAAE,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;IACrD,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,4EAA4E;AAC5E,SAAS,WAAW,CAAC,OAAsB,EAAE,IAAY,EAAE,IAAc,EAAE,WAAmB;IAC7F,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACzB,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAClC,MAAM,mBAAmB,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QACrF,gDAAgD;QAChD,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,yBAAyB,CAAC;QACvE,MAAM,YAAY,GAAG,iBAAiB,CAAC,mBAAmB,EAAE,WAAW,CAAC,IAAI,4BAA4B,CAAC;QACzG,OAAO,QAAQ,IAAI,YAAY,CAAC;IACjC,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,SAAS,mBAAmB,CAAC,OAAsB,EAAE,IAAY,EAAE,IAAc;IAChF,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,wBAAwB,CAAC,CAAC;AAC1G,CAAC;AAED,SAAS,cAAc,CAAC,IAAmB;IAC1C,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1C,IAAI,IAAI,CAAC,SAAS,KAAK,aAAa,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACzE,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,SAAS;YACb,OAAO,MAAM,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO;YACX,OAAO,WAAW,CAAC;QACpB;YACC,OAAO,SAAS,CAAC;IACnB,CAAC;AACF,CAAC;AAED,SAAS,cAAc,CAAC,IAAmB;IAC1C,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1C,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,aAAa,CAAC;IACzC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC;QAClB,KAAK,SAAS;YACb,OAAO,QAAQ,CAAC;QACjB,KAAK,OAAO;YACX,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;QACxE;YACC,OAAO,QAAQ,CAAC;IAClB,CAAC;AACF,CAAC;AAED,SAAS,aAAa,CAAC,IAAmB;IACzC,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,UAAU;YACd,OAAO,CAAC,CAAC;QACV,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU;YACd,OAAO,CAAC,CAAC;QACV,KAAK,SAAS;YACb,OAAO,CAAC,CAAC;QACV,KAAK,YAAY;YAChB,OAAO,CAAC,CAAC;QACV;YACC,OAAO,CAAC,CAAC;IACX,CAAC;AACF,CAAC;AAED,SAAS,QAAQ,CAAC,IAAmB,EAAE,GAAkB,EAAE,SAA0B,EAAE,QAAgB;IACtG,IAAI,IAAI,CAAC,SAAS,KAAK,aAAa,IAAI,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3G,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC;IAChF,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe,CAC9B,OAAsB,EACtB,IAAmB,EACnB,OAAe,EACf,GAAkB;IAElB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO;IACR,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAEvC,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC;QAAE,OAAO;IAE7D,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9D,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAE,CAAC;QACrC,OAAO,CAAC,SAAS,CAAC,GAAG;YACpB,GAAG,QAAQ;YACX,IAAI;YACJ,OAAO;YACP,MAAM;YACN,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,SAAS,EACR,QAAQ,CAAC,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,MAAM;gBACpD,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,QAAQ,CAAC,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,WAAW;oBAChE,CAAC,CAAC,WAAW;oBACb,CAAC,CAAC,SAAS;YACd,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC;YACtE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS;YAC/C,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS;YAC/C,SAAS,EAAE,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa;YAC/F,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,GAAG;SAC7D,CAAC;QACF,OAAO;IACR,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAgB;QAC7B,EAAE,EAAE,MAAM,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,IAAI;QACJ,OAAO;QACP,MAAM;QACN,OAAO,EAAE,MAAM;QACf,IAAI;QACJ,OAAO;QACP,UAAU,EACT,IAAI,CAAC,IAAI,KAAK,UAAU;YACvB,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ;gBACvB,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS;oBACxB,CAAC,CAAC,CAAC;oBACH,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;wBAC3B,CAAC,CAAC,CAAC;wBACH,CAAC,CAAC,CAAC;QACR,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;QACrC,OAAO,EAAE,GAAG;QACZ,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,EAAE;QACd,KAAK,EAAE,GAAG,CAAC,YAAY;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS;QACT,QAAQ;QACR,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC;KAC7C,CAAC;IAEF,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,WAAW,CAAC,OAAsB,EAAE,IAAY;IACxD,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,wBAAwB,CAC7G,CAAC;IACF,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,OAAO,CAAC,CAAwB;IACxC,QAAQ,CAAC,EAAE,CAAC;QACX,KAAK,YAAY;YAChB,OAAO,YAAY,CAAC;QACrB,KAAK,QAAQ;YACZ,OAAO,QAAQ,CAAC;QACjB,KAAK,UAAU;YACd,OAAO,UAAU,CAAC;QACnB,KAAK,SAAS;YACb,OAAO,SAAS,CAAC;QAClB,KAAK,UAAU;YACd,OAAO,UAAU,CAAC;QACnB,KAAK,OAAO;YACX,OAAO,OAAO,CAAC;QAChB;YACC,OAAO,MAAM,CAAC;IAChB,CAAC;AACF,CAAC;AAED,8EAA8E;AAE9E,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AACzC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAEvC,qHAAqH;AACrH,MAAM,UAAU,uBAAuB,CACtC,MAAqB,EACrB,SAAsB,EACtB,WAA0B;IAE1B,MAAM,WAAW,GAAG,GAAG,SAAS,CAAC,IAAI,IAAI,EAAE,IAAI,SAAS,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAChF,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,WAAW,CAAC,gBAAgB,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1G,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9E,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAClE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CACjC,OAAoB,EACpB,SAAoB;IAEpB,MAAM,aAAa,GAAG,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACtB,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC;QAChF,MAAM,YAAY,GAAG,iBAAiB,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,4BAA4B,CAAC;QACpG,IAAI,QAAQ,IAAI,YAAY;YAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;QACtB,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,yBAAyB;YAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC5G,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "anno-extension",
+  "version": "0.1.0",
+  "description": "Browser-native NanoMem engine with IndexedDB persistence and layered memory recall.",
+  "type": "module",
+  "license": "GPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.alibaba-inc.com/QoderDesign/ANNO.git"
+  },
+  "homepage": "https://github.com/cunyu666/ANNO",
+  "bugs": {
+    "url": "https://github.com/cunyu666/ANNO/issues"
+  },
+  "files": ["dist", "src", "README.md", "LICENSE", "THIRD_PARTY_NOTICES.md"],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build && npm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "engines": {"node": ">=18"}
+}

package/src/browser-fs.ts

@@ -0,0 +1,67 @@
+const DB_NAME = 'anno-nanomem-files-v1'
+const STORE = 'files'
+let databasePromise: Promise<IDBDatabase> | undefined
+
+function database(): Promise<IDBDatabase> {
+  if (!databasePromise) databasePromise = new Promise((resolve, reject) => {
+    const request = indexedDB.open(DB_NAME, 1)
+    request.onupgradeneeded = () => request.result.createObjectStore(STORE)
+    request.onsuccess = () => resolve(request.result)
+    request.onerror = () => reject(request.error)
+  })
+  return databasePromise
+}
+
+function transact<T>(mode: IDBTransactionMode, action: (store: IDBObjectStore) => IDBRequest<T>): Promise<T> {
+  return database().then(db => new Promise((resolve, reject) => {
+    const transaction = db.transaction(STORE, mode)
+    const request = action(transaction.objectStore(STORE))
+    let value: T
+    request.onsuccess = () => { value = request.result }
+    request.onerror = () => reject(request.error)
+    transaction.onerror = () => reject(transaction.error)
+    transaction.onabort = () => reject(transaction.error)
+    transaction.oncomplete = () => resolve(value)
+  }))
+}
+
+export function join(...parts: string[]): string {
+  return parts.join('/').replace(/\/+/g, '/')
+}
+
+export function dirname(path: string): string { return path.slice(0, path.lastIndexOf('/')) || '/' }
+export async function mkdir(_path: string, _options?: { recursive?: boolean }): Promise<void> { /* IndexedDB has no directories. */ }
+export async function readFile(path: string): Promise<string> {
+  const value = await transact<string | undefined>('readonly', store => store.get(path))
+  if (value === undefined) throw new Error(`File not found: ${path}`)
+  return value
+}
+export async function writeFile(path: string, text: string): Promise<void> { await transact('readwrite', store => store.put(text, path)) }
+// Web Locks coordinate extension pages and the MV3 service worker.
+export function withMemoryLock<T>(name: string, action: () => Promise<T>): Promise<T> {
+  return navigator.locks.request<Promise<T>>(`anno:${name}`, action).then(result => result)
+}
+export async function readdir(path: string): Promise<string[]> {
+  const keys = await transact<IDBValidKey[]>('readonly', store => store.getAllKeys())
+  const prefix = path.replace(/\/+$/, '') + '/'
+  return [...new Set(keys.map(String).filter(key => key.startsWith(prefix)).map(key => key.slice(prefix.length).split('/')[0]))]
+}
+export async function cp(source: string, target: string, options?: { recursive?: boolean }): Promise<void> {
+  const keys = await transact<IDBValidKey[]>('readonly', store => store.getAllKeys())
+  const matching = keys.map(String).filter(key => key === source || (options?.recursive && key.startsWith(source.replace(/\/+$/, '') + '/')))
+  if (!matching.length) throw new Error(`File not found: ${source}`)
+  for (const key of matching) await writeFile(target + key.slice(source.length), await readFile(key))
+}
+
+export async function removeTree(path: string): Promise<void> {
+  const keys = await transact<IDBValidKey[]>('readonly', store => store.getAllKeys())
+  const prefix = path.replace(/\/+$/, '') + '/'
+  await database().then(db => new Promise<void>((resolve, reject) => {
+    const transaction = db.transaction(STORE, 'readwrite')
+    const store = transaction.objectStore(STORE)
+    for (const key of keys.map(String)) if (key === path || key.startsWith(prefix)) store.delete(key)
+    transaction.oncomplete = () => resolve()
+    transaction.onerror = () => reject(transaction.error)
+    transaction.onabort = () => reject(transaction.error)
+  }))
+}

package/src/config.ts

@@ -0,0 +1,138 @@
+/**
+ * [WHO]: ProgressiveRecallConfig, NanomemConfig, getConfig, BudgetConfig, ScoreWeights
+ * [FROM]: Depends on browser-fs.ts and ./types.js
+ * [TO]: Consumed by packages/mem-core/src/index.ts
+ * [HERE]: packages/mem-core/src/config.ts - configuration management for memory system
+ */
+
+
+import { join } from "./browser-fs.js";
+import type { MemoryScope } from "./types.js";
+
+export interface ProgressiveRecallConfig {
+	/** Score threshold for Active tier — inject full detail */
+	thresholdActive: number;
+	/** Score threshold for Cue tier — inject name + summary + id */
+	thresholdCue: number;
+	/** Budget ratio for Active tier (default 0.15 = 15%) */
+	budgetActive: number;
+	/** Budget ratio for Cue tier (default 0.70 = 70%) */
+	budgetCue: number;
+	/** Force entries created within this many hours to Active tier */
+	forceRecentHours: number;
+	/** Force entries with importance >= this value to Active tier */
+	forceImportanceMin: number;
+}
+
+export interface EmbeddingConfig {
+	enabled: boolean;
+	model: string;
+	dim: number;
+	autoSync: boolean;
+}
+
+export interface NanomemConfig {
+	memoryDir: string;
+	tokenBudget: number;
+	budget: { lessons: number; knowledge: number; events: number; episodes: number; preferences: number; work: number; facets: number };
+	halfLife: Record<string, number>;
+	maxEntries: { knowledge: number; lessons: number; events: number; preferences: number; work: number; facets: number };
+	consolidationThreshold: number;
+	/** Stanford-style retrieval scoring weights */
+	scoreWeights: { recency: number; importance: number; relevance: number };
+	/** Utility-weighted eviction: access frequency vs base impact */
+	evictionWeights: { accessFrequency: number; baseImpact: number };
+	/** Default scope for all operations */
+	defaultScope?: MemoryScope;
+	/** Locale for LLM prompts and injection templates */
+	locale: "en" | "zh";
+	/** Strength growth factor on each successful recall (spaced repetition) */
+	strengthGrowthFactor: number;
+	/** Progressive recall injection configuration */
+	progressiveRecall: ProgressiveRecallConfig;
+	/** Default forgetting windows for less important memories */
+	forgetting: { ambientTtlDays: number; workTtlDays: number; reviveCooldownDays: number };
+	/** Embedding configuration for semantic episodic/procedural recall */
+	embeddings: EmbeddingConfig;
+	/** Weight for SAL structural proximity boost in V2 recall scoring (0 = disabled). */
+	structuralWeight: number;
+}
+
+const DEFAULT_BUDGET = {
+	lessons: 0.18,
+	knowledge: 0.17,
+	events: 0.15,
+	episodes: 0.18,
+	preferences: 0.1,
+	work: 0.2,
+	facets: 0.12,
+} as const;
+
+const DEFAULT_HALF_LIFE: Record<string, number> = {
+	lesson: 90,
+	fact: 60,
+	episode: 14,
+	preference: 120,
+	decision: 45,
+	entity: 30,
+	event: 180,
+	work: 45,
+	pattern: 180,
+	struggle: 120,
+};
+
+const DEFAULT_MAX_ENTRIES = { knowledge: 1000, lessons: 500, events: 300, preferences: 200, work: 400, facets: 400 };
+const DEFAULT_SCORE_WEIGHTS = { recency: 1, importance: 1, relevance: 1 };
+const DEFAULT_EVICTION_WEIGHTS = { accessFrequency: 0.4, baseImpact: 0.6 };
+const DEFAULT_PROGRESSIVE_RECALL: ProgressiveRecallConfig = {
+	thresholdActive: 0.7,
+	thresholdCue: 0.35,
+	budgetActive: 0.15,
+	budgetCue: 0.70,
+	forceRecentHours: 24,
+	forceImportanceMin: 9,
+};
+const DEFAULT_FORGETTING = {
+	ambientTtlDays: 45,
+	workTtlDays: 21,
+	reviveCooldownDays: 7,
+} as const;
+const DEFAULT_EMBEDDINGS: EmbeddingConfig = {
+	enabled: true,
+	model: "local-hash-v1",
+	dim: 256,
+	autoSync: true,
+};
+const DEFAULT_STRUCTURAL_WEIGHT = 0.15;
+
+export function getConfig(overrides?: Partial<NanomemConfig>): NanomemConfig {
+	const tokenBudget = 6000;
+	const memoryDir = overrides?.memoryDir || join("anno", "memory");
+	const locale = overrides?.locale || "en";
+	const embeddingsDim = DEFAULT_EMBEDDINGS.dim;
+	const embeddingsModel = DEFAULT_EMBEDDINGS.model;
+	return {
+		memoryDir,
+		tokenBudget: overrides?.tokenBudget ?? tokenBudget,
+		budget: overrides?.budget ?? { ...DEFAULT_BUDGET },
+		halfLife: overrides?.halfLife ?? { ...DEFAULT_HALF_LIFE },
+		maxEntries: overrides?.maxEntries ?? { ...DEFAULT_MAX_ENTRIES },
+		consolidationThreshold: overrides?.consolidationThreshold ?? 10,
+		scoreWeights: overrides?.scoreWeights ?? { ...DEFAULT_SCORE_WEIGHTS },
+		evictionWeights: overrides?.evictionWeights ?? { ...DEFAULT_EVICTION_WEIGHTS },
+		defaultScope: overrides?.defaultScope,
+		locale,
+		strengthGrowthFactor: overrides?.strengthGrowthFactor ?? 1.5,
+		progressiveRecall: overrides?.progressiveRecall ?? { ...DEFAULT_PROGRESSIVE_RECALL },
+		forgetting: overrides?.forgetting ?? { ...DEFAULT_FORGETTING },
+		embeddings:
+			overrides?.embeddings ??
+			{
+				enabled: DEFAULT_EMBEDDINGS.enabled,
+				model: embeddingsModel,
+				dim: embeddingsDim,
+				autoSync: DEFAULT_EMBEDDINGS.autoSync,
+			},
+		structuralWeight: overrides?.structuralWeight ?? DEFAULT_STRUCTURAL_WEIGHT,
+	};
+}