poker-mcp 1.8.3 → 1.9.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Yoshihiro Hirao
+
+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

@@ -4,14 +4,53 @@ YAML-based input file management tool for radiation-shielding calculation code P
 
 ## 📋 クイック情報
 
-- **バージョン**: 1.6.0
+- **バージョン**: 1.9.8
+- **ツール数**: 36メソッド
 - **プロトコル**: MCP (Model Context Protocol) 1.0.0 完全準拠
 - **メインサーバー**: `src/mcp_server_stdio_v4.js`
 - **データ保存**: `~/.poker-mcp/`（`POKER_MCP_HOME`環境変数で変更可）
 - **核種データ**: `${POKER_INSTALL_PATH}/LIB/ICRP-07.NDX` を直接参照
 - **実行方式**: STDIO通信（MCPプロトコル標準）
 
-## 🆕 バージョン1.8.0〜1.8.1の新機能
+## 🆕 バージョン1.9.8の新機能
+
+### 📜 `poker_getSchema` — ファイル書式を JSON Schema で取得
+
+POKER が扱う4種類のファイルの書式を、機械可読な形で取得できます。
+
+```javascript
+poker_getSchema()                   // 入力 YAML
+poker_getSchema({ kind: "paths" })  // CAD から抽出した経路ファイル
+poker_getSchema({ kind: "summary" })
+poker_getSchema({ kind: "dose" })
+```
+
+スキーマは静的なファイルではなく、`poker_cui --schema` をその場で呼んで
+生成します。そのため実行環境の POKER の版と材料ライブラリに必ず一致し、
+`lib_material.dat` に材料を追加していれば、その材料も材料名の一覧
+（`$defs` の `x-poker-names`）に現れます。
+
+規定するのは書式・型・値域までです。参照の解決（`zone.body_name` が
+`body` に在るか）や名前の存在確認は従来どおり `poker_cui --validate`
+（`poker_executeCalculation` が内部で実施）の担当で、両者で役割が分かれます。
+
+`.dose` のスキーマには、YAML の頭部に続く数値表の読み方
+（ブロックの区切り・列の索引 `[dose, ray, energy]`・行の索引
+`i + j*number_i + k*number_i*number_j`）が `x-poker-data-layout` として
+書かれています。
+
+### 🐛 `poker_getDoseMap` が線量種別の増加に追随
+
+`.dose` の列構成を、線量種別3種・線種4種と決め打ちしていました。線量種別は
+ライブラリ設定で増えるため（`E(PA)` や空気カーマを足した場合）、その環境では
+誤った列を読むか、集計ブロックを見つけられず失敗していました。
+
+冒頭の `information` から `dose_type` / `ray_type` / 線源ごとの `energy_bin` を
+数えて列構成を決めるようにしました。1D/2D/3D 検出器の全評価点について、
+`.summary` の `statistics_total`（min/max）と一致することを
+`npm run test:schema` で検証しています。
+
+## 🆕 バージョン1.8.0〜1.8.3の新機能
 
 ### 📐 CAD連携が MCP だけで完結
 従来、CAD からの経路抽出は MCP を経由せず、FreeCAD を手で起動する必要が
@@ -19,6 +58,7 @@ YAML-based input file management tool for radiation-shielding calculation code P
 スクリプトを渡す。3 手順すべてが手作業でした。
 
 ```javascript
+poker_generateInput({ fcstd: "C:/path/to/model.FCStd" })   // YAML を生成
 poker_generatePaths({ fcstd: "C:/path/to/model.FCStd" })
 poker_executeCalculation({ yaml_file: "poker.yaml", path_input: "poker.paths" })
 ```
@@ -43,6 +83,15 @@ FreeCAD の場所を、環境変数 → PATH → 既定のインストール先
 解決されていました。MCP サーバの起動場所によっては別の場所を指します。
 
 
