poker-mcp 1.7.2 → 1.8.2

package/README.md

@@ -11,6 +11,38 @@ YAML-based input file management tool for radiation-shielding calculation code P
 - **核種データ**: `${POKER_INSTALL_PATH}/LIB/ICRP-07.NDX` を直接参照
 - **実行方式**: STDIO通信（MCPプロトコル標準）
 
+## 🆕 バージョン1.8.0〜1.8.1の新機能
+
+### 📐 CAD連携が MCP だけで完結
+従来、CAD からの経路抽出は MCP を経由せず、FreeCAD を手で起動する必要が
+ありました。`spec.json` を手書きし、`poker_cui -p` を叩き、`freecadcmd` に
+スクリプトを渡す。3 手順すべてが手作業でした。
+
+```javascript
+poker_generatePaths({ fcstd: "C:/path/to/model.FCStd" })
+poker_executeCalculation({ yaml_file: "poker.yaml", path_input: "poker.paths" })
+```
+
+CAD ファイルを指定するだけになりました。分割点の取得、グリッド検出器の展開、
+ビルドアップ等価材料の解決（`Source_Dry` → `Tungsten` など）は自動です。
+
+### 🔍 FREECAD_PATH
+FreeCAD の場所を、環境変数 → PATH → 既定のインストール先の順で解決します。
+`POKER_INSTALL_PATH` のように固定の既定値を持てないのは、インストール先が
+バージョン番号を含むためです（FreeCAD 1.1, 1.0 …）。
+
+```json
+"env": {
+  "POKER_INSTALL_PATH": "C:\\Poker",
+  "FREECAD_PATH": "C:\\Program Files\\FreeCAD 1.1"
+}
+```
+
+### 🐛 相対パスの解決を修正
+`tasks/` 配下のファイル名指定が、プロセスのカレントディレクトリを基準に
+解決されていました。MCP サーバの起動場所によっては別の場所を指します。
+
+
 ## 🆕 バージョン1.7.0〜1.7.2の新機能
 
 ### 📉 サマリー出力量の制御（ThinnedIndices 操作系 3メソッド）
@@ -72,28 +104,61 @@ poker_getThinnedIndices()
 
 ### 📡 CAD連携レイトレース
 FreeCAD のソリッドモデルを、STEP のような中間フォーマットを介さず、CSG で
-表現し直す作業も無しに遮蔽体系として扱えます。線源点→検出器の直線を FreeCAD 側で
-追跡し、通過した材質と厚さを `.paths` ファイルで POKER に渡します。
+表現し直す作業も無しに遮蔽体系として扱えます。**MCP の 2 呼び出しで完結**します。
 
