claude-code-conductor 2.24.0__tar.gz → 2.25.0__tar.gz

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/.claude/hooks/select_tier.py

@@ -27,6 +27,7 @@ import collections
 import difflib
 import hashlib
 import json
+import math
 import os
 import random
 import re
@@ -47,8 +48,10 @@ except AttributeError:
 try:
     from c3 import db as _c3_db_const  # type: ignore[import-not-found]
     LEARNING_THRESHOLD: int = _c3_db_const.LEARNING_THRESHOLD
+    EPSILON: float = _c3_db_const.EPSILON_TIEBREAK
 except ImportError:
     LEARNING_THRESHOLD = 30
+    EPSILON = 0.05
 
 # 複雑度推定のキーワード
 SIMPLE_KEYWORDS = frozenset({
@@ -111,10 +114,9 @@ _PROMPT_HISTORY_SCAN_LINES = 1000
 
 TIERS: tuple[str, ...] = ("haiku", "sonnet", "opus")
 
-# cost-aware tie-break の拮抗判定閾値（v2.23.0）。
+# cost-aware tie-break の拮抗判定閾値（v2.23.0・SSOT は db.EPSILON_TIEBREAK）。
 # Beta サンプルは 0〜1 スケール。成功率 5pt 以内＝実質同等とみなす拮抗判定閾値。
-# 過大は成功率犠牲リスク、過小は無発動。調整可能化は v2.24.0。
-EPSILON: float = 0.05
+# 過大は成功率犠牲リスク、過小は無発動。C3_TIER_EPSILON env で上書き可（v2.25.0）。
 
 
 class SelectionResult(NamedTuple):
@@ -295,6 +297,7 @@ def select_tier_detailed(
     *,
     rng: random.Random | None = None,
     cost_map: dict[str, float] | None = None,
+    epsilon: float | None = None,
 ) -> SelectionResult:
     """Beta サンプリングまたは uniform 選択で推奨 Tier を SelectionResult で返す。
 
@@ -307,6 +310,7 @@ def select_tier_detailed(
             含む完全な dict」のいずれか。partial dict は渡されない前提
             （呼び出し側が全 TIERS 分を構築して保証する）。
             uniform 分岐では cost_map の有無に関わらず完全無視する（探索保護）。
+        epsilon: 拮抗判定閾値。None なら module 定数 EPSILON を使う（C3_TIER_EPSILON で上書き可）。
 
     Returns:
         SelectionResult（tier, mode, cost_tiebreak, contenders）。
@@ -323,7 +327,8 @@ def select_tier_detailed(
         tier: rng.betavariate(p[0], p[1])
         for tier, p in params.items()
     }
-    chosen, did_tiebreak, contenders = _cost_tiebreak(samples, cost_map)
+    eff_epsilon = epsilon if epsilon is not None else EPSILON
+    chosen, did_tiebreak, contenders = _cost_tiebreak(samples, cost_map, epsilon=eff_epsilon)
     return SelectionResult(chosen, "thompson", did_tiebreak, contenders)
 
 
@@ -332,6 +337,7 @@ def select_tier(
     *,
     rng: random.Random | None = None,
     cost_map: dict[str, float] | None = None,
+    epsilon: float | None = None,
 ) -> tuple[str, str]:
     """Beta サンプリングまたは uniform 選択で推奨 Tier を返す。
 
@@ -343,13 +349,14 @@ def select_tier(
             None なら cost を見ず従来の Thompson Sampling と完全一致。
             uniform 分岐では cost_map の有無に関わらず完全無視する。
             詳細は :func:`select_tier_detailed` を参照。
+        epsilon: 拮抗判定閾値。None なら module 定数 EPSILON を使う。
 
     Returns:
         ``(tier, mode)`` のタプル。``mode`` は ``"thompson"`` / ``"uniform"`` で、
         プロンプトに「学習データ収集中」と表示するかの分岐に使う。
         戻り値型は v2.22.0 以前と完全に不変。
     """
-    result = select_tier_detailed(params, rng=rng, cost_map=cost_map)
+    result = select_tier_detailed(params, rng=rng, cost_map=cost_map, epsilon=epsilon)
     return result.tier, result.mode
 
 
@@ -522,6 +529,41 @@ def _load_c3_db_module():
         return None
 
 
+def _resolve_epsilon() -> float:
+    """``C3_TIER_EPSILON`` を安全に解決する。
+
+    不正値（非数値 / 0 以下 / 1 超 / NaN）は受け付けず、stderr 警告 + デフォルト（EPSILON）に戻す。
+    未設定 / 空文字は無警告でデフォルトを返す（[SR-V-001]）。
+    """
+    raw = os.environ.get("C3_TIER_EPSILON")
+    if raw is None or raw == "":
+        return EPSILON
+    try:
+        x = float(raw)
+    except ValueError:
+        print(
+            f"[select_tier:epsilon] invalid C3_TIER_EPSILON={raw!r}, "
+            f"using default {EPSILON}",
+            file=sys.stderr,
+        )
+        return EPSILON
+    if math.isnan(x):
+        print(
+            f"[select_tier:epsilon] C3_TIER_EPSILON={raw!r} is NaN, "
+            f"using default {EPSILON}",
+            file=sys.stderr,
+        )
+        return EPSILON
+    if x <= 0 or x > 1:
+        print(
+            f"[select_tier:epsilon] C3_TIER_EPSILON={x} out of range (0, 1], "
+            f"using default {EPSILON}",
+            file=sys.stderr,
+        )
+        return EPSILON
+    return x
+
+
 def main() -> int:
     try:
         payload = json.loads(sys.stdin.read())
@@ -576,7 +618,8 @@ def main() -> int:
         except ImportError:
             cost_map = None
 
-    result = select_tier_detailed(params, cost_map=cost_map)
+    eps = _resolve_epsilon()
+    result = select_tier_detailed(params, cost_map=cost_map, epsilon=eps)
     tier, mode = result.tier, result.mode
     cost_tiebreak = result.cost_tiebreak
 

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/.claude/hooks/session_stop.py

@@ -103,6 +103,8 @@ def main() -> int:
                 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)
+                from c3.db import sync_tier_bandit_cost  # noqa: PLC0415
+                sync_tier_bandit_cost()
     except Exception as e:
         print(f"[session_stop:usage_ingester] failed: {type(e).__name__}", file=sys.stderr)
 

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [2.25.0] - 2026-05-26
+
+**tier_bandit cost 蓄積・EPSILON 調整可能化・例外ログ統一**: v2.22.0 で列確保済みの `tier_bandit.total_cost_usd`/`cost_samples` へ実測値を materialize する同期関数を追加。cost-aware tie-break の拮抗判定閾値を定数 SSOT 化し環境変数で上書き可能にする。db.py 既存 6 関数の例外ログを型名統一（SR-R-001）。routing 挙動は不変。cost-weighted Thompson 本格統合は v2.26.0。
+
+### 機能追加
+
+- **`src/c3/db.py`: `sync_tier_bandit_cost(*, db_path=None) -> None`（新規）**: `read_tier_cost_rate_summary` 由来の model 一致集計値を `tier_bandit` テーブルへ materialize する冪等な同期関数。「全クリア(total_cost_usd=0, cost_samples=0) → 集計 SET」の UPDATE-only 実装（INSERT なし）。session_stop の usage ingest 直後に実行。tier_bandit 行が存在しない複合キー (complexity, tier) は無視（INSERT は行わない）。
+
+- **`.claude/hooks/select_tier.py`: `db.EPSILON_TIEBREAK`（0.05）定数 SSOT 化・環境変数 `C3_TIER_EPSILON` 対応**: 従来 `EPSILON=0.05` をモジュールローカルで持っていた値を `c3.db.EPSILON_TIEBREAK` に移し Single Source of Truth 化。`select_tier.py` は `db.EPSILON_TIEBREAK` を参照するよう変更。環境変数 `C3_TIER_EPSILON` に数値が設定されている場合は実行時にその値で上書き可能。NaN・範囲外(0 < x <= 1 の外)・非数値は default 値（0.05）に fallback。env 未設定時の routing 挙動は v2.24.0 と完全一致。
+
+### 変更
+
+- **`src/c3/cli_tier.py`**: `c3 tier stats` の tier_bandit セクションに `total_cost_usd`（合計コスト USD）および `cost_samples`（計上セッション数）列を追加。値は `sync_tier_bandit_cost` 蓄積値を表示。データ未蓄積（0/0）時はセルを「-」表示。
+
+- **`src/c3/db.py`: 例外ログ型名統一（SR-R-001）**: 既存 6 関数 7 箇所の `except Exception as exc` ログを `logger.warning("...: %s", exc)` から `logger.warning("...: %s", type(exc).__name__)` に統一。生 exc message（外部 path・SQL 文・行データ等）の意図しない流出を防止。関数シグネチャ・戻り値・呼び出し元への影響なし。
+
+### 後方互換
+
+- 既存関数シグネチャ不変（`read_tier_params`・`read_tier_cost_rate_summary` 等）。
+- `select_tier_detailed`/`select_tier` の `epsilon` は optional kwarg（省略時 `db.EPSILON_TIEBREAK` を参照）。
+- migration 不要（`tier_bandit` の cost 列は v2.22.0 の 003 migration で確保済み）。
+- **破壊的変更なし**。
+
 ## [2.24.0] - 2026-05-25
 
 **tier-routing cost 精度向上**: tie-break が使う cost データを model 一致集計・USD/MTok レート化により信頼できるものにする。新関数 2 つを追加し、`select_tier` の cost_map 源を rate 関数へ切替。既存関数・tie-break ロジックは完全不変。

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.24.0
+Version: 2.25.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
@@ -201,6 +201,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `c3 recall search "<query>"` または `c3 recall "<query>"` | `.claude/memory/sessions/` 等から類似チャンクを意味検索 |
 | `c3 recall rebuild [--force]` | HNSW インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
 | `c3 recall stats` | チャンク数・モデル名・最終 rebuild 日時を表示 |
+| `c3 tier stats` | tier-routing（複雑度に応じた Tier 自動ルーティング）の学習データ・Tier 別コストを表形式で表示（`--json` で機械可読出力・`--recent N` で直近 outcome 件数指定） |
 
 ### 基本的な使い方
 

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/README.md

@@ -154,6 +154,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `c3 recall search "<query>"` または `c3 recall "<query>"` | `.claude/memory/sessions/` 等から類似チャンクを意味検索 |
 | `c3 recall rebuild [--force]` | HNSW インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
 | `c3 recall stats` | チャンク数・モデル名・最終 rebuild 日時を表示 |
+| `c3 tier stats` | tier-routing（複雑度に応じた Tier 自動ルーティング）の学習データ・Tier 別コストを表形式で表示（`--json` で機械可読出力・`--recent N` で直近 outcome 件数指定） |
 
 ### 基本的な使い方
 

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/src/c3/__init__.py

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

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/src/c3/cli_tier.py

@@ -94,6 +94,11 @@ def _collect_snapshot(db_path, recent_limit: int) -> dict[str, Any]:
     bandit_rows: list[dict[str, Any]] = []
     total_trials = 0
 
+    # cost 列は別 SELECT（read_tier_params は alpha/beta/trials 専用を維持）
+    bandit_cost: dict[tuple[str, str], tuple[float, int]] = c3_db.read_tier_bandit_cost(
+        db_path=db_path,
+    )
+
     for complexity in _COMPLEXITIES:
         params = c3_db.read_tier_params(complexity, db_path=db_path)
         for tier in _TIERS:
@@ -101,6 +106,7 @@ def _collect_snapshot(db_path, recent_limit: int) -> dict[str, Any]:
             total_trials += trials
             denom = alpha + beta
             expected = alpha / denom if denom > 0 else 0.5
+            cost_usd, cost_samples = bandit_cost.get((complexity, tier), (0.0, 0))
             bandit_rows.append({
                 "complexity": complexity,
                 "tier": tier,
@@ -108,6 +114,8 @@ def _collect_snapshot(db_path, recent_limit: int) -> dict[str, Any]:
                 "beta": beta,
                 "trials": trials,
                 "expected_success_rate": expected,
+                "total_cost_usd": cost_usd,
+                "cost_samples": cost_samples,
             })
 
     recent_outcomes: list[dict[str, Any]] = c3_db.read_recent_outcomes(
@@ -154,12 +162,18 @@ def _render_human(snapshot: dict[str, Any]) -> None:
     print()
 
     print("== Tier 別累積（tier_bandit） ==")
-    print(f"{'complexity':<12} {'tier':<8} {'trials':>6}  {'alpha':>5}  {'beta':>5}  {'期待成功率':>10}")
+    print(
+        f"{'complexity':<12} {'tier':<8} {'trials':>6}  {'alpha':>5}  {'beta':>5}  "
+        f"{'期待成功率':>10}  {'cost_usd':>10}  {'cost_samples':>12}"
+    )
     for row in snapshot["tier_bandit"]:
+        complexity_safe = sanitize_terminal_text(str(row["complexity"]))
+        tier_safe = sanitize_terminal_text(str(row["tier"]))
         print(
-            f"{row['complexity']:<12} {row['tier']:<8} "
+            f"{complexity_safe:<12} {tier_safe:<8} "
             f"{row['trials']:>6}  {row['alpha']:>5.2f}  {row['beta']:>5.2f}  "
-            f"{row['expected_success_rate'] * 100:>9.2f}%"
+            f"{row['expected_success_rate'] * 100:>9.2f}%  "
+            f"${row['total_cost_usd']:>9.4f}  {row['cost_samples']:>12}"
         )
     print()
 

{claude_code_conductor-2.24.0 → claude_code_conductor-2.25.0}/src/c3/db.py

@@ -35,6 +35,11 @@ _BUSY_TIMEOUT_MS = BUSY_TIMEOUT_MS  # 内部互換エイリアス（既存コー
 # tier-routing: 学習データ収集期の閾値（合計試行数がこの値未満なら uniform 選択）。
 # SSOT: cli_tier.py / select_tier.py はここから参照する（CR-M-002）。
 LEARNING_THRESHOLD = 30
+# cost-aware tie-break の拮抗判定閾値。Beta サンプルは 0〜1 スケールで、
+# 成功率 5pt（=0.05）以内を拮抗とみなす。本定数が SSOT。
+# 過大にすると成功率を犠牲にするリスク、過小にすると無発動になる。
+# C3_TIER_EPSILON 環境変数で上書き可（v2.25.0）。
+EPSILON_TIEBREAK = 0.05
 
 
 def _apply_busy_timeout(conn: sqlite3.Connection) -> None:
@@ -139,7 +144,7 @@ def fetch_review_decisions(
         finally:
             conn.close()
     except Exception as exc:  # noqa: BLE001
-        logger.warning("failed to fetch review_decisions: %s", exc)
+        logger.warning("failed to fetch review_decisions: %s", type(exc).__name__)
         return []
 
 
@@ -204,7 +209,7 @@ def insert_review_decision(
             conn.close()
         return True
     except Exception as exc:  # noqa: BLE001
-        logger.warning("failed to insert review_decision: %s", exc)
+        logger.warning("failed to insert review_decision: %s", type(exc).__name__)
         return False
 
 
@@ -270,7 +275,7 @@ def read_tier_params(
         finally:
             conn.close()
     except Exception as exc:  # noqa: BLE001
-        logger.warning("failed to read tier_params: %s", exc)
+        logger.warning("failed to read tier_params: %s", type(exc).__name__)
         return defaults
 
     result = dict(defaults)
@@ -342,7 +347,7 @@ def update_tier_params(
             conn.close()
         return True
     except Exception as exc:  # noqa: BLE001
-        logger.warning("failed to update tier_params: %s", exc)
+        logger.warning("failed to update tier_params: %s", type(exc).__name__)
         return False
 
 
@@ -439,10 +444,10 @@ def read_recent_outcomes(
         finally:
             conn.close()
     except sqlite3.OperationalError as exc:
-        logger.debug("read_recent_outcomes: table not found or inaccessible: %s", exc)
+        logger.debug("read_recent_outcomes: table not found or inaccessible: %s", type(exc).__name__)
         return []
     except Exception as exc:  # noqa: BLE001
-        logger.warning("read_recent_outcomes: unexpected error: %s", exc)
+        logger.warning("read_recent_outcomes: unexpected error: %s", type(exc).__name__)
         return []
 
     return [
@@ -493,7 +498,7 @@ def read_tier_failure_rate(
         finally:
             conn.close()
     except Exception as exc:  # noqa: BLE001
-        logger.warning("failed to read tier_failure_rate: %s", exc)
+        logger.warning("failed to read tier_failure_rate: %s", type(exc).__name__)
         return None, 0
 
     sample_count = len(rows)
@@ -1110,3 +1115,118 @@ def set_ingest_offset(
     except Exception as exc:  # noqa: BLE001
         logger.warning("failed to set_ingest_offset: %s", type(exc).__name__)
         return False
+
+
+def read_tier_bandit_cost(
+    *,
+    db_path: Path | None = None,
+) -> dict[tuple[str, str], tuple[float, int]]:
+    """tier_bandit テーブルから cost 列を読む。
+
+    cli_tier.py の _collect_snapshot が alpha/beta/trials（read_tier_params 由来）と
+    別 SELECT で cost を取得するために使う。
+
+    Args:
+        db_path: c3.db のパス。省略時は locate_c3_db() で探索。
+
+    Returns:
+        ``{(task_complexity, tier): (total_cost_usd, cost_samples)}`` の dict。
+        テーブル不在 / DB 不在 / エラー時は空 dict を返す。
+    """
+    if db_path is None:
+        db_path = locate_c3_db()
+        if db_path is None:
+            return {}
+
+    try:
+        conn = sqlite3.connect(str(db_path))
+        try:
+            _apply_busy_timeout(conn)
+            rows = conn.execute(
+                "SELECT task_complexity, tier, total_cost_usd, cost_samples "
+                "FROM tier_bandit"
+            ).fetchall()
+        finally:
+            conn.close()
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("failed to read tier_bandit_cost: %s", type(exc).__name__)
+        return {}
+
+    return {
+        (row[0], row[1]): (float(row[2]), int(row[3]))
+        for row in rows
+    }
+
+
+def sync_tier_bandit_cost(
+    *,
+    db_path: Path | None = None,
+) -> int:
+    """tier_bandit テーブルの cost 列を rate_summary 集計値で同期する（冪等 SET 同期）。
+
+    冪等性: 全行の cost 列を 0.0/0 にクリアしてから SET するため、
+    何度呼び出しても結果が同じになる（全クリア→SET の SET 同期）。
+
+    動作:
+      1. ``read_tier_cost_rate_summary`` で (complexity, tier) 別集計を取得。
+      2. 1 トランザクション内で:
+         a. 全行 cost 列クリア: ``UPDATE tier_bandit SET total_cost_usd=0.0, cost_samples=0``
+            （alpha/beta/trials/last_updated は一切変更しない）。
+         b. 各集計行を ``UPDATE tier_bandit SET total_cost_usd=?, cost_samples=?
+            WHERE task_complexity=? AND tier=?`` で SET。
+            ``cost_samples`` は DISTINCT session 数（``read_tier_cost_rate_summary``
+            の ``sessions`` フィールド）を格納する。
+         c. ``commit()``。クリア後 SET 前に別プロセスが読む瞬間を作らないため
+            途中で commit しない（R1 冪等性保証）。
+      3. UPDATE-only: tier_bandit に行が存在しない (complexity, tier) は INSERT しない。
+         alpha/beta のない半端な bandit 行の生成を防ぐ（R4 回避）。
+
+    制限:
+        USD/MTok レートの再現には billable_tokens が必要であり、本テーブル単独では
+        再現不可。レートが必要な箇所は ``read_tier_cost_rate_summary`` /
+        ``read_tier_cost_rate_for_complexity`` を使うこと。
+
+    Args:
+        db_path: c3.db のパス。省略時は locate_c3_db() で探索。
+            None（locate_c3_db が None を返す）の場合は 0 を返す。
+
+    Returns:
+        cost を SET できた行数（rowcount > 0 の UPDATE 件数合計）。
+        DB 不在 / エラー時は 0 を返す（例外を投げない）。
+        例外発生時は ``finally: conn.close()`` 経由で rollback され、
+        cost 列がクリアされた状態で残る可能性がある。
+        戻り値 0 を受け取った呼び出し元は次回 session_stop での再試行に委ねる。
+    """
+    if db_path is None:
+        db_path = locate_c3_db()
+        if db_path is None:
+            return 0
+
+    rows = read_tier_cost_rate_summary(db_path=db_path)
+
+    set_count = 0
+    try:
+        conn = sqlite3.connect(str(db_path))
+        try:
+            conn.execute("PRAGMA journal_mode=WAL")
+            _apply_busy_timeout(conn)
+            # Step 1: 全行 cost 列クリア（alpha/beta/trials/last_updated は触らない）
+            conn.execute("UPDATE tier_bandit SET total_cost_usd = 0.0, cost_samples = 0")
+            # Step 2: 各集計行を SET（UPDATE-only: tier_bandit に行が無い場合は rowcount=0）
+            for row in rows:
+                cur = conn.execute(
+                    "UPDATE tier_bandit "
+                    "SET total_cost_usd = ?, cost_samples = ? "
+                    "WHERE task_complexity = ? AND tier = ?",
+                    (row["total_cost_usd"], row["sessions"], row["complexity"], row["tier"]),
+                )
+                set_count += cur.rowcount
+            # Step 3: 全 SET が完了してから一括 commit（途中 commit しない）
+            conn.commit()
+        finally:
+            conn.close()
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("failed to sync_tier_bandit_cost: %s", type(exc).__name__)
+        return 0
+
+    return set_count