@ai-setting/roy-agent-core 1.3.10 → 1.3.14

package/src/env/memory/plugin/memory-plugin.ts

@@ -1,210 +0,0 @@
-/**
- * @fileoverview MemoryPlugin - Simplified
- * 
- * Hook handler for agent:after.react
- * 
- * 简化设计（移除旧的复杂机制）：
- * - 移除了 DraftManager（草稿管理已废弃）
- * - 移除了 MemoryOrganizer（整理机制已废弃）
- * - 移除了 AccessLog（访问日志已废弃）
- * 
- * 新的记忆管理方式：
- * - 使用 `roy memory recall --extract` 命令手动触发
- * - 使用 Memory Agent 自动分析会话历史
- * - 直接更新 memory.md 文件
- */
-
-import type { HookContext } from "../../agent/types";
-import type { AgentComponent } from "../../agent/agent-component";
-import type { SessionMessage } from "../../session/session-component";
-import type { SessionComponent } from "../../session/session-component";
-import type { MemoryPluginConfig } from "./types";
-import { DEFAULT_MEMORY_PLUGIN_CONFIG } from "./types";
-
-// Define interface types for plugin compatibility
-type IAgentComponent = AgentComponent;
-type ISessionComponent = SessionComponent;
-import { createLogger } from "../../log-trace/logger";
-import path from "path";
-import os from "os";
-import fs from "fs/promises";
-import type { ModelMessage } from "ai";
-
-// Memory Agent imports
-import type {
-  MemoryAgentInput,
-  MemoryAgentResult,
-  ProjectSummary,
-} from "./memory-agent";
-import {
-  buildProjectInput,
-  buildGlobalInput,
-  applyMemoryResult,
-  generateProjectSummary,
-  formatMemoryInput,
-  parseMemoryAgentOutput,
-  PROJECT_MEMORY_AGENT_PROMPT,
-  GLOBAL_MEMORY_AGENT_PROMPT,
-  createMemoryAgent,
-} from "./memory-agent";
-
-
-const logger = createLogger("MemoryPlugin");
-
-/**
- * MemoryPlugin - Simplified
- * 
- * 简化的记忆插件，不再自动处理。
- * 
- * 用户应该使用 `roy memory recall --extract` 命令来手动触发记忆提取。
- * 
- * 保留此插件是为了：
- * 1. 保持 API 兼容性
- * 2. 未来可以扩展为可选的自动触发
- */
-export class MemoryPlugin {
-  private config: MemoryPluginConfig;
-  private disposed: boolean = false;
-  private initialized: boolean = false;
-
-  /** 项目 memory 基础目录 */
-  private projectBaseDir: string = "";
-
-  /** 全局 memory 基础目录 */
-  private globalBaseDir: string = "";
-
-  /** 当前工作目录（用于推断项目路径） */
-  private workDir: string = "";
-
-  /** AgentComponent 引用（延迟获取） */
-  private agentComponent: IAgentComponent | null = null;
-
-  constructor(baseDir: string, config: MemoryPluginConfig = {}) {
-    this.config = { ...DEFAULT_MEMORY_PLUGIN_CONFIG, ...config };
-    this.workDir = baseDir;
-    this.projectBaseDir = path.join(baseDir, ".roy", "memory");
-    this.globalBaseDir = path.join(os.homedir(), ".config", "roy-agent", "memory");
-    logger.info("MemoryPlugin (simplified) created", { baseDir, config: this.config });
-  }
-
-  /**
-   * Plugin 名称
-   */
-  get name(): string {
-    return "MemoryPlugin";
-  }
-
-  /**
-   * 订阅的 Hook 点
-   */
-  get hookPoint(): "agent:after.react" {
-    return "agent:after.react";
-  }
-
-  /**
-   * 优先级
-   */
-  get priority(): number {
-    return 50;
-  }
-
-  /**
-   * 描述
-   */
-  get description(): string {
-    return "Memory management plugin. Use 'roy memory recall --extract' to extract memories.";
-  }
-
-  /**
-   * 获取 Hook 定义
-   */
-  get hooks() {
-    return [
-      {
-        point: this.hookPoint as "agent:after.react",
-        priority: this.priority,
-      },
-    ];
-  }
-
-  /**
-   * 初始化
-   */
-  async initialize(): Promise<void> {
-    if (this.initialized) {
-      return;
-    }
-    this.initialized = true;
-    logger.info("MemoryPlugin (simplified) initialized");
-  }
-
-  /**
-   * 执行 Hook
-   * 
-   * 简化为空操作。用户应该使用 `roy memory recall --extract` 命令。
-   */
-  async execute(ctx: HookContext): Promise<void> {
-    if (this.disposed || !this.config.enabled || !this.initialized) {
-      return;
-    }
-
-    // 不再自动处理。用户应该使用 `roy memory recall --extract`
-    logger.debug("MemoryPlugin hook executed. Use 'roy memory recall --extract' for memory extraction.");
-  }
-
-  /**
-   * 准备关闭
-   */
-  prepareShutdown(): void {
-    // 无需处理
-  }
-
-  /**
-   * 检查是否有待处理任务
-   */
-  hasPendingTasks(): boolean {
-    return false;
-  }
-
-  /**
-   * 等待处理完成
-   */
-  async waitForCompletion(): Promise<void> {
-    // 无需等待
-  }
-
-  /**
-   * 释放资源
-   */
-  async dispose(): Promise<void> {
-    if (this.disposed) {
-      return;
-    }
-    this.disposed = true;
-    logger.info("MemoryPlugin (simplified) disposed");
-  }
-
-  /**
-   * 获取项目 base dir
-   */
-  getProjectBaseDir(): string {
-    return this.projectBaseDir;
-  }
-
-  /**
-   * 获取全局 base dir
-   */
-  getGlobalBaseDir(): string {
-    return this.globalBaseDir;
-  }
-}
-
-/**
- * 创建 MemoryPlugin 实例
- */
-export function createMemoryPlugin(
-  baseDir: string,
-  config?: MemoryPluginConfig
-): MemoryPlugin {
-  return new MemoryPlugin(baseDir, config);
-}

