memory-forge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shelby-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# MemoryForge
+
+> 唯一基于去中心化热存储、链上可验证、合规可审计的 AI Agent 记忆引擎。
+
+## 一句话定位
+
+MemoryForge = 基于 Shelby 协议 + MCP 标准的去中心化 AI Agent 持久记忆引擎。一键嵌入 Claude Code / Cursor / Codex / Devin / Windsurf。
+
+## 为什么需要 MemoryForge
+
+现在的 AI Agent 都是**失忆的**——关闭会话就忘记一切。换平台从零开始。无法验证记忆的真伪。
+
+MemoryForge 解决这三个问题：
+1. **持久化**：记忆存 Shelby 去中心化热存储，跨会话、跨平台
+2. **可验证**：每条记忆有 链上哈希证明，无法篡改
+3. **合规**：GDPR 被遗忘权 + 不可篡改审计链
+
+## 快速开始
+
+```bash
+# 一键自动配置所有 Agent 平台
+npx memory-forge setup
+# → 自动检测 Claude Code / Cursor / Windsurf / VS Code / Codex / Devin
+# → 需要 Shelby API Key（在 docs.shelby.xyz/sdks/typescript/acquire-api-keys 获取）
+
+# 或手动嵌入 Claude Code
+claude mcp add memory-forge -- npx memory-forge
+```
+
+## 核心能力
+
+| 能力 | 说明 |
+|------|------|
+| 去中心化存储 | Shelby 热存储（亚秒级读取，~70% 比 AWS 便宜） |
+| 链上可验证 | 每条记忆有 Aptos 链上证明 |
+| MCP 标准 | 一键嵌入全部 Agent 平台 |
+| Git 式版本控制 | 分支、回滚、diff、合并 |
+| 自动冲突解决 | 确定性算法，非 LLM 判断 |
+| Token 效率 | slim 模式（73% 减少），universal 模式（98% 减少） |
+| 企业合规 | GDPR / HIPAA / SOC2 审计链 |
+| 记忆市场 | 用户可交易记忆包 |
+
+## 定价
+
+| 方案 | 价格 | 说明 |
+|------|------|------|
+| Free | $0 | 核心层 7 工具，100 条记忆，本地模式 |
+| Pro | $7/月 | + 差异层（链上哈希验证/导出/冲突解决），10K 记忆，Shelby 存储 |
+| Team | $19/月 | 全 15 工具，50K 记忆，SSE 远程，多 Agent 协作 |
+| Enterprise | $149/月 | + 链上哈希审计 + SSO + SLA + 合规报告 |
+
+## 项目结构
+
+```
+memory-forge/
+├── README.md           # 本文件
+├── SPEC.md             # 完整产品规格
+├── MARKET.md           # 市场分析与竞品
+├── ARCHITECTURE.md     # 系统架构
+├── REVENUE.md          # 收入模型
+├── package.json        # npm 配置
+├── tsconfig.json       # TypeScript 配置
+└── src/
+    └── index.ts        # MCP Server 入口
+```
+
+## 技术栈
+
+- **MCP 协议**：`@modelcontextprotocol/sdk`
+- **存储层**：`@shelby-protocol/sdk` (Shelby Protocol)
+- **嵌入**：本地 Ollama / OpenAI 可切换
+- **链上**：Aptos 交易哈希 + 链上存储证明
+- **运行时**：Node.js 18+, TypeScript

package/dist/auto/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 后台自动化引擎: 全部用户无感知。
+ */
+import type { MemoryStore, Memory } from "../store.js";
+/** 自动命名: 从内容中提取前几个字作为名称 */
+export declare function autoName(content: string): string;
+/** 自动合并: 检测相似内容并合并（异步，重新计算向量） */
+export declare function autoMerge(store: MemoryStore, newMemory: Memory): Promise<Memory | null>;
+/** 自动优先级: 基于访问频率 */
+export declare function autoPriority(memory: Memory): number;
+/** 自动衰减: Ebbinghaus 遗忘曲线 */
+export declare function autoDecay(memory: Memory): number;
+/** 生成上下文摘要给 Agent 注入 */
+export declare function generateContextSummary(store: MemoryStore, limit?: number): string;

package/dist/auto/index.js

