open-standards/joule-code/ROADMAP.md
Transaction Science b3afd4e766
Some checks failed
joule-moq-remote host agent / joule-moq-remote · does this change touch it (push) Successful in 23s
joule-moq-room room service / joule-moq-room · does this change touch it (push) Successful in 28s
joule-moq-web browser client / joule-moq-web · does this change touch it (push) Successful in 28s
wai-app and Create / wai-app · does this change touch it (push) Successful in 28s
wai-fleet service / does this change touch it (push) Successful in 28s
joule-code conformance gate / joule-moq-relay, its own energy on a counter (macos) (push) Successful in 40s
joule-moq-remote host agent / joule-moq-remote, every target (macos) (push) Successful in 48s
wai-fleet service / service · macos (push) Successful in 38s
wai-app and Create / wai-app · Create, browser end-to-end (macos) (push) Successful in 5m2s
wai-app and Create / wai-app · tests, clippy, the line language's verifier (linux) (push) Successful in 38s
joule-code conformance gate / Build + round-trip C1-C4 vectors (push) Successful in 2m55s
joule-moq-web browser client / joule-moq-web · browser end-to-end (macos) (push) Successful in 17m6s
wai-fleet service / service · linux (push) Successful in 3m32s
joule-moq-remote host agent / joule-moq-remote, every target (linux-arm64) (push) Has been cancelled
joule-moq-room room service / joule-moq-room, every target (push) Has been cancelled
repository checks / lockfiles, advisories, tests in CI, workflow hygiene, spec and section references, public text (push) Has been cancelled
joule-code conformance gate / joule-moq-relay, every target (push) Has been cancelled
joule-code conformance gate / joule-moq-ingest, every target (push) Has been cancelled
The retired communicationOS name leaves the repository
communicationOS consolidated into WAI, and its site is retired. Where these texts
meant the transport they now say WAI or MoQT, and joule-moq's description, the
Joule Code docs and the Three Faces tables follow. The transport example names
joule-moq, which it uses, and its test drops the old name.

Changelog: none
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-07 02:39:44 -05:00

27 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Joule Code roadmap
Where the standard goes after v0.1.0. The reference library in [`joule-code-rs/`](joule-code-rs/) is a multi-crate Rust workspace; the flagship consumer is the agent-zed editor.
## v0.1.0 (current)
- Coding-operation cargo, content addressing, deterministic CBOR, signing (§2–§4).
- The receipt: `estimated` energy with `Estimator` provenance, JWP-signed (§6).
- The cascade interface and the conformance suite C1–C4 (§5, §8).
- Single-endpoint operation only; collaboration is interface-level (Research).
## Near-term (v0.2)
- **Measured energy.** Bind the receipt's `measured_uj` / `HwShunt` path to real hardware interfaces (RAPL on Linux, SMC/IOReport on Apple Silicon) via JouleClaw's energy + calibration crates. A vendor counter feeds that path only while it is demonstrably live for the domain it claims ([`spec/receipt.md`](spec/receipt.md) §2); where it is present but not live — as IOReport's CPU rails are to an unprivileged reader on macOS 27 — the receipt stays on the estimator. Promote §6 measured path from Engineering toward Solid where the platform delivers it.
- **Cascade lower tiers.** Land real L0 (content-addressed op cache) and L2 (embedding + hybrid retrieval) stages so frontier calls (L4) are genuinely the last resort, not the first.
- **Per-task routing.** Choose the closing tier and the L4 leg per request from intent + budget, recorded in the receipt.
## Mid-term
- **Federated collaboration (Research → Engineering).** Promote [`spec/collab.md`](spec/collab.md) from interface-level to a conformance-bearing binding: coding operations as Smart Byte envelopes, lockstep replication, WAI transport for session and presence, RemoteOS for shared sessions. Add a `conformance/v1/lockstep_vectors.json`-style pack when the binding stabilizes.
- **Post-quantum signatures.** Exercise the one-byte algorithm identifier (§2) with a PQ successor alongside Ed25519.
## Non-goals
- A protocol-level token. There will not be one.
- Reimplementing vendor agent authentication. Frontier agents (L4) are reached through the vendor's own logged-in client; the credential never enters the protocol.
- Reimplementing codecs, editors, or model runtimes. Joule Code composes existing standards (JouleClaw, Smart Byte, EOC, WAI, RemoteOS); it does not absorb them.