building-standards-act-mcp 1.7.0 → 1.9.0

package/README.md

@@ -11,12 +11,13 @@ AI の建築法規回答に含まれるハルシネーションを、条文原
 
 ## 特徴
 
-- **法令取得** — e-Gov 法令 API v2 から条文を Markdown 形式で取得
-- **法令検索** — キーワードで法令を横断検索
+- **法令取得** — e-Gov 法令 API v2 から条文を条単位（`elm` 指定）で取得。1 条あたり数 KB で済み、全文 1 MB 超を読まない
+- **法令検索** — 法令名で建築関連法令を横断検索
+- **条文本文検索** — e-Gov のキーワード検索 API で条文本文を全文検索（`search_articles`）
 - **法令全文取得** — 法令全体のテキストを取得
 - **告示取得** — 建築基準法が技術基準を委任している告示を国土交通省の告示データベース（PDF）から取得
 - **検索ファースト** — e-Gov API 検索による動的な法令解決。プリセットに限らず、e-Gov 収録の全法令を取得可能
-- **略称マップ** — 建築基準法・消防法・都市計画法ほか 112 法令の略称を登録済み。「建基法」「都計法」「消防法」等の略称で指定可能
+- **略称マップ** — 建築基準法・消防法・都市計画法ほか 116 法令の略称を登録済み。「建基法」「都計法」「消防法」等の略称で指定可能
 - **キャッシュ** — 検索 30 分・法令データ 24 時間の TTL キャッシュ（永続化オプションあり）
 - **API 耐障害性** — 自動リトライ（exponential backoff）+ サーキットブレーカー
 - **運用可視化** — 構造化 JSON ログ + 使用量メトリクス（`get_metrics` ツール）
@@ -25,27 +26,29 @@ AI の建築法規回答に含まれるハルシネーションを、条文原
 
 Vercel にデプロイすると、Claude.ai からすぐに使えます。環境変数の設定は不要です（e-Gov API は公開 API）。
 
+公開インスタンス: `https://building-standards-act-mcp.vercel.app/api/mcp`（自分でデプロイしなくても、この URL をそのまま Custom Connector に登録できます）
+
 [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FSora-bluesky%2Fbuilding-standards-act-mcp)
 
 ### Claude.ai でのセットアップ（Free/Pro/Max/Team/Enterprise）
 
