@kunlv/atdc 1.0.0

package/reference/memory.md

@@ -0,0 +1,190 @@
+# reference/memory · 跨 session 记忆协议
+
+---
+
+## 渐进式披露（核心原则）
+
+> 借鉴 claude-mem 的 Progressive Disclosure：索引先行，按需拉取详情。
+
+**读策略**：
+1. **Session 启动** → 仅注入索引（~400 token），展示日期 + 类型图标 + change 名称
+2. **按需拉取** → agent 看到相关标题后用 Read 工具读取具体条目（~100-200 token/条）
+3. **优先拉取** → 🔴 bugfix / ⚠️ gotcha / 🟤 decision / ⚖️ tradeoff（高信号类型）
+4. **跳过无关** → 与当前任务无关的条目留在文件中，不进入 context
+
+**vs 旧方案**：cat 全量 .memory.md（~2000+ token）→ grep 索引（~400 token），token 效率提升 5x+。
+
+---
+
+## 记忆文件位置
+
+```
+~/.atd-code/memory/<项目目录名>/
+├── .memory.md          ← 决策日志（最近 20 条）
+├── .memory-archive.md  ← 超出 20 条后的归档
+└── .errors-log.md      ← 失败知识库
+
+<项目根目录>/
+├── STRATEGY.md         ← 产品策略锚点（/atd strategy 维护）
+├── CONCEPTS.md         ← 领域词汇表（/atd compound concepts 维护）
+└── docs/solutions/     ← 结构化知识沉淀（YAML frontmatter 可搜索）
+    └── <topic>.md      ← 每个已解决的复杂问题一个文件
+```
+
+项目目录名 = `basename` of 主 worktree 路径（worktree 场景下与 `basename $PWD` 不同）
+
+---
+
+## 类型图标对照
+
+| 图标 | 类型 | 说明 | 拉取优先级 |
+|--------|------|------|-------------|
+| 🔴 | bugfix | 修 bug / 修复问题 | 🔥 高 |
+| ⚠️ | gotcha | 发现坑 / 边界场景 | 🔥 高 |
+| 🟤 | decision | 架构决策（默认类型） | 🔥 高 |
+| ⚖️ | tradeoff | 明确取舍 / 方案对比 | 🔥 高 |
+| 🟢 | feature | 新功能 | 中 |
+| 🟡 | refactor | 重构 | 中 |
+| 🟣 | discovery | 发现 / 学习 / 洞察 | 中 |
+| 🧠 | learned-skill | auto-harvested golden path（self-learning 自动沉淀） | 🔥 高 |
+
+---
+
+## 何时写入
+
+- **归档完成后立即写**（不等 session 结束）
+- Session 结束前兜底检查，有未记录内容则补写
+
+**格式（caveman 压缩，控制 5-8 行）**：
+
+```markdown
+## 🟤 [YYYY-MM-DD] <change-name>  | ~150t
+done: <一句话描述完成的内容>
+decided: <核心技术决策，关键词即可>
+rejected: <排除的方案及原因，无则删此行>
+open: <未解决假设，无则删此行>
+
+### 🧠 learned-skill 格式
+
+```markdown
+## 🧠 [YYYY-MM-DD] <skill-name>  | ~150t
+done: <一句话描述学到的流程>
+decided: <核心操作步骤，关键词>
+failure: <这个 skill 避免的失败模式>
+dead-end: <被排除的死路>
+```
+```
+
+**规则**：
+- Header 前缀 emoji 从类型对照表选择，默认 🟤 decision
+- `~150t` 为 token 估算（~100-200，按内容行数估算）
+- `rejected:` 和 `open:` 如无内容则删除整行，不留空行
+- 总行数 5-8 行（含 header）
+- `next:` 字段不再使用（由索引 + Read 按需拉取替代）
+
+---
+
+## 何时读取
+
+- **GO.md Step 0a**：注入索引（grep headers），不读全量
+- **1-spec.md**：提案前扫索引，相关条目用 Read 拉取详情
+- **按需**：执行中遇到相关问题时，Read 拉取具体条目
+
+---
+
+## 索引生成命令
+
+session 启动时执行：
+
+```bash
+_PROJ=$(basename "$(git worktree list 2>/dev/null | head -1 | awk '{print $1}')" 2>/dev/null || basename "$PWD")
+MEMFILE="$HOME/.atd-code/memory/$_PROJ/.memory.md"
+
+if [ -f "$MEMFILE" ]; then
+  COUNT=$(grep -c "^## " "$MEMFILE" 2>/dev/null || echo 0)
+  echo "## 📋 项目记忆索引（共 $COUNT 条，显示最近 20）"
+  echo ""
+  grep "^## " "$MEMFILE" | tail -20 | awk '{
+    icon = substr($0, 4, 3)
+    rest = substr($0, 7)
+    printf "| %s | %s\n", icon, rest
+  }'
+  echo ""
+  echo "💡 渐进式披露：用 Read 工具读取具体条目（~100-200 token/条）。"
+  echo "   优先拉取：🔴 bugfix  ⚠️ gotcha  🟤 decision  ⚖️ tradeoff"
+else
+  echo "[无历史记忆]"
+fi
+```
+
+输出示例：
+```
+## 📋 项目记忆索引（共 9 条，显示最近 9）
+
+| 🟤 | [2026-06-01] perf-list-singleflight  | ~150t
+| 🟢 | [2026-06-01] kugou-embedded-h5  | ~120t
+| 🔴 | [2026-06-01] fixQYinMsgNotSend + subscribe-appid-aware-push-schema  | ~160t
+| 🟡 | [2026-06-09] simplify-ad-auto  | ~130t
+
+💡 渐进式披露：用 Read 工具读取具体条目（~100-200 token/条）。
+   优先拉取：🔴 bugfix  ⚠️ gotcha  🟤 decision  ⚖️ tradeoff
+```
+
+---
+
+## 自动裁剪
+
+`.memory.md` 保留最近 **20 条**（以 `## ` 计数）。
+
+超出时将最旧的条目移到 `.memory-archive.md`。
+
+---
+
+## 失败知识库（.errors-log.md）
+
+超过 2 次尝试才解决的问题，必须记录：
+
+```markdown
+## [YYYY-MM-DD] <change-name> / Task N
+
+- **失败路径**: <尝试了什么，为什么不 work>
+- **成功路径**: <最终怎么解决>
+- **教训**: <一句话总结>
+```
+
+新 change propose 时扫描相关历史，主动规避。
+
+---
+
+## 知识沉淀目录（docs/solutions/）
+
+结构化的问题→解决方案文档，由 `/atd compound` 生成和维护。
+
+**何时写入**：
+- 归档后用户运行 `/atd compound` 时
+- Session 中遇到复杂问题时（超过 2 次尝试）
+
+**文档结构**：参考 `@atd-code/templates/solution.md`
+- YAML frontmatter（title, date, tags, difficulty, module）用于搜索
+- 每个文档 20-40 行，不展开代码细节
+
+**何时读取**：
+- 1-spec 提案前：扫描 `docs/solutions/` 中与当前需求相关的历史解决方案
+- 3-impl 执行时：遇到类似问题先查沉淀知识
+
+**CONCEPTS.md**：
+- 领域词汇表，记录项目的业务术语和命名约定
+- 首次 `/atd context` 扫描时可生成，`/atd compound concepts` 可更新
+- 不记录通用技术术语，只记录业务特有概念
+
+---
+
+## 3 层记忆体系（职责区分）
+
+| 层 | 位置 | 作用 | 谁写 | 谁读 |
+|----|------|------|------|------|
+| **OpenCode session** | `.opencode/memory-context.md` | 当前项目 session 历史（OpenCode 原生格式） | OpenCode 自动 | GO.md Step 0a |
+| **跨 Agent 记忆** | `~/.atd-code/memory/<项目>/` | 所有项目、所有 AI agent 共享的决策日志 | atd 工作流（5-done、compound） | GO.md Step 0a 索引 |
+| **Self-learning** | `.memory.md`（🧠 条目）+ `.errors-log.md` | 自动检测 golden path 并沉淀为可复用 skill | self-learning detection（GO.md Step 0d） | X-learn.md、X-compound.md |
+
+3 层互补，不重叠：session 记忆管"上次讨论到哪"，跨 Agent 记忆管"决定了什么/排除了什么"，Self-learning 管"学到了什么可复用的流程"。

