@colin4k1024/tsp 2.4.5 → 2.4.6

package/README.md

@@ -2,7 +2,7 @@
 
 面向团队协作与平台治理的开源 Team Skills Platform，用于把单代理执行模式升级成“`Tech Lead` 编排 + 专业角色协作”的虚拟研发团队工作模型，并叠加 ECC 风格的 harness layer、specialist 命令与运行时增强能力。当前平台同时支持 `team mode` 与 `solo mode`，前者强调多人交接，后者强调单人闭环但保留同样的关键门禁。
 
-> English: Team Skills Platform (TSP) is an open-source framework for role-based AI delivery workflows. It packages role prompts, shared skills, commands, rules, hooks, examples, and install tooling for Claude Code, Codex, Cursor, and similar environments. Custom extensions can be layered on top via the overlay mechanism; the public repository ships only public capabilities.
+> English: Team Skills Platform (TSP) is an open-source framework for role-based AI delivery workflows. It packages role prompts, shared skills, commands, rules, hooks, examples, and install tooling for Claude Code, Codex, and OpenCode. Custom extensions can be layered on top via the overlay mechanism; the public repository ships only public capabilities.
 
 ## Quick Start / 最小安装
 
@@ -53,7 +53,7 @@ TSP 采用 **角色 + 技能 + Agent + 规则 + Hooks + Workflow 引擎** 六层
 | 命令面 | `commands/` | 80+ 命令（团队主链 8 个 + specialist + 工具链） |
 | Workflow 引擎 | `workflows/` + `scripts/workflow-*.js` | YAML DAG 工作流，支持依赖解析、状态持久化、失败恢复 |
 
-安装工具链支持 **10 个目标平台**：Claude、Cursor、Antigravity、Codex、Gemini、OpenCode、CodeBuddy、Copilot、Windsurf、Augment。
+安装工具链公开主线支持 **3 个 code agent**：Claude Code、Codex、OpenCode。其他历史 target 保留为隐藏兼容路径，不再作为公开 onboarding 主线。
 
 发布为 npm 包 `@colin4k1024/tsp`，内置 Rust bridge 预构建二进制，安装零依赖。
 
@@ -65,6 +65,7 @@ TSP 整合了多个社区开源框架的精华能力，而非从零构建：
 |------|------|--------------|
 | **ECC** (Everything Claude Code) | 社区 | 125+ specialist skills、27 specialist agents、language rules packs、runtime hooks、安装工具链 |
 | **BMAD** | 方法来源（已吸收） | 单入口主链（`/team-help`）、Requirement Challenge、Design Review、Implementation Readiness、Story Slice、`artifact:persist` 落盘、Release→Closeout 收口 |
+| **CodeGraph** | 社区（`colbymchenry/codegraph`） | 默认内置 MCP-backed 代码图谱能力（符号搜索、调用链、impact、focused context），以 npm 依赖 + target-scoped installer wrapper + 本地 skill 接入 |
 | **Graphify** | 社区（`safishamsi/graphify`） | 可选知识图谱能力（brownfield 结构扫描、依赖路径分析、架构问答证据），以 runbook + 本地 skill 接入，不替换 workflow-engine |
 | **GitNexus** | 社区（`abhigyanpatwari/GitNexus`） | 受控可选代码智能能力（MCP 查询、impact、detect_changes、多仓图谱证据），以 runbook + thin skill 接入，不内置依赖 |
 | **Open Design** | 社区（`nexu-io/open-design`） | 受控可选设计工作台能力（本地优先原型、deck、dashboard、mobile flow、`DESIGN.md`、导出 artifact），以 runbook + thin skill 接入，不内置 daemon |
@@ -208,6 +209,7 @@ TSP 的公开能力是在多个社区项目、技能仓库和工程方法论的
 | 仓库 | 在 TSP 中的关系 | 说明 |
 |------|------|------|
 | [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) | 上游能力来源 | ECC harness layer、specialist agents、skills、runtime hooks 与安装工具链的重要参考来源 |
