@specpow/framework 0.2.0

package/dist/core/memory/adapters/json-adapter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 增强型 JSON 记忆存储适配器
+ *
+ * 作为 FileMemoryStore 的增强版，支持多文件分片
+ * 适用于大规模记忆数据场景
+ *
+ * 存储结构：
+ * .specpow/memory/
+ *   ├── index.json          # 主索引（元数据）
+ *   ├── shards/             # 分片目录
+ *   │   ├── shard-001.json  # 分片文件
+ *   │   ├── shard-002.json
+ *   │   └── ...
+ *   ├── sessions/           # 会话日志
+ *   └── archives/           # 归档记忆
+ */
+import type { MemoryIndex, MemoryStore, SessionLog } from '../memory-types.js';
+export interface ShardedJsonStoreOptions {
+    /** 每个分片的最大条目数，默认 1000 */
+    maxEntriesPerShard?: number;
+    /** 项目根目录 */
+    projectRoot: string;
+}
+export declare class ShardedJsonStore implements MemoryStore {
+    private memoryDir;
+    private shardsDir;
+    private sessionsDir;
+    private archivesDir;
+    private indexPath;
+    private maxEntriesPerShard;
+    constructor(options: ShardedJsonStoreOptions);
+    private ensureDirs;
+    load(): Promise<MemoryIndex>;
+    save(index: MemoryIndex): Promise<void>;
+    private extractShardIndex;
+    clear(): Promise<void>;
+    saveSessionLog(sessionId: string, log: SessionLog): void;
+    loadSessionLog(sessionId: string): SessionLog | null;
+    listSessionIds(): string[];
+    /**
+     * 获取分片统计信息
+     */
+    getShardStats(): {
+        totalShards: number;
+        totalEntries: number;
+        shardSizes: number[];
+    };
+    private getShardFiles;
+}
+//# sourceMappingURL=json-adapter.d.ts.map

package/dist/core/memory/adapters/json-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-adapter.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/adapters/json-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,OAAO,EAAE,uBAAuB;IAU5C,OAAO,CAAC,UAAU;IAQZ,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IA8D5B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwG7C,OAAO,CAAC,iBAAiB;IAKnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;IAKxD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAapD,cAAc,IAAI,MAAM,EAAE;IAU1B;;OAEG;IACH,aAAa,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;IAoBpF,OAAO,CAAC,aAAa;CAUtB"}

package/dist/core/memory/adapters/json-adapter.js

