@ai-setting/roy-agent-cli 1.3.19 → 1.3.22

package/dist/core/src/env/memory/plugin/memory-agent.js

@@ -1,250 +0,0 @@
-/**
- * @fileoverview Memory Agent 核心逻辑 (Simplified)
- *
- * 简化设计：
- * - 移除 DraftManager（草稿管理已废弃）
- * - 移除 AccessLog（访问日志已废弃）
- * - 只保留核心的 Agent 类型和格式化逻辑
- */
-// ============================================================================
-// System Prompts (Simplified)
-// ============================================================================
-/**
- * Project Memory Agent System Prompt
- */
-export const PROJECT_MEMORY_AGENT_PROMPT = `你是项目级 Memory Agent，负责整理和更新当前项目的记忆。
-
-## 你的职责
-
-1. **信息收集**：在提取记忆前，先收集项目上下文信息
-2. **从对话中提取记忆**：分析 messages，提取与项目相关的知识、决策、解决方案
-3. **生成 memory.md**：更新项目记忆索引
-
-## 信息收集步骤（重要！）
-
-在提取记忆之前，请先使用可用工具收集项目上下文：
-
-1. **阅读项目 README**：了解项目概述、功能、使用方法
-   - 路径示例：README.md, README.zh-CN.md, docs/README.md
-
-2. **检查设计文档**：了解项目架构和设计决策
-   - 路径示例：docs/design.md, docs/ARCHITECTURE.md, docs/superpowers/specs/*.md
-
-3. **查看代码实现**：了解关键模块和实现细节
-   - 路径示例：src/**/*.ts, packages/*/src/**/*.ts
-
-4. **回顾现有 memory**：了解已有的项目记忆
-   - 路径：当前目录下的 .roy/memory/memory.md
-
-## 输入信息
-
-- 当前项目的 memory.md 内容
-- 当前对话消息
-
-## 输出要求
-
-请以 JSON 格式输出结果，包含以下字段：
-- memoryMdContent: 新的 memory.md 内容
-- projectSummary: 项目摘要（包含 summary, shortSummary 等）
-- hasUpdates: 是否有更新
-
-## 记忆组织原则
-
-- 优先记录具体、可操作的记忆（代码位置、配置项、命令）
-- 避免过于抽象或通用的描述
-- 记录设计决策及其理由`;
-/**
- * Global Memory Agent System Prompt
- */
-export const GLOBAL_MEMORY_AGENT_PROMPT = `你是全局 Memory Agent，负责整理跨项目的通用记忆。
-
-## 你的职责
-
-1. **聚合项目摘要**：分析 projectSummaries，提取共性知识
-2. **维护全局记忆**：更新全局 memory.md
-3. **维护项目索引**：在 memory.md 中维护项目列表
-4. **提取共性经验**：将项目经验提炼为通用最佳实践
-
-## 输入信息
-
-- 全局 memory.md 内容
-- 当前对话消息
-- 项目摘要列表（projectSummaries）
-
-## 输出要求
-
-请以 JSON 格式输出结果，包含以下字段：
-- memoryMdContent: 新的 memory.md 内容
-- hasUpdates: 是否有更新
-
-## 记忆组织原则
-
-- 关注跨项目共性（工作流、规范、偏好）
-- 项目索引只记录摘要和路径，不复制内容
-- 用户个人偏好（饮食、工作习惯）优先记录`;
-// ============================================================================
-// Core Functions
-// ============================================================================
-/**
- * 创建 Memory Agent 配置
- */
-export function createMemoryAgent(scope) {
-    const name = `memory-agent-${scope}-${Date.now()}`;
-    const systemPrompt = scope === "project"
-        ? PROJECT_MEMORY_AGENT_PROMPT
-        : GLOBAL_MEMORY_AGENT_PROMPT;
-    return {
-        name,
-        systemPrompt,
-        maxIterations: 5,
-    };
-}
-/**
- * 格式化 Memory Agent 输入为字符串
- */
-export function formatMemoryInput(input) {
-    const lines = [];
-    // Scope header
-    lines.push(`# Memory Agent Input (${input.scope} scope)\n`);
-    // Current memory.md
-    lines.push("## Current memory.md");
-    lines.push(input.currentMemoryMd || "_No existing memory_");
-    lines.push("");
-    // Messages
-    lines.push("## Recent Messages");
-    if (input.messages.length === 0) {
-        lines.push("_No messages_");
-    }
-    else {
-        for (const msg of input.messages.slice(-10)) {
-            const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
-            lines.push(`**${msg.role}**: ${content.substring(0, 500)}`);
-        }
-    }
-    lines.push("");
-    // Project Summaries (for global scope)
-    if (input.scope === "global" && input.projectSummaries && input.projectSummaries.length > 0) {
-        lines.push("## Project Summaries");
-        for (const ps of input.projectSummaries) {
-            lines.push(`### ${ps.projectName}`);
-            lines.push(`Path: ${ps.projectPath}`);
-            lines.push(`Last Updated: ${new Date(ps.lastUpdated).toLocaleString()}`);
-            lines.push(`Summary: ${ps.summary}`);
-            lines.push(`Memory: ${ps.memoryMdPath}`);
-            lines.push("---");
-        }
-        lines.push("");
-    }
-    lines.push("## Task");
-    lines.push("请分析以上信息，更新记忆并以 JSON 格式输出结果。");
-    return lines.join("\n");
-}
-/**
- * 解析 Memory Agent 输出
- */
-export function parseMemoryAgentOutput(output, scope) {
-    // Try to extract JSON from output
-    let jsonStr = output;
-    // Try to find JSON in the output
-    const jsonMatch = output.match(/```json\s*([\s\S]*?)\s*```/) ||
-        output.match(/```\s*([\s\S]*?)\s*```/) ||
-        output.match(/(\{[\s\S]*\})/);
-    if (jsonMatch) {
-        jsonStr = jsonMatch[1] || jsonMatch[0];
-    }
-    try {
-        const parsed = JSON.parse(jsonStr);
-        return {
-            scope,
-            memoryMdContent: parsed.memoryMdContent || "",
-            projectSummary: parsed.projectSummary,
-            hasUpdates: parsed.hasUpdates ?? false,
-        };
-    }
-    catch {
-        // Return empty result on parse failure
-        return {
-            scope,
-            memoryMdContent: output, // Use raw output as fallback
-            hasUpdates: false,
-        };
-    }
-}
-/**
- * 创建默认的 MemoryAgentResult
- */
-export function createEmptyResult(scope) {
-    return {
-        scope,
-        memoryMdContent: "",
-        hasUpdates: false,
-    };
-}
-// ============================================================================
-// Input Builders
-// ============================================================================
-/**
- * 构建 Project Memory Agent 输入
- */
-export async function buildProjectInput(params) {
-    const baseDir = params.projectPath + "/.roy/memory";
-    return {
-        scope: "project",
-        baseDir,
-        currentMemoryMd: params.currentMemoryMd,
-        messages: params.messages,
-    };
-}
-/**
- * 构建 Global Memory Agent 输入
- */
-export function buildGlobalInput(params) {
-    return {
-        scope: "global",
-        baseDir: params.baseDir,
-        currentMemoryMd: params.currentMemoryMd,
-        messages: params.messages,
-        projectSummaries: params.projectSummaries,
-    };
-}
-// ============================================================================
-// Result Application
-// ============================================================================
-/**
- * 应用 Memory Agent 结果到文件系统
- *
- * @param result MemoryAgent 结果
- * @param baseDir 基础目录
- */
-export async function applyMemoryResult(result, baseDir) {
-    const fs = await import("fs/promises");
-    const path = await import("path");
-    // Write memory.md
-    const memoryMdPath = path.join(baseDir, "memory.md");
-    await fs.mkdir(path.dirname(memoryMdPath), { recursive: true });
-    await fs.writeFile(memoryMdPath, result.memoryMdContent, "utf-8");
-}
-// ============================================================================
-// Project Summary Generation
-// ============================================================================
-/**
- * 生成项目摘要
- */
-export function generateProjectSummary(params) {
-    // Extract first paragraph as summary
-    const paragraphs = params.memoryMdContent.split(/\n\n+/);
-    const firstParagraph = paragraphs[0] || "";
-    const summary = firstParagraph.replace(/^#+\s*/g, "").trim() || "No summary available";
-    // Generate short summary (first sentence, max 50 chars)
-    const firstSentence = summary.split(/[.!?]/)[0] || summary;
-    const shortSummary = firstSentence.substring(0, 50) + (firstSentence.length > 50 ? "..." : "");
-    return {
-        projectPath: params.projectPath,
-        projectName: params.projectName,
-        lastUpdated: Date.now(),
-        summary,
-        shortSummary,
-        memoryMdPath: params.memoryMdPath,
-    };
-}
-//# sourceMappingURL=memory-agent.js.map

package/dist/core/src/env/memory/plugin/memory-agent.test.d.ts

@@ -1,11 +0,0 @@
-/**
- * @fileoverview MemoryAgent Test Suite - Simplified
- *
- * TDD 测试用例 - 验证简化后的 MemoryAgent 设计
- *
- * 简化设计：
- * - 移除了 DraftManager
- * - 只保留核心的 memory.md 操作
- */
-export {};
-//# sourceMappingURL=memory-agent.test.d.ts.map

package/dist/core/src/env/memory/plugin/memory-agent.test.js

@@ -1,207 +0,0 @@
-/**
- * @fileoverview MemoryAgent Test Suite - Simplified
- *
- * TDD 测试用例 - 验证简化后的 MemoryAgent 设计
- *
- * 简化设计：
- * - 移除了 DraftManager
- * - 只保留核心的 memory.md 操作
- */
-import { describe, test, expect, beforeEach, afterEach } from "bun:test";
-import fs from "fs/promises";
-import path from "path";
-import os from "os";
-import { createMemoryAgent, formatMemoryInput, parseMemoryAgentOutput, createEmptyResult, buildProjectInput, buildGlobalInput, applyMemoryResult, generateProjectSummary, } from "./memory-agent.js";
-describe("MemoryAgent - Simplified Design", () => {
-    let tmpDir;
-    beforeEach(async () => {
-        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "memory-agent-test-"));
-    });
-    afterEach(async () => {
-        await fs.rm(tmpDir, { recursive: true, force: true });
-    });
-    describe("createMemoryAgent", () => {
-        test("should create agent with project scope", () => {
-            const config = createMemoryAgent("project");
-            expect(config.name).toContain("memory-agent-project");
-            expect(config.systemPrompt).toContain("项目级 Memory Agent");
-            expect(config.maxIterations).toBe(5);
-        });
-        test("should create agent with global scope", () => {
-            const config = createMemoryAgent("global");
-            expect(config.name).toContain("memory-agent-global");
-            expect(config.systemPrompt).toContain("全局 Memory Agent");
-            expect(config.maxIterations).toBe(5);
-        });
-    });
-    describe("formatMemoryInput", () => {
-        test("should format project scope input", () => {
-            const input = {
-                scope: "project",
-                baseDir: tmpDir,
-                currentMemoryMd: "# 项目记忆\n\n一些记忆内容",
-                messages: [
-                    { role: "user", content: "Hello" },
-                    { role: "assistant", content: "Hi there!" },
-                ],
-            };
-            const formatted = formatMemoryInput(input);
-            expect(formatted).toContain("project scope");
-            expect(formatted).toContain("项目记忆");
-            expect(formatted).toContain("Hello");
-            expect(formatted).toContain("Hi there!");
-        });
-        test("should format global scope input with project summaries", () => {
-            const input = {
-                scope: "global",
-                baseDir: tmpDir,
-                currentMemoryMd: "# 全局记忆",
-                messages: [],
-                projectSummaries: [
-                    {
-                        projectPath: "/path/to/project",
-                        projectName: "test-project",
-                        lastUpdated: Date.now(),
-                        summary: "A test project",
-                        shortSummary: "Test project",
-                        memoryMdPath: "/path/to/project/.roy/memory/memory.md",
-                    },
-                ],
-            };
-            const formatted = formatMemoryInput(input);
-            expect(formatted).toContain("global scope");
-            expect(formatted).toContain("test-project");
-            expect(formatted).toContain("A test project");
-        });
-    });
-    describe("parseMemoryAgentOutput", () => {
-        test("should parse JSON output", () => {
-            const output = JSON.stringify({
-                memoryMdContent: "# 新记忆\n\n内容",
-                hasUpdates: true,
-            });
-            const result = parseMemoryAgentOutput(output, "project");
-            expect(result.memoryMdContent).toBe("# 新记忆\n\n内容");
-            expect(result.hasUpdates).toBe(true);
-            expect(result.scope).toBe("project");
-        });
-        test("should parse JSON with project summary", () => {
-            const output = JSON.stringify({
-                memoryMdContent: "# 记忆",
-                hasUpdates: true,
-                projectSummary: {
-                    projectPath: "/path",
-                    projectName: "test",
-                    lastUpdated: Date.now(),
-                    summary: "Summary",
-                    shortSummary: "Sum",
-                    memoryMdPath: "/path/memory.md",
-                },
-            });
-            const result = parseMemoryAgentOutput(output, "project");
-            expect(result.projectSummary).toBeDefined();
-            expect(result.projectSummary.projectName).toBe("test");
-        });
-    });
-    describe("createEmptyResult", () => {
-        test("should create empty result for project scope", () => {
-            const result = createEmptyResult("project");
-            expect(result.scope).toBe("project");
-            expect(result.memoryMdContent).toBe("");
-            expect(result.hasUpdates).toBe(false);
-            expect(result.projectSummary).toBeUndefined();
-        });
-        test("should create empty result for global scope", () => {
-            const result = createEmptyResult("global");
-            expect(result.scope).toBe("global");
-            expect(result.memoryMdContent).toBe("");
-            expect(result.hasUpdates).toBe(false);
-        });
-    });
-    describe("applyMemoryResult", () => {
-        test("should create memory.md file", async () => {
-            const result = {
-                scope: "project",
-                memoryMdContent: "# 项目记忆\n\n测试内容",
-                hasUpdates: true,
-            };
-            await applyMemoryResult(result, tmpDir);
-            const memoryMdPath = path.join(tmpDir, "memory.md");
-            const content = await fs.readFile(memoryMdPath, "utf-8");
-            expect(content).toBe("# 项目记忆\n\n测试内容");
-        });
-        test("should update existing memory.md", async () => {
-            // Create initial file
-            const memoryMdPath = path.join(tmpDir, "memory.md");
-            await fs.writeFile(memoryMdPath, "# 旧内容", "utf-8");
-            const result = {
-                scope: "project",
-                memoryMdContent: "# 新内容\n\n更新后的记忆",
-                hasUpdates: true,
-            };
-            await applyMemoryResult(result, tmpDir);
-            const content = await fs.readFile(memoryMdPath, "utf-8");
-            expect(content).toBe("# 新内容\n\n更新后的记忆");
-        });
-    });
-    describe("generateProjectSummary", () => {
-        test("should generate summary with required fields", () => {
-            const summary = generateProjectSummary({
-                projectPath: "/path/to/project",
-                projectName: "my-project",
-                memoryMdContent: "# 我的项目\n\n这是一个测试项目",
-                memoryMdPath: "/path/to/project/.roy/memory/memory.md",
-            });
-            expect(summary.projectPath).toBe("/path/to/project");
-            expect(summary.projectName).toBe("my-project");
-            expect(summary.lastUpdated).toBeGreaterThan(0);
-            expect(summary.memoryMdPath).toBe("/path/to/project/.roy/memory/memory.md");
-        });
-        test("should extract first paragraph as summary", () => {
-            const summary = generateProjectSummary({
-                projectPath: "/path",
-                projectName: "test",
-                memoryMdContent: "# 第一段\n\n这是第一段的内容。\n\n# 第二段\n\n这是第二段。",
-                memoryMdPath: "/path/memory.md",
-            });
-            // 移除标题前缀后，只包含第一段（第一行）
-            expect(summary.summary).toContain("第一段");
-            // 不包含内容，因为只取了第一段的第一行
-        });
-        test("should truncate short summary to 50 chars", () => {
-            const longContent = "这是一个非常长的描述，包含很多内容需要被截断才能符合要求。";
-            const summary = generateProjectSummary({
-                projectPath: "/path",
-                projectName: "test",
-                memoryMdContent: `# 标题\n\n${longContent}`,
-                memoryMdPath: "/path/memory.md",
-            });
-            expect(summary.shortSummary.length).toBeLessThanOrEqual(53); // 50 + "..."
-        });
-    });
-    describe("buildProjectInput", () => {
-        test("should build project input", async () => {
-            const input = await buildProjectInput({
-                projectPath: tmpDir,
-                currentMemoryMd: "# 测试",
-                messages: [],
-            });
-            expect(input.scope).toBe("project");
-            expect(input.baseDir).toContain(".roy/memory");
-            expect(input.currentMemoryMd).toBe("# 测试");
-        });
-    });
-    describe("buildGlobalInput", () => {
-        test("should build global input", () => {
-            const input = buildGlobalInput({
-                baseDir: tmpDir,
-                currentMemoryMd: "# 全局",
-                messages: [],
-            });
-            expect(input.scope).toBe("global");
-            expect(input.baseDir).toBe(tmpDir);
-            expect(input.currentMemoryMd).toBe("# 全局");
-        });
-    });
-});
-//# sourceMappingURL=memory-agent.test.js.map

