@optima-chat/optima-agent 0.8.97 → 0.8.99

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

@@ -0,0 +1,69 @@
+---
+name: linting-the-wiki
+description: Use when a maintained knowledge base needs a health check for gaps, stale claims, contradictions, missing links, or indexing issues.
+---
+
+# Linting The Wiki
+
+这个 skill 用来检查 wiki 随时间推移后的完整性和可维护性。
+
+## 职责
+
+- 识别 orphan pages
+- 识别断链或缺失链接
+- 识别过时或已被覆盖的结论
+- 识别矛盾
+- 识别索引覆盖不足
+- 识别值得通过 web search 或补充来源来填补的数据空白
+- 提出或执行有边界的修复
+
+## 不负责
+
+- 初始 schema 设计
+- 无边界 wiki 重写
+
+## 工作规则
+
+lint 的目标是让维护债务变得可见。如果某条结论已经过时或被冲突信息挑战，这件事应该很容易被发现。
+
+## 流程
+
+使用这个 skill 时，按以下顺序进行：
+
+1. 检查 `index.md`、关键 wiki 目录和一组有代表性的页面
+2. 先识别结构性问题，再决定是否动手修改
+3. 按类型归类问题：链接、覆盖度、过时、矛盾、重复、页面规模或索引问题
+4. 除非用户要求更大范围修复，否则只应用小而明确的修补
+5. 清楚报告仍未解决的问题
+
+## 要检查什么
+
+应检查：
+
+- 没有入链或出链的页面
+- 被反复提及但没有独立页面的实体或概念
+- 本应并入 overview 的 analysis 页面，或反过来的情况
+- 新来源进入后仍未更新的旧综述
+- `index.md` 与实际长期页面之间的漂移
+- 为了清晰起见应被拆分的大页面
+- 由于缺少来源而无法回答、但明显值得继续调查的问题
+
+## 修复边界
+
+安全的 lint 修复通常包括：
+
+- 增加缺失链接
+- 更新 `index.md`
+- 澄清过时标签
+- 就地标出矛盾
+
+不要把 lint 变成无边界重写。如果需要更深层次的结构调整，要明确说出来，并在边界处停下，除非用户明确要求继续。
+
+## 最小交付标准
+
+一次成功的 lint 至少应留下：
+
+- 一份简短但具体的问题清单
+- 已经完成的有边界修复
+- 已修复问题与剩余债务之间的清晰区分
+- 需要通过新来源或 web search 继续补足的空白点

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

@@ -0,0 +1,66 @@
+---
+name: querying-the-wiki
+description: Use when answering questions against an existing wiki-like knowledge base and deciding whether the result should be preserved.
+---
+
+# Querying The Wiki
+
+这个 skill 通过把“维护后的 wiki”视为主要知识层来回答问题。
+
+## 职责
+
+- 从 `index.md` 开始
+- 阅读相关 wiki 页面
+- 优先基于维护后的 wiki 回答
+- 在适当时把长期有效的结果回写到 `wiki/analyses/` 或 overview 页面
+
+## 不负责
+
+- 把每个问题都转成新的 ingest
+- 大规模维护性重构
+
+## 工作规则
+
+如果一个答案之后大概率还会有用，就应把它保存在 wiki 中，而不是只留在聊天里。
+
+## 流程
+
+使用这个 skill 时，按以下顺序进行：
+
+1. 阅读 `index.md`
+2. 找到最相关的 wiki 页面
+3. 优先基于这些维护后的页面回答
+4. 只有在 wiki 不完整或含混时才回到 raw sources
+5. 判断这个答案是否应该被保留
+6. 如果应该，就把它写进 `wiki/analyses/` 或对应 overview 页面
+
+## Query 规则
+
+回答时：
+
+- 优先使用维护后的 wiki，而不是每次从头重建
+- 当答案依赖不完整或过时的 wiki 覆盖时，要说清楚
+- 把 source-backed 内容与综合推断区分开
+- 标出这个问题是否暴露了 wiki 的结构性空缺
+- 尽量在答案中显式引用所使用的 wiki 页面；如果回看了 raw sources，也要说明
+
+## 何时保留结果
+
+在下列情况下，应把结果写回 wiki：
+
+- 同一个问题很可能会再次出现
+- 这个答案比较了多个来源或页面
+- 这个答案形成了可长期复用的综合
+- 这个答案解决了当前 wiki 尚未解释清楚的混乱点
+
+独立的长期输出应进入 `wiki/analyses/`。如果这个答案主要是在改进某个主题的现有综述，则应写入对应 overview 页面。
+
+## 最小交付标准
+
+一次成功的 query 至少应产出：
+
+- 一个直接回答用户问题的结果
+- 在答案中或答案后明确引用使用了哪些 wiki 页面
+- 清楚说明这个结果是否值得被保留
+
+如果答案暴露了长期缺口，却没有说明 wiki 该在哪里补强，这次 query 就是不完整的。

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

