Skip to main content

​
aiConnected Platform v2 — Port Map

Old path → New v2 path, with migration instructions March 2026

​
Overview

The v2 monorepo follows the same Turborepo structure as v1. Package names and locations are preserved where possible for developer familiarity. The key differences are: a new packages/ui package (shadcn/ui layer), a replaced packages/db schema, and three fully rebuilt apps/. 
platform-v2/
├── apps/
│   ├── platform/          ← Rebuilt from scratch (shadcn shell)
│   ├── chat/              ← Rebuilt from scratch (shadcn + chat-core)
│   └── kb-studio/         ← Rebuilt from scratch (shadcn + kb-engine)
├── packages/
│   ├── permissions/       ← Ported as-is
│   ├── app-sdk/           ← Ported + extended (events_emitted/consumed)
│   ├── kb-engine/         ← Ported as-is
│   ├── chat-core/         ← Ported as-is
│   ├── branding/          ← Logic ported, tokens replaced for TweakCN
│   ├── db/                ← Client patterns ported, schema rebuilt
│   └── ui/                ← NEW — shadcn/ui component package
├── supabase/
│   └── migrations/        ← Rebuilt from v2 schema contracts
└── turbo.json / package.json

​
Package Port Map

​
packages/permissions

Action: Copy as-is. Zero changes required.
v1 pathv2 pathChanges
packages/permissions/src/auth.jspackages/permissions/src/auth.jsNone
packages/permissions/src/index.jspackages/permissions/src/index.jsNone
The USER_ROLES constants, ROLE_GROUPS, and all helper functions (isSuperAdmin, isAgencyUser, isBusinessUser, etc.) are correct and match the v2 user model exactly. Copy verbatim.

​
packages/app-sdk

Action: Port + extend for events.
v1 pathv2 pathChanges
packages/app-sdk/src/manifests.jspackages/app-sdk/src/manifests.jsAdd events_emitted and events_consumed arrays to each manifest
packages/app-sdk/src/imports.jspackages/app-sdk/src/imports.jsExtend VALID_CONTRACT_KINDS to include event
packages/app-sdk/src/index.jspackages/app-sdk/src/index.jsNo change
Manifest extension required: Add to every module manifest object: 
events_emitted: ['module.event.name', ...],  // events this module fires
events_consumed: ['other.module.event', ...], // events this module listens to
The existing inputs, outputs, extensionPoints, permissions, and capabilities fields are correct and carry forward unchanged. The two new fields complete the event bus contract. Updated Chat manifest (example): 
{
  key: 'chat',
  // ... existing fields ...
  events_emitted: [
    'chat.session.started',
    'chat.message.sent',
    'chat.lead.captured',
    'chat.lead.warmed',
    'chat.session.ended',
  ],
  events_consumed: [
    'kb.published',
    'contact.updated',
    'voice.call.completed',
  ],
}

​
packages/kb-engine

Action: Port as-is. No logic changes.
v1 pathv2 pathChanges
packages/kb-engine/src/scraper.jspackages/kb-engine/src/scraper.jsNone
packages/kb-engine/src/researcher.jspackages/kb-engine/src/researcher.jsNone
packages/kb-engine/src/compiler.jspackages/kb-engine/src/compiler.jsNone
packages/kb-engine/src/extractor.jspackages/kb-engine/src/extractor.jsNone
packages/kb-engine/src/generate.jspackages/kb-engine/src/generate.jsNone
packages/kb-engine/src/ai.jspackages/kb-engine/src/ai.jsNone
packages/kb-engine/src/runtime.jspackages/kb-engine/src/runtime.jsNone
packages/kb-engine/src/system-prompt.jspackages/kb-engine/src/system-prompt.jsNone
packages/kb-engine/src/starters.jspackages/kb-engine/src/starters.jsNone
packages/kb-engine/src/concern-mapper.jspackages/kb-engine/src/concern-mapper.jsNone
packages/kb-engine/src/quiz.jspackages/kb-engine/src/quiz.jsNone
The scraper already points to crawl.sec-admn.com as the Crawl4AI endpoint. This infrastructure carries forward. No changes to the engine logic.

​
packages/chat-core

Action: Port as-is. One file to review.
v1 pathv2 pathChanges
packages/chat-core/src/runtime-config.jspackages/chat-core/src/runtime-config.jsNone
packages/chat-core/src/lead-capture.jspackages/chat-core/src/lead-capture.jsNone
packages/chat-core/src/lead-delivery.jspackages/chat-core/src/lead-delivery.jsNone
packages/chat-core/src/knowledge.jspackages/chat-core/src/knowledge.jsNone
packages/chat-core/src/ai-config.jspackages/chat-core/src/ai-config.jsNone
packages/chat-core/src/system-prompt.jspackages/chat-core/src/system-prompt.jsNone
packages/chat-core/src/structured-response.jspackages/chat-core/src/structured-response.jsNone
packages/chat-core/src/rate-limit.jspackages/chat-core/src/rate-limit.jsNone
packages/chat-core/src/composio.jspackages/chat-core/src/composio.jsReview: ensure it calls through API gateway, not direct
Note on composio.js: In v2, all external service calls route through the module’s declared API surface and the platform API gateway — not via direct SDK imports. Review composio.js to confirm it follows this pattern before porting. If it makes direct SDK calls, wrap them in the platform.http or composio.connection input pattern.

​
packages/branding

