DEV Community

Cover image for Introducing the "Aether" programming language.
Rob Bulkley
Rob Bulkley

Posted on

Introducing the "Aether" programming language.

Aether / XLang — Full Project Progress Report

Document: Full Project Progress Report
Status: Honest institutional record (Level 4 product docs)
Authority: AGENTS Constitution (pack) + project AGENTS.md
Date: 2026-08-04
Branch: codex/xlang-local-first-studio
HEAD: 1ab0be1891bf53f1c7fafb0bc6eca2246f344776
Package: aether-core / aether-cli 0.12.0
Language surface: 0.11 / AETH v11
Related Rule IDs: CONST-GATE-001, CONST-DONE-001, CONST-COMPLETE-001,
  CONST-DEP-001, DOC-SYNC-001, ENG-WARN-001, TEST-BEHAVIOR-001,
  SEC-INPUT-001, REV-PACK-001, REL-PACKAGE-001, SOP-PHASE-001, SOP-GATE-001
Enter fullscreen mode Exit fullscreen mode

1. Executive summary

Aether is a local-first programming language and CLI toolchain hosted inthis repository (historically labeled XLang). It parses only Aether source,emits verified AETH bytecode, and runs that bytecode in the Aether VM. Itdoes not transpile to Rust, C, JavaScript, LLVM, or any other language.

As of this report, the project has:

  1. Completed the language pilot program M0–M9 within documented bounds(surface 0.11, package 0.12 tooling).
  2. Completed the product completion arc TP-1 (integrity) + TP-2 (local technical preview) under AGENTS Constitution and SOP phases 8–10.
  3. Designed but not implemented M10 multi-unit offline projects (ADR-013).

This is not a 1.0 general systems language. Claims below are bounded,evidence-linked, and deliberately non-marketing.

Layer Truth
Seed-hosted compile + verify + run Product-usable
AI structural authoring (top-level, v6) Product-usable
Offline project integrity (single-unit pilot) Product-usable
Local technical preview package Delivered (dist/, gitignored; rebuildable)
Multi-unit projects Designed only
Language modules / C-FFI / registry / full LSP Not started (blocked or deferred)
Native / LLVM backend Prohibited without law change

2. Governing law (AGENTS Constitution)

2.1 Authority stack

Level Artifact Role
1–3 AGENTS Constitution pack (e.g. 5.0.1) Universal quality + process law
2 SOP.md Research → design → implement → audit → harden → deliver
1 constitution/03-DEFINITION-OF-DONE.md Machine-checkable Done
4 Repository AGENTS.md Aether mission, invariants, stack pins
4 MANIFEST.md Executable product contract

The project entry pointer loads pack AGENTS.md, SOP.md, Definition of Done,and engineering/testing/documentation standards before specialist modules.

2.2 Non-negotiable project invariants (Level 4)

  1. Seed-hosted product compile — default CLI uses Aether-written seed;Rust bootstrap is rebuild/diagnostic authority only.
  2. Verify before run / write — supported AETH v4–v11 only.
  3. No host capability leak — guest AETH has no file/process/network/shellauthority; pure host fixtures only for M8 pilot.
  4. Honest self-host claims — dual-compare where proven; no fulldiagnostic parity claim for the seed.
  5. CLI authority boundary — local files, explicit outputs, no model/network.
  6. legacy/ is reference only — never a production build input.
  7. Zero-warning gateunsafe_code = "forbid"; Clippy all = "deny".

2.3 Rule IDs this report answers to

Rule ID Meaning Project application
CONST-GATE-001 Pre-delivery checklist tools/aether-gate.ps1
CONST-DONE-001 Definition of Done Per milestone delivery reports
CONST-COMPLETE-001 No partial delivery Vertical slices closed with docs
CONST-DEP-001 Dependency-first M1 before M2…; design before M10 code
ENG-WARN-001 Zero warnings Workspace lints
TEST-BEHAVIOR-001 Behavior + negatives Matrices + dual-compare
DOC-SYNC-001 Docs match code MANIFEST / claims / ADRs
SEC-INPUT-001 Untrusted input Project paths, host, AETH verify
REV-PACK-001 Human review packaging Delivery reports
REL-PACKAGE-001 Release artifacts Local TP package
SOP-PHASE-001 Phases 1–10 order See §4
SOP-GATE-001 Gate table per increment See §10