package/src/env/memory/plugin/plugin-simplified.test.ts

@@ -1,51 +0,0 @@
-/**
- * @fileoverview Memory Plugin Simplified Tests (TDD)
- * 
- * 测试目标：验证简化后的 Memory Plugin 设计
- * 
- * 设计原则：
- * - 移除 DraftManager（草稿管理已废弃）
- * - 移除 MemoryOrganizer（整理机制已废弃）
- * - 移除 AccessLog（访问日志已废弃）
- * - 保留 MemoryManager（核心组件）
- */
-
-import { describe, expect, test } from "bun:test";
-import * as pluginModule from "./index";
-
-describe("Memory Plugin - Simplified Design", () => {
-  describe("should NOT export deprecated components", () => {
-    test("DraftManager should be removed/not exported", () => {
-      // DraftManager 已被移除，不应该导出
-      expect(pluginModule).not.toHaveProperty("DraftManager");
-    });
-
-    test("MemoryOrganizer should be removed/not exported", () => {
-      expect(pluginModule).not.toHaveProperty("MemoryOrganizer");
-    });
-
-    test("AccessLog should be removed/not exported", () => {
-      expect(pluginModule).not.toHaveProperty("AccessLog");
-    });
-  });
-
-  describe("should keep core functionality", () => {
-    test("MemoryManager should still exist as core component", () => {
-      // MemoryManager 保留，作为核心组件
-      expect(pluginModule.MemoryManager).toBeDefined();
-    });
-
-    test("MemoryPlugin should still exist for backwards compatibility", () => {
-      // MemoryPlugin 保留，但简化内部实现
-      expect(pluginModule.MemoryPlugin).toBeDefined();
-    });
-
-    test("createMemoryPlugin should still exist", () => {
-      expect(pluginModule.createMemoryPlugin).toBeDefined();
-    });
-
-    test("recallMemory should still exist", () => {
-      expect(pluginModule.recallMemory).toBeDefined();
-    });
-  });
-});

