poker-mcp 1.2.8 → 1.5.0

package/.mcp.json

@@ -57,7 +57,7 @@
     },
     "supported_materials": {
       "count": 14,
-      "types": ["Carbon", "Concrete", "Iron", "Lead", "Aluminum", "Copper", "Tungsten", "Air", "Water", "PyrexGlass", "AcrylicResin", "Polyethylene", "Soil", "VOID"]
+      "types": ["Carbon", "Concrete", "Iron", "Lead", "Aluminium", "Copper", "Tungsten", "Air", "Water", "PyrexGlass", "AcrylicResin", "Polyethylene", "Soil", "VOID"]
     }
   },
   "data_configuration": {
@@ -66,14 +66,15 @@
     "pending_file": "tasks/pending_changes.json",
     "backup_directory": "backups",
     "logs_directory": "logs",
-    "data_directory": "data",
     "nuclide_database": {
-      "target_file": "data/ICRP-07.NDX",
+      "resolved_file": "${POKER_INSTALL_PATH}/LIB/ICRP-07.NDX",
       "source_env_var": "POKER_INSTALL_PATH",
-      "source_relative_path": "lib/ICRP-07.NDX",
+      "source_relative_path": "LIB/ICRP-07.NDX",
       "default_install_path": "C:/Poker",
-      "skip_if_exists": true,
-      "fallback_behavior": "error_if_missing"
+      "copy_to_workspace": false,
+      "legacy_fallback": "${POKER_MCP_HOME}/data/ICRP-07.NDX",
+      "fallback_behavior": "warn_then_error_if_missing",
+      "note": "v1.4.0 以降、POKER_INSTALL_PATH/LIB を直接参照する。ワークスペースへのコピーは行わない（POKER 更新時に古いコピーを読み続ける問題を回避）"
     }
   },
   "environment_variables": {
@@ -81,7 +82,7 @@
       "description": "POKERインストールディレクトリのパス",
       "required": false,
       "default": "C:/Poker",
-      "purpose": "lib/ICRP-07.NDXファイルの取得元ディレクトリ指定",
+      "purpose": "LIB/ICRP-07.NDX（核種データ）および LIB/lib_material.dat（材料カタログ）の参照元、POKER_CUI.exe / POKER.exe の実行元",
       "example_windows": "C:/Program Files/POKER",
       "example_linux": "/usr/local/share/poker"
     }

package/README.md

@@ -4,12 +4,91 @@ YAML-based input file management tool for radiation-shielding calculation code P
 
 ## 📋 クイック情報
 
-- **バージョン**: 1.2.8
+- **バージョン**: 1.5.0
 - **プロトコル**: 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.5.0の新機能
