EAR ARCH GOVERNANCEBUILD 025.5ACTIVE BUILDACTIVE025.5Architecture Governance LayerDOMAINS10PROTECTED10ADR INDEX →BUILDING MANAGER →SYSTEM HEALTH →
ADMIN / ARCHITECTURE

Architecture Governance

Internal control surface for EAR platform architecture. Inspect system domains, release states, protected systems, migration history, and build queue before making any platform changes.

ADR INDEX
Total Domains
10
Stable / Verified
6/ 10
Experimental
3
Frozen
1
Protected Systems
10
Critical Protected
4/ 10
BLDBuild State Registry
BUILD001-021
Foundation through Signal-Entity PipelineVERIFIED

Foundational builds establishing the EAR intelligence platform: Supabase integration, n8n orchestration, review workflow, forum intelligence, AI disclosure, source credibility, role model, event history, operator mode, jobs intelligence scaffolding, hybrid ingestion, multi-AI ratings, category specialist, multi-brand OS, entity intelligence, entity resolution, signal-entity pipeline, and pipeline consolidation.

BUILD022
Robotics Jobs BoardVERIFIED

Established the /jobs route with 60 seed job records, job card components, filtering UI, and the job_sources schema. ADR-022 governs this build.

ADR-022
BUILD023
Jobs Board EnhancementVERIFIED

UI and filtering improvements on the robotics jobs board.

BUILD024
Real Ingestion PipelineVERIFIED

Live ATS ingestion from Greenhouse, Lever, and Ashby. Ingestion orchestrator, provider adapters, source health tracking, and manual trigger API. ADR-024 governs this build.

ADR-024
BUILD025
Workforce Intelligence LayerAUDITED

Skills extraction (80+ taxonomy), vertical classifier (11 verticals), freshness decay engine, dedup engine, trend snapshots, company intelligence profiles, and admin source panel. ADR-025 governs this build.

ADR-025
BUILD025.5
Architecture Governance LayerACTIVE

Internal governance and architecture awareness layer. Domain registry, protected systems list, migration registry, build registry, ADR index, dependency map, architecture dashboard, and documentation. Fixes RISK-4 and RISK-6 from the Build 026 audit.

ADR-025.5
BUILD026
Capital Intelligence LayerACTIVE

Full CAP pillar: funding tracker (/funding), startup profiles (/startups + /startups/[slug]), investor intelligence (/investors), defense & government monitor (/defense), capital heatmap (/capital), and nav CAP pillar. Schema: cap_investors, funding_rounds, ma_events, defense_contracts, startup_profiles.

ADR-026
BUILD027
Public SEO & Alert FeedsQUEUED

Public job feed endpoints for SEO (trending today, highest-paying, by vertical), email alert subscriptions for skill and company tracking.

blocked by build 026
BUILD028
AI-Powered Job MatchingQUEUED

AI-powered job matching and recommendations using embedding similarity on job descriptions and user skill profiles.

blocked by build 027
MIGMigration History5 applied
BUILD pre-024LOW
SEED-001-international-sources
APPLIED

Seeded international news sources (Asia, China, EU) into job_sources table. RSS and API sources only.

job_sources
BUILD 024MEDIUM
build_024_ingestion_foundation
APPLIED

ATS ingestion foundation. Added Greenhouse, Lever, and Ashby provider support. Created ingestion orchestrator. Added source health tracking fields (last_checked_at, failure_count, credibility_score) to job_sources.

robotics_jobsjob_sources
BUILD 025MEDIUM
build_025_workforce_intelligence
APPLIED

Workforce intelligence schema. Created ingestion_runs, job_skills, company_metrics, skill_trends, and trend_snapshots tables. Added vertical, freshness_score, content_hash, and dedup_group_id columns to robotics_jobs.

robotics_jobsingestion_runsjob_skillscompany_metricsskill_trendstrend_snapshots
BUILD 025.5LOW
build_025_5_ingestion_runs_persistence
APPLIED

Pre-026 fix: wired actual ingestion_runs row persistence into the /api/jobs/ingest POST route. Previously the table was created but never written to. The GET route now reads recent runs from the table.

ingestion_runs
BUILD 026LOW
build_026_capital_intelligence_tables
APPLIED

