Product Plan — April 2026

Nexus — Sovereign Process Orchestration

A no-code visual process orchestration platform that competes directly with N8N and Make.com — more flexible, more powerful, and built to run sovereign. Any graph. Any data model. Any scale. Four levels of resolution from enterprise workflow down to a single field validation rule. RBAC-governed forms, GPU-accelerated transformations, and a graph database at the core.

Nexus, formerly known as Nexus. Nexus is the name of the rule engine component at the core of Nexus. The product was formerly named Nexus before it absorbed Nexus canvas and orchestration capabilities and took the Nexus name. The backend engine repo remains named nexus/. All product documentation refers to Nexus.

01 — Competitive Position

N8N and Make.com are trigger-action workflow tools. They wire API calls together. They have no concept of a data model, no rule engine, no entity classes, no property-level constraints. When a workflow gets complex, users work around the tool with code nodes and external databases. The tool becomes scaffolding for custom code.

Nexus is not a trigger-action tool. It is a graph-native sovereign process orchestration platform with a four-resolution data model at its core. The graph is the execution model. Every Nexus deployment can run fully on-premises with no cloud dependency and no data egress.

DimensionN8N / Make.comNexus
Core model Trigger → Action chains Typed, rule-governed entity graphs executed as pipelines
Data model JSON blobs passed between steps. No schema enforcement. Four-scale model: Workflow → Class → Property → Rule. Defined once, enforced everywhere.
Rule engine None. Code nodes or external service. Nexus rule engine as native node. 409+ rule primitives. GPU-accelerated bulk validation.
Form generation None. Use Typeform/Airtable externally. ChameleonV2 Form node: schema → form auto-generated. RBAC-governed field visibility. deltaPrism business data type controls on every field. Flow-level styling and per-role variants.
Data store None. External DB required. deltaPrism graph DB as native Store node. Warehouse, ingestion/egress, and GPU-accelerated mid-pipeline transformation — all in one component.
Deployment Cloud-only (Make.com) or self-hosted Docker (N8N, constrained). Fully sovereign. All components self-hosted. Air-gap capable. No cloud account required.
Resolution One level: the workflow canvas. Four levels: Macro (workflow), Micro (class), Nano (property), Pico (rule). Navigate between them without leaving the UI.
Multi-tenancy Partial workspace isolation. Full Org / Team / User / API key model. Per-org pipeline isolation. Built in from day one (M-NEXUS-F1 complete).

02 — The Four Scales

Every Nexus entity and process exists at one of four resolution levels. The canvas is aware of all four. A user can drill into any node and descend to the next level, or navigate up and see the workflow context. The entire system — from a high-level pipeline down to a single field validation constraint — is navigable without leaving the Nexus UI.

Scale 1
Macro
Workflow
Top-level view. A workflow is a directed graph of typed nodes — the main canvas. Nodes represent pipeline stages: Form, OCR, Validate, Store, Forward, Transform, AI, HTTP, and more. Edges carry typed data. Workflows are saved, versioned, activated, and executed here.
Example: “ENDO Irena Document Pipeline” — 5 connected nodes from Form intake to Email forward.
Scale 2
Micro
Class
Zoom into any node and see the entity classes it operates on. A class is a named, typed entity definition — the schema level. Classes have fields, relationships, cardinality, and lifecycle stages. ChameleonV2 reads a class definition and renders the intake form.
Example: “Document” class with fields: FileName, Category, UploadDate, ExtractedData, ValidationStatus.
Scale 3
Nano
Property
Zoom into any class and see its properties. Each property has a name, deltaPrism business data type, required flag, default, display label, format constraints, and RBAC visibility rules. Changes here cascade up to forms and down to rules.
Example: “Category” property — type enum, required, values: [Invoice, Contract, ID, Medical], hidden from “Submitter” role.
Scale 4
Pico
Rule
Zoom into any property and see the rules that govern it. Nexus rule engine layer: validation rules, transformation rules, cross-field constraints, and precedence rules. Rules execute on CPU or GPU depending on dataset size and node configuration.
Example: Rule R-0042 — “If Category = Invoice then Amount must be numeric and positive.”