+
+### 🖥️ POKER GUI を閉じずに表示を切り替え
+`poker_openGui` で別の入力を指定すると、起動中の POKER ウィンドウの表示が
+そのまま切り替わります。従来は先に POKER を閉じる必要がありました。
+
+未保存の編集があるときは POKER 側で保存確認が出るため、編集内容が
+黙って失われることはありません（キャンセルすると切り替わりません）。
+
+> **POKER 2.1.1 以降が必要です。** 2.1.0 以前では従来どおり
+> `POKER_ALREADY_RUNNING` を返すので、先に POKER を閉じてください。
+
+### 🐛 `poker_openGui` の偽の成功報告を修正
+`spawn` の成否のみで判定していたため、POKER が二重起動で弾かれて即座に
+終了しても「起動しました」と PID 付きで成功を返していました。
+起動後の生存確認を追加し、実際に表示されたことを確認してから報告します。
+
+### 📖 ドキュメントの大幅整理
+`ADMIN_GUIDE.md` を実運用に即した内容へ全面改訂しました（699行 → 248行）。
+乱数で「正常」を出力する監視スクリプトなど、実態と乖離した記述を削除し、
+検証可能な手順のみに整理しています。
+
+詳細は [CHANGELOG.md](./CHANGELOG.md) を参照。
+
+## 🆕 バージョン1.4.0の新機能
+
+### ☢️ 子孫核種の自動管理
+親核種を指定すると子孫核種が自動生成され、**親の更新・削除に追随します**。
+Cs137 を入れれば Ba137m が分岐比 0.9439 で自動的に付き、Cs137 の放射能を
+2倍にすれば Ba137m も2倍になります。親を削除すれば娘も消えます。
+
+発火タイミングを `executeCalculation` 時から `proposeSource` / `updateSource`
+時へ移しました。モデル構築を終えた最後の段階で計算が中断することはなくなります。
+
+平衡型は親娘の半減期比で判定します（永続 / 過渡 / 平衡なし）。平衡が成立しない
+組み合わせは推定せず、警告を返して生成を見送ります。除外は線源ごとに記録され、
+親を何度更新しても復活しません。
+
+詳細は [docs/DAUGHTER_NUCLIDE_MANAGEMENT.md](./docs/DAUGHTER_NUCLIDE_MANAGEMENT.md)。
+
+> **POKER 2.1.0 以降が必要です。** 出自情報を保持する `x_meta` ノードを
+> POKER が受理する必要があります（`source` 直下と `inventory` 要素直下）。
+
+### 🐛 ICRP-07 パーサの重大な修正
+固定長の列位置が実データと一致しておらず、**全1252核種で子孫核種を1件も
+取得できていませんでした**。半減期も単位が崩壊形式側へ流出し、Cs137 を
+30.17年ではなく 30.17 **秒**と解釈していました（9桁の誤り）。
+
+修正後は 808 核種が子孫核種を持ちます。平衡判定は従来まったく機能して
+いなかったことになります。
+
+### 🐛 `reject` のグローバル無効化を修正
+1つの線源で子孫核種を拒否すると、セッション終了まで全線源の検出が無効に
+なっていました。線源ごとの管理に変更しています。
+
+### 🔧 核種データベースの参照先を LIB へ統一
+`POKER_MCP_HOME/data/` へのコピーを廃止し、`POKER_INSTALL_PATH/LIB/` を
+直接参照します。従来は「コピー先が存在すればスキップ」だったため、POKER を
+更新しても古いコピーを読み続けていました。
+
+詳細は [CHANGELOG.md](./CHANGELOG.md) を参照。
+
+## 🆕 バージョン1.3.0の新機能
+
+### ✨ `poker_getDoseMap` — グリッド検出器の線量マップ取得
+グリッド（線/面/体積 = 1D/2D/3D）検出器の全評価点の線量を `.dose` ファイルから取得します。サマリーはグリッド点を間引く（`一部省略`）ため、完全なマップは本ツールで取得します。戻り値は `points[]`（i/j/k・座標・線量）＋入れ子 `grid`（1D→[i], 2D→[j][i], 3D→[k][j][i]）＋ `min/max/max_at`。
+
+### ✨ `executeCalculation` の構造化結果
+応答に `.summary`(YAML) から抽出した構造化 `result_total`（検出器ごとの座標＋E(AP)/DskinM(AP)/H*(10) の内訳）、`dose_columns`、`calculation_warnings`、`calculation_notes` を追加。
+
+### 🐛 `updateSource` の division/geometry/cutoff_rate 対応
+ツールスキーマ・検証が弾いていたフィールドを解放し、線源の in-place 更新（分割の収束スタディ等）が可能に。
+
+### 🔧 マニフェスト↔実行時ドリフト検出
+`npm run check:manifest` でツール定義とマニフェストの乖離を検出。
+
+詳細は [CHANGELOG.md](./CHANGELOG.md) を参照。
+
 ## 🆕 バージョン1.2.8の新機能
 
 ### ✨ `poker_openGui` — POKER GUI 起動メソッドを追加
@@ -20,6 +99,14 @@ YAML-based input file management tool for radiation-shielding calculation code P
 - `POKER_INSTALL_PATH/POKER.exe`（デフォルト: `C:/Poker/POKER.exe`）を使用
 - Windows 専用
 
+### 最新のPOKER_CUI.exeの機能でPOKER-MCPがカバーしていない部分について
+POKER本体は随時バージョンアップされており、下記の機能についてPOKER-MCPのツールは未対応です。
+それらについてAIアプリが入力を編集しようとするとツールの制約によって拒否されることがあります。必要に応じて手動で入力を修正してください。
+
+- 二重層・三重層ビルドアップ係数の指定（現状では単層のみ）
+- 線源にエネルギースペクトルを指定（現状では核種指定のみ）
+- 材料ゾーン・ビルドアップに**任意組成のカスタム材料**を指定（lib_material.dat の標準13＋ユーザ材料には対応済み。詳細は docs/manuals/MATERIAL_SYSTEM.md）
+
 ## 🆕 バージョン1.2.7の修正（バグフィックス）
 
 ### 🐛 `poker_executeCalculation` の yaml_file パス解決を修正