-```bash
-poker_cui model.yaml -p -t                            # 分割点を出力
-freecadcmd -c "... gen_paths.main('spec.json')"       # CAD をトレース
-poker_cui model.yaml --path-input model.paths -t      # 計算
+```javascript
+poker_generatePaths({ fcstd: "C:/path/to/model.FCStd" })
+poker_executeCalculation({ yaml_file: "poker.yaml", path_input: "poker.paths" })
 ```
 
-POKER 側の `--path-input` も実装され、CSG 経由と一致することを平板・円筒・球の
-5 体系で確認済みです。フィレットや自由曲面のように CSG で表現できない形状も
-扱えます。**複数線源・グリッド検出器・スラント補正に対応**。
+線源点→検出器の直線を FreeCAD 側で追跡し、通過した材質と厚さを `.paths` に
+記録して POKER に渡します。分割点の取得、グリッド検出器の展開、ビルドアップ
+等価材料の解決はすべて自動です。
+
+CSG 経由と一致することを平板・円筒・球の 5 体系で確認済みです。フィレットや
+自由曲面のように CSG で表現できない形状も扱えます。**複数線源・グリッド検出器・
+スラント補正に対応**。
 
 他の CAD で作ったモデルも、STEP で FreeCAD に読み込めば同じパイプラインに
 乗ります。副産物として、POKER の改造なしで使える**簡易化の監査ツール**
 （ある形状を省略してよいかを定量化する）もあります。
 
+FreeCAD の場所は環境変数 `FREECAD_PATH` で指定します（未設定なら既定の
+インストール先を探索）。
+
+#### 必要なもの
+
+| | 入手 | 環境変数 |
+|---|---|---|
+| poker-mcp | `npm install poker-mcp` | — |
+| **POKER 本体** | 別途入手 | `POKER_INSTALL_PATH` |
+| **FreeCAD** | [freecad.org](https://www.freecad.org/)（無償） | `FREECAD_PATH` |
+
+numpy はレイトレーサが使いますが、FreeCAD に同梱されているので追加の
+インストールは不要です。
+
+```json
+"env": {
+  "POKER_MCP_HOME": "C:\\Users\\yoshi\\poker_mcp_workspace",
+  "POKER_INSTALL_PATH": "C:\\Poker",
+  "FREECAD_PATH": "C:\\Program Files\\FreeCAD 1.1"
+}
+```
+
+`FREECAD_PATH` は既定の場所にインストールされていれば省略できます。
+
+#### モデル側の約束
+
+**ソリッドに `PokerMaterial` プロパティで材質名を設定**しておく必要があります
+（`Iron`、`Concrete` など、POKER の材料ライブラリの名前）。密度を上書きする場合は
+`PokerDensity` も設定します。
+
+他の CAD で作ったモデルを STEP で読み込んだ場合、材質情報は失われるので
+FreeCAD 上で設定してください。一度設定すれば `.FCStd` に保存されます。
+
 詳細は [CAD_RAYTRACE.md](./docs/manuals/CAD_RAYTRACE.md)、フォーマットは
 [PATHS_FORMAT.md](./docs/manuals/PATHS_FORMAT.md)。
 
-詳細は [CHANGELOG.md](./CHANGELOG.md) を参照。
-
 ## 🆕 バージョン1.5.0の新機能
 
 ### 🖥️ POKER GUI を閉じずに表示を切り替え
@@ -336,7 +401,7 @@ Claude Desktopで以下のようにテストできます：
 ## 🏆 主要機能
 
 ### ✅ **MCP完全対応**
-- **33メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
+- **34メソッド完全実装**: 全ての放射線遮蔽計算入力管理機能
 - **JSON-RPC 2.0準拠**: 標準プロトコル完全対応
 - **STDIO通信**: MCPクライアントとの標準通信方式
 - **自動バックアップ・ロールバック**: 企業品質のデータ保護
@@ -355,7 +420,7 @@ Claude Desktopで以下のようにテストできます：
 
 ## 🎯 API構成
 
-### 🔧 **33メソッド完全実装**
+### 🔧 **34メソッド完全実装**
 
 | **カテゴリ** | **メソッド数** | **機能** | **主要操作** |
 |-------------|---------------|----------|-------------|
@@ -368,7 +433,7 @@ Claude Desktopで以下のようにテストできます：
 | **📏 Unit** | 5個 | 単位設定管理 | propose・get・update・validateIntegrity・analyzeConversion |
 | **⚙️ System** | 6個 | システム制御 | applyChanges・executeCalculation・resetYaml・confirmDaughterNuclides・openGui・各種検証 |
 
-### 📋 **全33メソッド一覧**
+### 📋 **全34メソッド一覧**
 ```
 Body系 (3):          poker_proposeBody, poker_updateBody, poker_deleteBody
 Zone系 (3):          poker_proposeZone, poker_updateZone, poker_deleteZone  

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poker-mcp",
-  "version": "1.7.2",
+  "version": "1.8.2",
   "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",
@@ -50,6 +50,11 @@
   },
   "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"
   ]

package/src/mcp/handlers/cadHandlers.js

