@optima-chat/optima-agent 0.8.98 → 0.8.100

package/.claude/settings.local.json

@@ -0,0 +1,166 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh api:*)",
+      "WebFetch(domain:platform.claude.com)",
+      "Bash(git init:*)",
+      "Bash(mkdir:*)",
+      "Bash(npm run typecheck:*)",
+      "Bash(npm view:*)",
+      "WebSearch",
+      "Bash(commerce --help)",
+      "Bash(done)",
+      "Bash(commerce product:*)",
+      "Bash(commerce order:*)",
+      "Bash(commerce i18n:*)",
+      "Bash(google-ads:*)",
+      "Bash(scout --help:*)",
+      "Bash(tree:*)",
+      "Bash(cloc:*)",
+      "Bash(npm run build:*)",
+      "Bash(git restore:*)",
+      "Bash(gh repo view:*)",
+      "Bash(mv:*)",
+      "Bash(rmdir:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push)",
+      "Bash(timeout 5 npm run optima:*)",
+      "Bash(npm install:*)",
+      "Bash(cat:*)",
+      "Bash(gh issue create:*)",
+      "Bash(npx tsx:*)",
+      "Bash(timeout 30 npx tsx:*)",
+      "Bash(git push origin feature/ask-user-question)",
+      "Bash(node:*)",
+      "Bash(npm version:*)",
+      "Bash(git push:*)",
+      "Bash(npm publish:*)",
+      "Bash(pkill:*)",
+      "Bash(git -C /Users/verypro/optima-agent log --oneline --all -- \".claude/\")",
+      "Bash(wc:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
+      "Bash(commerce collection --help:*)",
+      "Bash(commerce collection update --help:*)",
+      "Bash(commerce collection set-cover:*)",
+      "Bash(commerce collection get --help:*)",
+      "Bash(commerce collection list --help:*)",
+      "Bash(commerce collection create --help:*)",
+      "Bash(commerce collection remove-products:*)",
+      "Bash(commerce collection list-products:*)",
+      "Bash(commerce --version:*)",
+      "Bash(bi-cli --version:*)",
+      "Bash(commerce homepage create --help:*)",
+      "Bash(commerce homepage reorder --help:*)",
+      "Bash(commerce homepage delete --help:*)",
+      "Bash(commerce homepage update-images:*)",
+      "Bash(commerce homepage update-collections:*)",
+      "Bash(commerce homepage update-target:*)",
+      "Bash(commerce homepage switch-template:*)",
+      "Bash(commerce inventory:*)",
+      "Bash(commerce merchant:*)",
+      "Bash(commerce review:*)",
+      "Bash(commerce product-page:*)",
+      "Bash(bi-cli:*)",
+      "Bash(comfy:*)",
+      "Bash(scout search:*)",
+      "Bash(scout product:*)",
+      "Bash(commerce homepage create-collections:*)",
+      "Bash(commerce homepage create-featured:*)",
+      "Bash(commerce homepage create-collection-products:*)",
+      "Bash(commerce homepage create-banner:*)",
+      "Bash(xargs -I {} sh -c 'echo \"\"\"\"=== {} ===\"\"\"\"; head -3 /Users/verypro/optima-agent/.claude/skills/{}/SKILL.md | grep \"\"\"\"name:\"\"\"\"')",
+      "Bash(ls:*)",
+      "Bash(gh issue view:*)",
+      "Bash(npx markdownlint-cli:*)",
+      "Bash(chmod:*)",
+      "Bash(npm whoami:*)",
+      "Bash(tsx test-scripts/test-headless-progress.ts:*)",
+      "Bash(DEBUG_STREAM=1 node dist/bin/optima.js:*)",
+      "Bash(git describe:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(./scripts/test-headless.sh:*)",
+      "Bash(./scripts/test-headless-simple.sh:*)",
+      "Bash(env)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)",
+      "Bash(optima --version:*)",
+      "Bash(optima agent headless:*)",
+      "Bash(optima headless:*)",
+      "Bash(/Users/verypro/optima-agent/scripts/test-headless.sh:*)",
+      "Bash(/Users/verypro/optima-agent/scripts/test-headless-simple.sh:*)",
+      "Bash(tee:*)",
+      "Bash(CONV_ID=\"conv-1\":*)",
+      "Bash(echo:*)",
+      "Bash(scout tiktok trending --help:*)",
+      "Bash(scout tiktok trending:*)",
+      "Bash(git checkout:*)",
+      "Bash(npm test:*)",
+      "Bash(git tag:*)",
+      "Bash(/private/tmp/claude/-Users-verypro-optima-agent/68a9ac2c-def2-44e1-b42b-e53bd9022ab6/scratchpad/test-canUseTool.sh)",
+      "Bash(optima --help:*)",
+      "Bash(npx @optima-chat/ads-cli:*)",
+      "Bash(head:*)",
+      "Bash(git pull:*)",
+      "Bash(pnpm build:*)",
+      "Skill(read-code)",
+      "Bash(npm run cli:*)",
+      "Bash(scout:*)",
+      "WebFetch(domain:docs.scrapecreators.com)",
+      "WebFetch(domain:scrapecreators.com)",
+      "Bash(gh auth status:*)",
+      "Bash(optima-agent:*)",
+      "Bash(python3:*)",
+      "Bash(python3 -c \" import sys content = sys.stdin.read\\(\\) # Find flushMessageQueueSync idx = content.find\\(''flushMessageQueueSync''\\) # Get context around it lines = content.split\\(''\\\\n''\\) for i, line in enumerate\\(lines\\): if ''flushMessageQueueSync'' in line and ''private'' in line: for j in range\\(i, min\\(i+20, len\\(lines\\)\\)\\): print\\(f''{j+1}: {lines[j]}''\\) break \")",
+      "Bash(optima:*)",
+      "WebFetch(domain:www.npmjs.com)",
+      "WebFetch(domain:registry.npmjs.org)",
+      "WebFetch(domain:zod.dev)",
+      "Bash(npm ls:*)",
+      "Bash(NODE_DEBUG=child_process npx tsx:*)",
+      "Bash(DEBUG_CLAUDE_AGENT_SDK=1 npx tsx:*)",
+      "Bash(CLAUDECODE= npx tsx:*)",
+      "Bash(env:*)",
+      "Bash(gh release:*)",
+      "Bash(npm info:*)",
+      "Bash(gh run:*)",
+      "Bash(gtimeout 90:*)",
+      "Bash(sentinel:*)",
+      "Bash(gh pr:*)",
+      "Bash(git fetch:*)",
+      "Bash(git log:*)",
+      "Bash(npm bin:*)",
+      "Bash(git status:*)",
+      "Bash(browser-cli --version && browser-cli --help)",
+      "Bash(browser-cli status:*)",
+      "Bash(browser-cli launch:*)",
+      "Bash(browser-cli screenshot:*)",
+      "Bash(browser-cli --version)",
+      "Bash(browser-cli close:*)",
+      "Bash(npm update:*)",
+      "Bash(node -e \"console.log\\(require\\('./node_modules/@optima-chat/browser-cli/package.json'\\).version\\)\")",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(aws ecs:*)",
+      "Bash(aws ecr:*)",
+      "Bash(gh search:*)",
+      "Bash(npx tsc:*)",
+      "Bash(find /Users/verypro/optima-agent -path */node_modules -prune -o -type f \\\\\\(-name *comfy* -o -name *gen* \\\\\\) -print)",
+      "Bash(export PATH=\"/usr/local/bin:$PATH\")",
+      "Bash(pnpm add:*)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/max-rounds-hit)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/budget-almost-spent)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/two-active-campaigns)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/brand-only)",
+      "Bash(pnpm vitest:*)",
+      "Bash(pnpm test:*)",
+      "Bash(pnpm --filter @optima-scout/backend test --reporter=verbose backend/src/routes/outreach/__tests__/lock.test.ts backend/src/routes/outreach/__tests__/inbound.test.ts)",
+      "Bash(npx vitest:*)",
+      "Bash(DATABASE_URL=postgres://optima_scout:optima_scout_dev@localhost:7293/optima_scout pnpm --filter @optima-scout/backend test)",
+      "Bash(pnpm --filter @optima-scout/backend exec vitest run src/routes/outreach/__tests__/inbound.test.ts)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.claude/skills/.kb-skills-managed.json