The breadcrumb always reads Workflow / Node / Class / Property / Rule. Every level is its own graph. At Macro, the graph is nodes and edges. At Micro, it is classes and relationships. At Nano, properties and their dependencies. At Pico, rules and their precedence chains. Esc or breadcrumb navigation returns to the parent level.

03 — ChameleonV2: RBAC-Governed Form Engine

ChameleonV2 is a first-class Nexus component, developed in parallel with the platform. It is not a generic form library — it is a schema-aware, RBAC-governed, deltaPrism-typed form rendering engine that is tightly coupled to the Nexus data model.

When a Form node in a pipeline is executed, ChameleonV2 receives the Micro-scale class definition, the active RBAC role of the submitting user, the flow-level styling configuration, and the deltaPrism business data type constraints for each property. It renders the appropriate form variant in real time. No custom form code is ever written.

Schema Pull from Form Node

The Form node configuration specifies a class reference (by org slug + class ID from the Nexus pipeline API). At runtime, ChameleonV2 fetches the class definition and renders fields in property order. Field types, labels, required flags, enum values, and validation messages are all derived from the Nano-scale property definitions. The form re-renders automatically when the underlying class definition changes — no manual form maintenance.

RBAC Control Layer

Each user has a role within their org (defined at Org/Team level, M-NEXUS-F1). ChameleonV2 applies RBAC rules at render time to produce a role-specific form variant:

RBAC BehaviourWhat it controlsWhere defined
Field visibility A property can be visible to some roles and hidden from others. A “Submitter” sees the intake fields; a “Reviewer” sees additional metadata fields; an “Admin” sees all fields including computed and audit fields. Nano-scale property definition — rbac_visibility map per role
Field editability A property can be read-only for some roles and editable for others. Prevents submitters from overriding validated or computed values. Nano-scale property definition — rbac_editable map per role
Required flag override A field can be required for one role (e.g., Reviewer must fill “ApprovalNote”) but optional or absent for another. Nano-scale property definition — rbac_required map per role
Form variant Each role gets a distinct form layout: field order, section grouping, and step count can differ. A Submitter sees a 3-step wizard; a Reviewer sees a single-page summary with action buttons. Micro-scale class definition — rbac_variants layout map
Enum option filtering Dropdown options can be filtered by role. A standard user cannot select “Escalate”; only a Supervisor role can. Nano-scale property definition — rbac_options filter per role

deltaPrism Business Data Types

Every Nano-scale property carries a deltaPrism business data type (BDT) in addition to its primitive type. The BDT controls how ChameleonV2 renders and validates the field:

BDT: Currency
Monetary Amount
Renders with currency symbol, decimal precision enforcement, min/max guardrails from deltaPrism type definition. Validation fires before submission.
BDT: Document Reference
File Upload
Renders as file upload with allowed MIME types, max size, and optional OCR auto-fill. On upload, triggers Atlas OCR node inline and pre-populates extracted fields.
BDT: Entity Link
Relationship Picker
Renders as a searchable dropdown populated by a live query to deltaPrism. Allows the user to link the submitted entity to an existing entity in the graph.
BDT: Geo
Location Field
Renders with map picker or address autocomplete. Stores as normalised coordinate + address object. Validation checks against country/region enum from deltaPrism type.
BDT: Computed
Read-Only Derived
Never rendered as an input. Displays the computed value from the Pico-scale rule result, formatted per the BDT display mask. Always read-only regardless of RBAC role.
BDT: Classification
Governed Enum
Enum whose allowed values are managed in deltaPrism as a named classification list. The form always reflects the current list — no hardcoded option arrays in the form definition.

Flow-Level Styling

The Form node configuration includes a style_ref pointing to a style definition stored in the pipeline definition. ChameleonV2 reads this at render time and applies it as a CSS token override layer over the base theme. This means:

Per-Pipeline Branding
A Nesto pipeline can render a worker intake form in UAE labour authority colours. An ENDO Irena pipeline uses Pryzmat Media brand colours. Both use the same ChameleonV2 component — styling is configuration, not code.
Multi-Tenant White-Label
Each org can define its own style definition. A Nexus MSP deployment presents each client with their own branded forms from a single Nexus instance. No separate deployments required.
Development Status

ChameleonV2 is at v1.2.2 (chameleonv2/). The current package is a schema-driven form renderer. RBAC layer, BDT integration, flow-level styling, and role variants are milestone targets defined in this plan (M-NEXUS-CV-1 through M-NEXUS-CV-4).

04 — deltaPrism: Data Platform

deltaPrism is not a passive store. It is the active data platform layer of Nexus. It operates in three modes simultaneously within any given pipeline, and its role expands as pipelines grow in complexity.

Mode 1: Warehouse
Store validated entities Entity relationship graph Query by class / property / relationship Audit trail per entity Version history
Mode 2: Data Source
Ingestion node: CSV / JSON / API pull Egress node: push to downstream system Standalone source for pipelines without an upstream form Scheduled batch ingest CDC (change data capture) trigger
Mode 3: GPU Transform
Mid-pipeline intermediate state Nexus schema-driven transform definitions Pico-rule sets applied at GPU speed cuDF columnar execution (RAPIDS) Chained transform steps without round-trips Output: enriched entity written back to warehouse

Mode 1: Warehouse & Storage Layer

The Store node in any pipeline writes validated entities to deltaPrism. Entities are typed by their Micro-scale class definition. Relationships between entities (worker → document, client → project, invoice → bank entry) are first-class edges in the graph. Any downstream node in the same or a different pipeline can query these entities by class, property value, or relationship traversal.

Mode 2: Ingestion & Egress

deltaPrism acts as a standalone data source when a pipeline does not begin with a form submission. An ingest node pulls data from a CSV file, a JSON API endpoint, a database table, or a scheduled batch source. deltaPrism normalises the incoming data against the target class schema, applies property type coercions, and makes the result available to the next pipeline node. On the egress side, a deltaPrism egress node pushes entity data to an external system — a government API, a CRM, an invoice system — in whatever format the downstream system requires.

Mode 3: GPU-Accelerated Mid-Pipeline Transformation

When a pipeline contains multiple transformation operations in sequence, deltaPrism can take over the transformation layer entirely. Instead of routing data through the Nexus rule engine for each step, the pipeline hands off the intermediate dataset to deltaPrism, which:

1
Loads the Nexus schema definition for the entity class being transformed (Micro + Nano + Pico scales).
2
Compiles the applicable Pico-rule set into a cuDF execution plan. Rules are converted to columnar operations on the dataset.
3
Executes the full rule chain on GPU in a single pass. Validation, transformation, derived value calculation, and cross-field constraint checking all happen in one vectorised operation.
4
Writes enriched entities back to the warehouse atomically. The pipeline receives a reference to the completed result set and advances to the next node.

This is the mechanism that made EXP-4 viable: 21,327 entities validated and written at 21ms/entity using the bulk-concurrent adapter. The GPU transform mode extends this to arbitrary multi-step transformation chains — all processed without leaving deltaPrism.

Business Data Types

deltaPrism maintains the authoritative registry of business data types (BDTs) for the deployment. BDTs are named type definitions that extend primitive types with domain-specific constraints: allowed ranges, format masks, normalisation functions, and display renderers. When ChameleonV2 renders a form field, it fetches the BDT from deltaPrism and applies the constraints client-side. When the rule engine validates a submission, it checks the same BDT server-side. The constraint definition lives in one place and is consumed by both layers consistently.

05 — Technology Stack