-> **注意**: Custom Connectors はベータ版のため、接続が不安定な場合があります。安定してご利用いただくには [npx（ローカル）でのセットアップ](#npx推奨)もご検討ください。
+> Custom Connectors は Free / Pro / Max / Team / Enterprise の各プランで利用できます（Free プランは 1 件まで）。ローカルで動かしたい場合は [npx（ローカル）でのセットアップ](#npx推奨) を参照してください。
 
-1. 上の「Deploy with Vercel」ボタンでデプロイ（ワンクリック）
-2. [claude.ai](https://claude.ai) → プロフィールアイコン → Settings → Connectors
-3. 「Add custom connector」をクリック
-4. URL に `https://your-app.vercel.app/api/mcp`（your-app をデプロイ先に置換）を入力
+1. 公開インスタンスを使う場合はこの手順を飛ばす。自分でホストする場合は上の「Deploy with Vercel」ボタンでデプロイ（ワンクリック）
+2. [claude.ai](https://claude.ai) → Customize → Connectors
+3. 「+ Add」→「Add custom connector」をクリック
+4. URL に `https://building-standards-act-mcp.vercel.app/api/mcp`（自分でデプロイした場合はその URL）を入力し、認証は「No sign in」を選択
 5. チャットで「+」→「Connectors」→ building-standards-act を有効化
 6. 「建築基準法第20条を教えて」と質問
 
 > 参考: [Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)
 
-### Vercel Free tier の制限事項
+### Vercel での実行時間
 
-- 関数の実行時間が **10 秒** に制限されます（Pro プランでは 60 秒）
-- `get_kokuji`（告示取得）は PDF ダウンロード + パースが重いため、タイムアウトする場合があります
-- `check_law_updates` の大規模グループ（9章: 53法令）は Free tier ではタイムアウトする場合があります（Pro プランでは並行実行により対応可能）
-- `BUILDING_LAW_REQUEST_TIMEOUT=8000` を設定してタイムアウトを短縮できます
+- Vercel Functions の実行時間は Hobby プランでも既定 300 秒です（Fluid compute）。本リポの `vercel.json` は `maxDuration` を 60 秒に設定しています
+- `get_kokuji`（告示取得）は PDF ダウンロード + パースが重いため、60 秒を超える場合は `vercel.json` の `maxDuration` を引き上げてください
+- `check_law_updates` の大規模グループ（9章: 53法令）は最大 5 並行で実行します（`BUILDING_LAW_CONCURRENCY` で調整可能）
+- `BUILDING_LAW_REQUEST_TIMEOUT=8000` を設定して e-Gov API 呼び出しのタイムアウトを短縮できます
 
 ---
 
@@ -56,9 +59,11 @@ Vercel にデプロイすると、Claude.ai からすぐに使えます。環境
 インストール不要で実行できます。
 
 ```bash
-npx -y building-standards-act-mcp
+npx -y building-standards-act-mcp@latest
 ```
 
+`@latest` を付けると、npx のキャッシュに古い版が残っていても最新版で起動します。
+
 ### Claude Desktop
 
 `claude_desktop_config.json` に以下を追加してください。
@@ -68,7 +73,7 @@ npx -y building-standards-act-mcp
   "mcpServers": {
     "building-standards-act": {
       "command": "npx",
-      "args": ["-y", "building-standards-act-mcp"]
+      "args": ["-y", "building-standards-act-mcp@latest"]
     }
   }
 }
@@ -77,43 +82,37 @@ npx -y building-standards-act-mcp
 ### Claude Code
 
 ```bash
-claude mcp add building-standards-act -- npx -y building-standards-act-mcp
+claude mcp add building-standards-act -- npx -y building-standards-act-mcp@latest
 ```
 
 #### Windows + VS Code 拡張機能の場合
 
-VS Code 拡張機能では `npx` 経由の起動が `Connection closed` エラーになる場合があります。
-プロジェクトルートに `.mcp.json` を作成してください。
-
-**Step 1: グローバルインストール**
-
-```bash
-npm install -g building-standards-act-mcp
-```
-
-**Step 2: パスの確認**
+VS Code 拡張機能では `npx` 経由の起動が `Connection closed` エラーになる場合があります。その場合は、公開中の Vercel 版に HTTP で接続するのが確実です。
 
 ```bash
-where node        # → node.exe のフルパス（例: C:\Program Files\nodejs\node.exe）
-npm root -g       # → グローバル node_modules のパス
+claude mcp add --transport http building-standards-act https://building-standards-act-mcp.vercel.app/api/mcp
 ```
 
-**Step 3: `.mcp.json` を作成**
-
-取得したパスで置き換えてください（パス区切りは `/` を使用）:
+プロジェクト単位で設定するなら、プロジェクトルートの `.mcp.json` に次を書きます。
 
 ```json
 {
   "mcpServers": {
     "building-standards-act": {
-      "command": "<where node の出力>",
-      "args": ["<npm root -g の出力>/building-standards-act-mcp/dist/index.js"]
+      "type": "http",
+      "url": "https://building-standards-act-mcp.vercel.app/api/mcp"
     }
   }
 }
 ```
 
-> **注意**: `.mcp.json` にはマシン固有のパスが含まれるため、`.gitignore` に追加してください。
+ローカルの stdio で動かしたい場合は、`npx` を `cmd /c` で包みます。
+
+```bash
+claude mcp add building-standards-act -- cmd /c npx -y building-standards-act-mcp@latest
+```
+
+> **注意**: グローバルインストールした `dist/index.js` のパスを `.mcp.json` に直接書く方法は使わないでください。パッケージの更新・削除やフォルダの移動で、エラーを出さずに接続できなくなります。
 
 ### ローカル（ソースから）
 
@@ -137,18 +136,19 @@ npm run build
 
 ## MCP ツール
 
-| ツール              | 説明                                                                                          |
-| ------------------- | --------------------------------------------------------------------------------------------- |
-| `get_law`           | 条番号を指定して法令の条文を取得する。略称・正式名称のいずれでも指定可能                      |
-| `get_full_law`      | 法令の全文を取得する。条番号を指定せず法令全体のテキストを返す                                |
-| `search_law`        | キーワードで建築関連法令を横断検索する。略称マップと e-Gov API の両方を検索                   |
-| `get_kokuji`        | 建築基準法が技術基準を委任している告示の全文を取得する（省エネ告示は国交省 PDF から直接取得） |
-| `check_law_updates` | 法令の改正状況を e-Gov API で確認する（単体/バッチ/改正履歴表示に対応）                       |
-| `get_laws_batch`    | 複数の法令・条文を一括取得する（最大20件、同一法令は1回のAPI呼び出しで効率処理）              |
-| `verify_citation`   | AIの回答に含まれる法令引用を検証する（条文存在確認・テキスト照合、最大10件）                  |
-| `suggest_related`   | 指定した条文の関連法令・委任先・同法令内参照を自動抽出して提案する                            |
-| `analyze_article`   | 条文の構造解析メタデータ（項数・号数・参照統計・プレビュー）をJSON形式で返す                  |
-| `get_metrics`       | サーバーの使用量メトリクスを返す（ツール呼び出し回数・APIリクエスト数・キャッシュヒット率）   |
+| ツール              | 説明                                                                                                            |
+| ------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `get_law`           | 条番号を指定して法令の条文を取得する。略称・正式名称のいずれでも指定可能                                        |
+| `get_full_law`      | 法令の全文を取得する。`max_chars`（既定 100,000）で区切り、続きは `offset` で取る                               |
+| `search_law`        | 法令名（タイトル）で建築関連法令を検索する。略称マップと e-Gov API の両方を検索。条文本文の検索は `search_articles` |
+| `search_articles`   | 条文本文をキーワードで全文検索する（e-Gov `/keyword`）。法令名で絞り込み可。条番号は返らないので `get_law` で確定する   |
+| `get_kokuji`        | 建築基準法が技術基準を委任している告示の全文を取得する（省エネ告示は国交省 PDF から直接取得）                   |
+| `check_law_updates` | 法令の改正状況を e-Gov API で確認する。`since`（既定は 12 か月前）より後の改正だけを「改正あり」にする            |
+| `get_laws_batch`    | 複数の法令・条文を一括取得する（最大20件、1 条ごとに条単位で取得）                                              |
+| `verify_citation`   | AIの回答に含まれる法令引用を検証する（条文存在確認・テキスト照合、最大10件）                                    |
+| `suggest_related`   | 指定した条文の関連法令・委任先・同法令内参照を自動抽出して提案する                                              |
+| `analyze_article`   | 条文の構造解析メタデータ（項数・号数・参照統計・プレビュー）をJSON形式で返す                                    |
+| `get_metrics`       | サーバーの使用量メトリクスを返す（ツール呼び出し回数・APIリクエスト数・キャッシュヒット率）                     |
 
 ### パラメータ
 
@@ -162,21 +162,34 @@ npm run build
 
 #### `get_full_law`
 
-| パラメータ | 説明                         | 例                           |
-| ---------- | ---------------------------- | ---------------------------- |
-| `law_name` | 法令名（正式名称または略称） | `建築基準法施行令`, `建基令` |
+| パラメータ  | 説明                                          | 例                           |
+| ----------- | --------------------------------------------- | ---------------------------- |
+| `law_name`  | 法令名（正式名称または略称）                  | `建築基準法施行令`, `建基令` |
+| `max_chars` | 1 回に返す最大文字数（既定 100,000）          | `50000`                      |
+| `offset`    | 続きを取るときの開始位置（末尾の案内に出る値） | `100000`                     |
 
 #### `search_law`
 
-| パラメータ | 説明           | 例                     |
-| ---------- | -------------- | ---------------------- |
-| `keyword`  | 検索キーワード | `耐火構造`, `用途変更` |
+| パラメータ | 説明                   | 例                     |
+| ---------- | ---------------------- | ---------------------- |
+| `keyword`  | 法令名に含まれる語     | `建築`, `都市計画`     |
+
+#### `search_articles`
+
+| パラメータ  | 説明                                                         | 例                     |
+| ----------- | ------------------------------------------------------------ | ---------------------- |
+| `keyword`   | 条文本文に含まれる語。AND / OR / NOT と `*` `?` が使える       | `耐火構造`, `壁量`     |
+| `law_title` | 法令名または略称で絞り込み（省略時は e-Gov の全法令）        | `建築基準法`           |
+| `limit`     | 返す該当文の数（既定 10、最大 50）                           | `20`                   |
+| `offset`    | 続きを取るときの開始位置（応答の `next_offset` を渡す）      | `10`                   |
 
 #### `get_kokuji`
 
-| パラメータ    | 説明   | 例                             |
-| ------------- | ------ | ------------------------------ |
-| `kokuji_name` | 告示名 | `耐火構造の構造方法を定める件` |
+| パラメータ    | 説明                                  | 例                             |
+| ------------- | ------------------------------------- | ------------------------------ |
+| `kokuji_name` | 告示名                                | `耐火構造の構造方法を定める件` |
+| `max_chars`   | 1 回に返す最大文字数（既定 100,000）  | `50000`                        |
+| `offset`      | 続きを取るときの開始位置              | `100000`                       |
 
 #### `check_law_updates`
 
@@ -185,6 +198,7 @@ npm run build
 | `law_name`     | 法令名または略称（単体チェック）           | `建築基準法` |
 | `group`        | 章グループ（バッチチェック、省略時は全章） | `1章`        |
 | `show_history` | 改正履歴の詳細を表示（`law_name` 指定時）  | `true`       |
+| `since`        | 基準日。これより後の改正だけを報告（省略時は 12 か月前） | `2026-01-01` |
 
 #### `get_laws_batch`
 
@@ -235,8 +249,16 @@ npm run build
 ### 法令検索
 
 ```
-耐火構造に関する法令を検索して
-→ search_law(keyword="耐火構造")
+都市計画に関する法令を検索して
+→ search_law(keyword="都市計画")
+```
+
+### 条文本文検索
+
+```
+建築基準法で「耐火構造」が出てくる条文を探して
+→ search_articles(keyword="耐火構造", law_title="建築基準法")
+→ 該当文と区分（本則 / 附則）が返るので、条番号は get_law で確定する
 ```
 
 ### 全文取得
@@ -261,6 +283,9 @@ npm run build
 
 建築基準法施行令の附則第1条を取得して
 → get_law(law_name="建築基準法施行令", article_number="附則第1条")
+
+未施行の改正附則（現行データに無いときは改正履歴から未施行版を取る）
+→ get_law(law_name="建築基準法施行令", article_number="附則（令和8年政令第284号）")
 ```
 
 ### 別表取得
@@ -315,9 +340,9 @@ AI が建築法規について回答する際、条文の引用ミスや存在
 → 「第20条第1項第三号の記載に誤りがあります。正しくは…」
 ```
 
-## 対応法令一覧（112 法令 + e-Gov 全法令）
+## 対応法令一覧（116 法令 + e-Gov 全法令）
 
-> 以下の 112 法令は略称マップに登録済みです。略称マップに含まれない法令も、正式名称を指定すれば e-Gov API 検索で動的に取得できます。
+> 以下の 116 法令は略称マップに登録済みです。略称マップに含まれない法令も、正式名称を指定すれば e-Gov API 検索で動的に取得できます。
 
 ### 総則（4 法令）
 
@@ -495,21 +520,19 @@ AI が建築法規について回答する際、条文の引用ミスや存在
 | 被災市街地復興特別措置法                   | 被災市街地復興法 |
 | 被災区分所有建物の再建等に関する特別措置法 | 被災マンション法 |
 
-## 対応告示（9 件）
+## 告示の取得
 
-e-Gov API は告示を収録していないため、`get_kokuji` は国土交通省の告示・通達データベース（Excel → PDF）から取得します。省エネ関連の告示第265号・第266号は国交省 PDF から直接取得します。見つからない場合は e-Gov API のキーワード検索にフォールバックします。
+e-Gov API は告示を収録していないため、`get_kokuji` は国土交通省の告示・通達データベース（Excel → PDF）から正式名称で動的に取得します。見つからない場合は e-Gov API のキーワード検索にフォールバックします。
 
-| 告示名                                                                                       | 分野                     |
-| -------------------------------------------------------------------------------------------- | ------------------------ |
-| 耐火構造の構造方法を定める件                                                                 | 防火・耐火               |
-| 準耐火構造の構造方法を定める件                                                               | 防火・耐火               |
-| 防火構造の構造方法を定める件                                                                 | 防火・耐火               |
-| 不燃材料を定める件                                                                           | 防火・耐火               |
-| 採光に有効な部分の面積の算定方法を定める件                                                   | 採光                     |
-| 避難安全検証法に関する算出方法等を定める件                                                   | 避難                     |
-| 許容応力度計算等の方法を定める件                                                             | 構造                     |
-| 建築物エネルギー消費性能基準等を定める省令における算出方法等に係る事項                       | 省エネ（UA値）           |
-| 住宅部分の外壁、窓等を通しての熱の損失の防止に関する基準及び一次エネルギー消費量に関する基準 | 省エネ（断熱等性能等級） |
+ハードコードされたプリセットは持たず、常に最新の告示データベースから取得するため、改正後も陳腐化しません。
+
+```
+耐火構造の構造方法を定める件を取得して
+→ get_kokuji(kokuji_name="耐火構造の構造方法を定める件")
+
+木造建築物の軸組の設置の基準を定める件を取得して
+→ get_kokuji(kokuji_name="木造建築物の軸組の設置の基準を定める件")
+```
 
 ## 法令解決の仕組み
 
@@ -539,7 +562,7 @@ e-Gov API は告示を収録していないため、`get_kokuji` は国土交通
   "mcpServers": {
     "building-standards-act": {
       "command": "npx",
-      "args": ["-y", "building-standards-act-mcp"],
+      "args": ["-y", "building-standards-act-mcp@latest"],
       "env": {
         "BUILDING_LAW_CACHE": "file"
       }
@@ -563,7 +586,7 @@ e-Gov API は告示を収録していないため、`get_kokuji` は国土交通
 | API 並行呼び出し             | 最大 5 並行（200ms 間隔）        |
 | Vercel デプロイ              | 対応（MCP-over-HTTP + REST API） |
 | Vercel 関数タイムアウト      | 60 秒（maxDuration）             |
-| Node.js                      | >= 20.0.0                        |
+| Node.js                      | >= 22.12.0                       |
 
 ## セキュリティ
 

package/dist/data/kokuji-term-aliases.d.ts

@@ -0,0 +1,2 @@
+/** Append distinct provision aliases while preserving the user's original text. */
+export declare function expandKokujiAliases(text: string): string;

package/dist/data/kokuji-term-aliases.js

@@ -0,0 +1,21 @@
+/** Terms absent from the legacy MLIT titles; keep aliases tied to provisions. */
+const KOKUJI_TERM_ALIASES = {
+    // Reiwa 6 MLIT Notice 447 moved wall-quantity rules to Showa 56 Notice 1100, titled with Order Article 46(4).
+    壁量: "令46条4項",
+    // Required wall quantity is governed by the same Order Article 46(4) rule in Showa 56 Notice 1100.
+    必要壁量: "令46条4項",
+    // Wall-quantity calculations use Order Article 46(4), named in the legacy title of Showa 56 Notice 1100.
+    壁量計算: "令46条4項",
+    // Wall-quantity standards moved under Showa 56 Notice 1100 through Reiwa 6 MLIT Notice 447.
+    壁量基準: "令46条4項",
+    // Existing wall quantity is assessed against the Order Article 46(4) wall-quantity rule.
+    存在壁量: "令46条4項",
+};
+/** Append distinct provision aliases while preserving the user's original text. */
+export function expandKokujiAliases(text) {
+    const targets = new Set(Object.entries(KOKUJI_TERM_ALIASES)
+        .filter(([term]) => text.includes(term))
+        .map(([, target]) => target));
+    return [text, ...targets].join(" ");
+}
+//# sourceMappingURL=kokuji-term-aliases.js.map

package/dist/data/kokuji-term-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kokuji-term-aliases.js","sourceRoot":"","sources":["../../src/data/kokuji-term-aliases.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,mBAAmB,GAAqC;IAC5D,8GAA8G;IAC9G,EAAE,EAAE,QAAQ;IACZ,mGAAmG;IACnG,IAAI,EAAE,QAAQ;IACd,yGAAyG;IACzG,IAAI,EAAE,QAAQ;IACd,4FAA4F;IAC5F,IAAI,EAAE,QAAQ;IACd,yFAAyF;IACzF,IAAI,EAAE,QAAQ;CACf,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAC/B,CAAC;IACF,OAAO,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/lib/article-analyzer.js

@@ -1,5 +1,4 @@
-import { getLawData } from "./egov-client.js";
-import { parseArticleStructured } from "./egov-parser.js";
+import { fetchParsedArticle } from "./article-fetcher.js";
 import { formatArticleRef } from "./errors.js";
 import { resolveLawId } from "./law-resolver.js";
 const PREVIEW_LENGTH = 100;
@@ -60,8 +59,8 @@ export async function analyzeArticle(lawName, articleNumber) {
     if (!resolved) {
         throw new Error(`法令「${lawName}」が見つかりませんでした。`);
     }
-    const lawData = await getLawData(resolved.law_id);
-    const article = parseArticleStructured(lawData.law_full_text, articleNumber);
+    const fetched = await fetchParsedArticle(resolved.law_id, articleNumber, "structured");
+    const article = fetched?.article;
     if (!article) {
         throw new Error(`${resolved.title}に${formatArticleRef(articleNumber)}が見つかりませんでした。`);
     }

package/dist/lib/article-analyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"article-analyzer.js","sourceRoot":"","sources":["../../src/lib/article-analyzer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"article-analyzer.js","sourceRoot":"","sources":["../../src/lib/article-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/lib/article-fetcher.d.ts

@@ -0,0 +1,12 @@
+import type { EgovLawDataResponse, EgovRevisionInfo, ParsedArticle, StructuredArticle } from "./types.js";
+export interface FetchedArticle<T> {
+    article: T;
+    revision?: Pick<EgovRevisionInfo, "law_revision_id" | "amendment_enforcement_date" | "current_revision_status">;
+    revisionNote?: string;
+}
+/** Choose the smallest API response that can satisfy the request. */
+export declare function fetchArticleData(lawId: string, articleNumber: string): Promise<EgovLawDataResponse | null>;
+/** Resolve amendment supplements against a matching revision only after a miss. */
+export declare function fetchParsedArticle(lawId: string, articleNumber: string, format?: "text"): Promise<FetchedArticle<ParsedArticle> | null>;
+export declare function fetchParsedArticle(lawId: string, articleNumber: string, format: "structured"): Promise<FetchedArticle<StructuredArticle> | null>;
+export declare function fetchParsedArticle(lawId: string, articleNumber: string, format: "text" | "structured"): Promise<FetchedArticle<ParsedArticle | StructuredArticle> | null>;

package/dist/lib/article-fetcher.js

@@ -0,0 +1,65 @@
+import { getLawArticle, getLawData, getLawDataByRevision, getLawRevisions, } from "./egov-client.js";
+import { detectSpecialSection, findAmendmentSupplProvision, getSupplProvisionArticleNumbers, matchAmendLawNum, parseArticle, parseArticleStructured, toArticleElm, } from "./egov-parser.js";
+import { ArticleNotFoundError } from "./errors.js";
+/** Choose the smallest API response that can satisfy the request. */
+export async function fetchArticleData(lawId, articleNumber) {
+    const elm = toArticleElm(articleNumber);
+    return elm !== null ? await getLawArticle(lawId, elm) : await getLawData(lawId);
+}
+export async function fetchParsedArticle(lawId, articleNumber, format = "text") {
+    const data = await fetchArticleData(lawId, articleNumber);
+    if (!data)
+        return null;
+    const parse = format === "structured" ? parseArticleStructured : parseArticle;
+    const article = parse(data.law_full_text, articleNumber);
+    if (article)
+        return { article };
+    const special = detectSpecialSection(articleNumber);
+    if (special?.type !== "suppl_amendment" &&
+        special?.type !== "suppl_amendment_article") {
+        return null;
+    }
+    const revisions = await getLawRevisions(lawId);
+    const revision = revisions.revisions.find((entry) => entry.law_revision_id !== data.revision_info.law_revision_id &&
+        matchAmendLawNum(special.amendLawNum, entry.amendment_law_num));
+    let missingData = data;
+    if (revision) {
+        const revisionData = await getLawDataByRevision(revision.law_revision_id);
+        const revisedArticle = parse(revisionData.law_full_text, articleNumber);
+        if (revisedArticle) {
+            const metadata = {
+                law_revision_id: revision.law_revision_id,
+                amendment_enforcement_date: revision.amendment_enforcement_date,
+                current_revision_status: revision.current_revision_status,
+            };
+            const label = revision.current_revision_status === "UnEnforced"
+                ? "未施行の改正"
+                : "別の改正";
+            return {
+                article: revisedArticle,
+                revision: metadata,
+                revisionNote: `※ この附則は${label}（施行日 ${revision.amendment_enforcement_date}）の法令データから取得しました。`,
+            };
+        }
+        if (findAmendmentSupplProvision(revisionData.law_full_text, special.amendLawNum)) {
+            missingData = revisionData;
+        }
+    }
+    if (special.type === "suppl_amendment_article") {
+        const suppl = findAmendmentSupplProvision(missingData.law_full_text, special.amendLawNum);
+        if (suppl) {
+            const numbers = getSupplProvisionArticleNumbers(suppl).map((num) => {
+                const [main, ...branches] = num.split("_");
+                return `第${main}条${branches.map((branch) => `の${branch}`).join("")}`;
+            });
+            const title = missingData.revision_info.law_title;
+            const qualifier = suppl.attr?.["Extract"] === "true" ? "は抄録で、" : "には";
+            const contents = numbers.length > 0
+                ? `${numbers.join("・")}のみ収録されています。`
+                : "条番号付きの条文は収録されていません。";
+            throw new ArticleNotFoundError(articleNumber, title, `${title}の附則（${special.amendLawNum}）${qualifier}${contents}`);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=article-fetcher.js.map

package/dist/lib/article-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-fetcher.js","sourceRoot":"","sources":["../../src/lib/article-fetcher.ts"],"names":[],"mappings":"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"}

package/dist/lib/article-ref.d.ts

@@ -0,0 +1,14 @@
+/** A reference and its source span; numeral strings retain kanji spelling. */
+export interface ArticleRef {
+    law?: string;
+    article: string;
+    branches: string[];
+    paragraph?: string;
+    item?: string;
+    start: number;
+    end: number;
+}
+/** Parse bare references and explicit law names without assuming a law context. */
+export declare function parseArticleRefs(text: string): ArticleRef[];
+/** Render the kanji reference form used in notice titles, without the law name. */
+export declare function formatArticleRef(ref: ArticleRef): string;

package/dist/lib/article-ref.js

@@ -0,0 +1,52 @@
+const NUMERAL = "[0-9０-９〇零一二三四五六七八九十百千万億兆]+";
+const LAW = "[\\u4E00-\\u9FFF]+(?:法(?:施行令|施行規則)?|施行令|規則)|施行令|規則|法|令";
+/** Parse bare references and explicit law names without assuming a law context. */
+export function parseArticleRefs(text) {
+    const pattern = new RegExp(`(?:(${LAW})\\s*)?第?(${NUMERAL})条((?:の第?${NUMERAL})*)(?:第?(${NUMERAL})項)?(?:第?(${NUMERAL})号)?`, "g");
+    return [...text.matchAll(pattern)].map((match) => {
+        const prefix = match[1];
+        const law = prefix === "法"
+            ? "建築基準法"
+            : prefix === "令" || prefix === "施行令"
+                ? "建築基準法施行令"
+                : prefix;
+        return {
+            law,
+            article: match[2],
+            branches: match[3] ? match[3].split("の").slice(1) : [],
+            paragraph: match[4],
+            item: match[5],
+            start: match.index,
+            end: match.index + match[0].length,
+        };
+    });
+}
+function integerToKanji(value) {
+    const digits = "〇一二三四五六七八九";
+    for (const [unit, label] of [
+        [1_0000_0000_0000, "兆"], [1_0000_0000, "億"], [1_0000, "万"],
+        [1000, "千"], [100, "百"], [10, "十"],
+    ]) {
+        if (value < unit)
+            continue;
+        const count = Math.floor(value / unit);
+        const prefix = count === 1 && unit <= 1000 ? "" : integerToKanji(count);
+        const remainder = value % unit;
+        return prefix + label + (remainder ? integerToKanji(remainder) : "");
+    }
+    return digits[value];
+}
+function formatNumeral(value) {
+    const normalized = value.replace(/^第/, "").replace(/[０-９]/g, (digit) => String(digit.charCodeAt(0) - "０".charCodeAt(0)));
+    return /^\d+$/.test(normalized)
+        ? integerToKanji(Number(normalized))
+        : normalized;
+}
+/** Render the kanji reference form used in notice titles, without the law name. */
+export function formatArticleRef(ref) {
+    return `第${formatNumeral(ref.article)}条`
+        + ref.branches.map((branch) => `の${formatNumeral(branch)}`).join("")
+        + (ref.paragraph ? `第${formatNumeral(ref.paragraph)}項` : "")
+        + (ref.item ? `第${formatNumeral(ref.item)}号` : "");
+}
+//# sourceMappingURL=article-ref.js.map

package/dist/lib/article-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-ref.js","sourceRoot":"","sources":["../../src/lib/article-ref.ts"],"names":[],"mappings":"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"}

package/dist/lib/article-schemas.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import type { StructuredSubitem } from "./types.js";
+export declare const parsedArticleSchema: z.ZodObject<{
+    article_num: z.ZodString;
+    article_caption: z.ZodString;
+    article_title: z.ZodString;
+    text: z.ZodString;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        raw_text: z.ZodString;
+        ref_type: z.ZodEnum<{
+            same_law: "same_law";
+            cross_law: "cross_law";
+            relative: "relative";
+            delegation: "delegation";
+            unknown: "unknown";
+        }>;
+        target_law: z.ZodOptional<z.ZodString>;
+        target_article: z.ZodOptional<z.ZodString>;
+        target_paragraph: z.ZodOptional<z.ZodString>;
+        target_item: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const structuredArticleSchema: z.ZodObject<{
+    article_num: z.ZodString;
+    article_caption: z.ZodString;
+    article_title: z.ZodString;
+    paragraphs: z.ZodArray<z.ZodObject<{
+        paragraph_num: z.ZodString;
+        paragraph_sentence: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            item_num: z.ZodString;
+            item_title: z.ZodString;
+            item_sentence: z.ZodString;
+            subitems: z.ZodArray<z.ZodType<StructuredSubitem, unknown, z.core.$ZodTypeInternals<StructuredSubitem, unknown>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    references: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        raw_text: z.ZodString;
+        ref_type: z.ZodEnum<{
+            same_law: "same_law";
+            cross_law: "cross_law";
+            relative: "relative";
+            delegation: "delegation";
+            unknown: "unknown";
+        }>;
+        target_law: z.ZodOptional<z.ZodString>;
+        target_article: z.ZodOptional<z.ZodString>;
+        target_paragraph: z.ZodOptional<z.ZodString>;
+        target_item: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;