@@ -0,0 +1,187 @@
+// mcp/handlers/cadHandlers.js
+//
+// CAD 連携レイトレース。従来は次の 3 手順を手で行う必要があった。
+//   1. spec.json を手書き（絶対パスを 4 箇所）
+//   2. poker_cui -p で分割点と評価点を出す
+//   3. freecadcmd を起動して gen_paths.py を走らせる
+// このハンドラがまとめて行う。
+
+import { spawn } from 'child_process';
+import fs from 'fs/promises';
+import fssync from 'fs';
+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 { MaterialCatalog } from '../../utils/MaterialCatalog.js';
+
+function run(cmd, args, opts = {}) {
+  return new Promise((resolve) => {
+    const p = spawn(cmd, args, { ...opts, stdio: ['ignore', 'pipe', 'pipe'] });
+    let out = '', err = '';
+    p.stdout.on('data', d => out += d);
+    p.stderr.on('data', d => err += d);
+    p.on('error', e => resolve({ code: -1, out, err: e.message }));
+    p.on('close', code => resolve({ code, out, err }));
+  });
+}
+
+export function createCadHandlers(taskManager) {
+  return {
+    async generatePaths(args) {
+      const fail = (msg, hint) => ({
+        content: [{
+          type: 'text',
+          text: JSON.stringify({ success: false, error: msg, hint }, null, 2)
+        }],
+        isError: true
+      });
+
+      // --- FreeCAD の所在 ---
+      if (!FREECAD_CMD) {
+        return fail(
+          'FreeCAD が見つかりません',
+          '環境変数 FREECAD_PATH に freecadcmd の場所を設定してください。' +
+          '実行ファイル（C:/Program Files/FreeCAD 1.1/bin/freecadcmd.exe）でも、' +
+          'インストールフォルダ（C:/Program Files/FreeCAD 1.1）でも指定できます。' +
+          'claude_desktop_config.json の env に追加します。');
+      }
+      if (!args || !args.fcstd) return fail('fcstd を指定してください');
+      if (!fssync.existsSync(args.fcstd))
+        return fail('CAD ファイルが見つかりません: ' + args.fcstd);
+
+      const yamlFile = YAML_FILE;
+      if (!fssync.existsSync(yamlFile))
+        return fail('入力 YAML がありません: ' + yamlFile,
+          'applyChanges で入力を確定してから実行してください。');
+
+      // --- 1. poker_cui -p で分割点と評価点を出す ---
+      // .paths には全点が必要。間引かれていると gen_paths.py がエラーにする。
+      const exe = path.join(POKER_INSTALL_DIR, 'poker_cui.EXE');
+      if (!fssync.existsSync(exe))
+        return fail('poker_cui が見つかりません: ' + exe,
+          '環境変数 POKER_INSTALL_PATH を確認してください。');
+
+      const summary = yamlFile + '.summary';
+      const r1 = await run(exe, [yamlFile, '-p', '-t'], { cwd: TASKS_DIR });
+      if (r1.code !== 0 || !fssync.existsSync(summary)) {
+        return fail('poker_cui -p の実行に失敗しました（終了コード ' + r1.code + '）',
+          (r1.err || r1.out || '').slice(-400));
+      }
+
+      // --- 2. spec を組み立てる ---
+      const out = args.output || path.join(TASKS_DIR, 'poker.paths');
+      const spec = {
+        fcstd: args.fcstd.replace(/\\/g, '/'),
+        out: out.replace(/\\/g, '/'),
+        poker_summary: summary.replace(/\\/g, '/'),
+        detectors_from_summary: true,
+        deviation: args.deviation ?? 0.5,
+        unit_scale: args.unit_scale ?? 0.1,
+        poker_dir: POKER_INSTALL_DIR.replace(/\\/g, '/'),
+        mu_energy: args.mu_energy ?? 1.25,
+      };
+      if (args.source_name) spec.source_name = args.source_name;
+      if (args.buildup_exclude) spec.buildup_exclude = args.buildup_exclude;
+      if (args.chunk) spec.chunk = args.chunk;
+
+      // カスタム材料のビルドアップ等価材料を自動で解決する。
+      //   gen_paths.py は層の縮約先を決める際、単層ビルドアップデータの有無を
+      //   材料名で照合する。Source_Dry のようなカスタム材料は標準材料に
+      //   読み替える必要があり、従来は spec.equivalent に手で書いていた。
+      //   MaterialCatalog が lib_equivalent.dat と実データから解決できるので
+      //   ここで埋める（POKER 側も同じ表を見るので食い違わない）。
+      try {
+        const data = taskManager.data || {};
+        const equiv = {};
+        for (const z of (data.zone || [])) {
+          const m = z.material;
+          if (!m || m === 'VOID' || equiv[m]) continue;
+          if (MaterialCatalog.isStandard && MaterialCatalog.isStandard(m)) continue;
+          const e = MaterialCatalog.nearestBuildupEquivalent(m);
+          const name = (e && typeof e === 'object') ? e.equivalent : e;
+          if (name) equiv[m] = name;
+        }
+        if (Object.keys(equiv).length) {
+          spec.equivalent = equiv;
+          logger.info('ビルドアップ等価材料を自動設定しました', { equivalent: equiv });
+        }
+      } catch (e) {
+        logger.warn('等価材料の自動解決に失敗（spec.equivalent なしで続行）',
+          { error: e.message });
+      }
+
+      const specFile = path.join(TASKS_DIR, '.generate_paths_spec.json');
+      await fs.writeFile(specFile, JSON.stringify(spec, null, 2), 'utf8');
+
+      // --- 3. FreeCAD をヘッドレスで起動してトレース ---
+      // GUI の MCP ブリッジ経由では、数万レイのトレースが GUI スレッドを
+      // 占有してブリッジが壊れる。freecadcmd を使う。
+      const script =
+        'import sys, json, traceback\n' +
+        'sys.path.insert(0, r"' + CAD_TOOLS_DIR + '")\n' +
+        'try:\n' +
+        '    import gen_paths\n' +
+        '    gen_paths.main(r"' + specFile + '")\n' +
+        '    print("GEN_PATHS_OK")\n' +
+        'except BaseException:\n' +
+        '    print("GEN_PATHS_ERROR")\n' +
+        '    traceback.print_exc()\n';
+
+      const scriptFile = path.join(TASKS_DIR, '.generate_paths.py');
+      await fs.writeFile(scriptFile, script, 'utf8');
+
+      const r2 = await run(FREECAD_CMD, [scriptFile], { cwd: TASKS_DIR });
+      const log = (r2.out || '') + (r2.err || '');
+
+      if (!log.includes('GEN_PATHS_OK') || !fssync.existsSync(out)) {
+        // Python のトレースバックから要点を抜く
+        const m = log.match(/(?:SystemExit|Error|Exception)[^\n]*(?:\n[^\n]*){0,3}/);
+        return fail('経路の生成に失敗しました',
+          m ? m[0].trim() : log.slice(-500));
+      }
+
+      // --- 4. 生成結果を要約する ---
+      const text = await fs.readFile(out, 'utf8');
+      const info = {};
+      for (const key of ['n_sources', 'n_source_points', 'n_detectors', 'n_materials',
+                         'format_version', 'deviation_mm']) {
+        const m = text.match(new RegExp('^\\s*' + key + ':\\s*(.+)$', 'm'));
+        if (m) info[key] = m[1].trim();
+      }
+      const nPaths = (text.split('paths: |')[1] || '').trim().split('\n').length;
+
+      logger.info('経路ファイルを生成しました', { out, ...info });
+
+      return {
+        content: [{
+          type: 'text',
+          text: JSON.stringify({
+            success: true,
+            message: '経路ファイルを生成しました',
+            output: out,
+            summary: {
+              経路数: nPaths,
+              線源数: info.n_sources,
+              線源点数: info.n_source_points,
+              検出器評価点数: info.n_detectors,
+              材質数: info.n_materials,
+              テッセレーション偏差_mm: info.deviation_mm,
+              format_version: info.format_version
+            },
+            spec_used: {
+              deviation: spec.deviation,
+              unit_scale: spec.unit_scale,
+              mu_energy: spec.mu_energy,
+              buildup_exclude: spec.buildup_exclude ?? ['VOID', 'Air'],
+              equivalent: spec.equivalent ?? {},
+              freecad: FREECAD_CMD,
+              poker_dir: spec.poker_dir
+            },
+            next: 'poker_cui "' + yamlFile + '" --path-input "' + out + '" -t で計算できます'
+          }, null, 2)
+        }]
+      };
+    }
+  };
+}