package/dist/core/src/env/memory/plugin/memory-manager.d.ts

@@ -1,72 +0,0 @@
-/**
- * @fileoverview MemoryManager V3 - Simplified
- *
- * 后台异步任务队列处理
- *
- * 简化设计：
- * - 移除 DraftManager（草稿管理已废弃）
- * - 移除 MemoryOrganizer（整理机制已废弃）
- * - 移除 AccessLog（访问日志已废弃）
- * - 只保留核心的任务队列处理
- */
-import type { MemoryTask, ExtractMemoryPayload } from "./types";
-/**
- * MemoryManager 配置
- */
-export interface MemoryManagerConfig {
-    /** 回调：当需要提取记忆时调用 */
-    onExtractMemory?: (payload: ExtractMemoryPayload) => Promise<void>;
-}
-/**
- * MemoryManager V3 - Simplified
- *
- * 简化的后台异步内存处理，只负责任务队列
- */
-export declare class MemoryManager {
-    /** 队列最大容量，防止内存溢出 */
-    private static readonly MAX_QUEUE_SIZE;
-    private queue;
-    private processing;
-    private shuttingDown;
-    private config;
-    private processingPromise;
-    private resolveProcessing;
-    constructor(config?: MemoryManagerConfig);
-    /**
-     * 更新配置
-     */
-    updateConfig(config: Partial<MemoryManagerConfig>): void;
-    /**
-     * 入队（非阻塞）
-     */
-    enqueue(task: Omit<MemoryTask, "id">): void;
-    /**
-     * 启动处理循环
-     */
-    private startProcessingLoop;
-    /**
-     * 检查是否有待处理任务
-     */
-    hasPendingTasks(): boolean;
-    /**
-     * 等待处理完成
-     */
-    waitForCompletion(): Promise<void>;
-    /**
-     * 准备关闭
-     */
-    prepareShutdown(): void;
-    /**
-     * 释放资源
-     */
-    dispose(): Promise<void>;
-    /**
-     * 处理单个任务
-     */
-    private processTask;
-    /**
-     * 处理记忆提取
-     */
-    private handleExtractMemory;
-}
-//# sourceMappingURL=memory-manager.d.ts.map