package/reference/risk.md

@@ -0,0 +1,74 @@
+# reference/risk · 风险评分算法
+
+> 供 4-verify、X-review、1-spec Phase 3 共同使用的风险评估标准。
+
+---
+
+## 评分维度
+
+每个变更（或 change）从 4 个维度打分，每维 1-3 分，总分 4-12 分。
+
+### 1. 影响广度（Blast Radius Breadth）
+
+用 `codegraph_impact` 的结果判断：
+
+| 分数 | 条件 |
+|------|------|
+| 1 分（低） | blast radius 内 ≤3 个调用方 |
+| 2 分（中） | 4-10 个调用方 |
+| 3 分（高） | >10 个调用方，或影响核心公共接口 |
+
+### 2. 跨模块程度（Cross-Module Impact）
+
+检查受影响的目录/包是否跨越多个业务模块：
+
+| 分数 | 条件 |
+|------|------|
+| 1 分（低） | 变更局限于单一模块/目录内 |
+| 2 分（中） | 涉及 2 个模块（如 service + handler） |
+| 3 分（高） | 涉及 ≥3 个模块，或跨越边界层（如 DB + API + Cache） |
+
+### 3. 测试覆盖（Test Coverage）
+
+用 `codegraph_callers` 查找变更函数的测试调用方：
+
+| 分数 | 条件 |
+|------|------|
+| 1 分（低） | 所有变更函数都有对应的测试调用方 |
+| 2 分（中） | 部分变更函数有测试，部分没有 |
+| 3 分（高） | 多数变更函数无测试覆盖 |
+
+### 4. 变更类型（Change Type）
+
+基于 `git diff` 的变更性质判断：
+
+| 分数 | 条件 |
+|------|------|
+| 1 分（低） | 新增代码、修改日志/配置/注释、纯工具函数 |
+| 2 分（中） | 修改业务逻辑、重构内部实现 |
+| 3 分（高） | 修改公共函数签名、删除代码/接口、修改数据结构 |
+
+---
+
+## 风险等级
+
+| 总分 | 等级 | 标记 | 验证要求 |
+|------|------|------|---------|
+| 4-6 | 低风险 | 🟢 | 增量验证：只跑变更相关的测试 |
+| 7-9 | 中风险 | 🟡 | 标准验证：跑变更模块的全量测试 |
+| 10-12 | 高风险 | 🔴 | 全量验证：全量测试 + 人工确认 + 受影响流程 E2E 验证 |
+
+---
+
+## 快速评估（1-spec Phase 3 使用）
+
+propose 阶段无法运行实际代码，使用简化的预估规则：
+
+| 维度 | 预估方式 |
+|------|---------|
+| 影响广度 | 根据 design.md 中"涉及文件"列表的调用方数量估算 |
+| 跨模块 | 根据"涉及模块"数量直接判断 |
+| 测试覆盖 | 根据 tasks.md 是否有明确的测试任务判断 |
+| 变更类型 | 根据 proposal.md 的"实施范围"判断 |
+
+预估分数用于复杂度评估，不影响最终的风险评分（4-verify 阶段用实际 codegraph 结果重新计算）。