@@ -0,0 +1,9 @@
+{
+  "skills": [
+    "ingesting-sources",
+    "initializing-kb",
+    "linting-the-wiki",
+    "querying-the-wiki",
+    "updating-related-pages"
+  ]
+}

package/.claude/skills/ingesting-sources/SKILL.md

@@ -0,0 +1,67 @@
+---
+name: ingesting-sources
+description: "将新素材收录到知识库。当用户说'收录这篇文章'、'把这个加到知识库'时使用。"
+---
+
+# Ingesting Sources
+
+把原始材料做第一次落库，进入持续维护的 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 的契约
+
+## Ingest 流程
+
+1. 在 `~/kb/<slug>/raw/` 中定位来源文件
+2. 仔细阅读来源，提取主要论点、证据、实体和开放问题
+3. 在 `~/kb/<slug>/wiki/sources/` 中创建或更新对应页面
+4. 列出哪些 entity、overview 和 analysis 页面受到影响
+5. 如果任务范围包含来源页之外的更新，交给 updating-related-pages 处理，或执行一次有边界的相关页更新
+6. 如果这个来源是首次进入 wiki，更新 `~/kb/<slug>/index.md` 和 `~/kb/<slug>/log.md`
+7. 追加 `~/kb/PROGRESS.md`
+8. `cd ~/kb && git add -A && git commit -m "[<slug>] ingest: <来源名>"`
+
+## 来源页内容
+
+来源页应至少包含：
+
+- 来源标题
+- 简短摘要
+- 关键论点
+- 关键证据或观察
+- 相关实体、主题或概念
+- 对既有理解产生的冲突、修正或压力
+- 指向受影响页面的链接
+
+## 抽取规则
+
+- 将来源明确表达的内容与综合推断区分开
+- 不要把大段原文直接复制进 wiki
+- 优先写成简洁、可链接、之后可更新的陈述
+- 当来源含混或不完整时，显式记录不确定性
+- 遇到冲突要记录，不要静默抹平
+
+## 何时创建相关页面
+
+出现下列情况时应建议新建页面：
+
+- 某个人、组织、产品或概念很重要，但还没有稳定页面
+- 来源引入了一个新的 recurring topic
+- 来源实质性改变了某个既有 overview
+- 形成的综合结果已经明显值得进入 `wiki/analyses/`
+
+## 最小交付标准
+
+一次成功的 ingest 至少应留下：
+
+- 一页可用的 `wiki/sources/` 页面
+- 一份清晰的受影响页面列表
+- 足够明确的结构，使下一步 update 很自然