LayerTechnologySource / RepoRole in Nexus
Rule Engine Python (FastAPI) + SQLite / PostgreSQL nexus/ Validation, transformation, profile-governed rules. Exposed as Nexus Rule Engine node type.
Canvas UI HTML5 Canvas + vanilla JS (absorbed from Nexus) nexus/static/pipeline_flow.html Pipeline builder and live execution visualiser. Upgraded to call Nexus pipeline API.
Form Engine React + TypeScript (npm package) chameleonv2/ (chameleonv2 v1.2.2) Schema-driven RBAC-governed form renderer. Pulls class definition from Nexus Form node. Applies deltaPrism BDT constraints, flow-level styling, and per-role form variants. Zero custom form code.
Data Platform deltaPrism graph DB + GPU transform engine deltaPrism/ Three modes: (1) warehouse for validated entities, (2) standalone ingestion/egress data source, (3) GPU-accelerated mid-pipeline transformation engine (cuDF / RAPIDS). BDT registry. Port 15000.
Orchestration API FastAPI — routes_orgs.py, routes_pipelines.py nexus/nexus/api/ Multi-tenant CRUD for orgs, pipelines, node types, runs. Already built (M-ORCH-1 + M-ORCH-2 complete).
Admin Panel Flask + SQLite (admin.db) nexus/admin/ User, API key, and profile management. Co-exists with orchestration API.
Telemetry RunTracer (Python) + SSE stream nexus/core/run_tracer.py Per-node CPU/RAM/IO telemetry pushed to canvas in real time during execution.

06 — Use Cases

Three concrete deployments drive the product roadmap. Each is a real system, real data, real org. They are not hypothetical scenarios. Building Nexus means making each of these run end-to-end.

Nesto
Worker Onboarding

UAE employment agency. Onboards migrant workers from 3 source countries (PH, IN, PK). Each worker requires a compliance document bundle: passport, medical certificate, skills certification, and country-specific government portal registration. Manual today. Target: fully orchestrated.

1
Schema node: Worker entity — name, nationality, visa type, document checklist
2
Form node (ChameleonV2): Auto-generated intake form deployed to worker portal
3
OCR node (Atlas): Passport + certificates scanned, fields extracted
4
Validate node (Nexus): EDR-style rules check completeness, date validity, country track compliance
5
Store node (deltaPrism): Validated worker entity written to graph DB
6
Forward node: Government API registration (MoHRE Work Bundle / eMigrate / FEIMS / POLO)
Repo: nesto/ — Pipeline milestones: M-NEXUS-UC1-1 through M-NEXUS-UC1-3
ENDO AI
AI Employee Deployment

Polish AI automation SaaS by Pryzmat Media. Deploys three AI employees for SMBs: Marcin (Sales & SMS), Irena (OCR & Documents), Przemek (Voice & Analytics). Each is a Nexus pipeline. Deploying a new client means configuring and activating the relevant pipeline — no bespoke code.

1
Marcin pipeline: SMS intake → Nexus qualify node → slot booking → CRM Forward
2
Irena pipeline: Document upload form (ChameleonV2) → OCR node → Categorise → Email Forward
3
Przemek pipeline: Voice note ingest → Transcribe → Summarise → CEO briefing Forward
Repo: endo/ — Pipeline milestones: M-NEXUS-UC2-1 through M-NEXUS-UC2-3
ARC
Revenue & Client Pipeline

Freelance/consultancy CRM at arc/. Next.js 14 + FastAPI + Claude agent + PostgreSQL. ARC manages the full lifecycle from lead to invoice. The AI agent (Claude) drafts emails, scores offers, generates invoices. Nexus orchestrates the data flows that the ARC agent acts on: email indexing, offer generation, invoice matching, bank import.

1
Email ingest pipeline: Gmail fetch → Index node → Sentiment validate → Store (ARC PostgreSQL)
2
Offer pipeline: Project schema form → AI Transform (Claude) → PDF Forward
3
Invoice pipeline: Bank CSV ingest → Match validate → Tax report Forward
Repo: arc/ — Pipeline milestones: M-NEXUS-UC3-1 through M-NEXUS-UC3-2

07 — Roadmap

Phase 1: Foundation (complete)

IDNameStatusWhat it delivers
M-NEXUS-F1 Multi-Tenant Foundation COMPLETE Org / Team / User / API key models + full CRUD API. 34 tests passing.
M-NEXUS-F2 Pipeline Definition Engine COMPLETE Pipeline / NodeType / PipelineRun models + API. Draft / active / run states. 34 tests passing.

