System architecture documenter

Auto groups spokes using fuzzy rules inspired by the consulting workbook System Documentation helper. Registry + README mining + live aggregate health (`runAggregateHealthCheck`) keep this page honest without hand-drawn diagrams. Cross-cutting primitives list every first-level module under src/lib.

Aggregate health · down · checkedAt 2026-06-03T14:05:43.515Z

This surface

Category: Operator Tool

Nested under /operator/*; composes spoke HTTP contracts + README mining + aggregate health without new schemas.

Referenced spokes (docs): worker-resolution, org-graph, manager-effectiveness, segmentation-studio

Cross-cutting primitives (src/lib)

Toolbox-owned libraries that are not a single spoke — same mental bucket as the spreadsheet “system map” cross-cuts.

adminaianalysesauditauthcanonical-segmentationconnectorscontractsdata-lensdata-profilerdata-sourcesdiagnostic-chaineib-generatorelicitationexec-reportglass-oxgovernancehealthhttpinferenceinsight-playerintent-routerlogmapping-cascademcpmeasurement-theorymei-recalibrationmetric-segment-datasetoverlaypii-rulesplan-runnerplayerprovenancerating-codecreference-catalogsreviewsalary-benchmarksecurity-rolessignalstenancytenant-contexttriple-avisualizationsvoiwizards

Readme-derived dependency hints (HTTP path mentions)

  • anycompforecasting
  • manager-effectivenessperformance-validity

Foundation

data-anonymizerlive
Schema
data_anonymizer
Contract
1.2.0
Health
ok · 121ms
Tables*
0
Routes
7

# data-anonymizer **Role:** cross-cutting privacy primitive. PII detection (regex catalog, header + content modes), deterministic HMAC-keyed tokenization with persistent map cache, redaction-with-spans for arbitrary text, and the toolbox's min-N privacy gate. Every other spoke that surfaces team-level rollups gates against this. **Schema:** `data_anonymize…

org-graphlive
Schema
org_graph
Contract
1.1.0
Health
ok · 171ms
Tables*
0
Routes
10

# org-graph — Org multi-hierarchy graph (temporal edges + overrides) — PAT-148 **Role:** Materialize HRIS-aligned org snapshots as typed, time-bounded directed edges (`reports_to`, `costs_to`, departmental / custom hierarchies); resolve ancestors with operator-override precedence; run consistency QA, snapshot diffs, dominant-dept ELT inference, substring EL…

segmentation-studiolive
Schema
segmentation_studio
Contract
2.11.0
Health
ok · 139ms
Tables*
0
Routes
42

# segmentation-studio **Role:** HRIS canonical-field normalization + multi-membership segmentation engine. Raw HRIS columns → canonical field keys with confidence; SegmentDefinitions → resolved cohorts (memberIds + segmentNodeIds). The cohort-resolution layer downstream tools (calculus, preference-modeler's by-segment cross-tab, Performix's segmentation-ada…

worker-resolutionlive
Schema
worker_resolution
Contract
1.0.0
Health
ok · 195ms
Tables*
0
Routes
2

# worker-resolution spoke Two-Pass Self-Healing multi-source HR row resolution: learning index fortification (`Index_Reference`-style aliases) followed by deterministic merge with HRIS vault protection, supplemental fill/overwrite governance, admission policies, ladder matching, lineage, failures roster, rehire-aware termination guards.

workforce-planninglive
Schema
workforce_planning
Contract
0.5.0
Health
ok · 139ms
Tables*
0
Routes
17

# workforce-planning (position control + cross-system reconciliation) **Role:** Canonical **position spine** for org/location/job-family headcount, ATS requisitions, finance allocations, immutable **reconciliation** + **30/60/90 forecast** snapshots. Person-level facts stay in **segmentation-studio**; this spoke aggregates to **position grain** and aligns w…

Analytical

calculuslive
Schema
calculus
Contract
1.14.0
Health
ok · 140ms
Tables*
0
Routes
19

# calculus **Role:** numerical brain. Statistical enrichment + trend analysis as service primitives that other spokes call when they need stats applied to a feed or signal. Owns the canonical `MetricEnvelope` shape — the metric × segment × period × value × provenance × enrichment object that the rest of the portfolio composes around. **Schema:** `calculus`…

factor-modelslive
Schema
factor_models
Contract
0.4.0
Health
ok · 139ms
Tables*
0
Routes
9

# `factor-models` spoke

forecastinglive
Schema
forecasting
Contract
1.4.0
Health
ok · 140ms
Tables*
0
Routes
9

# forecasting **Role:** Monte Carlo simulation and value-of-information (VOI) primitives — EVPI and discrete EVSI — as **callable service APIs**, not a desktop analytics product. Owns seeded, reproducible draws; closed-form expression evaluation over named distributions; and compact decision-tree rollback for shared discrete uncertainty. **Schema:** `forec…

metrics-cataloglive
Schema
metrics_catalog
Contract
1.1.0
Health
ok · 142ms
Tables*
0
Routes
5

# metrics-catalog (HR Metrics Catalog — Catalog 1) — PAT-40 **Role:** Canonical HR metric definitions — Catalog 1 of the methodology substrate. **Donor:** `people-analyst/metric-engine-calculus` (archived) @ `97510dce446b9657cb3640c09200ad1f237f432b` (donor's `server/seed.ts` CATEGORIES + METRICS_DATA arrays; `icon` / `color` fields dropped as donor-app UI …

performance-calibrationlive
Schema
performance_calibration
Contract
1.0.0
Health
ok · 121ms
Tables*
0
Routes
4

## performance-calibration **Owns** - Calibration impact analytics surfaced as a distinct logical service (`/api/spokes/performance-calibration/*`). - Persisted snapshots of `{ preCalibrated → postCalibrated }` tuples keyed by `{ tenant × employee × cycleId }`. **PostgreSQL** - Schema: `performance_calibration` - Tables: `heartbeat`, `calibration_pairs` …

performance-validitylive
Schema
performance_validity
Contract
1.2.0
Health
ok · 120ms
Tables*
0
Routes
10

# `performance-validity` spoke **PAT-158** ships the toolbox-native **rating instrument diagnostics** substrate: treating performance ratings as a single-item measurement and surfacing convergence, reliability/validity scorecards, predictability decomposition, trajectory diagnostics, calibration ROI probes, and change attribution narratives.

program-evaluationlive
Schema
program_evaluation
Contract
0.2.0
Health
ok · 170ms
Tables*
0
Routes
6

# `program-evaluation` spoke

Consumer-Composite

anycomplive
Schema
anycomp
Contract
1.44.0
Health
ok · 141ms
Tables*
0
Routes
72

# anycomp (Compensation Decision OS) — PAT-18 **Role:** Tenant-scoped compensation **service substrate**: comp models, market band math, employee evaluation, and cycle-level audit rows. **Donor:** `~/Vibe Coding Projects/anycomp` @ `b1a82b97f4885866ae8b029a51c32e2bf5958d70` (UI, BigQuery, Kanban, AI agent out of scope for this lift). **Status:** Live — …

manager-effectivenesslive
Schema
manager_effectiveness
Contract
1.2.0
Health
ok · 196ms
Tables*
0
Routes
6

## manager-effectiveness **Owner:** Toolbox — leader-level composites for Performix + ELT scorecards **Donor:** Greenfield PAT-159 (nine-domain MEI scaffolding; FiveTran-inspired default weights only) **Status:** shipped **v1.1.0** — HTTP + MCP + Drizzle-backed tenant weight profiles + empirical recalibration shim (PAT-159-FU-B)

Operator Tool

operator-surfaceslive
Schema
(none — UI only)
Contract
0.1.0
Health
n/a ·
Tables*
0
Routes
0

Nested under /operator/*; composes spoke HTTP contracts + README mining + aggregate health without new schemas.

principia-connectorcoming-soon
Schema
principia_connector
Contract
0.0.0
Health
ok · 196ms
Tables*
0
Routes
1

# principia-connector — TB-PRINCIPIA-01 **Role:** Read-mostly cache + MCP surface for Principia's canonical-measurement store (CanonicalVariable / Measure / Citation / Instrument / Item / Effect). **Status:** **coming-soon** — namespace reserved; Principia API isn't live yet (lands with PRN-014). The cache + MCP tool surface lands in TB-PRINCIPIA-04 once th…

wage-benchmarklive
Schema
wage_benchmark
Contract
0.4.0
Health
down · 196ms
Tables*
0
Routes
5

# wage-benchmark spoke **Schema:** `wage_benchmark` · **Status:** live (v1) · **Contract:** `contracts/types.ts` Hourly-wage **market benchmarking** by job (SOC) × geography. Sibling to `wage-compliance`: compliance answers *"what is the legal floor?"*, benchmark answers *"what does the market pay?"*. Same audience — employers of hourly workers, who today …

wage-compliancelive
Schema
wage_compliance
Contract
0.17.0
Health
ok · 171ms
Tables*
0
Routes
32

# wage-compliance (Jurisdictional wage-rule engine) — PAT-79 **Role:** Tenant-aware **operational layer for jurisdictionally-variable wage compliance**: a hierarchical jurisdiction registry, a temporal rule engine with inheritance + precedence, citation-backed rule versions, and stateless single + bulk compliance evaluation against employee rosters. **Origi…

Uncategorized

glass-oxcoming-soon
Schema
glass_ox
Contract
0.1.0
Health
ok · 197ms
Tables*
0
Routes
4

# glass-ox — PAT-GO1 **Role:** Durable run-history substrate for the Glass Ox primitive (`src/lib/glass-ox/`). The primitive stays the authoritative engine (`runStep`, the assertion catalog, `buildRunReport`, `toDataLensStage`); this spoke owns the Postgres schema, versioned wire contract, HTTP read APIs, MCP module, and the registered "plan" concept that t…

insight-sprint-studioreserved
Schema
(see drizzle schema)
Contract
0.0.0
Health
n/a ·
Tables*
0
Routes
0

# `insight-sprint-studio`

job-family-agentlive
Schema
job_family_agent
Contract
1.2.0
Health
ok · 194ms
Tables*
0
Routes
16

# job-family-agent (Canonical job taxonomy + classifier + **JobFrame canon**) — PAT-71 · PAT-JF1 **Role:** Toolbox-owned canonical job taxonomy service **and the JobFrame canonical work-intelligence substrate**. Owns: (1) the SOC 2018 / O*NET 28.3 occupation registry (1,016 codes), 23 canonical job families, 26 canonical job functions, + a token-overlap heu…

leadership-qualitylive
Schema
leadership_quality
Contract
0.1.0
Health
ok · 172ms
Tables*
0
Routes
3

# leadership-quality — does a leader own the Triple-A model? **Role:** A **0–100 Leadership Quality index** for a leader or org-unit (PAT-184, Triple-A program W5). Mike's theory: a leader is excellent to the degree they take **ownership of the Triple-A model** for their organization. A composite-over-composites — it blends component sub-indexes computed by…

network-analysisreserved
Schema
(see drizzle schema)
Contract
0.0.0
Health
n/a ·
Tables*
0
Routes
0

# `network-analysis` (Organizational Network Analysis — ONA)

preference-modelerlive
Schema
preference_modeler
Contract
1.6.0
Health
ok · 121ms
Tables*
0
Routes
9

# preference-modeler **Role:** survey response collection + preference modeling. Anonymity-threshold rules that decide when a segment's responses can or cannot be surfaced. Conjoint / forced-choice / penny-allocation / pairwise comparison machinery. **Schema:** `preference_modeler` (Postgres, isolated within the shared Supabase project). **API namespace:*…

reincarnationlive
Schema
reincarnation
Contract
1.2.0
Health
ok · 120ms
Tables*
0
Routes
6

# reincarnation **Role:** adaptive psychometric diagnostic engine. Universal items (RIDs) shared across studies; study-local items (SIDs) carry virtue + IRT + reliability stats; pool-based item lifecycle (D / C / B / A / PURGATORY / INFINITY); information-gain-weighted adaptive selection. **Schema:** `reincarnation` (Postgres, isolated within the shared Su…

survey-orchestratorlive
Schema
survey_orchestrator
Contract
0.4.0
Health
ok · 172ms
Tables*
0
Routes
10

# `survey-orchestrator` spoke

talent-valuelive
Schema
talent_value
Contract
0.5.0
Health
ok · 171ms
Tables*
0
Routes
5

# talent-value — the value layer of the Triple-A model **Role:** Compute the *value stack* of Mike's people-analytics model — **ELV** (Employee Lifetime Value) now; **NA% / NAV / Opportunity** layered on top in PAT-182. This is the value denominator the whole Triple-A model (Attraction · Activation · Attrition) leans on. **Donor:** greenfield (net-new compu…