@@ -0,0 +1,273 @@
+/**
+ * 增强型 JSON 记忆存储适配器
+ *
+ * 作为 FileMemoryStore 的增强版，支持多文件分片
+ * 适用于大规模记忆数据场景
+ *
+ * 存储结构：
+ * .specpow/memory/
+ *   ├── index.json          # 主索引（元数据）
+ *   ├── shards/             # 分片目录
+ *   │   ├── shard-001.json  # 分片文件
+ *   │   ├── shard-002.json
+ *   │   └── ...
+ *   ├── sessions/           # 会话日志
+ *   └── archives/           # 归档记忆
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSync, unlinkSync } from 'fs';
+import { join } from 'path';
+export class ShardedJsonStore {
+    memoryDir;
+    shardsDir;
+    sessionsDir;
+    archivesDir;
+    indexPath;
+    maxEntriesPerShard;
+    constructor(options) {
+        this.memoryDir = join(options.projectRoot, '.specpow', 'memory');
+        this.shardsDir = join(this.memoryDir, 'shards');
+        this.sessionsDir = join(this.memoryDir, 'sessions');
+        this.archivesDir = join(this.memoryDir, 'archives');
+        this.indexPath = join(this.memoryDir, 'index.json');
+        this.maxEntriesPerShard = options.maxEntriesPerShard ?? 1000;
+        this.ensureDirs();
+    }
+    ensureDirs() {
+        for (const dir of [this.memoryDir, this.shardsDir, this.sessionsDir, this.archivesDir]) {
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+        }
+    }
+    async load() {
+        const index = {
+            entries: new Map(),
+            keywords: new Map(),
+            phases: new Map(),
+            sessions: new Map(),
+            timeline: [],
+        };
+        // 从所有分片加载数据
+        const shardFiles = this.getShardFiles();
+        for (const shardFile of shardFiles) {
+            try {
+                const data = JSON.parse(readFileSync(shardFile, 'utf-8'));
+                if (data.entries) {
+                    for (const [id, entry] of data.entries) {
+                        index.entries.set(id, entry);
+                        index.timeline.push(entry);
+                    }
+                }
+                if (data.keywords) {
+                    for (const [k, v] of data.keywords) {
+                        if (!index.keywords.has(k)) {
+                            index.keywords.set(k, new Set());
+                        }
+                        for (const id of v) {
+                            index.keywords.get(k).add(id);
+                        }
+                    }
+                }
+                if (data.phases) {
+                    for (const [k, v] of data.phases) {
+                        const phase = k;
+                        if (!index.phases.has(phase)) {
+                            index.phases.set(phase, new Set());
+                        }
+                        for (const id of v) {
+                            index.phases.get(phase).add(id);
+                        }
+                    }
+                }
+                if (data.sessions) {
+                    for (const [k, v] of data.sessions) {
+                        if (!index.sessions.has(k)) {
+                            index.sessions.set(k, new Set());
+                        }
+                        for (const id of v) {
+                            index.sessions.get(k).add(id);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                console.warn(`Failed to load shard ${shardFile}:`, err);
+            }
+        }
+        // 按时间排序 timeline
+        index.timeline.sort((a, b) => a.timestamp - b.timestamp);
+        return index;
+    }
+    async save(index) {
+        // 将数据分片存储
+        const entries = Array.from(index.entries.values());
+        const totalShards = Math.ceil(entries.length / this.maxEntriesPerShard) || 1;
+        // 获取现有分片用于增量比较
+        const existingShards = this.getShardFiles();
+        const existingShardData = new Map();
+        // 读取现有分片内容用于比较
+        for (const shardFile of existingShards) {
+            try {
+                const content = readFileSync(shardFile, 'utf-8');
+                const shardIndex = this.extractShardIndex(shardFile);
+                existingShardData.set(String(shardIndex), content);
+            }
+            catch {
+                // 忽略读取失败的分片
+            }
+        }
+        // 写入新分片（增量更新）
+        const writtenShards = new Set();
+        for (let i = 0; i < totalShards; i++) {
+            const start = i * this.maxEntriesPerShard;
+            const end = Math.min(start + this.maxEntriesPerShard, entries.length);
+            const shardEntries = entries.slice(start, end);
+            // 构建该分片的索引
+            const shardEntryIds = new Set(shardEntries.map(e => e.id));
+            const shardKeywords = [];
+            const shardPhases = [];
+            const shardSessions = [];
+            // 收集该分片相关的索引数据
+            for (const [keyword, ids] of index.keywords.entries()) {
+                const filtered = Array.from(ids).filter(id => shardEntryIds.has(id));
+                if (filtered.length > 0) {
+                    shardKeywords.push([keyword, filtered]);
+                }
+            }
+            for (const [phase, ids] of index.phases.entries()) {
+                const filtered = Array.from(ids).filter(id => shardEntryIds.has(id));
+                if (filtered.length > 0) {
+                    shardPhases.push([phase, filtered]);
+                }
+            }
+            for (const [sessionId, ids] of index.sessions.entries()) {
+                const filtered = Array.from(ids).filter(id => shardEntryIds.has(id));
+                if (filtered.length > 0) {
+                    shardSessions.push([sessionId, filtered]);
+                }
+            }
+            const shardData = {
+                version: 1,
+                shardIndex: i,
+                entries: shardEntries.map(e => [e.id, e]),
+                keywords: shardKeywords,
+                phases: shardPhases,
+                sessions: shardSessions,
+            };
+            const newContent = JSON.stringify(shardData, null, 2);
+            const shardPath = join(this.shardsDir, `shard-${String(i + 1).padStart(3, '0')}.json`);
+            const shardKey = String(i);
+            // 仅当内容变化时才写入（增量更新）
+            const existingContent = existingShardData.get(shardKey);
+            if (existingContent !== newContent) {
+                // 原子写入：先写临时文件，再重命名
+                const tempPath = shardPath + '.tmp';
+                writeFileSync(tempPath, newContent, 'utf-8');
+                // 重命名是原子操作
+                const { renameSync } = await import('fs');
+                renameSync(tempPath, shardPath);
+            }
+            writtenShards.add(shardKey);
+        }
+        // 删除多余的分片（数据减少的情况）
+        for (const shardFile of existingShards) {
+            const index = this.extractShardIndex(shardFile);
+            if (!writtenShards.has(String(index))) {
+                unlinkSync(shardFile);
+            }
+        }
+        // 保存主索引元数据（原子写入）
+        const indexMeta = {
+            version: 1,
+            totalEntries: index.entries.size,
+            totalShards,
+            maxEntriesPerShard: this.maxEntriesPerShard,
+            lastUpdated: Date.now(),
+        };
+        const tempIndexPath = this.indexPath + '.tmp';
+        writeFileSync(tempIndexPath, JSON.stringify(indexMeta, null, 2), 'utf-8');
+        const { renameSync } = await import('fs');
+        renameSync(tempIndexPath, this.indexPath);
+    }
+    extractShardIndex(shardPath) {
+        const match = shardPath.match(/shard-(\d+)\.json$/);
+        return match ? parseInt(match[1], 10) - 1 : -1;
+    }
+    async clear() {
+        // 删除所有分片
+        const shardFiles = this.getShardFiles();
+        for (const shardFile of shardFiles) {
+            unlinkSync(shardFile);
+        }
+        // 清空会话日志
+        if (existsSync(this.sessionsDir)) {
+            const files = readdirSync(this.sessionsDir);
+            for (const file of files) {
+                const filePath = join(this.sessionsDir, file);
+                const stat = statSync(filePath);
+                if (stat.isFile()) {
+                    unlinkSync(filePath);
+                }
+            }
+        }
+        // 删除索引文件
+        if (existsSync(this.indexPath)) {
+            unlinkSync(this.indexPath);
+        }
+    }
+    saveSessionLog(sessionId, log) {
+        const logPath = join(this.sessionsDir, `${sessionId}.json`);
+        writeFileSync(logPath, JSON.stringify(log, null, 2), 'utf-8');
+    }
+    loadSessionLog(sessionId) {
+        const logPath = join(this.sessionsDir, `${sessionId}.json`);
+        if (!existsSync(logPath)) {
+            return null;
+        }
+        try {
+            return JSON.parse(readFileSync(logPath, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    listSessionIds() {
+        if (!existsSync(this.sessionsDir)) {
+            return [];
+        }
+        return readdirSync(this.sessionsDir)
+            .filter(f => f.endsWith('.json'))
+            .map(f => f.replace('.json', ''));
+    }
+    /**
+     * 获取分片统计信息
+     */
+    getShardStats() {
+        const shardFiles = this.getShardFiles();
+        const shardSizes = [];
+        for (const shardFile of shardFiles) {
+            try {
+                const data = JSON.parse(readFileSync(shardFile, 'utf-8'));
+                shardSizes.push(data.entries?.length || 0);
+            }
+            catch {
+                shardSizes.push(0);
+            }
+        }
+        return {
+            totalShards: shardFiles.length,
+            totalEntries: shardSizes.reduce((a, b) => a + b, 0),
+            shardSizes,
+        };
+    }
+    getShardFiles() {
+        if (!existsSync(this.shardsDir)) {
+            return [];
+        }
+        return readdirSync(this.shardsDir)
+            .filter(f => f.startsWith('shard-') && f.endsWith('.json'))
+            .map(f => join(this.shardsDir, f))
+            .sort();
+    }
+}
+//# sourceMappingURL=json-adapter.js.map