Phase 2: Canvas (backend complete, UI not started)

IDNameStatusWhat it delivers
M-NEXUS-C1 Canvas API Integration BACKEND ONLY API: GET /pipelines/{id}/canvas/{scale} exists. pipeline_flow.html in nexus/ has NOT been wired to this API. No UI connection. Canvas absorb = NOT STARTED.
M-NEXUS-C2 Node Registry — 16 Built-in Types BACKEND ONLY 16 node types registered in NodeType registry (DB seeded). Palette exists in DB. No canvas UI rendering these types. Palette UI = NOT STARTED.
M-NEXUS-C3 Four-Scale Canvas Navigation BACKEND ONLY Backend: GET /pipelines/{id}/canvas/{scale} (scale = macro|micro|nano|pico). 11 tests passing. No UI consuming this. Four-scale navigation in canvas = NOT STARTED.

Phase 3: Execution (backend complete, canvas not started)

IDNameStatusWhat it delivers
M-NEXUS-E1 Pipeline Execution Engine COMPLETE Topological-order graph walker. Per-node status written to PipelineRun. RunTracer SSE stream feeds canvas. Blocking and async node execution modes.
M-NEXUS-E2 deltaPrism Store + Ingest + Egress Nodes COMPLETE Store node (entity write), IngestNodeExecutor (CSV/JSON/API pull → schema-normalised entities), EgressNodeExecutor (entity → HTTP/CSV/JSON push). Registered in REGISTRY. 11 tests passing.
M-NEXUS-E3 deltaPrism GPU Transform Mode COMPLETE GpuTransformNodeExecutor: submits entity dataset to deltaPrism POST /gpu/transform. Falls back to CPU rule engine when GPU instance unreachable (fallback_to_cpu=True). GpuTransform + GpuTransformNode in REGISTRY. 5 tests passing.

Phase 4: ChameleonV2 Full Integration

IDNameStatusWhat it delivers
M-NEXUS-CV-1 ChameleonV2 Schema Pull from Form Node BACKEND ONLY Backend API: GET /pipelines/{id}/nodes/{node_id}/schema exists. 8 tests passing. ChameleonV2 package at chameleonv2/ has NOT been connected to this endpoint. UI integration = NOT STARTED.
M-NEXUS-CV-2 ChameleonV2 RBAC Layer BACKEND ONLY Backend API: GET /pipelines/{id}/nodes/{node_id}/schema?role={role} exists. 5 tests passing. ChameleonV2 RBAC rendering = NOT STARTED.
M-NEXUS-CV-3 ChameleonV2 deltaPrism BDT Integration BACKEND ONLY Backend API: GET /pipelines/{id}/nodes/{node_id}/bdt/{field}/options exists. 7 tests passing. ChameleonV2 BDT render-time fetch = NOT STARTED.
M-NEXUS-CV-4 ChameleonV2 Flow-Level Styling BACKEND ONLY Backend API: GET/PUT /pipelines/{id}/style exists. Pipeline model has style_tokens column. 6 tests passing. ChameleonV2 consuming style tokens = NOT STARTED.

Use Case Sprints (Sprints 4–6)

IDNameUse CaseStatus
M-NEXUS-UC1-1 Nesto Worker Document Pipeline Nesto NOT STARTED Nesto Government API Forward Nodes Nesto NOT STARTED
M-NEXUS-UC1-3 Nesto Multi-Country Compliance Rules Nesto RULES ONLY
M-NEXUS-UC2-1 ENDO Marcin Lead Qualification Pipeline ENDO NOT STARTED
M-NEXUS-UC2-2 ENDO Irena Document Lifecycle Pipeline ENDO NOT STARTED
M-NEXUS-UC2-3 ENDO Przemek CEO Briefing Pipeline ENDO NOT STARTED
M-NEXUS-UC3-1 ARC Email Ingest + Offer Pipeline ARC NOT STARTED
M-NEXUS-UC3-2 ARC Invoice + Bank Matching Pipeline ARC NOT STARTED