3. Product pin (current baseline)

Layer Value
Product name Aether
Workspace Rust 2021, rust-version = "1.88" (built on host with rustc 1.96.0 for TP)
Core crate aether-core @ crates/xlang-core 0.12.0
CLI aether @ apps/xlang-cli 0.12.0
Language surface 0.11
Default AETH emit v11 (accepts verified v4–v10 as compatibility inputs)
Product compile Seed-hosted (compile_with_seed / embedded seed artifact)
Bootstrap compile --bootstrap, check, seed rebuild
Seed sources seed/aether_seed.ae + checked-in seed/aether_seed.aeth
Seed SHA-256 (checked-in) 6AC3C46B890029B646267E93C9FDA5CDD34F9E061D7BC0419D34E0DF6734B254
Authoring contracts aether.ast/v6, aether.edit/v6, aether.diagnostic/v6
Project schema aether.project/v1 (M9 pilot)
Branch / HEAD codex/xlang-local-first-studio @ 1ab0be1

Contract document: MANIFEST.mdArchitecture: ARCHITECTURE.mdClaims register: CORE_CLAIMS.mdNorth star (direction, not current behavior): NORTH_STAR.md


4. SOP scorecard (process law)

Binding process: pack SOP.md phases 1–10 (SOP-PHASE-001).

SOP # Phase Status for Aether program Evidence
1 Research reference projects Done docs/research/, landscape notes
2 Decompose components Done Research component matrix / synthesis
3 Deep study Done Patterns, stop conditions
4 Design system Done (pilots) NORTH_STAR, designs M1–M10
5 Foundational docs Done (pilots) ADRs 001–013, matrices, AETHER_0.x
6 Plan engineering Done for pilots + completion ROADMAP, completion plan
7 Implement Done M0–M9 pilots Feature commits + delivery reports
8 Audit + fixes Done for TP-1 Completion readiness audit
9 Harden Done for TP-2 freeze Threat model + residual risks
10 Final delivery Done for local TP channel TP delivery report + dist/

Interpretation: Language pilots completed research→implement. Productcompletion for integrity + local technical preview completed audit→harden→deliver. M10 implementation and any 1.0 platform work are new SOPcycles, not silent unfinished core.


5. Milestone program (M0–M10)

ID Theme Version / AETH Status Primary artifacts
M0 Research + AI-first foundation Complete NORTH_STAR, CORE_CLAIMS, research/, ADR-002
M1 Value/resource semantics Design Accepted direction DESIGN-M1, ADR-003, M1 matrix
M2 Bounded arena + buffers 0.6 / v6 Implemented ADR-004, AETHER_0.6
M3 Structural authoring v1…v6 current Implemented ADR-005, authoring protocols
M4 Error[Whole] effect 0.7 / v7 Implemented ADR-007, M4 design/matrix
M5 Deterministic comptime 0.8 / v8 Implemented ADR-008, M5 design/matrix
M6 Dual-layout tables 0.9 / v9 Implemented ADR-009, M6 design/matrix
M7 Structured nurseries 0.10 / v10 Implemented ADR-010, M7 design/matrix
M8 Pure host ABI pilot 0.11 / v11 Implemented ADR-011, M8 design/matrix
M9 Offline project tooling package 0.12 Implemented pilot ADR-012, M9 design/matrix
M10 Multi-unit offline projects tooling (planned) Designed only ADR-013, DESIGN-M10, M10 matrix

5.1 What each implemented milestone delivered (honest bounds)

Milestone In product Explicit non-claims
M2 One arena, Whole/Truth buffers, closed allocate outcomes No ambient allocator; no resource host ABI crossing
M3 Versioned AST/edit/diagnostic JSON; top-level structural edits Not fine-grained body LSP; not a second unsafe language
M4 Abortive Error[Whole], handle/forward/raise No generic effects; no resumption; clean resource boundary
M5 Root literal comptime bind, 1024-cap No macros, calls, host I/O, names at comptime
M6 shape + rows/columns tables No automatic layout rewrite; Whole-only fields
M7 together / spawn nurseries No OS threads; cooperative source order only
M8 host weave + HOST_CALL; pure fixtures whole_inc, text_extent No C/FFI, libloading, ambient I/O
M9 aether.project/v1, verify, format No registry, multi-unit graph, full LSP

5.2 Delivery report index (implementation history)

