@colin4k1024/tsp 2.4.9 → 2.5.1

package/README.md

@@ -1,4 +1,7 @@
-# Team Skills Platform
+<div align="center">
+  <img src="./assets/icon.png" alt="Team Skills Platform" width="128" height="128"/>
+  <h1>Team Skills Platform</h1>
+</div>
 
 面向团队协作与平台治理的开源 Team Skills Platform，用于把单代理执行模式升级成“`Tech Lead` 编排 + 专业角色协作”的虚拟研发团队工作模型，并叠加 ECC 风格的 harness layer、specialist 命令与运行时增强能力。当前平台同时支持 `team mode` 与 `solo mode`，前者强调多人交接，后者强调单人闭环但保留同样的关键门禁。
 
@@ -12,6 +15,7 @@
 node scripts/build-platform-artifacts.js
 node scripts/install-apply.js --profile team --target claude
 node scripts/install-apply.js --profile full --target codex
+node scripts/install-apply.js --profile full --target opencode
 ```
 
 ## Who It's For / 适合谁
@@ -55,6 +59,72 @@ TSP 采用 **角色 + 技能 + Agent + 规则 + Hooks + Workflow 引擎** 六层
 
 安装工具链公开主线支持 **3 个 code agent**：Claude Code、Codex、OpenCode。其他历史 target 保留为隐藏兼容路径，不再作为公开 onboarding 主线。
 
+### OpenCode 集成
+
+TSP 为 OpenCode 提供了完整的适配支持，包括：
+
+- **AGENTS.md 自动生成**：包含完整的规则索引、角色索引、命令索引和技能索引
+- **Agent 系统适配**：所有角色和 specialist agents 都添加了 YAML front matter 配置
+- **Hooks 系统适配**：将 TSP hooks 转换为 OpenCode 插件格式
+- **配置文件生成**：自动生成 `opencode.json` 配置文件
+- **Skills 系统兼容**：所有 SKILL.md 文件都兼容 OpenCode 的 skill 工具
+
+#### OpenCode 安装
+
+```bash
+# 安装完整 OpenCode 配置
+node scripts/install-apply.js --profile full --target opencode
+
+# 或使用 npm 脚本
+npm run install:opencode
+```
+
+#### OpenCode 配置
+
+安装完成后，OpenCode 配置文件位于 `~/.config/opencode/opencode.json`，包含：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "instructions": ["./AGENTS.md"],
+  "plugin": ["team-skills-platform"],
+  "permission": {
+    "edit": "allow",
+    "bash": "allow"
+  }
+}
+```
+
+#### OpenCode 使用
+
+1. **启动 OpenCode**：在项目目录运行 `opencode`
+2. **查看可用角色**：AGENTS.md 中包含所有角色的索引
+3. **切换角色**：使用 `@tech-lead`、`@frontend-engineer` 等方式切换角色
+4. **执行命令**：使用 `/team-intake`、`/team-plan` 等团队命令
+5. **加载技能**：使用 `skill` 工具加载 SKILL.md 文件
+
+#### OpenCode 目录结构
+
+```
+~/.config/opencode/
+├── AGENTS.md                    # 主配置文件（自动生成）
+├── opencode.json                # OpenCode 配置文件
+├── agents/                      # Agent 定义文件
+│   ├── tech-lead.md
+│   ├── product-manager.md
+│   └── ...
+├── command/                     # 命令文件
+│   ├── team-intake.md
+│   ├── team-plan.md
+│   └── ...
+└── plugins/                     # 插件目录
+    ├── team-skills-platform/    # TSP 插件
+    │   ├── skills/              # 技能文件
+    │   ├── rules/               # 规则文件
+    │   └── ...
+    └── tsp-hooks.js             # Hooks 插件
+```
+
 发布为 npm 包 `@colin4k1024/tsp`，内置 Rust bridge 预构建二进制，安装零依赖。
 
 ### 集成的开源框架与方法论

package/hooks/README.md

