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

Offen

#526 erstellt am 12.2.2026 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 5/5
Geschätzter Aufwand: Über eine Woche
Anfängerfreundlichkeit: 25/100

Issue-Typ: Refactoring
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: rust
Bereich: cli

Rechercherichtung

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.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

architecture enhancement

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

Vorherrschende Sprache: Rust
Sterne: 62
Forks: 5
Ø Merge: 2 Std. 27 Min.
Gemergte PRs (30 T.): 1

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus terraphim/terraphim-ai

Feature: Implement dynamic model fetching in pi-rust (refs: pi-agent-rust#92) Offen

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 25/100

terraphim/terraphim-ai#885 · Erstellt am 22.5.2026
[feat] Evaluate rlmgrep for terraphim-ai codebase search Offen

Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100

terraphim/terraphim-ai#871 · Erstellt am 16.5.2026
Learning-driven command correction: Phase 2 & 3 Offen

enhancement

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 25/100

terraphim/terraphim-ai#810 · 2 Kommentare · Erstellt am 15.4.2026
Cross-run compounding via lesson injection and validation (Phase 3) Offen

enhancement

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 35/100

terraphim/terraphim-ai#729 · Erstellt am 27.3.2026
Add AgentEvolution haystack ServiceType (Phase 2) Offen

enhancement

Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 35/100

terraphim/terraphim-ai#728 · Erstellt am 27.3.2026

Alle Issues in terraphim/terraphim-ai