08 — Platform Features

Pipeline Switcher

The top-level Nexus menu contains a Pipeline Profile Switcher: a dropdown that lists all saved pipeline profiles available to the active org. Selecting a profile loads its full graph into the canvas — including node configuration, class definitions, and style. Profiles are independently deployable, independently runnable, and independently observable. Switching between Nesto, ENDO Marcin, and ARC Invoice happens in one click with no page reload.

Real-Time Canvas Execution Visualisation

During any pipeline run the canvas updates live via SSE. Each node transitions through visual states:

StateVisualMeaning
IdleDim border, no glowNode not yet reached in this run
WaitingAmber pulseNode queued — dependency not yet complete
RunningBlue glow, spinning indicatorNode actively executing
Awaiting HumanPurple pulseRBAC gate: waiting for role actor to act
CompleteGreen fill, data packet animation along outgoing edgeNode finished, output passed to next node
FailedRed border, error badgeNode threw error — run halted, error surfaced in log panel

Data packet animations travel along edges showing the live flow of data between nodes. Hovering a completed node shows: execution time, input entity count, output entity count, and a link to the run log entry for that node.

Run Tracking and Logging

Every pipeline run produces a structured, queryable log:

Run Log
Per-Run Audit Record
Run ID, pipeline ID, org slug, triggered by (user or scheduler), start time, end time, status, total entities processed, error message if failed.
Node Log
Per-Node Step Record
Node ID, node type, start time, duration ms, input payload reference, output payload reference, rule results (pass/fail per rule), validation errors if any.
Entity Log
Per-Entity Trace
Entity ID, class name, every transformation applied to it in the pipeline, validation result per field, which run produced the entity, full field-level diff.

The log viewer is a panel accessible from the canvas. It shows the run log for the active pipeline, filterable by date range, status, and entity class. Full-text search across all log fields. Export to JSON or CSV. Each log entry links back to the canvas run replay.

Phase 5 Roadmap Milestones

IDNameStatusDeliverable
M-NEXUS-P1Pipeline Profile SwitcherBACKEND ONLYBackend: GET /pipelines?org_slug=... exists. Frontend switcher = NOT STARTED.
M-NEXUS-P2Real-Time Canvas Execution VisualisationNOT STARTEDBackend: SSE stream exists. Canvas consuming SSE = NOT STARTED. No live visual updates in any UI.
M-NEXUS-P3Run Log ViewerBACKEND ONLYBackend: GET /pipelines/runs/{run_id}/node-logs exists. Frontend log panel = NOT STARTED.

09 — Autonomous Demo

Demo Mode: C (Autonomous Default + Interactive Flag)

Decision confirmed 2026-04-18. The demo runs in two modes:

Autonomous Mode (default)
Fully Hands-Off
Demo runner seeds all data, submits all forms, provides all document uploads, auto-advances all RBAC gates with pre-seeded role decisions. Runs start to finish unattended. Command: python demo_runner.py --pipeline nesto. Produces a complete run log on completion.
Interactive Mode (--interactive)
Live Presentation
Pipeline runs autonomously up to each RBAC role gate, then pauses and displays the ChameleonV2 form for that role in a browser. A human actor playing that role interacts with the form. Demo runner detects the submission and advances. Command: python demo_runner.py --pipeline nesto --interactive.

Demo Infrastructure Requirements

ComponentDemo RequirementMilestone
Demo SeederScript that creates org, teams, users (one per RBAC role), pre-loads schema definitions, pre-loads node type registry, and seeds sample entities for each pipeline.M-NEXUS-D0
Demo RunnerPython script that drives a full pipeline run: submits forms, uploads sample documents, resolves RBAC gates (autonomous) or pauses for human (interactive).M-NEXUS-D1
Sample DataPer-pipeline fixture files: Nesto worker record + 3 document scans; ENDO Irena document batch + Marcin SMS leads + Przemek voice file; ARC email batch + bank CSV.M-NEXUS-D2
Reset ScriptResets demo to clean state: drops run history, removes seeded entities from deltaPrism, re-runs seeder. Idempotent.M-NEXUS-D3

