Unclassified

IntegrateWise / SpineWorkspace — Canonical Repository Architecture

This is the frozen repository boundary specification.

ROOT
│
├── apps/
│   → User-facing application surfaces and companion runtimes
│
├── packages/
│   → Shared product/domain packages, schemas, configuration,
│     MFEs, UI primitives and SDKs
│
├── services/
│   → Backend runtimes, Cloudflare Workers, APIs and gateways
│
├── contracts/
│   → Canonical protocol, API, event, schema and JSON contracts
│
├── configs/
│   → Cross-repository environment, deployment and infrastructure configuration
│
├── marketplace/
│   → Connector, MCP plugin and capability marketplace definitions
│
├── mcp/
│   → MCP protocol bridges, definitions and server infrastructure
│
├── docs/
│   → Canonical architecture, implementation specifications and ADRs
│
├── migrations/
│   → Operational/distributed storage migrations
│     D1 / KV / runtime state
│
├── sql-migrations/
│   → Canonical Spine PostgreSQL migrations
│     Neon / durable canonical state
│
└── tools/
    → Importers, code generation, migration helpers and build tooling

Domain Subdomains

spineworkspace.com
│
├── www.spineworkspace.com          → Public marketing (apps/marketing)
│
├── auth.spineworkspace.com         → One Access (apps/one-access)
├── connector.spineworkspace.com    → Connector management
├── platform.spineworkspace.com     → Platform control plane (apps/platform)
├── mcp.spineworkspace.com          → MCP infrastructure
├── marketplace.spineworkspace.com  → Marketplace discovery
├── admin.spineworkspace.com        → Administration
│
├── founder.spineworkspace.com      → Founder Workbench
├── sales.spineworkspace.com        → Sales Workbench
├── marketing.spineworkspace.com    → Marketing Workbench
├── finance.spineworkspace.com      → Finance Workbench
├── ops.spineworkspace.com          → Ops Workbench
├── engineering.spineworkspace.com  → Engineering Workbench
├── account-success.spineworkspace.com → TAM Workbench
├── technical-account-success.spineworkspace.com → Technical Account Success
├── business-intelligence.spineworkspace.com → Business Intelligence
├── campaigns.spineworkspace.com    → Campaigns Workbench
├── knowledge-management.spineworkspace.com → Knowledge Management
├── support.spineworkspace.com      → Support Workbench
├── brandstore.spineworkspace.com   → BrandStore (internal)
└── book-of-records.spineworkspace.com → Org Memory (internal)

Common Sidebar Structure (IW Grammar)

All domain workspaces share a common sidebar grammar. Only the Work section is projection-aware.

Home

Personal operational dashboard
Cross-domain aggregation
Workspace awareness
Recent activity
Priority ranking
Personal KPIs
Pending approvals
AI recommendations
Quick actions
Workspace continuity entry
Personal Twin context
Cross-projection navigation

My Work

Assigned work
Delegated work
Waiting on others
Waiting for me
Tasks
Goals
Deliverables
Follow-ups
Approvals
SLA commitments
Calendar-linked work
Twin-assisted execution

Inbox

Unified operational inbox
Aggregated from: Email, Chat, CRM, Tickets, Comments, Mentions, Notifications, AI-generated follow-ups, Connector events, Workflow events, Approval requests
With: Priority scoring, Deduplication, Threading, AI summaries, Suggested actions

Tasks

Universal task execution
Supports: Manual tasks, Workflow tasks, Agent-generated tasks, Connector-generated tasks, Scheduled tasks, Recurring tasks, Approvals, Dependencies, SLA tracking, Context-aware execution

My Queue

Dynamic execution queue
Generated using: Priority engine, OODA, Signals, Deadlines, Dependencies, AI prioritization, Role, Current context, Business impact, Attention management

Approvals

Human-in-the-loop governance
Supports: Publishing, Budget approval, Connector approval, AI approval, Write-back approval, Customer approval, Deployment approval, Security approval, Policy approval, Escalation workflows, Full audit trail

Notifications

Workspace event stream
Sources: Connectors, Pipelines, Agents, Skills, Workflows, Governance, Security, Platform, Workspace, Twin, Human collaboration
With intelligent grouping and prioritization

Recent Work

Continuity surface
Shows: Recently viewed entities, Recently edited records, Recent conversations, Recent workflows, Recent approvals, Recent Twin sessions, Recent canvas work, Recent documents, Recent context, Resume previous work

Favorites

Pinned operational assets
Includes: Views, Dashboards, Accounts, Campaigns, Customers, Reports, Skills, Agents, Workflows, Documents, Canvases, Pipelines

Communications

Unified communication layer

Activity Feed

Operational timeline
Combines: CRM activity, Emails, Meetings, Chats, Deployments, Customer interactions, Agent activity, Workflow execution, Connector events, Platform events
Mapped into one chronological Spine timeline

Email

Unified email workspace
Provides: Multi-provider inbox, AI summaries, Draft generation, Smart replies, CRM linking, Entity linking, Twin memory, Knowledge retrieval, Workflow initiation, Context gathering

Calendar

Unified scheduling
Supports: Multiple providers, Availability, AI scheduling, Meeting preparation, Agenda generation, Follow-up generation, Linked entities, Linked workflows, Context retrieval

Meetings

Meeting operating system
Includes: Preparation, Briefing, Live assistance, Recording, Transcript, Action extraction, Decisions, Follow-ups, Memory promotion, Workflow creation

Chat

