@optima-chat/optima-agent 0.8.98 → 0.8.100

package/.claude/skills/querying-the-wiki/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: querying-the-wiki
+description: "从已有知识库中查询和回答问题。当用户提到的话题可能在 ~/kb/ 的某个知识库中有覆盖时使用。"
+---
+
+# Querying The Wiki
+
+通过把维护后的 wiki 视为主要知识层来回答问题。
+
+## 启动 SOP
+
+1. `ls ~/kb/REGISTRY.md`
+   - 不存在 → 告诉用户"还没有知识库，需要先创建一个"，引导使用 initializing-kb
+2. 读 `~/kb/REGISTRY.md` — 获取所有 active 的 KB 列表
+3. 确定目标 KB：
+   - 用户明确指定了 KB slug 或主题 → 直接用
+   - 只有一个 active KB → 用它
+   - 多个 active → 根据用户问题匹配 `主题` + `说明` 字段；无法判断时列出让用户选
+4. 读 `~/kb/<slug>/AGENTS.md` 了解该 KB 的契约
+
+## 查询流程
+
+1. 读 `~/kb/<slug>/index.md`
+2. 找到最相关的 wiki 页面
+3. 优先基于维护后的页面回答
+4. 只有在 wiki 不完整或含混时才回到 raw sources
+5. 判断这个答案是否应该被保留
+6. 如果应该，写进 `~/kb/<slug>/wiki/analyses/` 或对应 overview 页面
+7. 追加 `~/kb/PROGRESS.md`
+8. `cd ~/kb && git add -A && git commit -m "[<slug>] query: <一句话>"`
+
+## Query 规则
+
+回答时：
+
+- 优先使用维护后的 wiki，而不是每次从头重建
+- 当答案依赖不完整或过时的 wiki 覆盖时，要说清楚
+- 把 source-backed 内容与综合推断区分开
+- 标出这个问题是否暴露了 wiki 的结构性空缺
+- 在答案中显式引用所使用的 wiki 页面；如果回看了 raw sources，也要说明
+
+## 何时保留结果
+
+在下列情况下，应把结果写回 wiki：
+
+- 同一个问题很可能会再次出现
+- 这个答案比较了多个来源或页面
+- 这个答案形成了可长期复用的综合
+- 这个答案解决了当前 wiki 尚未解释清楚的混乱点
+
+独立的长期输出应进入 `wiki/analyses/`。如果主要是改进某个主题的现有综述，则写入对应 overview 页面。
+
+## 最小交付标准
+
+一次成功的 query 至少应产出：
+
+- 一个直接回答用户问题的结果
+- 在答案中明确引用使用了哪些 wiki 页面
+- 清楚说明这个结果是否值得被保留

package/.claude/skills/updating-related-pages/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: updating-related-pages
+description: "在 ingest 后同步更新知识库的关联页面。通常由 ingesting-sources 触发，不单独使用。"
+---
+
+# Updating Related Pages
+
+在来源 ingest 之后，同步 wiki 的其他部分。
+
+## 启动 SOP
+
+1. `ls ~/kb/REGISTRY.md`
+   - 不存在 → 告诉用户"还没有知识库，需要先创建一个"，引导使用 initializing-kb
+2. 读 `~/kb/REGISTRY.md` — 获取所有 active 的 KB 列表
+3. 确定目标 KB：
+   - 用户明确指定了 KB slug 或主题 → 直接用
+   - 只有一个 active KB → 用它
+   - 多个 active → 根据用户问题匹配 `主题` + `说明` 字段；无法判断时列出让用户选
+4. 读 `~/kb/<slug>/AGENTS.md` 了解该 KB 的契约
+
+## 更新流程
+
+1. 从来源页或 ingest 产出的 affected-page 列表开始
+2. 确认哪些 entity、overview 和 analysis 页面需要更新
+3. 优先更新现有页面，而不是先新建页面
+4. 为变更后的页面补齐或修复交叉链接
+5. 如果创建了新的长期页面，更新 `~/kb/<slug>/index.md`
+6. 如果这次变更实质性影响了 wiki，在 `~/kb/<slug>/log.md` 中追加记录
+7. 追加 `~/kb/PROGRESS.md`
+8. `cd ~/kb && git add -A && git commit -m "[<slug>] update: <更新了哪些页面>"`
+
+## 更新规则
+
+更新既有页面时：
+
+- 保持页面的稳定职责
+- 把新信息合并进正确的 section，而不是随手堆一段笔记
+- 当新来源改变了先前理解时，要让修正过程可见
+- 让 source-backed 内容与综合推断保持可区分
+- 优先使用可链接的短陈述，而不是长段无结构文字
+
+## 冲突处理
+
+如果新来源与旧页面冲突：
+
+- 不要无解释地删除旧结论
+- 记录新的证据
+- 更新当前理解
+- 让之后的读者仍然看得出分歧在哪里
+
+## 何时创建新页面
+
+只有在下列情况下才应新建页面：
+
+- 新信息引入了一个 recurring concept，但还没有稳定 landing page
+- 某个 analysis 或 comparison 已经有独立长期价值
+- 现有页面已经过宽，无法干净吸收这次更新
+
+## 最小交付标准
+
+一次成功的 related-page update 至少应留下：
+
+- 被同步更新过的相关页面
+- source、entity、overview 和 analysis 页面之间清晰的交叉链接
+- 在适用时，对"理解发生变化"有可见处理

