Skip to main content

Crate dream

Crate dream 

Source
Expand description

§dream

Layer 2 library facade that re-exports all Layer 0–1 core crates under feature-gated modules. Zero own logic — every public item originates from a core crate.

§Responsibility Table

File/DirResponsibility
Cargo.tomlCrate manifest: seven feature-gated optional workspace deps
src/lib.rsFeature-gated pub mod re-exports + crate-level Feature Flags table
docs/Crate doc entities: aggregation feature spec and zero-own-logic invariant
tests/Integration smoke tests verifying re-export paths per feature

§Feature Flags

FeatureActivatesDescription
commonclaude_corePath topology (ClaudePaths) and process utilities
storageclaude_storage_coreZero-dep JSONL parser for ~/.claude/ storage
profileclaude_profile_coreToken status detection and account credential management
runnerclaude_runner_coreClaudeCommand builder for programmatic Claude Code execution
managerclaude_version_coreVersion detection, settings I/O, and install helpers
fullall five aboveAll domain modules in a single dependency
enabledfullAlias for full; conventional workspace activation name

§Usage

# Cargo.toml
[dependencies]
dream = { version = "~1.0", features = ["profile", "runner"] }
use dream::profile::token::TokenStatus;
use dream::runner::ClaudeCommand;

§Architecture

Layer 2 facade — depends on Layer 0 (claude_core) and Layer 1 (claude_profile_core, claude_runner_core, claude_version_core) plus the out-of-hierarchy claude_storage_core. No dependency on any Layer 2 CLI crate or Layer 3 super-app. No own types, traits, functions, or error definitions. dream — feature-gated facade re-exporting all claude_* core crates.

Enable individual domain modules via Cargo features:

FeatureModuleActivates
common[common]claude_coreClaudePaths, process utilities
storage[storage]claude_storage_core — JSONL parser, session types
profile[profile]claude_profile_core — token status, account management
runner[runner]claude_runner_coreClaudeCommand builder + execute()
version[version]claude_version_core — version, settings I/O helpers
assets[assets]claude_assets_core — symlink-based artifact installer
fullallAll six domain modules
enabledallAlias for full

§Usage

[dependencies]
dream = { version = "~1.0", features = ["profile", "runner"] }
use dream::runner::ClaudeCommand;