dreamstack/docs/generated/codebase-map.md
enzotar b0440e2e47 feat(compiler): v0.4 + v0.5 — CLI modularity, diagnostic pipeline, test suite
v0.4 — CLI Modularity:
- Split monolithic main.rs (2,038 lines) into 8 command modules + slim dispatch (107 lines)
- Add 12 JS codegen tests (signals, derived, views, events, loops, match, enums, components, interpolation, springs, tree-shaking)

v0.5 — Diagnostic Quality + Analyzer Confidence:
- Add From<ParseError> for Diagnostic (E0001) in ds-diagnostic
- Add errors_as_diagnostics() to TypeChecker (E0100–E0110)
- Wire Elm-style diagnostics through dreamstack check and build commands
- Switch incremental compiler to parse_program_resilient() for multi-error collection
- Add 12 analyzer tests (chains, fan-out, diamond deps, empty programs, conditionals, handlers, views)
- Add 2 diagnostic conversion tests

Test suite: 97 → 123 tests (26 new, 0 failures)
2026-03-10 09:09:02 -07:00

4.9 KiB

Codebase Map

Auto-generated by Space Operator Context extension. Links are relative — click to navigate to source files.

Project Structure

Rust Dependencies (Key Crates)

Local Crates

Crate Path
ds-parser compiler/ds-parser
ds-analyzer compiler/ds-analyzer
ds-codegen compiler/ds-codegen
ds-layout compiler/ds-layout
ds-types compiler/ds-types
ds-incremental compiler/ds-incremental
ds-physics engine/ds-physics
ds-stream engine/ds-stream
ds-stream-wasm engine/ds-stream-wasm

Tauri Backend Modules

Frontend (p2p-ui)

React + TypeScript desktop UI built with Tauri.

Key Pages

Page Description
ConnectionPage Connect to a remote Space Operator server
ProviderPage Register as a P2P compute provider
LocalServerPage Run an embedded flow backend locally
CommandsPage Browse and test registered flow commands
NodeDevPage Develop and test new nodes
KeypairsPage Manage Solana keypairs
DiscoveryPage P2P network node discovery

Flow Backend

The flow engine (git submodule) provides:

  • flow — Core flow graph execution engine
  • flow-lib — Shared types: CommandTrait, Value, CommandContext
  • flow-rpc — Cap'n Proto RPC for distributed node execution
  • cmds-std — Standard nodes: HTTP, JSON, string ops, storage, KV store
  • cmds-solana — Solana blockchain nodes: token ops, DeFi, NFT, governance
  • cmds-deno — JavaScript/TypeScript node runtime via Deno
  • rhai-script — Rhai scripting language nodes