Mission Control doc

Vertical Fusion Checklist

vertical-fusion-checklist.md

Vertical Fusion Checklist — Master Build Tracker

Date: 2026-05-12 Status: Composition / spec — first master tracker since 40-doc research pipeline + 16 ADR drafts Purpose: Master checklist of every vertical integration + fusion layer in ValOS. Layered from Core (substrate primitives)EndpointsPeer Servicesoutward to Features.

Companion to v_platform/PLATFORM.md (Baseline live status §A.0-E + Master Checklist Part 1 + Part 2). This doc extends + organizes that baseline + Master Checklist by composing every architectural surface surfaced across the 2026-05-11 research pipeline + 16 ADR drafts.

Sources: v_platform/PLATFORM.md baseline + 40 research docs (2026-05-11 batch) + 18 ADR drafts (2026-05-12) + v_platform/IDENTITY.md + v_platform/SOUL.md + v_platform/AGENTS.md + CLAUDE.md + valos-reference.md.

Terminology lock (per operator 2026-05-12): ADE Factory = val-forge — the dev factory engine. Throughout this checklist + sibling MC docs, "ADE Factory" + "val-forge" + "ADE Factory Pipeline" + "val-forge pipeline" are synonymous. Per ADR-011 + ADR-025 val-forge owns the 4-scope multi-repo ADE.


Status legend

SymbolMeaning
Locked / production-ready (per PLATFORM.md baseline)
🔧In progress / partial
Not started / missing
📋Spec'd (research-doc or spec design exists; not built)
🎯ADR proposed (2026-05-12 batch); operator approval pending

Layer 0 — Ring 0 Substrate (Third-Party Dockers)

The foundation processes ValOS engines depend on but does not own. Per PLATFORM.md §A.1.

#ComponentPurposeSource
L0.1valos-postgres (pgvector/pgvector:pg17)Relational store + pgvectorPLATFORM.md baseline row 8
L0.2valos-openbaoSecrets vault (HashiCorp Vault fork) — ValOS infrastructure secrets surfacePLATFORM.md baseline row 9 + CLAUDE.md secrets rule
L0.3valos-natsPub/sub + JetStream broker (VALOS_L_PULSES + VALOS_S_PULSES streams up)PLATFORM.md baseline row 10
L0.4valos-vllm (ollama/ollama:latest)Local LLM inference; 3 models loadedPLATFORM.md baseline row 11
L0.5valos-meilisearchKeyword + typo-tolerant search index (v1 idle)PLATFORM.md Component Inventory
L0.6valos-kamailioSIP edge / SBC (voice substrate)PLATFORM.md Component Inventory; cross-cuts ADR-022 candidate voice/comms
L0.7valos-freeswitchMedia engine (voice — RTP, transcoding, recording, conferencing)PLATFORM.md + voice-substrate per d_mission-control/policies/voice-substrate.md
L0.8valos-meshcentralMesh transport candidate per ADR-022 candidate / doc 35 F234 — also fleet RMM + SOP screen capturePLATFORM.md + doc 35
📋L0.9valos-hocuspocusCollaboration server (Node.js Hocuspocus) per ADR-023doc 31 + ADR-023 + doc 40 F267 cross-validation
L0.10valos-kopia (or vaultwarden + bitwarden-server)Backup engine + password vault Ring 0 servicesdoc 36 + doc 39 + ADR-019 / future

Layer 1 — Substrate Primitives (First-Class Entities)

10 members per ADR adoption. The composable substrate from which all features are built.

#PrimitiveStatusADRStorage
L1.1b_fact (business fact)Three-class taxonomy locked 2026-05-03(rules/fact-taxonomy.md)val-ledger
L1.2s_fact (state telemetry)Locked(rules/fact-taxonomy.md)JetStream
L1.3l_fact (operational event)Locked(rules/fact-taxonomy.md)JetStream + severity mirror
L1.4skill (universal markdown skill)Locked per ADR-001(skill-frontmatter-spec.md)val-skills + filesystem
🎯L1.5Missions (multi-agent orchestration)ADR-007 proposedADR-007val-orchestrator + b_fact state
L1.6blueprints (Ring 3 + Ring 4)Locked (three-layer model per memory)n/a (architectural)filesystem + val-skills registry
🎯L1.7Context Cores (packageable engagement bundles)ADR-019 proposedADR-019Core archive (zip with 12 directories)
🎯L1.8scenarios (val-ontology composite operations)ADR-015 proposedADR-015val-ontology + filesystem
🎯L1.9transactions (atomic multi-pulse)ADR-016 proposedADR-016val-ontology
🎯L1.10Canvas (JSON Canvas 1.0 spatial composition)ADR-022 proposedADR-022val-ontology + filesystem
🎯L1.11Editor + Collaboration substrate (Tiptap + Hocuspocus)ADR-023 proposedADR-023val-ontology + Hocuspocus
🎯L1.12val-ingest (document ingestion substrate)ADR-017 proposedADR-017val-ontology

Three-way block-schema cross-lock: ADR-010 (renderer) + ADR-022 (Canvas) + ADR-023 (editor). All three share canonical block schema.

