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 · ok · checkedAt 2026-06-19T11:13:16.995Z

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.

adaptive-magazineadminaianalysesauditauthbrandcanonical-segmentationclassificationcommercecommunicationcomp-simconnectorscontractsdata-lensdata-profilerdata-sourcesdiagnostic-chaineditoreib-generatorelicitationexec-reportfield-kitglass-oxgovernancehealthhttpinferenceinsight-playerintent-routerlogmapping-cascademcpmeasurement-theorymei-recalibrationmetric-segment-datasetofferingsoverlaypii-rulesplan-runnerplayerprovenancerating-codecreference-catalogsresearch-methodsreviewreview-tablesalary-benchmarksecurity-rolessignalsstatstenancytenant-contexttools-wizardstriple-avisual-languagevisualizationsvoiwizards

Readme-derived dependency hints (HTTP path mentions)

  • anycompforecasting
  • manager-effectivenessperformance-validity

Foundation

data-anonymizerlive
Schema
data_anonymizer
Contract
1.2.0
Health
ok · 71ms
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 · 76ms
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.13.0
Health
ok · 72ms
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 · 81ms
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.6.0
Health
ok · 74ms
Tables*
0
Routes
18

# 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.17.0
Health
ok · 72ms
Tables*
0
Routes
22

# 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.6.0
Health
ok · 74ms
Tables*
0
Routes
11

# `factor-models` spoke

forecastinglive
Schema
forecasting
Contract
1.4.0
Health
ok · 74ms
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 · 76ms
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 · 70ms
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.3.0
Health
ok · 73ms
Tables*
0
Routes
11

# `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 · 77ms
Tables*
0
Routes
6

# `program-evaluation` spoke

Consumer-Composite

anycomplive
Schema
anycomp
Contract
1.54.0
Health
ok · 76ms
Tables*
0
Routes
84

# 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 · 83ms
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-connectorlive
Schema
principia_connector
Contract
0.12.0
Health
ok · 83ms
Tables*
0
Routes
21

# principia-connector — TB-PRINCIPIA-01 **Role:** Read-mostly cache + MCP surface for Principia's canonical-measurement store (CanonicalVariable / Measure / Citation / Instrument / Item / Effect / **synthesized priors**). **Status:** **live** (PAT-150, 2026-06-05) — REST read client + public priors endpoint + MCP tools (`principia-connector.priors.get`, `.h…

wage-benchmarklive
Schema
wage_benchmark
Contract
0.4.0
Health
ok · 82ms
Tables*
0
Routes
6

# 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 · 82ms
Tables*
0
Routes
33

# 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

diagnostic-coachinglive
Schema
diagnostic_coaching
Contract
0.1.0
Health
ok · 69ms
Tables*
0
Routes
5

# diagnostic-coaching **Role:** adaptive **diagnostic-driven coaching** — deliver a prompt/insight → capture the respondent's answer → adapt the next sequence → build a respondent capability profile, grounding every adapted step in matched corpus guidance via the live advisory API. This is **adapter #2** of the shared `@people-analyst/reincarnation-engine` …

forecast-strengthlive
Schema
forecast_strength
Contract
0.1.0
Health
ok · 79ms
Tables*
0
Routes
6

# forecast-strength **Role:** The forecast-calibration loop (PAT-200, crown-jewel rebuild Brief 2). Leaders predict key measures (point + 80/90% intervals + confidence); actuals land; forecasts are scored (Winkler interval score = width penalty + miss penalty, absolute error, hit rates); per-leader accuracy + calibration **trend** by quarter (the learnabili…

glass-oxlive
Schema
glass_ox
Contract
1.0.0
Health
ok · 84ms
Tables*
0
Routes
5

# glass-ox — PAT-GO1..GO4 **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, the service-key-gated run endpoint, the MCP mod…

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.6.0
Health
ok · 82ms
Tables*
0
Routes
25

# 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.2.0
Health
ok · 79ms
Tables*
0
Routes
4

# 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…

linkage-modelslive
Schema
linkage_models
Contract
0.1.0
Health
ok · 79ms
Tables*
0
Routes
8

# linkage-models **Role:** The Models layer = the linkage design graph (PAT-198, crown-jewel rebuild Brief 1). The registry of causal models — `Model → Variables (coefficient weights, provenance, confidence)` — plus the routing edges `persona × priority/philosophy-dimension → construct/model → measure/metric → analytic/spoke`, the persisted stated-importanc…

network-analysislive
Schema
network_analysis
Contract
0.2.0
Health
ok · 81ms
Tables*
0
Routes
5

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

preference-modelerlive
Schema
preference_modeler
Contract
1.6.0
Health
ok · 69ms
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.3.0
Health
ok · 78ms
Tables*
0
Routes
7

# reincarnation > **⚖️ PATENT PENDING (filed 2026-06-12).** This spoke's core mechanism is covered by a USPTO > provisional application — *"Adaptive Experimental Learning via Dynamic Diagnostic Instrument > Reconfiguration"* (inventor: Mike West; pro se). Covered as-filed: the evidence-driven item > lifecycle (pools D/C/B/A/PURGATORY/INFINITY with promotion…

research-methodslive
Schema
research_methods
Contract
0.4.0
Health
ok · 81ms
Tables*
0
Routes
8

# research-methods **Role:** the toolbox's rigorous **statistics / research-methods** capability — own the rigor badge. **Status:** live (PAT-RM-SPOKE, 2026-06-08). **Donor:** none (built on `src/lib/stats` + `src/lib/research-methods`). **Schema:** `research_methods` (heartbeat-only — stateless compute).

survey-orchestratorlive
Schema
survey_orchestrator
Contract
0.15.0
Health
ok · 80ms
Tables*
0
Routes
28

# `survey-orchestrator` spoke

talent-valuelive
Schema
talent_value
Contract
0.5.0
Health
ok · 78ms
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…