@specpow/framework 0.2.0

package/dist/core/memory/memory-store.js

@@ -0,0 +1,148 @@
+/**
+ * 记忆存储实现
+ *
+ * P2-12: 基于文件系统的记忆存储
+ *
+ * 存储结构：
+ * .specpow/memory/
+ *   ├── index.json          # 主索引文件
+ *   ├── sessions/           # 会话日志
+ *   │   ├── {sessionId}.json
+ *   │   └── ...
+ *   └── archives/           # 归档记忆（压缩后的旧记忆）
+ *       └── {year}-{month}.json
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+// ─── 文件存储实现 ───────────────────────────────────────────
+export class FileMemoryStore {
+    memoryDir;
+    indexPath;
+    constructor(projectRoot) {
+        this.memoryDir = join(projectRoot, '.specpow', 'memory');
+        this.indexPath = join(this.memoryDir, 'index.json');
+        this.ensureDir();
+    }
+    ensureDir() {
+        if (!existsSync(this.memoryDir)) {
+            mkdirSync(this.memoryDir, { recursive: true });
+        }
+        const sessionsDir = join(this.memoryDir, 'sessions');
+        if (!existsSync(sessionsDir)) {
+            mkdirSync(sessionsDir, { recursive: true });
+        }
+        const archivesDir = join(this.memoryDir, 'archives');
+        if (!existsSync(archivesDir)) {
+            mkdirSync(archivesDir, { recursive: true });
+        }
+    }
+    async load() {
+        if (!existsSync(this.indexPath)) {
+            return this.createEmptyIndex();
+        }
+        try {
+            const data = JSON.parse(readFileSync(this.indexPath, 'utf-8'));
+            return this.deserializeIndex(data);
+        }
+        catch (err) {
+            console.warn('Failed to load memory index, creating new one:', err);
+            return this.createEmptyIndex();
+        }
+    }
+    async save(index) {
+        const data = this.serializeIndex(index);
+        writeFileSync(this.indexPath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    async clear() {
+        const emptyIndex = this.createEmptyIndex();
+        await this.save(emptyIndex);
+        // 清空会话日志
+        const sessionsDir = join(this.memoryDir, 'sessions');
+        if (existsSync(sessionsDir)) {
+            const files = readdirSync(sessionsDir);
+            for (const file of files) {
+                const filePath = join(sessionsDir, file);
+                const stat = statSync(filePath);
+                if (stat.isFile()) {
+                    // 保留目录结构，只删除文件
+                }
+            }
+        }
+    }
+    // ─── 序列化/反序列化 ───────────────────────────────────────
+    createEmptyIndex() {
+        return {
+            entries: new Map(),
+            keywords: new Map(),
+            phases: new Map(),
+            sessions: new Map(),
+            timeline: [],
+        };
+    }
+    serializeIndex(index) {
+        return {
+            version: 1,
+            entries: Array.from(index.entries.entries()),
+            keywords: Array.from(index.keywords.entries()).map(([k, v]) => [k, Array.from(v)]),
+            phases: Array.from(index.phases.entries()).map(([k, v]) => [k, Array.from(v)]),
+            sessions: Array.from(index.sessions.entries()).map(([k, v]) => [k, Array.from(v)]),
+            timeline: index.timeline,
+        };
+    }
+    deserializeIndex(data) {
+        const index = {
+            entries: new Map(data.entries || []),
+            keywords: new Map(),
+            phases: new Map(),
+            sessions: new Map(),
+            timeline: data.timeline || [],
+        };
+        // 反序列化 keywords
+        if (data.keywords) {
+            for (const [k, v] of data.keywords) {
+                index.keywords.set(k, new Set(v));
+            }
+        }
+        // 反序列化 phases
+        if (data.phases) {
+            for (const [k, v] of data.phases) {
+                index.phases.set(k, new Set(v));
+            }
+        }
+        // 反序列化 sessions
+        if (data.sessions) {
+            for (const [k, v] of data.sessions) {
+                index.sessions.set(k, new Set(v));
+            }
+        }
+        return index;
+    }
+    // ─── 会话日志管理 ─────────────────────────────────────────
+    saveSessionLog(sessionId, log) {
+        const sessionsDir = join(this.memoryDir, 'sessions');
+        const logPath = join(sessionsDir, `${sessionId}.json`);
+        writeFileSync(logPath, JSON.stringify(log, null, 2), 'utf-8');
+    }
+    loadSessionLog(sessionId) {
+        const logPath = join(this.memoryDir, 'sessions', `${sessionId}.json`);
+        if (!existsSync(logPath)) {
+            return null;
+        }
+        try {
+            return JSON.parse(readFileSync(logPath, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    listSessionIds() {
+        const sessionsDir = join(this.memoryDir, 'sessions');
+        if (!existsSync(sessionsDir)) {
+            return [];
+        }
+        return readdirSync(sessionsDir)
+            .filter(f => f.endsWith('.json'))
+            .map(f => f.replace('.json', ''));
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/core/memory/memory-store.js.map

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

package/dist/core/memory/memory-types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * 跨会话记忆系统类型定义
+ *
+ * P2-12: 借鉴 Trellis 的 mem 子系统
+ *
+ * 功能：
+ * - 索引 AI 会话日志
+ * - 关键词搜索
+ * - 阶段切片
+ * - 相关性评分
+ */
+export interface MemoryEntry {
+    /** 唯一标识 */
+    id: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 会话 ID */
+    sessionId: string;
+    /** 工作流阶段 */
+    phase: WorkflowStage;
+    /** 内容摘要 */
+    content: string;
+    /** 关键词 */
+    keywords: string[];
+    /** 相关性评分 (0-1) */
+    relevance: number;
+    /** 元数据 */
+    metadata: MemoryMetadata;
+}
+export interface MemoryMetadata {
+    /** 原始消息类型 */
+    messageType: 'user' | 'assistant' | 'system';
+    /** 工具调用（如果有） */
+    toolCalls?: string[];
+    /** 文件引用 */
+    files?: string[];
+    /** 变更名称 */
+    changeName?: string;
+    /** 技能名称 */
+    skillName?: string;
+}
+export type WorkflowStage = 'explore' | 'propose' | 'apply' | 'verify' | 'archive' | 'general';
+export interface MemoryIndex {
+    /** 所有记忆条目 */
+    entries: Map<string, MemoryEntry>;
+    /** 关键词索引：keyword -> entry IDs */
+    keywords: Map<string, Set<string>>;
+    /** 阶段索引：phase -> entry IDs */
+    phases: Map<WorkflowStage, Set<string>>;
+    /** 会话索引：sessionId -> entry IDs */
+    sessions: Map<string, Set<string>>;
+    /** 时间线索引：timestamp -> entry ID */
+    timeline: MemoryEntry[];
+}
+export interface SessionLog {
+    /** 会话 ID */
+    sessionId: string;
+    /** 开始时间 */
+    startTime: number;
+    /** 结束时间 */
+    endTime?: number;
+    /** 消息列表 */
+    messages: SessionMessage[];
+}
+export interface SessionMessage {
+    /** 时间戳 */
+    timestamp: number;
+    /** 消息类型 */
+    type: 'user' | 'assistant' | 'system';
+    /** 消息内容 */
+    content: string;
+    /** 工具调用 */
+    toolCalls?: ToolCall[];
+    /** 元数据 */
+    metadata?: Record<string, any>;
+}
+export interface ToolCall {
+    /** 工具名称 */
+    name: string;
+    /** 输入参数 */
+    input: Record<string, any>;
+    /** 输出结果 */
+    output?: string;
+    /** 时间戳 */
+    timestamp: number;
+}
+export interface MemorySearchQuery {
+    /** 关键词 */
+    keywords?: string[];
+    /** 工作流阶段过滤 */
+    phases?: WorkflowStage[];
+    /** 时间范围 */
+    timeRange?: {
+        start: number;
+        end: number;
+    };
+    /** 会话 ID 过滤 */
+    sessionId?: string;
+    /** 最大结果数 */
+    limit?: number;
+    /** 最小相关性阈值 */
+    minRelevance?: number;
+}
+export interface MemorySearchResult {
+    /** 匹配的记忆条目 */
+    entries: MemoryEntry[];
+    /** 总匹配数 */
+    total: number;
+    /** 搜索耗时（毫秒） */
+    duration: number;
+}
+export interface MemoryStore {
+    /** 加载索引 */
+    load(): Promise<MemoryIndex>;
+    /** 保存索引 */
+    save(index: MemoryIndex): Promise<void>;
+    /** 清空索引 */
+    clear(): Promise<void>;
+    /** 保存会话日志 */
+    saveSessionLog(sessionId: string, log: SessionLog): void;
+    /** 加载会话日志 */
+    loadSessionLog(sessionId: string): SessionLog | null;
+    /** 列出所有会话 ID */
+    listSessionIds(): string[];
+}
+export interface MemoryManager {
+    /** 索引会话日志 */
+    indexSession(log: SessionLog): Promise<number>;
+    /** 搜索记忆 */
+    search(query: MemorySearchQuery): Promise<MemorySearchResult>;
+    /** 获取指定阶段的记忆 */
+    getByPhase(phase: WorkflowStage, limit?: number): Promise<MemoryEntry[]>;
+    /** 获取最近的记忆 */
+    getRecent(limit?: number): Promise<MemoryEntry[]>;
+    /** 清空所有记忆 */
+    clear(): Promise<void>;
+    /** 获取统计信息 */
+    getStats(): Promise<MemoryStats>;
+}
+export interface MemoryStats {
+    /** 总记忆数 */
+    totalEntries: number;
+    /** 总会话数 */
+    totalSessions: number;
+    /** 各阶段记忆数 */
+    phaseCounts: Record<WorkflowStage, number>;
+    /** 最早记忆时间 */
+    oldestEntry?: number;
+    /** 最新记忆时间 */
+    newestEntry?: number;
+    /** 索引大小（字节） */
+    indexSize: number;
+}
+//# sourceMappingURL=memory-types.d.ts.map