Capital intelligence schema. Created 5 new tables for the CAP pillar: cap_investors, funding_rounds, ma_events, defense_contracts, startup_profiles. Seeded with 10 investors, 15 funding rounds, 7 M&A events, 10 defense contracts, and 10 startup profiles.

cap_investorsfunding_roundsma_eventsdefense_contractsstartup_profiles
PSRProtected Systems Registry10 PROTECTED

WARNING: Systems listed below cannot be rewritten, renamed, or structurally refactored without an explicit human instruction referencing the protected system ID. Additive changes only.

Ingestion OrchestratorCRITICAL

Core coordination layer that wires all ingestion adapters, the dedup engine, vertical classifier, skills extractor, and source health updates. Any structural change risks breaking the entire live ingestion pipeline.

lib/ingestion/orchestrator.ts
Job SchemaCRITICAL

Defines the canonical Zod schema and TypeScript types for all job data. Used by adapters, orchestrator, API routes, and UI components. Breaking this schema breaks the entire jobs pipeline.

lib/schemas/job-schema.ts
ATS Provider AdaptersHIGH

Each adapter implements the JobIngestionProvider interface against a live external API. Structural changes risk breaking production ingestion from real ATS platforms serving real robotics companies.

lib/adapters/greenhouse-adapter.tslib/adapters/lever-adapter.tslib/adapters/ashby-adapter.ts
Dedup EngineHIGH

Content-hash based deduplication prevents duplicate jobs from appearing in the feed. The 30-day lookback window, normalization logic, and dedup_group_id assignment are calibrated for production data. Altering these will corrupt the dedup_group_id lineage in the database.

lib/services/dedup-engine-service.ts
Vertical ClassifierHIGH

Classifies every ingested job into one of 11 canonical robotics verticals. The classifier patterns are calibrated against real job data. Changing vertical IDs would orphan existing database records.

lib/services/vertical-classifier-service.ts
Skills ExtractorHIGH

80+ skill taxonomy with weighted confidence scores. Skills are persisted to job_skills table. Renaming or removing skills would orphan existing skill_trends and company_metrics records.

lib/services/skills-extraction-service.ts
Freshness EngineMEDIUM

Exponential decay freshness scoring with a 14-day half-life. The decay formula is calibrated to keep jobs visible for ~60 days. Altering the formula would invalidate all existing freshness_score values in robotics_jobs.

lib/services/freshness-engine-service.ts
Ontology RegisterCRITICAL

Canonical taxonomy definitions used across all EAR domains. Any rename cascades across briefs, signals, entity records, and the jobs pipeline. Changes must be coordinated with a schema migration.

lib/intelligence/ontology-register.tslib/intelligence/canonical-definitions.ts
Approved Canonical DefinitionsCRITICAL

Approved canonical entity definitions that underpin the company resolver, signal classifier, and entity pipeline. Modifications require cross-domain impact assessment.

lib/intelligence/canonical-definitions.ts
Company Intelligence Profile RoutesHIGH

Company profile pages aggregate jobs-intelligence, funding, signals, and timeline data into structured public-facing profiles. These pages are indexed by search engines. Structural rewrites risk breaking SEO and external links.

app/company/[slug]/page.tsx
DOMSystem Domain Registry
DomainStateOwnerProtectedTablesDependenciesLast Updated
Ontologyontology
FROZENplatformYES2
none
2026-05-12
Ingestion Pipelineingestion
VERIFIEDplatformYES3
ontologysource-health
2026-05-13
Jobs Intelligencejobs-intelligence
VERIFIEDplatformYES5
ingestionsource-healthcompany-intelligence
2026-05-12
Company Intelligencecompany-intelligence
STABLEplatformno4
ontologyingestion
2026-05-12
Source Healthsource-health
VERIFIEDplatformYES2
none
2026-05-13
Capital Intelligencecapital-intelligence
EXPERIMENTALplatformno5
company-intelligence
2026-05-13
Research Intelligenceresearch-intelligence
STABLEplatformno2
ontologyingestion
2026-05-01
Educationeducation
EXPERIMENTALplatformno0
ontologyresearch-intelligence
2026-04-01
AI Model Libraryai-model-library
SANDBOXplatformno1
ontology
2026-04-15
Admin & Governanceadmin-governance
STABLEplatformno0
none
2026-05-13
DEPDomain Dependency Map
LEGEND
STABLE
VERIFIED
EXPERIMENTAL
SANDBOX
FROZEN
DEPRECATED
PROTECTED= do not rewrite without instruction
ONTOLOGYPROTECTED
Ontology
FROZEN

