95d9847354
- hotspots.md: Added specific dependent file lists for each hotspot - hotspots.md: Added cross-crate coupling points table - hotspots.md: Added crate-level coupling scores - limitations.md: Expanded coverage of unobservable patterns - limitations.md: Added confidence levels for inferences - limitations.md: Added extraction method details table Agent: euler
80 lines
4.5 KiB
Markdown
80 lines
4.5 KiB
Markdown
# Coupling Hotspots
|
|
|
|
**Generated**: 2025-02-02
|
|
**Method**: Fan-in/fan-out analysis from dependency graph
|
|
|
|
## High Fan-In Files (Most Depended Upon)
|
|
|
|
These files are imported by many other files. Changes here have wide impact.
|
|
|
|
| File | Fan-In | Dependents |
|
|
|------|--------|------------|
|
|
| `g3-core/src/lib.rs` | 18 | streaming_parser, context_window, acd, streaming, stats, retry, feedback_extraction, task_result, tool_dispatch, tools/* |
|
|
| `g3-core/src/ui_writer.rs` | 14 | retry, compaction, feedback_extraction, tool_dispatch, tools/{acd,executor,shell,research,file_ops,plan,memory,misc,webdriver} |
|
|
| `g3-cli/src/simple_output.rs` | 9 | utils, interactive, autonomous, coach_feedback, accumulative, task_execution, commands, agent_mode |
|
|
| `g3-cli/src/template.rs` | 6 | project_files, accumulative, commands, embedded_agents, agent_mode, interactive |
|
|
| `g3-core/src/paths.rs` | 6 | acd, session, context_window, tools/{executor,shell,plan} |
|
|
| `g3-core/src/context_window.rs` | 5 | compaction, stats, streaming, session, task_result |
|
|
| `g3-cli/src/g3_status.rs` | 5 | simple_output, interactive, task_execution, commands |
|
|
| `g3-cli/src/display.rs` | 4 | interactive, ui_writer_impl, agent_mode |
|
|
| `g3-cli/src/ui_writer_impl.rs` | 4 | autonomous, coach_feedback, accumulative, agent_mode |
|
|
| `g3-core/src/utils.rs` | 3 | tools/{shell,file_ops} |
|
|
|
|
## High Fan-Out Files (Most Dependencies)
|
|
|
|
These files import many other modules. They are integration points.
|
|
|
|
| File | Fan-Out | Dependencies |
|
|
|------|---------|-------------|
|
|
| `g3-cli/src/interactive.rs` | 11 | g3-core, completion, commands, display, g3_status, project, project_files, simple_output, input_formatter, template, task_execution, utils |
|
|
| `g3-cli/src/agent_mode.rs` | 11 | g3-core, project_files, display, language_prompts, simple_output, embedded_agents, ui_writer_impl, interactive, template, project, cli_args |
|
|
| `g3-cli/src/accumulative.rs` | 8 | g3-core, autonomous, cli_args, interactive, simple_output, ui_writer_impl, utils, template |
|
|
| `g3-cli/src/commands.rs` | 7 | g3-core, completion, g3_status, simple_output, project, template, task_execution |
|
|
| `g3-core/src/tools/executor.rs` | 7 | g3-config, background_process, pending_research, paths, ui_writer, webdriver_session, lib (ToolCall) |
|
|
| `g3-cli/src/autonomous.rs` | 5 | g3-core, coach_feedback, metrics, simple_output, ui_writer_impl |
|
|
| `g3-core/src/compaction.rs` | 4 | g3-providers, context_window, provider_config, ui_writer |
|
|
| `g3-core/src/tool_dispatch.rs` | 4 | tools/executor, tools/mod, ui_writer, lib (ToolCall) |
|
|
| `g3-cli/src/ui_writer_impl.rs` | 4 | g3-core, filter_json, display, streaming_markdown |
|
|
| `g3-core/src/streaming.rs` | 4 | g3-providers, context_window, streaming_parser, lib (ToolCall) |
|
|
|
|
## Cross-Crate Coupling Points
|
|
|
|
Files that bridge multiple crates:
|
|
|
|
| File | Cross-Crate Imports | Crates Touched |
|
|
|------|---------------------|----------------|
|
|
| `g3-core/src/lib.rs` | 2 | g3-config, g3-providers |
|
|
| `g3-core/src/webdriver_session.rs` | 1 | g3-computer-control |
|
|
| `g3-core/src/tools/webdriver.rs` | 1 | g3-computer-control |
|
|
| `g3-core/src/tools/executor.rs` | 1 | g3-config |
|
|
| `g3-core/src/tools/research.rs` | 1 | g3-config |
|
|
| `g3-core/src/provider_registration.rs` | 2 | g3-config, g3-providers |
|
|
| `g3-planner/src/llm.rs` | 3 | g3-config, g3-core, g3-providers |
|
|
|
|
## Crate-Level Coupling
|
|
|
|
| Crate | Outgoing Deps | Incoming Deps | Coupling Score |
|
|
|-------|---------------|---------------|----------------|
|
|
| g3-cli | 5 | 1 | High (consumer) |
|
|
| g3-core | 4 | 3 | High (hub) |
|
|
| g3-planner | 3 | 1 | Medium |
|
|
| g3-providers | 0 | 5 | High (foundation) |
|
|
| g3-config | 0 | 5 | High (foundation) |
|
|
| g3-computer-control | 0 | 2 | Low |
|
|
| g3-execution | 0 | 1 | Low |
|
|
| studio | 0 | 0 | Isolated |
|
|
|
|
## Observations
|
|
|
|
1. **g3-core/src/lib.rs** is the primary coupling hotspot. It defines `Agent`, `ToolCall`, and other core types used throughout the codebase.
|
|
|
|
2. **g3-core/src/ui_writer.rs** defines the `UiWriter` trait used by all tool implementations for output. High fan-in is expected for a trait definition.
|
|
|
|
3. **g3-cli/src/simple_output.rs** is a utility wrapper used by most CLI modules. High fan-in indicates it's a well-factored common dependency.
|
|
|
|
4. **g3-cli/src/interactive.rs** and **g3-cli/src/agent_mode.rs** have the highest fan-out, as expected for top-level orchestration modules.
|
|
|
|
5. **g3-providers** and **g3-config** are foundation crates with zero outgoing dependencies and high incoming dependencies. This is the expected pattern for leaf crates.
|
|
|
|
6. **studio** is completely isolated from the g3 crate ecosystem.
|