package/dist/core/memory/memory-types.d.ts.map

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

package/dist/core/memory/memory-types.js

@@ -0,0 +1,13 @@
+/**
+ * 跨会话记忆系统类型定义
+ *
+ * P2-12: 借鉴 Trellis 的 mem 子系统
+ *
+ * 功能：
+ * - 索引 AI 会话日志
+ * - 关键词搜索
+ * - 阶段切片
+ * - 相关性评分
+ */
+export {};
+//# sourceMappingURL=memory-types.js.map

package/dist/core/memory/memory-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-types.js","sourceRoot":"","sources":["../../../src/core/memory/memory-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

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

@@ -0,0 +1,80 @@
+/**
+ * Migration Tool — 移植自 OpenSpec migration.ts (20KB)
+ *
+ * 版本迁移工具：
+ * - 从旧版本升级到新版本
+ * - 目录结构迁移
+ * - 配置文件迁移
+ * - 支持 --dry-run 预览
+ * - 自动备份
+ */
+export interface MigrationStep {
+    name: string;
+    description: string;
+    fromVersion: string;
+    toVersion: string;
+    execute(projectRoot: string, dryRun?: boolean): Promise<void>;
+}
+export interface MigrationResult {
+    success: boolean;
+    steps: {
+        name: string;
+        status: 'executed' | 'skipped' | 'failed' | 'previewed';
+        message: string;
+    }[];
+    currentVersion: string;
+    targetVersion: string;
+    backupPath?: string;
+}
+export interface DryRunResult {
+    pendingSteps: {
+        name: string;
+        description: string;
+        fromVersion: string;
+        toVersion: string;
+    }[];
+    currentVersion: string;
+    targetVersion: string;
+}
+export declare class MigrationRunner {
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * 获取当前版本
+     */
+    getCurrentVersion(): string;
+    /**
+     * 检查需要执行的迁移
+     *
+     * @param targetVersion - 目标版本（与 run() 保持一致），默认为最高迁移的目标版本
+     */
+    getPendingMigrations(targetVersion?: string): MigrationStep[];
+    /**
+     * 预览迁移（dry-run）
+     *
+     * 显示将要执行的迁移步骤，但不实际执行
+     */
+    dryRun(targetVersion?: string): DryRunResult;
+    /**
+     * 创建备份
+     *
+     * 在执行迁移前备份关键配置文件
+     */
+    createBackup(): string | null;
+    /**
+     * 运行所有待执行的迁移
+     */
+    run(targetVersion?: string, options?: {
+        dryRun?: boolean;
+        backup?: boolean;
+    }): Promise<MigrationResult>;
+    /**
+     * 运行指定迁移步骤
+     */
+    runStep(stepName: string): Promise<void>;
+    /**
+     * 列出所有可用的迁移
+     */
+    listMigrations(): MigrationStep[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/migration/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpG,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9F,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAoMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAI/B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAM3B;;;;OAIG;IACH,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAY7D;;;;OAIG;IACH,MAAM,CAAC,aAAa,GAAE,MAAgB,GAAG,YAAY;IAqBrD;;;;OAIG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAyB7B;;OAEG;IACG,GAAG,CAAC,aAAa,GAAE,MAAgB,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IA2F1H;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9C;;OAEG;IACH,cAAc,IAAI,aAAa,EAAE;CAGlC"}