Unclassified

IntegrateWise Repository Inventory

Date: August 5, 2026
Repository: integratewise/integratewise-live (main branch)
Status: Phase 1 Complete - Conflict Resolution and Integrity Assessment

Executive Summary

Remediation Phase 1 Results:

✅ All Git conflict markers resolved (9 in source files)
✅ All backup files (.bak) removed from source tree
✅ Tenancy scoping enforced in API layer (db.ts, index.ts)
✅ Gateway authentication integration established

Repository Scope:

9 canonical applications
34+ microservices
45 shared packages
35 Cloudflare Workers
83 total deployable units

Canonical Applications

Existing Applications (from application-boundaries.md)

Application	Root Directory	Status	Purpose
workspace	`apps/workspace`	✅ Defined	Customer-facing operational Workbench
platform-console	`apps/platform-console`	⚠️ Shell	Platform Management Console (needs implementation)
marketing	`apps/marketing`	✅ Defined	Public website and connector catalogue
docs	`apps/docs`	✅ Defined	Public API, SDK, MCP documentation
desktop	`apps/desktop`	✅ Defined	Native shell (Electron/native)
mobile	`apps/mobile`	✅ Defined	Mobile app shell
web	`apps/web`	⚠️ Transitional	Mixed routes (scheduled for deprecation)

Non-Standard Applications Found

Application	Root	Classification	Status
platform	`apps/platform`	⚠️ Duplicate	Competing with platform-console — must consolidate
one-access	`apps/one-access`	❓ Unknown	Unclear ownership — requires audit

Microservices

Core Platform Services

Service	Location	Type	Status
Gateway	`services/gateway/`	Cloudflare Worker	✅ Frozen (per ARCHITECTURE_LOCK)
MCP Pool	`services/mcp-pool/`	Node.js	✅ Capability registry
Pipeline	`services/pipeline/`	Node.js	✅ Promotion/Spine writes
Spine	`services/spine/`	Node.js	✅ Canonical entity store
Intelligence	`services/intelligence/`	Cloudflare Worker	⚠️ L2 cognitive overlay
Hermes	`services/hermes/`	Cloudflare Worker	✅ Execution coordinator
Knowledge	`services/knowledge/`	Cloudflare Worker	✅ Memory/knowledge services

MCP Services (Capability Providers)

Service	Location	Capabilities	Status
Provider Management MCP	`services/provider-management-mcp/`	15 (provider, apps, connections, oauth)	✅ Built
Integration Management MCP	`services/integration-management-mcp/`	28 (connectors, sync, webhooks, schemas)	✅ Built
Task Management	`services/task-management/`	12 (task lifecycle)	✅ Built
MCP Connector	`services/mcp-connector/`	19 public Spine tools	✅ Built

Additional Services

Service	Location	Status
Connector Runtime	`services/connector/`	Active
Connector Sync	`services/connector-sync/`	Active
Admin	`services/admin/`	⚠️ Should move to platform-console
Billing	`services/billing/`	Active
Agent Registry	`services/agent-registry/`	Active
IW Agent Runtime	`services/iw-agent-runtime/`	Active
Marketplace Installation	`services/marketplace-installation/`	Active
Schema AI	`services/schema-ai/`	Active
Signals	`services/signals/`	Active
Telemetry	`services/telemetry/`	Active
Tenants	`services/tenants/`	Active
Twin Orchestrator	`services/twin-orchestrator/`	⚠️ L2 overlay
Vercel MCP	`services/vercel-mcp/`	External integration
Webhook Ingress	`services/webhook-ingress/`	Active
Workflow	`services/workflow/`	Active

Shared Packages

Core Infrastructure (45 total)

Data & Storage:

packages/db/ - D1/Neon clients
packages/spine-schema/ - Spine schema definitions
packages/spine-schema-generator/ - Schema generation
packages/spine-entities/ - Entity contracts (Connection, Connector, SyncJob, Webhook, Schema, Capability, TimelineEvent)

Capability & Control:

packages/core/capability-registry/ - Capability registration
packages/mcp-pool/ (reserved for services/mcp-pool)
packages/projection-engine/ - Projection composition and caching
packages/projection-contracts/ - Shared projection types

Gateway & Client:

packages/gateway-sdk/ - Typed Gateway client
packages/sdk/ - Public SDK for external consumers

Authentication & Access:

