AILang/docs/journals/2026-05-13-iter-form-a.1.md

# iter form-a.1 — Big-bang migration (Tasks 1-5: additive phase + relocation)

**Date:** 2026-05-13
**Started from:** 1a065b37 (post-iter 24.tidy)
**Status:** DONE (Tasks 1-5 only; Tasks 6-12 deferred to next dispatch)
**Tasks completed:** 5 of 12

## Summary

First half of the form-a-default-authoring milestone-close iter: T1
adds three new tests (parse-determinism + CLI-pipeline-idempotency +
carve-out-inventory-but-`#[ignore]`'d), T2 bulk-renders the 99
missing `examples/<stem>.ail` files via `ail render` (corpus 58 →
157), T3 + T4 migrate ~26 test files from `ailang_core::load_workspace`
to `ailang_surface::load_workspace` (Group A) and flip subprocess
fixture-suffix strings from `.ail.json` to `.ail` (Group B), T5
relocates `#[cfg(test)] mod tests` blocks from production source
(`ailang-core/src/hash.rs`, `ailang-core/src/workspace.rs`
non-carve-out subset, `ailang-codegen/src/lib.rs:3717-3799`) to
integration test crates that carry `ailang-surface` as a
dev-dependency, eliminating the production-source dependency on
`.ail.json` fixture reads. The remaining Tasks 6-12 (bench-driver
suffix flips, e2e diff-test rewrite, the actual 156-file
`.ail.json` deletion, retiring obsolete roundtrip tests +
schema_coverage corpus flip, DESIGN.md §Roundtrip Invariant
restatement, CLAUDE.md + DESIGN.md doctrine edits, WhatsNew +
roadmap close) run in the Boss's next dispatch on this iter ID.
`cargo test --workspace` is green at every per-task boundary (560
passed + 4 ignored at iter-half close; 558 + 3 new − 1 transit
`#[ignore]` on the inventory test). One Task-2 plan defect surfaced
inline and was repaired by pre-emptive forward-pull of Task-3
migrations.

## Per-task notes

- **iter form-a.1.1** — Added `parse_is_deterministic_over_every_ail_fixture`
  (round_trip.rs) and `cli_parse_then_render_then_parse_is_idempotent`
  (roundtrip_cli.rs); created `crates/ailang-core/tests/carve_out_inventory.rs`
  with the 8-file hardcoded list and `#[ignore]`'d until Task 8.
  The plan's `cli_parse_then_render_then_parse_is_idempotent` body
  used an `ail()` helper that doesn't exist in the repo (assert_cmd
  is not a dev-dep); adapted to use `Command::new(ail_bin())`
  matching the file's existing pattern. Plan acknowledged this
  possibility — "verify before writing the body; if `list_ail_fixtures`
  is missing in roundtrip_cli.rs, add a parallel helper at lines 47+."
- **iter form-a.1.2** — Rendered the 99 missing `.ail` files. The
  bulk render exposed a recon defect: `load_workspace` (since
  ext-cli.1) prefers `.ail` siblings for *imports* even when the
  entry is `.ail.json`. The seven Group-A test files whose entries
  were `.ail.json` but whose imports gained newly-rendered `.ail`
  siblings broke at Task 2's green-gate. Repair pulled forward five
  Task-3 migrations (mono_xmod_ctor_pattern, 3 sites in
  typeclass_22b2, 1 site in typeclass_22b3, env_construction_pin,
  4 sites in ailang-check/tests/workspace.rs, ctt2_registry_rekey)
  plus `#[ignore]`'d the 4 fixture-loading tests in
  `ailang-core/src/workspace.rs` `mod tests` with explicit
  `form-a.1 transit: Task 5 relocates...` markers. Also added
  `ailang-surface = { path = "../ailang-surface" }` to
  `crates/ailang-core/Cargo.toml` `[dev-dependencies]` (required
  for the ctt2_registry_rekey integration test to use
  `ailang_surface::load_workspace`).