package/dist/core/memory/adapters/json-adapter.js.map

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

package/dist/core/memory/adapters/sqlite-adapter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SQLite 记忆存储适配器
+ *
+ * 使用 better-sqlite3 实现 MemoryStore 接口
+ * 提供高性能的本地数据库存储
+ */
+import type { MemoryIndex, MemoryStore, SessionLog } from '../memory-types.js';
+export declare class SqliteMemoryStore implements MemoryStore {
+    private db;
+    private dbPath;
+    constructor(projectRoot: string, dbName?: string);
+    private stmts;
+    private prepareStatements;
+    private initSchema;
+    load(): Promise<MemoryIndex>;
+    save(index: MemoryIndex): Promise<void>;
+    clear(): Promise<void>;
+    saveSessionLog(sessionId: string, log: SessionLog): void;
+    loadSessionLog(sessionId: string): SessionLog | null;
+    listSessionIds(): string[];
+    /**
+     * 关闭数据库连接
+     */
+    close(): void;
+}
+//# sourceMappingURL=sqlite-adapter.d.ts.map

package/dist/core/memory/adapters/sqlite-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/adapters/sqlite-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAEX,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,WAAW,EAAE,MAAM,EAAE,MAAM,SAAc;IAiBrD,OAAO,CAAC,KAAK,CAYX;IAEF,OAAO,CAAC,iBAAiB;IAsCzB,OAAO,CAAC,UAAU;IA+DZ,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IA4D5B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI;IAIxD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQpD,cAAc,IAAI,MAAM,EAAE;IAK1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/memory/adapters/sqlite-adapter.js