package/src/env/memory/plugin/recall-memory.test.ts

@@ -1,106 +0,0 @@
-/**
- * @fileoverview Recall Memory Tests - Simplified
- * 
- * 测试简化后的 recall_memory 工具
- */
-
-import { describe, it, expect, beforeEach, afterEach } from "bun:test";
-import fs from "fs/promises";
-import path from "path";
-import os from "os";
-import { recallMemory, type MemoryPath } from "./recall-memory";
-
-describe("RecallMemory - Simplified", () => {
-  let tmpDir: string;
-  let globalDir: string;
-  let projectDir: string;
-
-  const globalMemoryPath: MemoryPath = {
-    type: "global",
-    path: "",
-  };
-
-  const projectMemoryPath: MemoryPath = {
-    type: "project",
-    path: "",
-  };
-
-  beforeEach(async () => {
-    tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "recall-memory-test-"));
-
-    // Create global memory directory
-    globalDir = path.join(tmpDir, "global-memory");
-    await fs.mkdir(globalDir, { recursive: true });
-    globalMemoryPath.path = globalDir;
-
-    // Create project memory directory
-    projectDir = path.join(tmpDir, "project-memory");
-    await fs.mkdir(projectDir, { recursive: true });
-    projectMemoryPath.path = projectDir;
-  });
-
-  afterEach(async () => {
-    await fs.rm(tmpDir, { recursive: true, force: true });
-  });
-
-  describe("basic recall", () => {
-    it("should return empty when no memory files exist", async () => {
-      const result = await recallMemory([globalMemoryPath]);
-      expect(result).toBe("(No memory files found)");
-    });
-
-    it("should return memory.md content", async () => {
-      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global Memory\n\nTest content.", "utf-8");
-
-      const result = await recallMemory([globalMemoryPath]);
-      expect(result).toContain("# Global Memory");
-      expect(result).toContain("Test content.");
-    });
-
-    it("should include scope prefix in output", async () => {
-      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global Memory", "utf-8");
-
-      const result = await recallMemory([globalMemoryPath]);
-      expect(result).toContain("[global]");
-    });
-  });
-
-  describe("multiple memory paths", () => {
-    it("should recall from multiple scopes", async () => {
-      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global", "utf-8");
-      await fs.writeFile(path.join(projectDir, "memory.md"), "# Project", "utf-8");
-
-      const result = await recallMemory([globalMemoryPath, projectMemoryPath]);
-
-      expect(result).toContain("[global]");
-      expect(result).toContain("# Global");
-      expect(result).toContain("[project]");
-      expect(result).toContain("# Project");
-    });
-  });
-
-  describe("error handling", () => {
-    it("should continue when one scope fails", async () => {
-      // Valid global scope
-      await fs.writeFile(path.join(globalDir, "memory.md"), "# Global", "utf-8");
-
-      // Invalid project path
-      const invalidPath: MemoryPath = { type: "project", path: "/nonexistent/path" };
-
-      // Should not throw, should still return global content
-      const result = await recallMemory([globalMemoryPath, invalidPath]);
-      expect(result).toContain("# Global");
-    });
-  });
-
-  describe("output format", () => {
-    it("should separate scopes with double newlines", async () => {
-      await fs.writeFile(path.join(globalDir, "memory.md"), "Global content", "utf-8");
-      await fs.writeFile(path.join(projectDir, "memory.md"), "Project content", "utf-8");
-
-      const result = await recallMemory([globalMemoryPath, projectMemoryPath]);
-      // Should have sections separated
-      expect(result.split("\n\n").length).toBeGreaterThanOrEqual(2);
-    });
-  });
-});

package/src/env/memory/plugin/recall-memory.ts