package/dist/bin/comfy.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/comfy-cli";
+//# sourceMappingURL=comfy.d.ts.map

package/dist/bin/comfy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfy.d.ts","sourceRoot":"","sources":["../../bin/comfy.ts"],"names":[],"mappings":";AACA,OAAO,wBAAwB,CAAC"}

package/dist/bin/comfy.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/comfy-cli";
+//# sourceMappingURL=comfy.js.map

package/dist/bin/comfy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfy.js","sourceRoot":"","sources":["../../bin/comfy.ts"],"names":[],"mappings":";AACA,OAAO,wBAAwB,CAAC"}

package/dist/bin/growth.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/growth-cli";
+//# sourceMappingURL=growth.d.ts.map

package/dist/bin/growth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth.d.ts","sourceRoot":"","sources":["../../bin/growth.ts"],"names":[],"mappings":";AACA,OAAO,yBAAyB,CAAC"}

package/dist/bin/growth.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "@optima-chat/growth-cli";
+//# sourceMappingURL=growth.js.map

package/dist/bin/growth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth.js","sourceRoot":"","sources":["../../bin/growth.ts"],"names":[],"mappings":";AACA,OAAO,yBAAyB,CAAC"}

package/dist/bin/sync-kb-skills.d.ts

@@ -0,0 +1,6 @@
+export interface SyncKbSkillsOptions {
+    repoRoot?: string;
+    packageRoot?: string;
+}
+export declare function syncKbSkills(options?: SyncKbSkillsOptions): string[];
+//# sourceMappingURL=sync-kb-skills.d.ts.map

package/dist/bin/sync-kb-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-kb-skills.d.ts","sourceRoot":"","sources":["../../bin/sync-kb-skills.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsCD,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,EAAE,CA0BxE"}

package/dist/bin/sync-kb-skills.js