Two secrets surfaces locked: OpenBao (infrastructure per CLAUDE.md) + Bitwarden/Vaultwarden (client-facing per doc 39).


Layer 2 — Endpoints (Device Trio + Distribution)

Device-side runtime that ships per-machine. Per PLATFORM.md §A.3.

#ComponentRoleStatus
L2.1val-agent (eng:val-agent)Device-side OODA Chief of StaffPLATFORM.md row 16 (/health 200)
L2.2val-node (eng:val-node)Transport: NATS local broker + peer mesh + sidecarPLATFORM.md row 17 (sidecar /health :9760)
L2.3val-bay (eng:val-bay) — device-sideLocal skill executor (no model access; runs rust: + nats-relay:)PLATFORM.md row 18 (bay.echo NATS reply ~430 µs)
🔧L2.4val-agent OODA generalizationOODA beyond chat-only (arbitrary pulses)PLATFORM.md Master Checklist Phase 1.2
🔧L2.5val-bay hot-reloadSubscribe to valos.skill.updated.> for hot-reloadPLATFORM.md Master Checklist Phase 1.2
📋L2.6Cross-platform Rust agent (RMM)Windows/macOS/Linux/iOS/Android/ChromeOS endpoint coverage per doc 35 F235 zerotouch.ai-style breadthdoc 35 F240 ValOS-native equivalent
📋L2.7Endpoint mesh transportMesh-default for cloud/hybrid + NATS for on-prem per doc 35 F234 operator correctiondoc 35 + ADR-022 candidate MeshCentral
📋L2.8Edge devices / IoTKiosks / signage / rugged / manufacturing portable per doc 35 F235doc 35 cross-platform breadth

Layer 3 — HQ Engines (Peer Services)

Server-side multi-tenant engines. Per PLATFORM.md §A.2.

Locked HQ engines (PLATFORM.md baseline)

#EnginePurposeStatus
L3.1val-grid (eng:val-grid)CA + node enrollment + Entra-config + token-exchange proxyrow 12 (/grid/health 200)
L3.2val-cargo (eng:val-cargo)SoR / MCP gateway + Entra token exchange + JWKS verifyrow 13 (/cargo/health 200)
L3.3val-ontology (eng:val-ontology)Fusion gate (entity graph + LLMWiki + vector index + storage routing + promotion gate)row 14 (NATS reply ~1.3 ms)
L3.4val-ledger (eng:val-ledger)Canonical b_fact registry (identity + state + lineage envelope)row 15 (systemd=active)

In-progress HQ engines

#EnginePurposeStatus
🔧L3.5val-switchOmni-channel comms gateway (voice/email/SMS/Teams/WA/IG/FB/TG/webchat) — operator commitment: ValOS own provider + carrier partner per doc 25 F167 row 14PLATFORM.md substrate locked; per-channel implementations pending
🔧L3.6val-orchestratorHQ-side OODA / multi-step coordination (7 closed primitives: Pulse/Decide/Fan/Map/Park/Gate/Compensate)Only fleet_host watcher kind impl; remaining kinds + Wizard primitive + Matter/Decision/Gate pending per PLATFORM.md Master Checklist
🔧L3.7val-bay HQ-side (model gateway)Routes llm-prompt:<profile> skills to OpenAI/Anthropic/Ollama; cost ledger + failover policyv2 spec landed 2026-05-07; Phase 12 complete; Phases 3-11 pending
🔧L3.8val-fleetNATS voice for non-fork dockers (postgres/openbao/nats/vllm)Currently sim mode; val-bridge folds in as library

Missing HQ engines (R3 Peer Services)

#EnginePurposeSource
L3.9val-ingestFact ingestion gateway (R2 entry gate); MarkItDown integration; 3 extraction modes (judgment / structured / video)ADR-017 + doc 15
L3.10val-policy engineSkill governance + signing + fleet-wide distribution + scope contract enforcement; capability binding (Reads/Builds/Grows/Evolves/Computes per doc 33 R210) + ABAC extension per doc 40 F269PLATFORM.md Master Checklist + doc 33 + doc 40
L3.11Blueprint engine (val-fab)Manifest registry + slot resolver + widget binding contract + mount mechanismPLATFORM.md Master Checklist + Ring 3/4 lifecycle

Future engines (per research-pipeline commitments)