package/src/mcp/handlers/calculationHandlers.js

@@ -115,7 +115,8 @@ export function createCalculationHandlers(taskManager) {
           summaryOptions,
           resolvedOutputFiles,
           undefined,
-          taskManager.dataManager
+          taskManager.dataManager,
+          args.path_input || null
         );
 
         // 事前検証で重大エラーが検出された場合の処理

package/src/mcp/handlers/index.js

@@ -6,7 +6,8 @@ import { createBuildupFactorHandlers } from './buildupFactorHandlers.js';
 import { createSourceHandlers } from './sourceHandlers.js';
 import { createDetectorHandlers } from './detectorHandlers.js';
 import { createUnitHandlers } from './unitHandlers.js';
-import { createThinnedIndicesHandlers } from './thinnedIndicesHandlers.js';
+import { createThinnedIndicesHandlers } from './thinnedIndicesHandlers.js';
+import { createCadHandlers } from './cadHandlers.js';
 import { createCalculationHandlers } from './calculationHandlers.js';
 import { resetHandlers } from './resetHandlers.js';
 import { createDaughterNuclideHandler } from './daughterNuclideHandler.js';
@@ -34,7 +35,8 @@ export function createAllHandlers(taskManager) {
     
     // 単位操作
     ...createUnitHandlers(taskManager),
-    ...createThinnedIndicesHandlers(taskManager),
+    ...createThinnedIndicesHandlers(taskManager),
+    ...createCadHandlers(taskManager),
     
     // 計算操作
     ...createCalculationHandlers(taskManager),

package/src/mcp/tools/cadTools.js

@@ -0,0 +1,65 @@
+// cadTools.js
+//
+// CAD 連携レイトレース（.paths の生成）のツール定義。
+//
+// FreeCAD のソリッドモデルから線源点→検出器の経路を抽出し、POKER に渡す
+// .paths ファイルを作る。従来は freecadcmd を手で叩き、spec.json を手書きする
+// 必要があったが、このツールがその手順をまとめる。
+//
+// FreeCAD の場所は環境変数 FREECAD_PATH で指定する。未設定なら既定の
+// インストール先を探す。
+
+export const cadTools = [
+  {
+    name: 'poker_generatePaths',
+    description:
+      'FreeCAD のモデルから経路ファイル(.paths)を生成します。線源分割点→検出器評価点の直線を追跡し、通過した材質と厚さを記録します。' +
+      'CSG プリミティブで表現しにくい形状（フィレット、自由曲面、多数の貫通孔など）をそのまま遮蔽計算に使えます。' +
+      '内部で poker_cui -p を実行して分割点と評価点を取得し、FreeCAD をヘッドレスで起動してトレースします。' +
+      '生成後は executeCalculation の path_input に指定するか、poker_cui --path-input で計算します。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        fcstd: {
+          type: 'string',
+          description: 'FreeCAD モデルのパス（.FCStd）。ソリッドに PokerMaterial プロパティで材質名を設定しておくこと。'
+        },
+        output: {
+          type: 'string',
+          description: '出力する .paths のパス。省略時は作業ディレクトリの poker.paths。'
+        },
+        deviation: {
+          type: 'number',
+          minimum: 0.001,
+          description: 'テッセレーション偏差 [mm]。既定 0.5。曲面を三角形で近似する際の最大のずれ。球面や複曲面が支配的な体系では小さくする（0.1 で誤差が約 1/10 になる）。'
+        },
+        unit_scale: {
+          type: 'number',
+          description: 'CAD 単位 → POKER 単位の倍率。既定 0.1（FreeCAD の mm → POKER の cm）。'
+        },
+        mu_energy: {
+          type: 'number',
+          description: '層の縮約に使う参照エネルギー [MeV]。既定 1.25。ビルドアップ層の選定（参考情報）にのみ影響し、線量計算には使われない。'
+        },
+        source_name: {
+          type: 'string',
+          description: '線源名。省略時は全線源を対象にする。'
+        },
+        buildup_exclude: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'ビルドアップ層の候補から除外する材質。既定 ["VOID","Air"]。大気中の長距離伝播で Air を遮蔽として数えたい場合などに変更する。減衰計算には影響せず、層の縮約（参考情報）にのみ効く。'
+        },
+        chunk: {
+          type: 'integer',
+          minimum: 1024,
+          description: 'レイトレースのバッチサイズ。既定 32768。メモリが厳しい環境では下げる。結果には影響しない。'
+        }
+      },
+      required: ['fcstd'],
+      additionalProperties: false,
+      title: 'CAD から経路ファイルを生成',
+      description: '入力 YAML の線源・検出器の定義と、FreeCAD のモデルを突き合わせて .paths を作ります。'
+    }
+  }
+];

