Skip to content

Monorepo-to-Multirepo Defactoring & Build-Time Flywheel SSOT

This document records the canonical architecture and measured before/after metrics for the Milestone v6.7 and v6.8 monorepo defactoring flywheel. Across two consecutive milestones, Vox eliminated all five workspace dev-dependency back-edge cycles, cut incremental and check compile times by 50% to 96% across the top 14 churn-weighted keystones, expanded standalone crates.io publishable packages from 7 to 33 verified crates, cut local vox ci pre-push execution to 1.07 seconds, reclaimed 191 GiB across ~/dev worktrees, and established a four-repository physical topology (vox, vox-ops, vox-axis, voxlang.org) with zero LLM split-brain.

1. Four-Repository Physical Topology (~/dev)

Section titled “1. Four-Repository Physical Topology (~/dev)”
RepositoryPath on DiskVisibilityRoleShared Contract Directories
vox/Users/brbrainerd/dev/voxPublic (Apache-2.0)core — Compiler, runtime, orchestrator, MCP server, CLI (default-members = ["crates/vox-cli"]), and 33 crates.io cratescontracts/wire/, contracts/ipc/, contracts/telemetry/
vox-ops/Users/brbrainerd/dev/vox-opsPrivate (LicenseRef-VoxOps-Proprietary)private-ops — Cloud GPU provider adapters (vox-plugin-cloud), private OTLP/telemetry receiver (vox-ops-telemetry-ingest), fleet opscontracts/wire/, contracts/ipc/, contracts/telemetry/
vox-axis/Users/brbrainerd/dev/vox-axis (crates/vox-gui)Public / Dualgui-surface — Tauri 2 + React/Vite desktop workbenchcontracts/gui/, contracts/telemetry/
voxlang.org/Users/brbrainerd/dev/voxlang.org (docs-astro)Publicdocs-site — Astro 7 + Starlight 0.42 documentation portalcontracts/documentation/

2. Measured Compile-Time & Velocity Flywheel (v6.6 → v6.8)

Section titled “2. Measured Compile-Time & Velocity Flywheel (v6.6 → v6.8)”
Crate / Gate90d Commitsv6.6 Baselinev6.8 VerifiedSpeedup / Reduction
vox-orchestrator-mcp619157.90 s9.88 s16.0x faster (-93.7%)
vox-orchestrator364119.00 s11.53 s10.3x faster (-90.3%)
vox-db25943.50 s1.78 s24.4x faster (-95.9%)
vox-orchestrator-models (leaf)4843.50 s1.37 s31.8x faster (-96.9%)
vox-populi22126.90 s6.41 s4.2x faster (-76.2%)
vox-compiler27925.40 s1.65 s15.4x faster (-93.5%)
vox-publisher3219.10 s7.33 s2.6x faster (-61.6%)
vox-scientia4314.70 s7.31 s2.0x faster (-50.3%)
vox-codegen39710.90 s7.67 s1.4x faster (-29.6%)
vox-corpus1038.60 s7.57 s1.1x faster (-12.0%)
vox-cli (src/ LoC)735109,091 LoC49,728 LoC-59,363 LoC (-54.4%)
Local vox ci pre-push—120 s+1.07 s>100x faster

3. Standalone crates.io Ecosystem (33 Verified Crates in crates/_public.toml)

Section titled “3. Standalone crates.io Ecosystem (33 Verified Crates in crates/_public.toml)”

All 33 crates pass vox ci publish-dry-run with zero path escapes and zero workspace-hack dependencies:

  1. Wave 1 (19 Zero-Internal-Dep Leaves): vox-crypto, vox-mesh-types, vox-kb-facets, vox-arch-check, vox-plugin-types, voxup, vox-rule-pack, vox-diagram, vox-similarity, vox-ast, vox-redact, vox-jsonschema-util, vox-http-client, vox-db-types, vox-orchestrator-types, vox-foundation, vox-telemetry, vox-quantize, vox-openai.
  2. Wave 2 (6 First-Order Dependents): vox-identity, vox-scaling-policy, vox-mesh-policy, vox-plugin-api, vox-oauth-pkce, vox-llm-egress.
  3. Wave 3 (2 Second-Order Dependents): vox-bounded-fs, vox-plugin-sdk.
  4. Wave 4 (6 Composite Libraries & CLI Binaries): vox-secrets (Clavis), vox-git, vox-hf-layout, vox-code-audit (toestub), vox-test-harness, vox-drift-check.