terraphim / terraphim/terraphim-ai

[Architecture][P4] Phase 4: Consolidate CLI product-line architecture

Open
#526 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

architecture enhancement
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.