#EnginePurposeADR / Source
📋L3.12val-track (first-party work-tracking)Linear-equivalent; 11 semantic categories; "build our own Linear" per operator commitmentdoc 30 F181-F182
📋L3.13val-host (VPS/DNS/web hosting)Net-new architectural surface per doc 25 F167 + F168; per-client DNS + web hosting + reverse proxy + certificate management; possibly extends val-grid scopedoc 25 F167 + F168 batch 5
🔧L3.14val-forge (dev factory / blueprint factory + Multi-Repo ADE)Owns pipeline branches; AI panel for spatial + AI-assisted composition; Path C hybrid integration per ADR-011; multi-repo orchestration across dev-workspace + canonical + per-client + per-tenant val-up scopes per ADR-025; in final desktop testing 2026-05-12ADR-011 + ADR-025 + val-forge-spec.md (in-flight) + doc 11
📋L3.15val-canvas library (Rust)Canvas substrate library — 8 archetype templates; JSON Canvas 1.0 reader/writer; consumed by val-forge + val-deskADR-022 + doc 26 R157
📋L3.16val-editor library (Rust)Editor substrate library — Tiptap-compatible block-schema; consumed by 6 surfacesADR-023 + doc 31 F199
📋L3.17val-block-renderer libraryMulti-channel block rendering (11 block kinds; markdown/HTML/PDF/SVG outputs)ADR-010 + doc 9
📋L3.18val-bridgeProtocol-pluggable upstream dispatcher (companion runtime)PLATFORM.md Component Inventory
🎯L3.19val-up (self-contained Mission Control + Onboarding Engine)Self-contained Rust engine; multi-tenant SaaS at up.valtience.com; borrows ValOS libraries but runs standalone; Microsoft Entra OAuth + per-tenant isolation; first concrete consumer of ADR-023 Tiptap + Hocuspocus; runs Engagement Wizard for every client onboarding per ADR-013; MCP-only HQ integration via val-cargoADR-024 + mission-control-operating-protocol.md
🎯L3.20val-forge Multi-Repo ADE (extension of L3.14)4-scope ADE routing (dev-workspace + canonical + per-client + per-tenant val-up); per-client repo lifecycle Missions (mission.forge.repo.create.v1 + archive.v1 + upgrade.v1); per-scope promoter approval workflow; Decision Card → pipeline-branch dispatch from val-upADR-025

Layer 4 — Shells / Apps (Ring 2)

Tauri shells that host blueprint surfaces. Per PLATFORM.md §A.5 + Component Inventory.

#ShellRoleStatus
🔧L4.1val-desk (app:val-desk)Operator cockpit — inbox + ops + content; daily-driver shell; in final desktop testing 2026-05-12PLATFORM.md row 29
🔧L4.2val-desk slot systemDeclare slots as queryable Core/Endpoint API; codify widget contract; repackage chrome for blueprint hostingPLATFORM.md Master Checklist Phase 1.2
📋L4.3val-desk OpsCenter (3-layer surface)Tasks + Metrics + Initiatives surfaces per doc 28doc 28 F167 + R170 metrics dashboard
📋L4.4val-desk Canvas modeOpsCenter operator spatial outlining; 8 archetypes per doc 26 R156doc 26 + ADR-022
📋L4.5val-desk client portalClient-facing self-service portal (separate from MSP-facing OpsCenter); read-only initiallydoc 40 F270 + R277
L4.6val-atlasKnowledge graph + LLMWiki + entity viewsPLATFORM.md Component Inventory
L4.7val-workbenchFocused work surface for skill-heavy operationsPLATFORM.md Component Inventory
L4.8Additional role-specific shellsResearch / field-ops / mission-control / etc. as roles divergePLATFORM.md Component Inventory

Layer 5 — Libraries (Shared Crates — Ring 1)

Per PLATFORM.md §A.4 — 14 libraries locked.

#LibraryPurposeLOCStatus
L5.1val-configTOML loader + OpenBao secret resolution635row 19
L5.2val-entityECS types261row 20
L5.3val-eventsCloudEvents v1.0 envelope212row 21
L5.4val-factchainFact-chain envelope types439row 22
L5.5val-graphEntity envelope (extracted from val-bay)144row 23
L5.6val-learningLearning loop + capture1 261row 24
L5.7val-llmLocal mini-inference layer579row 25
L5.8val-memorySecond Brain persistent memory758row 26
L5.9val-pulsesPulse handlers407row 27
L5.10val-storesled-backed local KV341row 28
L5.11val-skillsSkill registry (parser + filesystem discovery)n/aextracted 2026-05-07
L5.12val-engine-configengine.config resolver via NATSn/aextracted 2026-05-07
L5.13val-registrationFleet self-registrationn/aextracted 2026-05-07
L5.14val-cachesled-backed local cache of ECS deltasn/aextracted 2026-05-07
L5.15val-loopsval-node lifecycle loopsn/aextracted 2026-05-07
L5.16val-sidecarProtocol-pluggable upstream dispatchern/aextracted 2026-05-07
L5.17val-node-runtimeval-node daemon runtimen/aextracted 2026-05-07
L5.18val-runtimePulse-execution framework (val-bay v2 spec)n/arenamed 2026-05-07
L5.19val-dispatchPulse-execution request handlern/aextracted 2026-05-07
🔧L5.20val-memory (full impl)Beyond initial implementationpartialMaster Checklist
L5.21Learning library (full)Beyond captureMaster Checklist
L5.22Agent-swarm libraryMission decomposition orchestration helpers per ADR-007Master Checklist + ADR-007
L5.23Sensor-driver librariesPer-sensor type driversMaster Checklist + IDENTITY hardware/edge surface

Layer 6 — Policy-as-Code / Meta Governance

Sits above the rings per PLATFORM.md §Policy-as-Code layer.

