Project Structure

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

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.