@@ -0,0 +1,65 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createRequire } from "node:module";
+const MANIFEST_FILENAME = ".kb-skills-managed.json";
+function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+function resolveKbSkillsPackageRoot() {
+    const require = createRequire(import.meta.url);
+    const packageJsonPath = require.resolve("kb-skills/package.json");
+    return path.dirname(packageJsonPath);
+}
+function listKbSkillNames(skillsDir) {
+    if (!fs.existsSync(skillsDir)) {
+        throw new Error(`kb-skills skills directory not found: ${skillsDir}`);
+    }
+    return fs
+        .readdirSync(skillsDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .filter((name) => fs.existsSync(path.join(skillsDir, name, "SKILL.md")))
+        .sort();
+}
+function readManagedSkills(manifestPath) {
+    if (!fs.existsSync(manifestPath)) {
+        return [];
+    }
+    const parsed = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+    return Array.isArray(parsed.skills) ? parsed.skills.filter((skill) => typeof skill === "string") : [];
+}
+function writeManagedSkills(manifestPath, skills) {
+    fs.writeFileSync(manifestPath, JSON.stringify({ skills }, null, 2) + "\n");
+}
+export function syncKbSkills(options = {}) {
+    const repoRoot = options.repoRoot ?? process.cwd();
+    const packageRoot = options.packageRoot ?? resolveKbSkillsPackageRoot();
+    const sourceBaseDir = path.join(packageRoot, "skills");
+    const targetBaseDir = path.join(repoRoot, ".claude", "skills");
+    const manifestPath = path.join(targetBaseDir, MANIFEST_FILENAME);
+    const skillNames = listKbSkillNames(sourceBaseDir);
+    const previouslyManagedSkills = readManagedSkills(manifestPath);
+    ensureDir(targetBaseDir);
+    for (const skillName of previouslyManagedSkills) {
+        if (!skillNames.includes(skillName)) {
+            fs.rmSync(path.join(targetBaseDir, skillName), { recursive: true, force: true });
+        }
+    }
+    for (const skillName of skillNames) {
+        const sourceDir = path.join(sourceBaseDir, skillName);
+        const targetDir = path.join(targetBaseDir, skillName);
+        fs.rmSync(targetDir, { recursive: true, force: true });
+        fs.cpSync(sourceDir, targetDir, { recursive: true });
+    }
+    writeManagedSkills(manifestPath, skillNames);
+    return skillNames;
+}
+const thisFilePath = process.argv[1] ? path.resolve(process.argv[1]) : "";
+if (thisFilePath && import.meta.url === `file://${thisFilePath}`) {
+    const syncedSkills = syncKbSkills();
+    console.log(`Synced ${syncedSkills.length} kb skills.`);
+    for (const skillName of syncedSkills) {
+        console.log(skillName);
+    }
+}
+//# sourceMappingURL=sync-kb-skills.js.map

package/dist/bin/sync-kb-skills.js.map

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

package/dist/src/hooks-loader.d.ts

@@ -0,0 +1,6 @@
+import type { HooksConfig } from "./types.js";
+/**
+ * 从 skills 目录加载所有 skill 的 hooks
+ */
+export declare function loadSkillHooks(skillsDir: string, cwd: string, getSessionId: () => string | undefined): HooksConfig;
+//# sourceMappingURL=hooks-loader.d.ts.map

package/dist/src/hooks-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-loader.d.ts","sourceRoot":"","sources":["../../src/hooks-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AAwL5D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,GACrC,WAAW,CAiFb"}

package/dist/src/hooks-loader.js

@@ -0,0 +1,215 @@
+import { readFileSync, readdirSync, existsSync, writeFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import yaml from "js-yaml";
+import { execSync } from "child_process";
+import { YamlValidator, formatValidationErrors, formatValidationWarning } from "./validation/index.js";
+/**
+ * 从 SKILL.md 提取 YAML frontmatter
+ */
+function extractYamlFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return null;
+    try {
+        return yaml.load(match[1]);
+    }
+    catch (error) {
+        console.error("Failed to parse YAML frontmatter:", error);
+        return null;
+    }
+}
+/**
+ * 执行 shell 命令并返回结果
+ */
+function executeCommand(command, cwd, skillDir, sessionId) {
+    try {
+        // 替换环境变量
+        const expandedCommand = command
+            .replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, skillDir)
+            .replace(/\$\{SESSION_ID\}/g, sessionId || 'default');
+        const result = execSync(expandedCommand, {
+            cwd,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return result.trim();
+    }
+    catch (error) {
+        // 命令失败不阻塞，返回错误信息
+        return error.stdout || error.message || "";
+    }
+}
+/**
+ * 转换 skill hooks 为 SDK hooks 格式
+ */
+function convertSkillHooksToSdkHooks(skillHooks, skillDir, cwd, getSessionId, hookType) {
+    return skillHooks.map((hookConfig) => ({
+        matcher: hookConfig.matcher,
+        hooks: hookConfig.hooks.map((hook) => {
+            // SDK HookCallback 签名: (input, toolUseID, options) => Promise<HookJSONOutput>
+            return async (input, toolUseID, options) => {
+                // PreToolUse: 拦截并重定向 planning 文件操作
+                if (hookType === "PreToolUse" && input.tool_name && input.tool_input) {
+                    const toolName = input.tool_name;
+                    const toolInput = input.tool_input;
+                    // 处理文件操作工具的路径重定向
+                    if ((toolName === "Write" || toolName === "Read" || toolName === "Edit") && toolInput.file_path) {
+                        const filePath = toolInput.file_path;
+                        if (filePath.includes(".planning/default/")) {
+                            const sessionId = getSessionId() || "default";
+                            const updatedPath = filePath.replace(".planning/default/", `.planning/${sessionId}/`);
+                            console.log(`[hooks-loader] Intercepting and redirecting: ${filePath} -> ${updatedPath}`);
+                            // 手动执行文件操作并 return，不要继续到 command 部分
+                            try {
+                                console.log(`[hooks-loader] Inside try block, toolName=${toolName}`);
+                                if (toolName === "Write") {
+                                    console.log(`[hooks-loader] Handling Write operation`);
+                                    // 创建目录
+                                    const dir = dirname(updatedPath);
+                                    if (!existsSync(dir)) {
+                                        mkdirSync(dir, { recursive: true });
+                                    }
+                                    // 写入文件
+                                    writeFileSync(updatedPath, toolInput.content || "", "utf-8");
+                                    console.log(`[hooks-loader] File written to ${updatedPath}`);
+                                    // Block 原始工具执行
+                                    return {
+                                        decision: "block",
+                                        systemMessage: `File written to session-specific directory`,
+                                    };
+                                }
+                                else if (toolName === "Read") {
+                                    // 读取文件
+                                    if (existsSync(updatedPath)) {
+                                        const content = readFileSync(updatedPath, "utf-8");
+                                        console.log(`[hooks-loader] File read from ${updatedPath}`);
+                                        // Block 原始工具，返回文件内容
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File content:\n\n${content}`,
+                                        };
+                                    }
+                                    else {
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File not found: ${updatedPath}`,
+                                        };
+                                    }
+                                }
+                                else if (toolName === "Edit") {
+                                    // Edit 需要读取、修改、写入
+                                    if (existsSync(updatedPath)) {
+                                        let content = readFileSync(updatedPath, "utf-8");
+                                        // 执行替换
+                                        if (toolInput.old_string && toolInput.new_string) {
+                                            if (toolInput.replace_all) {
+                                                content = content.split(toolInput.old_string).join(toolInput.new_string);
+                                            }
+                                            else {
+                                                content = content.replace(toolInput.old_string, toolInput.new_string);
+                                            }
+                                            writeFileSync(updatedPath, content, "utf-8");
+                                            console.log(`[hooks-loader] File edited at ${updatedPath}`);
+                                        }
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File edited successfully`,
+                                        };
+                                    }
+                                    else {
+                                        return {
+                                            decision: "block",
+                                            systemMessage: `File not found: ${updatedPath}`,
+                                        };
+                                    }
+                                }
+                            }
+                            catch (error) {
+                                console.error(`[hooks-loader] Error:`, error);
+                                return {
+                                    decision: "block",
+                                    systemMessage: `Error: ${error.message}`,
+                                };
+                            }
+                        }
+                    }
+                }
+                if (hook.type === "command") {
+                    const sessionId = getSessionId();
+                    const result = executeCommand(hook.command, cwd, skillDir, sessionId);
+                    // 如果有输出，作为系统消息返回
+                    if (result) {
+                        return {
+                            continue: true,
+                            systemMessage: result,
+                        };
+                    }
+                }
+                return { continue: true };
+            };
+        }),
+    }));
+}
+/**
+ * 从 skills 目录加载所有 skill 的 hooks
+ */
+export function loadSkillHooks(skillsDir, cwd, getSessionId) {
+    const hooks = {};
+    if (!existsSync(skillsDir)) {
+        return hooks;
+    }
+    const skillDirs = readdirSync(skillsDir, { withFileTypes: true })
+        .filter((dirent) => dirent.isDirectory())
+        .map((dirent) => dirent.name);
+    for (const skillName of skillDirs) {
+        const skillDir = join(skillsDir, skillName);
+        const skillMdPath = join(skillDir, "SKILL.md");
+        if (!existsSync(skillMdPath)) {
+            continue;
+        }
+        try {
+            const content = readFileSync(skillMdPath, "utf-8");
+            // 验证配置文件
+            const validator = new YamlValidator();
+            const validationResult = validator.validate(content, skillMdPath);
+            // 显示错误
+            if (!validationResult.valid) {
+                console.error(formatValidationErrors(validationResult.errors));
+                continue;
+            }
+            // 显示警告
+            if (validationResult.warnings && validationResult.warnings.length > 0) {
+                for (const warning of validationResult.warnings) {
+                    console.warn(formatValidationWarning(warning));
+                }
+            }
+            const frontmatter = extractYamlFrontmatter(content);
+            if (!frontmatter?.hooks) {
+                continue;
+            }
+            // 转换各个 hook 事件
+            if (frontmatter.hooks.SessionStart) {
+                hooks.SessionStart = hooks.SessionStart || [];
+                hooks.SessionStart.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.SessionStart, skillDir, cwd, getSessionId, "SessionStart"));
+            }
+            if (frontmatter.hooks.PreToolUse) {
+                hooks.PreToolUse = hooks.PreToolUse || [];
+                hooks.PreToolUse.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.PreToolUse, skillDir, cwd, getSessionId, "PreToolUse"));
+            }
+            if (frontmatter.hooks.PostToolUse) {
+                hooks.PostToolUse = hooks.PostToolUse || [];
+                hooks.PostToolUse.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.PostToolUse, skillDir, cwd, getSessionId, "PostToolUse"));
+            }
+            if (frontmatter.hooks.Stop) {
+                hooks.Stop = hooks.Stop || [];
+                hooks.Stop.push(...convertSkillHooksToSdkHooks(frontmatter.hooks.Stop, skillDir, cwd, getSessionId, "Stop"));
+            }
+            console.log(`[hooks-loader] Loaded hooks from skill: ${skillName}`);
+        }
+        catch (error) {
+            console.error(`[hooks-loader] Failed to load hooks from ${skillName}:`, error);
+        }
+    }
+    return hooks;
+}
+//# sourceMappingURL=hooks-loader.js.map

package/dist/src/hooks-loader.js.map

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

package/dist/src/ui/App.d.ts

@@ -0,0 +1,6 @@
+interface AppProps {
+    cwd?: string;
+}
+export declare function App({ cwd }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=App.d.ts.map

package/dist/src/ui/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../src/ui/App.tsx"],"names":[],"mappings":"AAcA,UAAU,QAAQ;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,QAAQ,2CAqMpC"}