hakorune/docs/development/current/main/phases/phase-125

Phase 125: Reads-only inputs → Normalized env（planned）

目的

• Phase 124 で Return(Variable) を “writes由来の env” だけで解決できるようになった。
• Phase 125 では reads-only（外側スコープの読み取り専用入力）も Normalized env に載せ、return x が “writesではないが読み取り可能” な場合に自然に解決できるようにする。
• 既定挙動は不変：joinir_dev_enabled() のときだけ生成・検証し、本番経路の出力/動作は変えない。

Scope

• 対象: if-only（loopなし）の Normalized（dev-only）
• 目的の追加機能:
  • reads-only inputs を env に追加（return/compare で参照可能）
  • “unknown-read” を capability（または structured error tags）として扱い、strict では Fail-Fast

SSOT 方針

• StepTreeFacts/Contract の reads は “何を読むか” の SSOT
• “どこから読むか（host ValueId の供給）” は builder 側で SSOT 化し、ScopeManager / CapturedEnv / function params を入力として受け取る
• AST から “勝手に capture する” のは禁止（Phase 100 の pinned/captured と混同しない）

受け入れ基準

• cargo test --lib が PASS
• Phase 121–124 の smokes が退行しない
• Phase 125 の新規 fixture/smoke で return が reads-only inputs から解決できる

関連

• Phase 121–124: StepTree→Normalized dev-only の段階投入
  • docs/development/current/main/design/control-tree.md
  • docs/development/current/main/phases/phase-121/README.md
  • docs/development/current/main/phases/phase-124/README.md