hakorune/docs/development/current/main/phase47-test-files-inventory.md

Phase 47 Test Files Inventory

Date: 2025-12-12

P3 (If-Sum) Test Files Available

1. phase212_if_sum_min.hako ⭐ PRIMARY TARGET

Path: /home/tomoaki/git/hakorune-selfhost/apps/tests/phase212_if_sum_min.hako

Pattern: Simple if-sum with single carrier

local sum = 0
local i = 0
local len = 3

loop(i < len) {
    if (i > 0) {
        sum = sum + 1  // Conditional update
    } else {
        sum = sum + 0  // Else branch (no-op)
    }
    i = i + 1
}

Characteristics:

• ✅ Single carrier: sum
• ✅ Simple condition: i > 0
• ✅ One loop param: i
• ✅ Explicit else branch
• ✅ Clean structure (no method calls, no body-local)

Expected output: sum = 2

Use case: Phase 47-A Minimal (first Normalized P3 implementation)

---

2. phase217_if_sum_multi_min.hako

Path: /home/tomoaki/git/hakorune-selfhost/apps/tests/phase217_if_sum_multi_min.hako

Pattern: Multi-carrier if-sum (2 accumulators)

local sum = 0
local count = 0
local i = 0
local len = 3

loop(i < len) {
    if (i > 0) {
        sum = sum + 1    // Conditional update 1
        count = count + 1  // Conditional update 2
        print(sum)
        print(count)
    } else {
        print(0)
    }
    i = i + 1
}

Characteristics:

• ✅ Two carriers: sum, count
• ✅ Side effects: print() calls
• ✅ Multiple updates in then branch
• ⚠️ Slightly more complex than phase212

Expected output: sum = 2, count = 2

Use case: Phase 47-A Extended (multi-carrier test)

---

3. phase218_json_if_sum_min.hako

Path: /home/tomoaki/git/hakorune-selfhost/apps/tests/phase218_json_if_sum_min.hako

Pattern: JsonParser-style accumulation

local sum = 0
local i = 0
local len = 5

loop(i < len) {
    if (i > 0) {
        sum = sum + i  // Variable accumulation (not constant)
        print(sum)
    } else {
        print(0)
    }
    i = i + 1
}

Characteristics:

• ✅ Single carrier: sum
• ✅ Variable accumulation: sum + i (not sum + 1)
• ✅ Simulates JsonParser digit accumulation pattern
• ⚠️ More complex arithmetic

Expected output: sum = 10 (1+2+3+4)

Use case: Phase 47-A Extended (variable accumulation test)

---

Phase 47-A Implementation Priority

First Target: phase212_if_sum_min.hako

Why:

1. ✅ Simplest structure - single carrier, simple condition
2. ✅ Clean pattern - no side effects (no print), no method calls
3. ✅ Direct P2 analogy - just adds if branching to P2 structure
4. ✅ Best for proving concept - minimal complexity

Normalized components needed:

• EnvLayout: { i: int, sum: int } (same as P2)
• StepSchedule: [HeaderCond, IfCond, ThenUpdates, Updates, Tail]
• JpInst: Reuse existing If instruction

Second Target: phase217_if_sum_multi_min.hako

Why:

1. ✅ Multi-carrier test - proves P3 handles multiple accumulators
2. ⚠️ Side effects (print) - tests that side effects work in then/else branches
3. ✅ Still simple condition - i > 0 (same as phase212)

Additional Normalized components:

• EnvLayout: { i: int, sum: int, count: int } (multi-carrier)
• Side effect handling in then/else branches

Third Target: phase218_json_if_sum_min.hako

Why:

1. ✅ Variable accumulation - sum + i (not constant)
2. ✅ JsonParser pattern - prepares for real JsonParser loops
3. ⚠️ More complex arithmetic expression

Additional Normalized components:

• Expression lowering for sum + i (already supported by ExprLowerer)

---

Phase 47-B Target (Future)

Candidate: JsonParser array_filter pattern (if exists in codebase)

local out = new ArrayBox()
local i = 0

loop(i < arr.length()) {
    local v = arr.get(i)
    if (predicate(v)) {
        out.push(v)
    }
    i = i + 1
}

Complexity:

• ⚠️ Method calls: arr.length(), arr.get(i), out.push(v)
• ⚠️ Body-local: v (used in if condition)
• ⚠️ External predicate call

Status: Not yet verified if this exact pattern exists in codebase

---

Summary

Available P3 test files: 3

1. ✅ phase212_if_sum_min.hako (PRIMARY)
2. ✅ phase217_if_sum_multi_min.hako (SECONDARY)
3. ✅ phase218_json_if_sum_min.hako (TERTIARY)

Phase 47-A roadmap:

1. Start with phase212 (single carrier, simple)
2. Extend to phase217 (multi-carrier)
3. Extend to phase218 (variable accumulation)
4. All dev-only (Normalized→MIR direct comparison tests)

Phase 47-B roadmap (future):

• Real JsonParser loops with method calls + body-local
• Requires body-local handling in EnvLayout (already exists for P2 DigitPos)

Phase 47-C roadmap (future):

• Canonical promotion of P3 minimal (like P2)
• Performance validation

---

References

• Phase 47 Design: phase47-norm-p3-design.md
• P2 Completion: PHASE_43_245B_NORMALIZED_COMPLETION.md
• Architecture: joinir-architecture-overview.md