@@ -0,0 +1,90 @@
+/**
+ * 后台自动化引擎: 全部用户无感知。
+ */
+import { saveMemory } from "../storage/local.js";
+import { embed } from "../embedding.js";
+/** 自动命名: 从内容中提取前几个字作为名称 */
+export function autoName(content) {
+    // Strip code blocks, trim to ~30 chars
+    const clean = content.replace(/```[\s\S]*?```/g, "").replace(/`/g, "").trim();
+    const name = clean.slice(0, 40).replace(/\n/g, " ").trim();
+    return name || "memory";
+}
+/** 自动合并: 检测相似内容并合并（异步，重新计算向量） */
+export async function autoMerge(store, newMemory) {
+    const all = [...store.list({ limit: 100, offset: 0 })];
+    if (all.length === 0)
+        return null;
+    for (const existing of all) {
+        if (existing.id === newMemory.id)
+            continue;
+        const similarity = contentOverlap(existing.content, newMemory.content);
+        if (similarity > 0.8) {
+            // Merge: update existing with new content + fresh vector
+            existing.content = newMemory.content;
+            existing.access_count++;
+            existing.last_accessed = new Date().toISOString();
+            // Recompute vector for merged content
+            const vec = await embed(existing.content);
+            if (vec)
+                existing.vector = Array.from(vec);
+            saveMemory(existing);
+            store.remove(existing.id);
+            store.add(existing);
+            return existing;
+        }
+    }
+    return null;
+}
+/** 自动优先级: 基于访问频率 */
+export function autoPriority(memory) {
+    const age = Date.now() - new Date(memory.created_at).getTime();
+    const ageDays = age / 86400000;
+    const freqWeight = Math.min(memory.access_count, 50) / 50;
+    const recencyWeight = memory.last_accessed
+        ? Math.max(0, 1 - (Date.now() - new Date(memory.last_accessed).getTime()) / (90 * 86400000))
+        : 0.5;
+    return Math.round(1 + 9 * (freqWeight * 0.4 + recencyWeight * 0.4 + (1 - Math.min(ageDays, 365) / 365) * 0.2));
+}
+/** 自动衰减: Ebbinghaus 遗忘曲线 */
+export function autoDecay(memory) {
+    const daysSinceAccess = memory.last_accessed
+        ? (Date.now() - new Date(memory.last_accessed).getTime()) / 86400000
+        : (Date.now() - new Date(memory.created_at).getTime()) / 86400000;
+    const d = Math.floor(daysSinceAccess);
+    if (d <= 1)
+        return 1.0;
+    if (d <= 7)
+        return 0.8;
+    if (d <= 30)
+        return 0.5;
+    if (d <= 90)
+        return 0.2;
+    return 0; // archive
+}
+/** 内容重叠度 (Jaccard 近似) */
+function contentOverlap(a, b) {
+    const setA = new Set(a.toLowerCase().split(/\s+/).filter((w) => w.length > 2));
+    const setB = new Set(b.toLowerCase().split(/\s+/).filter((w) => w.length > 2));
+    if (setA.size === 0 || setB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const w of setA) {
+        if (setB.has(w))
+            intersection++;
+    }
+    return intersection / Math.min(setA.size, setB.size);
+}
+/** 生成上下文摘要给 Agent 注入 */
+export function generateContextSummary(store, limit = 5) {
+    const all = store.list({ limit: 100, offset: 0 });
+    const top = all
+        .sort((a, b) => (b.access_count - a.access_count) || ((b.priority || 5) - (a.priority || 5)))
+        .slice(0, limit);
+    if (top.length === 0)
+        return "";
+    return top
+        .map((m) => `- [${m.name}] ${m.content.slice(0, 150)}${m.content.length > 150 ? "…" : ""}`)
+        .join("\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/auto/index.js.map

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

package/dist/embedding.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 嵌入引擎: Transformers.js 进程内运行，23MB 模型，零外部服务。
+ * 延迟加载: 首次调用时加载模型，后续毫秒级。
+ * 降级: 加载失败 → 返回 null，memory_search 自动回退到关键词匹配。
+ */
+/** 重试模型加载（后台调用，不阻塞） */
+export declare function retryEmbedder(): void;
+export declare function embed(text: string): Promise<Float32Array | null>;
+/** 预加载模型（后台运行，不阻塞） */
+export declare function preload(): void;

package/dist/embedding.js

@@ -0,0 +1,66 @@
+/**
+ * 嵌入引擎: Transformers.js 进程内运行，23MB 模型，零外部服务。
+ * 延迟加载: 首次调用时加载模型，后续毫秒级。
+ * 降级: 加载失败 → 返回 null，memory_search 自动回退到关键词匹配。
+ */
+let embedFn = null;
+let loading = null;
+let lastAttempt = 0;
+const RETRY_MS = 300_000; // 5 min before retry after failure
+async function getEmbedder() {
+    // Auto-retry: if model failed, clear cache after RETRY_MS for next attempt
+    if (embedFn && lastAttempt > 0 && Date.now() - lastAttempt >= RETRY_MS) {
+        console.error("[MemoryForge] Retrying embedding model download...");
+        embedFn = null;
+        loading = null;
+    }
+    if (embedFn)
+        return embedFn;
+    if (loading)
+        return loading;
+    loading = (async () => {
+        try {
+            const { pipeline } = await import("@huggingface/transformers");
+            const engine = await pipeline("feature-extraction", "Xenova/all-MiniLM-L6-v2");
+            embedFn = async (text) => {
+                const result = await engine(text, { pooling: "mean", normalize: true });
+                return new Float32Array(result.data);
+            };
+            lastAttempt = 0;
+            return embedFn;
+        }
+        catch (err) {
+            console.error("[MemoryForge] Failed to load embedding model:", err.message);
+            console.error(`[MemoryForge] Falling back to keyword matching (retry in ${RETRY_MS / 1000}s).`);
+            lastAttempt = Date.now();
+            embedFn = async () => null;
+            return embedFn;
+        }
+    })();
+    return loading;
+}
+/** 重试模型加载（后台调用，不阻塞） */
+export function retryEmbedder() {
+    if (!embedFn || lastAttempt === 0)
+        return;
+    if (Date.now() - lastAttempt < RETRY_MS)
+        return;
+    console.error("[MemoryForge] Retrying embedding model download...");
+    embedFn = null;
+    loading = null;
+    getEmbedder();
+}
+export async function embed(text) {
+    const fn = await getEmbedder();
+    try {
+        return await fn(text);
+    }
+    catch {
+        return null;
+    }
+}
+/** 预加载模型（后台运行，不阻塞） */
+export function preload() {
+    getEmbedder();
+}
+//# sourceMappingURL=embedding.js.map

package/dist/embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.js","sourceRoot":"","sources":["../src/embedding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,IAAI,OAAO,GAAmB,IAAI,CAAC;AACnC,IAAI,OAAO,GAA4B,IAAI,CAAC;AAC5C,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,mCAAmC;AAE7D,KAAK,UAAU,WAAW;IACxB,2EAA2E;IAC3E,IAAI,OAAO,IAAI,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,IAAI,QAAQ,EAAE,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,GAAG,IAAI,CAAC;QACf,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CAAC;YAC/E,OAAO,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE;gBAC/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxE,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC,CAAC;YACF,WAAW,GAAG,CAAC,CAAC;YAChB,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;YACvF,OAAO,CAAC,KAAK,CAAC,4DAA4D,QAAQ,GAAG,IAAI,KAAK,CAAC,CAAC;YAChG,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;YAC3B,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,OAAO,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO;IAC1C,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,GAAG,QAAQ;QAAE,OAAO;IAEhD,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACpE,OAAO,GAAG,IAAI,CAAC;IACf,OAAO,GAAG,IAAI,CAAC;IACf,WAAW,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY;IACtC,MAAM,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,OAAO;IACrB,WAAW,EAAE,CAAC;AAChB,CAAC"}

package/dist/hooks/install.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Claude Code hooks 自动配置。
+ * 写入 ~/.claude/settings.json，自动添加 SessionStart/Stop/PreCompact hooks。
+ */
+export declare function installHooks(): boolean;
+export declare function getHooksStatus(): {
+    sessionStart: boolean;
+    stop: boolean;
+    preCompact: boolean;
+};

package/dist/hooks/install.js

@@ -0,0 +1,65 @@
+/**
+ * Claude Code hooks 自动配置。
+ * 写入 ~/.claude/settings.json，自动添加 SessionStart/Stop/PreCompact hooks。
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const CLAUDE_SETTINGS = path.join(process.env.HOME ?? process.env.USERPROFILE ?? "/tmp", ".claude", "settings.json");
+export function installHooks() {
+    try {
+        const dir = path.dirname(CLAUDE_SETTINGS);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        let config = {};
+        if (fs.existsSync(CLAUDE_SETTINGS)) {
+            const raw = fs.readFileSync(CLAUDE_SETTINGS, "utf-8");
+            config = JSON.parse(raw);
+        }
+        if (!config.hooks)
+            config.hooks = {};
+        const mfCmd = "npx memory-forge";
+        config.hooks.SessionStart = config.hooks.SessionStart || [];
+        if (!hasHook(config.hooks.SessionStart, "memory-forge")) {
+            config.hooks.SessionStart.push({
+                hooks: [{ type: "command", command: `${mfCmd} hook session-start` }],
+            });
+        }
+        config.hooks.Stop = config.hooks.Stop || [];
+        if (!hasHook(config.hooks.Stop, "memory-forge")) {
+            config.hooks.Stop.push({
+                hooks: [{ type: "command", command: `${mfCmd} hook stop` }],
+            });
+        }
+        config.hooks.PreCompact = config.hooks.PreCompact || [];
+        if (!hasHook(config.hooks.PreCompact, "memory-forge")) {
+            config.hooks.PreCompact.push({
+                hooks: [{ type: "command", command: `${mfCmd} hook pre-compact` }],
+            });
+        }
+        fs.writeFileSync(CLAUDE_SETTINGS, JSON.stringify(config, null, 2));
+        return true;
+    }
+    catch (err) {
+        console.error("[MemoryForge] Failed to install hooks:", err.message);
+        return false;
+    }
+}
+function hasHook(hooks, name) {
+    return hooks.some((h) => h.hooks?.some((inner) => inner.command?.includes(name)));
+}
+export function getHooksStatus() {
+    try {
+        if (!fs.existsSync(CLAUDE_SETTINGS))
+            return { sessionStart: false, stop: false, preCompact: false };
+        const config = JSON.parse(fs.readFileSync(CLAUDE_SETTINGS, "utf-8"));
+        return {
+            sessionStart: hasHook(config.hooks?.SessionStart || [], "memory-forge"),
+            stop: hasHook(config.hooks?.Stop || [], "memory-forge"),
+            preCompact: hasHook(config.hooks?.PreCompact || [], "memory-forge"),
+        };
+    }
+    catch {
+        return { sessionStart: false, stop: false, preCompact: false };
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/hooks/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/hooks/install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EACrD,SAAS,EACT,eAAe,CAChB,CAAC;AAEF,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhE,IAAI,MAAM,GAAQ,EAAE,CAAC;QACrB,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;QAErC,MAAM,KAAK,GAAG,kBAAkB,CAAC;QAEjC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC;gBAC7B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,qBAAqB,EAAE,CAAC;aACrE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrB,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,YAAY,EAAE,CAAC;aAC5D,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC3B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,mBAAmB,EAAE,CAAC;aACnE,CAAC,CAAC;QACL,CAAC;QAED,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;QAChF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,KAAY,EAAE,IAAY;IACzC,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,CAAM,EAAE,EAAE,CACT,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC;YAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACpG,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QACrE,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,IAAI,EAAE,EAAE,cAAc,CAAC;YACvE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,EAAE,cAAc,CAAC;YACvD,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,UAAU,IAAI,EAAE,EAAE,cAAc,CAAC;SACpE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * MemoryForge — AI Agent 持久记忆引擎 (MVP)
+ *
+ * 8 个 MCP 工具 + 5 个后台自动化引擎 + Pro 层 Shelby 云同步。
+ * 嵌入: Transformers.js (23MB, 进程内)。
+ * 存储: Free 层本地 Markdown; Pro 层 Shelby 云。
+ *
+ * 一键嵌入:
+ *   claude mcp add memory-forge -- npx memory-forge
+ */
+export {};