Document WASM tooling requirements and fix metadata for new crates

Author: flyingrobots

README.md

@@ -12,7 +12,7 @@
 > **THE PROOF IS MATHEMATICAL.**  
 > **TIME WILL TELL.**  
 >
-> 🔗 [AIΩN Organization](https://github.com/your-org) | [JITOS RFCs](https://jitos.dev/rfcs) | [CΩMPUTER Paper](link)
+> 🔗 [AIΩN](https://github.com/flyingrobots/aion) | [JITOS RFCs](https://github.com/flyingrobots/jitos) | [CΩMPUTER Paper](https://github.com/flyingrobots/aion-computer-book)
 
 ```rust
 //! ░▒▓████████▓▒░▒▓██████▓▒░░▒▓█▓▒░░▒▓█▓▒░░▒▓██████▓▒░
@@ -72,6 +72,11 @@ Echo doesn’t “update objects.” It _rewrites_ parts of the graph using a se
 
 Echo follows the JITOS Engineering Standard: every SPEC is simultaneously documentation, implementation, interactive demo (WASM), living test, and contributor certification. See `docs/METHODOLOGY.md` for the full 5x Duty model and workflow.
 
+### WASM Dev Quickstart (Spec-000)
+- Prereq: `rustup target add wasm32-unknown-unknown` and `cargo install --locked trunk`
+- Dev: `make spec-000-dev` (hot reload at http://127.0.0.1:8080)
+- Build: `make spec-000-build` (outputs to `specs/spec-000-rewrite/dist/`)
+
 ### Why Echo's Cool
 
 - **Deterministic:** same inputs = same world every time.

crates/echo-session-ws-gateway/Cargo.toml

@@ -4,6 +4,12 @@
 name = "echo-session-ws-gateway"
 version = "0.1.0"
 edition = "2021"
+description = "WebSocket to Unix-socket bridge for the Echo session hub (browser clients -> JS-ABI frames)"
+license = "Apache-2.0"
+repository = "https://github.com/flyingrobots/echo"
+readme = "README.md"
+keywords = ["echo", "rmg", "websocket", "gateway", "wasm"]
+categories = ["network-programming", "web-programming", "asynchronous"]
 
 [dependencies]
 anyhow = "1"

crates/echo-session-ws-gateway/README.md

@@ -0,0 +1,22 @@
+<!-- SPDX-License-Identifier: Apache-2.0 OR MIND-UCAL-1.0 -->
+<!-- © James Ross Ω FLYING•ROBOTS <https://github.com/flyingrobots> -->
+# echo-session-ws-gateway
+
+WebSocket ↔ Unix-socket bridge for the Echo session hub. It terminates browser WebSocket connections, enforces JS-ABI frame sizing, and forwards binary frames to the Unix-domain socket exposed by `echo-session-service`.
+
+## Usage
+
+```
+cargo run -p echo-session-ws-gateway -- \
+  --unix-socket /tmp/echo-session.sock \
+  --listen 0.0.0.0:8787 \
+  --allow-origin https://your.host \
+  --tls-cert cert.pem --tls-key key.pem
+```
+
+## Features
+- Binary WS frames → JS-ABI packets over UDS
+- Payload guard (8 MiB default)
+- Optional origin allowlist
+- Optional TLS (rustls)
+- Ping/pong keepalive

specs/spec-000-rewrite/Cargo.toml

@@ -4,6 +4,12 @@
 name = "spec-000-rewrite"
 version = "0.1.0"
 edition = "2024"
+description = "Living spec (Spec-000) for Echo/JITOS: Leptos + Trunk WASM demo scaffold"
+license = "Apache-2.0"
+repository = "https://github.com/flyingrobots/echo"
+readme = "README.md"
+keywords = ["echo", "rmg", "wasm", "leptos", "spec"]
+categories = ["wasm", "gui", "education"]
 
 [lib]
 crate-type = ["cdylib", "rlib"]

specs/spec-000-rewrite/README.md

@@ -0,0 +1,26 @@
+<!-- SPDX-License-Identifier: Apache-2.0 OR MIND-UCAL-1.0 -->
+<!-- © James Ross Ω FLYING•ROBOTS <https://github.com/flyingrobots> -->
+# Spec-000 Rewrite (Living Spec)
+
+Leptos + Trunk WASM scaffold for Spec-000: “Everything Is a Rewrite.” This page will embed the actual Echo/JITOS kernel in the browser to demonstrate rewrite-driven state.
+
+## Dev
+
+```
+rustup target add wasm32-unknown-unknown
+cargo install --locked trunk
+make spec-000-dev   # from repo root
+```
+
+Serves at http://127.0.0.1:8080 with hot reload.
+
+## Build
+
+```
+make spec-000-build  # outputs dist/
+```
+
+## Next steps
+- Wire kernel bindings (wasm-bindgen feature)
+- Render RMG graph + rewrite log
+- Add completion badge win condition

specs/spec-000-rewrite/src/lib.rs

@@ -5,6 +5,8 @@
 use leptos::*;
 use wasm_bindgen::prelude::*;
 
+/// Top-level Spec-000 Leptos component (WASM).
+#[allow(missing_docs)]
 #[component]
 pub fn App() -> impl IntoView {
     let (epoch, set_epoch) = create_signal(0usize);
@@ -34,6 +36,8 @@ pub fn App() -> impl IntoView {
     }
 }
 
+/// WASM entry point required by `trunk serve`.
+#[allow(missing_docs)]
 #[wasm_bindgen(start)]
 pub fn main() {
     console_error_panic_hook::set_once();