+### 📦 CAD連携ツールを npm パッケージに同梱（v1.8.2）
+`poker_generatePaths` が使う Python スクリプトが `files` に含まれておらず、
+GitHub から clone した環境でしか動きませんでした。`npm install` / `npx` でも
+使えるようにしています。
+
+### 🐛 サマリーの衝突を修正（v1.8.3）
+`generatePaths` が `-p` 付きで作ったサマリーを `executeCalculation` が上書きし、
+次に `generatePaths` を呼ぶと失敗していました。専用ファイルに分離しています。
+
 ## 🆕 バージョン1.7.0〜1.7.2の新機能
 
 ### 📉 サマリー出力量の制御（ThinnedIndices 操作系 3メソッド）
@@ -50,6 +99,9 @@ FreeCAD の場所を、環境変数 → PATH → 既定のインストール先
 線源分割点と検出器評価点が必要ですが、既定では間引かれるため手で書き足す
 必要がありました。
 
+**`poker_generatePaths` が自動で合わせる**ので、通常は意識する必要はありません。
+手で設定したい場合はこうします。
+
 ```javascript
 poker_updateThinnedIndices({ fit_for_paths: true })
 // → 入力の分割定義と検出器グリッドから必要数を計算して設定
@@ -104,16 +156,18 @@ poker_getThinnedIndices()
 
 ### 📡 CAD連携レイトレース
 FreeCAD のソリッドモデルを、STEP のような中間フォーマットを介さず、CSG で
-表現し直す作業も無しに遮蔽体系として扱えます。**MCP の 2 呼び出しで完結**します。
+表現し直す作業も無しに遮蔽体系として扱えます。**MCP の 3 呼び出しで完結**します。
 
 ```javascript
+poker_generateInput({ fcstd: "C:/path/to/model.FCStd" })
 poker_generatePaths({ fcstd: "C:/path/to/model.FCStd" })
 poker_executeCalculation({ yaml_file: "poker.yaml", path_input: "poker.paths" })
 ```
 
+CAD が正本です。**YAML を手で書く必要はありません。** ソリッドに材質・線源・
+検出器をカスタムプロパティで設定しておけば、そこから入力が生成されます。
 線源点→検出器の直線を FreeCAD 側で追跡し、通過した材質と厚さを `.paths` に
-記録して POKER に渡します。分割点の取得、グリッド検出器の展開、ビルドアップ
-等価材料の解決はすべて自動です。
+記録して POKER に渡します。
 
 CSG 経由と一致することを平板・円筒・球の 5 体系で確認済みです。フィレットや
 自由曲面のように CSG で表現できない形状も扱えます。**複数線源・グリッド検出器・
@@ -156,6 +210,7 @@ numpy はレイトレーサが使いますが、FreeCAD に同梱されている
 他の CAD で作ったモデルを STEP で読み込んだ場合、材質情報は失われるので
 FreeCAD 上で設定してください。一度設定すれば `.FCStd` に保存されます。
 
+まずは [CAD_QUICKSTART.md](./docs/manuals/CAD_QUICKSTART.md)（最短手順と実例）を、
 詳細は [CAD_RAYTRACE.md](./docs/manuals/CAD_RAYTRACE.md)、フォーマットは
 [PATHS_FORMAT.md](./docs/manuals/PATHS_FORMAT.md)。
 
@@ -401,14 +456,14 @@ Claude Desktopで以下のようにテストできます：
 ## 🏆 主要機能
 
 ### ✅ **MCP完全対応**
-- **34メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
+- **36メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
 - **JSON-RPC 2.0準拠**: 標準プロトコル完全対応
 - **STDIO通信**: MCPクライアントとの標準通信方式
 - **自動バックアップ・ロールバック**: 企業品質のデータ保護
 
 ### ✅ **放射線遮蔽計算専用設計**
 - **10種類の立体形状**: SPH, RCC, RPP, BOX, CMB, TOR, ELL, REC, TRC, WED
-- **14種類の材料**: コンクリート、鉛、鉄、VOID等標準遮蔽材料
+- **23種類の材料**: 鉄・鉛・コンクリート（普通/重量3種）・SUS・ポリエチレン等（`lib_material.dat` から読み込み）
 - **複数線源対応**: 点・体積線源の完全管理
 - **検出器配置**: 0D/1D/2D/3D検出器の柔軟な配置
 
@@ -420,7 +475,7 @@ Claude Desktopで以下のようにテストできます：
 
 ## 🎯 API構成
 
-### 🔧 **34メソッド完全実装**
+### 🔧 **36メソッド完全実装**
 
 | **カテゴリ** | **メソッド数** | **機能** | **主要操作** |
 |-------------|---------------|----------|-------------|
@@ -431,9 +486,12 @@ Claude Desktopで以下のようにテストできます：
 | **📡 Source** | 3個 | 線源管理 | propose・update・delete |
 | **🎯 Detector** | 3個 | 検出器管理 | propose・update・delete |
 | **📏 Unit** | 5個 | 単位設定管理 | propose・get・update・validateIntegrity・analyzeConversion |
-| **⚙️ System** | 6個 | システム制御 | applyChanges・executeCalculation・resetYaml・confirmDaughterNuclides・openGui・各種検証 |
+| **📉 ThinnedIndices** | 3個 | サマリー出力量の制御 | propose・get・update |
+| **📐 CAD** | 2個 | CAD から入力と経路を生成 | generateInput・generatePaths |
+| **⚙️ System** | 6個 | システム制御 | applyChanges・executeCalculation・resetYaml・confirmDaughterNuclides・openGui・getDoseMap |
+| **📜 Schema** | 1個 | ファイル書式の取得 | getSchema |
 
-### 📋 **全34メソッド一覧**
+### 📋 **全36メソッド一覧**
 ```
 Body系 (3):          poker_proposeBody, poker_updateBody, poker_deleteBody
 Zone系 (3):          poker_proposeZone, poker_updateZone, poker_deleteZone  
