cyb/wysm/CLAUDE.md

π 0.0% 588 words · 3 min

agent collaboration

principles for working with AI coding agents on the cyber wysm runtime. read this and the foundational documents to have full context:

auditor mindset

the project is supervised by an engineer with 30 years of experience. deception does not work. never fake results, never substitute "looks correct" for "is correct". one time correctly is cheaper than five times beautifully.

what this repo is

a hard fork of wasmi v2.0.0-beta.2 (commit a8f6d806), extended with four cyber-native enhancements: jet substitution, finite-wasm metering, an actor harness, and a trident-lowering on-ramp. the runtime cyb embeds to execute conventional WebAssembly programs (souls) loaded from radio.

wysm is cyber's name for the runtime. wasm/WASM is the WebAssembly format. wasmi is the upstream project. cyber-side crates use the wysm- prefix; upstream crates keep their wasmi_* names.

see specs/wysm.md for the full design.

companion repos

repo path role
nox ~/cyber/nox sibling runtime; jet authors borrow nox jet patterns
rune ~/cyber/rune calls into wysm via ~host:%wasm.module.fn.args
trident ~/cyber/trident reads wasmi_ir for WASM → LIR lowering
cyb ~/cyber/cyb embeds wysm as soul runtime
radio ~/cyber/radio source of soul particles loaded into the engine
cyber ~/cyber/cyber knowledge graph (parent subgraph)

upstream tracking

origin is wasmi-labs/wasmi as the upstream remote. cyber-specific commits live on main. merge upstream releases as their own commits; never rebase to hide divergence.

git fetch upstream
git merge upstream/main

document non-trivial divergence in specs/patches.md.

do not touch zones

  • Cargo.toml workspace dependency versions — discuss before changing
  • crates/wasmi/, crates/wasmi_ir/, crates/wasmi_core/, crates/wasmi_collections/ — upstream code. modify only when adding a jet hook or metering hook; document the patch in specs/patches.md
  • LICENSE-APACHE, LICENSE-MIT — preserve dual-license attribution
  • specs/ — canonical spec, change there first then propagate to code

cyber-specific code lives in new crates: crates/wysm-jet, crates/wysm-meter, crates/wysm-harness, crates/wysm-trident. additions to these are free.

git workflow

  • atomic commits — one logical change per commit
  • conventional prefixes: feat:, fix:, refactor:, docs:, test:, chore:
  • never amend upstream-derived commits — keep the upstream lineage clean for merge tooling
  • commit on completion; do not wait for the user to say "commit"

build matrix

target dispatch unstable rust
macOS aarch64 tail-call (become) yes
macOS x86_64 tail-call (become) yes
Linux aarch64 tail-call (become) yes
Linux x86_64 tail-call (become) yes
Windows x86_64 tail-call (become) yes
Android (arm64) portable-dispatch no
embedded / no_std portable-dispatch no 
cargo build --no-default-features --features unstable     # tier-1
cargo build --no-default-features --features portable-dispatch  # tier-2

shell: nushell

use nu -c '...' or nu script.nu for scripting. reserve bash for git.

