-
Notifications
You must be signed in to change notification settings - Fork 2
EPIC: zeph-core God Crate Decomposition #1973
Copy link
Copy link
Labels
architectureArchitecture improvementsArchitecture improvementsepicMilestone-level tracking issueMilestone-level tracking issue
Description
Problem
zeph-core is 83,123 LOC (40.5% of workspace) — a classic god crate. It contains agent loop, config, context management, sanitization, orchestration, experiments, subagents, pipeline, instructions, cost tracking, metrics, vault, and more. Compilation serializes through it.
Goal
Extract 4-5 independent crates from zeph-core to reduce coupling, improve compilation parallelism, and enforce module boundaries at the crate level.
Audit Reference
.local/audit/001-zeph-core-architecture.md
Proposed Extractions
- zeph-orchestration (5,384 LOC) — TaskGraph, DagScheduler, LlmPlanner, LlmAggregator
- zeph-experiments (3,958 LOC) — already feature-gated, trivial extraction
- zeph-sanitizer (4,337 LOC) — ContentSanitizer, ExfiltrationGuard, PII, quarantine
- zeph-subagent (9,108 LOC) — SubAgentManager, grants, transcripts
- zeph-config (8,925 LOC) — Config types shared across crates
Acceptance Criteria
- Each extracted crate compiles independently
- zeph-core LOC reduced below 50,000
- Build time for incremental changes to extracted crates does not trigger zeph-core recompilation
- All 6,160 tests pass
- No public API changes for downstream consumers
Dependencies
Blocks all other epics (reduced crate size makes refactoring safer).
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
architectureArchitecture improvementsArchitecture improvementsepicMilestone-level tracking issueMilestone-level tracking issue