Unified conversation layer
Across: Slack, Teams, Discord, Internal chat, MCP messaging, AI conversations
With: Context retrieval, Entity linking, Workspace memory, Suggested actions

Calls

Voice communication
Supports: Call preparation, Live notes, Transcript, CRM linking, Entity extraction, Tasks, Decisions, Follow-ups, Memory updates

Documents Shared

Collaborative document workspace
Supports: Google Docs, Office, Notion, Coda, PDFs, Internal documents
With: Semantic indexing, Context retrieval, Version awareness, AI understanding, Knowledge promotion

Personal

Personal knowledge and thinking space

Notes

Personal operational memory
Supports: Quick capture, Linked entities, AI organization, Tags, Knowledge promotion, Twin context, Search, Continuity

Knowledge Base

Workspace knowledge graph
Provides: Canonical knowledge, Policies, Documentation, Procedures, Product knowledge, Customer knowledge, Organizational knowledge, Semantic search, RAG context, Source traceability

Brainstorming Sessions

Collaborative ideation
Supports: Whiteboards, Structured thinking, AI ideation, Twin collaboration, Decision capture, Research, Concept evolution, Memory promotion

Activity

Personal operational timeline
Tracks: Work history, AI activity, Decisions, Context switches, Workflow participation, Learning, Memory evolution, Workspace interactions

Work Section

Route based on: Role × Department × Industry × Workspace policy

Built from:

Spine projections
Views (table, dashboard, board, canvas, feed, calendar)
Canvas
Tool capabilities
Twin execution through OODA
Skills
Agents
Workflows
Pipelines
Backend/frontend mappings
Operational databases
Context gathering
Entity360
Continuity memory

Each projection should contain enough operational depth for a user to perform their complete job in the agentic era.

Platform Section

Shared platform capability layer provided by apps/platform:

Integration Manager
Connector Marketplace
Activation Hub
Capability Manager
MCP Pool
AI Models
Knowledge
Memory & Continuity
Automation
Pipelines
Governance
Observability
Administration (Organizations, Users, Roles, Permissions, Audit, Billing, Deployments, API Keys, Security, Admin, Paywall)

`apps/` — 11 entries

apps/
│
├── marketing/
│   → Public Marketing application
│   → www.spineworkspace.com
│   → canonical public URLs
│   → /solutions/* remains URL-stable
│
├── web/
│   → Authenticated multi-domain User Workbench
│   → *.spineworkspace.com
│   → Common IW shell
│   → Domain Workbenches
│   → Role × Department × Industry × Context projections
│
├── one-access/
│   → OneAuth
│   → auth.spineworkspace.com
│   → Identity
│   → SSO
│   → tenant/workspace resolution
│   → onboarding
│   → activation entry
│
├── activation/
│   → Onboarding flow
│   → activation.spineworkspace.com
│
├── auth/
│   → Auth management UI
│   → auth.spineworkspace.com
│
├── connector/
│   → Connector management UI
│   → connector.spineworkspace.com
│
├── platform/
│   → Platform Control Surface
│   → platform.spineworkspace.com
│   → Integration Manager
│   → Activation
│   → Capabilities
│   → MCP
│   → AI
│   → Memory
│   → Pipelines
│   → Governance
│   → Observability
│   → Administration
│
├── docs/
│   → Public/developer documentation portal
│
├── mobile/
│   → Mobile Workbench client
│
├── desktop/
│   → Desktop Workbench client
│
├── mcp-servers/
│   → Managed MCP server runtimes
│
└── portfolio/
    → Deprecated / Absorbed into apps/platform

`packages/` boundary

Domain definitions and reusable product semantics belong here rather than becoming more apps.

packages/
├── workbenches/
│   ├── founder
│   ├── sales
│   ├── account-success (TAM)
│   ├── technical-account-success
│   ├── finance
│   ├── ops
│   ├── engineering
│   ├── marketing
│   ├── business-intelligence
│   ├── campaigns
│   ├── knowledge-management
│   ├── support
│   ├── brandstore (internal)
│   └── book-of-records (internal)
│
├── projection-engine/
├── context/
├── capability/
├── workbench-config/
├── workbench-common/
├── spine-schema/
├── spine-entities/
├── auth/
├── intelligence/
├── shell/
├── ui/
├── SDKs/
└── retained MFEs where genuinely reusable

`services/` boundary

services/
├── gateway/
├── context/
├── projection/
├── spine-sync/
├── loader/
├── normalizer/
├── pipeline/
├── capability/
├── governance/
├── orchestrator/
├── connectors/
├── reconciliation/
├── knowledge/
├── memory/
├── intelligence/
└── observability/

Storage migration boundary

sql-migrations/
      ↓
NEON (Canonical Spine, durable tenant truth, history, relationships, provenance, governance, durable memory)

migrations/
      ↓
D1 / KV / distributed runtime (Operational Spine, active working set, projection state, current context, runtime state)

Marketplace versus MCP

marketplace/
= what can be discovered / installed / activated

mcp/
= MCP protocol implementation and bridges

apps/mcp-servers/
= managed MCP runtime deployments

Final repository law

apps/         = experiences
packages/     = reusable product/domain definitions
services/     = runtime implementations
contracts/    = cross-boundary canonical contracts
configs/      = environment/infrastructure configuration
marketplace/  = discoverable/installable capability inventory
mcp/          = MCP protocol infrastructure
docs/         = architecture and implementation authority
migrations/   = Operational Spine/runtime migrations
sql-migrations/ = Canonical Spine/Neon migrations
tools/        = generation and engineering tooling