@@ -444,8 +502,12 @@ Source系 (3):        poker_proposeSource, poker_updateSource, poker_deleteSourc
 Detector系 (3):      poker_proposeDetector, poker_updateDetector, poker_deleteDetector
 Unit系 (5):          poker_proposeUnit, poker_getUnit, poker_updateUnit,
                      poker_validateUnitIntegrity, poker_analyzeUnitConversion
+ThinnedIndices系 (3): poker_proposeThinnedIndices, poker_getThinnedIndices,
+                     poker_updateThinnedIndices
+CAD系 (2):           poker_generateInput, poker_generatePaths
 System系 (6):        poker_applyChanges, poker_executeCalculation, poker_resetYaml,
-                     poker_confirmDaughterNuclides, poker_openGui, 内部検証メソッド群
+                     poker_confirmDaughterNuclides, poker_openGui, poker_getDoseMap
+Schema系 (1):        poker_getSchema
 ```
 
 ## 📁 プロジェクト構造
@@ -462,9 +524,10 @@ poker_mcp/
 │   │   ├── logger.js                # ログ出力（絶対パス）
 │   │   └── ...
 │   └── 📁 config/                   # 設定管理
+├── 📁 tools/                        # 🔧 CAD連携（レイトレーサ・経路生成）
 ├── 📁 docs/                         # 📚 完全ドキュメント
 ├── .mcp.json                        # MCPクライアント接続設定
-├── package.json                     # パッケージ定義（v1.2.6）
+├── package.json                     # パッケージ定義
 └── README.md                        # このファイル
 
 # 実行時に自動作成されるディレクトリ（POKER_MCP_HOME配下）
@@ -542,7 +605,7 @@ POKER_MCP_HOME/
 
 ### **✅ 放射線遮蔽計算特化**
 - **物理的妥当性**: 全パラメータの物理検証
-- **材料データベース**: 標準遮蔽材料14種完備
+- **材料データベース**: 標準遮蔽材料23種（lib_material.dat 準拠）
 - **単位系管理**: 4キー完全性保証（長さ・角度・密度・放射能）
 - **計算品質保証**: 自動整合性チェック
 
@@ -562,6 +625,7 @@ POKER_MCP_HOME/
 
 - **POKER**: 放射線遮蔽計算メインコード
 - **poker_cui**: コマンドライン実行インターフェース
+- **FreeCAD**: CAD連携レイトレース（`poker_generatePaths` を使う場合のみ）
 
 ## 🔗 システム要件
 
@@ -569,6 +633,8 @@ POKER_MCP_HOME/
 - **OS**: Windows, macOS, Linux
 - **MCP Client**: Claude Desktop (推奨)、その他MCPクライアント
 - **メモリ**: 512MB以上推奨（大規模検出器使用時は1GB以上）
+- **POKER 本体**: v2.1.5 以降（`POKER_INSTALL_PATH` で場所を指定）
+- **FreeCAD**: 1.0 以降（CAD連携を使う場合。`FREECAD_PATH`、未設定なら自動探索）
 
 ## 🎯 実際の使用ワークフロー
 
@@ -593,6 +659,41 @@ POKER_MCP_HOME/
 
 ## 📝 更新履歴
 
+### v1.9.8 (2026-10)
+- ✨ `poker_getSchema`（入力YAML・`.paths`・`.summary`・`.dose` の書式を JSON Schema で取得）
+- 🐛 `poker_getDoseMap` が `.dose` の列構成を `information` から読むようになり、線量種別の増加に追随
+- ✅ `npm run test:schema` を追加
+
+### v1.9.0〜v1.9.7 (2026-09)
+- ✨ `poker_generateInput`（CAD から入力 YAML を生成）
+- ✨ `generatePaths` が `thinnedindices` を `.paths` 生成に必要な値へ自動調整
+- ✨ `.paths` の座標・個数照合を強化
+
+### v1.8.0〜v1.8.3 (2026-09)
+- ✨ CAD連携が MCP だけで完結（`poker_generatePaths` と `path_input`）
+- ✨ `FREECAD_PATH` 環境変数（未設定なら PATH と既定の場所を自動探索）
+- 🐛 相対パスの解決をプロセスのカレントから `TASKS_DIR` 基準に修正
+- 🐛 `generatePaths` と `executeCalculation` のサマリー衝突を修正
+
+### v1.7.0〜v1.7.2 (2026-09)
+- ✨ ThinnedIndices 操作系 3メソッド（サマリー出力量の制御）
+- ✨ `get` 系が保留中の変更を `pending` として併記
+- ✨ `.paths` の座標照合（検出器を動かして再生成し忘れた場合を検出）
+
+### v1.6.0 (2026-09)
+- ✨ CAD連携レイトレースのツール群と `.paths` フォーマット
+- ✨ 材料システムを `lib_material.dat` 準拠に
+
+### v1.5.0 (2026-08)
+- ✨ `poker_openGui` で POKER を閉じずに表示を切り替え（POKER 2.1.1 以降）
+- 🐛 起動失敗時の偽の成功報告を修正
+
+### v1.4.0 (2026-07)
+- ✨ 子孫核種の自動管理（ICRP-07 準拠）
+
+### v1.3.0 (2026-06)
+- ✨ `poker_getDoseMap`（グリッド検出器の線量マップ取得）
+
 ### v1.2.8 (2026-05-16)
 - ✨ `poker_openGui` メソッドを新設（POKER.exe でGUI確認）
 - ✨ 起動前に `applyChanges` を自動実行
@@ -628,6 +729,16 @@ POKER_MCP_HOME/
 - 初期リリース
 - YAML管理基本機能
 
+## 📜 ライセンス
+
+**MIT License** — 著作権 (c) 2025-2026 Yoshihiro Hirao。全文は
+[LICENSE](LICENSE) を参照してください。
+
+このライセンスが及ぶのは本リポジトリの内容（poker-mcp）だけです。POKER itself is
+obtained separately and licensed separately. poker-mcp は `poker_cui` を外部
+プロセスとして起動するだけなので、POKER 本体の許諾には影響しません。FreeCAD も
+別途入手が必要で、それぞれのライセンスに従います。
+
 ## 📞 サポート・詳細情報
 
 - **📖 詳細README**: [docs/README.md](docs/README.md)
@@ -638,6 +749,6 @@ POKER_MCP_HOME/
 
 ---
 
-**🎯 Poker MCP Server v1.4.0**  
+**🎯 Poker MCP Server v1.9.8**  
 **プロトコル**: MCP 1.0.0 完全準拠  
-**作者**: Yoshihiro Hirao | **ライセンス**: ISC
+**作者**: Yoshihiro Hirao | **ライセンス**: MIT

package/package.json

@@ -1,62 +1,68 @@
-{
-  "name": "poker-mcp",
-  "version": "1.8.3",
-  "description": "YAML-based input file management tool for radiation shielding calculation code POKER with MCP support - Enhanced with collision detection, daughter nuclide auto-completion, and environment variable support",
-  "main": "src/mcp_server_stdio_v4.js",
-  "type": "module",
-  "bin": {
-    "poker-mcp": "src/mcp_server_stdio_v4.js"
-  },
-  "scripts": {
-    "start": "node src/mcp_server_stdio_v4.js",
-    "dev": "nodemon src/mcp_server_stdio_v4.js",
-    "prepare": "echo 'NPX ready: npx poker-mcp'",
-    "check:manifest": "node scripts/check-manifest-sync.mjs",
-    "test:pending": "node tests/pending-view.test.mjs",
-    "test:cad": "node tests/cad-e2e.test.mjs"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "yaml",
-    "radiation",
-    "shielding",
-    "nuclear",
-    "radioisotope",
-    "medical",
-    "accelerator",
-    "POKER",
-    "physics",
-    "validation",
-    "npx",
-    "point-kernel",
-    "collision-detection",
-    "daughter-nuclide"
-  ],
-  "author": "Yoshihiro Hirao <tora@pointkernel.com>",
-  "license": "ISC",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Hirao-Y/poker_mcp.git"
-  },
-  "homepage": "https://github.com/Hirao-Y/poker_mcp#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "js-yaml": "^4.1.0",
-    "winston": "^3.17.0",
-    "zod": "^3.24.2"
-  },
-  "files": [
-    "src/",
-    "tools/gen_paths.py",
-    "tools/ray_trace_tri.py",
-    "tools/poker_lib.py",
-    "tools/audit_mfp.py",
-    "tools/compare_poker_trace.py",
-    "README.md",
-    ".mcp.json"
-  ]
-}
+{
+  "name": "poker-mcp",
+  "version": "1.9.8",
+  "description": "YAML-based input file management tool for radiation shielding calculation code POKER with MCP support - Enhanced with collision detection, daughter nuclide auto-completion, and environment variable support",
+  "main": "src/mcp_server_stdio_v4.js",
+  "type": "module",
+  "bin": {
+    "poker-mcp": "src/mcp_server_stdio_v4.js"
+  },
+  "scripts": {
+    "start": "node src/mcp_server_stdio_v4.js",
+    "dev": "nodemon src/mcp_server_stdio_v4.js",
+    "prepare": "echo 'NPX ready: npx poker-mcp'",
+    "check:manifest": "node scripts/check-manifest-sync.mjs",
+    "test:pending": "node tests/pending-view.test.mjs",
+    "test:cad": "node tests/cad-e2e.test.mjs",
+    "test:cad-full": "node tests/cad-full.test.mjs",
+    "test:cad-validate": "node tests/cad-validate.test.mjs",
+    "test:cad-pipe": "node tests/cad-pipe.test.mjs",
+    "test:cad-thinned": "node tests/cad-thinned-fit.test.mjs",
+    "test:schema": "node tests/schema-dose.test.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "yaml",
+    "radiation",
+    "shielding",
+    "nuclear",
+    "radioisotope",
+    "medical",
+    "accelerator",
+    "POKER",
+    "physics",
+    "validation",
+    "npx",
+    "point-kernel",
+    "collision-detection",
+    "daughter-nuclide"
+  ],
+  "author": "Yoshihiro Hirao <tora@pointkernel.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hirao-Y/poker_mcp.git"
+  },
+  "homepage": "https://github.com/Hirao-Y/poker_mcp#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "js-yaml": "^4.1.0",
+    "winston": "^3.17.0",
+    "zod": "^3.24.2"
+  },
+  "files": [
+    "src/",
+    "tools/gen_paths.py",
+    "tools/ray_trace_tri.py",
+    "tools/poker_lib.py",
+    "tools/audit_mfp.py",
+    "tools/compare_poker_trace.py",
+    "README.md",
+    "LICENSE",
+    ".mcp.json"
+  ]
+}

package/src/mcp/handlers/cadHandlers.js

@@ -13,6 +13,7 @@ import path from 'path';
 import { FREECAD_CMD, CAD_TOOLS_DIR, POKER_INSTALL_DIR, TASKS_DIR, YAML_FILE }
   from '../../utils/paths.js';
 import { logger } from '../../utils/logger.js';
+import { reconcileInventory } from '../../utils/DaughterReconciler.js';
 import { MaterialCatalog } from '../../utils/MaterialCatalog.js';
 
 function run(cmd, args, opts = {}) {
@@ -55,6 +56,30 @@ export function createCadHandlers(taskManager) {
         return fail('入力 YAML がありません: ' + yamlFile,
           'applyChanges で入力を確定してから実行してください。');
 
+      // --- thinnedindices を全点が出る値に合わせる ---
+      //   .paths の生成には、線源の全分割点と検出器の全評価点が要る。
+      //   thinnedindices が小さいままだと、サマリーに一部しか出ず、経路が
+      //   足りない .paths ができてしまう。利用者が updateThinnedIndices を
+      //   呼び忘れても起きないよう、ここで自動的に合わせる。
+      //
+      //   .paths を作らない通常の計算では全点が出る必要はないので、この調整は
+      //   generatePaths のときだけ行う。
+      let thinnedNote = null;
+      try {
+        const before = JSON.stringify(taskManager.data?.thinnedindices ?? {});
+        await taskManager.updateThinnedIndices({ fit_for_paths: true });
+        await taskManager.applyChanges();
+        const after = JSON.stringify(taskManager.data?.thinnedindices ?? {});
+        if (before !== after) {
+          thinnedNote = 'thinnedindices を入力の分割数・評価点数に合わせました';
+          logger.info(thinnedNote, { thinnedindices: taskManager.data?.thinnedindices });
+        }
+      } catch (e) {
+        // 合わせられなくても処理は続ける。点が足りなければ gen_paths.py が
+        // エラーにするので、黙って誤った .paths ができることはない。
+        logger.warn('thinnedindices の自動調整に失敗しました', { error: e.message });
+      }
+
       // --- 1. poker_cui -p で分割点と評価点を出す ---
       // .paths には全点が必要。間引かれていると gen_paths.py がエラーにする。
       const exe = path.join(POKER_INSTALL_DIR, 'poker_cui.EXE');
@@ -185,10 +210,186 @@ export function createCadHandlers(taskManager) {
               freecad: FREECAD_CMD,
               poker_dir: spec.poker_dir
             },
+            // thinnedindices を調整した場合だけ知らせる（毎回出すと煩わしい）
+            ...(thinnedNote ? { note: thinnedNote } : {}),
             next: 'poker_cui "' + yamlFile + '" --path-input "' + out + '" -t で計算できます'
           }, null, 2)
         }]
       };
-    }
+    },
+    async generateInput(args) {
+      const fail = (msg, hint) => ({
+        content: [{
+          type: 'text',
+          text: JSON.stringify({ success: false, error: msg, hint }, null, 2)
+        }],
+        isError: true
+      });
+
+      if (!FREECAD_CMD) {
+        return fail(
+          'FreeCAD が見つかりません',
+          '環境変数 FREECAD_PATH に freecadcmd の場所を設定してください。');
+      }
+      if (!args || !args.fcstd) return fail('fcstd を指定してください');
+      if (!fssync.existsSync(args.fcstd))
+        return fail('CAD ファイルが見つかりません: ' + args.fcstd);
+
+      const out = args.output || YAML_FILE;
+      // 既存の YAML はバックアップしてから上書きする。
+      //   CAD が正本なので YAML は生成物であり、毎回 overwrite を
+      //   求めるのは煩わしいだけ。退避先は applyChanges と同じ
+      //   backups/ に混ぜる。CAD 連携と手動編集が同じセッションで
+      //   混ざるので、区別しても探しにくくなるだけ。
+      let backedUp = false;
+      if (fssync.existsSync(out) && out === YAML_FILE) {
+        try {
+          await taskManager.dataManager.createBackup();
+          backedUp = true;
+        } catch (e) {
+          logger.warn('バックアップに失敗（生成は続行）', { error: e.message });
+        }
+      }
+
+      // --- 1. CAD から線源の核種を読み、子孫核種を補完する ---
+      //   まず核種だけを抜き出すために FreeCAD を一度呼ぶ。
+      const probe = path.join(TASKS_DIR, '.probe_nuclides.py');
+      const probeOut = path.join(TASKS_DIR, '.probe_nuclides.json');
+      await fs.writeFile(probe,
+        'import FreeCAD as App, json, os\n' +
+        'd = App.openDocument(r"' + args.fcstd + '")\n' +
+        'out = {}\n' +
+        'for o in d.Objects:\n' +
+        '    r = (getattr(o, "PokerRole", None) or "shield").strip().lower()\n' +
+        '    if r != "source":\n' +
+        '        continue\n' +
+        '    out[o.Name] = getattr(o, "PokerNuclides", None) or ""\n' +
+        'json.dump(out, open(r"' + probeOut + '", "w"), ensure_ascii=False)\n',
+        'utf8');
+
+      const r0 = await run(FREECAD_CMD, [probe], { cwd: TASKS_DIR });
+      let nuclides = null;
+      let daughterNote = null;
+      if (fssync.existsSync(probeOut)) {
+        const raw = JSON.parse(await fs.readFile(probeOut, 'utf8'));
+        nuclides = {};
+        const added = [];
+        for (const [name, text] of Object.entries(raw)) {
+          const inv = [];
+          for (const part of String(text).split(/[,;]/)) {
+            const m = part.trim().match(/^([A-Za-z]+[-_]?\d+m?)\s*[:=]\s*([\d.eE+-]+)$/);
+            if (m) inv.push({
+              nuclide: m[1].replace(/[-_]/g, ''),
+              radioactivity: parseFloat(m[2])
+            });
+          }
+          if (!inv.length) continue;
+          try {
+            const rec = await reconcileInventory(inv,
+              { nuclideManager: taskManager.dataManager.nuclideManager });
+            nuclides[name] = rec.inventory;
+            for (const a of (rec.added || [])) added.push(name + ': ' + a.nuclide);
+          } catch (e) {
+            nuclides[name] = inv;
+            logger.warn('子孫核種の補完に失敗', { source: name, error: e.message });
+          }
+        }
+        if (added.length) daughterNote = '子孫核種を補完しました: ' + added.join(', ');
+      }
+
+      // --- 2. gen_input.py で YAML を組み立てる ---
+      const spec = {
+        fcstd: args.fcstd.replace(/\\/g, '/'),
+        out: out.replace(/\\/g, '/'),
+        poker_dir: POKER_INSTALL_DIR.replace(/\\/g, '/'),
+      };
+      if (nuclides && Object.keys(nuclides).length) spec.nuclides = nuclides;
+
+      const specFile = path.join(TASKS_DIR, '.generate_input_spec.json');
+      await fs.writeFile(specFile, JSON.stringify(spec, null, 2), 'utf8');
+
+      const script = path.join(TASKS_DIR, '.generate_input.py');
+      await fs.writeFile(script,
+        'import sys, traceback\n' +
+        'sys.path.insert(0, r"' + CAD_TOOLS_DIR + '")\n' +
+        'try:\n' +
+        '    import gen_input\n' +
+        '    gen_input.main(r"' + specFile + '")\n' +
+        '    print("GEN_INPUT_OK")\n' +
+        'except BaseException:\n' +
+        '    print("GEN_INPUT_ERROR")\n' +
+        '    traceback.print_exc()\n', 'utf8');
+
+      const r1 = await run(FREECAD_CMD, [script], { cwd: TASKS_DIR });
+      const log = (r1.out || '') + (r1.err || '');
+      if (!log.includes('GEN_INPUT_OK') || !fssync.existsSync(out)) {
+        const m = log.match(/(?:SystemExit|Error|Exception)[^\n]*(?:\n[^\n]*){0,3}/);
+        return fail('入力の生成に失敗しました', m ? m[0].trim() : log.slice(-500));
+      }
+
+      // 生成した YAML をサーバのデータに反映する。
+      //   これが無いと、メモリ上には起動時に読んだ古い YAML が残る。続けて
+      //   generatePaths を呼んだとき、ゾーンから材質を読めず等価材料を解決
+      //   できない（SUS_A -> Iron の読み替えが効かず "no buildup data" で失敗）。
+      if (out === YAML_FILE) {
+        try {
+          await taskManager.dataManager.loadData();
+        } catch (e) {
+          logger.warn('生成後のデータ再読み込みに失敗', { error: e.message });
+        }
+      }
+
+      // --- 3. 生成した入力を POKER に検証させる ---
+      //   poker_cui -c は線量計算をせず、入力の妥当性確認と経路追跡だけ行う。
+      //   これを通しておけば、線源が遮蔽体の外にある、材質名がライブラリに
+      //   無い、立体が重なっている、といった誤りを生成の時点で捕まえられる。
+      //   利用者が計算まで進んでから気づくより早い。
+      let validation = null;
+      {
+        const exe2 = path.join(POKER_INSTALL_DIR, 'poker_cui.EXE');
+        if (fssync.existsSync(exe2)) {
+          const rv = await run(exe2, [out, '-c'], { cwd: TASKS_DIR });
+          if (rv.code === 0) {
+            validation = { ok: true, message: 'poker_cui -c で検証を通過しました' };
+          } else {
+            const text = (rv.out || "") + (rv.err || "");
+            const m = text.match(/(?:ERROR|INPUT ERROR)[\s\S]{0,300}/);
+            validation = {
+              ok: false,
+              message: 'poker_cui -c で問題が見つかりました（終了コード ' + rv.code + '）',
+              detail: m ? m[0].trim() : text.slice(-300),
+            };
+          }
+        }
+      }
+
+      // --- 3. 生成結果を要約する ---
+      const text = await fs.readFile(out, 'utf8');
+      const count = (re) => (text.match(re) || []).length;
+      // YAML の節を切り出して、その中の "  - name:" を数える。
+      // 節をまたいで数えると線源と検出器が混ざる。
+      const sectionCount = (t, sec) => {
+        const m = t.split(new RegExp('^' + sec + ':', 'm'))[1];
+        if (!m) return 0;
+        const body = m.split(/^[a-z_]+:/m)[0];
+        return (body.match(/^  - name: /gm) || []).length;
+      };
+      const result = {
+        success: true,
+        message: '入力を生成しました',
+        output: out,
+        summary: {
+          材質数: count(/^  - body_name: REF_/gm),
+          線源数: sectionCount(text, 'source'),
+          検出器数: sectionCount(text, 'detector'),
+        },
+        next: 'poker_generatePaths で経路を抽出し、executeCalculation の path_input に渡してください',
+      };
+      if (daughterNote) result.note = daughterNote;
+      if (validation) result.validation = validation;
+
+      logger.info('CAD から入力を生成しました', { out, added: daughterNote });
+      return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    },
   };
 }