@@ -0,0 +1,76 @@
+---
+name: updating-related-pages
+description: Use when newly ingested source material affects existing entity pages, overview pages, or cross-references in the wiki.
+---
+
+# Updating Related Pages
+
+这个 skill 用来在来源 ingest 之后，同步 wiki 的其他部分。
+
+## 职责
+
+- 更新相关 entity 页面
+- 更新相关 overview 页面
+- 增加或修复交叉链接
+- 显式记录冲突
+- 更新 `index.md`
+- 追加 `log.md`
+
+## 不负责
+
+- 独自承担完整 ingest 流程
+- 替代 query 行为
+
+## 工作规则
+
+当新证据改变已有认知时，不要静默覆盖旧结论。应把修正过程明确写出来。
+
+## 流程
+
+使用这个 skill 时，按以下顺序进行：
+
+1. 从来源页或 ingest 产出的 affected-page 列表开始
+2. 确认哪些 entity、overview 和 analysis 页面需要更新
+3. 优先更新现有页面，而不是先新建页面
+4. 为这些变更后的页面补齐或修复交叉链接
+5. 如果创建了新的长期页面，则更新 `index.md`
+6. 如果这次变更实质性影响了 wiki，则在 `log.md` 中追加记录
+
+## 更新规则
+
+更新既有页面时：
+
+- 保持页面的稳定职责
+- 把新信息合并进正确的 section，而不是随手堆一段笔记
+- 当新来源改变了先前理解时，要让修正过程可见
+- 让 source-backed 内容与综合推断保持可区分
+- 优先使用可链接的短陈述，而不是长段无结构文字
+
+## 冲突处理
+
+如果新来源与旧页面冲突：
+
+- 不要无解释地删除旧结论
+- 记录新的证据
+- 更新当前理解
+- 让之后的读者仍然看得出分歧在哪里
+
+页面要体现“理解是如何变化的”，而不只是“它发生了变化”。
+
+## 何时创建新页面
+
+只有在下列情况下才应新建页面：
+
+- 新信息引入了一个 recurring concept，但还没有稳定 landing page
+- 某个 analysis 或 comparison 已经有独立长期价值
+- 现有页面已经过宽，无法干净吸收这次更新
+
+如果对现有页面做一次聚焦更新会让 wiki 更清楚，那就不要新建页面。
+
+## 最小交付标准
+
+一次成功的 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":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAoBvG;;GAEG;AACH,SAAS,sBAAsB,CAAC,OAAe;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAyB,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,GAAW,EAAE,QAAgB,EAAE,SAAkB;IACxF,IAAI,CAAC;QACH,SAAS;QACT,MAAM,eAAe,GAAG,OAAO;aAC5B,OAAO,CAAC,2BAA2B,EAAE,QAAQ,CAAC;aAC9C,OAAO,CAAC,mBAAmB,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;QAExD,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,EAAE;YACvC,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,iBAAiB;QACjB,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,2BAA2B,CAClC,UAA6B,EAC7B,QAAgB,EAChB,GAAW,EACX,YAAsC,EACtC,QAAgE;IAEhE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QACrC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACnC,8EAA8E;YAC9E,OAAO,KAAK,EAAE,KAAU,EAAE,SAA6B,EAAE,OAAgC,EAAE,EAAE;gBAC3F,mCAAmC;gBACnC,IAAI,QAAQ,KAAK,YAAY,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;oBACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC;oBACjC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;oBAEnC,iBAAiB;oBACjB,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;wBAChG,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAmB,CAAC;wBAE/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;4BAC5C,MAAM,SAAS,GAAG,YAAY,EAAE,IAAI,SAAS,CAAC;4BAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,aAAa,SAAS,GAAG,CAAC,CAAC;4BAEtF,OAAO,CAAC,GAAG,CAAC,gDAAgD,QAAQ,OAAO,WAAW,EAAE,CAAC,CAAC;4BAE1F,oCAAoC;4BACpC,IAAI,CAAC;gCACH,OAAO,CAAC,GAAG,CAAC,6CAA6C,QAAQ,EAAE,CAAC,CAAC;gCAErE,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;oCACzB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;oCAEvD,OAAO;oCACP,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;oCACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wCACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oCACtC,CAAC;oCACD,OAAO;oCACP,aAAa,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;oCAC7D,OAAO,CAAC,GAAG,CAAC,kCAAkC,WAAW,EAAE,CAAC,CAAC;oCAE7D,eAAe;oCACf,OAAO;wCACL,QAAQ,EAAE,OAAO;wCACjB,aAAa,EAAE,4CAA4C;qCAC5D,CAAC;gCACJ,CAAC;qCAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oCAC/B,OAAO;oCACP,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;wCAC5B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;wCACnD,OAAO,CAAC,GAAG,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;wCAE5D,oBAAoB;wCACpB,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,oBAAoB,OAAO,EAAE;yCAC7C,CAAC;oCACJ,CAAC;yCAAM,CAAC;wCACN,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,mBAAmB,WAAW,EAAE;yCAChD,CAAC;oCACJ,CAAC;gCACH,CAAC;qCAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oCAC/B,kBAAkB;oCAClB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;wCAC5B,IAAI,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;wCAEjD,OAAO;wCACP,IAAI,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;4CACjD,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;gDAC1B,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;4CAC3E,CAAC;iDAAM,CAAC;gDACN,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;4CACxE,CAAC;4CACD,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;4CAC7C,OAAO,CAAC,GAAG,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;wCAC9D,CAAC;wCAED,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,0BAA0B;yCAC1C,CAAC;oCACJ,CAAC;yCAAM,CAAC;wCACN,OAAO;4CACL,QAAQ,EAAE,OAAO;4CACjB,aAAa,EAAE,mBAAmB,WAAW,EAAE;yCAChD,CAAC;oCACJ,CAAC;gCACH,CAAC;4BACH,CAAC;4BAAC,OAAO,KAAU,EAAE,CAAC;gCACpB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;gCAC9C,OAAO;oCACL,QAAQ,EAAE,OAAO;oCACjB,aAAa,EAAE,UAAU,KAAK,CAAC,OAAO,EAAE;iCACzC,CAAC;4BACJ,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC5B,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;oBACjC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;oBAEtE,iBAAiB;oBACjB,IAAI,MAAM,EAAE,CAAC;wBACX,OAAO;4BACL,QAAQ,EAAE,IAAI;4BACd,aAAa,EAAE,MAAM;yBACtB,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5B,CAAC,CAAC;QACJ,CAAC,CAAC;KACH,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,GAAW,EACX,YAAsC;IAEtC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC9D,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;SACxC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhC,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEnD,SAAS;YACT,MAAM,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;YACtC,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAElE,OAAO;YACP,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;YAED,OAAO;YACP,IAAI,gBAAgB,CAAC,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtE,KAAK,MAAM,OAAO,IAAI,gBAAgB,CAAC,QAAQ,EAAE,CAAC;oBAChD,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;YAED,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAEpD,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,eAAe;YACf,IAAI,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACnC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;gBAC9C,KAAK,CAAC,YAAY,CAAC,IAAI,CACrB,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,cAAc,CAAC,CAC5G,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBACjC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;gBAC1C,KAAK,CAAC,UAAU,CAAC,IAAI,CACnB,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,CACxG,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBAClC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;gBAC5C,KAAK,CAAC,WAAW,CAAC,IAAI,CACpB,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,aAAa,CAAC,CAC1G,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,CACb,GAAG,2BAA2B,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,CAC5F,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,2CAA2C,SAAS,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,SAAS,GAAG,EAAE,KAAK,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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"}