# sougou-connectors catalog

『学問・技術 総合一覧』(2026-08-19 版) の全項目を、 1 項目 = 1 コネクタ
として構造化した索引データです。 446 項目、 12 章 + 付録 A/B/C。

## これは何か

学問・技術の各項目に対して、 項目名・章・節・位置・関連項目を機械可読な
形でまとめた JSON ファイルです。

- `catalog.json` — 常に最新版を指します
- `catalog-2.0.0.json` — 版を固定したスナップショット (内容は変更されません)

引用・参照には版固定版 (`catalog-2.0.0.json`) をお使いください。

## これは何ではないか

- **コネクタの実装 (Python) は含まれていません。** このファイルは索引データ
  のみです。 実装は公開していません。
- **実行されるコードではありません。** スクリプトでも MCP サーバでもなく、
  静的な JSON ファイルです。
- **外部 API への接続機能はありません。** データを取りに行く機能は含まれて
  いません。

## 構造

トップレベルに `moduleInfo` / `license` / `copyright` / `generatedAt` /
`itemCount` / `chapters` / `items` / `index_by_chapter` / `index_by_group`
を持ちます。 `moduleInfo.honestScope` に、 このデータが扱う範囲と扱わない
範囲を明記しています。

`moduleInfo` は Rei-AIOS の STEP 1676 で 定義された自己記述契約 (8 field:
name / version / step / purpose / publicApi / keyConcepts / relatedModules /
honestScope) に 適合します。 本 catalog が 同契約の 初の 外部公開インスタンス
です。

### 命名規約 — ファイル名の 版番号

ファイル名の 版番号 (`catalog-2.0.0.json` の `2.0.0`) は **索引している元
データ (『学問・技術 総合一覧』 由来の sougou-connectors 側) の 版** を
指します。 本 catalog モジュール自体の 生誕 STEP は `moduleInfo.step`
(現状 1677) を 参照してください。

### 命名規約 — field の 大文字小文字

トップレベル field は camelCase と snake_case が 混在しています:

- **v1 由来 field** (`source` / `generated_for` / `count` / `index_by_chapter`
  / `index_by_group`) は **snake_case** — 既存 sougou-connectors consumer との
  backward compat のため 保存
- **v2 以降 追加 field** (`moduleInfo` / `license` / `copyright` /
  `generatedAt` / `itemCount`) は **camelCase** — 自己記述契約 convention
  に 合わせて 追加

混在は 事故ではなく 判断の 結果です。 将来 全 camelCase 統一する 場合は
別 API version + migration guide を 併記します。

## ライセンス

Copyright (c) 2026 藤本伸樹 (Nobuki Fujimoto)

AGPL-3.0-or-later または商用ライセンスのデュアルライセンスです。
個人利用・研究利用は自由にお使いいただけます。 商用利用については
別途ご相談ください。

再配布・改変時は AGPL-3.0 の条件に従ってください。

## 出典と訂正

作成・著作権者： 藤本伸樹 (Nobuki Fujimoto)
元資料： 『学問・技術 総合一覧』2026-08-19 (同著者)

内容の誤りを見つけられた場合は、 お知らせいただけると助かります。
訂正の記録は版を分けて残します。

## 軽量版 (catalog-lite)

AI に 貼り付けて 使う 場合は、 軽量版を お使いください。

- https://rei-aios.pages.dev/data/sougou-connectors/catalog-lite.json
- https://rei-aios.pages.dev/data/sougou-connectors/catalog-lite-2.0.0.json

|  | 通常版 | 軽量版 |
|---|---|---|
| 大きさ | 約 162KB | 約 28KB |
| 説明文 (note) | あり | なし |
| 形式 | 項目ごとの オブジェクト | 列形式 (`fields` + `rows`) |
| 向いている 使い方 | プログラムから 読む | AI の テキスト欄に 貼る |

軽量版は 通常版から **機械的に 生成** しています (`scripts/publish-sougou-catalog/generate-catalog-lite.py`)。 `id` は 共通なので、 軽量版で 見つけた 項目の 説明を 通常版で 引く、 という 使い方が できます。

軽量版の `rows` は、 `fields` に 書かれた 順番で 値が 並んだ 配列です。 表計算ソフトの 1 行と 同じ構造 だと お考えください:

```json
"fields": ["id", "term", "chapter", "group"],
"rows": [
  ["001", "国語", "学校の教科", "小学校"],
  ["002", "算数", "学校の教科", "小学校"],
  ...
]
```

軽量版にも 通常版と 同じ **write-once discipline** が 適用されます — `catalog-lite-2.0.0.json` は 一度置いたら 二度と 変えません。

## 完全性の確認

catalog-2.0.0.json
SHA-256: `1bab78389e2332bb9c144db3e3d812cafca6373d9b5e2596d1ddf8f2365d6432`

```bash
sha256sum catalog-2.0.0.json
# → 1bab78389e2332bb9c144db3e3d812cafca6373d9b5e2596d1ddf8f2365d6432  catalog-2.0.0.json
```

**版固定ファイル (`catalog-2.0.0.json`) は 一度置いたら 二度と変えません** —
上の SHA-256 が 変わることは ありません。 新版が 必要な場合は
`catalog-2.0.1.json` のように **別ファイル** を 新規に 公開します。 生成器
(`scripts/publish-sougou-catalog/generate-catalog.py`) は 版固定ファイルに
異なる 内容で 上書きしようとすると fail-loud で 停止します。

---

## English summary

This is a machine-readable index of the "Academic and Technical Compendium"
(2026-08-19 edition) by Nobuki Fujimoto: 446 entries across 12 chapters plus
appendices A/B/C. **This URL serves the index only** — the Python connector
implementations (one file per entry) are not published here. The JSON is
static data, not executable code, and performs no external API calls.

The top-level `moduleInfo` block conforms to the Rei-AIOS self-description
contract (STEP 1676): eight required fields including `honestScope` that
states the data's boundaries. This catalog is the first external instance
of that contract.

Dual-licensed under AGPL-3.0-or-later or a commercial license. Use the
version-pinned `catalog-2.0.0.json` for citations.