claude-code-conductor 2.36.0__tar.gz → 2.37.0__tar.gz

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/.claude/hooks/recall_autorebuild.py

@@ -97,11 +97,14 @@ def find_repo_root() -> Path | None:
 
 
 def index_exists(repo_root: Path) -> bool:
-    """Return True if the recall HNSW index file exists.
+    """Return True if the recall index file (``recall.hnsw``) exists.
+
+    歴史的経緯でファイル名は ``.hnsw`` を維持しているが、中身は numpy ndarray
+    (``.npy`` ペイロード, shape (N, dim) float32) であり HNSW ではない。
 
     Only ``recall.hnsw`` is checked — not ``recall_meta.json`` — because
     this hook's purpose is to trigger a rebuild when the index is stale.
-    If the binary index is present (even without a metadata sidecar),
+    If the index file is present (even without a metadata sidecar),
     the stale check in ``index_is_stale_fast`` is meaningful and we should
     proceed.  ``recall_inject`` checks both files because it needs a valid
     meta to run a search; we do not run a search here.

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/.claude/hooks/recall_inject.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """UserPromptSubmit hook: inject semantically-similar past context (α design).
 
-The hook runs ``c3 recall search`` against the local HNSW index and
+The hook runs ``c3 recall search`` against the recall index (numpy cosine search) and
 returns the top hits as ``additionalContext`` for the parent Claude to
 consider. The preface explicitly asks Claude to evaluate the relevance
 of each hit and ignore unrelated ones — i.e. *AI judges, hook does not

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/.claude/skills/recall/SKILL.md

@@ -6,7 +6,7 @@ allowed-tools: Bash, Read
 
 # recall
 
-`c3 recall` の HNSW + 多言語 embedding（`sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2`）に基づき、
+`c3 recall` の numpy ベクトル検索 + 多言語 embedding（`sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2`）に基づき、
 `.claude/memory/sessions/`・`.claude/agent-memory/`・`.claude/reports/archive/`・
 `.claude/memory/patterns.json` から類似情報を意味検索する。
 

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/ARCHITECTURE.md

@@ -38,7 +38,7 @@ C3 は性質の異なる **2 つの層** からなる。この区別が全体理
 | 言語 | Python | Markdown（+ hook は Python） |
 | 配布 | `pip install claude-code-conductor` | `c3 init` が層 A から展開 |
 | エントリ | `c3 = "c3.cli:main"`（pyproject.toml） | スラッシュコマンド・Agent ツール |
-| 依存 | PyYAML / duckdb / chroma-hnswlib / fastembed | Claude Code ランタイム |
+| 依存 | PyYAML / duckdb / numpy / fastembed | Claude Code ランタイム |
 
 **配布元リポジトリ内の物理対応**:
 
@@ -165,7 +165,7 @@ A ヒアリング → B 設計 → C 計画 → D 実装(TDD) → E レビュー
 
 ```
 recall_chunker.py  →  embedding.py            →  recall_index.py
-（sessions/reports/    （fastembed: paraphrase-     （HNSW: chroma-hnswlib・
+（sessions/reports/    （fastembed: paraphrase-     （numpy cosine ブルートフォース・
   patterns をチャンク化）  multilingual-MiniLM-L12-v2    .claude/state/ に保存）
                           384次元・約220MB・多言語）
 ```

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.37.0] - 2026-06-16
+
+### 変更
+
+- **recall の索引バックエンドを chroma-hnswlib（C++ 拡張）から numpy ブルートフォース cosine 検索へ置換**: C++ コンパイラ（Microsoft Visual C++ Build Tools）が無い環境で `pip install claude-code-conductor` が失敗する問題を解消。numpy は全環境に wheel が提供されておりコンパイル不要。recall のコーパスは 1 ユーザーの `.claude/` 規模（数千チャンク）で近似最近傍の高速化が不要なため、numpy の総当たり cosine 検索で十分。索引は次回 `c3 recall rebuild` 実行時に自動で numpy 形式へ再生成される。アップグレード直後・初回 rebuild 完了までの間は recall が一時的に結果を返さない（`c3 recall rebuild --force` で即時再生成可能）。`recall.hnsw` ファイル名は後方互換のため維持（中身が numpy ペイロードに変わる）。関連フック（`recall_inject.py` / `recall_autorebuild.py`）は無改修で動作する。`load()` は不正形状・旧 hnswlib バイナリ・破損ファイルを検出すると `False` を返して全再構築フォールバックに繋ぐ（`np.load(allow_pickle=False)` で pickle 経路は遮断）。
+
+### 依存
+
+- `chroma-hnswlib>=0.7.6` を削除し `numpy>=1.22` を追加。`LICENSES/chroma-hnswlib-*` を削除し `LICENSES/numpy-LICENSE`（BSD-3-Clause）を追加。
+
+### 後方互換
+
+- 公開 API・CLI・索引ファイル名（`recall.hnsw`）・meta スキーマに変更なし。索引は自動再生成のため migration 操作は不要。**破壊的変更なし**。
+
 ## [2.36.0] - 2026-06-14
 
 **セッションファイルに「現在地」フィールドを新設し、コンテキスト圧縮（コンパクト）後の肥大ループとワークフロー無視を同時に解消（hook・skill 手順の変更／破壊的変更なし）**: 200K コンテキスト運用で、セッション復元（コンパクト後・`/init-session`）の経路が「構造のない丸投げ」になっていたことが 2 つの症状を生んでいた。(1) **コンパクト肥大ループ**: `pre_compact.py` がコンパクト直前に状態を無上限追記させ、`restore_session.py` がコンパクト後に `## 残タスク` / `## うまくいったアプローチ` / `## 試みたが失敗したアプローチ` の 3 セクションを完了済み `- [x]` 行も含め丸ごと再注入し続けるため、コンテキスト使用率が上がり→さらにコンパクトが早まる正のフィードバックになっていた。(2) **ワークフロー無視**: 復元時にフェーズ状態が単なる ToDo として注入されるだけで「dev-workflow 進行中・skill 経由で再開せよ・Approval Flow を守れ」の指示が無く、`/init-session` の「続きから作業する」も「そのまま作業に入る」となっていたため、復元後に dev-workflow を飛ばして直接着手しがちだった。両症状の根は同じ「復元時に構造化された現在地が無い」ことであり、`現在地:` の 1 行フィールドを新設して構造化することで、再注入を小さく保ちつつワークフロー復帰を確実化する。

claude_code_conductor-2.37.0/LICENSES/numpy-LICENSE

@@ -0,0 +1,32 @@
+# Source: https://github.com/numpy/numpy/blob/main/LICENSE.txt
+
+Copyright (c) 2005-2024, NumPy Developers.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+       copyright notice, this list of conditions and the following
+       disclaimer in the documentation and/or other materials provided
+       with the distribution.
+
+    * Neither the name of the NumPy Developers nor the names of any
+       contributors may be used to endorse or promote products derived
+       from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-conductor
-Version: 2.36.0
+Version: 2.37.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
@@ -37,9 +37,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development
 Requires-Python: >=3.10
-Requires-Dist: chroma-hnswlib>=0.7.6
 Requires-Dist: duckdb>=0.10
 Requires-Dist: fastembed>=0.8.0
+Requires-Dist: numpy>=1.22
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: notify
 Requires-Dist: windows-toasts>=1.0; (sys_platform == 'win32') and extra == 'notify'
@@ -184,7 +184,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `/doc` | ドキュメントをヒアリングして生成（mermaid 図・README・API 仕様書など） |
 | `/mcp-config` | MCP サーバーの追加・一覧・削除（プロジェクトスコープ） |
 | `/extract-lib` | 複数プロジェクトのコードを横断解析し、共通処理をライブラリとして設計・生成 |
-| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（HNSW + 多言語 embedding） |
+| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（numpy ベクトル検索 + 多言語 embedding） |
 | `/brainstorm` | 仕事・設計の相談を、資料（PDF/画像）を読み込んだ上で気軽に発散・壁打ち。視点・選択肢・論点を増やす方向（grill＝詰めるとは逆）（v2.29.0〜） |
 
 ### ターミナルで使う `c3` CLI（PyPI インストール時）
@@ -200,7 +200,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `c3 plan validate <plan-report>` | plan-report の YAML フロントマターと agent 存在を検証 |
 | `c3 plan waves <plan-report>` | plan-report の wave 分解結果を JSON で出力 |
 | `c3 recall search "<query>"` または `c3 recall "<query>"` | `.claude/memory/sessions/` 等から類似チャンクを意味検索 |
-| `c3 recall rebuild [--force]` | HNSW インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
+| `c3 recall rebuild [--force]` | numpy ベクトル検索インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
 | `c3 recall stats` | チャンク数・モデル名・最終 rebuild 日時を表示 |
 | `c3 tier stats` | tier-routing（複雑度に応じた Tier 自動ルーティング）の学習データ・Tier 別コスト・現在の routing パラメータ（λ/ε/escalation・v2.27.0〜）を表形式で表示（`--json` で機械可読出力・`--recent N` で直近 outcome 件数指定）。ルーティング挙動は環境変数 `C3_TIER_COST_LAMBDA`（cost-weighted の重み・`0 ≤ λ ≤ 5`・v2.26.0〜、上限拡張 v2.27.0）/ `C3_TIER_EPSILON` / `C3_ESCALATION_THRESHOLD` で調整可（[CLI リファレンス](https://satoh-y-0323.github.io/claude-code-conductor/cli-reference/)参照） |
 
@@ -420,7 +420,7 @@ C3 はセッションをまたいで作業状態を記憶します。
 
 | 依存 | ライセンス | 用途 |
 |---|---|---|
-| [chroma-hnswlib](https://github.com/chroma-core/hnswlib) | Apache-2.0 | HNSW 近傍検索インデックス |
+| [numpy](https://github.com/numpy/numpy) | BSD-3-Clause | recall のベクトル類似度検索（cosine ブルートフォース） |
 | [fastembed](https://github.com/qdrant/fastembed) | Apache-2.0 | embedding 生成ランタイム（ONNX ベース） |
 | [onnxruntime](https://github.com/microsoft/onnxruntime) | MIT | fastembed の推論バックエンド |
 | [sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2](https://huggingface.co/sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2) | Apache-2.0 | 多言語 embedding モデル（384 次元・約 220MB・約 50 言語対応） |

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/README.md

@@ -137,7 +137,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `/doc` | ドキュメントをヒアリングして生成（mermaid 図・README・API 仕様書など） |
 | `/mcp-config` | MCP サーバーの追加・一覧・削除（プロジェクトスコープ） |
 | `/extract-lib` | 複数プロジェクトのコードを横断解析し、共通処理をライブラリとして設計・生成 |
-| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（HNSW + 多言語 embedding） |
+| `/recall` | 過去のセッション・レポート・パターンから類似情報を意味検索（numpy ベクトル検索 + 多言語 embedding） |
 | `/brainstorm` | 仕事・設計の相談を、資料（PDF/画像）を読み込んだ上で気軽に発散・壁打ち。視点・選択肢・論点を増やす方向（grill＝詰めるとは逆）（v2.29.0〜） |
 
 ### ターミナルで使う `c3` CLI（PyPI インストール時）
@@ -153,7 +153,7 @@ C3 のスラッシュコマンドはすべてスキル（`skills/{name}/SKILL.md
 | `c3 plan validate <plan-report>` | plan-report の YAML フロントマターと agent 存在を検証 |
 | `c3 plan waves <plan-report>` | plan-report の wave 分解結果を JSON で出力 |
 | `c3 recall search "<query>"` または `c3 recall "<query>"` | `.claude/memory/sessions/` 等から類似チャンクを意味検索 |
-| `c3 recall rebuild [--force]` | HNSW インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
+| `c3 recall rebuild [--force]` | numpy ベクトル検索インデックスを再構築（初回は fastembed が ~220MB のモデルを取得） |
 | `c3 recall stats` | チャンク数・モデル名・最終 rebuild 日時を表示 |
 | `c3 tier stats` | tier-routing（複雑度に応じた Tier 自動ルーティング）の学習データ・Tier 別コスト・現在の routing パラメータ（λ/ε/escalation・v2.27.0〜）を表形式で表示（`--json` で機械可読出力・`--recent N` で直近 outcome 件数指定）。ルーティング挙動は環境変数 `C3_TIER_COST_LAMBDA`（cost-weighted の重み・`0 ≤ λ ≤ 5`・v2.26.0〜、上限拡張 v2.27.0）/ `C3_TIER_EPSILON` / `C3_ESCALATION_THRESHOLD` で調整可（[CLI リファレンス](https://satoh-y-0323.github.io/claude-code-conductor/cli-reference/)参照） |
 
@@ -373,7 +373,7 @@ C3 はセッションをまたいで作業状態を記憶します。
 
 | 依存 | ライセンス | 用途 |
 |---|---|---|
-| [chroma-hnswlib](https://github.com/chroma-core/hnswlib) | Apache-2.0 | HNSW 近傍検索インデックス |
+| [numpy](https://github.com/numpy/numpy) | BSD-3-Clause | recall のベクトル類似度検索（cosine ブルートフォース） |
 | [fastembed](https://github.com/qdrant/fastembed) | Apache-2.0 | embedding 生成ランタイム（ONNX ベース） |
 | [onnxruntime](https://github.com/microsoft/onnxruntime) | MIT | fastembed の推論バックエンド |
 | [sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2](https://huggingface.co/sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2) | Apache-2.0 | 多言語 embedding モデル（384 次元・約 220MB・約 50 言語対応） |

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
 dependencies = [
     "PyYAML>=6.0",
     "duckdb>=0.10",
-    "chroma-hnswlib>=0.7.6",
+    "numpy>=1.22",
     "fastembed>=0.8.0",
 ]
 

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/src/c3/__init__.py

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

{claude_code_conductor-2.36.0 → claude_code_conductor-2.37.0}/src/c3/cli_recall.py

@@ -2,13 +2,15 @@
 
 Subcommands:
 
-* ``c3 recall search <query>`` — query the HNSW index for relevant chunks.
+* ``c3 recall search <query>`` — query the numpy cosine index for relevant chunks.
 * ``c3 recall rebuild`` — re-embed every source file and rewrite the index.
 * ``c3 recall stats`` — report what's in the index.
 
-The heavy dependencies (``fastembed``, ``hnswlib``) are imported lazily
-inside the handlers so that ``c3 --help`` and unrelated subcommands stay
-fast even when the embedding model has not yet been downloaded.
+The heavy dependency (``fastembed``) is imported lazily inside the handlers
+so that ``c3 --help`` and unrelated subcommands stay fast even when the
+embedding model has not yet been downloaded. ``numpy`` is imported eagerly
+at module level (``import numpy as np`` in ``recall_index.py``) and is
+always available when this module is loaded.
 """
 
 from __future__ import annotations
@@ -296,13 +298,22 @@ def _handle_rebuild(args: argparse.Namespace) -> int:
             dim=embedder.dim,
         )
         try:
-            candidate.load()
-            old_index = candidate
+            # [M-01] load() の戻り値を確認し、False なら増分不可として全再構築する。
+            loaded = candidate.load()
+            if loaded:
+                old_index = candidate
+            else:
+                print(
+                    "[recall] 既存 index を読めず増分不可・全再構築にフォールバック:"
+                    " load() returned False",
+                    file=sys.stderr,
+                )
+                old_index = None
         except Exception as exc:
             # CR-E-002/SR-R-004: log the failure reason so operators can diagnose
             # corrupt or mismatched index files. Exception message is intentionally
             # omitted (type name only) to avoid leaking internal state — consistent
-            # with the SR-R-001 policy used in _hnsw_save/_hnsw_load.
+            # with the SR-R-001 policy used in RecallIndex.load().
             print(
                 f"[recall] 既存 index を読めず増分不可・全再構築にフォールバック: {type(exc).__name__}",
                 file=sys.stderr,