STEP 1662 — sougou-external-connectors 3 本 全体 v2

Date: 2026-09-02  ·  Repo: fc0web/rei-aios  ·  Scope: sougou-external-connectors (3 本、live API) + external_core

起点

藤本さん directive: 「CF Pages 反映確認後、次の layer に進めて下さい」。
STEP 1657 (sougou-connectors 446 本 v2) の CF Pages 反映 verify 完了後、コネクタ系統 6 系統 第 2 layer を pick。

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

v1 3-5 tools per connector は 完全無変更、共通 source_metadata tool を 全 3 connector に 追加。

source_metadata の 内容 (学習者が データ を 使う 前 に 出典を 確認)

field意味
nameデータ源 の 正式名称
url公式 URL
operator運用主体 (大学 / 研究機関)
coverageカバー範囲 (件数 / 種類)
licenseライセンス / 利用規約
rate_limitレート制限 (公式 or courtesy)
attribution学術引用 の 標準方法
connector_scopeこのコネクタで 出来ること (list)
not_coveredできないこと (honest scope、 list)

使用例 — SAT connector の source_metadata

■ SAT 大正新脩大藏經テキストデータベース (v2 出典透明化)

   URL       : https://21dzk.l.u-tokyo.ac.jp/SAT/
   運用主体   : 東京大学史料編纂所ほか
   カバー範囲 : 大正新脩大藏經 85 冊 + 図像 12 冊 + 昭和法宝総目録 3 冊
   ライセンス : SAT DB 公式利用規約 に 従う。 学術引用時 引用フォーマット 必須。
   レート制限 : 非公開。 courtesy pause 0.3s / request (external_core 既定)
   引用方法   : SAT 大正新脩大藏經テキストデータベース (東京大学史料編纂所)

  ── このコネクタで 出来ること (v2 明示) ──
   ✓ sat_info — SAT DB の 概要 / 出典 / 参考文献 / 制約 を 返す
   ✓ sat_canon_top — 大蔵経 主要部立 + 主要論書 (nb) 一覧
   ✓ sat_canonical_url — 経典番号 + 頁行 から SAT2018 の URL を 組み立てる

  ── 出来ないこと (honest scope) ──
   × free-text 検索 API (SAT 側で 公開文書化されていない)
   × 本文抽出 (master30.php の HTML は 1MB 級、 堅牢な 自動 parse 困難)

実装内容

  1. external_core.py: __version__ 0.1.0 → 0.2.0 + format_source_metadata() helper + source_metadata_tool_spec() helper
  2. sat_connector.py: SOURCE_METADATA dict (SAT DB / 東大 / 大蔵経 85 冊 / 利用規約 / できること 3 / できないこと 2) + dispatch + TOOLS 追加
  3. philosophy_connector.py: SOURCE_METADATA dict (PhilPapers + SEP / UWO + Stanford / 全 philosophy + 1858 SEP entries / できること 5 / できないこと 4)
  4. jp_academic_connector.py: SOURCE_METADATA dict (CiNii + J-STAGE / NII + JST / 日本 学術論文 数千万件 + 3000 誌 / できること 3 / できないこと 3)
  5. run_selftest.py: 各 connector CLI テスト に source_metadata 行 追加 (11 → 14 tests)

Test 結果

test内容結果
run_selftest.py (CLI mode)14/14 (v1 11 + v2 3) 実 API 疎通ALL PASS
test_external_aggregator.py in-process12 件OK
test_external_aggregator.py 境界5 件OK
test_external_aggregator.py MCP subprocess5 応答OK
Smoke: SAT / philosophy / jp_academic source_metadata (CLI)3 connector で 出典透明化 表示正常
Smoke: SAT source_metadata via aggregatordelegation route 動作正常
Honest scope:
  1. v2 は 拡張型 upgrade (source_metadata 追加のみ)、v1 tools は 動作・schema 完全維持 = 既存 client 破壊なし。
  2. source_metadata は 静的 dict (dispatch 時 外部 API を 叩かない)、rate limit や cooldown 対象外、Peace Axiom データ取得倫理 (25 LB #2) 完全準拠。
  3. coverage / rate_limit の 数値は 記載時点 (2026-09-02)、外部データ源 の 変化 (SEP entries 数 / PhilPapers 件数) は 追随しない = 手動 update discipline。
  4. バージョン 0.2.0 で bump 幅 控えめ — external-connectors は 元々 0.1.0 (early alpha) で、外部 API 依存の 不安定性 残存。 STEP 1657 (sougou-connectors) の 2.0.0 と 直接比較不可 (別 pool)。
  5. aggregator は 未変更 — 各 connector の dispatch を delegation で routing する 既存 pattern が source_metadata を 透過的に 通す (実測 verify)。

Next STEP candidate (コネクタ系統 進化残 4 layer)

  1. コンビナート 4 (connector-graph / open-end-tags / ghost-wire-detector / time-connector-runtime) — 端子基盤、v2 内容 = OwnerKind の D-FUMT₈ verdict 直接 mapping 追加 candidate
  2. ソフト connector catalog 3 (puzzle-verifier / mystery-reasoning / game-verdict) — v2 内容 = 統一 test harness 追加 candidate
  3. ハード connector template 2 (radio-clock-jjy / inductive-coil-pair) — Verilog / SVG 生成 layer、v2 内容 = 差動 Manchester template 追加 candidate
  4. agent connector 3 tool + 6 pin — v2 内容 = pin 8/6 に増強 (fail 2/6 の解消) candidate

Files (repo 側)