Series a is a bounded ring buffer with financial-style indexing
(index 0 = newest), shipped as a PURE AILang library extension over
RawBuf — zero Rust codegen, zero intercepts, zero (intrinsic)
markers. It is the first kernel-tier module that depends on another
kernel-tier module (raw_buf). This turns the committed SMA headline
pin (6b7ee45) green and closes the step-1 scope of #61.
The module lives at crates/ailang-kernel/src/series/{source.ail,
mod.rs} and is auto-injected by the loader exactly like raw_buf
(parse_series + injection in ailang-surface/src/loader.rs, re-export
in lib.rs). Five real-bodied ops: new / push / at / len /
total_count, all built on RawBuf.{new,set,get}.
The source is the model-0007 sketch with every defect corrected and
each correction verified against the live tool:
- param-in narrowed to (a Int Float); Bool deferred per #61.
- inner alloc is `(new RawBuf lookback)` with no element type-arg —
the element is solved from the `(con RawBuf a)` ctor-field context,
which the base-tier mono fix (b11a6d9) carries through to the
caller's concrete type. This is the capability that lets Series be
pure AILang.
- element-typed params/rets are bare `a`, not `(con a)` (a type
variable, not a nullary ctor).
- op signatures bind `a` via `(forall (vars a) ...)`.
- comparison uses the named helper `lt`, not the non-existent `<`.
- the at-index formula is `(head - 1 - i + 2*lookback) mod lookback`
(0007 had the sign on i wrong, walking the wrong direction).
Cross-kernel-module visibility — the flagged risk — needed ZERO
mechanism change: the loader derives its implicit-import set from
every kernel module, so series's body resolves `RawBuf.*` and
`(con RawBuf a)` via the existing kernel auto-visibility.
Both CLAUDE.md lockstep pairs stay intact:
- INTERCEPTS <-> (intrinsic) markers: unchanged. Series is
pure-AILang, adds neither; intercepts_bijection_with_intrinsic_
markers still green.
- Term::New typecheck/reject <-> pre_desugar_validation.rs:
untouched; the new/Series construction exercises existing paths.
Test-surface ripple, all verified:
- workspace module-count pins 4 -> 5 (e2e.rs, workspace_pin.rs),
with a `series` membership assertion added — the kernel set grew
by one deliberate module.
- two mono-identity tests (typeclass_22b3.rs) now skip `prelude`
and `series`: series is the first auto-imported real-bodied
consumer of the prelude polyfns `lt`/`compare` over Int, so mono
legitimately materialises `lt__Int`/`compare__Int` into prelude
for every workspace. That is a concrete call site, not gratuitous
mutation; the tests' real invariant (mono leaves work-free modules
untouched) still holds for every other module.
- five IR snapshots refreshed; the deltas are strictly additive
(zero IR deletions) — the same series-driven Int specialisations.
Verified: full `cargo test --workspace` green; SMA binary built via
`ail build --alloc=rc` prints `3.0 / 5.33333 / 5.66667 / 5.33333`.
refs #61
Brummel
35a9bc67b1