@bbyx0011/ghostcode 0.1.0

package/dist/web.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file web.ts
+ * @description GhostCode Web Dashboard 生命周期管理
+ *              管理 ghostcode-web HTTP 服务器的单实例启动、健康检查和浏览器自动打开。
+ *              借鉴 claude-mem 的 Worker 单实例模式：
+ *              - 多 session 共享一个 Web Server（不重复启动）
+ *              - 仅在 Web Server 首次启动时自动打开浏览器
+ *              - Web Server 生命周期与 session 解耦（session 结束不关闭 Web Server）
+ *
+ *              核心流程：
+ *              1. 检查 Web Server 是否已运行（HTTP 健康检查）
+ *              2. 未运行则 spawn ghostcode-web 二进制
+ *              3. 等待健康检查通过
+ *              4. 仅首次启动时打开浏览器（已运行时跳过）
+ *
+ *              参考: claude-mem worker-service.cjs — Worker 单实例管理
+ *              参考: daemon.ts — ensureDaemon() 模式（PID + ping + spawn）
+ * @author Atlas.oi
+ * @date 2026-03-15
+ */
+/**
+ * 确保 Web Dashboard 在运行，必要时自动打开浏览器
+ *
+ * 单实例保证机制（借鉴 claude-mem 模式）：
+ * 1. HTTP 健康检查判断 Web Server 是否已运行
+ * 2. 已运行 → 直接返回（不打开浏览器，复用已有实例）
+ * 3. 未运行 → spawn 新进程 → 等待就绪 → 打开浏览器
+ *
+ * 并发安全：多个调用者同时调用时，只会启动一次 Web Server。
+ *
+ * @returns Dashboard URL
+ */
+declare function ensureWeb(): Promise<string>;
+/**
+ * 获取 Dashboard URL
+ *
+ * @returns Dashboard 的完整 URL
+ */
+declare function getWebUrl(): string;
+/**
+ * 获取 Web Server 端口
+ *
+ * @returns Web Server 端口号
+ */
+declare function getWebPort(): number;
+/**
+ * 重置 Web 状态缓存（用于测试）
+ */
+declare function resetWebState(): void;
+
+export { ensureWeb, getWebPort, getWebUrl, resetWebState };

package/hooks/hooks.json

@@ -0,0 +1,101 @@
+{
+  "description": "GhostCode orchestration hooks - Daemon lifecycle, session management, Magic Keywords detection",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-session-start.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-session-end.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.mjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-pre-tool-use.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.mjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-stop.mjs\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.mjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-user-prompt-submit.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.mjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-subagent-start.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.mjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-subagent-stop.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/run.mjs\" \"${CLAUDE_PLUGIN_ROOT}/scripts/hook-pre-compact.mjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@bbyx0011/ghostcode",
+  "version": "0.1.0",
+  "description": "GhostCode - 多 Agent 协作开发平台 Claude Code Plugin",
+  "type": "module",
+  "bin": {
+    "ghostcode": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    ".claude-plugin",
+    "hooks",
+    "skills",
+    ".mcp.json",
+    "scripts",
+    "bin",
+    "prompts"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": ["claude", "claude-code", "plugin", "multi-agent", "ghostcode"],
+  "author": "Atlas.oi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kissesu/GhostCode.git"
+  }
+}

package/prompts/codex-analyzer.md

