AILang/docs/journals/INDEX.md

Journal index

Chronological pointer list of per-iter journal files. Append-only. One line per iter, newest at the bottom. Filenames are relative to docs/journals/.

• pre-2026-05-11 — see ../journal-archive.md for all prior history
• 2026-05-11 — iter or.1: orchestrator-refactor → 2026-05-11-iter-or.1.md
• 2026-05-11 — fieldtest canonical-type-names → 2026-05-11-fieldtest-canonical-type-names.md
• 2026-05-11 — iter pr.1: plan-recon subagent → 2026-05-11-iter-pr.1.md
• 2026-05-11 — iter or.2: orchestrator-agent design correction (no nested subagent dispatch) → 2026-05-11-iter-or.2.md
• 2026-05-11 — iter cadence: audit/fieldtest/docwriter cadence restructure → 2026-05-11-iter-cadence.md
• 2026-05-11 — iter 23.4-prep: checker prerequisites for prelude free fns → 2026-05-11-iter-23.4-prep.md
• 2026-05-11 — iter gc.1: grounding-check agent + brainstorm Step 7.5 → 2026-05-11-iter-gc.1.md
• 2026-05-11 — iter disc.1: boss-only commits + main-as-quarantine (no branches in implement) → 2026-05-11-iter-disc.1.md
• 2026-05-11 — iter 23.4: mono-pass unification (class methods + polymorphic free fns in one fixpoint; codegen-time specialiser removed) → 2026-05-11-iter-23.4.md
• 2026-05-12 — iter 23.5: prelude free fns (ne/lt/le/gt/ge) + E2E (positive / user-ADT / Float-NoInstance); milestone 23 closed → 2026-05-12-iter-23.5.md
• 2026-05-12 — audit-23: milestone 23 close (architect clean, compile_check ratified per H2 / 5-fn workload), DESIGN.md stub-fix tidy → 2026-05-12-audit-23.md
• 2026-05-12 — iter rt.1: roundtrip invariant audit tests (3 new tests + ailx-pair dynamic); all PASS first-shot, no gaps surfaced → 2026-05-12-iter-rt.1.md
• 2026-05-12 — iter rt.2: DESIGN.md anchor for Roundtrip Invariant (top-level section + Decision 6 Constraint 2 upward cross-reference) → 2026-05-12-iter-rt.2.md
• 2026-05-12 — audit-rt: milestone close (Roundtrip Invariant) — architect drift fixed in rt.tidy (3 items: Direction-2 5th test, roadmap P1 removed, wording sync); bench all-green → 2026-05-12-audit-rt.md
• 2026-05-12 — iter boss: /boss skill — autonomous-mode discipline (Direction freedom, Notifications, WhatsNew procedure) extracted from CLAUDE.md into a user-invoked skill → 2026-05-12-iter-boss.md
• 2026-05-12 — brainstorm Step 7.5: re-dispatch grounding-check on any post-PASS spec edit (skill SKILL.md edit + roadmap P1 todo removed) → see commit 90512d5 (no per-iter journal — small skill-discipline tweak)
• 2026-05-12 — iter cma.1: master mini-spec + render binary for cross-model authoring experiment (13 fixtures cover 34/34 AST variants, 4 test gates green, rendered/{json,ailx}.md checked in; out-of-workspace nested crate) → 2026-05-12-iter-cma.1.md
• 2026-05-12 — iter cma.2: harness binary + 4 tasks + reference solutions + 4 integration tests (six modules, real-pipeline preflight via verify_references, 13/13 tests green; pipeline.rs renames program file to module-name for ail check) → 2026-05-12-iter-cma.2.md
• 2026-05-12 — iter cma.3: live Qwen3-Coder-Next run + DESIGN.md §Decision-6 empirical addendum + roadmap close (AILX 2/4 green vs JSON 1/4; ~98k vs ~207k tokens; single-subject scope explicit, multi-subject expansion queued as P3) → 2026-05-12-iter-cma.3.md
• 2026-05-12 — audit-cma: milestone close (Cross-model authoring-form test) — architect drift fixed in 2 record-keeping items (INDEX backfill for brainstorm Step 7.5, README test-count correction); bench all-green (5 unexplained improvements on latency.explicit_at_rc not coupled to milestone, baseline left pristine) → 2026-05-12-audit-cma.md
• 2026-05-12 — iter ms.1: pipeline anyhow-chain preservation — {e} → {e:#} at pipeline.rs:118 restores serde_json parse-error leaf in JSON-cohort feedback; pinning unit test added (14/14 green) → 2026-05-12-iter-ms.1.md
• 2026-05-12 — iter ms.2: Qwen3-Coder-Next retroactive re-run + first CodeLlama-13b-Instruct run via IONOS; DESIGN.md §Decision-6 addendum extended from 2-col single-subject to 4-col two-subject; both subjects agree on direction (AILX cheaper + ≥ green); roadmap P3 multi-subject entry removed → 2026-05-12-iter-ms.2.md
• 2026-05-12 — audit-ms: milestone close (Multi-subject Authoring-Form Test — CodeLlama Replication) — architect clean, bench all-green (same 5-metric latency.explicit_at_rc improvement cluster as audit-cma earlier today, baseline left pristine for second consecutive audit) → 2026-05-12-audit-ms.md
• 2026-05-12 — iter ext-rename: .ailx → .ail extension rename across the live toolchain (61 example renames + 35 content edits + experiment-crate cohort rename ailx → ail); historical docs (journals, archive, specs, plans, frozen experiment runs) deliberately untouched; cargo+bench all-green; opens follow-up .ail-CLI-acceptance iter → 2026-05-12-iter-ext-rename.md
• 2026-05-12 — iter ext-cli.1: ail check/build/run/...all 12 path-taking subcommands now accept .ail (Form A) inputs via ailang_surface::{load_module, load_workspace} (extension-dispatching loaders + injection point core::load_workspace_with<F>); workspace imports prefer .ail sibling over .ail.json; new WorkspaceLoadError::SurfaceParse variant routes surface parse errors as surface-parse-error structured diagnostics through ail check --json; DESIGN.md §Decision 6 CLI addendum; +7 new tests; closes the loop opened by iter ext-rename → 2026-05-12-iter-ext-cli.1.md
• 2026-05-12 — iter hs.1: heap-Str ABI iter 1 — static-Str LLVM globals migrate from [N x i8] to packed-struct <{ i64, i64, [N x i8] }> carrying a UINT64_MAX sentinel rc-header + explicit len; IR-Str pointers now land on the len-field; @puts / @ail_str_eq / @ail_str_compare / @strcmp callsites GEP +8 to recover the bytes pointer (4 sites; plan listed 3, Task-5 e2e regression surfaced the 4th); 6 IR-shape pins; format strings stay raw [N x i8]; cross_lang.py + compile_check.py + full cargo test --workspace all green; byte-identical stdout across every example → 2026-05-12-iter-hs.1.md
• 2026-05-12 — spec amendment: heap-str-abi — sentinel-rc-header story dropped after hs.2 BLOCKED finding (codegen-level elision via move-tracking + non-escape lowering keeps static-Str pointers out of ailang_rc_dec along every shipping execution path; no runtime guard needed); re-dispatched grounding-check PASS → see commit 2a72a4a (no per-iter journal — spec edit)
• 2026-05-12 — iter hs.2: static-Str layout retrofit — drop the UINT64_MAX sentinel slot from packed-struct globals (<{ i64, i64, [N x i8] }> → <{ i64, [N x i8] }>); IR-Str pointer now lands on the len-field at struct-index 0 (was 1) via constexpr-GEP i32 0, i32 0; +8 consumer-side GEPs at the four C-API callsites invariant across the switch; renamed ..._sentinel_and_len test to ..._with_len; updated 5 sites in crates/ailang-codegen/src/lib.rs (3 format strings + 2 doc-comments); regenerated hello.ll snapshot; full cargo test --workspace, cross_lang.py, compile_check.py, check.py all green; static-Str globals are now 8 bytes smaller per literal → 2026-05-12-iter-hs.2.md
• 2026-05-12 — iter hs.3: heap-Str runtime additions — three new symbols appended to runtime/str.c (static str_alloc(uint64_t) slab helper, ailang_int_to_str(int64_t), ailang_float_to_str(double)); supporting <stdint.h>/<stdio.h>/<stdlib.h> includes + extern void *ailang_rc_alloc(size_t) declaration; the extern was promoted from plain-external to __attribute__((weak)) after the first regression sweep surfaced 11 e2e link failures under --alloc=gc/bump (public T symbols pull in their transitive callees regardless of upstream usage; rc.c is not linked under gc/bump in hs.3 — repair makes str.c link-safe in isolation, no-op once hs.4 lands the unconditional rc.c link); cargo test --workspace + cross_lang.py + compile_check.py + check.py all green on re-sweep; no IR-side caller wired yet (hs.4) → 2026-05-12-iter-hs.3.md
• 2026-05-12 — iter hs.4: IR + checker + linker wiring — int_to_str : (Int) -> Str installed in checker + synth.rs lockstep partner; IR-header preamble unconditionally declares both @ailang_int_to_str / @ailang_float_to_str; Emitter::lower_app gets new int_to_str arm and replaces float_to_str's CodegenError::Internal with the actual call emission; is_static_callee whitelist extends to int_to_str; runtime/rc.c hoisted out of AllocStrategy::Rc arm to the unconditional link path (the __attribute__((weak)) on str.c's ailang_rc_alloc extern becomes the documented no-op); 2 new IR-shape pins + 4 new E2E (2 stdout-smoke + 2 RC-stats) + 4 .ail.json fixtures; drop.rs Str-arm comment refreshed to dual-realisation framing; 5 IR snapshots regen for the 2 new declare lines. Status: DONE_WITH_CONCERNS — heap-Str RC-discipline incomplete (slabs leak at program end) because plan's literal ret_mode: Implicit interacts with uniqueness analyser walking Term::Do args as Position::Consume. Test asserts weakened from allocs == frees && live == 0 to allocs >= 1. Substantive fix requires spec-level effect-op arg-mode decision (deferred, bounce-back to user) → 2026-05-12-iter-hs.4.md
• 2026-05-12 — iter eob.1: Effect-op args walked as Borrow (uniqueness.rs + linearity.rs + linearity.rs doc-comment); heap-Str RC discipline closes (int_to_str / float_to_str ret_mode: Implicit → Own at 4 lockstep sites across builtins.rs + synth.rs; drop_symbol_for_binder App-arm gets Str carve-out symmetric to field_drop_call's existing one); 2 pre-existing RED tests at e2e.rs (commit 592d87b) flipped to GREEN unchanged with predicted concrete numbers (allocs==1,frees==1,live==0 and allocs==2,frees==2,live==0); 2 new positive tests + fixtures (primitive-Int through io/print_int: zero RC traffic; heap-Str repeated borrow through 2× io/print_str: allocs==1,frees==1,live==0); DESIGN.md §Decision 10 anchors both arg-position rules together (Ctor=Consume, Do=Borrow, plus a paragraph linking Do=Borrow to ret_mode==Own letbinder-trackability); WhatsNew entry shipped, roadmap P1 [milestone] Heap-Str ABI checked off, Post-22-Prelude depends on: line removed; 7/7 tasks first-shot, zero review re-loops; lint side-effect surface (over-strict-mode on (own T) params used solely via effect-ops) was empty for the current corpus → 2026-05-12-iter-eob.1.md
• 2026-05-12 — audit-eob: milestone close (heap-str-abi) — architect drift fixed inline as eob.tidy (3 DESIGN.md edits: float_to_str / int_to_str caveats dropped, "Str ABI" anchor added documenting both heap-Str and static-Str realisations with their shared consumer ABI and codegen-level non-RC invariant for static-Str); bench mixed (latency.explicit_at_rc improvement cluster reappears for the 3rd consecutive audit + new marginal bump_s regressions on list_sum/hof_pipeline 12% over 10% tol), baseline pristine for 3rd consecutive audit (conservative call: latency cluster has no identified cause across 3 audits — ratify-without-attribution would obscure future signal; bump_s cluster is first-sighting, observe next audit) → 2026-05-12-audit-eob.md
• 2026-05-12 — iter ctt.1: env-overlay shape ratification — new DESIGN.md top-level section ## Env construction anchors the env.types (owning) / env.ctor_index (reverse-index) split with the semantic rationale, plus the intentional check-side / mono-side asymmetry (mono-side narrowed at ct.3.2, check-side retains both halves because in-band DuplicateCtor consumes the per-module env.ctor_index rebuild); new behavioural-pin test crates/ailang-check/tests/duplicate_ctor_pin.rs ratifies the consumer; two P2 roadmap todos struck [x] (overlay shape question, per-module overlay narrowing); 3/3 tasks first-shot, zero review re-loops, no production-code edits → 2026-05-12-iter-ctt.1.md
• 2026-05-12 — iter ctt.2: Registry.type_def_module re-key from BTreeMap<String, String> to BTreeMap<(String, String), String> keyed by (owning_module, bare_name); new caller_module: &str parameter threads through normalize_type_for_registry + Registry::normalize_type_for_lookup; four ailang-check consumer sites (lib.rs:1640, mono.rs:121/624/1175) pass the correct module-context (env.current_module / defining_module / module_name) per the plan's Design Notes; new regression test plus three-module fixture (ctt2_collision_{cls,lib,main}.ail.json) exercises the cross-module bare-name collision shape that pre-ctt.2 silently overwrote; RED-failure observed as OrphanInstance rather than the plan's predicted DuplicateInstance because the pass-2 coherence check (workspace.rs:656-659) is also a bare-name consumer and fires earlier; both consumers fixed by the same re-key; plan's verbatim two-module fixture had two structural defects (two-way imports → Cycle, qualified InstanceDef.class → QualifiedClassName) that the implementer-phase repair handled by introducing the third cls-module; spec-intent (RED-first against bare-name collision) preserved; cargo test --workspace green (16 binary-test suites, ~600 tests, zero failures) → 2026-05-12-iter-ctt.2.md
• 2026-05-12 — iter ctt.3: KindMismatch retire — pure deletion across 3 files (workspace.rs: variant + dispatch + helper + "dead-but-defensive" doc; main.rs: Display arm; lib.rs: 22b.1 archaeology comment). Existing test class_param_in_applied_position_fires_canonical_form_rejection stays green unchanged (asserts BareCrossModuleTypeRef on the malformed fixture — the canonical-form-validator successor path). Two adjacent textual-consistency edits ride along (validate_classdefs doc-comment "Three → Two", lib.rs archaeology comment gains a ctt.3 retirement marker). One mid-deletion mechanical fix: dispatch-loop deletion orphaned mod_name binding → rewrote for (mod_name, m) in modules to for m in modules.values() (same body type, mechanical). 2/2 tasks, ~600 tests green across 16 binary-test suites → 2026-05-12-iter-ctt.3.md
• 2026-05-12 — audit-ct-tidy: milestone close (ct-tidy) — architect drift fixed inline as ctt.tidy (3 doc-side edits: DESIGN.md §"Class-schema diagnostics" drops the retired KindMismatch bullet + adds successor paragraph naming BareCrossModuleTypeRef; DESIGN.md §"Higher-kinded class params" rewritten to name BareCrossModuleTypeRef from canonical-form validation instead; roadmap.md two P2 todos struck [x] with forward-reference to ctt.3 and ctt.2). Bench mixed (check.py exit 1: bump_s persistence on bench_list_sum second consecutive sighting at +12.23% → +12.60%; two new first-sighting rc-cohort max_us latency regressions classified as noise pending next audit; the recurring 3-audit latency.explicit_at_rc improvement cluster narrowed to within tolerance this audit, withdrawing the ratify-pending plan from audit-eob — the meaningful shrinkage is itself attribution evidence that the cluster is noise-class not signal-class), baseline pristine for the 4th consecutive audit → 2026-05-12-audit-ct-tidy.md
• 2026-05-12 — iter 24.1: bool_to_str + str_clone runtime + codegen wiring — 2 new C functions in runtime/str.c (slab-allocating heap-Str primitives via existing str_alloc), lockstep checker + synth.rs installs with ret_mode: Own, 2 IR-header declares + 2 lower_app arms + is_static_callee whitelist extension, 5 IR snapshots regen (2 declares × 5 files), 9 new tests (2 builtins-install unit + 2 IR-shape pin + 5 E2E all green), pre-existing-drift fix included (int_to_str row added to builtins.rs::list()). One substantive deviation: builtin-signatures registered in uniqueness.rs::infer_module + linearity.rs::check_module_with_visible (8 LOC × 2 files) so str_clone's param_modes: [Borrow] is visible to the App-arg walker; symmetric to 23.4-prep's class-method registration; necessary for the plan's literal frees == 3 cross-realisation assertion. Full cargo test --workspace 513 passed, 0 failed. bench/compile_check.py + bench/cross_lang.py green → 2026-05-12-iter-24.1.md
• 2026-05-13 — iter mq.1: class-ref canonical-form extension + workspace-internal class-name qualification — three schema fields (InstanceDef.class, Constraint.class, SuperclassRef.class) move bare → canonical (bare for same-module, <module>.<Class> for cross-module) symmetric to ct.1's Type::Con.name rule; ClassDef.name stays bare (defining site, like TypeDef.name). validate_canonical_type_names gains three field-walks via new check_class_ref helper plus two sibling diagnostics BareCrossModuleClassRef / BadCrossModuleClassRef; check_class_name_fields narrowed to ClassDef.name-only. Workspace-internal class-name keys all qualified: class_def_module, class_by_name, registry entries.0, ClassMethodEntry.class_name, class_superclasses, mono's class_index, Origin::Class.class_name. New qualify_class_ref helper in workspace.rs plus sibling qualify_class_ref_in_check in ailang-check. Two new positive on-disk fixtures (mq1_xmod_constraint_class{,_dep}). Recon claim that all existing fixtures' class-refs are intra-module was empirically wrong — 5 test_22b* (orphan_third, dup_a/b/entry, unbound_constraint_var) + 5 other (eq_ord_polymorphic, eq_ord_user_adt, cmp_max_smoke, ctt2_collision_{lib,main}) fixtures required minimal canonical-form migration. Duplicate-instance test architecturally restructured: post-mq.1 orphan-freedom makes two-modules-on-same-(class, type) structurally impossible (any second instance in a non-owning module fires OrphanInstance first); new test_22b1_dup_same_module.ail.json lands both instances in the class's module — the only post-mq.1 way to land two on the same canonical key. Plan defects fixed inline: Origin::Class.class_name had one construction site not two (plan recon off-by-one); build_class_index in mono.rs needed qualifying (plan said "no code change needed"); build_module_globals needed a Def::Instance carve-out for qualified inst.class; check_fn's declared-constraint matching needed inline canonical-form lifting; NoInstance Float-aware message arm needed prelude.Eq/prelude.Ord match; coherence type-leg needed qualified-head split-and-lookup. Tasks 3-6 ran as one coherent fix (Task 3 alone left tests RED). 7/7 tasks, 520 tests green, bench/compile_check.py + bench/cross_lang.py exit 0; bench/check.py exit 1 due to 4 improvements-beyond-tolerance (audit-ratifiable per convention, not a regression). MethodNameCollision + dispatch path unchanged; iters mq.2 + mq.3 land them → 2026-05-13-iter-mq.1.md
• 2026-05-13 — iter mq.2: type-driven dispatch mechanism installed (mechanism-before-exercise) — Env.method_to_candidate_classes workspace-flat inverse index built alongside class_methods; two new CheckError variants AmbiguousMethodResolution + UnknownClass (Display+code+ctx) plus additive NoInstance.candidate_classes field; ResidualConstraint extended with candidates: Option<BTreeSet<String>> (visibility bumped pub(crate) → pub for test-crate access); pure resolve_method_dispatch helper implementing the spec's 5-step rule (qualifier → singleton → type-driven filter → constraint-driven filter → Multi for discharge-time refinement); synth Var-arm class-method branch rewritten via parse_method_qualifier with inner-dot gate (qualifier must be <module>.<Class> form, single-dot names like std_list.length fall through to the existing qualified-fn path); refine_multi_candidate_residual wired into check_fn discharge using expanded (post-superclass-expansion constraints) for the rigid-var path; resolve_residual_class_for_mono wired into mono's collect_residuals_ordered residual-to-target mapping. With MethodNameCollision still gating real workspaces, the new multi-candidate branches are exercised exclusively by 15 unit tests: 6 in tests/method_dispatch_pin.rs covering the 5-step rule's six cases, 6 in lib.rs mod tests covering variants + field shapes + discharge refinement, 3 in mono.rs mod tests covering the mono helper. Real workspaces continue producing single-class residuals (candidates: None); every pre-mq.2 fixture typechecks unchanged. Plan-invented format_type_for_display replaced with ailang_core::pretty::type_to_string (one less duplicate). Synth-time declared_constraints: &[] is a deliberate gap documented as known debt — load-bearing only post-mq.3 for the rigid-var fallback (env-plumbing the active fn's constraints into the Var arm is a ~10-line edit slated for mq.3). 9/9 tasks, 539 tests green (was 520 at start of mq.2; +19 = 15 new + 4 pre-existing); bench/compile_check.py + cross_lang.py clean; bench/check.py 1 regression (latency noise, runtime cannot be touched by typecheck-side iter). MethodNameCollision retirement lands in mq.3 → 2026-05-13-iter-mq.2.md