#Meta SkillPurposeStatus
L6.1meta/TAXONOMY.mdSkill naming ontologyLocked
L6.2meta/CAVEMAN.mdToken compression mechanics — 3-tier (Ultra/Full/Lite)Locked + caveman discipline external 57.7K-star validation per doc 24
L6.3meta/TONE.mdVoice + register specificationLocked
L6.4meta/PENDING.mdAnti-slop patternLocked
L6.5meta/AUTONOMY.mdApproval gate mechanicsLocked
L6.6meta/MEMORY.mdMemory modelLocked
L6.7meta/LEARNING.mdLearning loop mechanicsLocked
L6.8meta/SESSION.mdSession conventions detailLocked
📋L6.9Substrate-Primitive Design DisciplineAdd per doc 33 R207 — 4 ontology design principles (DDD / DRY / Open-Closed / Producer-extends-Consumer-Super)doc 33 R207 → valos-reference.md §48
📋L6.10meta/STRATEGIC-COMMITMENTS.mdOperator strategic commitments captured durably (zerotouch.ai borrow-only / mesh transport / Microsoft-stack alignment / val-track / val-host / etc.)doc 25 F167-F169 batch 5-6 commitments

Layer 7 — Cross-Vertical Capability Layers (Base Blueprints)

Cross-vertical capabilities composable across all verticals. Per project_blueprint_layering.md memory.

#Capability LayerStatusScope
📋L7.1Problem-Solving (multi-agent annealment)Operator-confirmed blueprintdoc 34; cross-vertical
📋L7.2QMS (Quality Management System — 8 surface areas)Operator-confirmed blueprintdoc 29; ISO 9001 + 7 extensions
📋L7.3Marketing AutomationCross-vertical capability layerdoc 18 + ADR-018
📋L7.4Engagement Wizard (5-level maturity framework)8 industry corroborationsADR-013; doc 12 + doc 19 + doc 21 + doc 25 + doc 29 + doc 34
📋L7.5Legacy Modernization MissionArmy + Foundry pattern at SMB scopeADR-014 + doc 13 + doc 4

Layer 8 — MSP-Vertical Toolstack (16-Area Capability Sketch)

Per doc 25 F167 capability sketch — 16 capability areas pre-mapped.

Endpoint Layer

#AreaStrategyReference
📋L8.1Endpoint provisioningval-grid + Rufus + USB sidecar (rejects Microsoft Autopilot)ADR-012 + doc 12
📋L8.2RMM / UEM / MDM consolidationValOS native build (Path C; mesh-default + NATS-on-prem); informed by zerotouch.ai primary + Tactical RMM secondary borrowable patternsdoc 35

Security / Monitoring Layer

#AreaStrategyReference
📋L8.3SIEM (Wazuh)Adopt Wazuh as primary SIEM substrate; XDR positioning beyond SIEM (15M endpoints production scale; Cisco/NASA/eBay/Intuit/Groupon customers)doc 25 F166
📋L8.4EDR / MDRValOS-as-MDR-provider on Microsoft Defender for Business EDR substrate; 6 MDR Mission categories; MDR ↔ RMM interaction (6 dispatch patterns)doc 37
📋L8.5M365 security trainingBlue Team Labs domain content (M365 audit logs / Defender / Intune)doc 25 F142

Operations Layer

#AreaStrategyReference
📋L8.6PSA / Ticketing / Client ManagementValOS native PSA-vertical-extension on val-track + Business Central + new client-portal surface; informed by Alga PSA borrow-only-patterns (5 patterns + Hocuspocus cross-validation)doc 40
📋L8.7Patch managementval-grid + val-orchestrator Missions (mission.patch.apply.v1)doc 25 F167 + ADR-012
📋L8.8Backup (per-client DR)Integrate-with Kopia (primary; Apache 2.0; Go) + Duplicati (alternative; LGPL; .NET); ValOS orchestrates engines via val-cargo + val-orchestratordoc 36

Identity + Credentials Layer

#AreaStrategyReference
📋L8.9Identity / SSO / Conditional AccessAzure AD / Entra (Microsoft-stack alignment) + val-grid identity surfacedoc 25 F167 + doc 38 F251
📋L8.10Password Management / VaultIntegrate-with Vaultwarden (primary; Rust; AGPLv3; lightweight) + Bitwarden Server (alternative; .NET; AGPLv3); 6 Mission categories; MDR cross-cut for credential-compromise rotationdoc 39
📋L8.11Documentation (IT Glue / Hudu replacement)Subsume via val-ontology LLMWiki + Coresdoc 25 F167

Communications + Hosting Layer

#AreaStrategyReference
📋L8.12Voice / CommsValOS own voice/comms provider + carrier partner per operator commitment 2026-05-11; val-switch + carrier SIP trunkingdoc 25 F167 + F168 batch 5
📋L8.13VPS / DNS / Web HostingNet-new ValOS hosting capability layer per operator commitmentval-host engine candidate OR extend val-grid scope; per-client DNS management + web hosting + reverse proxy + certificate managementdoc 25 F167 + F168 batch 5

System of Record Layer

#AreaStrategyReference
📋L8.14System of Record / Financial / BillingMicrosoft Dynamics 365 Business Central per operator commitment 2026-05-11; val-cargo MCP + REST/OData + Graph API bridge; 3 integration patterns (entity reference + b_fact emission + cache+sync); broadest cross-cutting commitment in pipelinedoc 38

