01 Core Principle — This Is Not a Show
What is forbidden: A modal popup that simulates typed text over a frozen screen. A "theatre" that plays fake animations independently of the actual interface. Any overlay that masks the real UI with invented data. Prerecorded sequences. Placeholders.
What autonomous demo mode is: The actual interface, running under programmatic control. Every click, every field fill, every node placement, every pipeline run is performed through the real DOM — the same paths a human user would take, at a speed and with precision that demonstrates the system's capabilities. The canvas you see is the real canvas. The data created is real data. The flow that runs is the real engine executing a real pipeline. The demo ends in a real completed state that could be exported, handed over, or continued manually.

02 All Four Orchestration Levels

The demo must traverse all four orchestration levels in sequence, creating entities at each level before descending to the next. A viewer watching the demo should understand, without narration, that Nexus handles organisational structure, team structure, user assignment, and execution flow as a unified hierarchy.

Level 1 — Organisation
Org + Team Setup
Create the organisation entity. Name it. Assign an industry vertical (e.g. UAE Compliance / Worker Onboarding). Set org-level metadata: jurisdiction, active, primary contact. Create one team under the org: Compliance Operations.
Level 2 — Users + RBAC
Users + Role Assignment
Create three users with distinct roles: Submitter (data entry), Validator (compliance review), HR Manager (decision authority). Each user gets a profile card. RBAC matrix is populated from role definitions, not hand-configured. Field visibility per role is auto-derived from the data schema.
Level 3 — Data Model
Schema + Template Selection
Select a data template (Worker Onboarding). System proposes required fields based on template knowledge: personal data, document identifiers, compliance flags. User confirms field list. Schema is created. Node types for each data shape are auto-registered in the canvas palette.
Level 4 — Pipeline
Flow + Execution
Canvas opens blank. Nodes are placed one by one (form_ingest, ocr, validate, store, hr_gate, sms_reply, api_forward). Edges are connected. Minimum-click run is triggered. Each node executes. Forms are shown with RBAC-appropriate styling per role. Pipeline completes. Result is exportable.

03 Full Demo Sequence — Step by Step

