agent-configs 1.0.0

package/commands/tdd.md

@@ -0,0 +1,326 @@
+---
+description: Enforce test-driven development workflow. Scaffold interfaces, generate tests FIRST, then implement minimal code to pass. Ensure 80%+ coverage.
+---
+
+# TDD Command
+
+This command invokes the **tdd-guide** agent to enforce test-driven development methodology.
+
+## What This Command Does
+
+1. **Scaffold Interfaces** - Define types/interfaces first
+2. **Generate Tests First** - Write failing tests (RED)
+3. **Implement Minimal Code** - Write just enough to pass (GREEN)
+4. **Refactor** - Improve code while keeping tests green (REFACTOR)
+5. **Verify Coverage** - Ensure 80%+ test coverage
+
+## When to Use
+
+Use `/tdd` when:
+- Implementing new features
+- Adding new functions/components
+- Fixing bugs (write test that reproduces bug first)
+- Refactoring existing code
+- Building critical business logic
+
+## How It Works
+
+The tdd-guide agent will:
+
+1. **Define interfaces** for inputs/outputs
+2. **Write tests that will FAIL** (because code doesn't exist yet)
+3. **Run tests** and verify they fail for the right reason
+4. **Write minimal implementation** to make tests pass
+5. **Run tests** and verify they pass
+6. **Refactor** code while keeping tests green
+7. **Check coverage** and add more tests if below 80%
+
+## TDD Cycle
+
+```
+RED → GREEN → REFACTOR → REPEAT
+
+RED:      Write a failing test
+GREEN:    Write minimal code to pass
+REFACTOR: Improve code, keep tests passing
+REPEAT:   Next feature/scenario
+```
+
+## Example Usage
+
+```
+User: /tdd I need a function to calculate market liquidity score
+
+Agent (tdd-guide):
+# TDD Session: Market Liquidity Score Calculator
+
+## Step 1: Define Interface (SCAFFOLD)
+
+```typescript
+// lib/liquidity.ts
+export interface MarketData {
+  totalVolume: number
+  bidAskSpread: number
+  activeTraders: number
+  lastTradeTime: Date
+}
+
+export function calculateLiquidityScore(market: MarketData): number {
+  // TODO: Implementation
+  throw new Error('Not implemented')
+}
+```
+
+## Step 2: Write Failing Test (RED)
+
+```typescript
+// lib/liquidity.test.ts
+import { calculateLiquidityScore } from './liquidity'
+
+describe('calculateLiquidityScore', () => {
+  it('should return high score for liquid market', () => {
+    const market = {
+      totalVolume: 100000,
+      bidAskSpread: 0.01,
+      activeTraders: 500,
+      lastTradeTime: new Date()
+    }
+
+    const score = calculateLiquidityScore(market)
+
+    expect(score).toBeGreaterThan(80)
+    expect(score).toBeLessThanOrEqual(100)
+  })
+
+  it('should return low score for illiquid market', () => {
+    const market = {
+      totalVolume: 100,
+      bidAskSpread: 0.5,
+      activeTraders: 2,
+      lastTradeTime: new Date(Date.now() - 86400000) // 1 day ago
+    }
+
+    const score = calculateLiquidityScore(market)
+
+    expect(score).toBeLessThan(30)
+    expect(score).toBeGreaterThanOrEqual(0)
+  })
+
+  it('should handle edge case: zero volume', () => {
+    const market = {
+      totalVolume: 0,
+      bidAskSpread: 0,
+      activeTraders: 0,
+      lastTradeTime: new Date()
+    }
+
+    const score = calculateLiquidityScore(market)
+
+    expect(score).toBe(0)
+  })
+})
+```
+
+## Step 3: Run Tests - Verify FAIL
+
+```bash
+npm test lib/liquidity.test.ts
+
+FAIL lib/liquidity.test.ts
+  ✕ should return high score for liquid market (2 ms)
+    Error: Not implemented
+
+1 test failed, 0 passed
+```
+
+✅ Tests fail as expected. Ready to implement.
+
+## Step 4: Implement Minimal Code (GREEN)
+
+```typescript
+// lib/liquidity.ts
+export function calculateLiquidityScore(market: MarketData): number {
+  // Handle zero volume edge case
+  if (market.totalVolume === 0) {
+    return 0
+  }
+
+  // Calculate component scores (0-100 scale)
+  const volumeScore = Math.min(market.totalVolume / 1000, 100)
+  const spreadScore = Math.max(100 - (market.bidAskSpread * 1000), 0)
+  const traderScore = Math.min(market.activeTraders / 10, 100)
+
+  // Recent activity bonus
+  const hoursSinceLastTrade = (Date.now() - market.lastTradeTime.getTime()) / (1000 * 60 * 60)
+  const recencyScore = Math.max(100 - (hoursSinceLastTrade * 10), 0)
+
+  // Weighted average
+  const score = (
+    volumeScore * 0.4 +
+    spreadScore * 0.3 +
+    traderScore * 0.2 +
+    recencyScore * 0.1
+  )
+
+  return Math.min(Math.max(score, 0), 100) // Clamp to 0-100
+}
+```
+
+## Step 5: Run Tests - Verify PASS
+
+```bash
+npm test lib/liquidity.test.ts
+
+PASS lib/liquidity.test.ts
+  ✓ should return high score for liquid market (3 ms)
+  ✓ should return low score for illiquid market (2 ms)
+  ✓ should handle edge case: zero volume (1 ms)
+
+3 tests passed
+```
+
+✅ All tests passing!
+
+## Step 6: Refactor (IMPROVE)
+
+```typescript
+// lib/liquidity.ts - Refactored with constants and better readability
+const WEIGHTS = {
+  VOLUME: 0.4,
+  SPREAD: 0.3,
+  TRADERS: 0.2,
+  RECENCY: 0.1,
+} as const
+
+const SCALE_FACTORS = {
+  VOLUME: 1000,
+  SPREAD: 1000,
+  TRADERS: 10,
+  RECENCY_PENALTY: 10,
+} as const
+
+function clamp(value: number, min: number, max: number): number {
+  return Math.min(Math.max(value, min), max)
+}
+
+export function calculateLiquidityScore(market: MarketData): number {
+  if (market.totalVolume === 0) return 0
+
+  const volumeScore = Math.min(market.totalVolume / SCALE_FACTORS.VOLUME, 100)
+  const spreadScore = clamp(100 - (market.bidAskSpread * SCALE_FACTORS.SPREAD), 0, 100)
+  const traderScore = Math.min(market.activeTraders / SCALE_FACTORS.TRADERS, 100)
+
+  const hoursSinceLastTrade = (Date.now() - market.lastTradeTime.getTime()) / (1000 * 60 * 60)
+  const recencyScore = clamp(100 - (hoursSinceLastTrade * SCALE_FACTORS.RECENCY_PENALTY), 0, 100)
+
+  const weightedScore =
+    volumeScore * WEIGHTS.VOLUME +
+    spreadScore * WEIGHTS.SPREAD +
+    traderScore * WEIGHTS.TRADERS +
+    recencyScore * WEIGHTS.RECENCY
+
+  return clamp(weightedScore, 0, 100)
+}
+```
+
+## Step 7: Verify Tests Still Pass
+
+```bash
+npm test lib/liquidity.test.ts
+
+PASS lib/liquidity.test.ts
+  ✓ should return high score for liquid market (3 ms)
+  ✓ should return low score for illiquid market (2 ms)
+  ✓ should handle edge case: zero volume (1 ms)
+
+3 tests passed
+```
+
+✅ Refactoring complete, tests still passing!
+
+## Step 8: Check Coverage
+
+```bash
+npm test -- --coverage lib/liquidity.test.ts
+
+File           | % Stmts | % Branch | % Funcs | % Lines
+---------------|---------|----------|---------|--------
+liquidity.ts   |   100   |   100    |   100   |   100
+
+Coverage: 100% ✅ (Target: 80%)
+```
+
+✅ TDD session complete!
+```
+
+## TDD Best Practices
+
+**DO:**
+- ✅ Write the test FIRST, before any implementation
+- ✅ Run tests and verify they FAIL before implementing
+- ✅ Write minimal code to make tests pass
+- ✅ Refactor only after tests are green
+- ✅ Add edge cases and error scenarios
+- ✅ Aim for 80%+ coverage (100% for critical code)
+
+**DON'T:**
+- ❌ Write implementation before tests
+- ❌ Skip running tests after each change
+- ❌ Write too much code at once
+- ❌ Ignore failing tests
+- ❌ Test implementation details (test behavior)
+- ❌ Mock everything (prefer integration tests)
+
+## Test Types to Include
+
+**Unit Tests** (Function-level):
+- Happy path scenarios
+- Edge cases (empty, null, max values)
+- Error conditions
+- Boundary values
+
+**Integration Tests** (Component-level):
+- API endpoints
+- Database operations
+- External service calls
+- React components with hooks
+
+**E2E Tests** (use `/e2e` command):
+- Critical user flows
+- Multi-step processes
+- Full stack integration
+
+## Coverage Requirements
+
+- **80% minimum** for all code
+- **100% required** for:
+  - Financial calculations
+  - Authentication logic
+  - Security-critical code
+  - Core business logic
+
+## Important Notes
+
+**MANDATORY**: Tests must be written BEFORE implementation. The TDD cycle is:
+
+1. **RED** - Write failing test
+2. **GREEN** - Implement to pass
+3. **REFACTOR** - Improve code
+
+Never skip the RED phase. Never write code before tests.
+
+## Integration with Other Commands
+
+- Use `/plan` first to understand what to build
+- Use `/tdd` to implement with tests
+- Use `/build-and-fix` if build errors occur
+- Use `/code-review` to review implementation
+- Use `/test-coverage` to verify coverage
+
+## Related Agents
+
+This command invokes the `tdd-guide` agent located at:
+`~/.claude/agents/tdd-guide.md`
+
+And can reference the `tdd-workflow` skill at:
+`~/.claude/skills/tdd-workflow/`

package/commands/test-coverage.md

@@ -0,0 +1,27 @@
+# Test Coverage
+
+Analyze test coverage and generate missing tests:
+
+1. Run tests with coverage: npm test --coverage or pnpm test --coverage
+
+2. Analyze coverage report (coverage/coverage-summary.json)
+
+3. Identify files below 80% coverage threshold
+
+4. For each under-covered file:
+   - Analyze untested code paths
+   - Generate unit tests for functions
+   - Generate integration tests for APIs
+   - Generate E2E tests for critical flows
+
+5. Verify new tests pass
+
+6. Show before/after coverage metrics
+
+7. Ensure project reaches 80%+ overall coverage
+
+Focus on:
+- Happy path scenarios
+- Error handling
+- Edge cases (null, undefined, empty)
+- Boundary conditions

package/commands/update-codemaps.md

@@ -0,0 +1,17 @@
+# Update Codemaps
+
+Analyze the codebase structure and update architecture documentation:
+
+1. Scan all source files for imports, exports, and dependencies
+2. Generate token-lean codemaps in the following format:
+   - codemaps/architecture.md - Overall architecture
+   - codemaps/backend.md - Backend structure  
+   - codemaps/frontend.md - Frontend structure
+   - codemaps/data.md - Data models and schemas
+
+3. Calculate diff percentage from previous version
+4. If changes > 30%, request user approval before updating
+5. Add freshness timestamp to each codemap
+6. Save reports to .reports/codemap-diff.txt
+
+Use TypeScript/Node.js for analysis. Focus on high-level structure, not implementation details.

package/commands/update-docs.md

@@ -0,0 +1,31 @@
+# Update Documentation
+
+Sync documentation from source-of-truth:
+
+1. Read package.json scripts section
+   - Generate scripts reference table
+   - Include descriptions from comments
+
+2. Read .env.example
+   - Extract all environment variables
+   - Document purpose and format
+
+3. Generate docs/CONTRIB.md with:
+   - Development workflow
+   - Available scripts
+   - Environment setup
+   - Testing procedures
+
+4. Generate docs/RUNBOOK.md with:
+   - Deployment procedures
+   - Monitoring and alerts
+   - Common issues and fixes
+   - Rollback procedures
+
+5. Identify obsolete documentation:
+   - Find docs not modified in 90+ days
+   - List for manual review
+
+6. Show diff summary
+
+Single source of truth: package.json and .env.example

package/configs.json

@@ -0,0 +1,158 @@
+{
+  "version": "1.0.0",
+  "defaultPlatform": "cursor",
+  "defaultScope": "project",
+  "categories": [
+    {
+      "id": "commands",
+      "name": "Commands",
+      "description": "斜杠命令，快速执行常用操作",
+      "platforms": ["claude", "cursor"],
+      "target": {
+        "claude": { "global": "~/.claude/commands/", "project": ".claude/commands/" },
+        "cursor": { "global": "~/.cursor/commands/", "project": ".cursor/commands/" }
+      },
+      "items": [
+        { "name": "plan", "description": "规划实现方案，WAIT 用户确认后执行", "path": "commands/plan.md", "featured": true },
+        { "name": "code-review", "description": "代码安全和质量审查", "path": "commands/code-review.md", "featured": true },
+        { "name": "tdd", "description": "TDD 工作流，测试先行", "path": "commands/tdd.md" },
+        { "name": "learn", "description": "提取可复用 patterns 为 skills", "path": "commands/learn.md" },
+        { "name": "refactor-clean", "description": "清理死代码和冗余文件", "path": "commands/refactor-clean.md" },
+        { "name": "e2e", "description": "Playwright E2E 测试", "path": "commands/e2e.md" },
+        { "name": "build-fix", "description": "构建错误自动修复", "path": "commands/build-fix.md" },
+        { "name": "test-coverage", "description": "测试覆盖率检查", "path": "commands/test-coverage.md" },
+        { "name": "update-docs", "description": "同步文档", "path": "commands/update-docs.md" },
+        { "name": "update-codemaps", "description": "更新架构文档", "path": "commands/update-codemaps.md" }
+      ]
+    },
+    {
+      "id": "skills",
+      "name": "Skills",
+      "description": "工作流定义和领域知识",
+      "platforms": ["claude", "cursor"],
+      "target": {
+        "claude": { "global": "~/.claude/skills/", "project": ".claude/skills/" },
+        "cursor": { "global": "~/.cursor/skills/", "project": ".cursor/skills/" }
+      },
+      "items": [
+        { "name": "ai-config-architect", "description": "AI 配置架构师 - 生成 rules/skills/commands/hooks/agents 配置，支持 Claude/Cursor 双平台", "path": "skills/ai-config-architect/", "featured": true },
+        
+        { "name": "security-review", "description": "安全审查检查清单", "path": "skills/security-review/" },
+        { "name": "coding-standards", "description": "编码规范和风格指南", "path": "skills/coding-standards/" },
+        { "name": "verification-loop", "description": "验证循环模式", "path": "skills/verification-loop/" },
+        { "name": "strategic-compact", "description": "策略性上下文压缩", "path": "skills/strategic-compact/" },
+        { "name": "bk-chat-helper", "description": "蓝鲸 AI Chat SDK（业务逻辑层）", "path": "skills/bk-chat-helper/", "tags": ["blueking"] },
+        { "name": "bk-chat-x", "description": "蓝鲸 AI Chat UI 组件库", "path": "skills/bk-chat-x/", "tags": ["blueking"] },
+        { "name": "tdd-workflow", "description": "TDD 完整工作流和最佳实践", "path": "skills/tdd-workflow/" }
+      ]
+    },
+    {
+      "id": "rules",
+      "name": "Rules",
+      "description": "编码规范和最佳实践（仅 Cursor 项目级别）",
+      "platforms": ["cursor"],
+      "target": {
+        "cursor": { "project": ".cursor/rules/" }
+      },
+      "items": [
+        { "name": "security", "description": "安全检查清单", "path": "rules/security.md", "featured": true },
+        { "name": "coding-style", "description": "编码风格（不可变性、文件组织）", "path": "rules/coding-style.md" },
+        { "name": "testing", "description": "TDD、80% 覆盖率要求", "path": "rules/testing.md" },
+        { "name": "git-workflow", "description": "Git 提交规范", "path": "rules/git-workflow.md" },
+        { "name": "agents", "description": "子代理使用规范", "path": "rules/agents.md" },
+        { "name": "patterns", "description": "API 响应格式规范", "path": "rules/patterns.md" },
+        { "name": "performance", "description": "模型选择和上下文管理", "path": "rules/performance.md" },
+        { "name": "hooks", "description": "Hook 使用文档", "path": "rules/hooks.md" }
+      ]
+    },
+    {
+      "id": "agents",
+      "name": "Agents",
+      "description": "子代理定义",
+      "platforms": ["claude", "cursor"],
+      "target": {
+        "claude": { "global": "~/.claude/agents/", "project": ".claude/agents/" },
+        "cursor": { "global": "~/.cursor/agents/", "project": ".cursor/agents/" }
+      },
+      "items": [
+        { "name": "planner", "description": "功能规划专家", "path": "agents/planner.md", "featured": true },
+        { "name": "code-reviewer", "description": "代码审查专家", "path": "agents/code-reviewer.md", "featured": true },
+        { "name": "tdd-guide", "description": "TDD 指导专家", "path": "agents/tdd-guide.md" },
+        { "name": "architect", "description": "系统架构专家", "path": "agents/architect.md" },
+        { "name": "security-reviewer", "description": "安全审查专家", "path": "agents/security-reviewer.md" },
+        { "name": "refactor-cleaner", "description": "重构清理专家", "path": "agents/refactor-cleaner.md" }
+      ]
+    },
+    {
+      "id": "hooks",
+      "name": "Hooks",
+      "description": "自动化钩子配置",
+      "platforms": ["claude", "cursor"],
+      "isSpecial": true,
+      "items": [
+        {
+          "name": "hooks",
+          "description": "完整 hooks 配置（PreToolUse, PostToolUse, Stop）",
+          "files": {
+            "claude": [{ "source": "hooks/hooks.json", "target": ".claude/settings.json", "merge": true }],
+            "cursor": [{ "source": "hooks/hooks.json", "target": ".cursor/hooks.json", "merge": true }]
+          }
+        }
+      ]
+    },
+    {
+      "id": "bundles",
+      "name": "Bundles",
+      "description": "配置组合包",
+      "isBundle": true,
+      "items": [
+        {
+          "name": "shared-memory",
+          "description": "跨会话记忆管理系统",
+          "hasFiles": true,
+          "path": "bundles/shared-memory/",
+          "featured": true
+        },
+        {
+          "name": "tdd-bundle",
+          "description": "TDD 完整工作流",
+          "includes": ["commands/tdd", "skills/tdd-workflow", "agents/tdd-guide"],
+          "path": "bundles/tdd-bundle/"
+        },
+        {
+          "name": "review-bundle",
+          "description": "代码审查全套",
+          "includes": ["commands/code-review", "skills/security-review", "agents/code-reviewer", "agents/security-reviewer"],
+          "path": "bundles/review-bundle/",
+          "featured": true
+        },
+        {
+          "name": "planning-bundle",
+          "description": "规划和架构设计",
+          "includes": ["commands/plan", "agents/planner", "agents/architect"],
+          "path": "bundles/planning-bundle/",
+          "featured": true
+        },
+        {
+          "name": "bk-chat-bundle",
+          "description": "蓝鲸 AI Chat 开发",
+          "includes": ["skills/bk-chat-helper", "skills/bk-chat-x"],
+          "path": "bundles/bk-chat-bundle/",
+          "tags": ["blueking"]
+        },
+        {
+          "name": "continuous-learning",
+          "description": "持续学习 - 从会话中自动提取 patterns，保存为 skills/instincts",
+          "hasFiles": true,
+          "path": "bundles/continuous-learning/",
+          "featured": true
+        }
+      ]
+    }
+  ],
+  "presets": {
+    "minimal": ["commands/plan", "commands/code-review", "rules/security"],
+    "recommended": ["bundles/review-bundle", "bundles/planning-bundle", "rules/*"],
+    "full": ["*"]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,101 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm run dev|pnpm( run)? dev|yarn dev|bun run dev)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"console.error('[Hook] BLOCKED: Dev server must run in tmux for log access');console.error('[Hook] Use: tmux new-session -d -s dev \\\"npm run dev\\\"');console.error('[Hook] Then: tmux attach -t dev');process.exit(1)\""
+          }
+        ],
+        "description": "Block dev servers outside tmux - ensures you can access logs"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm (install|test)|pnpm (install|test)|yarn (install|test)?|bun (install|test)|cargo build|make|docker|pytest|vitest|playwright)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"if(!process.env.TMUX){console.error('[Hook] Consider running in tmux for session persistence');console.error('[Hook] tmux new -s dev  |  tmux attach -t dev')}\""
+          }
+        ],
+        "description": "Reminder to use tmux for long-running commands"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"git push\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"console.error('[Hook] Review changes before push...');console.error('[Hook] Continuing with push (remove this hook to add interactive review)')\""
+          }
+        ],
+        "description": "Reminder before git push to review changes"
+      },
+      {
+        "matcher": "tool == \"Write\" && tool_input.file_path matches \"\\\\.(md|txt)$\" && !(tool_input.file_path matches \"README\\\\.md|CLAUDE\\\\.md|AGENTS\\\\.md|CONTRIBUTING\\\\.md\")",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path||'';if(/\\.(md|txt)$/.test(p)&&!/(README|CLAUDE|AGENTS|CONTRIBUTING)\\.md$/.test(p)){console.error('[Hook] BLOCKED: Unnecessary documentation file creation');console.error('[Hook] File: '+p);console.error('[Hook] Use README.md for documentation instead');process.exit(1)}console.log(d)})\""
+          }
+        ],
+        "description": "Block creation of random .md files - keeps docs consolidated"
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "tool == \"Bash\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const cmd=i.tool_input?.command||'';if(/gh pr create/.test(cmd)){const out=i.tool_output?.output||'';const m=out.match(/https:\\/\\/github.com\\/[^/]+\\/[^/]+\\/pull\\/\\d+/);if(m){console.error('[Hook] PR created: '+m[0]);const repo=m[0].replace(/https:\\/\\/github.com\\/([^/]+\\/[^/]+)\\/pull\\/\\d+/,'$1');const pr=m[0].replace(/.*\\/pull\\/(\\d+)/,'$1');console.error('[Hook] To review: gh pr review '+pr+' --repo '+repo)}}console.log(d)})\""
+          }
+        ],
+        "description": "Log PR URL and provide review command after PR creation"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const{execSync}=require('child_process');const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){try{execSync('npx prettier --write \"'+p+'\"',{stdio:['pipe','pipe','pipe']})}catch(e){}}console.log(d)})\""
+          }
+        ],
+        "description": "Auto-format JS/TS files with Prettier after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const{execSync}=require('child_process');const fs=require('fs');const path=require('path');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){let dir=path.dirname(p);while(dir!==path.dirname(dir)&&!fs.existsSync(path.join(dir,'tsconfig.json'))){dir=path.dirname(dir)}if(fs.existsSync(path.join(dir,'tsconfig.json'))){try{const r=execSync('npx tsc --noEmit --pretty false 2>&1',{cwd:dir,encoding:'utf8',stdio:['pipe','pipe','pipe']});const lines=r.split('\\n').filter(l=>l.includes(p)).slice(0,10);if(lines.length)console.error(lines.join('\\n'))}catch(e){const lines=(e.stdout||'').split('\\n').filter(l=>l.includes(p)).slice(0,10);if(lines.length)console.error(lines.join('\\n'))}}}console.log(d)})\""
+          }
+        ],
+        "description": "TypeScript check after editing .ts/.tsx files"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){const c=fs.readFileSync(p,'utf8');const lines=c.split('\\n');const matches=[];lines.forEach((l,idx)=>{if(/console\\.log/.test(l))matches.push((idx+1)+': '+l.trim())});if(matches.length){console.error('[Hook] WARNING: console.log found in '+p);matches.slice(0,5).forEach(m=>console.error(m));console.error('[Hook] Remove console.log before committing')}}console.log(d)})\""
+          }
+        ],
+        "description": "Warn about console.log statements after edits"
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const{execSync}=require('child_process');try{const r=execSync('git diff --name-only HEAD 2>/dev/null',{encoding:'utf8'});const files=r.split('\\n').filter(f=>/\\.(ts|tsx|js|jsx)$/.test(f));let found=[];for(const f of files){try{const c=require('fs').readFileSync(f,'utf8');const lines=c.split('\\n');lines.forEach((l,i)=>{if(/console\\.log/.test(l))found.push(f+':'+(i+1))});}catch(e){}}if(found.length){console.error('[Hook] WARNING: console.log found in modified files:');found.slice(0,5).forEach(m=>console.error('  '+m));}}catch(e){}\""
+          }
+        ],
+        "description": "Check for console.log in modified files after each response"
+      }
+    ]
+  }
+}