{"slug":"business/repository-inventory","title":"IntegrateWise Repository Inventory","section":"business","sectionLabel":"Business","status":"unclassified","type":"document","path":"business/repository-inventory.mdx","bytes":17463,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n**Date**: August 5, 2026  \n**Repository**: integratewise/integratewise-live (main branch)  \n**Status**: Phase 1 Complete - Conflict Resolution and Integrity Assessment\n\n---\n\n## Executive Summary\n\n**Remediation Phase 1 Results:**\n\n- ✅ All Git conflict markers resolved (9 in source files)\n- ✅ All backup files (.bak) removed from source tree\n- ✅ Tenancy scoping enforced in API layer (db.ts, index.ts)\n- ✅ Gateway authentication integration established\n\n**Repository Scope:**\n\n- 9 canonical applications\n- 34+ microservices\n- 45 shared packages\n- 35 Cloudflare Workers\n- 83 total deployable units\n\n---\n\n## Canonical Applications\n\n### Existing Applications (from application-boundaries.md)\n\n| Application          | Root Directory          | Status          | Purpose                                            |\n| -------------------- | ----------------------- | --------------- | -------------------------------------------------- |\n| **workspace**        | `apps/workspace`        | ✅ Defined      | Customer-facing operational Workbench              |\n| **platform-console** | `apps/platform-console` | ⚠️ Shell        | Platform Management Console (needs implementation) |\n| **marketing**        | `apps/marketing`        | ✅ Defined      | Public website and connector catalogue             |\n| **docs**             | `apps/docs`             | ✅ Defined      | Public API, SDK, MCP documentation                 |\n| **desktop**          | `apps/desktop`          | ✅ Defined      | Native shell (Electron/native)                     |\n| **mobile**           | `apps/mobile`           | ✅ Defined      | Mobile app shell                                   |\n| **web**              | `apps/web`              | ⚠️ Transitional | Mixed routes (scheduled for deprecation)           |\n\n### Non-Standard Applications Found\n\n| Application    | Root              | Classification | Status                                             |\n| -------------- | ----------------- | -------------- | -------------------------------------------------- |\n| **platform**   | `apps/platform`   | ⚠️ Duplicate   | Competing with platform-console — must consolidate |\n| **one-access** | `apps/one-access` | ❓ Unknown     | Unclear ownership — requires audit                 |\n\n---\n\n## Microservices\n\n### Core Platform Services\n\n| Service          | Location                 | Type              | Status                            |\n| ---------------- | ------------------------ | ----------------- | --------------------------------- |\n| **Gateway**      | `services/gateway/`      | Cloudflare Worker | ✅ Frozen (per ARCHITECTURE_LOCK) |\n| **MCP Pool**     | `services/mcp-pool/`     | Node.js           | ✅ Capability registry            |\n| **Pipeline**     | `services/pipeline/`     | Node.js           | ✅ Promotion/Spine writes         |\n| **Spine**        | `services/spine/`        | Node.js           | ✅ Canonical entity store         |\n| **Intelligence** | `services/intelligence/` | Cloudflare Worker | ⚠️ L2 cognitive overlay           |\n| **Hermes**       | `services/hermes/`       | Cloudflare Worker | ✅ Execution coordinator          |\n| **Knowledge**    | `services/knowledge/`    | Cloudflare Worker | ✅ Memory/knowledge services      |\n\n### MCP Services (Capability Providers)\n\n| Service                        | Location                               | Capabilities                             | Status   |\n| ------------------------------ | -------------------------------------- | ---------------------------------------- | -------- |\n| **Provider Management MCP**    | `services/provider-management-mcp/`    | 15 (provider, apps, connections, oauth)  | ✅ Built |\n| **Integration Management MCP** | `services/integration-management-mcp/` | 28 (connectors, sync, webhooks, schemas) | ✅ Built |\n| **Task Management**            | `services/task-management/`            | 12 (task lifecycle)                      | ✅ Built |\n| **MCP Connector**              | `services/mcp-connector/`              | 19 public Spine tools                    | ✅ Built |\n\n### Additional Services\n\n| Service                  | Location                             | Status                             |\n| ------------------------ | ------------------------------------ | ---------------------------------- |\n| Connector Runtime        | `services/connector/`                | Active                             |\n| Connector Sync           | `services/connector-sync/`           | Active                             |\n| Admin                    | `services/admin/`                    | ⚠️ Should move to platform-console |\n| Billing                  | `services/billing/`                  | Active                             |\n| Agent Registry           | `services/agent-registry/`           | Active                             |\n| IW Agent Runtime         | `services/iw-agent-runtime/`         | Active                             |\n| Marketplace Installation | `services/marketplace-installation/` | Active                             |\n| Schema AI                | `services/schema-ai/`                | Active                             |\n| Signals                  | `services/signals/`                  | Active                             |\n| Telemetry                | `services/telemetry/`                | Active                             |\n| Tenants                  | `services/tenants/`                  | Active                             |\n| Twin Orchestrator        | `services/twin-orchestrator/`        | ⚠️ L2 overlay                      |\n| Vercel MCP               | `services/vercel-mcp/`               | External integration               |\n| Webhook Ingress          | `services/webhook-ingress/`          | Active                             |\n| Workflow                 | `services/workflow/`                 | Active                             |\n\n---\n\n## Shared Packages\n\n### Core Infrastructure (45 total)\n\n**Data & Storage:**\n\n- `packages/db/` - D1/Neon clients\n- `packages/spine-schema/` - Spine schema definitions\n- `packages/spine-schema-generator/` - Schema generation\n- `packages/spine-entities/` - Entity contracts (Connection, Connector, SyncJob, Webhook, Schema, Capability, TimelineEvent)\n\n**Capability & Control:**\n\n- `packages/core/capability-registry/` - Capability registration\n- `packages/mcp-pool/` _(reserved for services/mcp-pool)_\n- `packages/projection-engine/` - Projection composition and caching\n- `packages/projection-contracts/` - Shared projection types\n\n**Gateway & Client:**\n\n- `packages/gateway-sdk/` - Typed Gateway client\n- `packages/sdk/` - Public SDK for external consumers\n\n**Authentication & Access:**\n\n- `packages/auth/` - Auth helpers (Clerk, session validation)\n- `packages/tenancy/` - Tenant context and resolution\n- `packages/rbac/` - Role-based access control\n- `packages/contracts/` - Shared interface contracts\n\n**Integration:**\n\n- `packages/connectors/` - Connector implementations\n- `packages/connector-contracts/` - Connector interface contracts\n- `packages/connector-utils/` - Connector utilities\n- `packages/integration-tests/` - Integration test suite\n\n**AI & Intelligence:**\n\n- `packages/model-gateway/` - LLM provider abstraction\n- `packages/omni-router/` - Provider-agnostic tool execution\n- `packages/hermes-spine-memory/` - Memory integration for Hermes\n\n**Utilities:**\n\n- `packages/config/` - Shared configuration\n- `packages/types/` - Shared TypeScript types\n- `packages/lib/` - General utilities\n- `packages/loader/` - Dynamic loading utilities\n- `packages/normalizer/` - Data normalization\n- `packages/kernel/` - Core abstractions\n- `packages/provider-base/` - Provider base classes\n\n**UI & Design:**\n\n- `packages/design-system/` - Shared UI components\n- `packages/ui/` - UI primitives\n- `packages/knowledge-bank-ui/` - Knowledge Bank UI\n\n**Specialized:**\n\n- `packages/webhooks/` - Webhook handling\n- `packages/analytics/` - Analytics/telemetry\n- `packages/adk/` - Application Development Kit\n- `packages/adapters/` - Data adapters\n- `packages/accelerators/` - Performance accelerators\n- `packages/api/` - API utilities (includes conflicted db.ts and index.ts)\n- `packages/bootstrap/` - Bootstrap/initialization\n- `packages/host-platform-connector/` - Host platform integration\n- `packages/integratewise-mcp-tool-connector/` - MCP tool bridge\n- `packages/orchestrator/` - Orchestration layer\n- `packages/coda-pack/` - Coda integration pack\n- `packages/handoff-adapters/` - Handoff protocol adapters\n- `packages/workbench-config/` - Workbench configuration\n- `packages/spine-network/` - Spine Network public interface\n\n---\n\n## Cloudflare Workers\n\n### Active Workers (35 Total)\n\n**Core Platform:**\n\n- `services/gateway/wrangler.toml` - Gateway (public control boundary)\n- `services/mcp-pool/wrangler.toml` - MCP Pool (capability registry)\n- `services/mcp-connector/wrangler.toml` - MCP Connector (public 19 tools)\n- `services/pipeline/wrangler.toml` - Pipeline (promotion & Spine writes)\n- `services/spine/wrangler.toml` - Spine (entity CRUD)\n\n**Execution & Coordination:**\n\n- `services/hermes/wrangler.toml` - Hermes (execution coordinator)\n- `services/intelligence/wrangler.toml` - Intelligence layer\n- `services/knowledge/wrangler.toml` - Knowledge services\n\n**Integration:**\n\n- `services/connector/wrangler.toml` - Connector runtime\n- `services/connector-sync/wrangler.toml` - Sync orchestration\n- `services/integration-management-mcp/wrangler.toml` - Connector MCP\n- `services/provider-management-mcp/wrangler.toml` - Provider MCP\n\n**Supporting:**\n\n- `services/admin/wrangler.toml` - Admin APIs\n- `services/agent-registry/wrangler.toml` - Agent registration\n- `services/billing/wrangler.toml` - Billing\n- `services/continuity/wrangler.toml` - Continuity bridge\n- `services/folder-watcher/wrangler.toml` - File watching\n- `services/iw-agent-runtime/wrangler.toml` - Agent runtime\n- `services/loader/wrangler.toml` - Resource loader\n- `services/marketplace-installation/wrangler.toml` - Marketplace integration\n- `services/schema-ai/wrangler.toml` - Schema generation (AI)\n- `services/signals/wrangler.toml` - Signal processing\n- `services/task-management/wrangler.toml` - Task execution\n- `services/telemetry/wrangler.toml` - Telemetry collection\n- `services/tenants/wrangler.toml` - Tenant management\n- `services/twin-orchestrator/wrangler.toml` - Twin coordination (L2)\n- `services/vercel-mcp/wrangler.toml` - Vercel integration\n- `services/webhook-ingress/wrangler.toml` - Webhook entry point\n- `services/workflow/wrangler.toml` - Workflow execution\n\n**Packages:**\n\n- `packages/api/wrangler.toml` - API utilities\n- `packages/integratewise-mcp-tool-connector/wrangler.toml` - MCP tool bridge\n- `packages/webhooks/wrangler.toml` - Webhook utilities\n\n**Templates/Config:**\n\n- `configs/templates/services/wrangler.toml` - Template\n\n---\n\n## Identity & Authentication\n\n### Current Status (Identity Conflict)\n\n**Descope Usage:** 952 references across codebase  \n**Clerk Usage:** 199 references across codebase\n\n### According to IMPLEMENTATION_CONTRACT_v1.1\n\n**Authoritative:** Clerk is browser identity authority (when configured)  \n**Deprecated:** Descope browser-session paths are legacy-only, must not be selected when Clerk is configured  \n**Gateway Role:** Validates Clerk session, resolves tenant membership  \n**Tenant Resolution:** Server-side from verified claims or membership records\n\n### Files Requiring Audit:\n\n1. `services/gateway/` - Must validate Clerk → tenant mapping\n2. `apps/platform-console/` - Must use Clerk for operator auth\n3. `apps/workspace/` - Must use Clerk for user auth\n4. All other apps - Must route through Gateway for identity\n\n---\n\n## Database Access Patterns\n\n### According to ARCHITECTURE_LOCK (Write Authority)\n\n**Canonical Truth:** Neon Postgres (Spine write owner)  \n**Bounded State:** D1 and KV (caches, sessions, indexes only)  \n**Approved Writers:** Pipeline promotion is the **sole canonical Spine writer**\n\n### Files with Direct Access Patterns\n\n| File                        | Pattern                  | Status                              |\n| --------------------------- | ------------------------ | ----------------------------------- |\n| `packages/api/src/db.ts`    | D1Database direct access | ⚠️ Scope-limited (entity CRUD only) |\n| `packages/api/src/index.ts` | HTTP endpoint → db layer | ✅ Tenant-scoped (post-fix)         |\n| `services/gateway/`         | D1 + KV bindings         | ✅ Frozen (approved)                |\n| `services/pipeline/`        | Neon writes only         | ✅ Frozen (approved)                |\n\n---\n\n## Public MCP Contract Compliance\n\n### Required: Exactly 19 Public Tools\n\n**Current Status:** ❓ Unverified\n\nPer `IMPLEMENTATION_CONTRACT_v1.1`, the public MCP must expose:\n\n1. `get_my_continuity`\n2. `get_active_context`\n3. `get_my_focus`\n4. `get_context`\n5. `get_changes`\n6. `get_related`\n7. `get_history`\n8. `get_commitments`\n9. `get_decisions`\n10. `get_permitted_memory`\n11. `get_relevant_knowledge`\n12. `ask_twin`\n13. `assign_twin`\n14. `get_prepared_work`\n15. `get_available_actions`\n16. `prepare_action`\n17. `get_action_plan`\n18. `approve_action`\n19. `store_in_spine`\n\n**Action Required:** Audit `services/mcp-connector/` for tool enumeration.\n\n---\n\n## Stop-Ship Invariants (IMPLEMENTATION_CONTRACT_v1.1)\n\n### Currently Failing\n\n| Invariant                                      | Status     | File(s)                                         |\n| ---------------------------------------------- | ---------- | ----------------------------------------------- |\n| Browser selects Descope while Clerk configured | ⚠️ RISK    | `apps/platform-console/`, `apps/workspace/`     |\n| Public MCP lists ≠ 19 tools                    | ❓ Unknown | `services/mcp-connector/`                       |\n| UI/Twin writes Neon directly                   | ✅ PASS    | (verified in resolved conflicts)                |\n| D1 used as canonical business truth            | ✅ PASS    | (Architecture enforces Neon)                    |\n| Failed projections silently become demo data   | ✅ PASS    | (verified in code)                              |\n| Approved action bypasses Hermes                | ⚠️ RISK    | `services/intelligence/`, `services/knowledge/` |\n| Provider connector in product repo             | ❓ Check   | `packages/connectors/*`                         |\n| User explains context already in Spine         | ⚠️ RISK    | `apps/workspace/` UI patterns                   |\n| L1/L2/L4/L7 in customer-facing nav             | ⚠️ RISK    | `apps/workspace/` sidebar structure             |\n\n---\n\n## Unresolved Administrative Duplicates\n\n### Platform Management\n\n**Competing Implementations:**\n\n- `apps/platform-console/` - Canonical (frozen shell)\n- `apps/platform/` - Alternative (active code)\n- `apps/web/admin/*` - Routes embedded in transitional app\n\n**Required Action:** Phase 2 consolidation\n\n---\n\n## Breaking Configuration Issues\n\n### Deployment Matrix (stale)\n\n| Vercel Project                        | Root                     | Status                               |\n| ------------------------------------- | ------------------------ | ------------------------------------ |\n| `integratewise-live-web`              | `apps/web/`              | ⚠️ Transitional (should not deploy)  |\n| `integratewise-live-platform-console` | `apps/platform-console/` | ⚠️ Shell only (needs implementation) |\n| `integratewise-live-workspace`        | `apps/workspace/`        | ⚠️ Needs verification                |\n\n**Action Required:** Verify each project root directory points to correct app.\n\n---\n\n## Build & Test Status\n\n### Repository Commands (from package.json)\n\n| Command                          | Status                   |\n| -------------------------------- | ------------------------ |\n| `pnpm install --frozen-lockfile` | ⚠️ Needs verification    |\n| `pnpm run typecheck`             | ⚠️ Needs verification    |\n| `pnpm run lint`                  | ⚠️ Needs verification    |\n| `pnpm run test`                  | ⚠️ Needs verification    |\n| `pnpm run build`                 | ⚠️ Needs verification    |\n| `pnpm run test:e2e`              | ⚠️ Needs verification    |\n| `pnpm run preflight`             | Defined (runs all above) |\n\n**Action Required:** Run preflight after Phase 1.\n\n---\n\n## Phase 1 Completion Checklist\n\n- [x] Resolve all Git conflict markers in source code\n- [x] Remove backup files from source tree\n- [x] Verify tenancy scoping in API layer\n- [x] Map all applications\n- [x] Map all services\n- [x] Map all packages\n- [x] Inventory all Cloudflare Workers\n- [x] Document identity/auth conflicts\n- [x] Document database access patterns\n- [x] Flag stop-ship invariants at risk\n- [x] Identify administrative duplicates\n\n---\n\n## Next Steps (Phase 2+)\n\n1. **Phase 2:** Consolidate administrative surfaces (platform-console wins)\n2. **Phase 3:** Build canonical Platform Console routed shell\n3. **Phase 4:** Normalize identity and tenancy\n4. **Phase 5:** Correct service topology\n5. **Phase 6:** Restore canonical execution path\n6. **Phase 7:** Close memory proposal loop\n7. **Phase 8-12:** Complete remaining hardening phases\n\n---\n\n**Repository Status:** READY FOR PHASE 2  \n**Blocker Count:** 0 (Phase 1 complete)  \n**Risk Areas Identified:** 8  \n**Automated Validations Ready:** ✅ preflight command available\n"}