Each step is performed by the autonomous mode controller via real UI interactions (programmatic click, focus, input events). The canvas and all panels remain visible and interactive throughout. The sequence runs at a pace optimised for comprehension, not speed — roughly 18–25 seconds per level, 90 seconds total end-to-end.

  1. Reset to blank state
    AUTO Canvas is cleared. Any existing nodes are removed. Org selector resets. A progress indicator appears in the toolbar: AUTO MODE — STEP 1 / 9. This communicates to any observer that an autonomous sequence is running.
  2. Create Organisation — Nesto Industries
    USER PANELAUTO-FILLED A slide-in panel opens (using the existing #class-panel infrastructure or a new entity panel). Title: NEW ORGANISATION. Fields animate in with the data template intellisense pattern: system detects "organisation" type, pre-proposes: Name, Industry, Jurisdiction, Status, Primary Contact. Fields are filled character-by-character. Values: Nesto Industries LLC / UAE Compliance / AE / Active / m.khalil@nesto.ae. Panel saves. Org appears in the org selector dropdown.
  3. Create Team — Compliance Operations
    USER PANELAUTO-FILLED New entity panel: NEW TEAM under Nesto Industries. Template-suggested fields: Team Name, Parent Org, Function, Member Cap. Filled: Compliance Operations / Nesto Industries LLC / Worker Compliance / 12. Saved. Team node appears as a data card on the canvas at Level 1 position (top-left region).
  4. Create Three Users with Roles
    USER PANELRBACAUTO-FILLED Three sequential user creation panels open and close. For each user, the system detects "person + role" data shape and proposes: Full Name, Email, Nationality, Role, Team. Roles are selected from the pre-defined role registry (Submitter / Validator / HR Manager). The RBAC matrix is automatically populated from the role definition — field visibility, editability, and required status for every schema field is auto-derived without manual configuration. Three user cards appear in the canvas Level 2 region.
  5. Select Data Template — Worker Onboarding
    DATA MODELINTELLISENSE A template picker opens. Categories shown: Personal Data / Compliance Documents / Financial / Logistics / Custom. User selects Worker Onboarding (UAE). System immediately proposes the canonical field list: First Name, Last Name, Nationality, Passport Number, Emirates ID, Occupation, Employer, Medical Status, POLO Exemption Flag, Compliance Status. Each field has a pre-assigned data type. User can add, remove, or rename fields — but in auto mode, the default set is confirmed in 1.2 seconds. Schema is created. Node type palette updates with a new WorkerProfile type available for placement.
  6. Build Pipeline on Canvas
    AUTOCANVAS Nodes are placed one by one with smooth position animations. Each node appears, its config panel briefly opens, key fields are shown, then closes. Sequence: form_ingest (Submitter role, WorkerProfile schema) → ocr_verify (document check) → validate_compliance (rule set: nesto_worker_docs) → store_worker (writes to registry) → hr_gate (HR Manager role, Reviewer form) → sms_notify (compliance confirmation) → api_forward (MoHRE + GDRFA endpoints). Edges drawn between nodes one at a time. Pipeline structure matches the Nesto use case spec.
  7. Run Pipeline — One Click
    EXECUTEAUTO The RUN button is clicked programmatically. The engine receives the pipeline definition and begins execution. Progress dots activate on each node as it runs. This is a real engine call, not simulated.
  8. Form Execution — RBAC-Styled Forms Per Role
    RBACFORMSAUTO-FILLED As each HumanGate or FormNode fires during execution, a form panel opens inline (not as a modal overlay — as a side panel or canvas-attached panel). The form is generated from the data schema. Its visual style variant is derived from the RBAC role: Submitter forms use a minimal entry variant; Validator forms use a review/readonly variant with diff highlighting; HR Manager forms use a decision authority variant with approve/reject controls. All forms are filled autonomously with Mohammed Al Rashidi's pre-seeded data. Each form submits itself. Node goes green.
  9. Completion State — Exportable Result
    COMPLETEEXPORT All 7 nodes are green. Run log shows full execution trace. A result summary card appears: Worker ID assigned, Compliance Status ACTIVE, API refs from MoHRE and GDRFA, SMS delivery confirmed. An EXPORT button is present (outputs the pipeline definition as JSON). The auto mode controller stops. The interface returns to normal interactive state. The data created during the demo is real and persists in the canvas state.

04 Intellisense & Data Templates
The core insight: When a user selects a data type or node type, the system already knows what fields that type requires. The job of intellisense is to surface this knowledge at the point of need — proposing a complete, correct field list that the user can confirm or modify, rather than requiring them to recall and type every field name from scratch.
Template Engine
Built-In Data Type Templates
A registry of canonical data shapes. Each template defines: name, category, field list with types, default constraints, and which RBAC roles are relevant.
  • Person — name, DOB, nationality, ID number, contact
  • Worker (UAE) — extends Person + employer, POLO flag, medical
  • Organisation — name, industry, jurisdiction, status, contact
  • Team — name, parent org, function, capacity
  • Compliance Document — type, issuer, issue date, expiry, reference
  • Pipeline Run Result — run ID, timestamp, status, node results map
  • API Endpoint — url, method, auth type, payload schema ref
Intellisense Behaviour
Propose, Confirm, Extend
When a node type is selected or a schema is initiated:
  • System detects the closest matching template
  • A field proposal list appears inline (not a new dialog)
  • Fields are pre-ticked. User can untick to exclude or click + Add Field
  • Confirmation collapses the list and the schema is finalised
  • Any field whose type is reference automatically suggests linking to an existing schema
Organisation Templates
Org-Specific Proposal Sets
Three organisation-domain templates surface when Industry is set:
  • UAE Compliance — POLO exempt flag, MoHRE ref, GDRFA ref, Emirates ID
  • Professional Services — project code, billing rate, engagement type, PO reference
  • Media Production — production title, rights region, deliverable type, broadcast date
Selecting an org-domain template customises both the org entity schema and the pipeline node palette available to that org.
Pipeline Node Awareness
Schema → Node Type Sync
When a schema is confirmed, the canvas palette updates automatically. New node types appear that are typed to that schema: FormNode[WorkerProfile], StoreNode[WorkerProfile], ValidateNode[WorkerProfile]. Dragging one of these onto the canvas pre-populates its config with the correct schema reference, required fields list, and default rule set.

05 RBAC-Driven Form Generation

Forms are not hand-designed. They are generated from the data schema + the RBAC matrix for the role of the current user. The result is that the same underlying data entity produces a fundamentally different form surface for each role — without any per-form design work.

Role Form Variant Visual Style Field Behaviour Controls
Submitter Entry Form Minimal, high-contrast input fields. Green accent on focus. Progress indicator showing completion %. All writable fields shown. Required fields marked. Optional fields collapsed behind Show more. SUBMIT button. Save Draft link. Help text on each field.
Validator Review Form Two-column layout: submitted values left, validation result right. Amber/green/red row-level status indicators. Read-only by default. All fields read-only. Validation rule results shown inline per field. Override toggle available for privileged fields. APPROVE / REQUEST REVISION / ESCALATE. Comment field. Rule result summary.
HR Manager Decision Form Authority styling: deeper background, larger typography, decision controls prominent. Document reference panel alongside main form. Summary view: only key identity fields + compliance status shown. Full detail available in expandable drawer. APPROVE / REJECT / HOLD. Decision note field (required). Signature hash field. Timestamp auto-set.
API Consumer Payload View JSON syntax-highlighted display. No form fields. Read-only. Copy button. Full entity serialised as JSON matching the schema definition. COPY PAYLOAD. View Schema link.
How it works: The schema defines fields[]. Each field has an RBAC matrix entry per role: visible, editable, required. The form generator reads this matrix and produces the correct variant automatically. Adding a new role creates a new form variant for free. Adding a new field propagates it to all role variants immediately.

06 Autonomous Mode Controller — Technical Spec
Activation
Single DEMO Button
One button in the toolbar triggers the full sequence. Second click cancels and returns to manual mode. Keyboard shortcut: Ctrl+Shift+D. A subtle pulsing indicator in the top-right of the toolbar shows AUTO MODE RUNNING with a step counter.
Controller Architecture
window.nexusAuto Object
Replaces window.nexusAuto entirely. Methods:
  • nexusAuto.run() — start full sequence
  • nexusAuto.cancel() — halt and restore state
  • nexusAuto.step(n) — jump to step n for debugging
  • nexusAuto.speed(multiplier) — 0.5x slow, 1x normal, 2x fast
Built as an async generator: each step yields control, allowing the browser to repaint between actions.
UI Interaction
Real DOM Operations
All interactions through the real DOM:
  • Field fill: el.focus(); el.value = v; el.dispatchEvent(new Event('input', {bubbles:true}));
  • Button click: btn.click()
  • Node placement: call the existing addNode(type, x, y, config) API
  • Panel open/close: use existing panel toggle functions
  • Canvas edge draw: call the existing edge creation API
No DOM mocking. No bypassing of event handlers.
Constraint
No Separate Overlay
The autonomous mode controller must NOT add any overlay element that covers the canvas or panels. All activity happens within the existing UI frame. Panels open/close in their normal positions. The canvas remains fully visible throughout. Any status display must be contained within the toolbar or a non-intrusive status strip.

07 Reference: Pyrometrix Autonomous Demo Mode

The Pyrometrix autonomous demo is the model for style and execution philosophy. Key attributes to replicate:

Pyrometrix Pattern 1
The Interface IS the Demo
No separate presentation layer. The production interface runs under automation. Watching the demo is equivalent to watching a skilled user operate the product at full speed. Every action is meaningful. Nothing is decorative.
Pyrometrix Pattern 2
Deliberate Pacing at Inflection Points
The sequence pauses briefly at moments of highest information density: when a schema is confirmed, when a pipeline result arrives, when a compliance decision is logged. These are the moments a potential client needs time to absorb. The controller inserts 1.5–2.5 second holds at these points.
Pyrometrix Pattern 3
Realistic Data, Real Actions
All pre-seeded values are plausible, specific, and consistent across the whole sequence. Mohammed Al Rashidi, AE-2943817, NE-2026-004817, +971-50-XXX — these appear in every panel, form, and log entry. Data continuity across steps signals that the system is tracking a real entity through a real process.
Pyrometrix Pattern 4
Completion Is a Deliverable
The demo does not fade out. It ends in a defined, useful state: a created org, a registered team, three assigned users, a confirmed schema, a built pipeline, a completed run, a stored worker record. This state can be exported, inspected, or continued manually after the autonomous sequence ends.

08 Implementation Backlog Items (New)
IDTitlePriorityDependsDescription
BL19 Rename demo-auto (remove theatre terminology) P1 Rename id="demo-theatre" to id="demo-auto", window.demoTheatre to window.nexusAuto, all dt-* CSS classes to da-* or remove. Remove all “theatre” wording from NEXUS_DEMO_SPEC.html. The overlay approach is also deprecated by BL22.
BL20 Entity creation panels (Org, Team, User) P1 BL19 Add entity creation side-panel component (using existing #class-panel infrastructure). Supports Org, Team, and User entity types. Fields are driven by the template engine. Panel opens/closes with existing animation. Save writes to in-memory state and updates the org/team/user dropdowns.
BL21 Data template registry + intellisense field proposals P1 BL20 Implement DATA_TEMPLATES registry (see Section 04). Wire template selection into the schema creation flow in the canvas. When a node type is selected, propose matching field list inline. Confirm collapses proposal and finalises schema. Template registry is defined as a JS object in WORMWOOD_APP.html.
BL22 Autonomous mode controller (window.nexusAuto) P1 BL20, BL21 Implement the full 9-step autonomous sequence defined in Section 03. Async generator architecture. No overlay. All DOM interactions through real UI paths. Pacing at inflection points. Speed multiplier support. Progress indicator in toolbar. Cancel on second DEMO click. Replaces current demo-auto overlay entirely.
BL23 RBAC-driven form generator P1 BL21 Implement form generation from schema + RBAC matrix. Four role variants as defined in Section 05. Form opens in the existing side panel. Fields are generated from schema field list filtered by role visibility matrix. Style variant (entry/review/decision/api) is applied via a CSS class on the panel root.
BL24 Schema → canvas palette sync P2 BL21 When a schema is confirmed, update the node type palette with typed node variants: FormNode[SchemaName], StoreNode[SchemaName], ValidateNode[SchemaName]. Dragging a typed node auto-populates its config. Required for autonomous mode to build the correct pipeline.
BL25 Demo Vision doc added to site registry P2 Add NEXUS_DEMO_VISION.html to NEXUS_DOC_HIERARCHY.html active registry (Section 05, row 21). Update validator exempt list if needed. Add doc card to index.html. Update NEXUS_DOC_POLICY.html sitemap entry count to 21.

09 Assessment of Current Implementation vs This Vision
Current state is inadequate. The existing demo-auto overlay (formerly "demo theatre") is a self-contained animation sequence that operates independently of the interface. It does not use the canvas. It does not create any entities. It does not build any pipeline. It does not run the engine. It opens as a modal over a frozen canvas and plays back pre-scripted text animations. This is the opposite of what is required. It is being deprecated and replaced by BL19–BL23.
CapabilityRequired by VisionCurrent StateGap
Org / Team / User creation Full entity creation through real UI panels Not implemented MISSING
Data template registry 7+ built-in templates with field proposals Not implemented MISSING
Intellisense field proposals Inline proposal list on node/schema creation Not implemented MISSING
RBAC form generation Schema + role matrix → 4 form variants Not implemented MISSING
Autonomous mode controller 9-step sequence, real DOM, no overlay Overlay-based animation, not connected to UI REWORK
Canvas node placement in auto mode Nodes placed on real canvas in sequence Not implemented MISSING
Schema → palette sync Typed node variants appear after schema creation Not implemented MISSING
End-to-end demo state Real persisted state: org, users, schema, pipeline, run result No state created MISSING
Canvas visible throughout Canvas always visible, no obscuring overlay Canvas obscured by overlay VIOLATION
Terminology (no "theatre") All references use "auto mode" language Code and docs use "theatre" REWORK