package/reference/tdd.md

@@ -0,0 +1,40 @@
+# reference/tdd · TDD 约束
+
+---
+
+## 完整循环（缺任何一步 = 任务未完成）
+
+```
+RED    → 写测试，确认测试失败（编译错误或运行失败均可）
+GREEN  → 写最简实现，测试通过
+REFACTOR → 清理代码，测试仍通过
+```
+
+---
+
+## 测试文件要求
+
+1. 测试文件与实现文件同目录（Go: `xxx_test.go`，TS: `xxx.test.ts`）
+2. 每个测试函数必须有意图注释：
+   ```go
+   // Intent: 验证批量退款在部分票已退的情况下，不会重复扣减库存
+   func TestBatchRefund_PartialAlreadyRefunded(t *testing.T) { ... }
+   ```
+3. Intent 说明"为什么这个行为重要"，不是"它做了什么"
+
+---
+
+## 覆盖维度
+
+每个业务功能至少覆盖：
+- Happy path（正常流程）
+- Sad path（错误/失败场景）
+- 边界（空值、超限、并发）
+
+---
+
+## 禁止事项
+
+- 不得在测试通过前提交实现
+- 不得写"占位"测试（空函数体或 `t.Skip()`）
+- 不得修改测试以适应错误实现（应修改实现）