+| [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph) | 默认内置接入 | 为 brownfield 符号搜索、调用链、impact 和 focused context 提供本地 MCP-backed 代码图谱能力；TSP 通过 target-scoped wrapper 调用上游 installer |
 | [safishamsi/graphify](https://github.com/safishamsi/graphify) | 已吸收并本地化 | 为 brownfield 结构扫描、依赖路径分析与架构问答补充知识图谱能力 |
 | [abhigyanpatwari/GitNexus](https://github.com/abhigyanpatwari/GitNexus) | 受控可选接入 | 为 brownfield MCP 查询、impact、detect_changes 和多仓代码图谱证据提供外部能力；因许可证与 Node 20 要求，不内置依赖 |
 | [nexu-io/open-design](https://github.com/nexu-io/open-design) | 受控可选接入 | 为本地优先原型、deck、dashboard、mobile flow、`DESIGN.md` 与可导出视觉 artifact 提供外部设计工作台；不内置 daemon 或上游源码 |
@@ -272,12 +274,12 @@ TSP 的公开能力是在多个社区项目、技能仓库和工程方法论的
 - 文档生命周期字段用于明确责任与新鲜度：`doc_tier`、`owner`、`updated`、`last_verified`、`source_of_truth`。
 - 历史资料通过 `doc_tier: historical` 分层，避免与现行操作手册并列误用。
 
-## 可选知识图谱能力（Graphify + GitNexus）
+## 代码图谱能力（CodeGraph + Graphify + GitNexus）
 
-- 定位：Graphify 作为轻量结构证据层，GitNexus 作为受控可选代码智能层；两者都不替代 workflow-engine 或 `/team-*` 主链。
-- 入口：Graphify 先执行 `npm run graphify:doctor`，GitNexus 先执行 `npm run gitnexus:doctor`；详细操作见 [graphify-knowledge-graph-usage.md](docs/runbooks/graphify-knowledge-graph-usage.md) 与 [gitnexus-code-intelligence-usage.md](docs/runbooks/gitnexus-code-intelligence-usage.md)。
-- 分发：通过安装模块 `knowledge-graph` 与组件 `capability:knowledge-graph` 提供；仅默认纳入 `research` 与 `full` profile。
-- 治理边界：不在本仓库执行 Graphify/GitNexus 的自动 setup 类命令；GitNexus 不进入 TSP 依赖，且索引时必须保护既有 AGENTS/CLAUDE 契约。
+- 定位：CodeGraph 作为默认内置 MCP-backed 代码图谱能力，Graphify 作为轻量结构证据层，GitNexus 作为受控可选深代码智能层；三者都不替代 workflow-engine 或 `/team-*` 主链。
+- 入口：CodeGraph 先执行 `npm run codegraph:doctor`，Graphify 先执行 `npm run graphify:doctor`，GitNexus 先执行 `npm run gitnexus:doctor`；详细操作见 [codegraph-code-intelligence-usage.md](docs/runbooks/codegraph-code-intelligence-usage.md)、[graphify-knowledge-graph-usage.md](docs/runbooks/graphify-knowledge-graph-usage.md) 与 [gitnexus-code-intelligence-usage.md](docs/runbooks/gitnexus-code-intelligence-usage.md)。
+- 分发：通过安装模块 `knowledge-graph` 与组件 `capability:knowledge-graph` 提供；默认纳入 `developer`、`team`、`research` 与 `full` profile，`core` 保持轻量。
+- 治理边界：TSP 只通过 `scripts/install-codegraph.js` 以当前 target 调用 CodeGraph installer，不使用 `--target=auto`，也不在安装时运行 `codegraph init -i`；Graphify/GitNexus 的自动 setup 类命令仍不在本仓库执行。
 
 ## 近期新增功能（v2.0.0 → v2.3.0）
 
@@ -597,9 +599,6 @@ CODEX_HOME_DIR=/tmp/codex AGENTS_HOME_DIR=/tmp/agents ./scripts/install-codex.sh
 # 安装到 Claude（可通过环境变量覆盖目标目录）
 CLAUDE_HOME_DIR=/tmp/claude ./scripts/install-claude.sh
 
-# 安装到 Cursor（可通过环境变量覆盖目标目录）
-CURSOR_HOME_DIR=/tmp/cursor ./scripts/install-cursor.sh
-
 # 安装到 OpenCode（可通过环境变量覆盖目标目录）
 OPENCODE_CONFIG_DIR=/tmp/opencode ./scripts/install-opencode.sh
 ```
@@ -608,20 +607,18 @@ OPENCODE_CONFIG_DIR=/tmp/opencode ./scripts/install-opencode.sh
 
 无需克隆仓库，直接通过 npx 一键安装到目标平台。npm 包已包含所有平台（macOS/Linux/Windows）的预编译二进制文件，无需 Rust 工具链，无需 GitHub 访问：
 
-- `tsp` 当前公开支持的 targets：`claude`、`cursor`、`antigravity`、`codex`、`gemini`、`opencode`、`codebuddy`、`copilot`、`windsurf`、`augment`
+- `tsp` 当前公开支持的 targets：`claude`（Claude Code）、`codex`、`opencode`；`claude-code` / `claudecode` 是 `claude` 的兼容别名
 - 当前公开支持的 profiles：`core`、`developer`、`security`、`research`、`team`、`full`
 - 自定义能力通过 overlay 机制扩展，不作为公开 `tsp` profile 暴露
 
-支持深度不是所有 target 都完全一致，当前建议按下面理解：
+公开支持深度按三类 code agent 收敛，当前建议按下面理解：
 
 | Support level | Targets | `team` profile depth | Notes |
 |------|---------|----------------------|-------|
-| Recommended | `claude`, `cursor` | 14 / 14 modules | 完整公开 workflow 链路、最强回归覆盖、文档最全 |
-| Strong | `codex`, `opencode` | 10 / 14, 11 / 14 modules | 核心命令和大部分 workflow 可用，但仍有少量 target-specific gap |
-| Partial | `antigravity`, `codebuddy` | 8 / 14, 11 / 14 modules | 安装适配器可用，但 workflow parity / shared-skills 覆盖不完整 |
-| Baseline | `gemini`, `copilot`, `windsurf`, `augment` | 1-2 / 14 modules | 仅提供基础兼容入口和平台配置，不承诺完整 `/team-*` 对齐 |
+| Recommended | `claude`, `codex`, `opencode` | 完整主链；仅跳过 target-intentional runtime gaps | 完整公开 workflow 链路、quick-start、安装验证与回归覆盖 |
+| Hidden compatibility | `cursor`, `antigravity`, `gemini`, `codebuddy`, `copilot`, `windsurf`, `augment` | 不作为公开承诺 | 适配器可继续存在以兼容旧用户，但不进入公开 wizard / release matrix |
 
-当前公开 quick-start / recipes / examples 主要覆盖 `claude`、`cursor`、`codex`、`opencode`。其他 targets 已进入公开 install surface，但应按上表理解为 partial 或 baseline 支持，而不是 full parity。
+当前公开 quick-start / recipes / examples 聚焦 `claude`、`codex`、`opencode`。其他 targets 属于隐藏兼容，不应按 full parity 预期使用。
 
 ```bash
 # 交互式向导（推荐首次使用）
@@ -629,7 +626,7 @@ npx @colin4k1024/tsp
 
 # 非交互式，直接指定目标和 profile
 npx @colin4k1024/tsp --target claude --profile full
-npx @colin4k1024/tsp --target cursor --profile team
+npx @colin4k1024/tsp --target claude-code --profile team
 npx @colin4k1024/tsp --target codex --profile full
 npx @colin4k1024/tsp --target opencode --profile full
 
@@ -652,7 +649,7 @@ npx @colin4k1024/tsp --from-source
 如果你是第一次使用这个平台，建议按下面的顺序进入：
 
 1. 运行 `node scripts/build-platform-artifacts.js` 生成最新产物。
-2. 根据使用端执行对应的安装脚本：`./scripts/install-claude.sh`、`./scripts/install-codex.sh`、`./scripts/install-cursor.sh` 或 `./scripts/install-opencode.sh`。
+2. 根据使用端执行对应的安装脚本：`./scripts/install-claude.sh`、`./scripts/install-codex.sh` 或 `./scripts/install-opencode.sh`。
 3. 打开你的项目仓库，在对话中先跑一次 `/team-help` 判断入口，再按建议进入 `/team-intake`、`/team-plan`、`/team-execute`、`/team-review`、`/team-release` 或 `/team-closeout`。
 4. specialist 命令只负责给出专项结论，最终决策回到 `/handoff` 或 `/team-*` 主链。
 
@@ -660,7 +657,6 @@ npx @colin4k1024/tsp --from-source
 
 - 第一次安装，准备在 Claude 中试跑：看 [docs/runbooks/claude-quick-start.md](docs/runbooks/claude-quick-start.md)
 - 第一次安装，准备在 Codex 中试跑：看 [docs/runbooks/codex-quick-start.md](docs/runbooks/codex-quick-start.md)
-- 想在 Cursor 中上手：看 [docs/runbooks/cursor-quick-start.md](docs/runbooks/cursor-quick-start.md)
 - 想在 OpenCode 中上手：看 [docs/runbooks/opencode-quick-start.md](docs/runbooks/opencode-quick-start.md)
 - 想按场景查 Claude 怎么用：看 [docs/runbooks/claude-usage-scenarios.md](docs/runbooks/claude-usage-scenarios.md)
 - 想按场景查 Codex 怎么用：看 [docs/runbooks/codex-usage-scenarios.md](docs/runbooks/codex-usage-scenarios.md)

package/bin/lib/install-surface.js

@@ -4,7 +4,7 @@ const path = require('path');
 
 const packageRoot = path.resolve(__dirname, '../..');
 const { listInstallProfiles } = require(path.join(packageRoot, 'scripts/lib/install-manifests'));
-const { listInstallTargetAdapters } = require(path.join(packageRoot, 'scripts/lib/install-targets/registry'));
+const { listPublicInstallTargetAdapters } = require(path.join(packageRoot, 'scripts/lib/install-targets/registry'));
 
 const TARGET_METADATA = Object.freeze({
   claude: {
@@ -34,7 +34,7 @@ const TARGET_METADATA = Object.freeze({
   },
   opencode: {
     label: 'OpenCode',
-    installPath: '~/.opencode/',
+    installPath: '~/.config/opencode/',
     scope: 'home-level',
   },
   codebuddy: {
@@ -92,7 +92,7 @@ function titleCase(value) {
 }
 
 function listPublicInstallTargets() {
-  return listInstallTargetAdapters().map((adapter) => {
+  return listPublicInstallTargetAdapters().map((adapter) => {
     const metadata = TARGET_METADATA[adapter.target] || {};
     return {
       id: adapter.target,

package/bin/lib/source-installer.js

@@ -14,7 +14,7 @@ const os = require('os');
 const ui = require('./ui');
 const { runPostInstallBridge } = require('./post-install-bridge');
 
-const DEFAULT_REPO_URL = 'https://github.com/Colin4k1024/harness-engineering.git';
+const DEFAULT_REPO_URL = 'https://github.com/Colin4k1024/tsp.git';
 const DEFAULT_CLONE_DIR = path.join(os.homedir(), '.tsp-source');
 
 function listMissingProductionDependencies(projectRoot) {
@@ -112,7 +112,7 @@ async function runSourceInstall(intent) {
     try {
       ui.info('Installing claude-mem plugin ...');
       execSync('npx --yes claude-mem install', { stdio: 'inherit' });
-    } catch (e) {
+    } catch (_e) {
       ui.warn('claude-mem install failed — run "npx claude-mem install" manually if needed.');
     }
   }

package/commands/team-help.md

@@ -34,8 +34,8 @@
 2. 默认以 `karpathy-guidelines` 的方式先暴露歧义、范围边界与更简单路径，不在入口阶段静默替用户补全高风险假设。
 3. 检查现有证据是否齐备：PRD、delivery-plan、arch-design、handoff、execute-log、test-plan、launch-acceptance、deployment-context、release-plan、closeout-summary，以及 `docs/memory/project-context.md`。
 4. 若任务边界清晰、影响面小、风险低，优先推荐 `/quick`；否则继续沿 `/team-*` 主链推进。
-5. 若是既有项目（brownfield）且现状上下文不足，优先建议执行 `/update-codemaps` 并启用 `doc-architecture`，需要轻量结构证据时选择 Graphify，需要跨模块影响面或 MCP 证据时选择 GitNexus，再把现有模块、集成点、关键数据流和历史包袱回落到 `delivery-plan.md` / `arch-design.md`。
+5. 若是既有项目（brownfield）且现状上下文不足，优先建议执行 `/update-codemaps` 并启用 `doc-architecture`；默认用 CodeGraph 做 MCP-backed 符号、调用链和影响面证据，需要轻量结构证据时选择 Graphify，需要跨模块或多仓影响面时选择 GitNexus，再把现有模块、集成点、关键数据流和历史包袱回落到 `delivery-plan.md` / `arch-design.md`。
 6. 若需求规模较大或涉及多角色并行，实现前先要求把计划切成可独立验收、可独立 handoff 的 story-sized execution units，并确认 `artifact:persist` 已创建对应任务目录与关键 artifact，再进入 `/team-execute`。
 7. 若缺少 PRD 或需求边界，推荐 `/team-intake`；若缺少 challenge、design review 或 implementation-readiness，推荐 `/team-plan`；若 readiness proof 与 handoff 齐备，推荐 `/team-execute`；若已完成实现与自测，推荐 `/team-review`；若已获得放行，推荐 `/team-release`；若发布观察窗口结束，推荐 `/team-closeout`。
-8. 若是既有项目且上下文不足，提示先补齐 brownfield / doc-architecture 类上下文；必要时用 Graphify 或 GitNexus 补图谱证据，再进入计划或执行。
+8. 若是既有项目且上下文不足，提示先补齐 brownfield / doc-architecture 类上下文；必要时用 CodeGraph、Graphify 或 GitNexus 补图谱证据，再进入计划或执行。
 9. 输出结构化建议：推荐命令、原因、阻塞项、降级路径，并说明是否需要先运行 `npm run workflow:readiness`。

package/commands/team-plan.md

@@ -40,7 +40,7 @@
 2. 默认把 `karpathy-guidelines` 作为计划收口护栏：要求显式写出假设、更简单备选路径、当前不做项，以及为什么本轮范围已经足够。
 3. 按任务特征装配动态讨论分组，先讨论再收敛，避免未经质疑直接进入计划冻结。
 4. 若启用 `doc-architecture`，补齐 Service Catalog、Communication Matrix、NFR Summary，并明确其 artifact 回落位置。
-5. 若是既有项目（brownfield），先梳理现有模块边界、外部依赖、历史约束和缺失文档；必要时运行 `/update-codemaps`，需要轻量结构证据时选择 Graphify，需要跨模块影响面或 MCP 证据时选择 GitNexus，再把 brownfield snapshot 回落到 `delivery-plan.md` 与 `arch-design.md`。
+5. 若是既有项目（brownfield），先梳理现有模块边界、外部依赖、历史约束和缺失文档；必要时运行 `/update-codemaps`，默认用 CodeGraph 补 MCP-backed 符号、调用链和影响面证据，需要轻量结构证据时选择 Graphify，需要跨模块或多仓影响面时选择 GitNexus，再把 brownfield snapshot 回落到 `delivery-plan.md` 与 `arch-design.md`。
 6. 若为企业内部应用，锁定应用等级、技术架构等级、关键组件偏离和资产入口要求，并判断是否必须输出 ADR。
 7. 为本次任务显式装配 shared 能力、ECC 增强与可选 enterprise overlay 组合，并说明哪些私有 overlay 能力、runbook 或 overlay 仅按场景启用。
 8. 若存在多参数、多角色、多配置或多终端组合，提前判断是否需要 `pairwise-test-design` 压缩测试矩阵。

package/commands/update-codemaps.md

@@ -4,7 +4,7 @@
 
 ## 用途
 
-扫描代码结构并生成 token-lean codemaps，适合作为 brownfield 项目的现状快照与 Graphify / GitNexus 图谱分析前置上下文。
+扫描代码结构并生成 token-lean codemaps，适合作为 brownfield 项目的现状快照与 CodeGraph / Graphify / GitNexus 图谱分析前置上下文。
 
 ## 主责角色
 
@@ -21,7 +21,7 @@
 - docs/CODEMAPS/ 下的结构化 codemap
 - .reports/codemap-diff.txt 差异摘要
 - 可供 `/team-help` / `/team-plan` 消费的 brownfield context
-- 可供 Graphify / GitNexus 继续深挖的结构化问题清单
+- 可供 CodeGraph / Graphify / GitNexus 继续深挖的结构化问题清单
 
 输出字段定义与交付结构见 [team-command-output-contracts.md](../docs/runbooks/team-command-output-contracts.md)。
 
@@ -30,4 +30,4 @@
 1. 先识别仓库类型、源码目录、入口文件和主要依赖边界。
 2. 为 architecture/backend/frontend/data/dependencies 生成 token-lean 文档，不写实现细节噪音。
 3. 若已有 codemap，先比较变更比例；超过阈值时要求人工确认再覆盖。
-4. 把结果作为 brownfield context snapshot 的辅助输入；若需要图谱证据，再选择 Graphify 或 GitNexus，并把结论回落到 `delivery-plan.md` / `arch-design.md`，不要形成平行事实源。
+4. 把结果作为 brownfield context snapshot 的辅助输入；若需要图谱证据，再选择 CodeGraph、Graphify 或 GitNexus，并把结论回落到 `delivery-plan.md` / `arch-design.md`，不要形成平行事实源。

package/manifests/install-components.json

@@ -140,7 +140,7 @@
     {
       "id": "capability:knowledge-graph",
       "family": "capability",
-      "description": "Optional Graphify and GitNexus code-graph capabilities for repository structure reasoning, dependency paths, and impact analysis.",
+      "description": "Default CodeGraph plus optional Graphify and GitNexus code-graph capabilities for repository structure reasoning, dependency paths, and impact analysis.",
       "modules": [
         "knowledge-graph"
       ]

package/manifests/install-modules.json

@@ -12,6 +12,8 @@
         "claude",
         "cursor",
         "antigravity",
+        "codex",
+        "opencode",
         "codebuddy",
         "copilot",
         "windsurf",
@@ -90,6 +92,7 @@
       "description": "Baseline platform configs, package-manager setup, and MCP catalog.",
       "paths": [
         ".claude-plugin",
+        ".codex-plugin",
         ".cursor",
         ".opencode-plugin",
         "mcp-configs"
@@ -293,13 +296,24 @@
     {
       "id": "knowledge-graph",
       "kind": "skills",
-      "description": "Optional Graphify and GitNexus code-graph capabilities for brownfield structure discovery, architecture Q&A, impact analysis, and evidence capture.",
+      "description": "Default CodeGraph plus optional Graphify and GitNexus code-graph capabilities for brownfield structure discovery, architecture Q&A, impact analysis, and evidence capture.",
       "paths": [
+        "skills/codegraph",
         "skills/graphify",
         "skills/gitnexus",
+        "docs/runbooks/codegraph-code-intelligence-usage.md",
         "docs/runbooks/graphify-knowledge-graph-usage.md",
-        "docs/runbooks/gitnexus-code-intelligence-usage.md"
+        "docs/runbooks/gitnexus-code-intelligence-usage.md",
+        "scripts/codegraph-preflight.js",
+        "scripts/install-codegraph.js"
       ],
+      "externalInstall": {
+        "id": "codegraph",
+        "description": "Run the upstream CodeGraph installer through a TSP target-scoped wrapper; never uses --target=auto and never initializes project indexes.",
+        "command": "node",
+        "script": "scripts/install-codegraph.js",
+        "args": []
+      },
       "targets": [
         "claude",
         "cursor",
@@ -311,7 +325,7 @@
       "dependencies": [
         "platform-configs"
       ],
-      "defaultInstall": false,
+      "defaultInstall": true,
       "cost": "medium",
       "stability": "beta"
     },

package/manifests/install-profiles.json

@@ -23,6 +23,7 @@
         "workflow-quality",
         "framework-language",
         "database",
+        "knowledge-graph",
         "workflow-engine",
         "workflow-defaults",
         "orchestration"
@@ -101,6 +102,7 @@
         "workflow-quality",
         "framework-language",
         "database",
+        "knowledge-graph",
         "workflow-engine",
         "workflow-defaults",
         "design-prototyping",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colin4k1024/tsp",
-  "version": "2.4.5",
+  "version": "2.4.6",
   "description": "Open-source Team Skills Platform for role-based AI delivery workflows, shared skills, hooks, commands, and multi-platform installs.",
   "repository": {
     "type": "git",
@@ -42,6 +42,7 @@
     "validate:docs-freshness": "node scripts/validate-doc-freshness.js",
     "graphify:doctor": "node scripts/graphify-preflight.js",
     "gitnexus:doctor": "node scripts/gitnexus-preflight.js",
+    "codegraph:doctor": "node scripts/codegraph-preflight.js",
     "validate:skill-structure": "node scripts/validate-skill-structure.js",
     "validate:prebuilt": "node scripts/validate-prebuilt.js",
     "validate:tarball": "node scripts/validate-packed-tarball.js",
@@ -57,6 +58,7 @@
     "workflow:validate": "node scripts/validate-workflows.js",
     "audit:query": "node scripts/query-audit-logs.js",
     "install:claude": "node scripts/install-apply.js --profile full --target claude && npx --yes claude-mem install",
+    "install:claude-code": "node scripts/install-apply.js --profile full --target claude && npx --yes claude-mem install",
     "install:codex": "node scripts/install-apply.js --profile full --target codex",
     "install:cursor": "node scripts/install-apply.js --profile full --target cursor",
     "install:opencode": "node scripts/install-apply.js --profile full --target opencode",
@@ -90,7 +92,6 @@
     "commands/",
     "roles/",
     "templates/",
-    "docs/",
     "hooks/",
     "contexts/",
     "examples/",
@@ -102,6 +103,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@colbymchenry/codegraph": "^0.7.12",
     "@iarna/toml": "^2.2.5",
     "@inquirer/prompts": "^7.5.0",
     "ajv": "^8.18.0",
@@ -116,5 +118,6 @@
     "globals": "^17.1.0",
     "markdownlint-cli": "^0.48.0",
     "vitepress": "^1.6.4"
-  }
+  },
+  "packageManager": "pnpm@11.0.9+sha512.34ce82e6780233cf9cad8685029a8f81d2e06196c5a9bad98879f7424940c6817c4e4524fb7d38b8553ceed48b9758b8ebaf1abd3600c232c4c8cf7366086f38"
 }

package/schemas/ecc-install-config.schema.json

@@ -19,12 +19,17 @@
       "type": "string",
       "enum": [
         "claude",
+        "claude-code",
+        "claudecode",
         "cursor",
         "antigravity",
         "codex",
         "gemini",
         "opencode",
-        "codebuddy"
+        "codebuddy",
+        "copilot",
+        "windsurf",
+        "augment"
       ]
     },
     "profile": {

package/schemas/install-modules.schema.json

@@ -53,7 +53,10 @@
                 "codex",
                 "gemini",
                 "opencode",
-                "codebuddy"
+                "codebuddy",
+                "copilot",
+                "windsurf",
+                "augment"
               ]
             }
           },

package/scripts/codegraph-preflight.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+const { spawnSync } = require('child_process')
+const { buildInstallCommand, mapTarget } = require('./install-codegraph')
+
+const MIN_NODE_MAJOR = 18
+const MAX_NODE_MAJOR_EXCLUSIVE = 25
+const PACKAGE_NAME = '@colbymchenry/codegraph'
+
+function parseNodeVersion(text) {
+  const match = String(text || '').trim().match(/^v?(\d+)\.(\d+)\.(\d+)/)
+  if (!match) {
+    return null
+  }
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    raw: `${match[1]}.${match[2]}.${match[3]}`,
+  }
+}
+
+function isNodeSupported(version) {
+  return Boolean(
+    version
+      && version.major >= MIN_NODE_MAJOR
+      && version.major < MAX_NODE_MAJOR_EXCLUSIVE
+  )
+}
+
+function loadPackageMetadata() {
+  if (process.env.CODEGRAPH_PREFLIGHT_PACKAGE_JSON) {
+    return {
+      ok: true,
+      source: 'env',
+      metadata: JSON.parse(process.env.CODEGRAPH_PREFLIGHT_PACKAGE_JSON),
+    }
+  }
+
+  try {
+    const packageJsonPath = require.resolve(`${PACKAGE_NAME}/package.json`)
+    return {
+      ok: true,
+      source: packageJsonPath,
+      metadata: JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')),
+    }
+  } catch (error) {
+    return {
+      ok: false,
+      source: 'node-resolution',
+      warning: error.message || String(error),
+    }
+  }
+}
+
+function detectCli(target) {
+  if (process.env.CODEGRAPH_PREFLIGHT_SKIP_CLI === '1') {
+    return {
+      ok: true,
+      command: '(skipped)',
+      output: 'skipped by CODEGRAPH_PREFLIGHT_SKIP_CLI',
+    }
+  }
+
+  let install
+  try {
+    install = buildInstallCommand(target || 'codex')
+  } catch (error) {
+    return {
+      ok: false,
+      command: 'codegraph',
+      output: error.message || String(error),
+    }
+  }
+
+  if (!install.supported) {
+    return {
+      ok: true,
+      command: '(unsupported target skipped)',
+      output: install.reason,
+    }
+  }
+
+  const args = install.args.slice(0, install.args.length - 4).concat(['--help'])
+  const result = spawnSync(install.command, args, {
+    encoding: 'utf8',
+    timeout: 8000,
+  })
+
+  if (result.error || result.status !== 0) {
+    return {
+      ok: false,
+      command: install.command,
+      output: result.error ? result.error.message : `${result.stdout || ''}${result.stderr || ''}`.trim(),
+    }
+  }
+
+  return {
+    ok: true,
+    command: install.command,
+    output: 'codegraph --help',
+  }
+}
+
+function main() {
+  console.log('CodeGraph preflight check')
+  console.log('=========================')
+
+  const target = process.env.TSP_INSTALL_TARGET || process.env.CODEGRAPH_PREFLIGHT_TARGET || ''
+  const nodeVersion = parseNodeVersion(process.env.CODEGRAPH_PREFLIGHT_NODE_VERSION || process.version)
+  const packageInfo = loadPackageMetadata()
+  const cli = detectCli(target)
+  const mappedTarget = target ? mapTarget(target) : null
+  let hasFailure = false
+
+  if (!nodeVersion) {
+    hasFailure = true
+    console.log(`- Node: unable to detect version (requires >= ${MIN_NODE_MAJOR} and < ${MAX_NODE_MAJOR_EXCLUSIVE})`)
+  } else if (!isNodeSupported(nodeVersion)) {
+    hasFailure = true
+    console.log(`- Node: ${nodeVersion.raw} (requires >= ${MIN_NODE_MAJOR} and < ${MAX_NODE_MAJOR_EXCLUSIVE})`)
+  } else {
+    console.log(`- Node: ${nodeVersion.raw} (ok)`)
+  }
+
+  if (packageInfo.ok && packageInfo.metadata) {
+    const engine = packageInfo.metadata.engines && packageInfo.metadata.engines.node
+      ? packageInfo.metadata.engines.node
+      : '(not declared)'
+    console.log(`- CodeGraph package: ${packageInfo.metadata.version || '(unknown)'} (license ${packageInfo.metadata.license || '(unknown)'}, node ${engine})`)
+  } else {
+    hasFailure = true
+    console.log(`- CodeGraph package: unavailable (${packageInfo.warning || 'not installed'})`)
+  }
+
+  if (!cli.ok) {
+    hasFailure = true
+    console.log(`- CodeGraph CLI: unavailable (${cli.output || cli.command})`)
+  } else {
+    console.log(`- CodeGraph CLI: ${cli.output} (ok)`)
+  }
+
+  if (target) {
+    if (mappedTarget) {
+      console.log(`- TSP target: ${target} -> CodeGraph target ${mappedTarget} (ok)`)
+    } else {
+      console.log(`- TSP target: ${target} (unsupported by upstream installer; wrapper will skip)`)
+    }
+  } else {
+    console.log('- TSP target: not provided (doctor only)')
+  }
+
+  console.log('\nControlled integration boundaries:')
+  console.log('- TSP calls CodeGraph installer with the current target only; it never uses --target=auto.')
+  console.log('- TSP install does not run `codegraph init -i`; initialize indexes inside target projects only.')
+  console.log('- Do not commit `.codegraph/` databases as TSP artifacts.')
+
+  if (hasFailure) {
+    console.log('\nFix failed checks before applying the CodeGraph integration.')
+    process.exit(1)
+  }
+
+  console.log('\nRecommended next commands:')
+  console.log('- npm run codegraph:doctor')
+  console.log('- codegraph init -i')
+  console.log('- codegraph status')
+}
+
+if (require.main === module) {
+  main()
+}
+
+module.exports = {
+  isNodeSupported,
+  parseNodeVersion,
+}

package/scripts/gitnexus-preflight.js

@@ -46,6 +46,14 @@ function isNodeSupported(version) {
 }
 
 function detectCommand(command) {
+  if (process.env.GITNEXUS_PREFLIGHT_SKIP_COMMANDS === '1') {
+    return {
+      ok: true,
+      command,
+      output: 'skipped by test fixture',
+    }
+  }
+
   const result = run(command, ['--version'])
   if (result.error || result.status !== 0) {
     return {

package/scripts/install-apply.js

@@ -8,12 +8,10 @@
 
 const os = require('os');
 const {
-  SUPPORTED_INSTALL_TARGETS,
   listLegacyCompatibilityLanguages,
   resolveInstallPlan,
 } = require('./lib/install-manifests');
 const {
-  LEGACY_INSTALL_TARGETS,
   normalizeInstallRequest,
   parseInstallArgs,
 } = require('./lib/install/request');
@@ -24,6 +22,7 @@ const {
   uninstallInstalledStates,
 } = require('./lib/install-lifecycle');
 const { deriveInstallManifestPath } = require('./lib/install-audit-manifest');
+const { PUBLIC_INSTALL_TARGETS } = require('./lib/install-targets/registry');
 
 const LIFECYCLE_COMMANDS = new Set(['plan', 'status', 'doctor', 'repair', 'uninstall']);
 
@@ -109,16 +108,19 @@ function evaluateCodexKnownRisk(planLike) {
 
 function getHelpText(command = 'all') {
   const languages = listLegacyCompatibilityLanguages();
+  const publicTargets = [...PUBLIC_INSTALL_TARGETS, 'claude-code', 'claudecode'];
   const planUsage = `
-Usage: install.sh [plan] [--target <${LEGACY_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] <language> [<language> ...]
-       install.sh [plan] [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] [--overlay <id>]... --profile <name> [--with <component>]... [--without <component>]...
-       install.sh [plan] [--target <${SUPPORTED_INSTALL_TARGETS.join('|')}>] [--dry-run] [--json] [--overlay <id>]... --modules <id,id,...> [--with <component>]... [--without <component>]...
+Usage: install.sh [plan] [--target <${publicTargets.join('|')}>] [--dry-run] [--json] <language> [<language> ...]
+       install.sh [plan] [--target <${publicTargets.join('|')}>] [--dry-run] [--json] [--overlay <id>]... --profile <name> [--with <component>]... [--without <component>]...
+       install.sh [plan] [--target <${publicTargets.join('|')}>] [--dry-run] [--json] [--overlay <id>]... --modules <id,id,...> [--with <component>]... [--without <component>]...
        install.sh [plan] [--dry-run] [--json] --config <path>
 
 Targets:
-  claude       (default) - Install rules to ~/.claude/rules/
-  cursor       - Install rules, hooks, and bundled Cursor configs to ./.cursor/
-  antigravity  - Install rules, workflows, skills, and agents to ./.agent/
+  claude       (default) - Install Claude Code assets to ~/.claude/
+  codex        - Install Codex assets to ~/.codex/ and register the plugin
+  opencode     - Install OpenCode assets to ~/.config/opencode/
+  claude-code  - Alias for claude
+  claudecode   - Alias for claude
 
 Options:
   --profile <name>    Resolve and install a manifest profile