┌─────────────────────────────────────────────────────────────┐
│  Agent Trace Management                                     │
├─────────────────────────────────────────────────────────────┤
│  📊 統計表示     - AI/人間の貢献率、モデル別統計            │
│  📋 一覧表示     - 最近のトレース一覧                       │
│  🔍 検索        - ファイル別、日付別のトレース検索          │
│  📄 レポート生成 - コンプライアンス用レポート               │
│  🗄️ アーカイブ   - 古いトレースの整理                      │
└─────────────────────────────────────────────────────────────┘

# プロジェクトの統計を表示
node -e "
const { TraceStore } = require('./.claude/lib/trace-store.ts');
const store = new TraceStore(process.cwd());
const stats = store.getStatistics();
console.log(JSON.stringify(stats, null, 2));
"

# 最新10件のトレースを表示
node -e "
const { TraceStore } = require('./.claude/lib/trace-store.ts');
const store = new TraceStore(process.cwd());
const traces = store.list(10);
traces.forEach(t => {
  console.log(\`[\${t.timestamp}] \${t.files.map(f => f.path).join(', ')}\`);
});
"

# src/api/auth.ts のトレース履歴を表示
node -e "
const { TraceStore } = require('./.claude/lib/trace-store.ts');
const store = new TraceStore(process.cwd());
const traces = store.findByFile('src/api/auth.ts');
console.log(JSON.stringify(traces, null, 2));
"

┌─────────────────────────────────────────────────────────────┐
│  自動トレース記録フロー                                     │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Claude Code (Edit/Write)                                   │
│       │                                                     │
│       ▼                                                     │
│  PostToolUse Hook                                           │
│  (.claude/hooks/agent-trace-capture.js)                     │
│       │                                                     │
│       ▼                                                     │
│  Trace Record 生成                                          │
│  - ファイルパス                                             │
│  - 貢献者タイプ（ai）                                       │
│  - モデル情報                                               │
│  - タイムスタンプ                                           │
│  - Git commit/branch                                        │
│       │                                                     │
│       ▼                                                     │
│  .agent-trace/traces/*.json に保存                          │
│                                                             │
└─────────────────────────────────────────────────────────────┘

{
  "version": "0.1.0",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2026-02-04T12:00:00Z",
  "files": [
    {
      "path": "src/utils/helper.ts",
      "conversations": [
        {
          "contributor_type": "ai",
          "model": "anthropic/claude-opus-4-5-20251101",
          "ranges": [{ "start_line": 1, "end_line": -1 }],
          "description": "Edit: text replacement"
        }
      ]
    }
  ],
  "vcs": {
    "type": "git",
    "commit": "abc123...",
    "branch": "main"
  },
  "tool": {
    "name": "taisun-agent",
    "version": "2.10.1"
  },
  "metadata": {
    "dev.taisun": {
      "hook": "agent-trace-capture",
      "tool_used": "Edit"
    }
  }
}

.agent-trace/
├── traces/           # アクティブなトレースファイル
│   ├── 2026-02-04_abc123.json
│   ├── 2026-02-04_def456.json
│   └── ...
└── archive/          # アーカイブ済みトレース
    └── 2026-01-*.json