package/scripts/svg2png.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+const puppeteer = require('puppeteer');
+const fs = require('fs');
+const path = require('path');
+
+(async () => {
+  const dir = process.argv[2] || '.';
+  const svgFiles = fs.readdirSync(dir).filter(f => f.endsWith('.svg'));
+
+  const browser = await puppeteer.launch({
+    headless: 'new',
+    args: ['--no-sandbox', '--disable-setuid-sandbox']
+  });
+
+  for (const file of svgFiles) {
+    const svgPath = path.resolve(dir, file);
+    const pngPath = svgPath.replace(/\.svg$/, '.png');
+    const svgContent = fs.readFileSync(svgPath, 'utf-8');
+
+    const vbMatch = svgContent.match(/viewBox="[^"]*\s(\d+)\s(\d+)"/);
+    let width = vbMatch ? parseInt(vbMatch[1]) : 1200;
+    let height = vbMatch ? parseInt(vbMatch[2]) : 800;
+
+    const scale = 2;
+    const page = await browser.newPage();
+    await page.setViewport({ width, height, deviceScaleFactor: scale });
+
+    const html = `<!DOCTYPE html>
+<html><head><meta charset="utf-8"><style>
+  body { margin: 0; padding: 0; background: transparent; }
+  img { display: block; }
+</style></head>
+<body>
+  <img src="data:image/svg+xml;base64,${Buffer.from(svgContent).toString('base64')}" width="${width}" height="${height}" />
+</body></html>`;
+
+    await page.setContent(html, { waitUntil: 'networkidle0' });
+    await page.screenshot({ path: pngPath, type: 'png', omitBackground: true });
+    await page.close();
+
+    console.log(`Done: ${path.basename(file)} → ${path.basename(pngPath)} (${width}×${height} @${scale}x)`);
+  }
+
+  await browser.close();
+  console.log('All done.');
+})();

package/src/cls/client.js

