terraphim / terraphim/terraphim-ai
[Architecture][P4] Phase 4: Consolidate CLI product-line architecture
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 62
- Forks
- 5
- Avg merge
- 2h 27m
- Merged PRs (30d)
- 1
Description
Parent: https://github.com/terraphim/terraphim-ai/issues/520
Related plan: docs/architecture-improvement-plan.md
Goal
Consolidate CLI architecture so terraphim_agent, terraphim_cli, and terraphim_repl share one runtime core and have clear product boundaries.
Deliverables
- ADR defining CLI product-line strategy (single binary with modes vs multiple binaries with shared runtime)
- Shared command runtime crate adopted by retained binaries
- Removal of duplicated command/runtime wiring
Tasks
- Evaluate existing overlap and decide target model via ADR
- Extract common command execution/runtime logic into shared crate
- Migrate binaries to shared core incrementally with compatibility checks
- Document ownership and purpose of each retained binary
Acceptance Criteria
- Clear ownership and purpose for each CLI binary in docs
- Reduced duplicate runtime logic across CLI crates
- Default and feature-enabled CLI builds pass quality gates
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading docs/architecture-improvement-plan.md and comparing the existing terraphim_agent, terraphim_cli, and terraphim_repl crates. The work requires an ADR decision, shared runtime extraction, incremental migration, and documentation of retained binary ownership. Done means duplicate runtime wiring is reduced and default and feature-enabled CLI builds pass their quality gates.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli
- Issue type
- Refactor
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100