feat(yaml-ide-gsm): migrate SimulationWorkflow successor scope

[kubohiroya]

概要

hierarchidb のフォルダ構造を IDE-GSM のプロジェクトとして扱い、import → calib → sim → export 、またはrsync-push → calib → sim → rsync-pull を順次実行する SimulationWorkflow を実装する。

背景

IDE-GSM の importProject / exportProject / calibrate / simulate API（ide-gsm PR #265）と、IdeGsmClient（#1155）が実装されることで、hierarchidb 側からシミュレーションを一貫して実行できるようになる。

実装内容(ここではimport/exportの場合を説明する。rsyncについてもこれに準ずる)

SimulationWorkflow クラスを新規作成する:

• client: IdeGsmClient を保持する
• runSimulation(folderNode, projectRelativePath, exportFilter?) メソッドを実装する:
  1. folderNode の内容を ProjectSnapshot（ZIP Base64）にシリアライズする
  2. client.importProject(projectSnapshot, projectRelativePath) → awaitTask() で完了待機
  3. client.calibrate(projectRelativePath) → awaitTask() で完了待機
  4. client.simulate(projectRelativePath) → awaitTask() で完了待機
  5. client.exportProject(projectRelativePath, include?, exclude?) → awaitTask() で完了待機
  6. 取得した ProjectSnapshot を YamlFileNode / 結果ノードとして hierarchidb のツリーに格納する
  7. いずれかのステップでエラーが発生した場合は後続ステップを実行せず例外をスローする

ワークフロー図(ここではimport/exportの場合を説明する。rsyncについてもこれに準ずる)

hierarchidb フォルダ
  ↓ シリアライズ（ZIP Base64）
importProject → IDE-GSM ワークディレクトリに展開
  ↓
calibrate → キャリブレーション実行
  ↓
simulate → シミュレーション実行
  ↓
exportProject → result-files/ を ZIP Base64 で取得
  ↓ デシリアライズ
hierarchidb ツリーに結果ノードとして格納

UI 要件

• 各ステップの実行状態（実行中・完了・失敗）をユーザーが確認できる UI を提供する
• エラー発生時はエラー内容をユーザーに通知する
• IDE-GSM への接続設定（エンドポイント URL・認証トークン）を設定として保持する

受け入れ基準(ここではimport/exportの場合を説明する。rsyncについてもこれに準ずる)

• import → calib → sim → export の順序で実行される
• 前のステップが完了してから次のステップが実行される
• いずれかのステップでエラーが発生した場合、後続ステップは実行されない
• exportProject で取得した結果が hierarchidb のツリーノードとして閲覧できる

関連

• ide-gsm PR fix: preserve shape progress updates with task metadata changes #265: https://github.com/kubohiroya/ide-gsm/pull/265
• 前提タスク: feat: YamlFileNode の追加（IDE-GSM 統合） #1154 (YamlFileNode), feat: IdeGsmClient の実装（IDE-GSM 統合） #1155 (IdeGsmClient)

[kubohiroya]

2026-08-22 rescope note after #1162 contract convergence and recovery-lane fail-closed decision.

The original SimulationWorkflow wording predates the current #1162 contract. It should not be treated as directly implementable without successor scope decisions.

Current boundary:

• Result tree materialization, composite workflow UI, IDE-GSM integration, and command execution need to be split or explicitly mapped to epic(yaml-ide-gsm): complete subtype-aware Step 4 integration #1162 successor Issues.
• SSH lifecycle integration remains blocked until upstream IDE-GSM exposes authoritative Frontend GraphQL start/stop mutations and the pinned revision/spec are updated.
• Remote/ec2 fallback for SSH lifecycle is not allowed.
• Storage or recovery behavior must not inherit authority from closed recovery-lane Issues (fix(yaml-storage): revoked partitionをone-shot corrective recoveryする #1388, ops(yaml-storage): corrected interrupted CoreDB preservation diagnosticを再受入する #1432, ops(yaml-storage): undefined references修正版のpreservation diagnosticを再受入する #1437); interrupted/non-YAML artifacts are not recovery/write targets.

Recommended rescope:

• Split non-SSH Simulation regression / integration from SSH lifecycle integration.
• Keep SSH work blocked on the upstream mutation contract.
• Decide whether this Issue is superseded by successor Issues or remains as the parent tracking Issue for SimulationWorkflow disposition.

Keep this Issue OPEN / Todo with needs:rescope until the disposition is recorded.