- **iter form-a.1.3** — Finished Group A migration across the
  remaining 12 Group-A files (10 + the 2 already migrated in T2
  scope-pull). Two files (`mono_recursive_fn.rs`,
  `mono_xmod_qualified_ref.rs`) were Group-B-pattern (subprocess
  CLI, suffix-only flip) but listed in plan's Group A; treated
  per their actual shape.
- **iter form-a.1.4** — Group-B migration: bulk regex flip of
  `build_and_run("X.ail.json")` → `build_and_run("X.ail")` (3
  patterns) in e2e.rs across 59 invocations; plus targeted
  subprocess `examples/<fixture>.ail.json` → `.ail` flips at 11
  more e2e.rs sites (6× `ws_main`, 2× `sum`, 1× `escape_local_demo`,
  1× `list_map_poly`, 1× `std_either` left as-is per its raw-bytes
  roundtrip semantics). Four additional sites in e2e.rs preserved
  intentionally for raw-JSON inspection (`borrow_own_demo`,
  `reuse_as_demo`, the `sum.ail.json` diff-test pending Task 7
  rewrite, and the `ail_run_accepts_ail_source...` dual-form smoke).
  Four plan-Group-B files (`mono_hash_stability`, `prelude_free_fns`,
  `print_mono_body_shape`, `show_mono_synthesis`) were
  Group-A-pattern (consumers of `load_workspace`); migrated both
  imports AND paths.
- **iter form-a.1.5** — Relocated 10 fixture-loading tests from
  `ailang-core/src/workspace.rs` `mod tests` to new
  `crates/ailang-core/tests/workspace_pin.rs` (integration test
  crate); relocated all 8 tests from `ailang-core/src/hash.rs`
  `mod tests` plus 2 in-memory unit tests to
  `crates/ailang-core/tests/hash_pin.rs`; relocated 3 tests from
  `ailang-codegen/src/lib.rs:3717-3799` to
  `crates/ailang-codegen/tests/eq_primitives_pin.rs`; migrated
  `ailang-prose/tests/snapshot.rs` (helper + 8 fixtures) to `.ail`
  + `ailang_surface::load_module`. Carve-out tests stay in-place
  (3× `class_param_in_applied_position` / `superclass_with_wrong_param`
  / `constraint_with_unbound_var` for 22b2; 3× `ct1_fixture_*`
  for ct.1). Tempdir-based loader tests
  (`user_module_named_prelude_is_rejected`, `detects_import_cycle`,
  `module_not_found_yields_structured_error`) stay in-place too —
  they don't consume the examples corpus, so they don't need
  migration for the Form-A goal. Added `ailang-surface` as a
  `[dev-dependencies]` entry to `ailang-codegen/Cargo.toml` and
  `ailang-prose/Cargo.toml`. Hash.rs has `mod tests {}` placeholder
  kept; workspace.rs `mod tests` shrunk from 73 to 57 tests +
  6 carve-outs unchanged.

## Concerns

- **e2e.rs raw-JSON-inspect tests** (4 sites: `borrow_own_demo_modes_are_metadata_only`,
  `reuse_as_demo_under_rc_uses_inplace_rewrite`, `diff_detects_changed_def`,
  `render_parse_round_trip_canonical`, plus the dual-form smoke
  `ail_run_accepts_ail_source_with_same_stdout_as_ail_json`) currently
  read raw `.ail.json` bytes for substring asserts or byte-roundtrip
  comparison. They pass today (the `.ail.json` files still exist
  pre-T8) but will break at T8 when `.ail.json` siblings are deleted.
  Plan Task 7 only addresses the `diff_detects_changed_def` test (the
  one that mutates JSON). The other three are out of T1-5 scope and
  inherit to Boss for T6-12 dispatch resolution (either parse-derived
  JSON via `ail parse` per T7 pattern, or `#[ignore]` with explicit
  marker).