@@ -26,7 +26,7 @@ User request → Claude picks a tool → PreToolUse hook runs → Tool executes
 | **Git push reminder** | `Bash` | Reminds to review changes before `git push` | 0 (warns) |
 | **Pre-commit quality check** | `Bash` | Runs quality checks before `git commit`: lints staged files, validates commit message format when provided via `-m/--message`, detects console.log/debugger/secrets | 2 (blocks critical) / 0 (warns) |
 | **Doc file warning** | `Write` | Warns about non-standard `.md`/`.txt` files (allows README, CLAUDE, CONTRIBUTING, CHANGELOG, LICENSE, SKILL, docs/, skills/); cross-platform path handling | 0 (warns) |
-| **Strategic compact** | `Edit\|Write` | Suggests manual `/compact` at logical intervals (every ~50 tool calls) | 0 (warns) |
+| **Strategic compact** | `*` | Suggests `/compact` when context usage crosses 70/85/95% thresholds, using Claude context-window metrics when available | 0 (warns) |
 | **InsAIts security monitor (opt-in)** | `Bash\|Write\|Edit\|MultiEdit` | Optional security scan for high-signal tool inputs. Disabled unless `ECC_ENABLE_INSAITS=1`. Blocks on critical findings, warns on non-critical, and writes audit log to `.insaits_audit_session.jsonl`. JS wrapper is the canonical hook entry; the Python monitor is an explicit third-party SDK exception. Requires `pip install insa-its`. [Details](../scripts/hooks/insaits-security-monitor.py) | 2 (blocks critical) / 0 (warns) |
 
 ### PostToolUse Hooks

package/hooks/hooks.json

@@ -69,15 +69,16 @@
         "id": "pre:write:doc-file-warning"
       },
       {
-        "matcher": "Edit|Write",
+        "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"pre:edit-write:suggest-compact\" \"scripts/hooks/suggest-compact.js\" \"standard,strict\""
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/run-with-flags.js\" \"pre:all:strategic-compact\" \"scripts/hooks/suggest-compact.js\" \"standard,strict\"",
+            "timeout": 10
           }
         ],