testing

  • unit tests in the crate they test (#[cfg(test)])
  • integration tests for new crates go in crates/<crate>/tests/
  • differential tests for jets — every jet is tested against its reference wasm implementation over a corpus. mismatches are CI errors, not silent fallback
  • benchmark against upstream wasmi on every PR — regressions in dispatch throughput are bugs

Homonyms

CLAUDE
Claude Code Instructions Git Workflow **Commit by default.** After completing a change, commit it. Don't wait for the user to say "commit". Only stage without committing when the user explicitly asks to stage. **Atomic commits.** One logical change per commit. Never combine two independent…
cyb/CLAUDE
CLAUDE.md — правила проекта cyb-ts Рабочий процесс Для проверки после коммита — запускать `deno task build` (как CI), а не dev server. Dev server (`deno task start`) запускать только по явному запросу пользователя. Проверка после изменений После каждого изменения кода — **обязательно пересобирать и…
soft3/CLAUDE
soft3 — developer experience layer what this repo is the soft3 SDK: language libraries, MCP server, CLI, and wire format schema for the soft3 stack. not the stack itself — a client layer on top of it. components | dir | what | status | |-----|------|--------| | `js/` | JavaScript/TypeScript SDK…
warriors/trisha/CLAUDE
Trisha — Claude Code Instructions Triton VM warrior. Execute, prove, verify, deploy Trident programs. Structure Source of Truth `roadmap/README.md` — status overview and confidence milestone. `roadmap/.md` — individual proposals (open/done). `docs/explanation/` — design rationale. Any…
cyb/evy/CLAUDE
evy — claude code instructions project evy is a unified-memory, multi-engine, neural-first game engine. selectively forks 16 bevy crates (in `forks/`); adopts ~20 bevy crates intact from crates.io; replaces 8 with cyber-native primitives. powers cyb and any future cyber-stack game. canonical spec…
neural/rs/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents below to have complete development context. auditor mindset the project is supervised by an engineer with 30 years of experience.…
soft3/lens/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
cyb/cyb-boot/CLAUDE
cyb-boot — project rules What cyb-boot IS A thin installer (~3MB) that bootstraps the cyb desktop app from the content-addressed network. It is NOT the app itself. Target flow (from design doc): 1. Import wallet from boot.dat (mnemonic + referrer) 2. Connect to iroh bootstrap nodes 3. Fetch version…
soft3/mudra/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
soft3/hemera/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
neural/eidos/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
soft3/bbg/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
neural/rune/CLAUDE
Claude Code Instructions Git Workflow **Commit by default.** After completing a change, commit it. **Atomic commits.** One logical change per commit. **Conventional commits.** Use prefixes: `feat:`, `fix:`, `refactor:`, `docs:`, `test:`, `chore:`. Architecture rune is the open-computation language…
cyb/honeycrisp/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…
neural/trident/CLAUDE
Trident A building block for a cyberstate with superintelligence. Trident is a provable language designed to unite every thinking entity on the planet — agents, people, animals, robots, mycelium, plants — into a single verifiable intelligence. Every line of code here is a step toward that…
soft3/nox/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
soft3/soma/CLAUDE
soma — machine mind Local cognitive architecture of one cyber Avatar. A machine that perceives, decides, acts, learns, and survives. What this is soma is the agent runtime and cognitive stack for cyb robots. It is a standalone product — the embodied mind layer that sits between raw hardware and the…
soft3/zheng/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
cyb/honeycrisp/aruminium/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…
cyb/honeycrisp/acpu/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…
neural/rs/.claude/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
soft3/strata/jali/CLAUDE
agent collaboration jali (जाली) — polynomial ring arithmetic R_q = F_p[x]/(x^n+1) over Goldilocks. project structure no wgsl/ directory. ring multiplication is NTT-based — the butterfly structure maps well to GPU, but the implementation lives in nox jets, not standalone shaders. key invariants…
soft3/strata/nebu/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
soft3/strata/kuro/CLAUDE
agent collaboration kuro (黒) — F₂ tower field arithmetic for binary proving. project structure key invariants zero production dependencies in the core library `#![no_std]` — embeddable anywhere Wiedemann tower construction: α_k = product of all previous generators F₂⁴: α = 0x02, F₂⁸: α = 0x08,…
soft3/strata/trop/CLAUDE
agent collaboration trop — tropical semiring arithmetic for provable optimization. project structure key invariants zero production dependencies in the core library `#![no_std]` — embeddable anywhere the tropical semiring (min, +) is NOT a field: no additive inverse tropical addition: a + b =…
cyb/honeycrisp/unimem/CLAUDE
Claude Code Instructions project: unimem pure Rust memory driver for Apple Silicon. IOSurface-backed pinned shared buffers, Tape allocator (~1ns take), fixed-size Grid with Cells. zero-copy sharing between CPU, GPU, AMX, and ANE. role in the stack unimem is a hardware memory driver. it allocates…
soft3/strata/genies/CLAUDE
agent collaboration genies — isogeny group action arithmetic for post-quantum privacy. project structure wgsl/ provides batch F_q GPU operations. 512-bit multi-limb arithmetic has carry dependencies that limit single-element throughput, but batch dispatch (many independent mul/add pairs) amortizes…
cyb/honeycrisp/rane/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…

Graph