AILang/docs/journals/2026-05-18-iter-emit-ir-staticlib.md

iter emit-ir-staticlib — ail emit-ir --emit=staticlib (M1 fieldtest spec_gap#2)

Date: 2026-05-18 Started from: 03493c9b31 Status: DONE Tasks completed: 4 of 4

Summary

Resolves M1 fieldtest [spec_gap]#2 ("no public path emits the staticlib IR though Decision 5 makes IR readability a first-class LLM affordance") by adding --emit=staticlib to ail emit-ir, symmetric with the M1-shipped ail build --emit=staticlib. A one-line codegen convenience lower_workspace_staticlib(ws) (mirroring lower_workspace) routes through the M1-audited, unchanged Target::StaticLib forwarder-emission path; the CLI arm gains an emit: String clap field (symmetric with Cmd::Build's) and a zero-export guard byte-identical to build_staticlib's. DESIGN.md is widened (never narrowed) with a present-tense affordance sentence in §"Embedding ABI (M1)" and a synopsis correction that also fixes a pre-existing M1 omission for ail build --emit=staticlib. No new doc pin (architecture decision): the new E2E file pins the behaviour; the existing docs_honesty_pin (5 tests) confirmed non-regressed.

Per-task notes

• iter emit-ir-staticlib.1: codegen — added pub fn lower_workspace_staticlib in ailang-codegen/src/lib.rs between lower_workspace and lower_workspace_inner; delegates to lower_workspace_inner(ws, Gc, Target::StaticLib). cargo build -p ailang-codegen clean.
• iter emit-ir-staticlib.2: CLI — RED-first E2E file crates/ail/tests/emit_ir_staticlib_cli.rs (3 tests), observed RED "1 passed; 2 failed" exactly as predicted; added emit clap field to Cmd::EmitIr, destructured it in the arm, branched the lowering call with the byte-identical zero-export guard (Steps 3+4 honoured as a single compile unit — no cargo between the E0027 window). GREEN: 3 passed; embed_staticlib_cli 2 passed (build-side symmetry, no regression).
• iter emit-ir-staticlib.3: DESIGN.md — added the present-tense --emit=staticlib affordance sentence after the M1 export snippet; synopsis: both emit-ir and build lines gained [--emit=staticlib] (the build correction discharges a pre-existing M1 current-state-honesty gap). docs_honesty_pin 5/5 green — no new pin, no regression.
• iter emit-ir-staticlib.4: regression gate — ail suite 186 passed / 0 failed; workspace TOTAL_PASSED=626 = pre-iter 623
  • 3 (exactly the new tests, no pre-existing test lost); scope check clean (only the 4 in-scope paths).

Concerns

(none)

Known debt

(none — scoped feature fully closed; no fixture minted, no doc pin added, all by explicit plan decision.)

Blocked detail

(none)

Files touched

• crates/ailang-codegen/src/lib.rs — lower_workspace_staticlib convenience
• crates/ail/src/main.rs — Cmd::EmitIr emit clap field + arm branch + zero-export guard
• crates/ail/tests/emit_ir_staticlib_cli.rs — new, 3 E2E tests (positive forwarder-IR / zero-export guard / default-exe regression)
• docs/DESIGN.md — §"Embedding ABI (M1)" affordance sentence + CLI synopsis (both lines)

Stats

bench/orchestrator-stats/2026-05-18-iter-emit-ir-staticlib.json