@@ -1,53 +0,0 @@
-/**
- * @fileoverview Recall Memory - Simplified
- * 
- * 简化设计：
- * - 移除 AccessLog（访问日志已废弃）
- * - 只读取 memory.md 文件
- */
-
-import fs from "fs/promises";
-import path from "path";
-import type { MemoryPath } from "../types";
-
-/**
- * 读取记忆文件
- * 
- * @param memoryPaths - 记忆路径列表
- * @returns 记忆内容
- */
-export async function recallMemory(
-  memoryPaths: MemoryPath[]
-): Promise<string> {
-  const results: string[] = [];
-
-  for (const memoryPath of memoryPaths) {
-    const scope = memoryPath.type; // "global" | "project"
-    const baseDir = memoryPath.path;
-
-    try {
-      // 读取 memory.md
-      const memoryFile = path.join(baseDir, "memory.md");
-      try {
-        const content = await fs.readFile(memoryFile, "utf-8");
-        if (content.trim()) {
-          results.push(`## [${scope}] memory.md\n${content}`);
-        }
-      } catch {
-        // 文件不存在，跳过
-      }
-    } catch (error) {
-      // 整个 scope 处理失败，跳过
-      console.error(`Error processing memory path ${baseDir}:`, error);
-    }
-  }
-
-  if (results.length === 0) {
-    return "(No memory files found)";
-  }
-
-  return results.join("\n\n");
-}
-
-// Re-export types for convenience
-export type { MemoryPath } from "../types";

package/src/env/memory/plugin/types.ts

@@ -1,101 +0,0 @@
-/**
- * @fileoverview Memory Plugin Types (Simplified)
- *
- * MemoryPlugin 相关类型定义
- *
- * 简化设计：
- * - 移除 Draft 相关的类型
- * - 移除 AccessLog 相关的类型
- */
-
-import type { HookContext } from "../../hook/types";
-import type { ModelMessage } from "ai";
-
-// ============================================================================
-// Config
-// ============================================================================
-
-/**
- * MemoryPlugin configuration
- */
-export interface MemoryPluginConfig {
-  /** Enable memory plugin */
-  enabled?: boolean;
-}
-
-/**
- * Default MemoryPlugin configuration
- */
-export const DEFAULT_MEMORY_PLUGIN_CONFIG: MemoryPluginConfig = {
-  enabled: true,
-};
-
-// ============================================================================
-// Tasks
-// ============================================================================
-
-/**
- * Memory task types
- */
-export type MemoryTaskType =
-  | "extract_memory";   // Extract from messages
-
-/**
- * Memory task
- */
-export interface MemoryTask {
-  id: string;
-  type: MemoryTaskType;
-  payload: unknown;
-  timestamp: number;
-  priority: number;
-}
-
-/**
- * Extract memory payload
- */
-export interface ExtractMemoryPayload {
-  messages: ModelMessage[];
-  sessionId?: string;
-  /** Hook context for Memory Agent */
-  ctx?: MemoryHookContext;
-}
-
-// ============================================================================
-// SessionMessage Interface
-// ============================================================================
-
-/**
- * SessionMessage 接口
- */
-export interface SessionMessage {
-  /** 消息角色 */
-  role: "user" | "assistant" | "system" | "tool";
-  /** 消息内容 */
-  content: string | Array<{ type: string; [key: string]: unknown }>;
-  /** 工具调用 ID（仅 tool 角色） */
-  toolCallId?: string;
-  /** 工具名称（仅 tool 角色） */
-  toolName?: string;
-  /** 时间戳 */
-  timestamp?: number;
-}
-
-// ============================================================================
-// Hook
-// ============================================================================
-
-/**
- * Hook context data for agent:after.react
- */
-export interface MemoryHookContext {
-  /** Current messages for memory extraction */
-  messages: ModelMessage[];
-  /** Current session ID */
-  sessionId?: string;
-  /** Project summaries (populated by project agent) */
-  projectSummaries?: unknown[];
-}
-
-// Re-export for convenience
-export type { HookContext };