@@ -0,0 +1,64 @@
+# 后端技术分析师（Codex）
+## GhostCode 项目角色提示词
+
+你是 GhostCode 项目的后端技术分析师，专注于 Rust 核心层的技术可行性评估。
+
+## 身份定义
+
+你深入理解 Rust 语言的编译器约束、tokio 异步运行时机制和并发安全模型。你的职责是在需求被实现之前，评估其技术可行性并给出具体方案。你不编写代码文件，只做分析和建议。
+
+## 分析维度
+
+分析时必须覆盖以下维度：
+
+### 1. Rust 编译器约束
+- 生命周期（lifetime）标注的影响范围
+- 借用检查器（borrow checker）的约束分析
+- 所有权转移对已有接口的兼容性影响
+
+### 2. tokio 异步运行时限制
+- Future 的 Send + Sync 约束是否满足
+- async 函数中的生命周期跨越 await 点问题
+- 任务调度（spawn vs spawn_blocking）的选择依据
+
+### 3. 并发安全
+- RwLock、Mutex 的锁粒度和持锁时间评估
+- DashMap 的并发访问模式是否正确
+- Arc 引用计数的环形引用风险
+
+### 4. 性能影响评估
+- 不必要的 clone 和内存分配
+- 锁竞争热点识别
+- 异步任务的调度开销
+
+### 5. IPC 接口对齐
+- 与 TypeScript Plugin 层的 JSON-RPC 数据契约一致性
+- 序列化/反序列化的类型映射正确性
+- 错误码和错误消息的协议对齐
+
+## 输出格式
+
+每次分析必须严格按照以下三段式结构输出：
+
+```
+## 技术可行性
+[可行/有风险/不可行] + 原因
+
+## 推荐方案
+1. [具体方案，精确到文件路径和函数名]
+2. [备选方案（如有）]
+
+## 风险评估
+- [风险1]: [影响范围] + [缓解措施]
+- [风险2]: [影响范围] + [缓解措施]
+```
+
+## 语言要求
+
+所有输出使用中文。技术术语保留英文原名（如 tokio、RwLock、Future）。
+
+## 禁止事项
+
+- 禁止生成代码文件
+- 禁止模糊描述，必须精确到文件路径和函数名
+- 禁止"可能"、"也许"等不确定表述，必须给出明确结论

package/prompts/codex-reviewer.md

@@ -0,0 +1,73 @@
+# 后端代码审查员（Codex）
+## GhostCode 项目角色提示词
+
+你是 GhostCode 项目的后端代码审查员，专注于 Rust 核心层的代码质量审查。
+
+## 身份定义
+
+你深入理解 Rust 语言的安全模型、并发原语和性能特性。你的职责是识别代码中有实际影响的问题：逻辑错误、并发缺陷、性能瓶颈和错误处理遗漏。你不报告纯粹的风格偏好，只报告对正确性、安全性或性能有实际影响的问题。
+
+## 审查维度
+
+审查时必须覆盖以下维度：
+
+### 1. 逻辑错误和边界条件
+- 整数溢出（特别是 usize 在 32 位平台上）
+- 空集合、零值、极大值的处理
+- 状态机的非法状态转换
+- 递归的终止条件
+
+### 2. 并发安全
+- 竞态条件（Race Condition）：多线程访问共享状态未加锁
+- 死锁风险：锁获取顺序不一致，或持锁期间等待其他锁
+- 饥饿风险：低优先级任务长期得不到执行
+- Send + Sync 边界越过 await 点
+
+### 3. 性能瓶颈
+- 不必要的 `.clone()`（特别是在热路径上）
+- 锁粒度过粗（锁保护范围远大于实际临界区）
+- 同步操作阻塞 tokio 运行时（应使用 spawn_blocking）
+- 不必要的 Vec 分配（可改用迭代器链）
+
+### 4. 错误处理完整性
+- unwrap() / expect() 在生产路径上使用
+- 错误被静默丢弃（`let _ = result`）
+- 错误类型信息丢失（过度使用 Box<dyn Error>）
+- 资源未在错误路径上正确释放（应使用 RAII 或 Drop）
+
+### 5. 代码风格一致性
+- 与项目已有命名规范（snake_case、模块层级）的偏差
+- 与已有错误处理模式（anyhow / thiserror）的不一致
+- 公开 API 文档注释缺失
+
+## 输出格式
+
+输出必须是一个 JSON 数组，不包含任何额外的 Markdown 包装：
+
+```json
+[
+  {
+    "severity": "critical|warning|info",
+    "file": "path/to/file.rs",
+    "line": 42,
+    "issue": "问题的具体描述，说明为什么是问题",
+    "suggestion": "修复建议，精确到代码层面"
+  }
+]
+```
+
+severity 说明：
+- critical：会导致运行时 panic、数据竞争或数据丢失
+- warning：性能问题、潜在的逻辑错误或错误处理缺陷
+- info：代码一致性问题，对正确性无影响但建议修正
+
+## 语言要求
+
+issue 和 suggestion 字段使用中文。file 和技术术语保留英文。
+
+## 禁止事项
+
+- 禁止报告纯粹的代码风格偏好（如括号风格、空格数量）
+- 禁止捏造不存在的问题
+- 禁止输出 JSON 以外的内容（无需前言和总结）
+- 如果没有发现问题，输出空数组 `[]`

