028285825b
Refreshed static analysis of workspace dependency structure: - graph.json: 10 crates, 17 crate-level edges, 95 files, 123 file-level edges - graph.summary.md: Updated metrics and fan-in/fan-out rankings - sccs.md: Confirmed no cycles (DAG structure intact) - layers.observed.md: 5-layer hierarchy from binaries to infrastructure - hotspots.md: Identified g3-config, g3-providers as high fan-in; g3-cli as high fan-out - limitations.md: Documented extraction method constraints Agent: euler
173 lines
7.7 KiB
Markdown
173 lines
7.7 KiB
Markdown
# Observed Layering
|
|
|
|
## Derivation Method
|
|
|
|
Layers derived mechanically from:
|
|
1. Crate dependency direction in Cargo.toml
|
|
2. Path-based module grouping
|
|
3. Import directionality analysis
|
|
|
|
## Crate Hierarchy
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ Layer 0: Binaries │
|
|
│ g3 (main entry) │
|
|
│ studio (standalone tool) │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ Layer 1: Application │
|
|
│ g3-cli (CLI interface, 16 files) │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ Layer 2: Orchestration │
|
|
│ g3-planner (planning logic, 8 files) │
|
|
│ g3-ensembles (multi-agent, 4 files) │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ Layer 3: Core Engine │
|
|
│ g3-core (agent engine, 38 files) │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌─────────────────────────────────────────────────────────────┐
|
|
│ Layer 4: Infrastructure │
|
|
│ g3-providers (LLM providers, 7 files) │
|
|
│ g3-config (configuration, 2 files) │
|
|
│ g3-execution (code execution, 1 file) │
|
|
│ g3-computer-control (desktop automation, 16 files) │
|
|
└─────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
## Intra-Crate Module Structure
|
|
|
|
### g3-core (38 files)
|
|
|
|
```
|
|
lib.rs
|
|
├── acd.rs # Aggressive Context Dehydration
|
|
├── background_process.rs # Background process management
|
|
├── code_search/ # Tree-sitter code search
|
|
│ ├── mod.rs
|
|
│ └── searcher.rs
|
|
├── compaction.rs # Context compaction
|
|
├── context_window.rs # Context window management
|
|
├── error_handling.rs # Error classification
|
|
├── feedback_extraction.rs # Coach feedback extraction
|
|
├── paths.rs # Path utilities
|
|
├── project.rs # Project abstraction
|
|
├── prompts.rs # System prompts
|
|
├── provider_config.rs # Provider configuration
|
|
├── provider_registration.rs # Provider registration
|
|
├── retry.rs # Retry logic
|
|
├── session.rs # Session management
|
|
├── session_continuation.rs # Session continuation
|
|
├── streaming.rs # Streaming utilities
|
|
├── streaming_parser.rs # Tool call parser
|
|
├── task_result.rs # Task result types
|
|
├── tool_definitions.rs # Tool definitions
|
|
├── tool_dispatch.rs # Tool routing
|
|
├── tools/ # Tool implementations
|
|
│ ├── mod.rs
|
|
│ ├── acd.rs
|
|
│ ├── executor.rs
|
|
│ ├── file_ops.rs
|
|
│ ├── memory.rs
|
|
│ ├── misc.rs
|
|
│ ├── research.rs
|
|
│ ├── shell.rs
|
|
│ ├── todo.rs
|
|
│ └── webdriver.rs
|
|
├── ui_writer.rs # UI abstraction
|
|
├── utils.rs # General utilities
|
|
└── webdriver_session.rs # WebDriver session
|
|
```
|
|
|
|
### g3-cli (16 files)
|
|
|
|
```
|
|
lib.rs
|
|
├── accumulative.rs # Accumulative mode
|
|
├── agent_mode.rs # Agent mode
|
|
├── autonomous.rs # Autonomous mode
|
|
├── cli_args.rs # CLI argument parsing
|
|
├── coach_feedback.rs # Coach feedback
|
|
├── filter_json.rs # JSON filtering
|
|
├── interactive.rs # Interactive mode
|
|
├── metrics.rs # Metrics/timing
|
|
├── project_files.rs # Project file loading
|
|
├── simple_output.rs # Simple output helper
|
|
├── streaming_markdown.rs # Markdown formatting
|
|
├── task_execution.rs # Task execution
|
|
├── theme.rs # UI theming
|
|
├── ui_writer_impl.rs # UiWriter implementation
|
|
└── utils.rs # CLI utilities
|
|
```
|
|
|
|
### g3-computer-control (16 files)
|
|
|
|
```
|
|
lib.rs
|
|
├── macax/ # macOS Accessibility
|
|
│ ├── mod.rs
|
|
│ └── controller.rs
|
|
├── ocr/ # OCR engines
|
|
│ ├── mod.rs
|
|
│ ├── tesseract.rs
|
|
│ └── vision.rs
|
|
├── platform/ # Platform implementations
|
|
│ ├── mod.rs
|
|
│ ├── linux.rs
|
|
│ ├── macos.rs
|
|
│ └── windows.rs
|
|
├── types.rs # Shared types
|
|
└── webdriver/ # WebDriver implementations
|
|
├── mod.rs
|
|
├── chrome.rs
|
|
├── diagnostics.rs
|
|
└── safari.rs
|
|
```
|
|
|
|
### g3-providers (7 files)
|
|
|
|
```
|
|
lib.rs
|
|
├── anthropic.rs # Anthropic Claude
|
|
├── databricks.rs # Databricks
|
|
├── embedded.rs # Local llama.cpp
|
|
├── oauth.rs # OAuth flow
|
|
├── openai.rs # OpenAI-compatible
|
|
└── streaming.rs # Streaming utilities
|
|
```
|
|
|
|
### g3-planner (8 files)
|
|
|
|
```
|
|
lib.rs
|
|
├── code_explore.rs # Code exploration
|
|
├── git.rs # Git operations
|
|
├── history.rs # History management
|
|
├── llm.rs # LLM integration
|
|
├── planner.rs # Planning logic
|
|
├── prompts.rs # Planner prompts
|
|
└── state.rs # State management
|
|
```
|
|
|
|
## Layer Violations
|
|
|
|
**None detected.**
|
|
|
|
All dependencies flow downward through the layer hierarchy. No upward dependencies exist.
|
|
|
|
## Uncertainty
|
|
|
|
- Layer assignment is based on dependency direction, not semantic intent
|
|
- `studio` is isolated (no internal crate dependencies) - layer assignment is nominal
|
|
- Some crates at Layer 4 could arguably be split further (e.g., `g3-computer-control` is large)
|