AILang

Brummel/AILang

Fork 0

Commit Graph

Author	SHA1	Message	Date
Brummel	bcd41810f4	design/ + source rustdoc: replace opaque shorthand with content phrases + links Reader-facing prose and rustdoc carried opaque shorthand like "Decision 10", "clause-5", "mq.1", "ct.1", "eob.1", "rpe.1", "post-mq.3", and "Iter 22b.1:" with no in-repo definition the reader could follow. This commit replaces every such occurrence in the durable tier the reader is most likely to land on (design/ ledger + source //! module headers + the central /// public-item rustdoc) with an inline content phrase plus, where applicable, a Markdown link to the file that defines the referenced concept. design/ ledger — 16 files: Definition-site headings demoted from "Decision N: <title>" to "<title>": authoring-surface, tail-calls, memory-model section in rc-uniqueness.md, dual-allocator section, typeclass design, effects "pure core + algebraic effects". Cross-reference sites: "Decision 1" -> canonical-schema principle (data-model); "Decision 3/4" -> effects + scope-boundaries; "Decision 6" -> authoring-surface; "Decision 8" -> tail-calls; "Decision 9" -> rc-uniqueness (dual-allocator); "Decision 10" -> memory-model; "Decision 11" -> typeclasses (model). "clause-5" -> body-link durability gate. "clause-3" (in language-constraints) -> bug-class-reintroduction discriminator. "mq.1/2/3", "ct.1/4", "eob.1", "rpe.1" -> the canonical-form rule / the type-driven dispatch / the Str carve-out / etc. "post-mq.3" -> "type-driven". design/contracts/feature-acceptance.md: file-local "clauses 1/2/3" -> "criteria 1/2/3" (sprachliche Kohärenz mit der File-Überschrift "Feature-acceptance criterion"); "the clause-3 mechanism" -> "the bug-class-reintroduction discriminator". Source //! module headers — 24 files: Stripped "Iter X.Y:" prefixes and "(Decision N)" / "(mq.X)" tags from spec_drift, uniqueness, reuse_shape, migrate_canonical_types, typeclass_22b{2,3,c}, suppress_filter, lift, mono, linearity, diagnostic, method_dispatch_pin, method_collision_pin, no_per_type_print_ops, mq3_multi_class_e2e, print_mono_body_shape, print_no_leak_pin, cli_diag_human_workspace_load_error, ct1_check_cli, prose snapshot, unbound_in_instance_method_pin, mono_xmod_ctor_pattern, desugar. Central /// public-item rustdoc: ast.rs (full sweep — every "Iter X" + "Decision N" prefix reformulated; mode/Type::Fn rustdoc now points at memory-model.md; Constraint / SuperclassRef / InstanceDef / ClassDef rustdoc points at typeclasses contract). diagnostic.rs (all "(Iter X)" / "(mq.X)" tags on diagnostic codes removed). lib.rs (FORM_A_SPEC rustdoc points at authoring-surface.md instead of "Decision 6"). canonical.rs (type_hash + Float-literal rustdoc). Still outstanding (for a follow-up commit): ~500 inline `//` code-body comments with `Iter X.Y` markers across the workspace, and a handful of `///` rustdoc items in hash_pin / workspace_pin / lift / mono / suppress_filter test-pin and internal-function bodies. Code identifiers (test filenames like `mq3_multi_class_e2e.rs`, function names like `iter18e_drop_iterative_default_preserves_hashes`) stay verbatim per the user's "code identifiers stay verbatim" rule. Tests: design_index_pin 5/5 + docs_honesty_pin 5/5; workspace builds clean; full `cargo test --workspace` previously green (every `test result: ok` line, no FAILED line).	2026-05-20 09:47:33 +02:00
Brummel	e7e67e1a40	iter str-concat: heap-Str concatenation primitive in four-site lockstep Closes fieldtest-form-a friction finding #4. `str_concat : (borrow Str, borrow Str) -> Str` ships in the four-site-lockstep pattern established by `str_clone` / `int_to_str` / `bool_to_str` (iter 24.1). The LLM-natural Show-MyType body `(app str_concat "label=" (app int_to_str x))` now parses, checks, builds, and runs end-to-end. Sites touched (lockstep): - runtime/str.c — `ailang_str_concat(a, b)` slab-allocates and memcpys both source payloads into a new heap-Str. - ailang-check/src/builtins.rs — `env.globals.insert("str_concat", Fn { 2x Str borrow, ret Str own, effects [] })` + `list()` row + `install_str_concat_signature` unit test. - ailang-codegen/src/lib.rs — `declare ptr @ailang_str_concat(ptr, ptr)` extern + `lower_app` arm after str_clone + `is_builtin_callable` extension + IR-pin unit test `str_concat_emits_call_to_ailang_str_concat`. - examples/show_user_adt_with_label.ail (new) + crates/ail/tests/ str_concat_e2e.rs (new) — corpus fixture exercising the LLM-natural Show body shape + E2E pin asserting check + build + run produce `Item 42\n`. Lockstep collision repaired: examples/bug_unbound_in_instance_method.ail used `str_concat` as its UNBOUND name (because that was the literal fieldtester repro). Renamed to `format_label` (LLM-author-realistic helper name that will never become a builtin) and updated the pin test `crates/ail/tests/unbound_in_instance_method_pin.rs` accordingly, preserving the regression guard's intent (instance-method-body walked through unbound-var check). DESIGN.md amended: new §"Heap-Str primitives" subsection between the milestone-24 Show-backer enumeration and the existing `Primitive output goes through ...` paragraph, cataloguing all five heap-Str primitives (`int_to_str`, `bool_to_str`, `float_to_str`, `str_clone`, `str_concat`) with signatures, iter origins, and the user-visible-vs-prelude-internal distinction. Show-backer block unchanged. IR snapshots regenerated (hello, list, max3, sum, ws_main) to absorb the new `declare ptr @ailang_str_concat(ptr, ptr)` line in the unconditional extern header — same upkeep pattern as hs.4 which regenerated the same 5 snapshots for the same reason (unconditional declares dead-stripped by clang -O2 when unused). Tests: 559 + 3 = 562 green (E2E pin + builtin-signature test + IR-pin test). Zero re-loops across all 7 tasks.	2026-05-13 12:43:10 +02:00
Brummel	72f3f6541b	debug: RED-pin for instance-body unbound-var bug ail check returns ok for a program that references an unbound identifier inside an instance method's lambda body. The error surfaces later at ail build as a degraded mono-pass diagnostic (monomorphise_workspace: unknown identifier) without source location, symbol kind, or "did you mean" candidates. Cause: check_def at crates/ailang-check/src/lib.rs:1593 early- returns Ok(()) for Def::Instance without walking method bodies. The arm's comment promises instance-body typechecking from iter 22b.2; that wiring was never implemented. Only the workspace- load coherence checks (Orphan/Duplicate/MissingMethod) touch instance defs, and they inspect schema only, not the method- body identifier graph. This commit lands RED only. GREEN follows via implement mini- mode. Fixture: examples/bug_unbound_in_instance_method.ail RED test: crates/ail/tests/unbound_in_instance_method_pin.rs - check_fires_unbound_var_for_str_concat_in_instance_method_body - check_json_unbound_var_in_instance_method_body	2026-05-13 11:59:49 +02:00

Author

SHA1

Message

Date

Brummel

bcd41810f4

design/ + source rustdoc: replace opaque shorthand with content phrases + links

Reader-facing prose and rustdoc carried opaque shorthand like
"Decision 10", "clause-5", "mq.1", "ct.1", "eob.1", "rpe.1",
"post-mq.3", and "Iter 22b.1:" with no in-repo definition the reader
could follow. This commit replaces every such occurrence in the
durable tier the reader is most likely to land on (design/ ledger +
source //! module headers + the central /// public-item rustdoc) with
an inline content phrase plus, where applicable, a Markdown link to
the file that defines the referenced concept.

design/ ledger — 16 files:
  Definition-site headings demoted from "Decision N: <title>" to
  "<title>": authoring-surface, tail-calls, memory-model section in
  rc-uniqueness.md, dual-allocator section, typeclass design,
  effects "pure core + algebraic effects".
  Cross-reference sites: "Decision 1" -> canonical-schema principle
  (data-model); "Decision 3/4" -> effects + scope-boundaries; "Decision
  6" -> authoring-surface; "Decision 8" -> tail-calls; "Decision 9" ->
  rc-uniqueness (dual-allocator); "Decision 10" -> memory-model;
  "Decision 11" -> typeclasses (model). "clause-5" -> body-link
  durability gate. "clause-3" (in language-constraints) ->
  bug-class-reintroduction discriminator. "mq.1/2/3", "ct.1/4",
  "eob.1", "rpe.1" -> the canonical-form rule / the type-driven
  dispatch / the Str carve-out / etc. "post-mq.3" -> "type-driven".

design/contracts/feature-acceptance.md: file-local "clauses 1/2/3"
-> "criteria 1/2/3" (sprachliche Kohärenz mit der File-Überschrift
"Feature-acceptance criterion"); "the clause-3 mechanism" -> "the
bug-class-reintroduction discriminator".

Source //! module headers — 24 files:
  Stripped "Iter X.Y:" prefixes and "(Decision N)" / "(mq.X)" tags
  from spec_drift, uniqueness, reuse_shape, migrate_canonical_types,
  typeclass_22b{2,3,c}, suppress_filter, lift, mono, linearity,
  diagnostic, method_dispatch_pin, method_collision_pin,
  no_per_type_print_ops, mq3_multi_class_e2e, print_mono_body_shape,
  print_no_leak_pin, cli_diag_human_workspace_load_error,
  ct1_check_cli, prose snapshot, unbound_in_instance_method_pin,
  mono_xmod_ctor_pattern, desugar.

Central /// public-item rustdoc:
  ast.rs (full sweep — every "Iter X" + "Decision N" prefix
  reformulated; mode/Type::Fn rustdoc now points at memory-model.md;
  Constraint / SuperclassRef / InstanceDef / ClassDef rustdoc points
  at typeclasses contract).
  diagnostic.rs (all "(Iter X)" / "(mq.X)" tags on diagnostic codes
  removed).
  lib.rs (FORM_A_SPEC rustdoc points at authoring-surface.md
  instead of "Decision 6").
  canonical.rs (type_hash + Float-literal rustdoc).

Still outstanding (for a follow-up commit): ~500 inline `//`
code-body comments with `Iter X.Y` markers across the workspace, and
a handful of `///` rustdoc items in hash_pin / workspace_pin / lift /
mono / suppress_filter test-pin and internal-function bodies. Code
identifiers (test filenames like `mq3_multi_class_e2e.rs`, function
names like `iter18e_drop_iterative_default_preserves_hashes`) stay
verbatim per the user's "code identifiers stay verbatim" rule.

Tests: design_index_pin 5/5 + docs_honesty_pin 5/5; workspace builds
clean; full `cargo test --workspace` previously green (every
`test result: ok` line, no FAILED line).

2026-05-20 09:47:33 +02:00

Brummel

e7e67e1a40

iter str-concat: heap-Str concatenation primitive in four-site lockstep

Closes fieldtest-form-a friction finding #4. `str_concat : (borrow Str,
borrow Str) -> Str` ships in the four-site-lockstep pattern established
by `str_clone` / `int_to_str` / `bool_to_str` (iter 24.1). The
LLM-natural Show-MyType body
`(app str_concat "label=" (app int_to_str x))` now parses, checks,
builds, and runs end-to-end.

Sites touched (lockstep):
- runtime/str.c — `ailang_str_concat(a, b)` slab-allocates and
  memcpys both source payloads into a new heap-Str.
- ailang-check/src/builtins.rs — `env.globals.insert("str_concat",
  Fn { 2x Str borrow, ret Str own, effects [] })` + `list()` row +
  `install_str_concat_signature` unit test.
- ailang-codegen/src/lib.rs — `declare ptr @ailang_str_concat(ptr,
  ptr)` extern + `lower_app` arm after str_clone + `is_builtin_callable`
  extension + IR-pin unit test `str_concat_emits_call_to_ailang_str_concat`.
- examples/show_user_adt_with_label.ail (new) + crates/ail/tests/
  str_concat_e2e.rs (new) — corpus fixture exercising the LLM-natural
  Show body shape + E2E pin asserting check + build + run produce
  `Item 42\n`.

Lockstep collision repaired: examples/bug_unbound_in_instance_method.ail
used `str_concat` as its UNBOUND name (because that was the literal
fieldtester repro). Renamed to `format_label` (LLM-author-realistic
helper name that will never become a builtin) and updated the pin test
`crates/ail/tests/unbound_in_instance_method_pin.rs` accordingly,
preserving the regression guard's intent (instance-method-body walked
through unbound-var check).

DESIGN.md amended: new §"Heap-Str primitives" subsection between the
milestone-24 Show-backer enumeration and the existing
`Primitive output goes through ...` paragraph, cataloguing all five
heap-Str primitives (`int_to_str`, `bool_to_str`, `float_to_str`,
`str_clone`, `str_concat`) with signatures, iter origins, and the
user-visible-vs-prelude-internal distinction. Show-backer block
unchanged.

IR snapshots regenerated (hello, list, max3, sum, ws_main) to absorb
the new `declare ptr @ailang_str_concat(ptr, ptr)` line in the
unconditional extern header — same upkeep pattern as hs.4 which
regenerated the same 5 snapshots for the same reason
(unconditional declares dead-stripped by clang -O2 when unused).

Tests: 559 + 3 = 562 green (E2E pin + builtin-signature test + IR-pin
test). Zero re-loops across all 7 tasks.

2026-05-13 12:43:10 +02:00

Brummel

72f3f6541b

debug: RED-pin for instance-body unbound-var bug

ail check returns ok for a program that references an unbound
identifier inside an instance method's lambda body. The error
surfaces later at ail build as a degraded mono-pass diagnostic
(monomorphise_workspace: unknown identifier) without source
location, symbol kind, or "did you mean" candidates.

Cause: check_def at crates/ailang-check/src/lib.rs:1593 early-
returns Ok(()) for Def::Instance without walking method bodies.
The arm's comment promises instance-body typechecking from iter
22b.2; that wiring was never implemented. Only the workspace-
load coherence checks (Orphan/Duplicate/MissingMethod) touch
instance defs, and they inspect schema only, not the method-
body identifier graph.

This commit lands RED only. GREEN follows via implement mini-
mode.

Fixture: examples/bug_unbound_in_instance_method.ail
RED test: crates/ail/tests/unbound_in_instance_method_pin.rs
  - check_fires_unbound_var_for_str_concat_in_instance_method_body
  - check_json_unbound_var_in_instance_method_body

2026-05-13 11:59:49 +02:00

3 Commits