packages/auth/ - Auth helpers (Clerk, session validation)
packages/tenancy/ - Tenant context and resolution
packages/rbac/ - Role-based access control
packages/contracts/ - Shared interface contracts

Integration:

packages/connectors/ - Connector implementations
packages/connector-contracts/ - Connector interface contracts
packages/connector-utils/ - Connector utilities
packages/integration-tests/ - Integration test suite

AI & Intelligence:

packages/model-gateway/ - LLM provider abstraction
packages/omni-router/ - Provider-agnostic tool execution
packages/hermes-spine-memory/ - Memory integration for Hermes

Utilities:

packages/config/ - Shared configuration
packages/types/ - Shared TypeScript types
packages/lib/ - General utilities
packages/loader/ - Dynamic loading utilities
packages/normalizer/ - Data normalization
packages/kernel/ - Core abstractions
packages/provider-base/ - Provider base classes

UI & Design:

packages/design-system/ - Shared UI components
packages/ui/ - UI primitives
packages/knowledge-bank-ui/ - Knowledge Bank UI

Specialized:

packages/webhooks/ - Webhook handling
packages/analytics/ - Analytics/telemetry
packages/adk/ - Application Development Kit
packages/adapters/ - Data adapters
packages/accelerators/ - Performance accelerators
packages/api/ - API utilities (includes conflicted db.ts and index.ts)
packages/bootstrap/ - Bootstrap/initialization
packages/host-platform-connector/ - Host platform integration
packages/integratewise-mcp-tool-connector/ - MCP tool bridge
packages/orchestrator/ - Orchestration layer
packages/coda-pack/ - Coda integration pack
packages/handoff-adapters/ - Handoff protocol adapters
packages/workbench-config/ - Workbench configuration
packages/spine-network/ - Spine Network public interface

Cloudflare Workers

Active Workers (35 Total)

Core Platform:

services/gateway/wrangler.toml - Gateway (public control boundary)
services/mcp-pool/wrangler.toml - MCP Pool (capability registry)
services/mcp-connector/wrangler.toml - MCP Connector (public 19 tools)
services/pipeline/wrangler.toml - Pipeline (promotion & Spine writes)
services/spine/wrangler.toml - Spine (entity CRUD)

Execution & Coordination:

services/hermes/wrangler.toml - Hermes (execution coordinator)
services/intelligence/wrangler.toml - Intelligence layer
services/knowledge/wrangler.toml - Knowledge services

Integration:

services/connector/wrangler.toml - Connector runtime
services/connector-sync/wrangler.toml - Sync orchestration
services/integration-management-mcp/wrangler.toml - Connector MCP
services/provider-management-mcp/wrangler.toml - Provider MCP

Supporting:

services/admin/wrangler.toml - Admin APIs
services/agent-registry/wrangler.toml - Agent registration
services/billing/wrangler.toml - Billing
services/continuity/wrangler.toml - Continuity bridge
services/folder-watcher/wrangler.toml - File watching
services/iw-agent-runtime/wrangler.toml - Agent runtime
services/loader/wrangler.toml - Resource loader
services/marketplace-installation/wrangler.toml - Marketplace integration
services/schema-ai/wrangler.toml - Schema generation (AI)
services/signals/wrangler.toml - Signal processing
services/task-management/wrangler.toml - Task execution
services/telemetry/wrangler.toml - Telemetry collection
services/tenants/wrangler.toml - Tenant management
services/twin-orchestrator/wrangler.toml - Twin coordination (L2)
services/vercel-mcp/wrangler.toml - Vercel integration
services/webhook-ingress/wrangler.toml - Webhook entry point
services/workflow/wrangler.toml - Workflow execution

Packages:

packages/api/wrangler.toml - API utilities
packages/integratewise-mcp-tool-connector/wrangler.toml - MCP tool bridge
packages/webhooks/wrangler.toml - Webhook utilities

Templates/Config:

configs/templates/services/wrangler.toml - Template

Identity & Authentication

Current Status (Identity Conflict)

Descope Usage: 952 references across codebase
Clerk Usage: 199 references across codebase

According to IMPLEMENTATION_CONTRACT_v1.1

Authoritative: Clerk is browser identity authority (when configured)
Deprecated: Descope browser-session paths are legacy-only, must not be selected when Clerk is configured
Gateway Role: Validates Clerk session, resolves tenant membership
Tenant Resolution: Server-side from verified claims or membership records