Nesto Demo: UAE Worker Onboarding

Full lifecycle: worker created → documents uploaded → OCR extracted → validated → HR review → approved → government API notified

1
[HR Admin — ChameleonV2 Form] Create worker record: Name, Nationality (PH), VisaType (Employment), PassportNumber. RBAC: only HR Admin role can create.
2
[Worker — ChameleonV2 Form, Submitter variant] Upload documents: Passport scan, Medical Certificate, POLO Clearance Certificate. BDT: Document Reference fields, OCR auto-fill on upload.
3
[Atlas OCR Node] Passport: extract Surname, GivenName, DOB, ExpiryDate, PassportNumber. Medical: extract IssueDate, ExpiryDate, HospitalRef. POLO: extract ClearanceDate, ExpiryDate.
4
[Nexus Validate Node] Run rules: passport not expired, medical within 12 months, POLO within 6 months for PH nationals, all required fields present. Result: PASS or FAIL with per-field error list.
5
[deltaPrism Store Node] Write Worker entity with all validated fields and document relationships to graph DB.
6
[HR Manager Review — ChameleonV2 Form, Reviewer variant] Simplified decision form: validation summary panel, document thumbnail grid, compliance status per document, decision field (Approve / Reject / Request More Info), optional note. RBAC gate: pauses in interactive mode.
7
[deltaPrism Store Node] Record HR Manager decision, decision timestamp, reviewer ID against worker entity.
8
[Notify Node] Push notification to worker: approval status, next steps, reference number. Email + SMS.
9
[Forward Node × 3] On approval: MoHRE Work Bundle API, eMigrate registration (if IN), POLO confirmation (if PH). Canvas shows all 3 forward nodes green. Run complete.

RBAC roles seeded: Worker (Submitter), HR Admin, HR Manager, Compliance Officer (view-only). Full run: ~45 seconds autonomous. See: NEXUS_USECASE_NESTO.html

ENDO Demo: Three AI Employee Pipelines

Three independently switchable pipelines, all deployable to the same org in one demo.

PipelineTriggerKey NodesRBAC GateOutput
MarcinSMS lead ingestSMS Ingest → ChameleonV2 Lead Form → Nexus Qualify → Schedule → SMS Reply → StoreNone (fully autonomous)Appointment booked, CRM entry created
IrenaDocument uploadChameleonV2 Upload Form → Atlas OCR → Nexus Categorise → Store → Email ForwardLow-confidence: Reviewer approves categoryDocument categorised, filed, email sent
PrzemekVoice note fileVoice Ingest → Transcribe → AI Transform (Claude) → CEO Briefing Form → Approve → ForwardCEO confirms briefing before sendAction items distributed to team

See: NEXUS_USECASE_ENDO.html

ARC Demo: Revenue & Client Pipeline

Three pipelines converted from ARC repo flows into Nexus nodes.

PipelineSource Flow (ARC)Nexus NodesRBAC Gate
Email Ingestarc/backend/services/email_service.pyGmail OAuth Ingest → Index → AI Sentiment → Store (deltaPrism + ARC PostgreSQL)None
Offerarc/backend/agent/ Claude drafting flowChameleonV2 Project Form → AI Transform (Claude draft) → Freelancer Review → PDF ForwardFreelancer approves draft
Invoice Matcharc/backend/services/bank_service.pyBank CSV Ingest → Transform → Nexus Match Validate → Store → Tax Report ForwardNone

See: NEXUS_USECASE_ARC.html

Demo Phase Roadmap