-        "description": "Suggest manual compaction at logical intervals",
-        "id": "pre:edit-write:suggest-compact"
+        "description": "Suggest strategic context compaction when context usage crosses 70/85/95% thresholds",
+        "id": "pre:all:strategic-compact"
       },
       {
         "matcher": "*",

package/hooks/strategic-compact/README.md

@@ -4,11 +4,11 @@
 
 ## 当前状态
 
-✅ **已实现** - 通过 `scripts/hooks/pre_compact.py` 和 `scripts/hooks/suggest_compact.py` 提供完整功能。
+✅ **已实现** - 通过 `scripts/hooks/pre-compact.js` 和 `scripts/hooks/suggest-compact.js` 提供完整功能。
 
 ## 实现细节
 
-### pre_compact.py
+### pre-compact.js
 
 **触发时机**: 上下文压缩前自动调用
 
@@ -25,12 +25,14 @@
 - 总是丢弃的类型：`tool_result`, `search_result`, `exploration_trace`（超过 500 字符时）
 - 其他根据上下文大小决定
 
-### suggest_compact.py
+### suggest-compact.js
 
-**触发时机**: 上下文使用超过 70% 时自动调用
+**触发时机**: `hooks/hooks.json` 的 `pre:all:strategic-compact` 在工具调用前运行；当真实上下文使用超过 70% 时注入 `/compact` 建议。
 
 **功能**:
-- 计算上下文使用率
+- 优先读取 Claude hook 输入里的 `context_window.used_percentage` / `context_window.remaining_percentage`
+- 其次读取 `CLAUDE_CONTEXT_SIZE` / `CLAUDE_CONTEXT_LIMIT`
+- 最后读取 `harness-statusline.js` 写入的 `/tmp/harness-ctx-{session_id}.json`
 - 评估紧迫度：`low` (< 70%) | `medium` (70-85%) | `high` (85-95%) | `critical` (> 95%)
 - 估算可节省的 token
 - 提供具体压缩建议：

package/hooks/strategic-compact/suggest-compact.js

@@ -1,100 +1,14 @@
 #!/usr/bin/env node
-// suggest-compact.js — SuggestCompact hook
-// JS equivalent of scripts/hooks/suggest_compact.py
-//
-// Called when context is getting large. Analyses usage ratio and outputs
-// compact suggestions + reorganisation plan.
-//
-// Reads context metrics from:
-//   1. stdin JSON ({ context_window: { used_percentage, remaining_percentage } })
-//   2. env vars  (CLAUDE_CONTEXT_SIZE, CLAUDE_CONTEXT_LIMIT)
-//   3. bridge file /tmp/harness-ctx-{session_id}.json (written by harness-statusline.js)
-//
-// Silent-fail: any error → process.exit(0)
+/**
+ * Compatibility entry for older strategic-compact hook paths.
+ *
+ * The canonical implementation lives in scripts/hooks/suggest-compact.js so
+ * hooks.json, installers, tests, and audits share one behavior.
+ */
 
 'use strict';
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Urgency thresholds (context usage %)
-const URGENCY = [
-  [95, 'critical'],
-  [85, 'high'],
-  [70, 'medium'],
-  [ 0, 'low'],
-];
-
-function getUrgency(usagePct) {
-  for (const [threshold, label] of URGENCY) {
-    if (usagePct > threshold) return label;
-  }
-  return 'low';
-}
-
-function buildSuggestions(usagePct, contextSize) {
-  const suggestions = [];
-  let savings = 0;
-
-  if (usagePct > 85) {
-    const s = Math.round(contextSize * 0.15);
-    suggestions.push({
-      action: 'summarize',
-      target: 'early conversation history',
-      reason: 'Preserve decisions and conclusions, compress exploration traces',
-      estimated_tokens_saved: s,
-    });
-    savings += s;
-  }
-
-  if (usagePct > 70) {
-    const s = Math.round(contextSize * 0.10);
-    suggestions.push({
-      action: 'discard',
-      target: 'tool results and search outputs',
-      reason: 'These are reference-only, not critical for continuity',
-      estimated_tokens_saved: s,
-    });
-    savings += s;
-  }
-
-  if (usagePct > 60) {
-    const s = Math.round(contextSize * 0.08);
-    suggestions.push({
-      action: 'reorganize',
-      target: 'specialist outputs',
-      reason: 'Move key conclusions to session summary, keep full outputs in memory store',
-      estimated_tokens_saved: s,
-    });
-    savings += s;
-  }
-
-  return { suggestions, savings };
-}
-
-function buildReorganizationPlan() {
-  return {
-    phase_1: {
-      action: 'save_decisions_to_memory',
-      description: 'Extract all decisions and save to ~/.claude/memory/error_experience/decisions/',
-    },
-    phase_2: {
-      action: 'save_pending_items',
-      description: 'Extract pending items and next hints to session summary',
-    },
-    phase_3: {
-      action: 'compress_conversation',
-      description: 'Keep system prompts and last 20 exchanges, summarize middle',
-    },
-    phase_4: {
-      action: 'compact_tool_results',
-      description: 'Replace long tool outputs with summaries: [File X read, Y lines]',
-    },
-  };
-}
-
-// ─── main ───────────────────────────────────────────────────────────────────
+const { buildHookOutput } = require('../../scripts/hooks/suggest-compact');
 
 let input = '';
 const stdinTimeout = setTimeout(() => process.exit(0), 8000);
@@ -103,87 +17,8 @@ process.stdin.on('data', chunk => { input += chunk; });
 process.stdin.on('end', () => {
   clearTimeout(stdinTimeout);
   try {
-    let data = {};
-    try { data = JSON.parse(input || '{}'); } catch (_) { /* ignore */ }
-
-    const sessionId = data.session_id || '';
-
-    // ── Resolve context metrics (3 sources, first wins) ──
-    let usagePct  = null;
-    let contextSize  = 0;
-    let contextLimit = 200000;
-
-    // Source 1: stdin context_window
-    const cw = data.context_window;
-    if (cw && cw.used_percentage != null) {
-      usagePct  = cw.used_percentage;
-      contextSize = Math.round((usagePct / 100) * contextLimit);
-    }
-
-    // Source 2: env vars
-    if (usagePct == null) {
-      const envSize  = parseInt(process.env.CLAUDE_CONTEXT_SIZE  || '0', 10);
-      const envLimit = parseInt(process.env.CLAUDE_CONTEXT_LIMIT || '200000', 10);
-      if (envSize > 0) {
-        contextSize  = envSize;
-        contextLimit = envLimit;
-        usagePct     = Math.round((envSize / envLimit) * 100);
-      }
-    }
-
-    // Source 3: bridge file from harness-statusline.js
-    if (usagePct == null && sessionId) {
-      const bridgePath = path.join(os.tmpdir(), `harness-ctx-${sessionId}.json`);
-      if (fs.existsSync(bridgePath)) {
-        try {
-          const bridge = JSON.parse(fs.readFileSync(bridgePath, 'utf8'));
-          usagePct  = bridge.used_pct ?? null;
-          contextSize = usagePct != null ? Math.round((usagePct / 100) * contextLimit) : 0;
-        } catch (_) { /* ignore */ }
-      }
-    }
-
-    if (usagePct == null) {
-      process.exit(0); // No metrics available — nothing to suggest
-    }
-
-    const urgency       = getUrgency(usagePct);
-    const shouldCompact = usagePct > 70;
-
-    const { suggestions, savings } = buildSuggestions(usagePct, contextSize);
-    const reorganizationPlan = shouldCompact ? buildReorganizationPlan() : null;
-
-    const payload = {
-      should_compact: shouldCompact,
-      urgency,
-      context_usage_ratio: usagePct,
-      estimated_token_savings: savings,
-      suggestions,
-      reorganization_plan: reorganizationPlan,
-    };
-
-    const _msg = `Compact suggestion: ${urgency} urgency, ~${savings} tokens could be saved`;
-
-    // Build context advisory (only inject if compact is warranted)
-    if (!shouldCompact) {
-      process.exit(0);
-    }
-
-    const urgencyEmoji = { critical: '🔴', high: '🟠', medium: '🟡', low: '🟢' }[urgency] ?? '⚪';
-    const ctx = [
-      `## 上下文压缩建议 ${urgencyEmoji} (strategic-compact)`,
-      `- 使用率: ${usagePct}% | 紧迫度: ${urgency} | 可节省: ~${savings} tokens`,
-      ...suggestions.map(s => `- [${s.action}] ${s.target}: ${s.reason}`),
-    ].join('\n');
-
-    process.stdout.write(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'SuggestCompact',
-        additionalContext: ctx,
-      },
-      compactSuggestion: payload,
-    }));
-
+    const output = buildHookOutput(input);
+    if (output) process.stdout.write(JSON.stringify(output));
   } catch (_) {
     process.exit(0);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colin4k1024/tsp",
-  "version": "2.4.9",
+  "version": "2.5.1",
   "description": "Open-source Team Skills Platform for role-based AI delivery workflows, shared skills, hooks, commands, and multi-platform installs.",
   "repository": {
     "type": "git",

package/scripts/harness-audit.js

@@ -203,6 +203,9 @@ function getRepoChecks(rootDir) {
   const commandPrimary = safeRead(rootDir, 'commands/harness-audit.md').trim();
   const commandParity = safeRead(rootDir, '.opencode/commands/harness-audit.md').trim();
   const hooksJson = safeRead(rootDir, 'hooks/hooks.json');
+  const hasStrategicCompactHook =
+    hooksJson.includes('pre:all:strategic-compact') &&
+    hooksJson.includes('scripts/hooks/suggest-compact.js');
 
   return [
     {
@@ -270,10 +273,10 @@ function getRepoChecks(rootDir) {
       category: 'Context Efficiency',
       points: 3,
       scopes: ['repo', 'hooks'],
-      path: 'scripts/hooks/suggest-compact.js',
-      description: 'Suggest-compact automation hook exists',
-      pass: fileExists(rootDir, 'scripts/hooks/suggest-compact.js'),
-      fix: 'Implement scripts/hooks/suggest-compact.js for context pressure hints.',
+      path: 'hooks/hooks.json',
+      description: 'Suggest-compact automation is registered for strategic context pressure hints',
+      pass: fileExists(rootDir, 'scripts/hooks/suggest-compact.js') && hasStrategicCompactHook,
+      fix: 'Register pre:all:strategic-compact in hooks/hooks.json and point it at scripts/hooks/suggest-compact.js.',
     },
     {
       id: 'context-model-route',