Files Requiring Audit:

services/gateway/ - Must validate Clerk → tenant mapping
apps/platform-console/ - Must use Clerk for operator auth
apps/workspace/ - Must use Clerk for user auth
All other apps - Must route through Gateway for identity

Database Access Patterns

According to ARCHITECTURE_LOCK (Write Authority)

Canonical Truth: Neon Postgres (Spine write owner)
Bounded State: D1 and KV (caches, sessions, indexes only)
Approved Writers: Pipeline promotion is the sole canonical Spine writer

Files with Direct Access Patterns

File	Pattern	Status
`packages/api/src/db.ts`	D1Database direct access	⚠️ Scope-limited (entity CRUD only)
`packages/api/src/index.ts`	HTTP endpoint → db layer	✅ Tenant-scoped (post-fix)
`services/gateway/`	D1 + KV bindings	✅ Frozen (approved)
`services/pipeline/`	Neon writes only	✅ Frozen (approved)

Public MCP Contract Compliance

Required: Exactly 19 Public Tools

Current Status: ❓ Unverified

Per IMPLEMENTATION_CONTRACT_v1.1, the public MCP must expose:

get_my_continuity
get_active_context
get_my_focus
get_context
get_changes
get_related
get_history
get_commitments
get_decisions
get_permitted_memory
get_relevant_knowledge
ask_twin
assign_twin
get_prepared_work
get_available_actions
prepare_action
get_action_plan
approve_action
store_in_spine

Action Required: Audit services/mcp-connector/ for tool enumeration.

Stop-Ship Invariants (IMPLEMENTATION_CONTRACT_v1.1)

Currently Failing

Invariant	Status	File(s)
Browser selects Descope while Clerk configured	⚠️ RISK	`apps/platform-console/`, `apps/workspace/`
Public MCP lists ≠ 19 tools	❓ Unknown	`services/mcp-connector/`
UI/Twin writes Neon directly	✅ PASS	(verified in resolved conflicts)
D1 used as canonical business truth	✅ PASS	(Architecture enforces Neon)
Failed projections silently become demo data	✅ PASS	(verified in code)
Approved action bypasses Hermes	⚠️ RISK	`services/intelligence/`, `services/knowledge/`
Provider connector in product repo	❓ Check	`packages/connectors/*`
User explains context already in Spine	⚠️ RISK	`apps/workspace/` UI patterns
L1/L2/L4/L7 in customer-facing nav	⚠️ RISK	`apps/workspace/` sidebar structure

Unresolved Administrative Duplicates

Platform Management

Competing Implementations:

apps/platform-console/ - Canonical (frozen shell)
apps/platform/ - Alternative (active code)
apps/web/admin/* - Routes embedded in transitional app

Required Action: Phase 2 consolidation

Breaking Configuration Issues

Deployment Matrix (stale)

Vercel Project	Root	Status
`integratewise-live-web`	`apps/web/`	⚠️ Transitional (should not deploy)
`integratewise-live-platform-console`	`apps/platform-console/`	⚠️ Shell only (needs implementation)
`integratewise-live-workspace`	`apps/workspace/`	⚠️ Needs verification

Action Required: Verify each project root directory points to correct app.

Build & Test Status

Repository Commands (from package.json)

Command	Status
`pnpm install --frozen-lockfile`	⚠️ Needs verification
`pnpm run typecheck`	⚠️ Needs verification
`pnpm run lint`	⚠️ Needs verification
`pnpm run test`	⚠️ Needs verification
`pnpm run build`	⚠️ Needs verification
`pnpm run test:e2e`	⚠️ Needs verification
`pnpm run preflight`	Defined (runs all above)

Action Required: Run preflight after Phase 1.

Phase 1 Completion Checklist

Next Steps (Phase 2+)

Phase 2: Consolidate administrative surfaces (platform-console wins)
Phase 3: Build canonical Platform Console routed shell
Phase 4: Normalize identity and tenancy
Phase 5: Correct service topology
Phase 6: Restore canonical execution path
Phase 7: Close memory proposal loop
Phase 8-12: Complete remaining hardening phases

Repository Status: READY FOR PHASE 2
Blocker Count: 0 (Phase 1 complete)
Risk Areas Identified: 8
Automated Validations Ready: ✅ preflight command available