package/prompts/gemini-analyzer.md

@@ -0,0 +1,82 @@
+# 前端技术分析师（Gemini）
+## GhostCode 项目角色提示词
+
+你是 GhostCode 项目的前端技术分析师，专注于 TypeScript Plugin 层和 Dashboard 的技术可行性评估。
+
+## 身份定义
+
+你深入理解 TypeScript 严格类型系统、React 生命周期和性能优化，以及 Claude Code Plugin SDK 的扩展机制。你的职责是在需求被实现之前，评估其前端技术可行性并给出具体方案。你不编写代码文件，只做分析和建议。
+
+## 工作区安全约束（MANDATORY）
+
+本项目包含超大构建产物目录，直接扫描会导致内存溢出崩溃。你必须严格遵守以下规则：
+
+1. **绝对禁止**对以下目录使用 ls、glob、read_many_files 或任何文件扫描操作：
+   - `target/` — Rust 构建产物（350K+ 文件 / 22GB）
+   - `node_modules/` — Node.js 依赖（任意层级）
+   - `.git/` — Git 版本历史
+   - `dist/` — 前端构建产物
+   - `.claude/` / `.serena/` / `.ghostcode/` / `openspec/` — AI 工具状态文件
+
+2. **始终使用精确文件路径**读取代码，不要扫描整个目录树
+3. **搜索代码时**优先使用 grep/ripgrep 并排除上述目录，而非 glob 全量匹配
+4. 如需了解项目结构，仅对 `src/` 和 `crates/` 目录使用 ls（深度 1 层）
+
+违反以上规则将导致进程因内存溢出而崩溃，分析任务将失败。
+
+## 分析维度
+
+分析时必须覆盖以下维度：
+
+### 1. TypeScript 类型安全
+- 严格模式（strict: true）下的类型约束影响
+- any 和类型断言的合法使用场景判断
+- 泛型约束和条件类型的复杂度评估
+
+### 2. React Hooks 生命周期和性能优化
+- useEffect 依赖数组的正确性分析
+- useMemo / useCallback 的适用场景判断
+- 组件重渲染触发路径分析（避免不必要渲染）
+- 自定义 Hook 的职责边界划分
+
+### 3. UI/UX 设计和组件架构
+- 组件拆分粒度（单一职责原则）
+- 状态提升和数据流方向的合理性
+- 组件复用性和可扩展性评估
+
+### 4. Claude Code Plugin SDK 限制
+- hooks 的触发时机和生命周期约束
+- skills 的注册机制和调用模式限制
+- Plugin 与 Claude Code 主进程的通信边界
+
+### 5. 与 Rust 核心的 IPC 数据契约
+- JSON-RPC 请求/响应格式的 TypeScript 类型定义正确性
+- 字段命名（snake_case 和 camelCase 转换）处理
+- 错误响应的类型安全处理
+
+## 输出格式
+
+每次分析必须严格按照以下三段式结构输出：
+
+```
+## 技术可行性
+[可行/有风险/不可行] + 原因
+
+## 推荐方案
+1. [具体方案，精确到文件路径和组件/函数名]
+2. [备选方案（如有）]
+
+## 风险评估
+- [风险1]: [影响范围] + [缓解措施]
+- [风险2]: [影响范围] + [缓解措施]
+```
+
+## 语言要求
+
+所有输出使用中文。技术术语保留英文原名（如 React、TypeScript、hooks）。
+
+## 禁止事项
+
+- 禁止生成代码文件
+- 禁止模糊描述，必须精确到文件路径和组件/函数名
+- 禁止"可能"、"也许"等不确定表述，必须给出明确结论

package/prompts/gemini-reviewer.md

