Felix v0.1: linear values, ternary words, and a contraction that must agree with the memnet oracle
  • Rust 93.2%
  • Shell 6.3%
  • Java 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Péter Lódri c6a1a62b16 Add a mirror script that checks all three forges before pushing
A mirror that pushes to two of three forges leaves them disagreeing about what
the repository is, and nobody notices until someone clones the stale one. The
script probes each remote first, refuses to push when one is unreachable, and
prints the exact create commands it needs for Codeberg and g8t.

💘 Generated with Crush

Assisted-by: Crush:deepseek/deepseek-v4.1-flash-1017
2026-11-01 12:37:08 +09:00
.build Add a mirror script that checks all three forges before pushing 2026-11-01 12:37:08 +09:00
crates Start Felix with the two promises a test can hold 2026-11-01 12:33:35 +09:00
examples Start Felix with the two promises a test can hold 2026-11-01 12:33:35 +09:00
scripts Add a mirror script that checks all three forges before pushing 2026-11-01 12:37:08 +09:00
.gitignore Start Felix with the two promises a test can hold 2026-11-01 12:33:35 +09:00
AGENTS.md Start Felix with the two promises a test can hold 2026-11-01 12:33:35 +09:00
Cargo.lock Start Felix with the two promises a test can hold 2026-11-01 12:33:35 +09:00
Cargo.toml Start Felix with the two promises a test can hold 2026-11-01 12:33:35 +09:00
README.md Add a mirror script that checks all three forges before pushing 2026-11-01 12:37:08 +09:00

Felix v0.1

Two promises, both checked by tests:

  1. A linear value is consumed exactly once, or the program does not compile.
  2. The ternary datapath is the memnet reference oracle, bit for bit — Felix does not get its own opinion about packing or contraction.

It runs .flx files:

cargo run -q -- examples/01_hello_ternary.flx
word{gamma:2, re:+1/1, im:+0/0}
word{gamma:1, re:+4/0, im:+0/0}
(0, 0)
144
00+--+

And it refuses things:

cargo run -q -- examples/02_linear_rejected.flx
# error at 4:7: linear value `vault` is used here without being consumed

The language, in full

program    := statement* EOF
statement  := "linear"? "let" IDENT "=" expr ";"
            | "consume" "(" expr ")" ";"
            | "print"   "(" expr ")" ";"
expr       := primary ( "<~>" primary )*
primary    := INT | "[" [ expr ("," expr)* ] "]"
            | IDENT | IDENT "(" [ expr ("," expr)* ] ")"

Values: Int, Word (a packed complex ternary word plus its scale), Pair (a contraction result), Text, Vault, Unit.

Builtins:

Call Meaning
pack([samples...], gamma) dead-zone quantise integer samples into a word, imaginary quadrature zero
a <~> b contract two words; returns (re, im) integer accumulator
fib(n) F(n) by the NAND-only ripple-carry cascade
bt(n) balanced ternary of n, least significant digit first
new_vault() a fresh linear value

Why this is the whole language and not a scaffold

The repository this grew out of proposed a compiler, a VM, an LSP server, an MCP surface, four stdlib modules and a triple-forge push, in one pass. None of those can be called real until something pins their semantics, and a language whose first commit is all of them is a specification in a repository's clothing.

So v0.1 ships the spine and says what it does not do:

Piece State
Lexer, parser, checker, evaluator working, 27 tests
Linear-capability rule enforced, with both use sites in the diagnostic
Ternary packing + contraction delegated to memnet, differentially tested
NAND-only Fibonacci, balanced ternary reachable from source, tested to F(39)
VM, LSP, MCP, stdlib modules absent, deliberately
mem8 / engram / entheai stdlib absent — each needs its own acceptance tests
Second implementation (Zig/RTL) absent — this is the reference the others get diffed against

And one sentence that matters more than the rest: a language runtime is not a mind. Vault exists so that a memory-owning value has an owner, not because software has an interior. Anything that reads as a claim about consciousness is a documentation bug and should be deleted.

Layout

crates/felix-lang   lexer · ast · parser · check (linear types) · eval · diag
crates/felix-cli    the `felix` binary
examples/           01 runs, 02 is meant to fail

The differential tests (packing_is_bit_identical_to_the_oracle, contraction_is_bit_identical_to_the_oracle) link the real memnet crate by path, so if either side drifts the build breaks instead of the claim.

Where it lives

Forge URL State
GitHub https://github.com/8b-is/felix live
Codeberg https://codeberg.org/lodripeter-sec/felix does not exist yet — create it, then run the mirror script
g8t (Forgejo) git@g8t.8b.is:8b-is/felix.git no remote yet

scripts/mirror.sh checks all three forges for reachability before pushing, because a mirror that half-runs leaves the forges disagreeing; it prints the create commands when one is missing.

AGPL-3.0-only, matching the workspace it lives in.