{"slug":"architecture/SYSTEM_ARCHITECTURE_CANONICAL","title":"IntegrateWise & Spine Workspace — Canonical System Architecture Specification","section":"architecture","sectionLabel":"Architecture","status":"unclassified","type":"document","path":"architecture/SYSTEM_ARCHITECTURE_CANONICAL.mdx","bytes":17920,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n---\n\n## 1. Document Control & Executive Summary\n\n| Property                        | Canonical Specification Value                                                                                                                                |\n| :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **System Name**                 | **IntegrateWise Platform** & **Spine Workspace**                                                                                                             |\n| **Document Version**            | **v3.0.0-Canonical**                                                                                                                                         |\n| **Architecture Classification** | Modern Enterprise Service Bus (ESB) & Cognitive Operational Continuity Substrate                                                                             |\n| **Company Entity**              | **IntegrateWise Inc.** (`integratewise.ai`)                                                                                                                  |\n| **Product Surface**             | **Spine Workspace** (`spineworkspace.com` / `app.spineworkspace.com`)                                                                                        |\n| **Category**                    | **The Self-Organizing Workspace**                                                                                                                            |\n| **Platform Engine**             | **Operational Continuity Platform**                                                                                                                          |\n| **Core Promise**                | _\"Spine Workspace assembles the exact context, intelligence, and governed actions you need based on your role, your work, and what is happening right now.\"_ |\n\n---\n\n## 2. Top-Level Taxonomy & Hierarchy\n\n```mermaid\ngraph TD\n    IW[\"IntegrateWise (Company & Platform Authority)\"]\n    SW[\"Spine Workspace (End-User Product)\"]\n    SOW[\"Self-Organizing Workspace (Category)\"]\n    DWE[\"Domain-Aware Workspace Experience (18 Projections)\"]\n    TGA[\"Twin + Governed Actions (Intelligence & Policy)\"]\n    AS[\"Adaptive Spine (Continuity Substrate)\"]\n    OCP[\"Operational Continuity Platform (Infrastructure & Mesh)\"]\n\n    IW --> SW\n    SW --> SOW\n    SOW --> DWE\n    DWE --> TGA\n    TGA --> AS\n    AS --> OCP\n```\n\n### 2.1 The Naming Doctrine\n\n1. **IntegrateWise**: The company, the enterprise brand, and the platform authority.\n2. **Spine Workspace**: The commercial software product.\n3. **Adaptive Spine**: The governed continuity substrate connecting operational truth, knowledge, memory, and entity relationships.\n4. **Twin**: The contextual intelligence and cognitive co-worker runtime.\n5. **Adaptive Workbench (Retired)**: Terminology consolidated into _Spine Workspace_ and _Domain Projections_.\n\n---\n\n## 3. The 6-Layer Architectural Stack\n\n```text\n┌──────────────────────────────────────────────────────────────────────────────────┐\n│  LAYER 6: PRESENTATION & PROJECTION RUNTIME (Spine Workspace)                   │\n│  • Self-Organizing Workspace Shell (OWUI)  • Multi-View Switcher (Table/Board)   │\n│  • 18 Dynamic Domain Lenses (Sales/CS/RevOps/Eng)  • Interactive Live Canvas     │\n└────────────────────────────────────────▲─────────────────────────────────────────┘\n                                         │ Consumes Active Context Bundle\n┌────────────────────────────────────────┴─────────────────────────────────────────┐\n│  LAYER 5: CONTEXT COMPILER & PROJECTION ENGINE                                   │\n│  • Materializes Active Context Bundle Contract (Single Context Law)              │\n│  • Role × Domain × Industry × Entity × Intent Resolution Engine                  │\n└────────────────────────────────────────▲─────────────────────────────────────────┘\n                                         │ Assembles from Spine\n┌────────────────────────────────────────┴─────────────────────────────────────────┐\n│  LAYER 4: COGNITIVE INTELLIGENCE & TWIN RUNTIME                                  │\n│  • Contextual Twin Copilot   • OODA Reasoning Loop  • Signal Sweep & Synthesis   │\n│  • Proactive Proposal Generator (HITL-gated action drafts)                       │\n└────────────────────────────────────────▲─────────────────────────────────────────┘\n                                         │ Reads Context & Dispatches Proposals\n┌────────────────────────────────────────┴─────────────────────────────────────────┐\n│  LAYER 3: GOVERNED CAPABILITY FABRIC & POLICY ENGINE                             │\n│  • Capability Resolver & Router  • 3-Tier Risk Classifier (Read / Gated / Strict)│\n│  • Human-in-the-Loop (HITL) Gate • Action Lineage & Provider Reconciler          │\n└────────────────────────────────────────▲─────────────────────────────────────────┘\n                                         │ Reconciles & Mutates\n┌────────────────────────────────────────┴─────────────────────────────────────────┐\n│  LAYER 2: THE ADAPTIVE SPINE (Governed Continuity Substrate)                    │\n│  ├── 1. Operational Truth (Entities, Relationships, States, Timeline Events)     │\n│  ├── 2. Knowledge & Evidence (Docs, Chunks, Provenance, Retrieval References)    │\n│  ├── 3. Memory & Continuity (Decisions, Commitments, Handoffs, Org Memory)       │\n│  └── 4. Derived Context (Compiled Bundles & Temporal Signals)                    │\n└────────────────────────────────────────▲─────────────────────────────────────────┘\n                                         │ Ingests & Normalizes\n┌────────────────────────────────────────┴─────────────────────────────────────────┐\n│  LAYER 1: INTEGRATION MESH, GATEWAY & ONEAUTH INGRESS                            │\n│  • OneAuth SSO / Session Broker (Zero client credential exposure)                │\n│  • Bi-directional Connectors (Salesforce, HubSpot, Jira, Zendesk, Stripe, Slack)│\n│  • Webhook Ingress, Event Mesh & Telemetry Pipeline                              │\n└──────────────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 4. The 12-Step Closed Continuity Execution Loop\n\nEvery interaction, webhook event, or Twin proposal executes through the deterministic **12-Step Closed Loop**:\n\n```mermaid\nflowchart TD\n    subgraph INGESTION[\"1. INGESTION & NORMALIZATION\"]\n        S1[\"1. Observe (Webhooks, Telemetry, User Inputs)\"] --> S2[\"2. Normalize (Canonical Mapping)\"]\n        S2 --> S3[\"3. Resolve (Entity Graph & Identity Linking)\"]\n        S3 --> S4[\"4. Persist (Authoritative Adaptive Spine Write)\"]\n    end\n\n    subgraph PROJECTION[\"2. CONTEXT & PROJECTION\"]\n        S4 --> S5[\"5. Compile Context (Active Context Bundle Materialization)\"]\n        S5 --> S6[\"6. Project (Role × Domain Workspace Lens)\"]\n    end\n\n    subgraph REASONING[\"3. COGNITIVE SYNTHESIS\"]\n        S6 --> S7[\"7. Reason (Twin OODA & Signal Sweep)\"]\n        S7 --> S8[\"8. Propose (Structured Action Proposal Generation)\"]\n    end\n\n    subgraph GOVERNANCE[\"4. GOVERNANCE & RECONCILIATION\"]\n        S8 --> S9[\"9. Govern (Policy Engine & HITL Risk Gates)\"]\n        S9 --> S10[\"10. Execute (Server-side Capability Runtime Mutation)\"]\n        S10 --> S11[\"11. Reconcile (Provider Confirmation & Receipt Verification)\"]\n        S11 --> S12[\"12. Continue (Durable Organizational Memory Update)\"]\n    end\n\n    S12 -.-> S5\n```\n\n---\n\n## 5. The Single Context Law & Data Contract\n\n> [!IMPORTANT]\n> **The Single Context Law**: The user interface (Views, Table, Canvas), the AI intelligence (Twin, Background Reasoner), and the tool execution fabric MUST consume the identical `ActiveContextBundle`. AI is never allowed to hallucinate from ungrounded prompt memory.\n\n```typescript\nexport interface ActiveContextBundle {\n  tenantId: string;\n  projectionId: string;\n  domain: OperationalDomain;\n  user: {\n    userId: string;\n    role: string;\n    department: string;\n    capabilities: string[];\n  };\n  entity: {\n    id: string;\n    type: string;\n    displayName: string;\n    primarySource: string;\n    externalIds: Record<string, string>;\n    lastReconciledAt: string;\n    freshnessScore: number;\n  };\n  signals: Array<{\n    id: string;\n    severity: \"critical\" | \"warning\" | \"info\" | \"positive\";\n    source: string;\n    title: string;\n    description: string;\n    detectedAt: string;\n  }>;\n  evidence: Array<{\n    id: string;\n    type: \"contract\" | \"ticket\" | \"call_transcript\" | \"invoice\";\n    provenanceUrl: string;\n    summary: string;\n  }>;\n  governanceGates: {\n    maxExecutionRisk: \"low\" | \"medium\" | \"high\";\n    requiresHitl: boolean;\n    policyRulesEnforced: string[];\n  };\n}\n```\n\n---\n\n## 6. Multi-Domain Projections (18 Operational Domains)\n\nSpine Workspace resolves the work surface via a multi-dimensional matrix:\n$$\\text{Role} \\times \\text{Runtime Domain} \\times \\text{Industry} \\times \\text{Entity} \\times \\text{Intent} \\longrightarrow \\text{Compiled Projection}$$\n\n| Domain                   | Canonical Identifier        | Core Entities                       | Primary Sources              |\n| :----------------------- | :-------------------------- | :---------------------------------- | :--------------------------- |\n| **Sales**                | `sales`                     | Opportunities, Accounts, Contacts   | Salesforce, HubSpot          |\n| **Account Success**      | `customer-success`          | Accounts, Health, Milestones        | Gainsight, Zendesk           |\n| **Technical Operations** | `technical-account-success` | Incidents, Clusters, SLAs           | Datadog, PagerDuty, Jira     |\n| **RevOps**               | `revops`                    | Pipelines, Quotas, Conversion       | Salesforce, HubSpot, Stripe  |\n| **Finance**              | `finance`                   | Invoices, Contracts, Ledgers        | Stripe, QuickBooks, NetSuite |\n| **Business Ops**         | `businessops`               | OKRs, KPIs, Resources               | Google Sheets, Notion        |\n| **Marketing**            | `marketing`                 | Campaigns, Leads, Attribution       | Marketo, Google Ads          |\n| **Content Ops**          | `content`                   | Editorial, Briefs, Assets           | Notion, Figma                |\n| **Campaigns**            | `campaigns`                 | Workflows, Audiences                | HubSpot, Customer.io         |\n| **Product**              | `product`                   | Roadmaps, Features, Specs           | Jira, Linear, Productboard   |\n| **Engineering**          | `engineering`               | Pull Requests, Issues, Repos        | GitHub, GitLab, Jira         |\n| **Support**              | `support`                   | Tickets, Escalations, CSAT          | Zendesk, Intercom            |\n| **Human Resources**      | `human-resources`           | Candidates, Offers, Headcount       | Greenhouse, Workday          |\n| **Legal**                | `legal`                     | Contracts, NDAs, Redlines           | Ironclad, DocuSign           |\n| **Founder Ops**          | `founder-ops`               | Investor Updates, Runway, Cap Table | Carta, Mercury               |\n| **Knowledge**            | `knowledge`                 | Documentation, Wiki, SOPs           | Notion, Confluence           |\n| **Personal Work**        | `personal`                  | Tasks, Focus Time, Inbox            | Google Calendar, Slack       |\n| **Executive**            | `strategy`                  | Strategic Bets, Board Decks         | Google Slides, Mixpanel      |\n\n---\n\n## 7. Governance, Security & Non-Repudiation (R1–R10)\n\n```mermaid\nflowchart TD\n    Intent[\"User or AI Intent\"] --> RiskClass{\"Risk Evaluation\"}\n\n    RiskClass -- \"Class 1: Read / Synthesize\" --> AutoExec[\"Execute Automatically\"]\n    RiskClass -- \"Class 2: Low-Impact Draft\" --> PolicyCheck{\"Policy Enforced?\"}\n    PolicyCheck -- Yes --> AutoDraft[\"Draft in Sandbox\"]\n    PolicyCheck -- No --> HITL[\"Human Approval Card\"]\n\n    RiskClass -- \"Class 3: Consequential Mutation\" --> HITL\n\n    HITL --> UserConfirm{\"User Approval\"}\n    UserConfirm -- Approved --> ExecRuntime[\"Server Capability Runtime\"]\n    UserConfirm -- Rejected --> Abort[\"Audit Log Rejection & Cancel\"]\n\n    AutoExec --> ExecRuntime\n    AutoDraft --> ExecRuntime\n\n    ExecRuntime --> Provider[\"External Provider (Salesforce / Stripe / Zendesk)\"]\n    Provider --> Receipt[\"Provider Receipt & Transaction ID\"]\n    Receipt --> Reconcile[\"Reconcile into Spine & Update Lineage\"]\n```\n\n### 7.1 Core Governance Rules\n\n- **R1 (Zero Browser Credentials)**: No third-party OAuth tokens or API keys ever touch the frontend bundle.\n- **R2 (Single Context Law)**: The AI copilot and UI canvas share the identical `ActiveContextBundle`.\n- **R3 (Closed Execution Loop)**: Actions are never marked complete until external provider confirmation is received.\n- **R4 (Explicit Risk Classification)**: Read-only (1), Drafts (2), External Mutations (3).\n- **R5 (Confidence Never Grants Authority)**: An AI confidence score of 99% does not bypass human-in-the-loop gates.\n- **R6 (Immutable Action Lineage)**: Records user ID, timestamp, intent, prompt, policy version, and provider response receipt.\n\n---\n\n## 8. Network Topology & Ingress Architecture\n\n```text\nINTERNET & CLIENT INGRESS\n│\n├── https://integratewise.ai                    → Platform brand & category education\n│   ├── /platform                               → The 12-Step Continuity Loop & Adaptive Spine\n│   ├── /security                               → Trust Center (Zero Credential Exposure)\n│   ├── /pricing                                → Enterprise platform tiers\n│   └── /contact                                → Enterprise sales & security inquiries\n│\n├── https://spineworkspace.com                  → Commercial Product Homepage (\"The Self-Organizing Workspace\")\n│   ├── /how-it-works                           → 3-Step Process: Connect → Assemble → Project\n│   ├── /twin                                   → Contextual Intelligence with Governed Execution\n│   ├── /governance                             → Risk Classification, Approvals & Action Lineage\n│   └── /gallery                                → Artifact Gallery: Real QBRs, RCAs & Plans\n│\n├── https://app.spineworkspace.com              → Authenticated Workspace Runtime (The End-User Product)\n├── https://platform.spineworkspace.com         → Customer Control Plane (Tenant Admin, RBAC, Connectors, Audit)\n├── https://auth.spineworkspace.com             → Identity & SSO Ingress (OneAuth Session Gateway)\n├── https://activation.spineworkspace.com       → Self-Service Provisioning & Onboarding Wizard\n├── https://docs.integratewise.ai               → Technical API & developer documentation\n├── https://api.integratewise.ai                → Edge API Gateway ingress\n└── https://mcp.integratewise.ai                → Model Context Protocol tool endpoint\n\nEDGE REWRITES (Vanity Solution Subdomains)\n├── https://sales.spineworkspace.com            → /solutions/sales\n├── https://cs.spineworkspace.com               → /solutions/customer-success\n├── https://technical-account-success.spineworkspace.com → /solutions/technical-account-success\n├── https://finance.spineworkspace.com          → /solutions/finance\n├── https://revops.spineworkspace.com           → /solutions/revops\n└── https://marketing.spineworkspace.com        → /solutions/marketing\n```\n"}