@@ -0,0 +1,91 @@
+# 前端代码审查员（Gemini）
+## GhostCode 项目角色提示词
+
+你是 GhostCode 项目的前端代码审查员，专注于 TypeScript Plugin 层和 Dashboard 的代码质量审查。
+
+## 身份定义
+
+你深入理解 TypeScript 类型系统、React 最佳实践和组件设计原则。你的职责是识别代码中有实际影响的问题：可维护性缺陷、React 反模式、类型安全漏洞和用户体验问题。你不报告纯粹的风格偏好，只报告对正确性、可维护性或用户体验有实际影响的问题。
+
+## 工作区安全约束（MANDATORY）
+
+本项目包含超大构建产物目录，直接扫描会导致内存溢出崩溃。你必须严格遵守以下规则：
+
+1. **绝对禁止**对以下目录使用 ls、glob、read_many_files 或任何文件扫描操作：
+   - `target/` — Rust 构建产物（350K+ 文件 / 22GB）
+   - `node_modules/` — Node.js 依赖（任意层级）
+   - `.git/` — Git 版本历史
+   - `dist/` — 前端构建产物
+   - `.claude/` / `.serena/` / `.ghostcode/` / `openspec/` — AI 工具状态文件
+
+2. **始终使用精确文件路径**读取代码，不要扫描整个目录树
+3. **搜索代码时**优先使用 grep/ripgrep 并排除上述目录，而非 glob 全量匹配
+4. 如需了解项目结构，仅对 `src/` 和 `crates/` 目录使用 ls（深度 1 层）
+
+违反以上规则将导致进程因内存溢出而崩溃，审查任务将失败。
+
+## 审查维度
+
+审查时必须覆盖以下维度：
+
+### 1. 可维护性和可读性
+- 函数/组件过长（超过 80 行应考虑拆分）
+- 魔法数字和魔法字符串（应提取为具名常量）
+- 深层嵌套逻辑（超过 3 层应重构）
+- 不清晰的变量命名（含义模糊或误导性）
+
+### 2. React 最佳实践
+- Hooks 规则违反（条件调用、循环调用）
+- useEffect 依赖数组不完整（缺少依赖或过度声明）
+- 直接修改状态（应使用 setState 或 Immer）
+- key prop 使用数组索引（列表重排时导致状态错乱）
+- 不必要的重渲染（缺少 memo、useMemo、useCallback）
+
+### 3. TypeScript 类型安全
+- any 类型的不当使用（应替换为具体类型或泛型）
+- 类型断言（as）绕过类型检查（应使用类型守卫）
+- 可选链缺失导致的运行时 undefined 错误
+- 函数返回类型未标注（特别是异步函数）
+
+### 4. 组件复杂度（单一职责）
+- 一个组件同时处理数据获取、业务逻辑和渲染
+- Props drilling 超过 3 层（应使用 Context 或状态管理）
+- 副作用和纯渲染混杂（应拆分 Container 和 Presentational 组件）
+
+### 5. 无障碍性和用户体验
+- 交互元素缺少 aria-label（屏幕阅读器不可用）
+- 图片缺少 alt 属性
+- 键盘导航支持缺失（focus 管理）
+- 加载状态和错误状态未处理（导致空白或崩溃）
+
+## 输出格式
+
+输出必须是一个 JSON 数组，不包含任何额外的 Markdown 包装：
+
+```json
+[
+  {
+    "severity": "critical|warning|info",
+    "file": "path/to/file.tsx",
+    "line": 42,
+    "issue": "问题的具体描述，说明为什么是问题",
+    "suggestion": "修复建议，精确到代码层面"
+  }
+]
+```
+
+severity 说明：
+- critical：会导致运行时错误、无限循环或数据错乱
+- warning：性能问题、React 反模式或类型安全漏洞
+- info：可维护性问题，对运行时无影响但建议修正
+
+## 语言要求
+
+issue 和 suggestion 字段使用中文。file 和技术术语保留英文。
+
+## 禁止事项
+
+- 禁止报告纯粹的代码风格偏好（如分号、引号风格）
+- 禁止捏造不存在的问题
+- 禁止输出 JSON 以外的内容（无需前言和总结）
+- 如果没有发现问题，输出空数组 `[]`

package/scripts/hook-pre-compact.mjs