@@ -0,0 +1,230 @@
+/**
+ * SQLite 记忆存储适配器
+ *
+ * 使用 better-sqlite3 实现 MemoryStore 接口
+ * 提供高性能的本地数据库存储
+ */
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+export class SqliteMemoryStore {
+    db;
+    dbPath;
+    constructor(projectRoot, dbName = 'memory.db') {
+        const memoryDir = join(projectRoot, '.specpow', 'memory');
+        if (!existsSync(memoryDir)) {
+            mkdirSync(memoryDir, { recursive: true });
+        }
+        this.dbPath = join(memoryDir, dbName);
+        this.db = new Database(this.dbPath);
+        // 启用 WAL 模式提升并发读写性能
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.initSchema();
+        this.prepareStatements();
+    }
+    // 预编译语句缓存
+    stmts = {
+        insertEntry: null,
+        insertKeyword: null,
+        insertPhase: null,
+        insertSession: null,
+        loadEntries: null,
+        loadKeywords: null,
+        loadPhases: null,
+        loadSessions: null,
+        loadSessionLog: null,
+        saveSessionLog: null,
+        listSessionIds: null,
+    };
+    prepareStatements() {
+        this.stmts.insertEntry = this.db.prepare(`
+      INSERT OR REPLACE INTO memory_entries (id, timestamp, session_id, phase, content, keywords, relevance, metadata)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        this.stmts.insertKeyword = this.db.prepare(`
+      INSERT OR IGNORE INTO keyword_index (keyword, entry_id) VALUES (?, ?)
+    `);
+        this.stmts.insertPhase = this.db.prepare(`
+      INSERT OR IGNORE INTO phase_index (phase, entry_id) VALUES (?, ?)
+    `);
+        this.stmts.insertSession = this.db.prepare(`
+      INSERT OR IGNORE INTO session_index (session_id, entry_id) VALUES (?, ?)
+    `);
+        this.stmts.loadEntries = this.db.prepare('SELECT * FROM memory_entries ORDER BY timestamp');
+        this.stmts.loadKeywords = this.db.prepare('SELECT keyword, entry_id FROM keyword_index');
+        this.stmts.loadPhases = this.db.prepare('SELECT phase, entry_id FROM phase_index');
+        this.stmts.loadSessions = this.db.prepare('SELECT session_id, entry_id FROM session_index');
+        this.stmts.loadSessionLog = this.db.prepare('SELECT log_data FROM session_logs WHERE session_id = ?');
+        this.stmts.saveSessionLog = this.db.prepare(`
+      INSERT OR REPLACE INTO session_logs (session_id, log_data, created_at)
+      VALUES (?, ?, ?)
+    `);
+        this.stmts.listSessionIds = this.db.prepare('SELECT session_id FROM session_logs');
+    }
+    initSchema() {
+        // 创建记忆条目表
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS memory_entries (
+        id TEXT PRIMARY KEY,
+        timestamp INTEGER NOT NULL,
+        session_id TEXT NOT NULL,
+        phase TEXT NOT NULL,
+        content TEXT NOT NULL,
+        keywords TEXT NOT NULL,
+        relevance REAL NOT NULL,
+        metadata TEXT NOT NULL
+      )
+    `);
+        // 创建关键词索引表
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS keyword_index (
+        keyword TEXT NOT NULL,
+        entry_id TEXT NOT NULL,
+        PRIMARY KEY (keyword, entry_id),
+        FOREIGN KEY (entry_id) REFERENCES memory_entries(id) ON DELETE CASCADE
+      )
+    `);
+        // 创建阶段索引表
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS phase_index (
+        phase TEXT NOT NULL,
+        entry_id TEXT NOT NULL,
+        PRIMARY KEY (phase, entry_id),
+        FOREIGN KEY (entry_id) REFERENCES memory_entries(id) ON DELETE CASCADE
+      )
+    `);
+        // 创建会话索引表
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS session_index (
+        session_id TEXT NOT NULL,
+        entry_id TEXT NOT NULL,
+        PRIMARY KEY (session_id, entry_id),
+        FOREIGN KEY (entry_id) REFERENCES memory_entries(id) ON DELETE CASCADE
+      )
+    `);
+        // 创建会话日志表
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS session_logs (
+        session_id TEXT PRIMARY KEY,
+        log_data TEXT NOT NULL,
+        created_at INTEGER NOT NULL
+      )
+    `);
+        // 创建索引以加速查询
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_entries_timestamp ON memory_entries(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_entries_session ON memory_entries(session_id);
+      CREATE INDEX IF NOT EXISTS idx_entries_phase ON memory_entries(phase);
+      CREATE INDEX IF NOT EXISTS idx_keyword_keyword ON keyword_index(keyword);
+    `);
+    }
+    async load() {
+        const index = {
+            entries: new Map(),
+            keywords: new Map(),
+            phases: new Map(),
+            sessions: new Map(),
+            timeline: [],
+        };
+        // 使用预编译缓存的语句加载数据
+        const entries = this.stmts.loadEntries.all();
+        for (const row of entries) {
+            const entry = {
+                id: row.id,
+                timestamp: row.timestamp,
+                sessionId: row.session_id,
+                phase: row.phase,
+                content: row.content,
+                keywords: JSON.parse(row.keywords),
+                relevance: row.relevance,
+                metadata: JSON.parse(row.metadata),
+            };
+            index.entries.set(entry.id, entry);
+            index.timeline.push(entry);
+        }
+        // 加载关键词索引
+        const keywords = this.stmts.loadKeywords.all();
+        for (const row of keywords) {
+            if (!index.keywords.has(row.keyword)) {
+                index.keywords.set(row.keyword, new Set());
+            }
+            index.keywords.get(row.keyword).add(row.entry_id);
+        }
+        // 加载阶段索引
+        const phases = this.stmts.loadPhases.all();
+        for (const row of phases) {
+            const phase = row.phase;
+            if (!index.phases.has(phase)) {
+                index.phases.set(phase, new Set());
+            }
+            index.phases.get(phase).add(row.entry_id);
+        }
+        // 加载会话索引
+        const sessions = this.stmts.loadSessions.all();
+        for (const row of sessions) {
+            if (!index.sessions.has(row.session_id)) {
+                index.sessions.set(row.session_id, new Set());
+            }
+            index.sessions.get(row.session_id).add(row.entry_id);
+        }
+        // 显式排序 timeline（SQL ORDER BY 已排序，此为安全冗余）
+        index.timeline.sort((a, b) => a.timestamp - b.timestamp);
+        return index;
+    }
+    async save(index) {
+        // 使用事务确保原子性
+        const transaction = this.db.transaction(() => {
+            // 清空现有数据
+            this.db.exec('DELETE FROM memory_entries');
+            this.db.exec('DELETE FROM keyword_index');
+            this.db.exec('DELETE FROM phase_index');
+            this.db.exec('DELETE FROM session_index');
+            // 使用预编译缓存的语句
+            const insertEntry = this.stmts.insertEntry;
+            const insertKeyword = this.stmts.insertKeyword;
+            const insertPhase = this.stmts.insertPhase;
+            const insertSession = this.stmts.insertSession;
+            for (const entry of index.entries.values()) {
+                insertEntry.run(entry.id, entry.timestamp, entry.sessionId, entry.phase, entry.content, JSON.stringify(entry.keywords), entry.relevance, JSON.stringify(entry.metadata));
+                // 插入关键词索引
+                for (const keyword of entry.keywords) {
+                    insertKeyword.run(keyword, entry.id);
+                }
+                // 插入阶段索引
+                insertPhase.run(entry.phase, entry.id);
+                // 插入会话索引
+                insertSession.run(entry.sessionId, entry.id);
+            }
+        });
+        transaction();
+    }
+    async clear() {
+        this.db.exec('DELETE FROM memory_entries');
+        this.db.exec('DELETE FROM keyword_index');
+        this.db.exec('DELETE FROM phase_index');
+        this.db.exec('DELETE FROM session_index');
+        this.db.exec('DELETE FROM session_logs');
+    }
+    saveSessionLog(sessionId, log) {
+        this.stmts.saveSessionLog.run(sessionId, JSON.stringify(log), Date.now());
+    }
+    loadSessionLog(sessionId) {
+        const row = this.stmts.loadSessionLog.get(sessionId);
+        if (!row) {
+            return null;
+        }
+        return JSON.parse(row.log_data);
+    }
+    listSessionIds() {
+        const rows = this.stmts.listSessionIds.all();
+        return rows.map(r => r.session_id);
+    }
+    /**
+     * 关闭数据库连接
+     */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite-adapter.js.map

package/dist/core/memory/adapters/sqlite-adapter.js.map

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

package/dist/core/memory/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 跨会话记忆系统入口
+ *
+ * P2-12: 借鉴 Trellis 的 mem 子系统
+ *
+ * 提供能力：
+ * - 索引 AI 会话日志
+ * - 关键词搜索
+ * - 阶段切片
+ * - 相关性评分
+ *
+ * @example
+ * ```typescript
+ * import { createMemoryManager } from 'specpow/core/memory';
+ *
+ * const memory = createMemoryManager(projectRoot);
+ *
+ * // 索引会话
+ * await memory.indexSession(sessionLog);
+ *
+ * // 搜索记忆
+ * const results = await memory.search({
+ *   keywords: ['authentication', 'login'],
+ *   phases: ['apply'],
+ *   limit: 10
+ * });
+ *
+ * // 获取最近记忆
+ * const recent = await memory.getRecent(20);
+ * ```
+ */
+export type { MemoryEntry, MemoryMetadata, MemoryIndex, MemoryStore, MemoryManager, MemoryStats, MemorySearchQuery, MemorySearchResult, SessionLog, SessionMessage, ToolCall, WorkflowStage, } from './memory-types.js';
+export { FileMemoryStore } from './memory-store.js';
+export { MemoryManagerImpl, createMemoryManager } from './memory-manager.js';
+export { SqliteMemoryStore } from './adapters/sqlite-adapter.js';
+export { ShardedJsonStore, type ShardedJsonStoreOptions } from './adapters/json-adapter.js';
+export { extractKeywords, detectPhase, calculateRelevance, indexSessionLog, addToIndex, } from './memory-indexer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,YAAY,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,QAAQ,EACR,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAG5F,OAAO,EACL,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,UAAU,GACX,MAAM,qBAAqB,CAAC"}