@shuji-bonji/houki-abbreviations 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shuji-bonji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# @shuji-bonji/houki-abbreviations
+
+> 日本の法令略称・通称の共有辞書。houki-hub MCP family が共通で利用する基盤パッケージ。
+
+[![CI](https://github.com/shuji-bonji/houki-abbreviations/actions/workflows/ci.yml/badge.svg)](https://github.com/shuji-bonji/houki-abbreviations/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@shuji-bonji/houki-abbreviations.svg)](https://www.npmjs.com/package/@shuji-bonji/houki-abbreviations)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## 何のパッケージか
+
+日本の法令には「消法」「労基法」「電帳法」のような**略称**と、「電子帳簿保存法」のような**通称**があります。条文を参照したい LLM や MCP は、ユーザーがどの呼称で入力しても正式名称・e-Gov law_id に解決できる必要があります。
+
+このパッケージは、houki-hub MCP family（`houki-egov-mcp`、`houki-nta-mcp`、`houki-mhlw-mcp` 等）が**共通で参照する辞書層**です。各 MCP が独自に同じデータを持たないように、ここに一元化しています。
+
+```mermaid
+graph TB
+    subgraph "houki-hub MCP family"
+        Egov[houki-egov-mcp]
+        NTA[houki-nta-mcp]
+        MHLW[houki-mhlw-mcp]
+    end
+
+    Abbr["@shuji-bonji/houki-abbreviations<br/>略称辞書"]
+
+    Egov --> Abbr
+    NTA --> Abbr
+    MHLW --> Abbr
+
+    style Abbr fill:#fff4d6
+```
+
+## v0.1.0 の収録範囲
+
+- **165 エントリ**（6 分野）
+- **法律・政令・省令・規則・憲法**（e-Gov 法令API 配下）
+- 全エントリ `source_mcp_hint='houki-egov'`
+
+| 分野 | 件数 | 例 |
+|---|---|---|
+| tax | 26 | 所法、消法、電帳法 |
+| labor | 28 | 労基法、安衛法、フリーランス新法 |
+| accounting | 9 | 公認会計士法、会計士法 |
+| commercial | 31 | 会社、商法、電子署名法、資金決済法 |
+| civil | 23 | 民、民訴法、不動産登記法 |
+| administrative | 48 | 憲法、行手法、個情法、プロ責法 |
+
+## インストール
+
+```sh
+npm install @shuji-bonji/houki-abbreviations
+```
+
+## 使い方
+
+```ts
+import {
+  resolveAbbreviation,
+  listByDomain,
+  listByCategory,
+  listBySourceMcpHint,
+  getAbbreviationStats,
+} from '@shuji-bonji/houki-abbreviations';
+
+// 略称・通称・正式名称のいずれからもエントリを引ける
+const r = resolveAbbreviation('消法');
+// {
+//   abbr: '消法',
+//   formal: '消費税法',
+//   law_id: '363AC0000000108',
+//   law_num: '昭和六十三年法律第百八号',
+//   law_type: 'Act',
+//   domain: 'tax',
+//   category: 'law',
+//   source_mcp_hint: 'houki-egov',
+//   aliases: ['消費税']
+// }
+
+// 通称・aliases でも引ける
+resolveAbbreviation('電子帳簿保存法')?.abbr;  // '電帳法'
+resolveAbbreviation('PL法')?.formal;          // '製造物責任法'
+
+// 分野別・カテゴリ別・MCP 別の一覧
+listByDomain('tax');                  // 26 件
+listByCategory('cabinet-order');      // 政令系
+listBySourceMcpHint('houki-egov');    // e-Gov 管轄全件
+
+// 統計
+getAbbreviationStats();
+// { total: 165, byDomain: {...}, byCategory: {...}, bySourceMcpHint: {...} }
+```
+
+## API
+
+### `resolveAbbreviation(name: string): AbbreviationEntry | null`
+
+略称・通称・正式名称のいずれかからエントリを引きます。前後の空白はトリムされます。完全一致のみ（部分一致なし）。見つからない場合は `null`。
+
+### `listByDomain(domain: Domain): AbbreviationEntry[]`
+
+`'tax' | 'labor' | 'accounting' | 'commercial' | 'civil' | 'administrative'` のいずれかで絞り込み。
+
+### `listByCategory(category: Category): AbbreviationEntry[]`
+
+法令種別で絞り込み。`'constitution' | 'law' | 'cabinet-order' | 'imperial-ordinance' | 'ministerial-ordinance' | 'rule' | 'kihon-tsutatsu' | 'kobetsu-tsutatsu' | 'qa-jirei' | 'tax-answer' | 'hanrei' | 'saiketsu'` のいずれか。
+
+### `listBySourceMcpHint(hint: SourceMcpHint): AbbreviationEntry[]`
+
+このエントリを処理すべき MCP で絞り込み。各 MCP が起動時に「自分の管轄エントリだけ」を抽出する用途を想定。
+
+### `getAbbreviationStats(): AbbreviationStats`
+
+辞書全体の統計（総数、ドメイン別、カテゴリ別、MCP 別）。
+
+## エントリ型
+
+```ts
+interface AbbreviationEntry {
+  abbr: string;            // 略称（例: '消法'）
+  formal: string;          // 正式名称（例: '消費税法'）
+  law_id: string | null;   // e-Gov law_id（verified 済みのみ）
+  law_num?: string;        // 法令番号（例: '昭和六十三年法律第百八号'）
+  law_type?: LawTypeCode;  // 'Act' | 'CabinetOrder' | ...（後方互換）
+  domain: Domain;          // 分野タグ
+  category: Category;      // 法令カテゴリ
+  source_mcp_hint: SourceMcpHint;  // 参照すべき MCP
+  aliases?: string[];      // 同義の別表記
+  note?: string;           // 備考
+}
+```
+
+## category と source_mcp_hint の対応
+
+| category | 例 | source_mcp_hint |
+|---|---|---|
+| `constitution` | 日本国憲法 | houki-egov |
+| `law` | 消費税法、労働基準法 | houki-egov |
+| `cabinet-order` | 消費税法施行令 | houki-egov |
+| `ministerial-ordinance` | 消費税法施行規則 | houki-egov |
+| `rule` | 各庁規則 | houki-egov |
+| `kihon-tsutatsu` *(将来)* | 消費税法基本通達 | houki-nta |
+| `kobetsu-tsutatsu` *(将来)* | 個別通達 | houki-nta / houki-mhlw |
+| `qa-jirei` *(将来)* | 質疑応答事例 | houki-nta |
+| `hanrei` *(将来)* | 判例 | houki-court |
+| `saiketsu` *(将来)* | 国税不服審判所裁決 | houki-saiketsu |
+
+v0.1.0 では `houki-egov` 管轄のみ。`houki-nta-mcp` 等の開発と並行してエントリを追加していきます。
+
+## 貢献方法
+
+辞書の追加・修正は PR でお願いします。詳しくは [CONTRIBUTING.md](CONTRIBUTING.md) を参照。
+
+## リリース
+
+リリース手順・Trusted Publisher 設定・トラブルシュートは [docs/RELEASE.md](docs/RELEASE.md) を参照。
+
+## ライセンス
+
+MIT

package/dist/data/accounting.json

@@ -0,0 +1,87 @@
+[
+  {
+    "abbr": "会社計算規則",
+    "formal": "会社計算規則",
+    "law_id": null,
+    "law_type": "MinisterialOrdinance",
+    "domain": "accounting",
+    "category": "ministerial-ordinance",
+    "source_mcp_hint": "houki-egov"
+  },
+  {
+    "abbr": "財規",
+    "formal": "財務諸表等の用語、様式及び作成方法に関する規則",
+    "law_id": null,
+    "law_type": "MinisterialOrdinance",
+    "domain": "accounting",
+    "category": "ministerial-ordinance",
+    "source_mcp_hint": "houki-egov",
+    "aliases": [
+      "財務諸表等規則"
+    ]
+  },
+  {
+    "abbr": "連結財規",
+    "formal": "連結財務諸表の用語、様式及び作成方法に関する規則",
+    "law_id": null,
+    "law_type": "MinisterialOrdinance",
+    "domain": "accounting",
+    "category": "ministerial-ordinance",
+    "source_mcp_hint": "houki-egov"
+  },
+  {
+    "abbr": "四半期財規",
+    "formal": "四半期財務諸表等の用語、様式及び作成方法に関する規則",
+    "law_id": null,
+    "law_type": "MinisterialOrdinance",
+    "domain": "accounting",
+    "category": "ministerial-ordinance",
+    "source_mcp_hint": "houki-egov"
+  },
+  {
+    "abbr": "中間財規",
+    "formal": "中間財務諸表等の用語、様式及び作成方法に関する規則",
+    "law_id": null,
+    "law_type": "MinisterialOrdinance",
+    "domain": "accounting",
+    "category": "ministerial-ordinance",
+    "source_mcp_hint": "houki-egov"
+  },
+  {
+    "abbr": "公認会計士法",
+    "formal": "公認会計士法",
+    "law_id": null,
+    "law_type": "Act",
+    "domain": "accounting",
+    "category": "law",
+    "source_mcp_hint": "houki-egov"
+  },
+  {
+    "abbr": "税理士法",
+    "formal": "税理士法",
+    "law_id": null,
+    "law_type": "Act",
+    "domain": "accounting",
+    "category": "law",
+    "source_mcp_hint": "houki-egov"
+  },
+  {
+    "abbr": "会計検査院法",
+    "formal": "会計検査院法",
+    "law_id": null,
+    "law_type": "Act",
+    "domain": "accounting",
+    "category": "law",
+    "source_mcp_hint": "houki-egov"
+  },
+  {
+    "abbr": "法会規",
+    "formal": "法人の会計の公正な処理の基準に関する規則",
+    "law_id": null,
+    "law_type": "MinisterialOrdinance",
+    "domain": "accounting",
+    "category": "ministerial-ordinance",
+    "source_mcp_hint": "houki-egov",
+    "note": "（通称なし・参考参照用）"
+  }
+]