package/src/mcp/tools/calculationTools.js

@@ -17,7 +17,7 @@ export const calculationTools = [
   },
   {
     name: 'poker_executeCalculation',
-    description: '作成したYAMLファイルを使用してpoker_cuiで放射線遮蔽計算を実行します。応答には .summary(YAML) から抽出した構造化 result_total（検出器ごとの座標と E(AP)/DskinM(AP)/H*(10) の線量内訳）、dose_columns、警告フッタ calculation_warnings、注記 calculation_notes を含みます。',
+    description: '作成したYAMLファイルを使用してpoker_cuiで放射線遮蔽計算を実行します。path_input に .paths を指定すると、CAD から抽出した経路を幾何として使います。応答には .summary(YAML) から抽出した構造化 result_total（検出器ごとの座標と E(AP)/DskinM(AP)/H*(10) の線量内訳）、dose_columns、警告フッタ calculation_warnings、注記 calculation_notes を含みます。',
     inputSchema: {
       type: 'object',
       properties: {
@@ -26,6 +26,10 @@ export const calculationTools = [
           description: '計算に使用するYAMLファイル名（拡張子.yamlを含む）。ファイル名のみ指定（例: poker.yaml）で、POKER_MCP_HOME/tasks/ 配下のファイルが自動的に参照されます。絶対パスも指定可能です。',
           pattern: '^([a-zA-Z0-9_\\-\\.]+\\.(yaml|yml)|([a-zA-Z]:[\\\\\/]|\\/)[^\\\\]+\\.(yaml|yml))$'
         },
+        path_input: {
+          type: 'string',
+          description: 'CAD から抽出した経路ファイル（.paths）。指定すると、YAML の立体・ゾーン定義の代わりにこのファイルの経路を幾何として使います（poker_cui の --path-input）。poker_generatePaths で生成できます。線源・検出器・材料・ビルドアップ設定は従来どおり YAML から取得するので、入力の正本は YAML に保たれます。ファイル名のみの指定で POKER_MCP_HOME/tasks/ 配下が参照されます。'
+        },
         summary_options: {
           type: 'object',
           description: 'サマリー出力オプション（注意: show_source_dataとshow_total_doseの少なくとも一方は必須です）',

package/src/mcp/tools/index.js

@@ -7,7 +7,8 @@ import { sourceTools } from './sourceTools.js';
 import { detectorTools } from './detectorTools.js';
 import { commonTools } from './commonTools.js';
 import { unitTools } from './unitTools.js';
-import { thinnedIndicesTools } from './thinnedIndicesTools.js';
+import { thinnedIndicesTools } from './thinnedIndicesTools.js';
+import { cadTools } from './cadTools.js';
 import { calculationTools } from './calculationTools.js';
 import { resetTools } from './resetTools.js';
 import { daughterNuclideTools } from './daughterNuclideTools.js';
@@ -22,7 +23,8 @@ export const allTools = [
   ...detectorTools,
   ...commonTools,
   ...unitTools,
-  ...thinnedIndicesTools,
+  ...thinnedIndicesTools,
+  ...cadTools,
   ...calculationTools,
   ...resetTools,
   ...daughterNuclideTools,
@@ -38,7 +40,8 @@ export {
   detectorTools,
   commonTools,
   unitTools,
-  thinnedIndicesTools,
+  thinnedIndicesTools,
+  cadTools,
   calculationTools,
   resetTools,
   daughterNuclideTools,

package/src/services/CalculationService.js

@@ -1,7 +1,8 @@
 // services/CalculationService.js
 import { spawn } from 'child_process';
 import { promises as fs } from 'fs';
-import path from 'path';
+import path from 'path';
+import { TASKS_DIR } from '../utils/paths.js';
 import { logger } from '../utils/logger.js';
 import { CalculationError } from '../utils/errors.js';
 
@@ -240,7 +241,7 @@ export class CalculationService {
    * @param {number} timeout タイムアウト時間（ミリ秒）
    * @returns {Promise<Object>} 計算結果
    */
-  async executeCalculation(yamlFile, summaryOptions = {}, outputFiles = {}, timeout = this.defaultTimeout) {
+  async executeCalculation(yamlFile, summaryOptions = {}, outputFiles = {}, timeout = this.defaultTimeout, pathInput = null) {
     // 前処理: 各種検証
     logger.info('Starting calculation validation', { yamlFile, summaryOptions, outputFiles });
     
@@ -301,7 +302,7 @@ export class CalculationService {
       absoluteYamlPath = yamlFile;
     } else {
       // 相対パスの場合、tasks/ディレクトリからの相対パスとして解決
-      absoluteYamlPath = path.resolve('tasks', yamlFile);
+      absoluteYamlPath = path.join(TASKS_DIR, yamlFile);
     }
     const args = [absoluteYamlPath];
     
@@ -318,6 +319,16 @@ export class CalculationService {
       args.push('-d', outputFiles.dose_file);
     }
 
+    // CAD から抽出した経路を幾何として使う。
+    //   YAML の立体・ゾーン定義の代わりに .paths の経路を読む。線源・検出器・
+    //   材料・ビルドアップ設定は従来どおり YAML から取得するので、入力の
+    //   正本は YAML に保たれる。
+    if (pathInput) {
+      const absPathInput = path.isAbsolute(pathInput)
+        ? pathInput : path.join(TASKS_DIR, pathInput);
+      args.push('--path-input', absPathInput);
+    }
+
     logger.info('Executing poker_cui calculation', { 
       command: this.pokercuiCommand,
       args,
@@ -540,7 +551,7 @@ export class CalculationService {
    * @param {Object} dataManager - データマネージャーインスタンス（オプション）
    * @returns {Promise<Object>} 実行結果
    */
-  async executeWithValidation(yamlFile, summaryOptions = {}, outputFiles = {}, timeout = this.defaultTimeout, dataManager = null) {
+  async executeWithValidation(yamlFile, summaryOptions = {}, outputFiles = {}, timeout = this.defaultTimeout, dataManager = null, pathInput = null) {
     try {
       logger.info('統合検証付き計算実行を開始', { yamlFile });
 
@@ -615,7 +626,7 @@ export class CalculationService {
       }
 
       // 通常の計算実行
-      const calculationResult = await this.executeCalculation(yamlFile, summaryOptions, outputFiles, timeout);
+      const calculationResult = await this.executeCalculation(yamlFile, summaryOptions, outputFiles, timeout, pathInput);
 
       // poker_cuiがエラーを返した場合、事後診断を実行
       if (!calculationResult.success && dataManager) {

package/src/utils/paths.js

@@ -10,6 +10,7 @@
 //     "POKER_INSTALL_PATH": "C:\\Poker"
 //   }
 //
+import fs from 'fs';
 import path from 'path';
 import os from 'os';
 
@@ -24,6 +25,88 @@ export const BACKUPS_DIR = path.join(BASE_DIR, 'backups');
 export const POKER_INSTALL_DIR = process.env.POKER_INSTALL_PATH ?? 'C:/Poker';
 export const POKER_LIB_DIR = path.join(POKER_INSTALL_DIR, 'LIB');
 
+// FreeCAD のコマンドライン版（freecadcmd）。CAD 連携レイトレースで使う。
+//
+// 環境変数 FREECAD_PATH で指定する。実行ファイルそのものでも、
+// インストールフォルダ（bin の親）でも受け付ける。
+//
+// 未設定なら既定の場所を順に探す。見つからなければ null を返し、
+// CAD 連携のツールを呼んだときに「設定してください」と案内する。
+// POKER_INSTALL_PATH のように既定値を決め打ちしないのは、FreeCAD の
+// インストール先がバージョン番号を含み（FreeCAD 1.1, FreeCAD 1.0 …）
+// 決め打ちが当たらないため。
+// 探索の順序:
+//   1. 環境変数 FREECAD_PATH（実行ファイルでもインストールフォルダでも可）
+//   2. PATH に freecadcmd があるか
+//   3. 既定のインストール先を走査（バージョン番号を決め打ちしない）
+//
+// バージョン番号を含むフォルダ（FreeCAD 1.1, FreeCAD 1.0 …）に入るため、
+// POKER_INSTALL_PATH のような固定の既定値は使えない。
+const FREECAD_SEARCH_ROOTS = [
+  'C:/Program Files',
+  'C:/Program Files (x86)',
+  '/usr/lib',
+  '/opt',
+  process.env.LOCALAPPDATA ? path.join(process.env.LOCALAPPDATA, 'Programs') : null,
+].filter(Boolean);
+
+const FREECAD_EXE = process.platform === 'win32' ? 'freecadcmd.exe' : 'freecadcmd';
+
+function underDir(dir) {
+  for (const rel of [path.join('bin', FREECAD_EXE), FREECAD_EXE]) {
+    const c = path.join(dir, rel);
+    if (fs.existsSync(c)) return c;
+  }
+  return null;
+}
+
+function fromPathEnv() {
+  const sep = process.platform === 'win32' ? ';' : ':';
+  for (const d of (process.env.PATH || '').split(sep)) {
+    if (!d) continue;
+    const c = path.join(d, FREECAD_EXE);
+    try { if (fs.existsSync(c)) return c; } catch { /* 権限などは無視 */ }
+  }
+  return null;
+}
+
+function scanRoots() {
+  // FreeCAD* に一致するフォルダを探す。新しいバージョンから試すため降順。
+  for (const root of FREECAD_SEARCH_ROOTS) {
+    let entries;
+    try { entries = fs.readdirSync(root); } catch { continue; }
+    const cands = entries.filter(n => /^freecad/i.test(n)).sort().reverse();
+    for (const n of cands) {
+      const hit = underDir(path.join(root, n));
+      if (hit) return hit;
+    }
+  }
+  // Linux の標準的な配置
+  for (const c of ['/usr/bin/freecadcmd', '/usr/local/bin/freecadcmd']) {
+    if (fs.existsSync(c)) return c;
+  }
+  return null;
+}
+
+function resolveFreeCad() {
+  const env = process.env.FREECAD_PATH;
+  if (env) {
+    if (fs.existsSync(env) && fs.statSync(env).isFile()) return env;
+    const hit = underDir(env);
+    if (hit) return hit;
+    return null;   // 指定されているが見つからない（呼び出し側で案内する）
+  }
+  return fromPathEnv() || scanRoots();
+}
+
+export const FREECAD_CMD = resolveFreeCad();
+
+// CAD 連携ツール（tools/ 配下の Python）の場所。
+// npm パッケージにも同梱するので、このファイルからの相対で解決する。
+export const CAD_TOOLS_DIR = path.resolve(
+  path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')),
+  '..', '..', 'tools');
+
 export const YAML_FILE    = path.join(TASKS_DIR,  'poker.yaml');
 export const PENDING_FILE = path.join(TASKS_DIR,  'pending_changes.json');
 export const USER_CONFIG  = path.join(BASE_DIR,   'config.json');