Date Report
2026-07-28 AI-first foundation
2026-07-28 M1 resource semantics
2026-07-31 M2 bounded resources
2026-07-31 M3 structural authoring
2026-08-01 M4 typed error effect
2026-08-01 Retire Studio
2026-08-03 M5 comptime
2026-08-03 M6 layout
2026-08-03 M7 nurseries
2026-08-04 M8 host ABI
2026-08-04 M9 project tooling
2026-08-04 Technical preview TP-2

6. Architecture snapshot

┌─────────────────────────────────────────────────────────────────┐
│ Operator (trusted for host process)                              │
│  aether CLI — local files only, explicit write paths             │
└────────────────────────────┬────────────────────────────────────┘
                             │
     ┌───────────────────────┼───────────────────────┐
     ▼                       ▼                       ▼
 Bootstrap (Rust)      Seed compiler (Aether)    Project tooling
 parse/check/AST       default product compile   aether.project/v1
 authoring v6          forge ABI host            path + lock + verify
 format                                            format
     │                       │
     └───────────┬───────────┘
                 ▼
         AETH v4–v11 verify
                 ▼
         Aether VM (guest untrusted)
         pure host fixtures only (M8)
Enter fullscreen mode Exit fullscreen mode
Path Role
Seed (default) CLI compile, apply-edit validation
Bootstrap compile --bootstrap, check, seed rebuild
Forge Host ABI: compile [borrow source: Text] -> Bytes

Studio: Retired (ADR-006). CLI is the sole product interface.

Legacy: legacy/ holds historical prototypes; not build inputs.


7. Seed self-host and proof posture

