Registers
Indices 0–21 are visible; index 22 is Aleph Olam.
01 / Build objective
One engine, two public experiences
IvritCode executes normalized Hebrew source over twenty-two visible base-22 registers plus Aleph Olam. Quantum Etz Chaim presents that same run through services, paths, gates, observation, and manifestation. IvritOS names the orchestration contract between purpose and output.
The register reducer is authoritative. Coherence, graphics, sound, and prose may describe completed state; they may never alter it.
02 / Deliverable boundary
Implemented software, bounded claims
In scope
- NFC Hebrew input and final-form normalization.
- Exactly 23 immutable bounded registers.
- All 22 instructions and a versioned path map.
- Replayable trace, observation, screen, sound, file, and export.
- Shared contracts consumed by both sites.
Out of scope
- Physical qubit control or quantum speed-up.
- Generated-code execution or runtime network access.
- Unrecorded permission or global-state mutation.
- Symbolic language presented as scientific or religious proof.
03 / Package ownership
Canonical dependency direction
| Package | Owns | Must not own |
|---|---|---|
@ivritcode/core | Register state, Hebrew operations, execution trace | DOM, network, architectural prose |
@qec/core | Manifest, policy, verification, orchestration | Alternate letter transforms |
@qec/spec | Versions, identifiers, exchange validation | UI or runtime state |
| QEC adapter | Paths, gates, observation and Malchut views | A duplicate engine |
Direction: UI → QEC orchestration → IvritCode engine → Unicode primitives.
04 / Normative state
Machine invariants
Bounds
Every value is an integer base-22 digit.
Sequence
Each trace event advances exactly once.
UI mutation
Projection and rendering never change state.
Every beforeHash matches the preceding afterHash. Equal source, state, versions, seed, permissions, limits, and mode yield byte-identical canonical output.
05 / Atomic instruction
Ten accountable stages
01 Parse02 Authorize03 Context04 Path05 Services06 Transform07 Trace08 Project09 Observe10 Manifest
Any failure prevents partial state commit. Malchut remains locked until Da’at records a valid observation.
Open lifecycle plate →06 / Cross-site exchange
Reproducible handoff
ivritcode-exchange-0.2 carries source, hashes, initial and final state, engine version, path-map version, seed, complete trace hash, manifestation version, returning letters, and gates.
Quantum Etz Chaim validates the envelope through
@qec/spec. Unknown versions, invalid register counts, malformed payloads, and out-of-range values fail closed.07 / Safety limits
Bounded by construction
| Resource | Ceiling | Failure |
|---|---|---|
| Source graphemes | 4,096 | E_SOURCE_LIMIT |
| Instructions | 1,024 | E_PROGRAM_LIMIT |
| Execution steps | 10,000 | E_STEP_LIMIT |
| Trace events | 50,000 | E_TRACE_LIMIT |
| Export | 5 MiB | E_OUTPUT_LIMIT |
| Recursion | Disabled | E_RECURSION_DISABLED |
08 / Release gates
Evidence required
09 / Delivery status
What is built
| Phase | Output | Status |
|---|---|---|
| Atlas | Architecture and engineering plates | Complete |
| Engine | @ivritcode/core runtime | Complete |
| Contracts | @qec/spec, schemas, exchange 0.2 | Complete |
| Orchestration | @qec/core verification and policy | Integrated prototype |
| Console | Programs, traces, Da’at, Malchut | Complete prototype |
| Hardening | Expanded fuzzing and automated accessibility | Next |
10 / Definition of done
A traceable machine, not an atmosphere
Kernel 0.3 is done when both experiences consume one versioned engine; all instructions resolve; execution is deterministic and bounded; every visual claim cites a trace event or explicit convention; exports validate; classical state is independent of visualization; and every verification gate runs in CI.