Canonical definitions, taxonomy, and approved vocabularies for all EAR verticals, skill categories, and entity types. The ground truth layer that all other domains must reference.

USED BY
ingestioncompany-intelligenceresearch-intelligenceeducationai-model-library
PROTECTED SYSTEMS
Ontology RegisterCRITICAL
Approved Canonical DefinitionsCRITICAL
DB TABLES
ontology_termscanonical_entities
INGESTIONPROTECTED
Ingestion Pipeline
VERIFIED

Real-time job and news ingestion from ATS providers (Greenhouse, Lever, Ashby), RSS feeds, ArXiv, GitHub Trending, HuggingFace, and Reddit. Handles fetching, normalization, deduplication, and persistence.

DEPENDS ON
ontologysource-health
USED BY
jobs-intelligencecompany-intelligenceresearch-intelligence
PROTECTED SYSTEMS
Ingestion OrchestratorCRITICAL
ATS Provider AdaptersHIGH
DB TABLES
robotics_jobsjob_sourcesingestion_runs
JOBS-INTELLIGENCEPROTECTED
Jobs Intelligence
VERIFIED

Workforce intelligence layer over the ingested job corpus. Includes skills extraction, vertical classification, freshness decay, trend snapshots, company hiring metrics, and admin analytics surfaces.

DEPENDS ON
ingestionsource-healthcompany-intelligence
PROTECTED SYSTEMS
Job SchemaCRITICAL
Dedup EngineHIGH
Vertical ClassifierHIGH
Skills ExtractorHIGH
Freshness EngineMEDIUM
DB TABLES
robotics_jobsjob_skillscompany_metricsskill_trendstrend_snapshots
COMPANY-INTELLIGENCE
Company Intelligence
STABLE

Entity intelligence profiles for robotics companies. Aggregates signals, job data, funding events, and timeline history into structured company pages.

DEPENDS ON
ontologyingestion
USED BY
jobs-intelligencecapital-intelligence
PROTECTED SYSTEMS
Company Intelligence Profile RoutesHIGH
DB TABLES
robotics_companiescompany_eventsentity_timeline_eventscompany_metrics
SOURCE-HEALTHPROTECTED
Source Health
VERIFIED

Monitors the health, reliability, and credibility of all ingestion sources. Tracks failure counts, last check times, and credibility scores per source.

USED BY
ingestionjobs-intelligence
DB TABLES
job_sourcesingestion_runs
CAPITAL-INTELLIGENCE
Capital Intelligence
EXPERIMENTAL

Robotics funding intelligence layer: funding rounds, M&A events, defense contracts, investor profiles, and startup intelligence profiles. The PitchBook pillar of the EAR OS.

DEPENDS ON
company-intelligence
DB TABLES
funding_roundsma_eventsdefense_contractscap_investorsstartup_profiles
RESEARCH-INTELLIGENCE
Research Intelligence
STABLE

ArXiv paper ingestion, academic signal detection, model release tracking, and research trend analysis. Feeds into intelligence briefs and trend signals.

DEPENDS ON
ontologyingestion
USED BY
education
DB TABLES
intelligence_signalsintelligence_briefs
EDUCATION
Education
EXPERIMENTAL

Learning paths, glossary, plain-language briefs, and structured course content for the EAR EDU pillar.

DEPENDS ON
ontologyresearch-intelligence
AI-MODEL-LIBRARY
AI Model Library
SANDBOX

Curated index of open-weight robotics AI models, foundation models, and deployment tooling. Includes model cards, benchmark comparisons, and hardware requirements.

DEPENDS ON
ontology
DB TABLES
ai_models
ADMIN-GOVERNANCE
Admin & Governance
STABLE

Internal platform governance layer. Architecture dashboard, domain registry, protected systems list, ADR index, migration history, dependency map, and build state registry.