Brummel
9339279181
Terminal iteration of the kernel-extension-mechanics milestone. Ships
the four language-level mechanisms named in the spec's § Goal:
Module.kernel + TypeDef.param-in schema, their Form-A surface,
flag-driven kernel-tier auto-injection, and generic param-in checker
enforcement with a new diagnostic.
Schema (Tasks 1+2). Module gains a `kernel: bool` field
(skip_serializing_if = is_false), TypeDef gains a
`param_in: BTreeMap<String, BTreeSet<String>>` field
(skip-if-empty, kebab-renamed to "param-in"). Both fields are
strictly additive — every pre-existing fixture's canonical-JSON hash
is bit-stable except `prelude.ail`, which intentionally gains
`(kernel)`. The struct-literal sweep covered ~104 Module sites and
~35 TypeDef sites across the workspace; the additive serde-default
covers JSON deserialise paths, only Rust struct literals broke.
Form-A surface (Tasks 3+4). `(kernel)` is a bare module-header
attribute; `(param-in (a Int Float) (b Str))` is one outer
TypeDef-body clause carrying one or more inner var-lists (OQ1
decision — mirrors `(ctors …)`, one parser arm, deterministic
BTreeMap iteration). Both round-trip Form-A → JSON → Form-A
bit-identical.
Workspace-load migration (Task 5). The hardcoded `&["prelude"]`
literal at loader.rs:108 became a `modules.values().filter(|m|
m.kernel)` derivation; `parse_prelude()` injection stays because
the prelude has no on-disk manifest in user workspaces. Prelude
now carries `(kernel)` in its source, so the new filter picks it
up automatically. Code-path migration only — observable behaviour
is identical (prelude_free_fns.rs stays green). prelude hash
re-pinned (af372f28c726f29f) with Honesty-Rule provenance comment.
WorkspaceLoadError::ReservedModuleName diagnostic prose
repurposed: any built-in kernel module name is reserved
(currently prelude + kernel_stub), not specifically prelude. CLI
mapping at main.rs updated in lockstep.
Stub crate (Task 6). New `crates/ailang-kernel-stub/` is a
zero-dependency leaf crate carrying only `pub const STUB_AIL:
&str` with the Form-A source of the kernel_stub module (one
parametric TypeDef with param-in, one ctor). The parse hop —
`parse_kernel_stub()` — lives in ailang-surface next to
parse_prelude, keeping the crate-dependency graph acyclic
(`ailang-surface → ailang-kernel-stub → ailang-core`, no
back-edge). The stub is injected unconditionally in all builds as
the ratifying fixture for the kernel-extension mechanism; future
base extensions may add more or retire the stub. Drift-pinned by
`kernel_stub_module_round_trips`.
Checker (Task 7). New `CheckError::ParamNotInRestrictedSet`
variant + code() + ctx() arms + enforcement in
`check_type_well_formed`'s Type::Con arm — generic, data-driven
from the TypeDef, mentions no specific extension type. Two
in-source tests pin both the rejection (`Str` outside `{Int,
Float}`) and the acceptance (`Int` inside) paths.
Workspace-load integration tests (Task 8). New
`workspace_kernel.rs` integration-test crate with three tests:
auto-import without explicit `(import …)` declaration, two
kernel-tier modules co-load, explicit-import-overrides-auto-
import precedence preserved. Loader is import-tree-only so the
auto-import tests use a bridge module that brings the kernel
module into the workspace via the import graph — docstring
captures the reachability nuance for future readers.
Doc-state transitions (Task 9). INDEX.md kernel-extensions row
annotation transitions from "design accepted 2026-05-28; impl in
progress" to "mechanisms milestone closed 2026-05-28; raw-buf and
series milestones pending". Whitepaper STATUS + auto-import +
param-in sections transitioned forward→present for shipped
mechanisms; forward-tense survives only in sections describing
the still-pending raw-buf/series milestones (per Honesty-Rule).
data-model contract gains anchor blocks for both new schema
fields.
Side-effect: every binary's IR snapshot now contains ~52 lines
for `drop_kernel_stub_StubT` because the stub is auto-injected
into every workspace load. Snapshots refreshed; e2e expects 4
modules per workspace (prelude + kernel_stub + entry + zero or
more user modules) instead of the previous 3.
Plan defects scrubbed in the implementation (folded back into
the planner template via the planner's self-review checklist
next time): Task 4 sample test src used fictional
`(ctors (MkT a))` list form (project grammar is per-`(ctor MkT
a)`); Task 6 original wiring would have created a cycle
ailang-surface → ailang-kernel-stub → ailang-surface (inverted —
stub crate is zero-dep, parse hop lives in surface); Task 7 in-
source tests referenced a fictional `check_type_in_module`
helper (used the existing Workspace + check_workspace
convention); Task 8 first integration test expected loader to
auto-load kernel modules from disk (loader is import-tree-only;
tests use a bridge module).
Concern-5 fix folded in pre-commit: workspace.rs ReservedModuleName
doc-prose initially said "in test/dev builds" for kernel_stub —
but stub is unconditionally injected in all builds. Doc copy
tightened to present-state per Honesty-Rule.
Stats: 0 spec-review-loops, 0 quality-review-loops, 2 sweep-script
retries on Task 2 (brace-depth bug on nested vec![Ctor{…}],
recovered via per-file checkout + rewritten anchor-on-existing-
field sweep), 1 e2e-snapshot refresh on Task 6.
229 lines
5.9 KiB
LLVM
229 lines
5.9 KiB
LLVM
; AILang generated workspace; entry: hello
|
|
source_filename = "hello.ail"
|
|
target triple = "<NORMALIZED>"
|
|
|
|
@.str_hello_str_0 = private unnamed_addr constant <{ i64, [15 x i8] }> <{ i64 14, [15 x i8] c"Hello, AILang.\00" }>, align 8
|
|
|
|
declare i32 @printf(ptr, ...)
|
|
declare i32 @fputs(ptr, ptr)
|
|
@stdout = external global ptr
|
|
declare ptr @ailang_rc_alloc(i64)
|
|
declare void @ailang_rc_inc(ptr)
|
|
declare void @ailang_rc_dec(ptr)
|
|
declare ptr @ailang_drop_worklist_new()
|
|
declare void @ailang_drop_worklist_push(ptr, ptr)
|
|
declare ptr @ailang_drop_worklist_pop(ptr)
|
|
declare void @ailang_drop_worklist_free(ptr)
|
|
declare i32 @strcmp(ptr, ptr)
|
|
declare zeroext i1 @ail_str_eq(ptr, ptr)
|
|
declare i32 @ail_str_compare(ptr, ptr)
|
|
declare ptr @ailang_int_to_str(i64)
|
|
declare ptr @ailang_float_to_str(double)
|
|
declare ptr @ailang_bool_to_str(i1)
|
|
declare ptr @ailang_str_clone(ptr)
|
|
declare ptr @ailang_str_concat(ptr, ptr)
|
|
declare i64 @llvm.fptosi.sat.i64.f64(double)
|
|
|
|
@ail_hello_main_clos = private unnamed_addr constant { ptr, ptr } { ptr @ail_hello_main_adapter, ptr null }
|
|
@ail_prelude_float_eq_clos = private unnamed_addr constant { ptr, ptr } { ptr @ail_prelude_float_eq_adapter, ptr null }
|
|
@ail_prelude_float_ne_clos = private unnamed_addr constant { ptr, ptr } { ptr @ail_prelude_float_ne_adapter, ptr null }
|
|
@ail_prelude_float_lt_clos = private unnamed_addr constant { ptr, ptr } { ptr @ail_prelude_float_lt_adapter, ptr null }
|
|
@ail_prelude_float_le_clos = private unnamed_addr constant { ptr, ptr } { ptr @ail_prelude_float_le_adapter, ptr null }
|
|
@ail_prelude_float_gt_clos = private unnamed_addr constant { ptr, ptr } { ptr @ail_prelude_float_gt_adapter, ptr null }
|
|
@ail_prelude_float_ge_clos = private unnamed_addr constant { ptr, ptr } { ptr @ail_prelude_float_ge_adapter, ptr null }
|
|
define i8 @ail_hello_main() {
|
|
entry:
|
|
%v1 = getelementptr inbounds i8, ptr getelementptr inbounds (<{ i64, [15 x i8] }>, ptr @.str_hello_str_0, i32 0, i32 0), i64 8
|
|
%v2 = load ptr, ptr @stdout, align 8
|
|
call i32 @fputs(ptr %v1, ptr %v2)
|
|
ret i8 0
|
|
}
|
|
|
|
define i8 @ail_hello_main_adapter(ptr %_env) {
|
|
entry:
|
|
%r = call i8 @ail_hello_main()
|
|
ret i8 %r
|
|
}
|
|
|
|
define void @drop_kernel_stub_StubT(ptr %p) {
|
|
entry:
|
|
%is_null = icmp eq ptr %p, null
|
|
br i1 %is_null, label %ret, label %live
|
|
live:
|
|
%tag = load i64, ptr %p, align 8
|
|
switch i64 %tag, label %dflt [
|
|
i64 0, label %arm_0
|
|
]
|
|
arm_0:
|
|
%a0 = getelementptr inbounds i8, ptr %p, i64 8
|
|
%v1 = load ptr, ptr %a0, align 8
|
|
call void @ailang_rc_dec(ptr %v1)
|
|
br label %join
|
|
dflt:
|
|
unreachable
|
|
join:
|
|
call void @ailang_rc_dec(ptr %p)
|
|
br label %ret
|
|
ret:
|
|
ret void
|
|
}
|
|
|
|
define void @partial_drop_kernel_stub_StubT(ptr %p, i64 %mask) {
|
|
entry:
|
|
%is_null = icmp eq ptr %p, null
|
|
br i1 %is_null, label %ret, label %live
|
|
live:
|
|
%tag = load i64, ptr %p, align 8
|
|
switch i64 %tag, label %dflt [
|
|
i64 0, label %arm_0
|
|
]
|
|
arm_0:
|
|
%b0 = and i64 %mask, 1
|
|
%s1 = icmp ne i64 %b0, 0
|
|
br i1 %s1, label %after_0_0, label %do_0_0
|
|
do_0_0:
|
|
%a2 = getelementptr inbounds i8, ptr %p, i64 8
|
|
%v3 = load ptr, ptr %a2, align 8
|
|
call void @ailang_rc_dec(ptr %v3)
|
|
br label %after_0_0
|
|
after_0_0:
|
|
br label %join
|
|
dflt:
|
|
unreachable
|
|
join:
|
|
call void @ailang_rc_dec(ptr %p)
|
|
br label %ret
|
|
ret:
|
|
ret void
|
|
}
|
|
|
|
define i1 @ail_prelude_float_eq(double %arg_x, double %arg_y) alwaysinline {
|
|
entry:
|
|
%v1 = fcmp oeq double %arg_x, %arg_y
|
|
ret i1 %v1
|
|
}
|
|
|
|
define i1 @ail_prelude_float_eq_adapter(ptr %_env, double %a0, double %a1) {
|
|
entry:
|
|
%r = call i1 @ail_prelude_float_eq(double %a0, double %a1)
|
|
ret i1 %r
|
|
}
|
|
|
|
define i1 @ail_prelude_float_ne(double %arg_x, double %arg_y) alwaysinline {
|
|
entry:
|
|
%v1 = fcmp une double %arg_x, %arg_y
|
|
ret i1 %v1
|
|
}
|
|
|
|
define i1 @ail_prelude_float_ne_adapter(ptr %_env, double %a0, double %a1) {
|
|
entry:
|
|
%r = call i1 @ail_prelude_float_ne(double %a0, double %a1)
|
|
ret i1 %r
|
|
}
|
|
|
|
define i1 @ail_prelude_float_lt(double %arg_x, double %arg_y) alwaysinline {
|
|
entry:
|
|
%v1 = fcmp olt double %arg_x, %arg_y
|
|
ret i1 %v1
|
|
}
|
|
|
|
define i1 @ail_prelude_float_lt_adapter(ptr %_env, double %a0, double %a1) {
|
|
entry:
|
|
%r = call i1 @ail_prelude_float_lt(double %a0, double %a1)
|
|
ret i1 %r
|
|
}
|
|
|
|
define i1 @ail_prelude_float_le(double %arg_x, double %arg_y) alwaysinline {
|
|
entry:
|
|
%v1 = fcmp ole double %arg_x, %arg_y
|
|
ret i1 %v1
|
|
}
|
|
|
|
define i1 @ail_prelude_float_le_adapter(ptr %_env, double %a0, double %a1) {
|
|
entry:
|
|
%r = call i1 @ail_prelude_float_le(double %a0, double %a1)
|
|
ret i1 %r
|
|
}
|
|
|
|
define i1 @ail_prelude_float_gt(double %arg_x, double %arg_y) alwaysinline {
|
|
entry:
|
|
%v1 = fcmp ogt double %arg_x, %arg_y
|
|
ret i1 %v1
|
|
}
|
|
|
|
define i1 @ail_prelude_float_gt_adapter(ptr %_env, double %a0, double %a1) {
|
|
entry:
|
|
%r = call i1 @ail_prelude_float_gt(double %a0, double %a1)
|
|
ret i1 %r
|
|
}
|
|
|
|
define i1 @ail_prelude_float_ge(double %arg_x, double %arg_y) alwaysinline {
|
|
entry:
|
|
%v1 = fcmp oge double %arg_x, %arg_y
|
|
ret i1 %v1
|
|
}
|
|
|
|
define i1 @ail_prelude_float_ge_adapter(ptr %_env, double %a0, double %a1) {
|
|
entry:
|
|
%r = call i1 @ail_prelude_float_ge(double %a0, double %a1)
|
|
ret i1 %r
|
|
}
|
|
|
|
define void @drop_prelude_Ordering(ptr %p) {
|
|
entry:
|
|
%is_null = icmp eq ptr %p, null
|
|
br i1 %is_null, label %ret, label %live
|
|
live:
|
|
%tag = load i64, ptr %p, align 8
|
|
switch i64 %tag, label %dflt [
|
|
i64 0, label %arm_0
|
|
i64 1, label %arm_1
|
|
i64 2, label %arm_2
|
|
]
|
|
arm_0:
|
|
br label %join
|
|
arm_1:
|
|
br label %join
|
|
arm_2:
|
|
br label %join
|
|
dflt:
|
|
unreachable
|
|
join:
|
|
call void @ailang_rc_dec(ptr %p)
|
|
br label %ret
|
|
ret:
|
|
ret void
|
|
}
|
|
|
|
define void @partial_drop_prelude_Ordering(ptr %p, i64 %mask) {
|
|
entry:
|
|
%is_null = icmp eq ptr %p, null
|
|
br i1 %is_null, label %ret, label %live
|
|
live:
|
|
%tag = load i64, ptr %p, align 8
|
|
switch i64 %tag, label %dflt [
|
|
i64 0, label %arm_0
|
|
i64 1, label %arm_1
|
|
i64 2, label %arm_2
|
|
]
|
|
arm_0:
|
|
br label %join
|
|
arm_1:
|
|
br label %join
|
|
arm_2:
|
|
br label %join
|
|
dflt:
|
|
unreachable
|
|
join:
|
|
call void @ailang_rc_dec(ptr %p)
|
|
br label %ret
|
|
ret:
|
|
ret void
|
|
}
|
|
|
|
|
|
define i32 @main() {
|
|
call i8 @ail_hello_main()
|
|
ret i32 0
|
|
}
|