package/.claude/skills/initializing-kb/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: initializing-kb
+description: "创建新知识库或初始化 ~/kb/ 工作空间。当用户说'建个知识库'、'我想整理XX的知识'时使用。"
+---
+
+# Initializing KB
+
+创建一个基于 Markdown 的知识库。主要产物是 `~/kb/<slug>/` 目录和其中的 `AGENTS.md`。
+
+## 核心：~/kb/ 工作目录
+
+所有知识库都在 `~/kb/` 下，每个知识库一个子目录。
+
+```text
+~/kb/
+├── REGISTRY.md
+├── PROGRESS.md
+├── <slug>/
+│   ├── AGENTS.md
+│   ├── index.md
+│   ├── log.md
+│   ├── raw/
+│   └── wiki/
+│       ├── overview/
+│       ├── entities/
+│       ├── sources/
+│       └── analyses/
+└── .git/
+```
+
+## 启动 SOP
+
+1. `ls ~/kb/REGISTRY.md`
+   - 不存在 → 初始化根目录（见下方"首次初始化"）
+   - 存在 → 读 `REGISTRY.md`，了解已有的知识库
+2. 询问用户要创建什么主题的知识库
+
+## 首次初始化
+
+如果 `~/kb/` 不存在：
+
+1. `mkdir -p ~/kb`
+2. 创建 `~/kb/REGISTRY.md`：
+
+   ```markdown
+   # 知识库注册表
+
+   | slug | 主题 | 状态 | 创建日期 | 说明 |
+   |------|------|------|----------|------|
+   ```
+
+3. 创建 `~/kb/PROGRESS.md`：
+
+   ```markdown
+   # 知识库工作日志
+   ```
+
+4. `cd ~/kb && git init && git add -A && git commit -m "init kb workspace"`
+
+## 创建知识库
+
+1. 询问用户知识库主题
+2. 从主题生成 kebab-case slug 建议（不带 `-kb` 后缀）
+3. 校验 slug：
+   - 匹配 `^[a-z0-9][a-z0-9-]{0,29}$`
+   - 不与 `REGISTRY.md` 已有 slug 重复
+   - 让用户确认或修改
+4. `mkdir -p ~/kb/<slug>`
+5. 检查当前素材（如果用户指定了已有目录或文件）
+6. 确定所需的最小页面类型集合
+7. 创建 `AGENTS.md`（见下方"AGENTS.md 内容"）
+8. 创建 `index.md`、`log.md`、`raw/`、`wiki/overview/`、`wiki/entities/`、`wiki/sources/`、`wiki/analyses/`
+9. 追加 `~/kb/REGISTRY.md` 新行
+10. `cd ~/kb && git add -A && git commit -m "[<slug>] init: <主题>"`
+
+## AGENTS.md 内容
+
+至少应包含：
+
+- 仓库目标
+- `raw/` 的 source-of-truth 规则
+- 页面类型及其职责
+- ingest 工作流
+- query 工作流
+- lint 工作流
+- 编辑规则
+- 命名约定
+- 何时应新建页面，而不是继续扩写旧页
+- agent 修改后的输出要求
+
+## 页面模型
+
+默认页面职责：
+
+- `wiki/sources/`：每个来源一页
+- `wiki/entities/`：每个跨多个来源反复出现的稳定实体或概念一页
+- `wiki/overview/`：每个主题或认知领域一页
+- `wiki/analyses/`：长期有效的答案、比较、综合或决策记录
+
+避免混淆这些角色。
+
+## 命名规则
+
+- 来源页：`YYYY-MM-DD-short-source-name.md`
+- 分析页：`YYYY-MM-DD-short-analysis-name.md`
+- 实体页：`kebab-case-entity-name.md`
+- 综述页：`kebab-case-topic-name.md`
+
+## 好的结果
+
+一个好的 schema 应该让这些决策变得容易：
+
+- 新来源应该落到哪里
+- 一个概念什么时候值得拥有独立实体页
+- 一个高价值答案应该写回哪里
+- 冲突信息应如何呈现
+- 之后如何再次找到这些页面