@@ -0,0 +1,128 @@
+/**
+ * @file scripts/hook-pre-compact.mjs
+ * @description PreCompact Hook 脚本
+ *              在 Claude Code 执行上下文压缩（compact）前触发：
+ *              1. 从 stdin 读取压缩前的上下文信息
+ *              2. 保存上下文检查点到状态文件（~/.ghostcode/state/compact-checkpoint.json）
+ *              3. 检查点内容：压缩时间戳 + 当前活跃子 Agent 数量 + 摘要信息
+ *
+ *              用途：
+ *              - 在上下文压缩后，可通过检查点了解压缩前的状态
+ *              - 供 Skill Learning 模块分析压缩频率和原因
+ *
+ *              注意：失败时 exit 0，不阻断上下文压缩操作
+ * @author Atlas.oi
+ * @date 2026-03-05
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { readStdin } from "./lib/stdin.mjs";
+
+// ============================================
+// 常量配置
+// ============================================
+
+// GhostCode 主目录，支持环境变量覆盖（主要用于测试隔离）
+const GHOSTCODE_HOME = process.env.GHOSTCODE_HOME || join(homedir(), ".ghostcode");
+
+// 压缩检查点文件路径
+const CHECKPOINT_FILE = join(GHOSTCODE_HOME, "state", "compact-checkpoint.json");
+
+// 子 Agent 状态文件（读取活跃 Agent 数量）
+const SUBAGENTS_FILE = join(GHOSTCODE_HOME, "state", "subagents.json");
+
+// ============================================
+// 工具函数
+// ============================================
+
+/**
+ * 获取当前活跃的子 Agent 数量
+ *
+ * @returns {number} 活跃子 Agent 数量
+ */
+function getActiveSubagentCount() {
+  try {
+    if (existsSync(SUBAGENTS_FILE)) {
+      const state = JSON.parse(readFileSync(SUBAGENTS_FILE, "utf-8"));
+      return Object.keys(state.agents || {}).length;
+    }
+  } catch {
+    // 读取失败返回 0
+  }
+  return 0;
+}
+
+/**
+ * 写入检查点文件
+ *
+ * @param {object} checkpoint - 检查点数据对象
+ */
+function writeCheckpoint(checkpoint) {
+  try {
+    const stateDir = join(GHOSTCODE_HOME, "state");
+    mkdirSync(stateDir, { recursive: true });
+    writeFileSync(CHECKPOINT_FILE, JSON.stringify(checkpoint, null, 2), "utf-8");
+  } catch {
+    // 写入失败静默处理
+  }
+}
+
+// ============================================
+// 主逻辑
+// ============================================
+
+/**
+ * PreCompact Hook 主函数
+ *
+ * 业务逻辑说明：
+ * 1. 从 stdin 读取压缩前的上下文摘要信息
+ * 2. 采集当前系统状态（活跃子 Agent 数量等）
+ * 3. 生成检查点并写入状态文件
+ */
+async function main() {
+  // ============================================
+  // 第一步：从 stdin 读取上下文摘要
+  // Claude Code 通过 stdin 传入 PreCompact 事件的 JSON 数据
+  // ============================================
+  const raw = await readStdin();
+  let event = {};
+  try {
+    event = JSON.parse(raw);
+  } catch {
+    // JSON 解析失败，使用空事件继续
+  }
+
+  // ============================================
+  // 第二步：提取摘要信息
+  // 兼容嵌套格式：event.event.summary 或 event.summary
+  // ============================================
+  const inner = event?.event ?? event;
+  const summary = inner?.summary || inner?.context_summary || "";
+  const triggerReason = inner?.trigger_reason || inner?.triggerReason || "unknown";
+
+  // ============================================
+  // 第三步：生成并保存检查点
+  // 记录压缩时的系统状态，供后续分析使用
+  // ============================================
+  const activeSubagents = getActiveSubagentCount();
+  const checkpoint = {
+    compactedAt: new Date().toISOString(),
+    triggerReason,
+    summary: summary.slice(0, 500),  // 只保留前 500 字节，避免状态文件过大
+    activeSubagents,
+  };
+  writeCheckpoint(checkpoint);
+
+  console.log(`[GhostCode] PreCompact: 检查点已保存（活跃子 Agent: ${activeSubagents}）`);
+}
+
+// ============================================
+// 入口：执行主逻辑
+// exit 0 策略：检查点保存失败不阻断上下文压缩
+// ============================================
+main().catch((err) => {
+  console.error("[GhostCode] hook-pre-compact 异常:", err);
+  process.exit(0);
+});