Cross-Cutting Layer

#AreaStrategyReference
📋L8.15Incident response runbooksval-skills + scenarios per ADR-015doc 25 F167
📋L8.16Problem-Solving (complex incidents / NCR / root cause)Problem-Solving base blueprint per L7.1doc 34

MSP-vertical capability sketch total: 16 capability areas. Operator strategic stance per F167: subsume / integrate-with / build natively per per-category nuance.


Layer 9 — System of Record + External Integration

Microsoft-stack-aligned positioning locked across pipeline: 6 surfaces.

#Microsoft SurfaceValOS IntegrationReference
📋L9.1Microsoft Dynamics 365 Business Central (ERP / SoR)val-cargo MCP + REST/OData + Graph APIdoc 38 + ADR-009
📋L9.2Microsoft Defender for Business (EDR substrate)val-cargo + Graph API security endpoints; ValOS-as-MDR-providerdoc 37
📋L9.3Microsoft Intune (UEM/MDM)val-cargo + Graph API; zerotouch.ai-style Intune companion architecturedoc 35 F233
📋L9.4Microsoft Dataverse (business application data)val-cargo + Dataverse Web APIdoc 7
📋L9.5Azure AD / Microsoft Entra (identity / SSO)val-grid + Graph API user/group/license endpointsdoc 25 F167 + doc 38 F251
📋L9.6Microsoft 365 audit logs (security training + M365 surface)val-cargo + Graph APIdoc 25 F142

Per-client Microsoft licensing cost factor: ~$92/user/month (Business Premium + Business Central Essentials) per doc 38 F252.

Open-source-substrate-aligned alternatives:

  • Kopia + Duplicati (backup — L8.8)
  • Vaultwarden / Bitwarden Server (password vault — L8.10)
  • Wazuh (SIEM — L8.3)
  • Tiptap + Hocuspocus (editor + collaboration — L1.11)
  • MeshCentral (mesh transport + remote desktop — L0.8 + ADR-022)

Open-vs-locked corroboration count: 18 (per doc 17 §3 baseline 13 + 5 added across batch 5-6).


Layer 10 — Pipelines + Lifecycle

#PipelinePurposeStatus
📋L10.1Onboarding pipelineFills IDENTITY + SOUL templates + selects Ring 4 blueprints; runs at first session via val-agent CoS chatPLATFORM.md Component Inventory
📋L10.2val-forge factory pipelineAuthor → Promote → Install → Run → Retire for blueprints (Ring 3 + Ring 4)PLATFORM.md Blueprints-as-a-Service + ADR-011
L10.3Anomaly pipelineJetStream firehose → val-bay watcher OODA → val-ontology gate → val-ledger registryPLATFORM.md Pulse Lifecycle Path 2
📋L10.4Heartbeat watchdogval-orchestrator interval + plateau triggers per ADR-020 (3 corroborations: Coral + Automaton + K4D)ADR-020
L10.5Skill registry pipelineval-bay scans v_platform/skills/ at boot, validates against meta/TAXONOMY, exposes via valos.skill.lookupPLATFORM.md
🔧L10.6Smoke harness pipelineEngine-by-engine smokes (in v_source/ops/smoke/); dev-side onlyPLATFORM.md row 51
📋L10.7Engagement Core lifecycle (build/test/version/promote/rollback/transfer)6 lifecycle Missions per ADR-019ADR-019
📋L10.8Background curation Missions (Hydrator + Synthesis + Validation)6 categories per doc 32 F202; threshold ~500 LLMWiki entriesdoc 32 R199 + R200
📋L10.9Legacy Modernization pipeline (7 phases)Mission template per ADR-014ADR-014
📋L10.10caveman-shrink filter (MCP middleware)val-cargo gateway compression discipline; ~65% token reduction multiplierADR-021

Layer 11 — Engagement Cores Archive Structure (12 Directories)

Per ADR-019 + batch 5-6 directory extensions.

core.engagement.<client>.<engagement>.v<version>.zip
├── manifest.json                  ← (per ADR-019 baseline)
├── ontology/                      ← (per ADR-019 baseline)
├── embeddings/                    ← (per ADR-019 baseline)
├── facts/                         ← (per ADR-019 baseline)
├── policies/                      ← (per ADR-019 baseline)
├── provenance/                    ← (per ADR-019 baseline)
├── canvases/                      ← per doc 26 R158 (ADR-022)
├── knowledge-nodes/               ← per doc 33 R203 (granular reflected-knowledge units)
├── backup-state/                  ← per doc 36 F247 (backup config + restore-point catalog)
├── mdr-state/                     ← per doc 37 F247 (MDR config + incident log + playbooks)
├── bc-references/                 ← per doc 38 F254 (Business Central entity references)
├── password-mgmt-state/           ← per doc 39 F260 (Bitwarden config + audit log)
└── psa-state/                     ← per doc 40 F271 (tickets / assets / agreements / workflows)

Total: 12 directories (was 7 baseline; 7 substrate-state directories added across batch 5-6).


Layer 12 — Cross-Vertical Capability Layer Composition

Three cross-vertical base blueprints + four vertical-specific extensions identified to date.