@@ -86,7 +173,12 @@ npx poker-mcp
 **未設定時は `~/.poker-mcp/` が自動的に使用されます。**
 
 #### `POKER_INSTALL_PATH`（オプション）
-ICRP-07.NDX 核種データベースのコピー元を指定します。
+POKERのインストールディレクトリを指定します。以下の2つの用途で参照されます。
+
+- **ICRP-07.NDX の参照先**: `{POKER_INSTALL_PATH}/LIB/ICRP-07.NDX` を直接参照（v1.4.0以降、コピーなし）
+- **POKER.exe の場所**: `{POKER_INSTALL_PATH}/POKER.exe`（`poker_openGui` 使用時）
+
+**デフォルト値**: `C:/Poker`（未設定時は `C:/Poker` を使用）
 
 ```bash
 # Windows（コマンドプロンプト）
@@ -163,7 +255,7 @@ Claude Desktopで以下のようにテストできます：
 ## 🏆 主要機能
 
 ### ✅ **MCP完全対応**
-- **29メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
+- **30メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
 - **JSON-RPC 2.0準拠**: 標準プロトコル完全対応
 - **STDIO通信**: MCPクライアントとの標準通信方式
 - **自動バックアップ・ロールバック**: 企業品質のデータ保護
@@ -182,7 +274,7 @@ Claude Desktopで以下のようにテストできます：
 
 ## 🎯 API構成
 
-### 🔧 **29メソッド完全実装**
+### 🔧 **30メソッド完全実装**
 
 | **カテゴリ** | **メソッド数** | **機能** | **主要操作** |
 |-------------|---------------|----------|-------------|
@@ -193,9 +285,9 @@ Claude Desktopで以下のようにテストできます：
 | **📡 Source** | 3個 | 線源管理 | propose・update・delete |
 | **🎯 Detector** | 3個 | 検出器管理 | propose・update・delete |
 | **📏 Unit** | 5個 | 単位設定管理 | propose・get・update・validateIntegrity・analyzeConversion |
-| **⚙️ System** | 5個 | システム制御 | applyChanges・executeCalculation・resetYaml・confirmDaughterNuclides・各種検証 |
+| **⚙️ System** | 6個 | システム制御 | applyChanges・executeCalculation・resetYaml・confirmDaughterNuclides・openGui・各種検証 |
 
-### 📋 **全29メソッド一覧**
+### 📋 **全30メソッド一覧**
 ```
 Body系 (3):          poker_proposeBody, poker_updateBody, poker_deleteBody
 Zone系 (3):          poker_proposeZone, poker_updateZone, poker_deleteZone  