- **`ailang-core/src/workspace.rs` `mod tests`**: 3 tempdir-based
  loader-mechanism tests (lines :1743, :1759, :1776 pre-relocation;
  current line numbers shifted by the deletions) remain in-place
  per implementer-judgement (they don't consume `examples/`, so
  the Form-A goal is trivially satisfied). Plan suggested
  relocating them for doctrinal cleanup; scope reduction is
  deliberate. They continue to test what they always tested
  (loader cycle/missing-module/user-prelude-conflict behaviour)
  and pass.
- **Plan recon defect on Group-A vs. Group-B classification**:
  `mono_hash_stability.rs`, `prelude_free_fns.rs`,
  `print_mono_body_shape.rs`, `show_mono_synthesis.rs` were listed
  in plan's Group B but actually use `ailang_core::workspace::load_workspace`
  directly (Group-A pattern). Migrated correctly by switching both
  the import and the path. Recorded so a future recon-tightening
  pass on the planner skill can review whether path-grep-only
  recon is sufficient for Group A/B classification.
- **`mono_recursive_fn.rs` and `mono_xmod_qualified_ref.rs`** were
  symmetric — listed in plan's Group A but actually CLI subprocess
  callers (Group-B pattern). Suffix-only flip applied as if Group B.

## Known debt

- 4 raw-JSON-inspect tests in e2e.rs need T7-style rewrites or
  `#[ignore]` markers before Task 8's `.ail.json` deletion lands
  (see Concerns).
- 3 tempdir tests in `ailang-core/src/workspace.rs` `mod tests`
  could be relocated as doctrinal cleanup but functionally don't
  need to be (see Concerns).
- `mod tests {}` placeholder in `ailang-core/src/hash.rs` could
  be deleted entirely; left as a structural breadcrumb pointing at
  the integration test crate.

## Files touched

Working tree: 37 modified + 14 new test files + 99 new `.ail`
fixtures = 150 paths. Detail:

### Modified production / test source (37)

- `crates/ail/tests/`: codegen_import_map_fallback_pin.rs,
  ct1_check_cli.rs, e2e.rs (extensive build_and_run + 11
  subprocess sites), eq_float_noinstance.rs, eq_ord_e2e.rs,
  floats_e2e.rs, ir_snapshot.rs, mono_hash_stability.rs,
  mono_recursive_fn.rs, mono_unification.rs, mono_xmod_ctor_pattern.rs,
  mono_xmod_qualified_ref.rs, mq3_multi_class_e2e.rs,
  polyfn_dot_qualified_branch_pin.rs, prelude_free_fns.rs,
  print_mono_body_shape.rs, roundtrip_cli.rs, show_mono_synthesis.rs,
  show_no_instance_e2e.rs, show_print_e2e.rs, typeclass_22b2.rs,
  typeclass_22b3.rs, typeclass_22c.rs (23 files)
- `crates/ailang-check/tests/`: env_construction_pin.rs,
  method_collision_pin.rs, show_dispatch_pin.rs, workspace.rs (4)
- `crates/ailang-codegen/`: Cargo.toml + src/lib.rs (2)
- `crates/ailang-core/`: Cargo.toml + src/hash.rs + src/workspace.rs
  + tests/ctt2_registry_rekey.rs (4)
- `crates/ailang-prose/`: Cargo.toml + tests/snapshot.rs (2)
- `crates/ailang-surface/tests/round_trip.rs` (1)
- `Cargo.lock` (1)

### New (14 test files + 99 rendered .ail fixtures)

- `crates/ailang-codegen/tests/eq_primitives_pin.rs` (relocated T5)
- `crates/ailang-core/tests/hash_pin.rs` (relocated T5)
- `crates/ailang-core/tests/workspace_pin.rs` (relocated T5)
- `crates/ailang-core/tests/carve_out_inventory.rs` (new T1)
- 99× `examples/<stem>.ail` rendered via `ail render` (T2)

## Stats

bench/orchestrator-stats/2026-05-13-iter-form-a.1.json