Claim Status
Multi-generation seed self-host identity Proven in seed_self_host tests (full run is long-pole)
Shipped examples/*.ae seed ≡ bootstrap Proven (gate dual-compare + tests)
M2–M8 documented corpora dual-compare Proven in seed self-host suite
Full invalid-source diagnostic parity (seed vs bootstrap) Not claimed
Seed reads project JSON / multi-file link Not claimed (and not M10 design)

Checked-in seed pin:

seed/aether_seed.aeth
SHA-256: 6AC3C46B890029B646267E93C9FDA5CDD34F9E061D7BC0419D34E0DF6734B254
Enter fullscreen mode Exit fullscreen mode

Profile documentation: SEED_PROFILE.mdForge contract: FORGE_CONTRACT.md


8. CLI product surface

Command Purpose
aether version Print package version
aether check Bootstrap parse/validate path
aether structure Emit aether.ast/v6
aether apply-edit Apply aether.edit/v6; seed-compile before write
aether format Canonical format (stdout or --output)
aether project verify Offline project integrity + per-unit seed compile
aether compile Seed compile (default); --bootstrap optional
aether forge Compile via compiler artifact ABI
aether run Verify then execute AETH

Note: Successful run uses process exit 0; the program exit code isprinted (Aether 0.12.0 exited with N). Host-pilot program exit is 48.


9. Completion program (TP-1 / TP-2 / P4.1)

Human P0 freeze (2026-08-04):

Target Definition Status
TP-1 Integrity Complete Claims/docs, formal audit, gate automation, tree hygiene Done (810f9ac)
TP-2 Technical Preview Threat model + local dist/ + checksums + consumer verify Done (1f24a1b)
P4.1 / M10 Multi-unit projects Design → ADR → matrix before code Design Done (1ab0be1); impl pending

9.1 TP-1 deliverables

Item Path / evidence
Claim/doc sync CORE_CLAIMS, ROADMAP, MANIFEST, AGENTS
Constitution dumps .gitignore (never commit)
Gate script tools/aether-gate.ps1 (-Mode quick / full)
Audit AUDIT_REPORT-2026-08-04-COMPLETION-READINESS.md
Quick gate PASS (fmt, clippy, tests, 19 example dual-compare, host-pilot, project verify)

9.2 TP-2 deliverables

Item Path / evidence
Threat model THREAT_MODEL-TECHNICAL-PREVIEW.md
Release notes / changelog RELEASE_NOTES-TECHNICAL-PREVIEW.md, CHANGELOG-0.12.md
Package script tools/package-preview.ps1
Consumer verify tools/verify-preview.ps1 (also staged in package)
Package layout dist/aether-0.12.0-tp/ (gitignored)
Delivery report DELIVERY_REPORT-2026-08-04-TECHNICAL-PREVIEW.md
Consumer verify result PREVIEW VERIFY PASS
Binary SHA-256 (build host) E6D958F111F820C9EAD7C1B49D6D6F4C5FA9A29D1EA289C5B314D97D54833FE7
Channel Local folder + SHA-256SUMS only (no required git tag / GitHub Release)

9.3 M10 design (P4.1) — accepted direction, not implemented

Item Path
Design DESIGN-M10-MULTI-UNIT-PROJECTS.md
ADR ADR-013-m10-multi-unit-projects.md
Matrix M10-VALIDATION-MATRIX.md
Claim CLM-018 Accepted direction (not Proven now)

Decision summary: multi-unit offline integrity with nested paths andindependent per-unit seed compile; no language modules/imports; keepaether.project/v1 with expanded path grammar; add project format.


10. Quality gates and how to run them

10.1 Day-to-day (TP-1 quick)

pwsh -File .\tools\aether-gate.ps1 -Mode quick
Enter fullscreen mode Exit fullscreen mode

Includes: pack verify (if found), fmt --check, clippy -D warnings, core lib

  • m4–m7 semantic tests, CLI tests, example dual-compare, host-pilot, projectverify. Skips multi-generation seed rebuild.

10.2 Release / TP confidence (full)

pwsh -File .\tools\aether-gate.ps1 -Mode full
Enter fullscreen mode Exit fullscreen mode

Adds full aether-core suite (including seed self-host) and bootstrap≡forged≡checked-in seed hash identity. Long pole (many minutes).

10.3 Technical preview package

pwsh -File .\tools\package-preview.ps1
pwsh -File .\dist\aether-0.12.0-tp\verify-preview.ps1
Enter fullscreen mode Exit fullscreen mode

10.4 Manual MANIFEST gate (subset)

Documented in MANIFEST.md and project AGENTS.md Commands.


11. Claims register snapshot

Source of truth: CORE_CLAIMS.md. Summary only:

Status Examples
Proven now AETH verify-before-run; seed-hosted default compile; no ambient guest I/O; local-first CLI; M2–M8 bounded features; M9 single-project pilot; authoring v6
Accepted direction Broader FFI beyond pure host (CLM-009); M10 multi-unit (CLM-018)
Research hypothesis Further layout expansion beyond M6 (CLM-008)
Prohibited Transpile-to-other-language (CLM-010); blanket “better than all languages” (CLM-011)

Any public comparative claim must use the scorecard in CORE_CLAIMS.


12. Security and threat posture

Topic Posture
Guest AETH Untrusted; no ambient OS authority
Host CLI Trusted by the operator who launched it
Host services (product) Pure only: whole_inc, text_extent; fail closed if missing
Project paths Relative only; .. / absolute / drive rejected
Locks SHA-256 mismatch fails closed
Network / registry / model Not in product
Formal cert / multi-tenant SaaS Not claimed

Canonical freeze: THREAT_MODEL-TECHNICAL-PREVIEW.md.

Runtime dependencies (core): pinned serde, serde_json, sha2 — nonetwork client in the product CLI.


13. Repository map

XLang/
  AGENTS.md                 Level-4 pointer + mission
  MANIFEST.md               Product contract / release gate
  README.md                 Overview
  AUDIT_REPORT.md           Historical migration audit
  apps/xlang-cli/           aether CLI
  crates/xlang-core/        parser, compiler, verifier, VM, authoring, project
  seed/                     Aether-written seed compiler source + artifact
  examples/                 Shipped .ae + project fixture
  schemas/                  AST/edit/diagnostic/project JSON schemas
  docs/                     Specs, ADRs, matrices, delivery reports, this report
  tools/                    aether-gate, package-preview, verify-preview
  legacy/                   Reference only
  dist/                     Local TP package (gitignored)
Enter fullscreen mode Exit fullscreen mode

14. Recent commit spine (completion + late pilots)

Commit Summary
1ab0be1 docs(m10): multi-unit design ADR-013
1f24a1b docs(tp2): technical preview package + threat model
810f9ac docs(tp1): integrity complete — claims, gate, audit
7a8024e feat(tooling): 0.12 offline project pilot (M9)
b08c0b6 feat(language): 0.11 host ABI pilot (M8)
cdcafe7 feat(language): 0.10 structured nurseries (M7)
f1c7663 feat(language): 0.9 dual-layout tables (M6)
002e98a feat(language): 0.8 deterministic comptime (M5)
bf0e1a2 feat(language): 0.7 typed error effect (M4)
44974fd refactor: retire Studio; CLI toolchain
ae568d2 feat(authoring): structural editing contract
36e10b7 feat(language): 0.6 bounded resources (M2)

15. Gaps, residual risk, and non-goals

15.1 Open engineering (next)

Item Priority Blocker
Implement M10 per matrix Next feature Design/ADR ready; needs code + tests + example
Optional aether-gate -Mode full timed audit entry Hygiene Long runtime
Language modules / imports Later Separate ADR + seed proof
Broader host I/O Later Threat model rewrite + ADR
C/FFI Later Ownership/threat design
Full LSP Later Authority boundary design
Network registry Later Offline-first law + threat model
Native/LLVM backend Blocked Requires project law change

15.2 Residual risks (accepted for preview)

Risk Status
Operator can overwrite any explicit --output path Documented host authority
Seed forge cost limits iteration quick vs full gates
Dual pack path (external vs untracked dump) Dumps gitignored; gate searches both
Claim drift after future features DOC-SYNC + gate discipline
Expectation of multi-file linking M10 docs explicitly refuse until modules ADR

15.3 Hard non-goals (current law)

  • Transpilation to another language
  • Ambient guest file/network/shell
  • Blanket superiority marketing
  • Committing constitution dump trees
  • Calling technical preview “1.0”

16. Definition of Done status by program arc

Arc CONST-DONE-001? Notes
M0–M9 language/tooling pilots Yes (within bounds) Each has delivery report + matrix evidence
TP-1 Integrity Yes Audit certificate filed
TP-2 Local technical preview Yes for local channel Not a public GitHub Release
M10 multi-unit No Design only; implementation incomplete
General 1.0 platform No Not a project claim

17. Rule ID self-audit (this progress report)

Rule ID Status Notes
CONST-GATE-001 Pass (documented) Gate scripts exist; run before further ship
CONST-DONE-001 Pass for closed arcs M10 not Done
CONST-COMPLETE-001 Pass for closed arcs No half-open M0–M9 claims
CONST-DEP-001 Pass M10 design before implementation
DOC-SYNC-001 Pass for this snapshot Report matches HEAD 1ab0be1
ENG-WARN-001 Pass at last TP/TP-1 gates Re-run after next code change
TEST-BEHAVIOR-001 Pass for shipped surface M10 matrix not green yet
SEC-INPUT-001 Pass for TP freeze Threat model present
REV-PACK-001 Pass This report packages human-readable progress
REL-PACKAGE-001 Pass for local TP Rebuild via package-preview
SOP-PHASE-001 Pass Phases scored honestly in §4
SOP-GATE-001 Pass Gates mapped in §10

Modules conceptually loaded for this report: pack AGENTS/SOP/Done/docsstandards; project AGENTS, MANIFEST, ROADMAP, CORE_CLAIMS, threat model,completion audit, TP delivery report, M10 design package.


18. Recommended next actions (human priority)

  1. Accept this progress report as the institutional snapshot at 1ab0be1.
  2. Implement M10 against M10-VALIDATION-MATRIX.md(path grammar, multi-unit example, project format, tests, DOC-SYNC,delivery report) — full SOP 7 → 8 → Done.
  3. Optionally run aether-gate -Mode full and attach wall-time/hash evidence tothe audit trail.
  4. Archive/copy dist/aether-0.12.0-tp/ if the local preview binary set isneeded offline outside the monorepo.
  5. Do not start C/FFI, registry, full LSP, or native backend without a newhuman-approved ADR and threat-model update.

19. One-page scorecard

Dimension Score Comment
Local-first AETH toolchain Strong Seed path, verify, VM, CLI
Evidence discipline Strong ADRs, matrices, dual-compare, claims register
Constitution / SOP adherence Strong Pack law, gates, delivery reports
Language completeness Bounded pilot Deliberately small surface
Multi-file projects Designed Not implemented
Public distribution Local TP only No mandated public release
1.0 readiness No Honest non-claim

20. Document control

Field Value
Title Full Project Progress Report
Location docs/PROGRESS_REPORT-FULL-PROJECT.md
Supersedes Ad-hoc chat summaries; does not replace MANIFEST or milestone delivery reports
Update trigger After each milestone Done or completion-target change
Honesty rule Prefer under-claim; never promote NORTH_STAR to current behavior

End of full project progress report. Prepared under AGENTS Constitution:evidence over aspiration, Rule IDs over vague compliance, Done only whenmachine-checkable and documented.

Top comments (1)

Collapse
 
wpai-mrwizard94 profile image
Rob Bulkley

Aether in XLang

This repository hosts Aether, a new local-first language and CLI toolchain fordeterministic, AI-primary authorship. Aether 0.12.0 parses only Aethersource, emits deterministic AETH v11 bytecode, verifies every artifact, and runsit in the Aether VM. It never translates source to Rust, C, JavaScript, LLVM,or another language. Verified AETH v4/v5/v6/v7/v8/v9/v10 artifacts remaincompatible inputs with their original meanings; new compilation emits v11.

Seed-hosted compile path, resources, effects, comptime, and layout

Default compilation is no longer bootstrap-hosted for user programs.

  • aether compile invokes the Aether-written seed compiler(seed/aether_seed.aeth, embedded as SEED_COMPILER_ARTIFACT) through theforge ABI.
  • The Rust core remains the bootstrap: rebuild the seed (compile --bootstrap),produce the AST for check, and verify seed output against bootstrap in tests.
  • The seed self-hosts, and the shipped examples plus a complete canonical-surfaceregression corpus produce bytecode byte-identical to the Rust bootstrap.

Seed Profile emits the complete prior canonical surface plus Aether 0.11'sdocumented M2 resource, M4 error, M5 comptime, M6 layout, M7 nursery, and M8host-pilot corpora: named locals/parameters, every statement and shallowexpression family, borrow/move/access, multi-weave calls, immutablerecords, closed arena / Whole-or-Truth-buffer outcomes, dual-layout Wholetables, the explicit raises Whole, raise, forward call, and terminalhandle call forms, root-only literal comptime bind, structured nurseries,and capability-closed host weave / HOST_CALL. New compilation emits verifiedAETH v11 (language 0.11). Toolchain 0.12 adds offline project verify and format. See docs/AETHER_0.11.md anddocs/SEED_PROFILE.md.

weave leaf [value: Whole] -> Whole raises Whole:
  raise value

weave main [] -> Whole:
  bind mutable success <- 0
  bind mutable code <- 0
  handle call leaf 17 into success otherwise error into code
Enter fullscreen mode Exit fullscreen mode

M4 is deliberately one bounded abortive Error[Whole] effect, not a generalexception or algebraic-effects system. Effect boundaries are copy-only andcannot cross live owners, loans, arenas, buffers, or M2 outcomes.

M5 is deliberately one bounded evaluator, not a macro or build-script system:

weave main [] -> Whole:
  comptime bind table_width <- product 16 8
  comptime bind header_size <- sum 12 4
  yield sum table_width header_size
Enter fullscreen mode Exit fullscreen mode

It accepts exactly five checked literal Whole operations, has a fixed1,024-directive budget, and has no names, calls, loops, text, resource, effect,or host authority surface. Seedocs/DESIGN-M5-DETERMINISTIC-COMPT....

M6 adds author-visible layout for multi-field tables:

shape particle:
  mass Whole
  charge Whole

weave main [] -> Whole:
  bind memory <- arena 4096
  bind mutable parts <- table particle layout columns
  ...
Enter fullscreen mode Exit fullscreen mode

layout rows and layout columns store the same logical cells with differentphysical order. Seedocs/DESIGN-M6-EXPLICIT-LAYOUT-SHA....

Versioned structural authoring contract

Aether 0.11 tooling exposes a local, machine-readable aether.ast/v6 documentand accepts bounded aether.edit/v6 structural edits. The protocoluses exact canonical source revisions to reject stale requests, supports typedtop-level record/shape/weave insert, replace, and delete operations, reparses theformatter-owned result, and seed-compiles it before the CLI writes source to anexplicit output path. It exposes effect annotations, M4/M5/M6/M7 nodes, and arequired Bind.stage (runtime or comptime) without reinterpreting v1–v4.See docs/AETHER_AUTHORING_PROTOCOL_v5.mdand docs/ADR-005-structural-authoring-....

Still honest limits

  • Full invalid-source diagnostic parity is not claimed; the Rust bootstrapremains the diagnostic authority (aether check).
  • Records are intentionally non-recursive and immutable. Resource outcomes areimmediate terminal choose conditions, not first-class values; Buffer ownerscannot be weave results or cross the host ABI.
  • M4 supports only Error[Whole], Whole erroring results, and terminalhandling. It has no effect inference, resumption, cleanup, cancellation, orresource/effect composition.
  • M5 supports only one literal Whole arithmetic operation per explicit rootdirective. It has no dependency chaining, compile-time calls, control flow,macro expansion, build hooks, or configurable fuel.
  • Host invocation accepts and returns primitives only; use an Aether weave toproject a record field.
  • Future language extensions require their own seed-emission parity proof beforethey become part of the product compile surface.
  • Bootstrap rebuild of the seed is still required after changing the seed source.
  • M3 edits are deliberately top-level declaration operations. Fine-grainedstatement/expression edits and any claim of universal syntax-error-proof AIgeneration remain future, separately versioned work.

North star and evidence-led roadmap

Aether 0.8 is the current executable contract, not the full long-range languagevision. The project is deliberately designing for AI-primary authorship whilekeeping deterministic, locally verifiable compiler authority. Read the designset in this order:

  1. docs/NORTH_STAR.md — intended product direction andcurrent-law constraints.
  2. docs/CORE_CLAIMS.md — proven facts, accepteddirections, research hypotheses, and prohibited claims.
  3. docs/research/ — primary-source reference study,decomposition, and evidence plan.
  4. docs/AETHER_0.8.md anddocs/ADR-004-aeth-v6-bounded-resou...— current resource contract and deliberate limits.
  5. docs/AETHER_AUTHORING_PROTOCOL_v3.mdand docs/ADR-005-structural-authoring-...— implemented M3 authoring contract and its limits.
  6. docs/DESIGN-M4-TYPED-ERROR-EFFECTS.md,docs/ADR-007-m4-typed-error-effect.md,and docs/M4-VALIDATION-MATRIX.md — implementedM4 design, executable semantic kernel, and proof matrix.
  7. docs/ROADMAP.md — completed M2/M3/M4/M5 scope,and approved dependency order for future language work.

These documents do not claim general effects, concurrency, SoA lowering, Cinterop, fine-grained structural edits, or a native backend exist in 0.8.

Workspace

  • crates/xlang-core — bootstrap parser, typed resource semantic plan,emitter/verifier/VM, forge API, seed path
  • apps/xlang-cliaether CLI (seed compile by default)
  • seed/ — Aether-written compiler source + checked-in artifact
  • examples/ — programs proven seed-identical to bootstrap, including M2 cases
  • AGENTS.md — Level 4 entry → AGENTS Constitution pack

Command Line

Set-Location C:\WPAI\Software\XLang
cargo run -p aether-cli -- check (Resolve-Path .\examples\comptime.ae)
cargo run -p aether-cli -- structure (Resolve-Path .\examples\comptime.ae)
cargo run -p aether-cli -- compile (Resolve-Path .\examples\comptime.ae) --output .\target\comptime.aeth
cargo run -p aether-cli -- run .\target\comptime.aeth

Rebuild the seed safely after editing seed/aether_seed.ae.

Promote it only after the bootstrap and self-forged hashes are identical.

cargo run -p aether-cli -- compile .\seed\aether_seed.ae --output .\target\aether_seed.bootstrap.aeth --bootstrap
cargo run -p aether-cli -- forge .\target\aether_seed.bootstrap.aeth .\seed\aether_seed.ae --output .\target\aether_seed.forged.aeth
Get-FileHash .\target\aether_seed.bootstrap.aeth, .\target\aether_seed.forged.aeth
cargo run -p aether-cli -- compile .\seed\aether_seed.ae --output .\seed\aether_seed.aeth --bootstrap
cargo build -p aether-cli

Enter fullscreen mode Exit fullscreen mode




Product interface

The CLI is the shipped Aether product interface. It exposes canonical structureand validated structural edits locally without introducing an application, model,or network authority. The former Studio workbench was retired indocs/ADR-006-retire-aether-studio.md;historical material remains under legacy/ as reference only.

Governance

Binding quality law: AGENTS.md → universal AGENTS Constitution pack.Product contract: MANIFEST.md, docs/.