@@ -206,8 +298,8 @@ 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
-System系 (5):        poker_applyChanges, poker_executeCalculation, poker_resetYaml,
-                     poker_confirmDaughterNuclides, 内部検証メソッド群
+System系 (6):        poker_applyChanges, poker_executeCalculation, poker_resetYaml,
+                     poker_confirmDaughterNuclides, poker_openGui, 内部検証メソッド群
 ```
 
 ## 📁 プロジェクト構造
@@ -400,6 +492,6 @@ POKER_MCP_HOME/
 
 ---
 
-**🎯 Poker MCP Server v1.2.8**  
+**🎯 Poker MCP Server v1.4.0**  
 **プロトコル**: MCP 1.0.0 完全準拠  
 **作者**: Yoshihiro Hirao | **ライセンス**: ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poker-mcp",
-  "version": "1.2.8",
+  "version": "1.5.0",
   "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",
@@ -10,7 +10,8 @@
   "scripts": {
     "start": "node src/mcp_server_stdio_v4.js",
     "dev": "nodemon src/mcp_server_stdio_v4.js",
-    "prepare": "echo 'NPX ready: npx poker-mcp'"
+    "prepare": "echo 'NPX ready: npx poker-mcp'",
+    "check:manifest": "node scripts/check-manifest-sync.mjs"
   },
   "keywords": [
     "mcp",
@@ -41,7 +42,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.7.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "js-yaml": "^4.1.0",
     "winston": "^3.17.0",
     "zod": "^3.24.2"

package/src/mcp/handlers/bodyHandlers.js

@@ -81,7 +81,7 @@ export function createBodyHandlers(taskManager) {
     async deleteBody(args) {
       try {
         if (!args.name) throw new ValidationError('立体名は必須です', 'name', args.name);
-        const result = await taskManager.deleteBody(args.name);
+        const result = await taskManager.deleteBody(args.name, args.cascade === true);
         return { success: true, message: result };
       } catch (error) {
         logger.error('deleteBodyハンドラーエラー', { args, error: error.message });

package/src/mcp/handlers/buildupFactorHandlers.js

@@ -33,7 +33,8 @@ export function createBuildupFactorHandlers(taskManager) {
         const result = await taskManager.proposeBuildupFactor(
           args.material, 
           useSlantCorrection, 
-          useFiniteMediumCorrection
+          useFiniteMediumCorrection,
+          args.equivalent
         );
         return { success: true, message: result };
       } catch (error) {

package/src/mcp/handlers/calculationHandlers.js

@@ -4,11 +4,40 @@ import { ValidationError, CalculationError } from '../../utils/errors.js';
 import { logger } from '../../utils/logger.js';
 import path from 'path';
 import { TASKS_DIR } from '../../utils/paths.js';
+import { parseDoseSummary } from '../../utils/summaryParser.js';
+import { parseDoseMap } from '../../utils/doseMapParser.js';
 
 export function createCalculationHandlers(taskManager) {
   const calculationService = new CalculationService();
 
   return {
+    async getDoseMap(args) {
+      try {
+        if (!args.detector_name) {
+          throw new ValidationError('detector_name is required', 'detector_name', args.detector_name);
+        }
+        const yamlFile = args.yaml_file || 'poker.yaml';
+        const absolutePathPattern = /^([a-zA-Z]:[\\\/]|\/)/;
+        const resolvedYamlFile = absolutePathPattern.test(yamlFile) ? yamlFile : path.join(TASKS_DIR, yamlFile);
+        const dosePath = resolvedYamlFile + '.dose';
+        // .dose は poker_cui 完了直後に書き込まれるが、完了検知からディスク反映までに数秒の
+        // ばらつきがある。実運用（executeCalculation とは別コール）では準備済みだが、直後呼び出しに
+        // 備え、準備できるまで最大約10秒リトライする（未準備時のみ待機）。
+        let map = parseDoseMap(dosePath, args.detector_name, { doseType: args.dose_type, ray: args.ray });
+        for (let attempt = 0; attempt < 20 && !map; attempt++) {
+          await new Promise(r => setTimeout(r, 500));
+          map = parseDoseMap(dosePath, args.detector_name, { doseType: args.dose_type, ray: args.ray });
+        }
+        if (!map) {
+          return { success: false, error: `.dose の解析に失敗、または検出器 '${args.detector_name}' が見つかりません`, dose_file: dosePath };
+        }
+        return { success: true, ...map, dose_file: dosePath };
+      } catch (error) {
+        logger.error('getDoseMap handler error', { args, error: error.message });
+        throw error;
+      }
+    },
+
     async executeCalculation(args) {
       try {
         // 引数検証
@@ -157,6 +186,25 @@ export function createCalculationHandlers(taskManager) {
           response.warnings = ['Some output files were not generated. Check calculation logs for details.'];
         }
 
+        // .summary(YAML) をパースして構造化 result_total を付加
+        try {
+          const summaryPath = (resolvedOutputFiles && resolvedOutputFiles.summary_file)
+            ? resolvedOutputFiles.summary_file
+            : resolvedYamlFile + '.summary';
+          const parsed = parseDoseSummary(summaryPath);
+          if (parsed) {
+            response.result_total = parsed.result_total;
+            response.dose_columns = parsed.columns;
+            if (parsed.notes && parsed.notes.length) response.calculation_notes = parsed.notes;
+            if (parsed.elapsed_time) response.calculation.elapsed_time = parsed.elapsed_time;
+            if (parsed.warnings && parsed.warnings.length) {
+              response.calculation_warnings = parsed.warnings;
+            }
+          }
+        } catch (e) {
+          logger.warn('summary 構造化パースをスキップ', { error: e.message });
+        }
+
         logger.info('Calculation completed successfully', {
           yamlFile: resolvedYamlFile,
           executionTime: result.executionTime,