Project Structure

Full specification: 00-product-spec.md.

1. Rust Workspace

members = [
    "crates/yzos-core",
    "crates/yzos-runtime",
    "crates/yzos-cli",
    "crates/yzos-mcp",
    "crates/yzos-mcp-harness",
    "src-tauri",
]

Crate	Output	Responsibility
yzos-core	lib	Domain logic, PostgreSQL, OKF, entities, observation, inference, platform capabilities
yzos-runtime	lib	HTTP server, MCP, observe loop, crystallize loop, sidecar management
yzos-cli	bin yzos	Local HTTP client
yzos-mcp	bin yzos-mcp	MCP adapter
yzos-mcp-harness	test harness	MCP integration tests
src-tauri	bin yzos-desktop	Tauri host, links the runtime

2. crates/yzos-core

crates/yzos-core/src/
  -> activity/
  -> apps/
  -> bootstrap/
  -> crystallize/
  -> db/
  -> entity/
  -> inference/
  -> maintain/
  -> models/
  -> observe/
  -> platform/
  -> privacy/
  -> supply/
  -> sync/

Directory	Responsibility
activity	Activity session store, recorder
observe	Clipboard, AI tool, OCR, screen capture
crystallize	Triage, OKF, scene router, embedding
entity	Entity engine, signals, search, OKF writer
inference	Scheduler, LLM sidecar client, VLM profile
maintain	Cron, jobs, scheduling
platform	macOS permissions, accessibility, capture capability
supply	API handlers, pipeline

3. crates/yzos-runtime

crates/yzos-runtime/src/
  -> lib.rs
  -> server.rs
  -> mcp.rs
  -> llama_sidecar.rs
  -> state_file.rs

yzos-runtime is a runtime library, linked into src-tauri.

4. src-tauri

src-tauri/
  -> Cargo.toml
  -> tauri.conf.json
  -> Entitlements.plist
  -> Info.plist
  -> src/
       -> main.rs
       -> lib.rs

The Tauri host owns the window, menu bar item, permission requests, and the frontend bridge, and starts the runtime.

5. Migrations

migrations/
  -> 001_activity.sql
  -> 002_okf.sql
  -> 003_p1.sql
  -> 004_entities.sql
  -> 005_search_vector.sql
  -> 006_pgvector.sql
  -> 007_clipboard.sql
  -> 008_activity_screen_segments.sql
  -> 009_screen_segments_ocr_text.sql
  -> 010_voice_segments.sql
  -> 011_entity_metadata_indexes.sql
  -> 012_embed_dims_1024.sql
  -> 013_cron_jobs.sql

The UI State Engine’s target migration adds ui_snapshots, ui_nodes, ui_regions, ui_text_boxes, and ui_behavior_events.

6. Scripts

Script	Responsibility
scripts/dev-install.sh	Build and deploy /Applications/YZOS.app
scripts/install-autostart.sh	Install the login autostart agent
scripts/uninstall-autostart.sh	Remove the login autostart agent
scripts/fetch-models.sh	Download models
scripts/fetch-sidecars.sh	Download sidecars
scripts/verify-supply.sh	Verify the supply interfaces
scripts/verify-goal-e2e.sh	Verify end-to-end goal completion

7. Generated Files

.stdai/standards is the source of truth for AI assistant rules. After editing it, run:

stdagent sync --target claude-code --target codex

Do not hand-edit AGENTS.md, CLAUDE.md, .claude/rules/, or .codex/memories/; they are generated output.