@specpow/framework 0.2.0

package/dist/commands/init.js

@@ -0,0 +1,146 @@
+/**
+ * init 命令 - 初始化项目
+ *
+ * 委托给 core/init/engine.ts 的 InitEngine
+ * InitEngine 提供完整的初始化流程：
+ * - AI 工具检测（自动发现已安装的 AI 工具）
+ * - 目录结构创建
+ * - 技能和命令生成
+ * - 配置文件初始化
+ *
+ * P1-10: 集成模板哈希增量更新
+ */
+import chalk from 'chalk';
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join, dirname, relative } from 'path';
+import { fileURLToPath } from 'url';
+import { InitEngine } from '../core/init/engine.js';
+import { TemplateHashManager } from '../core/init/template-hash.js';
+export async function initProject(options) {
+    const projectRoot = process.cwd();
+    const tool = options.tool || 'claude';
+    const force = options.force || false;
+    console.log(chalk.cyan('\n🚀 SpecPow Framework 初始化\n'));
+    console.log(`  目标工具: ${chalk.bold(tool)}`);
+    console.log(`  项目目录: ${chalk.dim(projectRoot)}\n`);
+    const engine = new InitEngine(projectRoot);
+    const hashManager = new TemplateHashManager(projectRoot);
+    // --force 时重置哈希存储
+    if (force) {
+        hashManager.reset();
+    }
+    try {
+        const result = await engine.initialize({
+            tools: tool,
+            force: force,
+            quiet: false,
+        });
+        // 输出检测到的工具
+        if (result.toolsDetected.length > 0) {
+            console.log(chalk.dim('  检测到的 AI 工具:'));
+            for (const detected of result.toolsDetected) {
+                if (detected.available) {
+                    console.log(chalk.green(`    ✓ ${detected.name} (${detected.toolId})`));
+                }
+            }
+            console.log('');
+        }
+        // 输出创建的目录
+        if (result.dirsCreated.length > 0) {
+            console.log(chalk.dim('  创建的目录:'));
+            for (const dir of result.dirsCreated.slice(0, 10)) {
+                console.log(chalk.green(`    ✓ ${dir}`));
+            }
+            if (result.dirsCreated.length > 10) {
+                console.log(chalk.dim(`    ... 及其他 ${result.dirsCreated.length - 10} 个目录`));
+            }
+            console.log('');
+        }
+        // 输出警告
+        for (const warning of result.warnings) {
+            console.log(chalk.yellow(`  ⚠ ${warning}`));
+        }
+        // P1-10: 使用哈希管理器复制内置 Schema（增量更新）
+        const hashResult = copyBuiltinSchemasWithHash(projectRoot, hashManager);
+        if (hashResult.copied > 0) {
+            console.log(chalk.green(`  ✓ 新增/更新 ${hashResult.copied} 个 Schema 文件`));
+        }
+        if (hashResult.skipped > 0) {
+            console.log(chalk.dim(`  ○ 跳过 ${hashResult.skipped} 个未变化文件`));
+        }
+        if (hashResult.userModified.length > 0) {
+            console.log(chalk.yellow(`  ⚠ ${hashResult.userModified.length} 个文件已被用户修改，新版本保存为 .new`));
+        }
+        console.log(chalk.cyan('\n✅ 初始化完成！\n'));
+        console.log('下一步:');
+        console.log(`  1. ${chalk.bold('specpow explore "你的需求"')}  — 探索需求`);
+        console.log(`  2. ${chalk.bold('specpow propose <name>')}      — 创建变更提案`);
+        console.log(`  3. ${chalk.bold('specpow apply')}               — 执行实现`);
+        console.log('');
+    }
+    catch (err) {
+        console.log(chalk.red(`\n❌ 初始化失败: ${err.message}\n`));
+    }
+}
+/**
+ * P1-10: 使用模板哈希管理器复制内置 Schema
+ * 实现增量更新：未变化的文件跳过，用户修改的文件创建 .new
+ */
+function copyBuiltinSchemasWithHash(projectRoot, hashManager) {
+    // 定位包的 schemas 目录（兼容 ESM 和开发模式）
+    let packageSchemasDir;
+    try {
+        const thisFile = fileURLToPath(import.meta.url);
+        packageSchemasDir = join(dirname(thisFile), '..', '..', 'schemas');
+    }
+    catch {
+        return { copied: 0, skipped: 0, userModified: [] };
+    }
+    if (!existsSync(packageSchemasDir))
+        return { copied: 0, skipped: 0, userModified: [] };
+    const targetSchemasDir = join(projectRoot, 'schemas');
+    const files = [];
+    try {
+        const entries = readdirSync(packageSchemasDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const srcDir = join(packageSchemasDir, entry.name);
+            collectFiles(srcDir, join(targetSchemasDir, entry.name), projectRoot, files);
+        }
+    }
+    catch (e) {
+        console.warn(`Warning: failed to read builtin schemas: ${e.message}`);
+        return { copied: 0, skipped: 0, userModified: [] };
+    }
+    // 使用哈希管理器批量处理
+    const result = hashManager.processFiles(files);
+    return {
+        copied: result.added.length + result.updated.length,
+        skipped: result.skipped.length,
+        userModified: result.userModified,
+    };
+}
+/**
+ * 递归收集目录中的文件
+ */
+function collectFiles(srcDir, destDir, projectRoot, files) {
+    if (!existsSync(srcDir))
+        return;
+    const entries = readdirSync(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(srcDir, entry.name);
+        const destPath = join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            collectFiles(srcPath, destPath, projectRoot, files);
+        }
+        else {
+            const content = readFileSync(srcPath, 'utf-8');
+            files.push({
+                path: relative(projectRoot, destPath),
+                content,
+            });
+        }
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/memory.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Memory CLI 命令
+ *
+ * 提供跨会话记忆的索引、搜索、统计、时间线、阶段切片、清除功能。
+ * 复用 src/core/memory/ 的 createMemoryManager、extractKeywords、detectPhase、calculateRelevance。
+ */
+export declare function memoryIndex(sessionFile: string, options: {
+    json?: boolean;
+}): Promise<void>;
+export declare function memorySearch(keywords: string[], options: {
+    phase?: string;
+    session?: string;
+    limit?: string;
+    minRelevance?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function memoryStats(options: {
+    json?: boolean;
+}): Promise<void>;
+export declare function memoryTimeline(options: {
+    limit?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function memoryPhases(phase: string, options: {
+    limit?: string;
+    json?: boolean;
+}): Promise<void>;
+export declare function memoryClear(options: {
+    json?: boolean;
+    yes?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/commands/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/commands/memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0DH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmEf;AAMD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,IAAI,CAAC,CA2Gf;AAMD,wBAAsB,WAAW,CAC/B,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAwCf;AAMD,wBAAsB,cAAc,CAClC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CA4Df;AAMD,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAuEf;AAMD,wBAAsB,WAAW,CAC/B,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/commands/memory.js

@@ -0,0 +1,455 @@
+/**
+ * Memory CLI 命令
+ *
+ * 提供跨会话记忆的索引、搜索、统计、时间线、阶段切片、清除功能。
+ * 复用 src/core/memory/ 的 createMemoryManager、extractKeywords、detectPhase、calculateRelevance。
+ */
+import chalk from 'chalk';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { createMemoryManager, } from '../core/memory/index.js';
+import { successResponse, errorResponse, outputJson } from '../core/agent-contract.js';
+// ============================================================
+// 辅助函数
+// ============================================================
+/** 格式化时间戳为可读字符串 */
+function formatTime(ts) {
+    const d = new Date(ts);
+    const now = Date.now();
+    const diff = now - ts;
+    if (diff < 60_000)
+        return '刚刚';
+    if (diff < 3_600_000)
+        return `${Math.floor(diff / 60_000)} 分钟前`;
+    if (diff < 86_400_000)
+        return `${Math.floor(diff / 3_600_000)} 小时前`;
+    if (diff < 604_800_000)
+        return `${Math.floor(diff / 86_400_000)} 天前`;
+    return d.toLocaleDateString('zh-CN', { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' });
+}
+/** 格式化字节数 */
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1_048_576)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1_048_576).toFixed(1)} MB`;
+}
+/** 阶段名称映射 */
+const PHASE_LABELS = {
+    explore: '探索',
+    propose: '提案',
+    apply: '实现',
+    verify: '验证',
+    archive: '归档',
+    general: '通用',
+};
+/** 截断文本 */
+function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return text.slice(0, maxLen - 3) + '...';
+}
+// ============================================================
+// memory index — 索引会话日志
+// ============================================================
+export async function memoryIndex(sessionFile, options) {
+    const jsonMode = !!options.json;
+    const projectRoot = process.cwd();
+    // 验证文件存在
+    const filePath = join(projectRoot, sessionFile);
+    if (!existsSync(filePath)) {
+        const msg = `会话日志文件不存在: ${sessionFile}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'FILE_NOT_FOUND'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+        return;
+    }
+    // 读取并解析 JSON
+    let sessionLog;
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        sessionLog = JSON.parse(raw);
+    }
+    catch (err) {
+        const msg = `无法解析会话日志文件: ${err instanceof Error ? err.message : String(err)}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'PARSE_ERROR'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+        return;
+    }
+    // 验证基本结构
+    if (!sessionLog.sessionId || !Array.isArray(sessionLog.messages)) {
+        const msg = '会话日志格式无效: 需要 sessionId 和 messages 数组';
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'INVALID_FORMAT'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+        return;
+    }
+    try {
+        const manager = createMemoryManager(projectRoot);
+        const count = await manager.indexSession(sessionLog);
+        if (jsonMode) {
+            outputJson(successResponse({
+                sessionId: sessionLog.sessionId,
+                messageCount: sessionLog.messages.length,
+                indexedEntries: count,
+                message: '会话索引完成',
+            }));
+        }
+        else {
+            console.log(chalk.green('✓ 会话索引完成'));
+            console.log(`  会话 ID: ${chalk.cyan(sessionLog.sessionId)}`);
+            console.log(`  消息总数: ${sessionLog.messages.length}`);
+            console.log(`  索引条目: ${chalk.cyan(String(count))}`);
+        }
+    }
+    catch (err) {
+        const msg = `索引失败: ${err instanceof Error ? err.message : String(err)}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'INDEX_ERROR'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+    }
+}
+// ============================================================
+// memory search — 搜索记忆
+// ============================================================
+export async function memorySearch(keywords, options) {
+    const jsonMode = !!options.json;
+    const projectRoot = process.cwd();
+    try {
+        const manager = createMemoryManager(projectRoot);
+        // 构建搜索查询
+        const query = {};
+        if (keywords.length > 0) {
+            query.keywords = keywords;
+        }
+        if (options.phase) {
+            const phase = options.phase;
+            const validPhases = ['explore', 'propose', 'apply', 'verify', 'archive', 'general'];
+            if (!validPhases.includes(phase)) {
+                const msg = `无效的阶段: "${options.phase}"。有效值: ${validPhases.join(', ')}`;
+                if (jsonMode) {
+                    outputJson(errorResponse(msg, 'INVALID_PHASE'));
+                }
+                else {
+                    console.log(chalk.red(msg));
+                }
+                return;
+            }
+            query.phases = [phase];
+        }
+        if (options.session) {
+            query.sessionId = options.session;
+        }
+        if (options.limit) {
+            const limit = parseInt(options.limit, 10);
+            if (isNaN(limit) || limit <= 0) {
+                const msg = `无效的 limit: "${options.limit}"`;
+                if (jsonMode) {
+                    outputJson(errorResponse(msg, 'INVALID_LIMIT'));
+                }
+                else {
+                    console.log(chalk.red(msg));
+                }
+                return;
+            }
+            query.limit = limit;
+        }
+        if (options.minRelevance) {
+            const minRelevance = parseFloat(options.minRelevance);
+            if (isNaN(minRelevance) || minRelevance < 0 || minRelevance > 1) {
+                const msg = `无效的最小相关性: "${options.minRelevance}"（需要 0-1 之间的数值）`;
+                if (jsonMode) {
+                    outputJson(errorResponse(msg, 'INVALID_RELEVANCE'));
+                }
+                else {
+                    console.log(chalk.red(msg));
+                }
+                return;
+            }
+            query.minRelevance = minRelevance;
+        }
+        const result = await manager.search(query);
+        if (jsonMode) {
+            outputJson(successResponse({
+                total: result.total,
+                duration: result.duration,
+                message: '搜索完成',
+                entries: result.entries.map(e => ({
+                    id: e.id,
+                    phase: e.phase,
+                    content: e.content,
+                    keywords: e.keywords,
+                    relevance: e.relevance,
+                    timestamp: e.timestamp,
+                    sessionId: e.sessionId,
+                })),
+            }));
+        }
+        else {
+            console.log(chalk.green(`\n🔍 搜索完成 (${result.duration}ms)`));
+            console.log(`  找到 ${chalk.cyan(String(result.total))} 条结果\n`);
+            if (result.entries.length === 0) {
+                console.log(chalk.yellow('  无匹配结果。'));
+                return;
+            }
+            for (const entry of result.entries) {
+                const phaseLabel = PHASE_LABELS[entry.phase] || entry.phase;
+                const relevanceBar = '█'.repeat(Math.round(entry.relevance * 10)) + '░'.repeat(10 - Math.round(entry.relevance * 10));
+                console.log(`  ${chalk.gray(formatTime(entry.timestamp))} ${chalk.blue(`[${phaseLabel}]`)} ${relevanceBar} ${chalk.gray(entry.relevance.toFixed(2))}`);
+                console.log(`    ${truncate(entry.content, 100)}`);
+                if (entry.keywords.length > 0) {
+                    console.log(`    ${chalk.gray('关键词:')} ${entry.keywords.map(k => chalk.dim(k)).join(', ')}`);
+                }
+                console.log('');
+            }
+        }
+    }
+    catch (err) {
+        const msg = `搜索失败: ${err instanceof Error ? err.message : String(err)}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'SEARCH_ERROR'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+    }
+}
+// ============================================================
+// memory stats — 显示记忆统计
+// ============================================================
+export async function memoryStats(options) {
+    const jsonMode = !!options.json;
+    const projectRoot = process.cwd();
+    try {
+        const manager = createMemoryManager(projectRoot);
+        const stats = await manager.getStats();
+        if (jsonMode) {
+            outputJson(successResponse({ ...stats, message: '记忆统计' }));
+        }
+        else {
+            console.log(chalk.green('\n📊 记忆统计\n'));
+            console.log(`  总条目数: ${chalk.cyan(String(stats.totalEntries))}`);
+            console.log(`  总会话数: ${chalk.cyan(String(stats.totalSessions))}`);
+            console.log(`  索引大小: ${chalk.cyan(formatBytes(stats.indexSize))}`);
+            if (stats.oldestEntry && stats.newestEntry) {
+                console.log(`  最早记录: ${chalk.gray(formatTime(stats.oldestEntry))}`);
+                console.log(`  最新记录: ${chalk.gray(formatTime(stats.newestEntry))}`);
+            }
+            console.log(chalk.green('\n  阶段分布:'));
+            const phases = Object.entries(stats.phaseCounts);
+            for (const [phase, count] of phases.sort((a, b) => b[1] - a[1])) {
+                if (count > 0) {
+                    const label = PHASE_LABELS[phase] || phase;
+                    const bar = '█'.repeat(Math.min(count, 30));
+                    console.log(`    ${chalk.blue(`[${label}]`)} ${bar} ${count}`);
+                }
+            }
+            console.log('');
+        }
+    }
+    catch (err) {
+        const msg = `获取统计失败: ${err instanceof Error ? err.message : String(err)}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'STATS_ERROR'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+    }
+}
+// ============================================================
+// memory timeline — 按时间线展示
+// ============================================================
+export async function memoryTimeline(options) {
+    const jsonMode = !!options.json;
+    const projectRoot = process.cwd();
+    try {
+        const manager = createMemoryManager(projectRoot);
+        const limit = options.limit ? parseInt(options.limit, 10) : 20;
+        if (isNaN(limit) || limit <= 0) {
+            const msg = `无效的 limit: "${options.limit}"`;
+            if (jsonMode) {
+                outputJson(errorResponse(msg, 'INVALID_LIMIT'));
+            }
+            else {
+                console.log(chalk.red(msg));
+            }
+            return;
+        }
+        const entries = await manager.getRecent(limit);
+        if (jsonMode) {
+            outputJson(successResponse({
+                count: entries.length,
+                message: '时间线',
+                entries: entries.map(e => ({
+                    id: e.id,
+                    phase: e.phase,
+                    content: e.content,
+                    keywords: e.keywords,
+                    relevance: e.relevance,
+                    timestamp: e.timestamp,
+                    sessionId: e.sessionId,
+                })),
+            }));
+        }
+        else {
+            console.log(chalk.green(`\n📅 最近 ${entries.length} 条记忆\n`));
+            if (entries.length === 0) {
+                console.log(chalk.yellow('  暂无记忆数据。'));
+                return;
+            }
+            for (const entry of entries) {
+                const phaseLabel = PHASE_LABELS[entry.phase] || entry.phase;
+                console.log(`  ${chalk.gray(formatTime(entry.timestamp))} ${chalk.blue(`[${phaseLabel}]`)} ${chalk.gray(`(相关性: ${entry.relevance.toFixed(2)})`)}`);
+                console.log(`    ${truncate(entry.content, 120)}`);
+                if (entry.keywords.length > 0) {
+                    console.log(`    ${chalk.dim(entry.keywords.join(', '))}`);
+                }
+                console.log('');
+            }
+        }
+    }
+    catch (err) {
+        const msg = `获取时间线失败: ${err instanceof Error ? err.message : String(err)}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'TIMELINE_ERROR'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+    }
+}
+// ============================================================
+// memory phases — 按阶段切片
+// ============================================================
+export async function memoryPhases(phase, options) {
+    const jsonMode = !!options.json;
+    const projectRoot = process.cwd();
+    const validPhases = ['explore', 'propose', 'apply', 'verify', 'archive', 'general'];
+    if (!validPhases.includes(phase)) {
+        const msg = `无效的阶段: "${phase}"。有效值: ${validPhases.join(', ')}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'INVALID_PHASE'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+        return;
+    }
+    try {
+        const manager = createMemoryManager(projectRoot);
+        const limit = options.limit ? parseInt(options.limit, 10) : 20;
+        if (isNaN(limit) || limit <= 0) {
+            const msg = `无效的 limit: "${options.limit}"`;
+            if (jsonMode) {
+                outputJson(errorResponse(msg, 'INVALID_LIMIT'));
+            }
+            else {
+                console.log(chalk.red(msg));
+            }
+            return;
+        }
+        const entries = await manager.getByPhase(phase, limit);
+        const phaseLabel = PHASE_LABELS[phase] || phase;
+        if (jsonMode) {
+            outputJson(successResponse({
+                phase,
+                count: entries.length,
+                message: `${phaseLabel} 阶段记忆`,
+                entries: entries.map(e => ({
+                    id: e.id,
+                    content: e.content,
+                    keywords: e.keywords,
+                    relevance: e.relevance,
+                    timestamp: e.timestamp,
+                    sessionId: e.sessionId,
+                })),
+            }));
+        }
+        else {
+            console.log(chalk.green(`\n📋 ${phaseLabel} 阶段 — 最近 ${entries.length} 条\n`));
+            if (entries.length === 0) {
+                console.log(chalk.yellow(`  暂无 "${phaseLabel}" 阶段的记忆数据。`));
+                return;
+            }
+            for (const entry of entries) {
+                console.log(`  ${chalk.gray(formatTime(entry.timestamp))} ${chalk.gray(`(相关性: ${entry.relevance.toFixed(2)})`)}`);
+                console.log(`    ${truncate(entry.content, 120)}`);
+                if (entry.keywords.length > 0) {
+                    console.log(`    ${chalk.dim(entry.keywords.join(', '))}`);
+                }
+                console.log('');
+            }
+        }
+    }
+    catch (err) {
+        const msg = `获取阶段记忆失败: ${err instanceof Error ? err.message : String(err)}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'PHASE_ERROR'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+    }
+}
+// ============================================================
+// memory clear — 清除记忆数据
+// ============================================================
+export async function memoryClear(options) {
+    const jsonMode = !!options.json;
+    const projectRoot = process.cwd();
+    if (!options.yes) {
+        const msg = '此操作将清除所有记忆数据，不可恢复。使用 --yes 确认。';
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'CONFIRMATION_REQUIRED'));
+        }
+        else {
+            console.log(chalk.yellow(`⚠️  ${msg}`));
+        }
+        return;
+    }
+    try {
+        const manager = createMemoryManager(projectRoot);
+        // 先获取统计信息用于报告
+        const statsBefore = await manager.getStats();
+        const clearedEntries = statsBefore.totalEntries;
+        const clearedSessions = statsBefore.totalSessions;
+        await manager.clear();
+        if (jsonMode) {
+            outputJson(successResponse({
+                clearedEntries,
+                clearedSessions,
+                message: '记忆数据已清除',
+            }));
+        }
+        else {
+            console.log(chalk.green('✓ 记忆数据已清除'));
+            console.log(`  清除条目: ${chalk.cyan(String(clearedEntries))}`);
+            console.log(`  清除会话: ${chalk.cyan(String(clearedSessions))}`);
+        }
+    }
+    catch (err) {
+        const msg = `清除失败: ${err instanceof Error ? err.message : String(err)}`;
+        if (jsonMode) {
+            outputJson(errorResponse(msg, 'CLEAR_ERROR'));
+        }
+        else {
+            console.log(chalk.red(msg));
+        }
+    }
+}
+//# sourceMappingURL=memory.js.map