Action: Port merge logic, replace token definitions.
v1 pathv2 pathChanges
packages/branding/src/index.jspackages/branding/src/index.jsKeep mergeTheme() function. Replace DEFAULT_PLATFORM_THEME object with TweakCN-compatible CSS variable names.
Token replacement mapping (v1 → v2 TweakCN): 
sidebar_bg        → --sidebar-background
sidebar_text      → --sidebar-foreground
button_bg         → --primary
button_text       → --primary-foreground
body_bg           → --background
card_bg           → --card
heading_text      → --foreground
body_text         → --muted-foreground
Map all remaining v1 tokens to their shadcn/TweakCN equivalents. The mergeTheme(...themes) function logic is correct and carries forward unchanged.

​
packages/db

Action: Port client patterns. Rebuild schema.
v1 pathv2 pathChanges
packages/db/src/supabase-client.jspackages/db/src/supabase-client.jsNone
packages/db/src/supabase-server.jspackages/db/src/supabase-server.jsNone
packages/db/src/browser.jspackages/db/src/browser.jsNone
packages/db/src/server.jspackages/db/src/server.jsNone
packages/db/src/business-connectors.jspackages/db/src/business-connectors.jsReview against v2 schema
packages/db/src/integration-sharing.jspackages/db/src/integration-sharing.jsReview against v2 schema
Schema: Rebuild from v2 contracts. Do not run v1 migrations. v2 core schema (new migrations, written fresh): 
-- Core shared entities
workspaces          -- tenant record (replaces v1 agencies/businesses)
contacts            -- universal entity, all modules read/write
users               -- platform users, workspace-scoped roles
events              -- shared event log for module interconnection
module_registry     -- installed modules + capability contracts

-- Module-owned tables (created by each module's migration)
voice_calls
voice_profiles
transcripts
chat_conversations
chat_messages
chat_configs
kb_entries
kb_projects
contact_forms
contact_submissions

​
packages/ui — NEW PACKAGE

Action: Create from scratch. This package did not exist meaningfully in v1. In v2 it is the shadcn/ui component layer used by all apps and modules. 
packages/ui/
├── src/
│   ├── components/    ← shadcn/ui components (button, card, dialog, etc.)
│   ├── hooks/         ← shared React hooks
│   ├── lib/           ← utils (cn, etc.)
│   └── index.ts       ← barrel export
├── components.json    ← shadcn/ui config
└── package.json
All apps import from @aiconnected/ui. No app ever imports directly from shadcn/ui. This enforces design system consistency and enables global component updates.

​
App Port Map

​
apps/platform → Rebuild

Do not port. Build fresh. New platform shell structure: 
apps/platform/
├── src/
│   ├── app/
│   │   ├── (auth)/         ← login, signup, reset
│   │   ├── (shell)/        ← authenticated shell layout
│   │   │   ├── layout.tsx  ← sidebar + header shell
│   │   │   ├── dashboard/
│   │   │   ├── agencies/[agencyId]/
│   │   │   ├── businesses/[businessId]/
│   │   │   ├── settings/
│   │   │   └── billing/
│   │   └── api/
│   │       ├── auth/
│   │       ├── modules/    ← module registry endpoints
│   │       └── events/     ← event bus endpoints
│   ├── components/
│   │   ├── shell/          ← Sidebar, Header, Nav
│   │   └── shared/         ← reusable page components
│   └── lib/
│       ├── navigation.ts   ← sidebar structure by role
│       └── auth.ts         ← role utilities (from permissions package)
Reference from v1 (logic only, no UI):
  • src/lib/navigation.js — sidebar menu structure logic
  • src/lib/auth.js — auth utility patterns
  • src/context/ImpersonationContext.jsx — impersonation state logic (rewrite in TypeScript)

​
apps/chat → Rebuild

Do not port. Build fresh. New chat app structure: 
apps/chat/
├── src/
│   ├── app/
│   │   ├── [businessId]/   ← full-screen chat interface
│   │   ├── widget/         ← embeddable bubble widget
│   │   └── api/
│   │       ├── chat/       ← AI response endpoint (uses chat-core)
│   │       └── leads/      ← lead capture endpoint
│   ├── components/
│   │   ├── ChatWindow/
│   │   ├── MessageBubble/
│   │   ├── ServiceCard/
│   │   ├── VoiceToggle/
│   │   └── LeadForm/
│   └── lib/
│       └── chat-client.ts
Port from v1 (logic only):
  • All of packages/chat-core (unchanged)
  • apps/chat/public/widget.js — widget embed logic (review and port)

​
apps/kb-studio → Rebuild

Do not port. Build fresh. 
apps/kb-studio/
├── src/
│   ├── app/
│   │   ├── onboarding/     ← KB generator onboarding flow
│   │   ├── editor/         ← KB management UI
│   │   └── api/
│   │       ├── generate/   ← triggers kb-engine pipeline
│   │       └── publish/    ← publishes KB, emits kb.published event
│   └── components/
│       ├── OnboardingWizard/
│       ├── KBEditor/
│       └── ServiceCardEditor/
Port from v1 (logic only):
  • All of packages/kb-engine (unchanged)
  • apps/kb-studio/kb-ui/kb-editor-spec.md — reference for editor UI design

​
Infrastructure Port Map

v1 resourcev2 actionNotes
Supabase projectKeepUpdate schema via new migrations
DigitalOcean dropletsKeepRedeploy v2 via Dokploy
Dokploy configUpdateNew app paths and build commands
Crawl4AI service (crawl.sec-admn.com)KeepAlready referenced correctly in kb-engine
OpenRouter integrationKeepAlready the inference layer
Stripe accountKeepReconnect to v2 billing module
n8n instanceKeepSeparate from platform rebuild
Port map v1.0 — March 2026 Read alongside: aiConnected-Platform-V2-Build-Plan.md