STEP 1657 — sougou-connectors 446 本 全体 v2 bulk bump

Date: 2026-09-02  ·  Repo: fc0web/rei-aios  ·  Scope: sougou-connectors 446 本 + core + aggregator

起点

藤本さん directive (本 session):
「今存在する 449 本のツール含めた全てのツール、マシン、端子、チップ、回路等を 順番に進化させたい」 の 段階着地として、
「まず、学習ツールの充実が先なので、449 本の大量にあるものを 簡単でも良いので 一度で全体的に Ver.2 に進めて頂けますか?」

段階着地判断 = 学習ツール (sougou-connectors 446 本) を 一括 v2 pilot として実行、
他 layer (rei-aios MCP / benchtop / hardware template / コンビナート等) は 後続 STEP で 段階拡張候補。

v2 = 「拡張型」 upgrade (後方互換 完全維持)

v1 4 tools (info / siblings / chapter / search) は 無変更、5 番目 learn_path を 追加。 既存 client への 破壊なし。

learn_path の 内容 (catalog 内在情報だけで derive、外部依存 ゼロ)

field意味
current現在項目 (id / term / note)
previous同じ小見出しの 前の項目 (最初なら null)
next同じ小見出しの 次の項目 (最後なら null)
chapter_progress章全体での 位置 (例 9/52)
sibling_chapters同じ部 の 前後の章 (先に/次に 学べる 章)
part_difficulty_hint部別 難易度目安 (第I部 序盤 / 第II部 応用 / 第III部 実装 / 付録 拡張)

使用例 — MOSFET [276] を learn_path で 案内

■ 学習順路: MOSFET  [276]

章内位置: 9/52  (10. 回路 › 能動素子)
難易度  : 応用(職業・資格)

← 前 : [275] BJT
→ 次 : [277] IGBT

姉妹章(第II部 技術・実装):
  ← 09. 装置  (34 項)
  → 11. コネクタ  (48 項)

使用例 — 国語 [001] を learn_path で 案内

■ 学習順路: 国語  [001]

章内位置: 1/36  (01. 学校の教科 › 小学校)
難易度  : 序盤(基礎教養)

← 前 : (この小見出しの最初)
→ 次 : [002] 算数

姉妹章(第I部 学問・教育):
  ← (この部の 最初の章)
  → 02. 学問分野  (37 項)

実装内容

  1. sougou_core.py: __version__ 1.0.0 → 2.0.0 + learn_path() 関数 + _fmt_learn_path() formatter + _tools() list に entry 追加 + _dispatch() case 追加 + cli() case 追加 + serve() instructions に v2 mention
  2. 446 connector stub docstring bulk bump: scripts/sougou-connectors/bump_to_v2.py (idempotent) で docstring first line に v2 tag 追加 (446 files bumped / 0 skip / 0 nomatch)
  3. sougou_aggregator.py: call_connector tool の enum に learn_path 追加 + description v2 明示 + dispatch route 追加
  4. run_all_tests.py: expected tools list に learn_path 追加 (in-process + subprocess 2 箇所)

Test 結果

testv1 baselinev2 after
run_all_tests.py 構文検証446 本 PASS446 本 PASS
run_all_tests.py コア機能 (446 × 4 = 1784 呼出)ALL PASSALL PASS
run_all_tests.py MCP 疎通 (5 sample)ALL PASSALL PASS + learn_path visible
run_all_tests.py 設定 JSON (446 + 章別 15)ALL PASSALL PASS
test_aggregator.py in-process dispatch8 件 OK8 件 OK
test_aggregator.py 境界 (エラー系)4 件 OK4 件 OK
test_aggregator.py MCP subprocess5 応答 OK5 応答 OK
Smoke: MOSFET [276] learn_path via aggregatorN/A正常応答
Smoke: 国語 [001] learn_path via connectorN/A正常応答
Honest scope:
  1. v2 = 拡張型 upgrade (追加 5 番目 tool のみ)、v1 4 tools は 動作・schema 完全維持 = 既存 client 破壊なし。
  2. learn_path は catalog 内在情報 だけで derive。 外部 API / 実データ取得 / D-FUMT₈ verdict 生成は 含まない = 「純粋な 案内 layer」 (Peace Axiom データ取得倫理 = 25 load-bearing invention #2 に 完全準拠、外部 rate limit や cooldown 無関係)。
  3. 446 stub の docstring bump は 表示 layer のみ。 実質的な version bump は core __version__ = 2.0.0 で、MCP handshake の serverInfo.version で 各 client に 通知される。 docstring tag は grep-ability 用途。
  4. 他 layer (rei-aios MCP / benchtop / hardware template / コンビナート / 端子基盤等) は 本 STEP scope 外。 layer 毎に 「進化」 定義が 必要 (sougou-connectors の 「案内 layer」 pattern は 他 layer に 直接転用不可)。
  5. part_difficulty_hint は heuristic。 学問体系の 一般的直感 で 割当、厳密 学習理論根拠なし。 学習者への 目安として位置付け、absolute claim ではない (controllable 表現 discipline 準拠)。

Next STEP candidate (藤本さん judgment 待機)

  1. 他 layer 進化 protocol 化 (sougou-connectors 以外 の 545 - 446 = 99 wired 実装 の v2 検討) — layer 毎 の 「進化」 定義が 必要 (rei-aios MCP tool = argument schema 拡張? / benchtop = physics-limits 追加? / hardware template = 差動 Manchester 追加 candidate?)
  2. learn_path の 章横断化 (現状は 部内 章間だけ、章内 姉妹群への navigation は siblings tool が既にカバー)
  3. learn_path の D-FUMT₈ verdict 付与 (Peace Axiom 準拠 前提で、外部データ無しの pure heuristic verdict)

Files (repo 側)