| --- |
| license: other |
| license_name: sovereign-leviathan-sl-agpl3-001 |
| license_link: https://huggingface.co/Snapkitty/Intent-V/blob/main/LICENSE |
| tags: |
| - snapkitty |
| - october-2026-drop |
| - zig |
| - scala |
| - chisel |
| - riscv |
| - rv32im |
| - firmware |
| - spice |
| - hardware |
| --- |
| |
| > Mirrored from [https://github.com/SNAPKITTYWEST/Intent-V](https://github.com/SNAPKITTYWEST/Intent-V) at commit `093768a`. Part of the **SnapKitty October 2026 main drop**. |
|
|
| # INTENT-V |
|
|
| [](https://github.com/BEL-ESPRIT-D-ACCORD-TRUST-HOLDINGS/demo-repository/actions/workflows/ci.yml) |
| [](LICENSE) |
|  |
|  |
|  |
|  |
|
|
| A small RV32IM-adjacent hardware/firmware sandbox: a memory-mapped accelerator, |
| its bare-metal driver, and an analog sanity netlist. |
|
|
| **What the "Conscious Coherence Unit" actually is:** a gated 32-bit multiplier |
| (`rawIntent * information`, low 32 bits, output enabled by `passionBound`) plus |
| an 8-bit saturating counter of cycles since it was last enabled. The thematic |
| signal names are aliases for that; nothing here exhibits anything beyond |
| multiplication and a mux. Please don't describe it to anyone as more. |
|
|
| | Dir | Contents | Toolchain | |
| |-------------|-------------------------------------------------------|------------------| |
| | `rtl/` | `IntentNexus` core, `CcuMmio` register wrapper, tests | sbt, Chisel 3.6 | |
| | `firmware/` | Zig 0.13 bare-metal driver, linker script | zig | |
| | `spice/` | NAND-gate transient netlist + placeholder models | ngspice | |
|
|
| ## Register map (base `0x4000_1000`) |
| |
| | Offset | Name | Access | |
| |--------|--------------------|--------| |
| | 0x00 | raw_intent | RW | |
| | 0x04 | information | RW | |
| | 0x08 | passion_bound[0] | RW | |
| | 0x0C | emergent_structure | RO | |
| | 0x10 | system_entropy[7:0]| RO | |
| |
| See [VERIFY.md](VERIFY.md) for the verification checklist. |
| |
| ## Architecture |
| |
| ```mermaid |
| flowchart LR |
| FW["Zig firmware<br/>(firmware/src/ccu.zig)"] -- "volatile MMIO<br/>base 0x4000_1000" --> MMIO |
| subgraph RTL["rtl/ (Chisel)"] |
| MMIO["CcuMmio<br/>register wrapper"] -- "rawIntent, information,<br/>passionBound" --> NEXUS["IntentNexus<br/>gated 32-bit multiplier<br/>+ 8-bit idle counter"] |
| NEXUS -- "emergentStructure,<br/>systemEntropy" --> MMIO |
| end |
| SPICE["spice/<br/>NAND transient netlist<br/>(placeholder models)"]:::side |
| classDef side stroke-dasharray: 4 3; |
| ``` |
| |
| ## Inside `IntentNexus` |
|
|
| ```mermaid |
| flowchart TD |
| A[rawIntent] --> M["multiply<br/>keep low 32 bits"] |
| B[information] --> M |
| M --> X{passionBound?} |
| X -- 1 --> P[emergentStructure = product] |
| X -- 0 --> Z[emergentStructure = 0] |
| X -- 1 --> C0[counter := 0] |
| X -- 0 --> INC{counter == 255?} |
| INC -- no --> C1[counter := counter + 1] |
| INC -- yes --> C2[counter holds at 255] |
| C0 --> E[systemEntropy] |
| C1 --> E |
| C2 --> E |
| ``` |
|
|
| ## Driver flow (`Ccu.compute`) |
|
|
| ```mermaid |
| flowchart TD |
| S([compute a, b]) --> R[read system_entropy & 0xFF] |
| R --> Q{"> ENTROPY_LIMIT (200)?"} |
| Q -- yes --> ERR([error.EntropyExceeded]) |
| Q -- no --> W["write raw_intent, information,<br/>then passion_bound = 1"] |
| W --> F[fence] |
| F --> RD[read emergent_structure] |
| RD --> U[write passion_bound = 0] |
| U --> OK([return product]) |
| ``` |
|
|
| ## CI pipeline |
|
|
| ```mermaid |
| flowchart LR |
| T["push / PR /<br/>workflow_dispatch"] --> J1["rtl<br/>sbt test"] |
| T --> J2["firmware<br/>zig build test, zig build"] |
| T --> J3["spice<br/>ngspice -b nexus_nand.sp"] |
| ``` |
|
|
| ## Commands |
|
|
| ```sh |
| cd rtl && sbt test # unit tests; `sbt run` emits Verilog to rtl/generated |
| cd firmware && zig build test # host-side driver tests |
| cd firmware && zig build # RV32IM ELF |
| cd spice && ngspice -b nexus_nand.sp |
| ``` |
|
|
| ## Status |
|
|
| First local run is recorded in [verification/FIRST-RUN.md](verification/FIRST-RUN.md). |
| RTL tests passed, `sbt run` emitted Verilog, Zig host tests passed, and the |
| SPICE deck printed `t_emergence`. Debug firmware does not fit the 64K ROM; |
| `zig build` defaults to ReleaseSmall for that reason. The SPICE models are |
| still placeholders. No process or clock claim. |
|
|
| ## License |
|
|
| Licensed under the Sovereign Leviathan covenant (`LicenseRef-Sovereign-Leviathan-SL-AGPL3-001`), an AGPL-3.0-based license. See [`LICENSE`](LICENSE). |
|
|
| ### 💼 Commercial License |
|
|
| SnapKitty code is free and open under the **Sovereign Leviathan covenant (AGPL-3.0 based)** for open-source use. Building a commercial product or service? A **proprietary commercial license** from Snapkitty Collective LLC lets you ship this code without the covenant's source-sharing and network-use obligations. |
|
|
| **[→ Get a commercial license](mailto:A.parr@belespritdaccord.uk?subject=Commercial%20license:%20Intent-V)** · A.parr@belespritdaccord.uk |
|
|
|
|
