feat(normalization): Phase 142 P0 - Loop statement-level normalization
Phase 142-loopstmt P0: Statement-level normalization 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
@ -0,0 +1,96 @@
|
||||
# Phase 143-loopvocab: StepTree Vocabulary Expansion (loop → if/break/continue)
|
||||
|
||||
Status: planned
|
||||
Scope: Normalized shadow / JoinIR(dev-only, default behavior unchanged)
|
||||
|
||||
Related (SSOT):
|
||||
- `docs/development/current/main/design/control-tree.md`
|
||||
- `docs/development/current/main/design/normalized-expr-lowering.md`
|
||||
- `docs/development/current/main/phases/phase-142-loopstmt/README.md`
|
||||
|
||||
---
|
||||
|
||||
## Goal
|
||||
|
||||
`loop(true){ if(cond) break/continue }` を「新パターン追加」ではなく、**StepTree/ControlTree の語彙(vocabulary)拡張**として表現し、同じ Normalized lowering(env + continuation)に流す。
|
||||
|
||||
つまり、suffix/fixture の形を増やすのではなく:
|
||||
|
||||
- **制御は構造(StepTree)**
|
||||
- **値は一般化(ExprLowererBox)**
|
||||
|
||||
で吸収する。
|
||||
|
||||
## Non-Goals
|
||||
|
||||
- `loop(<cond>)`(条件付き loop)を Normalized に入れる(既存経路へフォールバック維持)
|
||||
- impure expression(Call/MethodCall general case)を増やす(Phase 141 P2+ で扱う)
|
||||
- 既定挙動変更(out-of-scope は `Ok(None)` でフォールバック)
|
||||
|
||||
---
|
||||
|
||||
## P0 (planned): If-in-loop (single if, break/continue only)
|
||||
|
||||
### Accepted surface syntax (fixtures)
|
||||
|
||||
1) break:
|
||||
```hako
|
||||
loop(true) {
|
||||
if (cond) { break }
|
||||
}
|
||||
```
|
||||
|
||||
2) continue:
|
||||
```hako
|
||||
loop(true) {
|
||||
if (cond) { continue }
|
||||
}
|
||||
```
|
||||
|
||||
### StepTree vocabulary (existing)
|
||||
|
||||
StepTree は既に `StepNode::Loop` / `StepNode::If` / `StepStmtKind::{Break,Continue}` を持っている。
|
||||
|
||||
P0 の焦点は **Normalized lowering が Loop-body 内の If を受けられるようにする**こと。
|
||||
|
||||
### Capability / contract (Fail-Fast boundary)
|
||||
|
||||
- P0 で許可するのは「Loop-body の先頭/末尾に 1 個の If(else無しでも可)で、その then/else が Break/Continue のみ」まで。
|
||||
- それ以外(ネスト if、複数 if、then に Assign など)は out-of-scope (`Ok(None)`) にして既存経路へフォールバック。
|
||||
- strict/dev では `OutOfScopeReason` を必ず出す(silent accept 禁止)。
|
||||
|
||||
### Implementation sketch (boxes)
|
||||
|
||||
- `NormalizationPlanBox`:
|
||||
- `loop(true)` を見たら `loop_only(consumed=1)`(Phase 142-loopstmt と同じ)
|
||||
- 追加で「Loop-body が If を含むか」を feature として観測(plan の枝分かれは最小)
|
||||
- `NormalizationExecuteBox`:
|
||||
- `execute_loop_only` の内部で StepTree を作る
|
||||
- `StepTreeContractBox` で capability 判定(許可形なら Normalized lowering、不可なら `Ok(None)`)
|
||||
- Normalized lowering:
|
||||
- `if(cond){break}`: `cond_vid` を `ExprLowererBox`(pure only)で生成し、branch to `k_exit` / `loop_step` に落とす
|
||||
- `if(cond){continue}`: then -> tailcall `loop_step`, else -> fallthrough
|
||||
|
||||
### Fixtures / smokes
|
||||
|
||||
- VM + LLVM EXE parity を 1 本ずつ増やす(最小2本)
|
||||
- `apps/tests/phase143_loop_true_if_break_min.hako`
|
||||
- `apps/tests/phase143_loop_true_if_continue_min.hako`
|
||||
- Integration smokes:
|
||||
- `tools/smokes/v2/profiles/integration/apps/phase143_loop_true_if_break_vm.sh`
|
||||
- `tools/smokes/v2/profiles/integration/apps/phase143_loop_true_if_break_llvm_exe.sh`
|
||||
- `tools/smokes/v2/profiles/integration/apps/phase143_loop_true_if_continue_vm.sh`
|
||||
- `tools/smokes/v2/profiles/integration/apps/phase143_loop_true_if_continue_llvm_exe.sh`
|
||||
|
||||
### Acceptance criteria
|
||||
|
||||
- Phase 142-loopstmt の「statement-level normalization(consumed=1)」を維持し、suffix 形の増殖をさせない
|
||||
- out-of-scope は `Ok(None)` でフォールバック(既定挙動不変)
|
||||
- Unit tests が「許可形/不許可形」を contract として固定している(箱の責務が明確)
|
||||
|
||||
---
|
||||
|
||||
## Next
|
||||
|
||||
- P1: `if(cond) { break } else { continue }`(else branch を入れる)を vocabulary として追加
|
||||
- P2+: nested if / multi-if は capability guard で段階解禁(Phase 切りで SSOT 化)
|
||||
Reference in New Issue
Block a user