Base Blueprints (cross-vertical capability layers)

Base BlueprintCross-Vertical Scope
Marketing Automation (ADR-018)All B2B + B2C + retail + SaaS + professional-services verticals
QMS (doc 29)Manufacturing + construction + healthcare + food-safety + medical-devices + pharma + financial-services + IT-services (8 candidate verticals)
Problem-Solving (doc 34)Universal across verticals (highest applicability)
Debt-recovery-au (memory baseline)SBR first production client engagement vertical

Vertical Blueprints (industry-specific)

VerticalStatusReference
Debt-recovery-AU📋 v1 priority (SBR first production client)project_slater_byrne.md memory
MSP / IT Services📋 capture-and-hold; 16-area sketchdoc 25 F167
Manufacturing📋 capture-and-hold (Doug Wood reference shape)doc 29 F175
Construction📋 capture-and-holddoc 29 F175
Healthcare📋 capture-and-holddoc 29 F175 + doc 2 §10 F11 HIPAA
Food-safety📋 capture-and-holddoc 29 F175
Medical-devices📋 capture-and-holddoc 29 F175
Pharma📋 capture-and-holddoc 29 F175
Financial-services📋 capture-and-holddoc 29 F175

Layer 13 — Operator Surfaces (Ring 4 Blueprints + Per-Deployment)

Per PLATFORM.md §Ring 4. Per-deployment + per-operator.

#SurfaceStatus
📋L13.1val-desk OpsCenter Tasks layer (recurring + one-off + single-ownership)doc 28 F167
📋L13.2val-desk OpsCenter Metrics dashboard surface (3rd primary surface)doc 28 R170 (15+ b_fact taxonomy candidates)
📋L13.3val-desk OpsCenter Initiatives layer (Mission-vocabulary surface)doc 28 R171 + ADR-007
📋L13.4val-desk Canvas mode (8 archetypes)doc 26 R156
📋L13.5val-desk client portal (read-only initially)doc 40 F270 + R277
📋L13.6Operator daily-brief blueprintsPLATFORM.md Ring 4
📋L13.7SBR debt-recovery vertical blueprintsproject_slater_byrne.md memory

Layer 14 — Cross-cutting Mechanical Enforcement

Per PLATFORM.md Phase 1.5 Cross-cutting Mechanical Enforcement.