@@ -0,0 +1,244 @@
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+const os = require('os');
+const { execSync, exec } = require('child_process');
+
+const CONFIG_DIR = path.join(os.homedir(), '.cls');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const DEFAULT_TEMPLATE = path.join(__dirname, '..', '..', 'config', 'cls-defaults.json');
+
+function _defaults() {
+  return {
+    skill_dir: '',
+    python: 'python3',
+    accounts: {},
+    defaults: { limit: 200, out_dir: '.', topic_type: 'error', regions: 'gz,bj', time_range: '15m' },
+    output: { format: 'jsonl', filename: '{account}_{query}_{ts}-{suffix}.jsonl' },
+  };
+}
+
+function initConfig() {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  if (fs.existsSync(CONFIG_FILE)) {
+    return { ok: false, msg: `配置文件已存在: ${CONFIG_FILE}`, path: CONFIG_FILE };
+  }
+  if (!fs.existsSync(DEFAULT_TEMPLATE)) {
+    return { ok: false, msg: `模板文件不存在: ${DEFAULT_TEMPLATE}` };
+  }
+  const template = fs.readFileSync(DEFAULT_TEMPLATE, 'utf8');
+  fs.writeFileSync(CONFIG_FILE, template);
+  return { ok: true, msg: `配置文件已生成: ${CONFIG_FILE}，请编辑 skill_dir 和 accounts`, path: CONFIG_FILE };
+}
+
+function loadConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) {
+    throw new Error(`配置文件 ${CONFIG_FILE} 不存在。请运行: cls --init`);
+  }
+  const raw = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+  return { ..._defaults(), ...raw, defaults: { ..._defaults().defaults, ...(raw.defaults || {}) }, output: { ..._defaults().output, ...(raw.output || {}) } };
+}
+
+function resolveAccount(config, alias) {
+  const entry = config.accounts[alias];
+  if (!entry) {
+    const available = Object.keys(config.accounts).join(', ');
+    throw new Error(`账号 "${alias}" 未在配置中找到。可用: ${available}`);
+  }
+  if (typeof entry === 'string') return { account: entry, project_id: null };
+  return { account: entry.account || alias, project_id: entry.project_id || null };
+}
+
+function detectPython(cmd) {
+  try {
+    execSync(`which "${cmd}" 2>/dev/null || command -v "${cmd}"`, { encoding: 'utf8' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function _relativeTime(range) {
+  const m = range.match(/^(\d+)(m|h|d|s)$/);
+  if (!m) throw new Error(`无效的时间范围: ${range}（支持 15m/1h/2d）`);
+  const val = parseInt(m[1]);
+  const unit = m[2];
+  const ms = val * { s: 1000, m: 60000, h: 3600000, d: 86400000 }[unit];
+  return new Date(Date.now() - ms).toISOString().replace('T', ' ').slice(0, 19);
+}
+
+function _now() {
+  return new Date().toISOString().replace('T', ' ').slice(0, 19);
+}
+
+function _safeQuery(query) {
+  return (query || 'log')
+    .replace(/[^a-zA-Z0-9\u4e00-\u9fff]+/g, '_')
+    .replace(/_+/g, '_')
+    .replace(/^_|_$/g, '')
+    .slice(0, 30);
+}
+
+function buildOutputPath(account, query, outDir) {
+  const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 15);
+  const suffix = crypto.randomBytes(2).toString('hex');
+  const safeQ = _safeQuery(query);
+  const ext = 'jsonl';
+  const name = `${account}_${safeQ}_${ts}-${suffix}.${ext}`;
+  const dir = (outDir || '.').replace(/^~/, os.homedir());
+  fs.mkdirSync(dir, { recursive: true });
+  return path.join(dir, name);
+}
+
+function buildSearchArgs(config, account, query, opts = {}) {
+  const resolved = resolveAccount(config, account);
+  const script = path.join(config.skill_dir, 'scripts', 'cls_query_python.py');
+  const outputPath = buildOutputPath(account, query, opts.out_dir || config.defaults.out_dir);
+  const limit = opts.limit || config.defaults.limit;
+  const from = opts.from || _relativeTime(config.defaults.time_range);
+  const to = opts.to || _now();
+  const topicType = opts.type || config.defaults.topic_type;
+  const regions = opts.regions || config.defaults.regions;
+
+  const args = [
+    config.python,
+    script,
+    '--account', resolved.account,
+    '--query', query,
+    '--limit', String(limit),
+    '--from', from,
+    '--to', to,
+    '--topic-type', topicType,
+    '--regions', regions,
+    '--output', outputPath,
+    '--pretty',
+  ];
+
+  if (resolved.project_id) {
+    args.splice(4, 0, '--project-id', resolved.project_id);
+  }
+
+  return { args, outputPath };
+}
+
+function buildFetchArgs(config, account, query, opts = {}) {
+  const resolved = resolveAccount(config, account);
+  const script = path.join(config.skill_dir, 'scripts', 'cls_fetch_bulk.py');
+  const outputPath = buildOutputPath(account, query, opts.out_dir || config.defaults.out_dir);
+  const from = opts.from || _relativeTime(config.defaults.time_range);
+  const to = opts.to || _now();
+  const max = opts.max || 5000;
+
+  const args = [
+    config.python,
+    script,
+    '--account', resolved.account,
+    '--query', query,
+    '--from', from,
+    '--to', to,
+    '--max', String(max),
+    '--out', outputPath,
+    '--content-only',
+  ];
+
+  if (resolved.project_id) {
+    args.splice(4, 0, '--project-id', resolved.project_id);
+  }
+
+  return { args, outputPath };
+}
+
+function listAccounts() {
+  const config = loadConfig();
+  const result = {};
+  for (const [alias, entry] of Object.entries(config.accounts)) {
+    if (typeof entry === 'string') {
+      result[alias] = entry;
+    } else {
+      result[alias] = `${entry.account} → project ${entry.project_id}`;
+    }
+  }
+  return result;
+}
+
+function searchSync(account, query, opts = {}) {
+  const config = loadConfig();
+  if (!detectPython(config.python)) throw new Error(`Python 解释器 "${config.python}" 未找到。请检查 ~/.cls/config.json 中 python 字段`);
+
+  const { args, outputPath } = buildSearchArgs(config, account, query, opts);
+  const cmd = args.map(a => a.includes(' ') ? `"${a}"` : a).join(' ');
+
+  if (!opts.quiet) console.error(`→ ${cmd}`);
+
+  execSync(cmd, { encoding: 'utf8', maxBuffer: 50 * 1024 * 1024, timeout: (opts.timeout || 60) * 1000 });
+  const raw = fs.readFileSync(outputPath, 'utf8');
+  const data = JSON.parse(raw);
+  const count = data?.Response?.Results?.length || data?.summary?.returned_count || 0;
+
+  return { output_file: outputPath, count, sample: (data?.Response?.Results || []).slice(0, 3) };
+}
+
+function searchAsync(account, query, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const config = loadConfig();
+    if (!detectPython(config.python)) return reject(new Error(`Python "${config.python}" 未找到`));
+
+    const { args, outputPath } = buildSearchArgs(config, account, query, opts);
+    const cmd = args.map(a => a.includes(' ') ? `"${a}"` : a).join(' ');
+
+    exec(cmd, { encoding: 'utf8', maxBuffer: 50 * 1024 * 1024, timeout: (opts.timeout || 60) * 1000 }, (err, stdout, stderr) => {
+      if (err) return reject(new Error(stderr || err.message));
+      try {
+        const raw = fs.readFileSync(outputPath, 'utf8');
+        const data = JSON.parse(raw);
+        const count = data?.Response?.Results?.length || data?.summary?.returned_count || 0;
+        resolve({ output_file: outputPath, count, sample: (data?.Response?.Results || []).slice(0, 3) });
+      } catch (e) {
+        reject(e);
+      }
+    });
+  });
+}
+
+function fetchSync(account, query, opts = {}) {
+  const config = loadConfig();
+  if (!detectPython(config.python)) throw new Error(`Python "${config.python}" 未找到`);
+
+  const { args, outputPath } = buildFetchArgs(config, account, query, opts);
+  const cmd = args.map(a => a.includes(' ') ? `"${a}"` : a).join(' ');
+
+  if (!opts.quiet) console.error(`→ ${cmd}`);
+
+  execSync(cmd, { encoding: 'utf8', maxBuffer: 200 * 1024 * 1024, timeout: (opts.timeout || 120) * 1000 });
+  const lines = fs.readFileSync(outputPath, 'utf8').split('\n').filter(Boolean);
+  return { output_file: outputPath, total: lines.length };
+}
+
+function fetchAsync(account, query, opts = {}) {
+  return new Promise((resolve, reject) => {
+    const config = loadConfig();
+    if (!detectPython(config.python)) return reject(new Error(`Python "${config.python}" 未找到`));
+
+    const { args, outputPath } = buildFetchArgs(config, account, query, opts);
+    const cmd = args.map(a => a.includes(' ') ? `"${a}"` : a).join(' ');
+
+    exec(cmd, { encoding: 'utf8', maxBuffer: 200 * 1024 * 1024, timeout: (opts.timeout || 120) * 1000 }, (err, stdout, stderr) => {
+      if (err) return reject(new Error(stderr || err.message));
+      const lines = fs.readFileSync(outputPath, 'utf8').split('\n').filter(Boolean);
+      resolve({ output_file: outputPath, total: lines.length });
+    });
+  });
+}
+
+module.exports = {
+  initConfig,
+  loadConfig,
+  detectPython,
+  resolveAccount,
+  listAccounts,
+  searchSync,
+  searchAsync,
+  fetchSync,
+  fetchAsync,
+  buildOutputPath,
+};

package/src/constants.js

@@ -0,0 +1,49 @@
+const os = require('os');
+const path = require('path');
+
+const HOME = os.homedir();
+
+const PACKAGE_DIR = (() => {
+  if (process.env.ATDC_DIR) return process.env.ATDC_DIR;
+  const idx = __dirname.lastIndexOf('/node_modules/atdc/');
+  if (idx !== -1) return path.resolve(__dirname.slice(0, idx), 'node_modules/atdc');
+  const srcIdx = __dirname.lastIndexOf('/src');
+  if (srcIdx !== -1) return __dirname.slice(0, srcIdx);
+  return __dirname;
+})();
+
+const TERMINAL_CONFIGS = {
+  claude: {
+    name: 'Claude Code',
+    dir: path.join(HOME, '.claude', 'commands'),
+    fileLink: { src: 'commands/claude/atd.md', dest: 'atd.md' },
+    dirLink: { src: 'commands/claude/atd', dest: 'atd' },
+    installedCheck: () => [path.join(HOME, '.claude')],
+  },
+  opencode: {
+    name: 'OpenCode',
+    dir: path.join(HOME, '.config', 'opencode', 'commands'),
+    fileLink: { src: 'commands/opencode/atd.md', dest: 'atd.md' },
+    dirLink: { src: 'commands/opencode/atd', dest: 'atd' },
+    installedCheck: () => [path.join(HOME, '.config', 'opencode')],
+  },
+  codex: {
+    name: 'Codex',
+    dir: path.join(HOME, '.agents', 'skills'),
+    isDirLinks: true,
+    linkMap: [
+      'atd', 'atd-1-spec', 'atd-1-update', 'atd-2-qa',
+      'atd-3-impl', 'atd-3-impl-skip-spec', 'atd-4-verify',
+      'atd-5-done', 'atd-add-to-hc', 'atd-article', 'atd-compound',
+      'atd-context', 'atd-diagnose', 'atd-git-guardrails',
+      'atd-grill-with-docs', 'atd-handoff', 'atd-health', 'atd-review',
+      'atd-strategy', 'atd-zoom-out',
+    ],
+    installedCheck: () => [path.join(HOME, '.agents')],
+  },
+};
+
+const MEMORY_DIR = path.join(HOME, '.atdc', 'memory');
+const PLACEHOLDER = '{{ATDC_DIR}}';
+
+module.exports = { HOME, PACKAGE_DIR, TERMINAL_CONFIGS, MEMORY_DIR, PLACEHOLDER };