MAS-067: マルチイヤー計画ワークスペース + ステージ準備度ダッシュボード（人間駆動・MAS-057 派生）

概要

目的

MAS-057 Phase 3 実装完了 (PR #379) 後の振り返りで派生した案件。MAS-057 は単年スコープのため、複数年計画の俯瞰と「次のアクション準備度」可視化が空白。MAS-008 (単年ランウェイ)・MAS-011 (単一ドライバー What-If)・MAS-058 (単年必要年商) では複数年自由入力 + B/S 引継ぎ + ステージ可視化を扱えない。

MAS-059 (AI 自動オーケストレーション・LangGraph) とは別物で、本案件は人間が手動で 5 年分の計画を入力する静的・俯瞰的ワークスペース。海外 FP&A SaaS (Pigment / Causal / Runway) は複数年予測機能を持つが、「ライフステージ S1-S4 + アクション準備度 3 種」の 2 軸ステージ判定は世界空白で差別化機会。

経営者ユーザーの直接要望（2026-04-27 振り返り会話）:

「入力を 1 年目・2 年目みたいに増やして、2 年目は 1 年目の計画 PL/BS/CF を引き継ぎ、各年でランウェイなど評価して、人を雇う準備ができたのか・融資を申し込める準備ができたのか・SaaS ビジネスのためのプロジェクト開発に投資する準備ができたのか等を可視化したい」

この要望を 4 機能（マルチイヤー入力 / B/S 引継ぎ / ステージ準備度ダッシュボード / サジェストエンジン）× 4 Phase（A-D 段階リリース）に分解して実現する。

現在のコード

本案件は既存 5 案件（MAS-008 / MAS-011 / MAS-013 / MAS-058 / MAS-057）の計算エンジンを順次呼び出して年次連結 PL/BS/CF を構築するアグリゲータレイヤー。新規ロジックは年次連結 + 5 軸ステージ判定 + ガードレール + Section G 5 機能 + サジェストエンジンのみ。MAS-048 HiringTcoSimulator は v1.2 改訂で正社員採用判定が v2+ 延期となり v1 スコープでは未呼出（v2+ で 11 軸目アクション追加時に再利用予定）。

連携先 6 案件の利用関数

400_domain/ 採番状況（2026-04-27 時点）

既使用: 442（MAS-057 Phase 1）/ 443（MAS-057 Phase 2）/ 444（MAS-057 Phase 2）/ 445（MAS-058）/ 449（MAS-066 想定）/ 450（MAS-063 想定）。本案件は 451 を新規採番（MAS-066 449 / MAS-063 450 と並列・連番継続）。

MAS-057 Phase 3 SPA 基盤の流用

webapp_client/scripts/sync-engines.mjs（PR #379 で確立）が 400_domain/{442,443,444,445}*.js を webapp_client/src/engines/ にコピー + window 露出する仕組み。本案件で 451 を sync 対象に追加するだけで MAS-067 ドメインエンジンも同じ SSoT 共有方式が適用される（TypeScript 複製ゼロ）。

webapp_client/vite.config.ts の multi-page entry に multiyear_spa を追加することで、MAS-057 cockpit と並列で独立 cockpit ビルドが可能。

修正方針

Step 1: マルチイヤー入力 UI（4 機能の (a)・Phase A）

Y1-Y5 の各年で全パラメータを設定する year-tab UI:

[ Y1 ][ Y2 ][ Y3 ][ Y4 ][ Y5 ]   ← タブで年切替
─────────────────────────────────
役員報酬月額: [50 万 ▾]   ← A1 役員報酬最適化
賞与年額:     [0 万  ▾]
社宅負担率:   [0%   ▾]   ← A2 役員社宅
出張頻度:     [月 0 回 ▾] ← A3 出張日当
親族役員:     [なし   ▾]  ← A4 親族役員化（業務実態 score 入力）
共済掛金:     [0 万  ▾]   ← A5 小規模企業共済 / A6 セーフティ共済
配当年額:     [0 万  ▾]   ← F-66 連携・F67_DIVIDEND_INTEGRATION_ENABLED で表示切替
─────────────────────────────────
年商:           [1,680 万 ▾]
固定費:         [240 万   ▾]
業務委託費:     [0 万    ▾]  ← A8 業務委託活用（v1 で正社員採用の代替・S3-S4 のみアンロック）
  └ 元請支払サイト: [60 日 ▾]  ← Section G-1 サイト負け検知用
  └ 委託支払サイト: [60 日 ▾]
少額減価償却:   [0 万    ▾]  ← A7 少額減価償却特例（年 300 万枠）
公庫融資申込:   [なし   ▾]   ← A9 公庫融資準備（債務償還年数 ≤ 10 年判定）
退職金プラン:   [なし   ▾]   ← A10 退職金制度設計（S4 でアンロック）
インボイス登録日: [—     ▾]   ← Section G-5 インボイス特例終了崖検知用

v1.2 削除項目 (移行注記): 「採用計画 (正社員 1 名)」と「SaaS 開発 600 万」の入力フィールドは v1.0/1.1 案では存在したが、v1.2 で正社員採用は v2+ 延期 / SaaS 開発は A7 少額減価償却に置換されたため UI から削除。v2+ で正社員採用が再導入される際は MAS-048 連携の「採用計画」フィールドを復活する。

webapp_client/src/multiyear/YearTabs.tsx で実装。F67_PLAN_HORIZON_YEARS で年数可変（default 5・10 まで拡張可・内部実装は N 年汎用ループ）。各ドロップダウンは ai_agent_tips.md §7 準拠の離散単位選択。

Step 2: 計画 P/L・B/S・CF 引継ぎ（4 機能の (b)・Phase A）

各年の P/L → B/S → CF 計算を年次連結で実行:

// 400_domain/451_multiyear_planner.js (純粋関数 + IIFE 名前空間)

var MultiyearPlanner = (function () {

  /**
   * @param {Object[]} yearInputs  Y1-Y5 の各年入力 (5 要素)
   * @param {Object} initialBS     初期 B/S（資本金 + 現預金）
   * @param {Object} [params]      03_sys_params override
   * @returns {Object[]}           各年の {pl, bs, cf, runway, stages, suggestions}
   */
  function simulateMultiyear(yearInputs, initialBS, params) {
    // v1.1: _loadParamsFromSysParams_ ヘルパは廃止 (Gemini レビュー Major 1 反映)
    // → 既存 Constants.getParam を直接呼び出す形に変更
    // v1.2: 5 軸モデル + 10 アクション + Section G で 14 キーに拡張 (旧 v1.0/1.1 の hiring/funding/saas 系 8 キーを廃止)
    var p = params || {
      planHorizonYears: Constants.getParam('F67_PLAN_HORIZON_YEARS', 5),
      // A9 公庫融資準備 (旧: 自己資本比率 ≥ 30% から RQ-036 反映で変更)
      debtRedemptionYearsMax: Constants.getParam('F67_DEBT_REDEMPTION_YEARS_MAX', 10.0),
      cashRunwayMonthsMin: Constants.getParam('F67_CASH_RUNWAY_MONTHS_MIN', 3.0),
      // A1-A10 個別閾値
      a1CfMonthsMin: Constants.getParam('F67_A1_CF_MONTHS_MIN', 6),
      a4JobEvidenceMin: Constants.getParam('F67_A4_JOB_EVIDENCE_MIN', 3),
      a5OpProfitMin: Constants.getParam('F67_A5_OP_PROFIT_MIN', 840000),
      a6OpProfitMin: Constants.getParam('F67_A6_OP_PROFIT_MIN', 2400000),
      a7CapexLimit: Constants.getParam('F67_A7_CAPEX_LIMIT', 3000000),
      a8RunwayMin: Constants.getParam('F67_A8_RUNWAY_MIN', 3),
      a8GrossMarginMin: Constants.getParam('F67_A8_GROSS_MARGIN_MIN', 8000000),
      a10TenureMin: Constants.getParam('F67_A10_TENURE_MIN', 5),
      // Section G + 最優先ポリシー
      optimizationPolicyDefault: Constants.getParam('F67_OPTIMIZATION_POLICY_DEFAULT', 'A'),
      burnoutOccupancyRedThreshold: Constants.getParam('F67_BURNOUT_OCCUPANCY_RED_THRESHOLD', 100),
      invoiceTransitionEndDate: Constants.getParam('F67_INVOICE_TRANSITION_END_DATE', '2026-09-30'),
      // 既存 flag
      dividendIntegrationEnabled: Constants.getParam('F67_DIVIDEND_INTEGRATION_ENABLED', 'false') === 'true',
      aiSuggestEnabled: Constants.getParam('F67_AI_SUGGEST_ENABLED', 'false') === 'true',
    };

    // v1.1: 計算エンジンの多重ロード回避 (Gemini レビュー Major 2 反映)
    // → マスタ・パラメータを冒頭で一度キャッシュし各エンジンへ Context 注入
    var ctx = {
      socialInsuranceTierMap: SocialInsuranceTierRepository.findAsMap(),
      perDiemPolicyMap: PerDiemPolicyRepository.findAsMap(),
      taxBrackets: { income: Constants.INCOME_TAX_BRACKETS, corp: Constants.TAX_RATES },
    };

    var results = [];
    var carryoverBS = initialBS;
    for (var i = 0; i < yearInputs.length; i++) {
      var year = i + 1;
      var pl = _computePL_(yearInputs[i]);
      var bs = _computeBS_(carryoverBS, pl, yearInputs[i]);
      var cf = _computeCF_(carryoverBS, bs, pl, yearInputs[i]);
      var runway = _computeRunway_(bs.cashBalance, pl);
      // v1.2: 5 軸 (Liquidity / Tax & Social / Scale / Accumulation / Exit) × A1-A10 評価
      var lifeStage = _evaluateLifeStage_(year, pl, bs, runway, p);
      var stages = _evaluateStages_(year, pl, bs, cf, runway, lifeStage, p);
      // v1.2: ガードレール 10 件 + Section G 5 機能
      var guardrails = evaluateGuardrails(yearInputs[i], stages, p);
      var sectionG = {
        siteGap: detectFreelanceLawSiteGap(yearInputs[i]),
        burnout: calcBurnoutMeter(yearInputs[i]),
        invoiceCliff: detectInvoiceTransitionCliff({ ...yearInputs[i], year: year }),
        // 退職控除 5 年ルール / セーフティ共済出口パズルは plan 全体スコープなのでループ外で評価
      };
      var suggestions = _generateSuggestions_(stages, yearInputs[i], p);
      results.push({
        year: year,
        pl: pl,
        bs: bs,
        cf: cf,
        runway: runway,
        lifeStage: lifeStage,
        stages: stages,           // { liquidity, taxSocial, scale, accumulation, exit, actions: { A1..A10 } }
        guardrails: guardrails,
        sectionG: sectionG,
        suggestions: suggestions,
      });
      carryoverBS = bs;  // 翌年期首 B/S = 当年期末 B/S
    }
    // plan 全体スコープの Section G (G-2 / G-3) は results 構築後に追加評価
    var planScopeG = {
      retirementConflict: detectRetirementDeductionConflict(yearInputs),
      safetyNetExit: evaluateSafetyNetExitPuzzle({ years: results, ...yearInputs[0] }),
    };
    return { years: results, planScopeG: planScopeG };
  }

  return { simulateMultiyear: simulateMultiyear /* 他 */ };
})();

B/S 引継ぎ項目（会計仕訳と整合）

webapp_client/src/multiyear/BSCarryover.tsx で各年の繰越状況をビジュアル表示（前年末 → 翌年期首の矢印 + 数値変動）。

MAS-058 必要年商の各年逆算

各年で RequiredRevenueSolver.solveRequiredRevenue() を呼出し、その年の希望役員報酬で必要年商 Healthy を逆算。実際の年商入力値が Healthy を下回ると「年商不足」警告を該当年タブに表示。

Step 3: 5 軸ステージ準備度ダッシュボード（4 機能の (c)・Phase B・v1.2 で 3 アクション → 5 軸 10 アクションに再編 / MAS-334 Gemini Deep Think 精緻化反映）

v1.2 改訂: 当初 v1.0/1.1 の「アクション準備度 3 種 (採用 / 融資 / SaaS 投資)」を、MAS-334 Gemini 3 Pro Preview Deep Think 精緻化により 5 軸モデル + 10 アクション + プログレッシブ・ディスクロージャー に再編。退職金が「投資」と「出口」で重複していた 6 軸モデルを 5 軸に整理し、1 人社長メンタルモデルに直結。

5 軸モデル (BRD §5.3 v2.3 / MAS-334 Section B 整合)

🏦 Liquidity (流動性・防衛)        — 公庫融資・Runway 確保 [A9]
🛡️ Tax & Social (節税・社保)       — 役員報酬・社宅・出張日当・親族役員化 [A1-A4]
⚔️ Scale (事業拡張)                 — 業務委託・少額減価償却特例 [A7-A8]
💰 Accumulation (蓄積)              — 小規模企業共済・経営セーフティ共済 [A5-A6]
🚪 Exit (出口・承継)                — 退職金制度 [A10]

v1 採用 10 アクション (Gemini 精緻化版・MAS-334 Section A 反映)

+ 表示のみ A11: 賃上げ促進税制 (MAS-049)・1 人法人は構造的に対象外を 🔴 明示 ("適用できないことを知る" UX 価値)

v1 で除外したアクション

• インボイス・電帳法 (Day 1 法定要件・オンボーディングチェックリストへ移譲)
• SaaS 開発投資 (v1 スコープ重い・A7 少額減価償却に置換)
• 正社員採用 (S3-S4 のみ・v2+)
• 補助金マッチング (MAS-068・P3 降格)
• HD/M&A (MAS-069・P3)
• マイクロ法人 (MAS-070 棄却・実質所得者課税で否認)
• サイバーセキュリティ等

プログレッシブ・ディスクロージャー (S1-S4 で軸を順次アンロック・MAS-334 Section B)

                         Y1     Y2     Y3     Y4     Y5
─────────────────────────────────────────────────────────
ライフステージ           S1     S2     S2     S3     S3
─────────────────────────────────────────────────────────
🏦 Liquidity (A9)       🔴     🟡     🟢     🟢     🟢
🛡️ Tax & Social         —      🟡     🟢     🟢     🟢   ← S2 でアンロック
   ├─ A1 役員報酬最適化  —      🟡     🟢     🟢     🟢
   ├─ A2 役員社宅        —      🔴     🟡     🟢     🟢
   ├─ A3 出張日当        —      🔴     🟡     🟢     🟢
   └─ A4 親族役員化      —      🔴     🔴     🟡     🟢
💰 Accumulation         —      🔴     🟡     🟢     🟢   ← S2 でアンロック
   ├─ A5 小規模企業共済  —      🔴     🟡     🟢     🟢
   └─ A6 セーフティ共済  —      🔴     🔴     🟡     🟢
⚔️ Scale                —      —      —      🟡     🟢   ← S3 でアンロック
   ├─ A7 少額減価償却    —      —      —      🟢     🟢
   └─ A8 業務委託        —      —      —      🟡     🟢
🚪 Exit (A10)           —      —      —      —      🔴   ← S4 でアンロック (Y5 で初表示)
A11 賃上げ税制 (表示のみ) 🔴 (常時) 1人法人は構造的に対象外

判定ロジック (アクションごと・閾値は F67_STAGE_THRESHOLDS_* で運用上書き可)

A9 GAS 実装制約: 営業 CF ≤ 0 で debtRedemptionYears = totalDebt / operatingCF = Infinity / NaN 発生 → Math.min(val, 999) サニタイズ必須 (failure_patterns #29 V8→Java silent null 対策)。

function _calcDebtRedemptionYears_(totalDebt, operatingCF) {
  if (operatingCF <= 0) return 999;  // 営業 CF が赤字なら理論上返済不能 = 999 年でサニタイズ
  var raw = totalDebt / operatingCF;
  return Math.min(raw, 999);          // Infinity 防衛
}

webapp_client/src/multiyear/StageDashboard.tsx で Y1-Y5 × (1 ステージ + 5 軸 + 10 アクション展開) の信号機マトリクス表示。プログレッシブ・ディスクロージャーで アンロック前の軸は — 表示 (経営者のメンタルモデル負荷を最小化)。各セルクリックで判定根拠 (充足/未充足の指標一覧 + 評価順序ハードロックの説明) を expand 表示。

達成予定年バッジ (MAS-334 Section E): array.findIndex(s => s === '🟢') で最初の 🟢 年を検出 → 「🟡 業務委託活用 🎯 計画通りなら Y3 (2028 年) に実行可能ライン到達見込」型の未来道標を表示。

循環参照解消: 最優先ポリシー A/B/C セレクター (MAS-334 Section D)

5 軸間の相互依存 (例: 役員報酬 ↔ 公庫融資枠 ↔ 退職金限度額) で発生する 3↔6↔9 の三すくみ は、DAG エッジカット (循環検知時に Y-1 値または固定値にフォールバック・1 パスで強制終了) + 「最優先ポリシー」3 択 UI セレクター で解消する。

UI: MAS-067 cockpit ヘッダに「🎯 最適化ポリシー: [A 手取り優先 ▼]」ドロップダウン (ポリシー切替 = 全年再計算)。F67_OPTIMIZATION_POLICY_DEFAULT = A で default 確定。

ライフステージ S1-S4 自動判定（BRD §5.3 v2.3 整合・財務指標動的判定 + 年数機械的判定の併用）

Step 4: サジェストエンジン（4 機能の (d)・Phase C/D）

「Y3 で公庫融資準備 (A9) 完了するには Y2 までに営業 CF +X 万」型の自動アドバイス。v1.2 改訂で v1.0/1.1 の 3 アクション (採用 / 融資 / SaaS 投資) → 10 アクション (A1-A10) ルールベースに拡張。

function _generateSuggestions_(stages, yearInput, p) {
  var suggestions = [];

  // A9 公庫融資準備 (旧: 採用準備度 → v1.2 で正社員採用は v2+ 延期)
  if (stages.actions.A9 === 'red') {
    var debtRedemptionDeficit = stages.actions.A9Deficit.debtRedemptionYearsExcess;  // 10 年閾値超過
    var cashRunwayDeficit = stages.actions.A9Deficit.cashRunwayMonthsShortage;       // 3 ヶ月閾値不足
    if (debtRedemptionDeficit > 0) {
      suggestions.push({
        type: 'op_cf_increase',
        target: 'A9 公庫融資準備 🟢',
        action: '前年までに営業 CF +' + Math.ceil(debtRedemptionDeficit * yearInput.totalDebt / 100) + ' 万 (債務償還年数を 10 年以下に)',
        severity: 'high',
      });
    }
    if (cashRunwayDeficit > 0) {
      suggestions.push({
        type: 'cash_reserve_buildup',
        target: 'A9 公庫融資準備 🟢',
        action: '前年までに現預金 +' + Math.ceil(cashRunwayDeficit * (yearInput.monthlyFixedCost || 0) / 10000) + ' 万 (現預金 ≥ 3 ヶ月分確保)',
        severity: 'high',
      });
    }
  }

  // A8 業務委託活用 (v1 で正社員採用判定の代替・S3-S4 でアンロック)
  if (stages.actions.A8 === 'red') {
    var grossMarginShortage = p.a8GrossMarginMin - (yearInput.grossMargin || 0);
    if (grossMarginShortage > 0) {
      suggestions.push({
        type: 'gross_margin_increase',
        target: 'A8 業務委託活用 🟢',
        action: '前年までに粗利 +' + Math.ceil(grossMarginShortage / 10000) + ' 万 (800 万閾値到達)',
        severity: 'medium',
      });
    }
    suggestions.push({
      type: 'outsource_postpone',
      target: 'A8 業務委託活用 🟢',
      action: '業務委託開始を翌年（Y' + (stages.year + 1) + '）に後ろ倒し',
      severity: 'low',
    });
  }

  // A1 役員報酬最適化 / A5 / A6 共済 / A7 少額減価償却 / A10 退職金 も同様パターンで生成
  // (10 アクション分のルール定義は _RULES_ 定数に集約)

  return suggestions;
}

Phase C: ルールベース実装

上記のような決定論的ルールで A1-A10 各アクションごとに 1-3 件のサジェストを生成（最大 10-30 件 / 年）。ルール定義は 400_domain/451_multiyear_planner.js 内の _RULES_ 定数で集中管理。F67_AI_SUGGEST_ENABLED = false でルールベースのみ動作。プログレッシブ・ディスクロージャー (S1=Liquidity のみ → S4=+Exit) で アンロック前の軸はサジェスト生成スキップ (経営者メンタルモデル負荷を最小化)。

Phase D: AI 提案統合 (✅ 完了 PR #448・2026-04-30)

F67_AI_SUGGEST_ENABLED = true で Vertex Gemini 連携を有効化。300_ui/302_spa_bridge.js に generateF67Suggest 関数追加（MAS-057 Phase 3 の generateF57Insight パターン流用）。Gemini Pro モデル + Deep Think で「自然言語でユーザーに最適な経路を提案」。buildSuggestPrompt_(currentPlan, stageEvaluations) で構造化プロンプト生成（純粋関数として MAS-057 spec の buildInsightPrompt_ と並列対称）。

実装済 sys_params キー 5 件 (800_ops/820_migration_f67_phase_d_seed.js で冪等投入): (a) F67_AI_SUGGEST_ENABLED (default false) / (b) F67_AI_SUGGEST_MODEL (default GEMINI_PRO・GEMINI_PRO/GEMINI_FLASH/CLAUDE_SONNET 選択肢) / (c) F67_GEMINI_MODEL_OVERRIDE_PRO (default gemini-2.5-pro) / (d) F67_GEMINI_MODEL_OVERRIDE_FLASH (default gemini-2.5-flash) / (e) F67_AI_TEMPERATURE (default 0.3・経営アドバイスは具体数値含むため低温で一貫性確保)。

SuggestPanel UI: AI モデル selector (GEMINI_PRO/GEMINI_FLASH/CLAUDE_SONNET/CUSTOM) + Custom Model ID 入力 (default gemini-3.1-pro-preview — Custom 選択時のフォールバック値) + 🧠 Deep Think + temperature 入力 + 「💡 AI に統合提案を依頼」ボタン。F67_AI_SUGGEST_ENABLED=false 時は無効化メッセージ + 有効化方法の案内を表示・ルールベースサジェスト (Phase C-1) は AI OFF でも引き続き動作。

Vertex AI quota 状況 (2026-04-30 時点): Gemini Pro/Flash は dev で動作確認済。Anthropic Claude (Vertex 経由) は dev quota escalation 申請中のため初期 default は GEMINI_PRO。

LLM ハルシネーション対策（MAS-058 注意事項 #12 / MAS-333 反映）: 数値はサジェストオブジェクトから直接取得・LLM テキスト応答中で復唱させない。Air Canada v. Moffatt 型責任回避を継承。

Step 5: 行為計算否認ガードレール 10 件 UI 表示（v1.2 追加・MAS-334 Section C・Phase B）

各アクションの実行時に税務否認リスクが発生し得る。spec § 注意事項に文言ハードコードし、webapp_client/src/multiyear/GuardrailPanel.tsx（新規・Phase B で追加）で常時表示・🟢 到達時表示・変更時警告・超過時警告のいずれかで提示する。

実装: 400_domain/451_multiyear_planner.js 内に GUARDRAILS 定数を定義し、evaluateGuardrails(plan) 純粋関数で各アクションのトリガー条件 (常時 / 🟢到達時 / 超過時 / 変更時 / 数値超過時) を判定 → DTO に含めて runMultiyearSimulation 戻り値で返却。GuardrailPanel.tsx は DTO の guardrails 配列を表示するだけのプレゼンテーション層。

var GUARDRAILS = [
  { id: 1, action: 'A1', trigger: 'on_change', message: '期首から 3 ヶ月以内の改定が必須です...' },
  { id: 2, action: 'A2', trigger: 'on_green', message: '国税庁算式の『法定家賃』を毎月徴収しない場合...' },
  // ... 計 10 件
];

Step 6: Deep Think 独自必須機能 5 件（v1.2 追加・MAS-334 Section G・Phase B/C）

Gemini 3 Pro Preview Deep Think で発見された Claude 合成見落とし 5 件。海外 FP&A SaaS でも空白の差別化機能。

MAS-236. フリーランス新法 60 日支払義務 vs 元請 90 日サイトのキャッシュ枯渇 (Phase B)

A8 業務委託活用で外注費先行・受領遅延でワーキングキャピタルギャップ → 🔴 アラートロジック必須。

function detectFreelanceLawSiteGap(yearInput) {
  if (yearInput.outsourcePaymentDays > 60) {
    return { level: 'red', reason: 'フリーランス新法違反: 60 日超過 (法令違反 → 50 万以下罰金 + 公表)' };
  }
  if (yearInput.clientPaymentDays - yearInput.outsourcePaymentDays > 30) {
    return {
      level: 'yellow',
      reason: 'ワーキングキャピタルギャップ: 元請 ' + yearInput.clientPaymentDays + '日 vs 外注 ' + yearInput.outsourcePaymentDays + '日',
      cashGapMonths: (yearInput.clientPaymentDays - yearInput.outsourcePaymentDays) / 30,
    };
  }
  return { level: 'green' };
}

UI: 業務委託 (A8) のドロップダウンに「元請支払サイト (日)」「委託先支払サイト (日)」入力 + サイト負け検知結果を信号機表示。

MAS-237. 退職所得控除「枠の食い合い」5 年/19 年ルール (Phase C)

共済 + 役員退職金を近接時期に受け取ると控除枠相殺 → タイムライン上で「受取時期 5 年ズラす」ガードレール必須。

function detectRetirementDeductionConflict(plan) {
  var smallEnterpriseExitYear = plan.smallEnterpriseExitYear;     // 小規模企業共済受取年
  var directorRetirementYear = plan.directorRetirementYear;       // 役員退職金受取年
  if (!smallEnterpriseExitYear || !directorRetirementYear) return { level: 'green' };
  var diff = Math.abs(directorRetirementYear - smallEnterpriseExitYear);
  if (diff < 5) {
    return {
      level: 'yellow',
      reason: '退職所得控除「5 年ルール」違反リスク: ' + diff + '年差 (5 年以上空ける必要あり・控除枠重複)',
      suggestion: '一方を ' + (5 - diff) + '年後ろ倒しに変更',
    };
  }
  return { level: 'green' };
}

UI: A10 退職金 + A5/A6 共済の各受取年をユーザーがタイムライン上に配置 → 5 年ルール違反時に🟡 + ズラし提案表示。

MAS-238. 2024.10 法改正セーフティ共済「出口パズル」(Phase C)

短期解約ループ死滅 → 「いつ解約・どの年に益金 vs 退職金/赤字とぶつけるか」マッピング設計が MAS-067 コアバリュー。

UI: Y1-Y5 タイムライン上に「セーフティ共済解約フラグ」をユーザーが立てる → 解約年の益金計上額 (積立額全額) を退職金支給年や赤字年と相殺できるか自動判定 → 🟢 (相殺成功・益金 ≤ 損金) / 🟡 (一部相殺) / 🔴 (相殺不能・課税発生) で評価。

function evaluateSafetyNetExitPuzzle(plan) {
  var exitYear = plan.safetyNetExitYear;                          // 解約年
  if (!exitYear) return { level: 'green', skipped: true };
  var accumulatedAmount = plan.safetyNetAccumulated;              // 積立済額 (益金計上)
  var offsetYearLoss = plan.years[exitYear].operatingLoss || 0;
  var offsetYearRetirement = plan.years[exitYear].retirementPayment || 0;
  var totalOffset = offsetYearLoss + offsetYearRetirement;
  if (totalOffset >= accumulatedAmount) return { level: 'green', message: '相殺成功: 益金 ' + accumulatedAmount + ' ≤ 損金 ' + totalOffset };
  if (totalOffset >= accumulatedAmount * 0.5) return { level: 'yellow', message: '一部相殺: 益金の ' + Math.round((totalOffset / accumulatedAmount) * 100) + '% を相殺' };
  return { level: 'red', message: '相殺不能: 課税発生 ' + (accumulatedAmount - totalOffset) + ' 円・解約年見直し推奨' };
}

MAS-239. 社長稼働限界 (Burnout) メーター (Phase B)

ナレッジワーカー売上増 ∝ 労働時間 → 売上 2 倍計画で稼働 200% の物理破綻を 稼働率 (%) で計算・100% 超で🔴 + 業務委託強制サジェスト。

function calcBurnoutMeter(yearInput) {
  var monthlyHourlyRate = yearInput.monthlyHourlyRate;            // 例: 10000 円/h
  var monthlyTargetRevenue = yearInput.monthlyRevenue;
  var monthlyMaxHours = 160;                                       // 月 160 時間 = 100% 稼働
  var requiredHours = monthlyTargetRevenue / monthlyHourlyRate;
  var occupancyRate = (requiredHours / monthlyMaxHours) * 100;
  if (occupancyRate > 100) {
    return {
      level: 'red',
      occupancy: occupancyRate,
      message: 'Burnout 警告: ' + occupancyRate.toFixed(1) + '% 稼働 → 業務委託 (A8) を強制サジェスト',
      suggestedOutsourceHours: requiredHours - monthlyMaxHours,
    };
  }
  if (occupancyRate > 80) return { level: 'yellow', occupancy: occupancyRate, message: '稼働率高: ' + occupancyRate.toFixed(1) + '%・余力低下' };
  return { level: 'green', occupancy: occupancyRate };
}

UI: webapp_client/src/multiyear/BurnoutMeter.tsx（新規・Phase B）で各年の稼働率を progress bar 表示・100% 超で 🔴 + A8 サジェストポップアップ。

MAS-240. インボイス 2 割特例 2026/9 終了の崖 (Phase B)

2023/10 登録法人は 2026/9 含む課税期間で特例終了・消費税キャッシュアウト跳ね上がり → 5 年計画 Y2-Y3 で織込み必須。

function detectInvoiceTransitionCliff(plan) {
  var registrationDate = plan.invoiceRegistrationDate;
  var fiscalYearEndMonth = plan.fiscalYearEndMonth;
  if (!registrationDate || registrationDate >= new Date('2023-10-01')) return { level: 'green' };
  var transitionEndDate = new Date('2026-09-30');
  var firstFullCostFiscalYear = _calcFirstFullCostFiscalYear_(registrationDate, fiscalYearEndMonth, transitionEndDate);
  return {
    level: 'yellow',
    cliffYear: firstFullCostFiscalYear,
    message: 'Y' + firstFullCostFiscalYear + ' (' + (2026 + firstFullCostFiscalYear) + ' 年) からインボイス 2 割特例終了・消費税キャッシュアウト本則計上',
    expectedCashOutDelta: plan.years[firstFullCostFiscalYear].consumptionTax * 0.8,
  };
}

UI: A8 業務委託活用ドロップダウンに「インボイス登録日」入力 + 2 割特例終了崖年を 5 カ年タイムライン上に🟡マーカー表示。

影響範囲

注意事項

1. MAS-059 との完全分離: MAS-067 = 人間駆動（手動入力 + 静的・俯瞰）/ MAS-059 = AI 自動オーケストレーション（LangGraph）。両者の UI / バックエンド・実装パイプラインは完全独立。3 cockpit（MAS-057 単年 / MAS-067 マルチイヤー / MAS-059 AI 自動）は BRD §6.1 v2.2 で並列提供方針確定。

2. B/S 引継ぎの会計的正確性: 利益剰余金繰越 + 配当決議減少 + 共済積立資産化 を会計仕訳と整合させる。実装時に顧問税理士確認必須。特に配当決議のタイミング（株主総会決議日 vs 配当支払日）は B/S 影響期間と整合させる。

3. ステージ判定閾値の妥当性: v1.2 の A1-A10 個別閾値 (default: A1 月次 CF 連続黒字 ≥ 6 ヶ月 / A5 営業利益 ≥ 84 万 / A6 営業利益 ≥ 240 万 / A7 CAPEX < 300 万 / A8 ランウェイ ≥ 3 ヶ月 + 粗利 ≥ 800 万 / A9 債務償還年数 ≤ 10 年 + 現預金 ≥ 3 ヶ月 / A10 役員勤続 ≥ 5 年 + 利益剰余金 ≥ 1,000 万) は税理士 / 銀行員 / VC との突合で実装時に確定（人間検討事項 #2）。F67_A1_CF_MONTHS_MIN 〜 F67_A10_TENURE_MIN 等の個別キーで運用時上書き可能。

4. 計画期間の汎用化: F67_PLAN_HORIZON_YEARS で 5-10 年可変・内部実装は N 年汎用ループ（30 年退職金計画等の将来拡張余地）。UI の year-tab も動的生成（Array.from({length: N}, ...) パターン）。

5. MAS-066 配当ミックスの任意連携: F67_DIVIDEND_INTEGRATION_ENABLED flag で切替・MAS-066 仕様書完成後の Phase B 以降で本格統合。Phase A では配当ドロップダウン非表示（給与系のみで動作）。

6. failure_patterns #18-#20 遵守（命名造語禁止）: 関数名（simulateMultiyear / _evaluateStages_ / _generateSuggestions_）は既存命名規則と整合（動詞 + 目的語）。「multiyear」「stage」は業界標準英語で新語ではない。Read で既存ファイルに同名関数なきこと裏取り。

7. failure_patterns #25 遵守（並列実装対称性）: MAS-057 / MAS-066 と純粋関数 + Constants.getParam パターンで対称。3 cockpit（MAS-057/MAS-066/MAS-067）は API 設計を統一（bootstrap / runXSimulation / generateXInsight の 3 関数構成）。

8. failure_patterns #26 遵守（oauthScopes）: appsscript.json は変更なし。

9. failure_patterns #29 遵守（V8→Java Infinity null・v1.1 で対策方式を境界処理に修正・Gemini レビュー Critical 2 反映）: 5 カ年配列の各要素で多重発生リスクあり。❌ NG（v1.0 案）: 「Constants.INCOME_TAX_BRACKETS.brackets[6].upTo = Infinity 等の定数自体を Number.MAX_SAFE_INTEGER に書換える」→ 法人税計算等の他モジュールの挙動を破壊するため不可。✅ 採用方式（v1.1）: 「runMultiyearSimulation がクライアントへレスポンスを返す直前に、DTO 内の Infinity を Number.MAX_SAFE_INTEGER に置換する境界処理」を 300_ui/302_spa_bridge.js の _scrubInfinityForJSON_(dto) 純粋関数で実装。MAS-057 Phase 3 の同パターンと整合。MultiyearPlanner の戻り値も全要素を Number.isFinite() でチェックし、境界処理でクライアント送信時のみ scrub。

10. failure_patterns #31 適用: 本案件起票時に Phase 1-A-pre（番号衝突チェック）を適用済（PR #384・MAS-067 が次空きであることを git fetch + grep で事前確認）。dev_spec_prompt_template v1.10 の初回適用事例。

11. 税理士助言代替不可 Disclaimer: MAS-058 / MAS-061 / MAS-066 と同パターンで全画面常時表示。「本提案は税理士・社労士・銀行員・VC の個別助言に代わるものではありません」を画面下部固定。

12. 計画 vs 実績の乖離: 本案件は計画作成支援に専念し、実績マートとの比較タブは v2 候補（人間検討事項 #11）。Phase A-D では計画機能のみ提供。

13. AI サジェストの届出期限警告（Phase D）: 事前確定届出給与の届出期限（株主総会決議日から 1 ヶ月以内 or 事業年度開始日から 4 ヶ月以内）を AI 提案時に併記。BRD §6 / MAS-057 注意事項 #15 と整合。

14. マトリクスの視認性: v1.2 で 5 年 × (1 ライフステージ + 5 軸 + 10 アクション展開) = 約 80 セル に拡大。プログレッシブ・ディスクロージャーで未アンロック軸は — 表示するため実効セル数は S1 で 5 × 2 ≈ 10、S4 で 5 × 17 ≈ 85 と段階的増加。モバイル（< 768px）では年次方向に横スクロール、軸 / アクション方向は固定列でスクロール追従。各軸は折り畳み可能（default 閉・🟡 🔴 がある軸のみ開）で初期視認性を確保。

エッジケース

実装時に必ず以下 18 件を単体テストでカバーする。

実データ検証

1. 齋藤 Baseline + 5 カ年計画の期待値

実装完了後に以下を 901_test_runner.js で自動検証し、±10% 以内で一致を合格基準とする（マルチイヤーは複利的に誤差累積するため MAS-058/MAS-066 より広め）:

v1.2 改訂: 旧 v1.0/1.1 の「採用 / 融資 / SaaS 準備度」3 列ヘッダを 5 軸モデル + 代表アクションに置換。Y3 の「正社員採用 +580 万」は v2+ 延期のため A8 業務委託活用 +200 万に置換、Y5 の「SaaS 投資 600 万」は A7 少額減価償却 +280 万に置換。

プログレッシブ・ディスクロージャー: S1 (Y1) では Liquidity のみ表示・他軸は —。S2 (Y2-Y3) で Tax & Social + Accumulation アンロック。S3 (Y4-Y5) で Scale アンロック。Exit (A10) は S4 で初めてアンロックされるため Y5 までは未表示。

2. MAS-058 / MAS-066 / MAS-057 との連動整合

• 各年の Healthy 年商を MAS-058 で逆算 → MAS-067 入力年商と比較し「不足/充足」判定
• MAS-066 配当ミックス有効化時、各年の配当 → 利益剰余金減少 → 翌年期首 B/S への影響を検証
• MAS-057 Phase 3 の Step 6（3 区分テーブル UI）を MAS-067 各年タブ内に再利用（個人/法人/合計の縦展開）

3. ライフステージ S1-S4 自動判定の境界検証

4. ステージ準備度信号機の境界検証 (v1.2: 5 軸 10 アクション)

A1 役員報酬最適化 🟢 達成境界:

• 月次 CF 連続黒字 5.99 ヶ月 → 🟡 / 6.0 ヶ月 → 🟢 (F67_A1_CF_MONTHS_MIN = 6)

A8 業務委託活用 🟢 達成境界:

• ランウェイ 2.99 ヶ月 → 🔴 / 3.0 ヶ月 → 🟡 (F67_A8_RUNWAY_MIN = 3)
• 粗利 7,999,999 円 → 🟡 / 8,000,000 円 → 🟢 (F67_A8_GROSS_MARGIN_MIN = 8000000)

A9 公庫融資準備 🟢 達成境界 (v1.2 で旧自己資本比率閾値から変更):

• 債務償還年数 10.01 年 → 🟡 / 10.0 年 → 🟢 (F67_DEBT_REDEMPTION_YEARS_MAX = 10.0)
• 現預金 2.99 ヶ月 → 🔴 / 3.0 ヶ月 → 🟡 (F67_CASH_RUNWAY_MONTHS_MIN = 3.0)
• 境界・サニタイズ: 営業 CF ≤ 0 → _calcDebtRedemptionYears_ が 999 を返却 (Infinity 回避)

これらを単体テスト F67-04〜F67-08 で網羅。

5. エッジケース検証（単体テスト F67-01〜F67-18）

エッジケースセクションの 18 項目それぞれを 1 テストケースとして 901_test_runner.js に追加。

関連ドキュメント

人間が検討すべき事項

1. 計画期間 default: 5 年 vs 10 年 vs 30 年の根拠（退職金見込み年・出口戦略タイミング・経営者の人生観で異なる）。F67_PLAN_HORIZON_YEARS で運用時切替可だが default 値の選定。

2. ステージ判定閾値の妥当性 (v1.2): A1 月次 CF 連続黒字 ≥ 6 ヶ月 / A5 営業利益 ≥ 84 万 / A6 営業利益 ≥ 240 万 / A7 CAPEX < 300 万 / A8 ランウェイ ≥ 3 ヶ月 + 粗利 ≥ 800 万 / A9 債務償還年数 ≤ 10 年 + 現預金 ≥ 3 ヶ月 (v1.0/1.1 の自己資本比率 ≥ 30% から MAS-334 反映で変更) / A10 役員勤続 ≥ 5 年 + 利益剰余金 ≥ 1,000 万 は仮置き・税理士 / 銀行員 / VC の実務感覚と突合必要。Phase B 実装後に外部レビュー実施。

3. ライフステージ S1-S4 の境界判定: 年数で機械的判定（Step 3 で v1 採用）vs 財務指標で動的判定（v2 候補）。動的判定にすると判定逆転（一度 S2 になった後に S1 に戻る）の UX 設計が複雑化するため v1 は機械的を推奨。

4. B/S 引継ぎの粒度: 12 ヶ月単位（spec 採用）vs 四半期単位 vs 月次。月次粒度は計算量とデータ入力負荷が指数的に増加するため v1 は年次。

5. MAS-058 必要年商の連動: 各年で 3 段階（Min/Healthy/Buffered）表示するか・1 つだけ表示するか。3 段階表示は情報量過多のため v1 は Healthy 1 つを default、tooltip で Min/Buffered 表示。

6. MAS-066 配当ミックスの組込タイミング: MAS-066 仕様書完成前の Phase A では disabled、MAS-066 仕様書 v1.0 完成後の Phase B 以降で有効化。Phase A 完成のみで MAS-066 着手可能。

7. UI レイアウト: Y1-Y5 をタブ（spec 採用）vs 列並列（5 列同時表示）vs 折れ線連結のサンキー。タブが情報密度最低・列並列は視認性高いが横スクロール必須・サンキーは流量可視化に強い。Phase A は タブ default、Phase B で列並列モード追加検討。

8. サジェストエンジンのアルゴリズム: ルールベース（Phase C）vs LLM（Phase D）vs ハイブリッド。spec はハイブリッド採用（Phase C ルールベース基盤 + Phase D で AI 提案統合）。

9. 「達成困難」シナリオの扱い: 赤信号で停止 vs 「次年に再挑戦」の自動繰越。spec は「達成困難・計画見直し推奨」表示で停止し、ユーザーに修正させる方針（自動繰越は計画意思の歪曲リスク）。

10. 商用化時のテンプレート: BZ-1 コンサル / BZ-2 SaaS / BZ-5 ハイブリッドで業種別プリセット用意（PH-4 商用化期）。Phase A-D は bizlp 自身の運用検証に専念。

11. 計画 vs 実績の乖離キャッチアップ UI: 本案件 v2 候補（実績マートとの比較タブ）。MAS-067 計画 vs MAS-003 KPI ダッシュボードの実績を月次で突合する機能（v2.0 で別 PR）。

12. AI サジェストの届出期限警告: 事前確定届出給与の届出期限を AI 提案時に併記。BRD §6 / MAS-057 注意事項 #15 整合。Phase D 実装時に必須。

13. MAS-008 / MAS-011 / MAS-013 / MAS-058 を呼び出す純粋関数集約レイヤーの設計責務: 本案件（MAS-067 MultiyearPlanner）に集約する案 vs MAS-059 DecisionTreeOrchestrator と統合する案。spec は MAS-067 独立を採用（MAS-059 とは別の設計哲学のため）。MAS-048 採用 TCO は v1.2 で v1 スコープから除外 (正社員採用は v2+) のため呼出対象外。

14. ステージ準備度の「1 つでも 🟢 になったら通知」のアラート機構: MAS-009 連携で「Y3 で A9 公庫融資準備 🟢 達成」「Y4 で ⚔️ Scale 軸 アンロック」のような前向き通知を経営者にプッシュ。Phase B 以降で検討（MAS-009 仕様書完成待ち）。v1.2: 達成予定年バッジ (Step 3) で先取り表示する仕組みは実装済のため、MAS-009 連携時は「達成確定通知」のみ追加。

15. MAS-067 v2 (正社員採用ステージ判定) と MAS-060 (組織構成シミュレーター) の統合判断タイミング (v1.3 追加): v1 で除外した「正社員採用判定 (S3-S4 のみ)」を v2 で A11 軸目アクションとして再導入する際、MAS-060 と統合する vs 分離するの判断は MAS-060 spec v1.0 完成後に行う。推奨は分離パス (MAS-060 = 単年内のミックス最適化 / MAS-067 v2 = 年次連結のステージ判定で住み分け・MAS-067 v2 が MAS-060 を年次で呼出すアグリゲータ構造とする・MAS-067 v1 が MAS-058 を年次で呼ぶ構造と対称)。実装順序: MAS-067 v1 (Phase A-D) → MAS-060 spec 起草 (MAS-058 Step 5 完了待ち) → MAS-060 実装 → MAS-067 v2 spec 起草 → MAS-067 v2 実装。統合パスを選ぶ場合は spec 規模 1.5-2 倍 + 5 軸 × 役職タイプ 7 種の二次元マトリクスで認知負荷増のため、強い UX 要件 (一画面で全部見たい等) が出てこない限り採用しない。判断主体・判断時期: MAS-060 spec v1.0 完成時の Gemini 第三者レビュー + main 側ユーザーの実務感覚で確定。連携先案件: MAS-048 採用 TCO (v2+ で再連携・既に実装済) / MAS-042 投資ハードルレート (v2+ で「業務委託→正社員化損益分岐アラート」残件と統合)。

Phase 分割計画（A-E・段階リリース可・v1.5 で Phase B を 4 サブフェーズに細分化・v1.8 で Phase E 追加）

各 Phase で independent PR・Phase A だけでも価値ある（5 年計画作成支援ツール）ので段階リリースを優先。Phase B-1 完了で 5 軸 × 10 アクション信号機可視化が稼働済。MAS-066 配当ミックス連携は Phase B-4 で実装予定。

Phase B サブフェーズの分割理由（v1.5 で確定）

旧 v1.2-1.4 では「Phase B = 4 週間まとめて実装」だったが、PR レビュー単位での消化が大きすぎることと、ステージダッシュボードだけでも単独価値があることから 4 サブフェーズに分割。B-1 (5 軸 + プログレッシブ・ディスクロージャー) が単独で大きな価値 (信号機可視化) を生むため最優先で完了。残る B-2/B-3/B-4 は順次・並列実装可能。

実装プロンプト（Claude Code 用）

Claude Opus 4.7（1M context）推奨。MAS-008/MAS-011/MAS-013/MAS-058 の 4 エンジン統合 + B/S 引継ぎ会計ロジック + 5 軸ステージ判定 + ガードレール 10 件 + Section G 5 機能 + 7 React コンポーネント 設計の最高難易度（v1.2 で v1.0/1.1 の 5 エンジン → 4 エンジン / 5 React → 7 React に更新。MAS-048 は v2+ 延期）。

## 案件
MAS-067 — マルチイヤー計画ワークスペース + ステージ準備度ダッシュボード（人間駆動・MAS-057 派生）

## 事前調査（必ず Read する）
1. `docs/dev/dev_mas-067_multiyear_planning_workspace.md` 全文（本仕様書）
2. `docs/brd_solo_ceo_financial_navigator.md` §5.1 / §5.3 / §6.1（v2.2 改訂内容）
3. `tasks/prompts/task_F-67.md`（仕様書作成プロンプト・本仕様書の起源）
4. `docs/dev/dev_mas-057_solo_ceo_cockpit.md` v2.0 全文（Phase 3 SPA 実装パターン継承元）
5. `docs/dev/dev_mas-058_required_revenue_solver.md` v1.2（各年で逆算）
6. `400_domain/445_required_revenue_solver.js`（MAS-058 実装・solveRequiredRevenue API）
7. `400_domain/430_what_if_simulator.js`（MAS-011 5 カ年エンジン）
8. ~~`400_domain/412_hiring_tco_simulator.js`（MAS-048 採用 TCO）~~ **v1.2 で v1 スコープから除外** (正社員採用は v2+ 延期。v2+ で再連携時に Read 必要)
9. `400_domain/431_investment_analyzer.js`（MAS-013 投資分析）
10. `webapp_client/src/cockpit/calc.ts`（MAS-057 Phase 3 クライアント側計算パターン）
11. `webapp_client/scripts/sync-engines.mjs`（SSoT 共有方式・451 を sync 対象に追加）
12. `webapp_client/vite.config.ts`（multi-page entry パターン）
13. `300_ui/302_spa_bridge.js`（MAS-057 Phase 3 SPA bridge パターン継承元）
14. `docs/_internal/failure_patterns.md` #18-#20 / #25 / #26 / #29 / #31

## 実装対象（Phase A-D 段階リリース）

Phase A (~2 週間):
1. `400_domain/451_multiyear_planner.js` 新規（IIFE 名前空間 MultiyearPlanner）:
   - simulateMultiyear(yearInputs, initialBS, params) — メイン API
   - 内部ヘルパ: _computePL_ / _computeBS_ / _computeCF_ / _computeRunway_
     (※ v1.1 で _loadParamsFromSysParams_ は廃止・Constants.getParam を直接呼出・
      Gemini レビュー Major 1 反映)
   - MAS-058 / MAS-011 / MAS-013 / MAS-008 を順呼出 (v1.2 で MAS-048 削除・正社員採用は v2+ 延期)
2. `webapp_client/multiyear_cockpit.html` 新規
3. `webapp_client/src/MultiyearApp.tsx` 新規（React ルート）
4. `webapp_client/src/multiyear/{YearTabs,BSCarryover}.tsx` 新規（2 コンポーネント）
5. `webapp_client/src/multiyear/calc.ts` 新規（クライアント計算）
6. `webapp_client/scripts/sync-engines.mjs` 拡張（451 を sync 対象に追加）
7. `webapp_client/vite.config.ts` 拡張（multiyear_spa entry 追加）
8. `300_ui/302_spa_bridge.js` 拡張（multiyear_spa view + bootstrap +
   runMultiyearSimulation API 追加）
9. `templates/financial_cockpit.html` 拡張（ヘッダに「📅 マルチイヤー計画」リンク追加）
10. `03_sys_params` の F67_PLAN_HORIZON_YEARS のみ追加（Phase A 段階）

Phase B (~4 週間・v1.2 拡張: ガードレール + Section G 追加で 3 → 4 週間):
11. _evaluateStages_ ヘルパ追加 + 5 軸 (Liquidity / Tax & Social / Scale / Accumulation / Exit) × A1-A10 判定
    + 14 キー追加 (F67_DEBT_REDEMPTION_YEARS_MAX / F67_CASH_RUNWAY_MONTHS_MIN / F67_A1-A10
    個別閾値 / F67_OPTIMIZATION_POLICY_DEFAULT / F67_BURNOUT_OCCUPANCY_RED_THRESHOLD /
    F67_INVOICE_TRANSITION_END_DATE)
12. webapp_client/src/multiyear/StageDashboard.tsx 新規 (5 軸 × 10 アクション展開・
    プログレッシブ・ディスクロージャー・最優先ポリシー A/B/C セレクター・達成予定年バッジ)
13. webapp_client/src/multiyear/GuardrailPanel.tsx 新規 (v1.2・行為計算否認ガードレール 10 件 UI)
    + evaluateGuardrails(plan) 純粋関数 + GUARDRAILS 定数追加
14. webapp_client/src/multiyear/BurnoutMeter.tsx 新規 (v1.2・社長稼働限界・100% 超で 🔴 + A8 サジェスト)
    + calcBurnoutMeter ヘルパ追加
15. detectFreelanceLawSiteGap (MAS-236) + detectInvoiceTransitionCliff (MAS-240) ヘルパ追加
16. MAS-066 配当ミックス連携（F67_DIVIDEND_INTEGRATION_ENABLED で切替）

Phase C (~3 週間・v1.2 拡張: 退職控除 5 年ルール + セーフティ共済出口パズル追加で 2 → 3 週間):
17. _generateSuggestions_ ヘルパ追加（ルールベース・A1-A10 の 10 アクション分）
18. webapp_client/src/multiyear/SuggestPanel.tsx 新規
19. detectRetirementDeductionConflict (MAS-237) + evaluateSafetyNetExitPuzzle (MAS-238) ヘルパ追加

Phase D (~1 週間):
16. 300_ui/302_spa_bridge.js に generateF67Suggest 関数追加
    + F67_AI_SUGGEST_ENABLED で切替
    + 内部で **Utils.callGeminiForReasoningOnVertex_** (既存・000_infra/004_utils.js) を呼出
    (v1.1 で造語 _callVertexGeminiForF67Suggest_ を廃止・Gemini レビュー Critical 1 反映)
17. buildSuggestPrompt_(currentPlan, stageEvaluations) 純粋関数追加
    (MAS-057 buildInsightPrompt_ と並列対称)
18. 300_ui/302_spa_bridge.js に **_scrubInfinityForJSON_(dto)** 境界処理追加
    (v1.1・Gemini レビュー Critical 2 反映・定数 mutate 禁止)
    - runMultiyearSimulation がクライアントへ返すレスポンスを scrub
    - サーバー側ロジック (MultiyearPlanner) は Infinity のまま動作

全 Phase 共通:
- 900_test/901_test_runner.js に F67-01〜F67-18 単体テスト追加
- 8XX_migration_f67_multiyear_seed.js（任意・F67_* 14 キーシーダー / v1.2 で 10 → 14 に拡張）

## 動作確認
1. 齋藤 Baseline + 5 カ年計画（Y1-Y5）で期末純資産・ステージ準備度が
   実データ検証 §1 の期待値 ±10% 以内
2. MAS-058 各年逆算が `solveRequiredRevenue` の純粋呼出で正常動作
3. ライフステージ S1-S4 自動判定の境界検証（実データ検証 §3）
4. ステージ準備度信号機の境界検証（実データ検証 §4）
5. MAS-066 配当ミックス連携時の B/S 影響（Phase B 以降）
6. AI サジェスト Phase D で Vertex Gemini が正常応答 + null 安全フォールバック
7. エッジケース 18 項目すべて想定通り

## デプロイ手順（各 Phase 共通）
1. dev で push:dev → サイドバーから「📅 マルチイヤー計画」リンク経由で
   multiyear_spa 起動 → 5 年計画入力 → ステージ準備度確認
2. Go なら push:prod
3. コミットメッセージ:
   Phase A: feat(MAS-067 Phase A): MultiyearPlanner + B/S 引継ぎ + year-tab UI
   Phase B: feat(MAS-067 Phase B): 5 軸ステージ準備度ダッシュボード (5 軸 × 10 アクション + ガードレール 10 件 + Burnout メーター + Section MAS-236/MAS-240)
   Phase C: feat(MAS-067 Phase C): サジェストエンジン (ルールベース A1-A10 / 10 アクション + Section MAS-237/MAS-238 退職控除 5 年ルール / セーフティ共済出口パズル)
   Phase D: feat(MAS-067 Phase D): AI 提案統合 (Vertex Gemini + Deep Think)

## failure_patterns チェック
- #18-#20: MultiyearPlanner / simulateMultiyear / _evaluateStages_ を Read で裏取り
- #25: MAS-057 / MAS-066 と純粋関数 + Constants.getParam パターン対称
- #26: appsscript.json は変更なし
- #29: 5 カ年配列の各要素で Infinity / NaN scrub 必須
- #31: 本仕様書起票時に Phase 1-A-pre 適用済（MAS-067 が次空き番号確認）

推奨実行モデル

Phase 別に推奨モデルを使い分け、トークン消費と応答品質を最適化する。

変更履歴