IDNamePipelineStatus
M-NEXUS-D0Demo seeder + reset scriptAllCLI ONLY
M-NEXUS-D1Demo runner (autonomous + interactive flag)AllCLI ONLY
M-NEXUS-D2Sample data fixtures (3 pipelines)AllNOT STARTED
M-NEXUS-D3Nesto worker onboarding demo (9-step)NestoNOT STARTED
M-NEXUS-D4ENDO Marcin lead qualification demoENDONOT STARTED
M-NEXUS-D5ENDO Irena document lifecycle demoENDONOT STARTED
M-NEXUS-D6ENDO Przemek CEO briefing demoENDONOT STARTED
M-NEXUS-D7ARC email ingest + offer demoARCNOT STARTED
M-NEXUS-D8ARC invoice + bank match demoARCNOT STARTED

10 — Open Decisions

These decisions gate specific development paths. All other work continues in parallel.

IDDecisionOptionsBlocks
D-05 ARC demo: Claude API integration RESOLVED — A: Real Claude API key. Real AI output in all demos (ARC offer, ENDO lead qualification, email sentiment). Unblocked. BL04, BL06 ready to implement.
D-06 ENDO org structure RESOLVED — A: Single Nexus org, 3 pipelines (Pryzmat Media). All 3 AI employees (Marcin, Irena, Przemek) within one org. Demo seeder: 1 org + 5 RBAC users. Pipeline profile switcher demonstrates multi-pipeline capability. Unblocked. D4, D5, D6 demo paths unblocked. M-NEXUS-D0 seeder: 1 org.
D-07 Nesto government forward nodes RESOLVED — B: Mock HTTP Forward nodes (log payload, return 200 OK). No real UAE API sandbox required for demo. Unblocked. BL03, BL05 ready to implement.
D-08 Nesto/ENDO SMS gateway RESOLVED — B: Mock SMS node (log payload, display in canvas run view). No real gateway required for demo. Unblocked. BL02, BL09 ready to implement.
Current Position — 2026-04-18

M-NEXUS-F1 and M-NEXUS-F2 complete and pushed (fafb688). Next: M-NEXUS-C1 — absorb canvas, wire to pipeline API.

Codebase: nexus/ — branch: feature/pfp-pyrometrix — Full docs suite: index.html

11 — Development Status Audit — April 2026

This section is the honest record of what is built vs. what was falsely claimed complete. Full analysis: NEXUS_ACTION_PLAN.html.

CategoryItemActual StatusEvidence
BackendRule engine (Nexus core)COMPLETE1,394 tests total (1,256 passing, 98 env/AWS skipped, 40 skipped). EDR, BDT, profiles, pfp, executors covered.
BackendMulti-tenant foundation (F1, F2)COMPLETEOrg/Team/User/API key CRUD. Pipeline definition engine. Full test coverage.
BackendExecution engine (E1, E2, E3)COMPLETETopological walker, SSE stream, IngestNodeExecutor, EgressNodeExecutor, GpuTransformNodeExecutor. Tested.
Backend APICanvas APIs (C1, C2, C3)BACKEND ONLYAll 3 endpoints exist and are tested. No UI consuming them.
Backend APIChameleonV2 APIs (CV-1 to CV-4)BACKEND ONLYAll 4 endpoints exist and are tested. ChameleonV2 package (chameleonv2/) not connected.
Backend APIPlatform APIs (P1, P2, P3)BACKEND ONLYSwitcher, SSE, log viewer APIs exist. No frontend consuming them.
CLIDemo seeder (D0)CLI ONLYscripts/seed_nexus_demo.py seeds DB. Terminal only. No UI state.
CLIDemo runner (D1)CLI ONLYscripts/nexus_demo_runner.py triggers runs via API. Terminal output only. No canvas, no interactive mode.
NOT BUILTCanvas UI (nexus/)NOT STARTEDpipeline_flow.html was never wired to the Nexus pipeline API. Separate repo. Not started.
NOT BUILTChameleonV2 connectionNOT STARTEDChameleonV2 npm package (v1.2.2) has never been connected to any Nexus API endpoint.
NOT BUILTSample document fixtures (D2)NOT STARTEDNo fixture files exist in scripts/fixtures/ or anywhere in the repo.
NOT BUILTAll use case demos (D3–D8, UC1–UC3)NOT STARTEDUse case pipelines have no end-to-end runner, no real data, no interactive demo mode.