claude-code-conductor 2.20.0__tar.gz → 2.22.0__tar.gz

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/.claude/hooks/select_tier.py

@@ -323,6 +323,7 @@ def write_tier_selection(
     escalation_reason: str | None = None,
     prompt_prefix: str | None = None,
     prompt_hash: str | None = None,
+    session_id: str | None = None,
 ) -> None:
     """直近の選択結果を ``tier_selection.json`` に書く。
 
@@ -335,6 +336,9 @@ def write_tier_selection(
 
     ``escalated`` / ``escalation_reason`` を任意で含める。
     failure rate に基づく昇格が起きた場合のみ True / 文字列が入る。
+
+    ``session_id`` を任意で含める。UserPromptSubmit payload の session UUID。
+    None のときは tier_selection.json のキー自体を省略する（後方互換）。
     """
     os.makedirs(os.path.dirname(TIER_SELECTION_PATH), exist_ok=True)
     payload: dict[str, object] = {
@@ -354,6 +358,8 @@ def write_tier_selection(
         payload["prompt_prefix"] = prompt_prefix
     if prompt_hash is not None:
         payload["prompt_hash"] = prompt_hash
+    if session_id is not None:
+        payload["session_id"] = session_id
     try:
         with open(TIER_SELECTION_PATH, "w", encoding="utf-8") as f:
             json.dump(payload, f, ensure_ascii=False)
@@ -415,6 +421,8 @@ def main() -> int:
     if not isinstance(prompt, str) or not prompt.strip():
         return 0
 
+    session_id = payload.get("session_id")
+
     # Phase 2-C: 類似度推定で complexity を補強
     heuristic_complexity = estimate_complexity(prompt)
     strong_complexity, weak_matches = similarity_boost(prompt)
@@ -448,6 +456,7 @@ def main() -> int:
         escalated=escalated, escalation_reason=escalation_reason,
         prompt_prefix=prompt_prefix,
         prompt_hash=prompt_hash,
+        session_id=session_id,
     )
 
     context_text = build_additional_context(

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/.claude/hooks/session_stop.py

@@ -89,6 +89,23 @@ def main() -> int:
     except Exception as e:
         print(f"[session_stop:consolidate_memory] failed: {e}", file=sys.stderr)
 
+    # Phase 3: usage_ingester — セッションログからコスト集計データを ingestion
+    # worktree session では起動しない（stop.run の is_worktree 判定と整合）
+    # 安全側動作: session_utils ロード失敗時や is_worktree 判定失敗時は ingester をスキップする。
+    # worktree 判定不能で誤起動するより skip を優先（except Exception で捕捉 → 早期終了）。
+    try:
+        session_utils_module = _load_module("session_utils")
+        if not session_utils_module.is_worktree(os.getcwd()):
+            session_id = payload.get("session_id")
+            transcript_path = payload.get("transcript_path")
+            if session_id and transcript_path:
+                from pathlib import Path as _Path  # noqa: PLC0415
+                from c3.usage_ingester import ingest_session  # noqa: PLC0415
+                project_dir = _Path(transcript_path).parent
+                ingest_session(session_id=session_id, project_dir=project_dir)
+    except Exception as e:
+        print(f"[session_stop:usage_ingester] failed: {type(e).__name__}", file=sys.stderr)
+
     return 0
 
 

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/.claude/skills/dev-workflow/scripts/record_tier_outcome.py

@@ -210,15 +210,19 @@ def main(argv: list[str] | None = None) -> int:
     # Phase 2-B: tier_recent_outcomes にも 1 件記録（escalation 判定の母数）。
     # tier_bandit 更新が失敗してもこちらは試みる（DB が一時的に詰まる程度なら
     # 片方だけ通る可能性もある）。
+    # v2.22.0: session_id を渡して cost 紐づけを可能にする。
+    # session_id キーが無い古い tier_selection.json の場合は None になる（後方互換）。
+    session_id = selection.get("session_id")
     try:
         c3_db.record_tier_recent_outcome(
             complexity=selection["complexity"],
             tier=selection["tier"],
             success=success,
+            session_id=session_id,
         )
     except Exception as exc:  # noqa: BLE001
         print(
-            f"[record_tier_outcome] tier_recent_outcomes record skipped: {exc}",
+            f"[record_tier_outcome] tier_recent_outcomes record skipped: {type(exc).__name__}",
             file=sys.stderr,
         )
 

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/CHANGELOG.md

@@ -1,5 +1,65 @@
 # Changelog
 
+## [2.22.0] - 2026-05-25
+
+**tier-routing cost 紐づけデータ蓄積**: tier_recent_outcomes に session_id 列を追加し、agent_cost_runs と JOIN できるデータ基盤を整備する。`c3 tier stats` に complexity×tier 別の平均コストセクションを追加する。cost-aware routing 本体は v2.23.0。
+
+**スコープ注記**: 単価テーブル自動更新は公式 price API が非提供のため pricing.py の手動メンテ継続。tier_bandit の total_cost_usd / cost_samples 列は v2.23.0 用に確保のみ（書き込み・読み出しなし）。
+
+### 機能追加
+
+- **`src/c3/migrations/003_tier_cost.sql`（新規）**: `tier_recent_outcomes` に `session_id TEXT` 列と `idx_tier_recent_session` インデックスを追加。`tier_bandit` に `total_cost_usd REAL DEFAULT 0.0` / `cost_samples INTEGER DEFAULT 0` 列を追加（v2.23.0 用確保のみ）。既存データは ADD COLUMN DEFAULT で保持（破壊的変更なし）。
+
+- **`src/c3/db.py`: `record_tier_recent_outcome` に `session_id` 追加**: kw-only 引数 `session_id: str | None = None` を追加。既存呼び出しは後方互換（省略時 NULL 保存）。
+
+- **`src/c3/db.py`: `read_tier_cost_summary` 追加**: tier_recent_outcomes × agent_cost_runs を session_id で JOIN し、complexity×tier 別の sessions / total_cost_usd / avg_cost_usd を返す。2 段 CTE で session コストの 1 session 内重複計上を防ぐ（mainline 除外・session 単位 SUM → DISTINCT JOIN）。テーブル不在・データ不在・session_id 全 NULL で `[]`。
+
+- **`.claude/hooks/select_tier.py`: session_id 記録**: UserPromptSubmit payload から session_id を取得し tier_selection.json に追記。session_id が None のときはキーを省略（既存テスト互換）。
+
+- **`.claude/skills/dev-workflow/scripts/record_tier_outcome.py`: session_id 受け渡し**: tier_selection.json から session_id を読み `record_tier_recent_outcome` に渡す。session_id キーが無い古い json でも動作（None として扱う）。
+
+- **`c3 tier stats` に Tier 別平均コストセクション追加**: `_collect_snapshot()` に `read_tier_cost_summary()` の結果を `tier_cost` キーで追加。human 表示に「Tier 別平均コスト（粗い概算 / 精度向上は v2.23.0）」セクションを追加。tier_cost が空のときは「（cost 紐づけデータ未収集）」と表示。`--json` 出力の `tier_cost` キーにも自動反映。
+
+### 変更
+
+- **`src/c3/__init__.py`**: `__version__` を `"2.21.0"` から `"2.22.0"` に更新。
+
+- **注記更新**: `c3 tier stats` の「cost-aware routing は v2.22.0 予定」を「データ紐づけ蓄積。cost-aware routing 本体は v2.23.0 予定」へ更新。
+
+## [2.21.0] - 2026-05-25
+
+**tier-routing コスト統合（データ収集基盤）**: Claude Code セッションログ（`~/.claude/projects/<slug>/<session>.jsonl` + subagent jsonl）を読み込み、モデル単価で USD 換算して c3.db に蓄積するデータ収集基盤を整備する。将来の cost-aware routing（v2.22.0）の土台。
+
+**スコープ注記**: 本リリースはデータ収集基盤のみ。cost-aware routing と tier_bandit のコスト列は v2.22.0 予定。
+
+### 機能追加
+
+- **`src/c3/pricing.py`（新規）**: Claude API モデルの USD/MTok 単価から token コストを計算する純関数モジュール。
+  `resolve_tier(model)`・`compute_cost_usd(...) -> tuple[float, bool]`・`known_models()` を提供。
+  Opus は世代で単価が 3 倍異なる（4.1/4=$15 系、4.5/4.6/4.7=$5 系）ため、具体パターン優先マッチ → tier 部分一致 fallback の 2 段構成を採用。
+  単価は 2026-05-25 公式取得値（出典 URL を docstring に明記）。
+
+- **`src/c3/migrations/002_agent_cost_runs.sql`（新規）**: `agent_cost_runs` テーブル・`usage_ingest_state` テーブル・インデックスを追加する migration。
+  PK=(session_id, agent_id, model) で「1 エージェント × 1 モデル = 1 行」の集約設計。
+  既存 event-based `agent_runs`（001）は一切変更しない。
+
+- **`src/c3/usage_ingester.py`（新規）**: セッションログ取り込みモジュール。
+  公開 API `ingest_session(*, session_id, project_dir, db_path=None) -> IngestResult`。
+  mainline / subagent jsonl を走査し、model 単位でトークンを合算して `insert_agent_cost_run` で upsert する。
+  session_id UUID validate・パストラバーサル防止・symlink スキップ・例外 type 名のみログ（SR-R-001 準拠）。
+
+- **`.claude/hooks/session_stop.py` Phase 3 追加**: セッション終了時に `ingest_session` を呼ぶ Phase 3 を追加。
+  worktree session では起動しない。例外握りつぶしで exit 0 を維持する。
+
+- **`c3 tier stats` の Agent 別コスト集計セクション追加**: `_collect_snapshot()` に `read_agent_cost_summary()` を追加し、human / JSON 両出力に `agent_cost` セクションを表示する。
+  mainline 行には「（マクロ集計・tier 学習対象外）」を明示。0 件のときは「（コストデータ未収集）」を表示。
+
+### 変更
+
+- **`src/c3/db.py`**: 4 ヘルパー追加（`insert_agent_cost_run` / `read_agent_cost_summary` / `get_ingest_offset` / `set_ingest_offset`）。既存 tier ヘルパー規約（DB 不在で静かに False/0/[]・WAL・busy_timeout）に準拠。
+
+- **`src/c3/__init__.py`**: `__version__` を `"2.20.0"` から `"2.21.0"` に更新。
+
 ## [2.20.0] - 2026-05-25
 
 **SQLite schema migration 枠組み導入**: `.claude/hooks/schema.sql` の「冪等 DDL 一発実行」から、`src/c3/migrations/` の「連番 NNN_xxx.sql migration runner」へ移行する基盤を整備する。

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.20.0
+Version: 2.22.0
 Summary: Multi-agent orchestration framework for Claude Code with Codex/Cursor adapters (C3)
 Project-URL: Homepage, https://github.com/satoh-y-0323/claude-code-conductor
 Project-URL: Repository, https://github.com/satoh-y-0323/claude-code-conductor

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/src/c3/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Conductor (C3) - multi-agent orchestration framework for Claude Code."""
 
-__version__ = "2.20.0"
+__version__ = "2.22.0"

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/src/c3/cli_tier.py

@@ -89,7 +89,7 @@ def handle_stats(args: argparse.Namespace) -> int:
 
 
 def _collect_snapshot(db_path, recent_limit: int) -> dict[str, Any]:
-    """DB から tier_bandit / tier_recent_outcomes を読み snapshot dict を返す。"""
+    """DB から tier_bandit / tier_recent_outcomes / agent_cost / tier_cost を読み snapshot dict を返す。"""
     bandit_rows: list[dict[str, Any]] = []
     total_trials = 0
 
@@ -114,6 +114,10 @@ def _collect_snapshot(db_path, recent_limit: int) -> dict[str, Any]:
         db_path=db_path,
     )
 
+    agent_cost: list[dict[str, Any]] = c3_db.read_agent_cost_summary(db_path=db_path)
+
+    tier_cost: list[dict[str, Any]] = c3_db.read_tier_cost_summary(db_path=db_path)
+
     if total_trials < _LEARNING_THRESHOLD:
         mode = "uniform"
     else:
@@ -127,6 +131,8 @@ def _collect_snapshot(db_path, recent_limit: int) -> dict[str, Any]:
         },
         "tier_bandit": bandit_rows,
         "recent_outcomes": recent_outcomes,
+        "agent_cost": agent_cost,
+        "tier_cost": tier_cost,
     }
 
 
@@ -166,3 +172,40 @@ def _render_human(snapshot: dict[str, Any]) -> None:
     print("== 学習データ記録チャネル ==")
     print("記録元: dev-workflow フェーズ E の最終承認時のみ（record_tier_outcome.py）")
     print("直接指示作業ではデータが溜まりません（設計通り）")
+    print()
+
+    print("== Agent 別コスト集計（agent_cost_runs） ==")
+    agent_cost = snapshot.get("agent_cost", [])
+    if not agent_cost:
+        print("（コストデータ未収集）")
+    else:
+        print(
+            f"{'agent_type':<16} {'runs':>5}  {'total_usd':>10}  "
+            f"{'in_tok':>9}  {'out_tok':>9}  {'cache_r':>9}  {'cache_w':>9}"
+        )
+        for row in agent_cost:
+            note = "  （マクロ集計・tier 学習対象外）" if row["agent_type"] == "mainline" else ""
+            print(
+                f"{row['agent_type']:<16} {row['runs']:>5}  "
+                f"${row['total_cost_usd']:>9.4f}  "
+                f"{row['input_tokens']:>9}  {row['output_tokens']:>9}  "
+                f"{row['cache_read_tokens']:>9}  {row['cache_create_tokens']:>9}"
+                f"{note}"
+            )
+    print()
+
+    print("== Tier 別平均コスト（粗い概算 / 精度向上は v2.23.0） ==")
+    tier_cost = snapshot.get("tier_cost", [])
+    if not tier_cost:
+        print("（cost 紐づけデータ未収集）")
+    else:
+        print(f"{'complexity':<12} {'tier':<8} {'sessions':>8}  {'avg_usd':>10}  {'total_usd':>10}")
+        for row in tier_cost:
+            print(
+                f"{row['complexity']:<12} {row['tier']:<8} "
+                f"{row['sessions']:>8}  "
+                f"${row['avg_cost_usd']:>9.4f}  "
+                f"${row['total_cost_usd']:>9.4f}"
+            )
+    print()
+    print("（注: データ紐づけ蓄積。cost-aware routing 本体は v2.23.0 予定）")

{claude_code_conductor-2.20.0 → claude_code_conductor-2.22.0}/src/c3/db.py

@@ -358,12 +358,21 @@ def record_tier_recent_outcome(
     tier: str,
     success: bool,
     db_path: Path | None = None,
+    session_id: str | None = None,
 ) -> bool:
     """``tier_recent_outcomes`` に 1 件 INSERT する。
 
     Phase 2-B のエスカレーション判定用。tier_bandit の累積 α/β とは別に、
     直近 N 件の event を時系列で保持する。
 
+    Args:
+        complexity: 'simple' | 'medium' | 'complex'。
+        tier: 'haiku' | 'sonnet' | 'opus'。
+        success: True なら成功、False なら失敗。
+        db_path: c3.db のパス。省略時は :func:`locate_c3_db` で探索。
+        session_id: セッション UUID（v2.22.0+）。省略時は NULL で保存。
+            cost 紐づけに使用。None の場合は既存行との後方互換を維持する。
+
     Returns:
         INSERT 成功時 True、DB 不在 / エラー時 False。
     """
@@ -382,15 +391,15 @@ def record_tier_recent_outcome(
             _apply_busy_timeout(conn)
             conn.execute(
                 "INSERT INTO tier_recent_outcomes "
-                "(task_complexity, tier, success, ts) VALUES (?, ?, ?, ?)",
-                (complexity, tier, 1 if success else 0, now_iso),
+                "(task_complexity, tier, success, ts, session_id) VALUES (?, ?, ?, ?, ?)",
+                (complexity, tier, 1 if success else 0, now_iso, session_id),
             )
             conn.commit()
         finally:
             conn.close()
         return True
     except Exception as exc:  # noqa: BLE001
-        logger.warning("failed to record tier_recent_outcome: %s", exc)
+        logger.warning("failed to record tier_recent_outcome: %s", type(exc).__name__)
         return False
 
 
@@ -493,3 +502,343 @@ def read_tier_failure_rate(
 
     failures = sum(1 for r in rows if r[0] == 0)
     return failures / sample_count, sample_count
+
+
+# ---------------------------------------------------------------------------
+# usage-ingester: agent_cost_runs / usage_ingest_state ヘルパー（v2.21.0）
+# ---------------------------------------------------------------------------
+
+
+def insert_agent_cost_run(
+    *,
+    session_id: str,
+    agent_id: str,
+    agent_type: str,
+    description: str | None,
+    model: str,
+    attribution_skill: str | None,
+    input_tokens: int,
+    output_tokens: int,
+    cache_read_tokens: int,
+    cache_create_tokens: int,
+    total_cost_usd: float,
+    db_path: Path | None = None,
+) -> bool:
+    """agent_cost_runs に 1 行 upsert する。
+
+    PK=(session_id, agent_id, model) で「1 エージェント × 1 モデル = 1 行」。
+    同一 PK が既に存在する場合は全数値列・total_cost_usd・recorded_at を最新合算値に上書き。
+
+    Args:
+        session_id: セッション UUID。
+        agent_id: 'agent-<id>' または 'mainline'。
+        agent_type: meta.json の agentType / 'mainline'。
+        description: meta.json の description（任意）。
+        model: message.model 文字列。
+        attribution_skill: assistant レコードの attributionSkill（任意）。
+        input_tokens: 入力トークン数（jsonl 内合算値）。
+        output_tokens: 出力トークン数（jsonl 内合算値）。
+        cache_read_tokens: キャッシュ読み込みトークン数（jsonl 内合算値）。
+        cache_create_tokens: キャッシュ書き込みトークン数（jsonl 内合算値）。
+        total_cost_usd: compute_cost_usd が返した USD コスト。
+        db_path: c3.db のパス。省略時は locate_c3_db() で探索。
+
+    Returns:
+        upsert 成功時 True、DB 不在 / sqlite3.Error 時は静かに False。
+    """
+    if db_path is None:
+        db_path = locate_c3_db()
+        if db_path is None:
+            return False
+
+    from datetime import timezone as _tz  # noqa: PLC0415
+    now_iso = datetime.now(_tz.utc).isoformat(timespec="seconds")
+
+    try:
+        conn = sqlite3.connect(str(db_path))
+        try:
+            conn.execute("PRAGMA journal_mode=WAL")
+            _apply_busy_timeout(conn)
+            conn.execute(
+                "INSERT INTO agent_cost_runs "
+                "(session_id, agent_id, agent_type, description, model, "
+                " attribution_skill, input_tokens, output_tokens, "
+                " cache_read_tokens, cache_create_tokens, "
+                " total_cost_usd, recorded_at) "
+                "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) "
+                "ON CONFLICT(session_id, agent_id, model) DO UPDATE SET "
+                "  agent_type = excluded.agent_type, "
+                "  description = excluded.description, "
+                "  attribution_skill = excluded.attribution_skill, "
+                "  input_tokens = excluded.input_tokens, "
+                "  output_tokens = excluded.output_tokens, "
+                "  cache_read_tokens = excluded.cache_read_tokens, "
+                "  cache_create_tokens = excluded.cache_create_tokens, "
+                "  total_cost_usd = excluded.total_cost_usd, "
+                "  recorded_at = excluded.recorded_at",
+                (
+                    session_id, agent_id, agent_type, description, model,
+                    attribution_skill, input_tokens, output_tokens,
+                    cache_read_tokens, cache_create_tokens,
+                    total_cost_usd, now_iso,
+                ),
+            )
+            conn.commit()
+        finally:
+            conn.close()
+        return True
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("failed to insert_agent_cost_run: %s", type(exc).__name__)
+        return False
+
+
+def read_agent_cost_summary(
+    *,
+    db_path: Path | None = None,
+    limit: int = 50,
+) -> list[dict]:
+    """agent_cost_runs を agent_type 別に集計した結果を返す。
+
+    SELECT agent_type, COUNT(*) runs, SUM(total_cost_usd), SUM(input_tokens),
+    SUM(output_tokens), SUM(cache_read_tokens), SUM(cache_create_tokens)
+    FROM agent_cost_runs GROUP BY agent_type ORDER BY total_cost_usd DESC LIMIT ?
+
+    Args:
+        db_path: c3.db のパス。省略時は locate_c3_db() で探索。
+        limit: 返す最大件数（デフォルト 50）。
+
+    Returns:
+        各行を dict にしたリスト。キー:
+        ``agent_type`` / ``runs`` / ``total_cost_usd`` /
+        ``input_tokens`` / ``output_tokens`` /
+        ``cache_read_tokens`` / ``cache_create_tokens``。
+        DB 不在 / テーブル不在 / エラー時は空リスト。
+    """
+    if db_path is None:
+        db_path = locate_c3_db()
+        if db_path is None:
+            return []
+
+    try:
+        conn = sqlite3.connect(str(db_path))
+        try:
+            # WAL は書き込みヘルパー呼び出し時または migrate 時に設定済みの前提
+            # （既存 read_recent_outcomes 等の read ヘルパーと同方針 / CR-M-001）
+            _apply_busy_timeout(conn)
+            rows = conn.execute(
+                "SELECT agent_type, "
+                "       COUNT(*) AS runs, "
+                "       SUM(total_cost_usd) AS total_cost_usd, "
+                "       SUM(input_tokens) AS input_tokens, "
+                "       SUM(output_tokens) AS output_tokens, "
+                "       SUM(cache_read_tokens) AS cache_read_tokens, "
+                "       SUM(cache_create_tokens) AS cache_create_tokens "
+                "FROM agent_cost_runs "
+                "GROUP BY agent_type "
+                "ORDER BY total_cost_usd DESC "
+                "LIMIT ?",
+                (limit,),
+            ).fetchall()
+        finally:
+            conn.close()
+    except sqlite3.OperationalError as exc:
+        # テーブル不在（no such table）は [] を返す（DB 未初期化でも止めない）
+        logger.debug(
+            "read_agent_cost_summary: table not found or inaccessible: %s",
+            type(exc).__name__,
+        )
+        return []
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("read_agent_cost_summary: unexpected error: %s", type(exc).__name__)
+        return []
+
+    return [
+        {
+            "agent_type": row[0],
+            "runs": row[1],
+            "total_cost_usd": row[2],
+            "input_tokens": row[3],
+            "output_tokens": row[4],
+            "cache_read_tokens": row[5],
+            "cache_create_tokens": row[6],
+        }
+        for row in rows
+    ]
+
+
+def read_tier_cost_summary(
+    *,
+    db_path: Path | None = None,
+) -> list[dict]:
+    """tier_recent_outcomes × agent_cost_runs を session_id で JOIN し、
+    complexity×tier 別コストを返す（粗い概算 / 精度向上は v2.23.0）。
+
+    2 段 CTE で重複計上を防ぐ:
+      - ``session_cost`` CTE: agent_cost_runs を mainline 除外しつつ
+        session_id 単位で SUM（1 session = 1 行）→ cost の重複計上を構造的に防ぐ
+      - ``outcome_sessions`` CTE: tier_recent_outcomes を
+        (session_id, task_complexity, tier) で DISTINCT 化。
+        session_id が NULL（v2.22.0 移行前行）は除外
+      - JOIN して complexity×tier 別に sessions / total_cost_usd / avg_cost_usd を算出
+
+    既知の不正確性（v2.22.0 許容・精度向上は v2.23.0）:
+      - session が複数の (complexity, tier) outcome を持つ場合、同一 session の cost が
+        複数の (complexity,tier) 行に重複加算されうる（1 session 内での cost 重複は防ぐが、
+        複数 outcome を持つ session の cross-outcome 重複は未解決）
+      - cost は session 全体の non-mainline 合計であり、特定 tier の model 行に限定しない
+      - agent_id 単位の紐づけはしていない
+
+    Args:
+        db_path: c3.db のパス。省略時は :func:`locate_c3_db` で探索。
+
+    Returns:
+        各行を dict にしたリスト。キー:
+        ``complexity``(str) / ``tier``(str) / ``sessions``(int) /
+        ``total_cost_usd``(float) / ``avg_cost_usd``(float)。
+        ORDER BY total_cost_usd DESC。
+        テーブル不在 / データ不在 / session_id 全 NULL / JOIN 0 行 /
+        DB 不在 / エラー時は空リストを返す。
+    """
+    if db_path is None:
+        db_path = locate_c3_db()
+        if db_path is None:
+            return []
+
+    try:
+        conn = sqlite3.connect(str(db_path))
+        try:
+            # WAL は書き込みヘルパー呼び出し時または migrate 時に設定済みの前提
+            # （read_agent_cost_summary 等の read ヘルパーと同方針 / CR-M-001）
+            _apply_busy_timeout(conn)
+            rows = conn.execute(
+                "WITH session_cost AS ("
+                "    SELECT session_id,"
+                "           SUM(total_cost_usd) AS session_cost_usd"
+                "    FROM agent_cost_runs"
+                "    WHERE agent_type <> 'mainline'"
+                "    GROUP BY session_id"
+                "),"
+                "outcome_sessions AS ("
+                "    SELECT DISTINCT session_id, task_complexity, tier"
+                "    FROM tier_recent_outcomes"
+                "    WHERE session_id IS NOT NULL"
+                ") "
+                "SELECT o.task_complexity            AS complexity,"
+                "       o.tier                       AS tier,"
+                "       COUNT(DISTINCT o.session_id) AS sessions,"
+                "       SUM(sc.session_cost_usd)     AS total_cost_usd,"
+                "       SUM(sc.session_cost_usd) / COUNT(DISTINCT o.session_id)"
+                "           AS avg_cost_usd "
+                "FROM outcome_sessions o "
+                "JOIN session_cost sc ON sc.session_id = o.session_id "
+                "GROUP BY o.task_complexity, o.tier "
+                "ORDER BY total_cost_usd DESC"
+            ).fetchall()
+        finally:
+            conn.close()
+    except sqlite3.OperationalError as exc:
+        # テーブル不在（no such table）は [] を返す（DB 未初期化でも止めない）
+        logger.debug(
+            "read_tier_cost_summary: table not found or inaccessible: %s",
+            type(exc).__name__,
+        )
+        return []
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("read_tier_cost_summary: unexpected error: %s", type(exc).__name__)
+        return []
+
+    return [
+        {
+            "complexity": row[0],
+            "tier": row[1],
+            "sessions": int(row[2]),
+            "total_cost_usd": float(row[3]) if row[3] is not None else 0.0,
+            "avg_cost_usd": float(row[4]) if row[4] is not None else 0.0,
+        }
+        for row in rows
+    ]
+
+
+def get_ingest_offset(
+    file_key: str,
+    *,
+    db_path: Path | None = None,
+) -> int:
+    """usage_ingest_state から処理済み行数（offset）を返す。
+
+    Args:
+        file_key: '<session>:mainline' / '<session>:agent-<id>'。
+        db_path: c3.db のパス。省略時は locate_c3_db() で探索。
+
+    Returns:
+        処理済み行数。行・テーブル不在・DB 不在は 0 を返す。
+    """
+    if db_path is None:
+        db_path = locate_c3_db()
+        if db_path is None:
+            return 0
+
+    try:
+        conn = sqlite3.connect(str(db_path))
+        try:
+            # WAL は書き込みヘルパー呼び出し時または migrate 時に設定済みの前提
+            # （既存 read_recent_outcomes 等の read ヘルパーと同方針 / CR-M-001）
+            _apply_busy_timeout(conn)
+            row = conn.execute(
+                "SELECT last_offset FROM usage_ingest_state WHERE file_key = ?",
+                (file_key,),
+            ).fetchone()
+        finally:
+            conn.close()
+    except Exception as exc:  # noqa: BLE001
+        logger.debug("get_ingest_offset: %s", type(exc).__name__)
+        return 0
+
+    return row[0] if row is not None else 0
+
+
+def set_ingest_offset(
+    file_key: str,
+    offset: int,
+    *,
+    db_path: Path | None = None,
+) -> bool:
+    """usage_ingest_state に offset を upsert する。
+
+    Args:
+        file_key: '<session>:mainline' / '<session>:agent-<id>'。
+        offset: 処理済み行数（= 次回開始行）。
+        db_path: c3.db のパス。省略時は locate_c3_db() で探索。
+
+    Returns:
+        upsert 成功時 True、DB 不在 / エラー時は静かに False。
+    """
+    if db_path is None:
+        db_path = locate_c3_db()
+        if db_path is None:
+            return False
+
+    from datetime import timezone as _tz  # noqa: PLC0415
+    now_iso = datetime.now(_tz.utc).isoformat(timespec="seconds")
+
+    try:
+        conn = sqlite3.connect(str(db_path))
+        try:
+            conn.execute("PRAGMA journal_mode=WAL")
+            _apply_busy_timeout(conn)
+            conn.execute(
+                "INSERT INTO usage_ingest_state "
+                "(file_key, last_offset, last_processed_at) "
+                "VALUES (?, ?, ?) "
+                "ON CONFLICT(file_key) DO UPDATE SET "
+                "  last_offset = excluded.last_offset, "
+                "  last_processed_at = excluded.last_processed_at",
+                (file_key, offset, now_iso),
+            )
+            conn.commit()
+        finally:
+            conn.close()
+        return True
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("failed to set_ingest_offset: %s", type(exc).__name__)
+        return False

claude_code_conductor-2.22.0/src/c3/migrations/002_agent_cost_runs.sql

@@ -0,0 +1,41 @@
+-- C3 SQLite migration 002: agent_cost_runs / usage_ingest_state テーブル追加
+--
+-- セッションログ（~/.claude/projects/<slug>/<session>.jsonl + subagents/）から
+-- モデル別トークン消費を USD 換算して蓄積するコスト収集基盤テーブルを定義する。
+--
+-- PK=(session_id, agent_id, model) で「1 エージェント × 1 モデル = 1 行」。
+-- jsonl 内の複数 requestId は ingester（usage_ingester.py）が合算 upsert する。
+--
+-- usage_ingest_state は jsonl ごとの処理済み行数 offset を管理する。
+-- file_key = '<session>:mainline' / '<session>:agent-<id>'
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS agent_cost_runs (
+  session_id          TEXT NOT NULL,
+  agent_id            TEXT NOT NULL,              -- 'agent-<id>' / mainline は 'mainline'
+  agent_type          TEXT NOT NULL,              -- meta.json agentType / 'mainline'
+  description         TEXT,
+  model               TEXT NOT NULL,              -- message.model
+  attribution_skill   TEXT,
+  input_tokens        INTEGER NOT NULL DEFAULT 0,
+  output_tokens       INTEGER NOT NULL DEFAULT 0,
+  cache_read_tokens   INTEGER NOT NULL DEFAULT 0,
+  cache_create_tokens INTEGER NOT NULL DEFAULT 0,
+  total_cost_usd      REAL NOT NULL,
+  recorded_at         TEXT NOT NULL,              -- ISO8601 UTC
+  PRIMARY KEY (session_id, agent_id, model)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_cost_runs_agent_type
+  ON agent_cost_runs(agent_type, recorded_at);
+
+CREATE TABLE IF NOT EXISTS usage_ingest_state (
+  file_key            TEXT PRIMARY KEY,           -- '<session>:mainline' / '<session>:agent-<id>'
+  last_offset         INTEGER NOT NULL,           -- 処理済み行数
+  last_processed_at   TEXT NOT NULL               -- ISO8601 UTC
+);
+
+INSERT OR IGNORE INTO schema_migrations (version) VALUES ('002');
+
+COMMIT;