#RuleStatusSource
🔧L14.1R1 NATS via val-node (Non-Negotiable #8)Inspector skill at runtime; needs commit/CI gatePLATFORM.md row 33 + SOUL.md NN#8
L14.2R2 Facts through val-ingest firstUnenforced; ADR-017 will lockADR-017
🔧L14.3R3 Skills via val-bay (NN#3)Partial buildtime; needs src-tauri coveragePLATFORM.md row 39 + SOUL.md NN#3
🔧L14.4R4 No hardcoded UI arrays (ARCH-166)Soft lint warning; needs build-failPLATFORM.md row 47
L14.5R5 Markdown view layer (ARCH-165)Prose-onlyCLAUDE.md ARCH-165 + ADR-010
L14.6R6 Single-tenant per deployment (NN#5)Postgres RLS enforcedPLATFORM.md row 32
L14.7R7 Latency targetsDuration recorded; no SLO checkPLATFORM.md Master Checklist
L14.8R8 Three-class fact model2-class enum currently; locked 2026-05-03 per rules/fact-taxonomy.mdrules/fact-taxonomy.md
L14.9R9 SEID atomic-universal (UUIDv7)Convention onlyPLATFORM.md Master Checklist
L14.10R10 Model stackDeclarative TOML; no enforcementd_mission-control/policies/model-stack.md
L14.11R11 Operator three meaningsProse-onlyPLATFORM.md Master Checklist

Layer 15 — Observability + Audit

#ComponentStatusSource
L15.1val-ledger b_facts audit chain (parent_fact_ids)LockedPLATFORM.md baseline + AGENTS.md
L15.2system.inspector.v1 skillLocked; clean walk = baseline lockedPLATFORM.md row 50
L15.3smoke-baseline.sh allLocked; 43/43 probe-able rows greenPLATFORM.md row 51
L15.4baseline-coral.jsonl (append-only coral log)Locked; per-row probe historyPLATFORM.md Baseline §A.0-E
📋L15.5Heartbeat watchdog observabilityb_facts emit per trigger firingADR-020
📋L15.6Engagement Core lifecycle audit6 Core lifecycle Missions emit audit b_factsADR-019
📋L15.7val-bay pulse cost ledger (LLM cost telemetry)Locked direction; full implementation pendingval-bay v2 spec §3

Layer 16 — Strategic Commitments + Vocabulary

Strategic commitments captured durably across pipeline

CommitmentSource
Business Central as System of Recorddoc 38 + operator 2026-05-11
zerotouch.ai as RMM reference (borrow-only-patterns)doc 35 + operator 2026-05-11
Mesh-default transport + NATS on-premdoc 35 F234 + operator correction 2026-05-11
ValOS-as-MDR-provider on Microsoft Defender for Businessdoc 37 + operator 2026-05-11
Bitwarden / Vaultwarden for password managementdoc 39 + operator 2026-05-11
Kopia + Duplicati both for backupsdoc 36 + operator 2026-05-11
VPS / DNS / Hosting capability (val-host engine candidate)doc 25 F167 + F168 + operator 2026-05-11
Voice / Comms own provider + carrier partnerval-switch spec + operator 2026-05-11
val-track first-party engine (work-tracking)doc 30 F181 + operator 2026-05-11
Microsoft-stack-aligned positioning (6 surfaces)doc 38 F251 + batch 5-6 commitments

Vocabulary register (operator-facing surface vs internal-architecture labels)

Operator-facing labelInternal architectureLock source
InitiativeMissiondoc 28 R171
Work Itemval-track entity (per ADR-019 candidate val-track)doc 30 F184 + R185
ApproachIdea (Problem-Solving generation stage)doc 34 Q169

Caveman tier discipline (3 tiers locked)

TierBudgetUse
Ultra≤ 50 tokWiki cards / badges / tiles / bullet digests
Full≤ 300 tokOperator chat / pulse output / status replies
Lite≤ 600 tokClient-facing text / onboarding / proposals / briefings

Substrate-Primitive Design Discipline (per doc 33 R207)

  1. Domain-driven design
  2. Don't repeat yourself (Rule of Three)
  3. Open-Closed (locked core + composition extension)
  4. Producer extends consumer super (covariance / contravariance)

Build Burn-Down Summary

Already locked (per PLATFORM.md baseline 48/48)

  • Ring 0 substrate: 4 of 8 dockers operational (postgres / openbao / nats / vllm)
  • Ring 1 HQ engines: 4 locked (val-grid / val-cargo / val-ontology / val-ledger)
  • Ring 1 device trio: 3 locked (val-agent / val-node / val-bay)
  • Ring 1 libraries: 14 locked + 5 extracted (val-skills / val-engine-config / val-registration / val-cache / val-loops / val-sidecar / val-node-runtime / val-runtime / val-dispatch) = 19 total locked
  • Ring 2 apps: val-desk locked
  • Systems + Features: 10 + 7 + 1 + 1 = 19 locked

Currently in-progress (🔧)

  • val-bay (v2 spec Phase 12 complete; Phases 3-11 pending)
  • val-agent OODA generalization + hot-reload
  • val-desk slot system + chrome chassis repackaging
  • val-switch per-channel implementations
  • val-orchestrator multi-watcher kinds + Wizard primitive
  • val-fleet (currently sim mode)
  • val-memory (full impl)

Spec'd / ADR-proposed (📋 / 🎯) — 16 ADRs drafted 2026-05-12

  • ADR-007 Missions
  • ADR-009 Inbound MCP
  • ADR-010 val-block-renderer
  • ADR-011 val-forge integration
  • ADR-012 Device provisioning
  • ADR-013 Engagement Wizard
  • ADR-014 Legacy Modernization Mission
  • ADR-015 Scenarios
  • ADR-016 Transactions
  • ADR-017 val-ingest
  • ADR-018 Marketing Automation
  • ADR-019 Context Cores
  • ADR-020 Heartbeat watchdog
  • ADR-021 caveman-shrink filter
  • ADR-022 Canvas substrate-primitive
  • ADR-023 Editor + Collaboration substrate

Net-new architectural surfaces flagged

  • val-track (first-party work-tracking engine; doc 30 commitment)
  • val-host (VPS/DNS/hosting engine candidate; doc 25 F167 commitment)
  • val-policy ABAC extension (doc 40 F269 R276)
  • Client-facing portal val-desk extension (doc 40 F270 R277)
  • Meta-Ontology subclasses for b_facts (doc 32 F201)
  • Background-curation Mission categories (doc 32 F202)
  • Hydrator pattern (doc 32 F203)
  • Dynamically-instantiated Worker roles ADR-007 variant (doc 34 F226)
  • val-policy "Computes" capability (doc 33 R210; 5th capability)
  • Walkthrough video as 3rd validation modality (doc 30 F185)
  • Fork-from-state Mission debug (doc 32 F208)
  • Caveman 4-tier extension question (Wenyan tier per doc 24)

Critical Path — Next Build Targets

Per PLATFORM.md Master Checklist update protocol + 16 ADR draft cross-locks.

Immediate (Part 1 Phase 1.2-1.3 completion)

  1. val-ingest ADR-017 — fact ingestion gateway (R2 entry gate)
  2. val-policy engine — skill governance + signing + capability binding extension (Reads/Builds/Grows/Evolves/Computes)
  3. Blueprint engine (val-fab) — manifest registry + slot resolver + widget binding
  4. val-agent OODA generalization — beyond chat-only

Near-term (ADR review windows)

  1. ADR-019 Context Cores — substrate-primitive lock (broadest cross-cutting); 12 directory archive structure
  2. ADR-020 Heartbeat watchdog — val-orchestrator background process (3 corroborations)
  3. Three-way block-schema cross-lock — ADR-010 + ADR-022 + ADR-023 coordinated review
  4. ADR-009 Inbound MCP — val-cargo gateway scope (6 Microsoft surfaces ready)

Per-vertical-engagement triggers

  1. SBR debt-recovery v1 — first production client engagement
  2. MSP-vertical scoping (post-SBR + post-first-production-stage) — MSP toolstack 5 sibling docs ready
  3. QMS base blueprint scoping (when manufacturing or construction client triggers)

Strategic / commercial-model

  1. 9 memory updates pending at next commit time (val_bay_cost_envelope / msp_vertical / opscenter_design / work_tracking_surface / editor_collaboration_substrate / palantir_competitive_intel / substrate_design_discipline / problem_solving_blueprint / business_central_sor)
  2. FORCE deck revision — substrate-ownership slide cluster (per doc 17 R91) + Microsoft-stack alignment + pricing model with Microsoft licensing pass-through

Counts + Convergence Metrics

MetricCountSource
Total research docs (2026-05-11 pipeline)40This pipeline
Total ADRs drafted (2026-05-12)16This batch
Substrate-primitive layer members10-12Per ADR adoption (b_facts × 3 + skills + blueprints + Cores + scenarios + transactions + Canvas + Editor + val-ingest)
Open-vs-locked corroborations18doc 17 §3 (5 added across batch 5-6)
Skill format convergence14 industry sourcesdoc 27 F151
Block-schema convergence15 industry sourcesdoc 31 F191
Confidence gating corroborations8doc 27 F158
Reflection-as-consolidation corroborations4doc 34 F225
Promotion-to-deterministic corroborations3doc 32 F207
Heartbeat watchdog corroborations3ADR-020
Hybrid retrieval corroborations5doc 27 F156 + doc 32 cross-cut
Substrate-primitive thesis corroborations4doc 33 F212
Engagement Wizard pattern instances8ADR-013
Cross-vertical capability layers3Marketing + QMS + Problem-Solving
Base blueprints scoped4+ Debt-recovery-AU from memory
MSP-vertical capability sketch areas16doc 25 F167
MSP-toolstack sibling docs5RMM + Backup + MDR + Password + PSA
Microsoft surfaces integrated6doc 38 F251
Production-scale customer references10+First Solar + Cisco + NASA + eBay + Intuit + Groupon + LinkedIn + KPMG + Substack + GBrain + Hivemind + etc.
Academic-grade citations2Coral arXiv 2604.01658 + Caveman March 2026 research
Competitor analysis layers4Substrate / OpsCenter-surface / Dev-factory / Editor + Collaboration substrate
Per-category strategy variants3Native-with-borrow-patterns / Integrate-with / Integrate-with-SoR
Cross-ADR couplings3+Three-way block schema (ADR-010 + ADR-022 + ADR-023); ADR-019 + ADR-020 (Cores + heartbeat); ADR-007 Missions consumed across many
Memory updates pending9Per pipeline state
Operator strategic commitments locked10+Per batch 5-6 + Business Central SoR + zerotouch.ai + mesh transport + etc.
First-party platform commitments1+val-track (doc 30) + val-host candidate
Hocuspocus external-product corroborations1Alga PSA (doc 40 F267)
Entity convergence count2Asset + Client/Company
Two secrets surfaces2OpenBao + Bitwarden/Vaultwarden
Reserved doc 17 §3 corroborations5+MSP / Wazuh / RMM / Backup / EDR / Password / PSA / val-track (when MSP scopes)

Update Protocol

  1. When a checklist item flips state (❌ → 📋 → 🎯 → 🔧 → ✅), update this section + commit with message referencing the item.
  2. When a layer fully completes (all items ✅), lock it via memory entry; do not unlock without explicit operator approval.
  3. ADR status flips:
    • 🎯 → 🔧 when ADR draft accepted + scoping begins
    • 🔧 → ✅ when ADR-locked surface is built + production-ready
  4. Memory updates pending at every commit window — apply when commits batch.
  5. Layer-level completeness gates same as PLATFORM.md (Layer N green before Layer N+1 advances where dependency exists).
  6. Cross-doc updates from research pipeline flow into this checklist (b_fact taxonomy / Core archive directories / dispatch patterns / capability counts / etc.).

Companion Documents

DocumentPurpose
v_platform/PLATFORM.mdArchitectural picture + baseline live status (48/48 rows locked) + Master Checklist Part 1 + Part 2
v_platform/IDENTITY.mdWho this deployment serves (per-deployment)
v_platform/SOUL.mdWhat ValOS IS (universal)
v_platform/AGENTS.mdHow Val behaves per session (universal)
CLAUDE.mdCowork dev rules (Cowork-only; not shipped)
valos-reference.mdLocked reference (engines + capabilities + vocabulary)
16 ADR drafts (d_mission-control/specs/adr-NNN-*.md)Architectural decisions
40 research docs (d_mission-control/research/2026-05-11.*.md)Pipeline depth surfaces
3 rules (d_mission-control/rules/)Architecture-layers / fact-taxonomy / OODA-pattern
2 policies (d_mission-control/policies/)Model-stack / voice-substrate
9 existing specs (d_mission-control/specs/)Engine + feature specs

Master vertical fusion checklist — Cowork-side composition. Companion to PLATFORM.md baseline. Status reflects pipeline state 2026-05-12 (post-batch-5 commit + 16 ADR drafts).