Unclassified

Changelog

All notable changes to IntegrateWise will be documented in this file.

Format based on Keep a Changelog.

[1.1.0] — 2026-08-10

Refactored

OmniRouter Execution Engine (packages/omni-router/)

  • Implemented per-user sliding-window rate limiting — returns RATE_LIMIT_EXCEEDED with retryable flag when threshold exceeded
  • Added automatic credential refresh prior to tool execution — stale tokens are transparently refreshed via executor.refreshCredentials() before retry
  • Tenant-isolated execution cache keys — prefixed with tenantId to prevent cross-tenant cache contamination
  • Corrected concurrency tracking to match against connector.tools list in addition to provider prefix

MCP API Route (apps/web/app/api/mcp/route.ts)

  • MCP tool execution failures now return structured ${error.code}: ${error.message} strings for downstream diagnostic clarity

Monorepo Application Consolidation (apps/)

  • Removed apps/one-access-console — 100% duplicate clone of apps/connector (@integratewise/one-access-connector)
  • Consolidated apps/platform-console into apps/platform — operator surfaces unified under single canonical Platform Control Board
  • Removed stub apps/workspace — workspace runtime projections served directly by apps/web
  • apps/ reduced from 15 to 12 canonical, distinct applications

Platform API Clients & Types

  • Added get(), post(), patch(), delete() HTTP helpers to IntegrateWiseClient
  • Added user optional field to AuthSession interface; useAuthSession() now returns client instance
  • Fixed SpineRelationshipQuery.type → SpineRelationshipQuery.relationshipType alignment
  • Introduced SpineSummaryEntity interface in lib/platform/data.ts for dashboard-level entity projections
  • Added CapabilityId type export to lib/data/types.ts

Test Coverage

  • Added 3 new integration tests in @integratewise/omni-router:
    • refreshes invalid credentials before executing tool
    • enforces sliding window rate limits per user
    • isolates cache keys by tenant ID
  • All 96 tests across monorepo passing (8 omni-router, 88 web)

Build Gate

  • pnpm build: 38/38 monorepo tasks clean
  • pnpm test: 96/96 tests passing

[1.0.0-alpha] — 2026-07-21

Architecture Freeze

This release declares the architecture freeze for the composition layer. The core runtime responsibilities are now clearly separated and documented.

Added

Projection Engine (packages/projection-engine/)

  • Sole composition layer that produces SharedWorkbench
  • ProjectionEngine class with compose(), morningContext(), entity360(), inbox() methods
  • EntityAssembler — transforms raw spine entities into workbench shape
  • RelationshipResolver — builds entity relationship graph
  • CapabilityResolver — discovers and status-maps workspace capabilities
  • GovernanceEvaluator — evaluates policy gates for each capability
  • KnowledgeEnricher — attaches IQ Hub context (topics, learnings, conversations)
  • SignalEnricher — attaches intelligence signals
  • ReadinessCalculator — computes department operational readiness score
  • Smoke tests (3/3 passing)

Frozen SharedWorkbench Contract (contracts/shared-workbench/)

  • v1.ts — Canonical TypeScript types, frozen at v1.0.0
  • schema.json — JSON Schema for validation
  • CHANGELOG.md — Version history and change rules

Architecture Decision Records (docs/adr/)

  • ADR-001: Projection Engine is the sole composition layer
  • ADR-002: SharedWorkbench is the sole composed output
  • ADR-003: Gateway never assembles entities
  • ADR-004: Loader Runtime is the only canonical writer
  • ADR-005: IQ Hub stores derived intelligence only
  • ADR-006: Capability Fabric executes actions
  • ADR-007: Governance at composition and execution

CI Architecture Boundary Checks (scripts/check-architecture-boundaries.mjs)

  • R1: Gateway cannot import connector internals
  • R2: UI packages cannot import backend Spine services directly
  • R3: Only Projection Engine exports SharedWorkbench
  • R4: Projection Engine cannot import UI packages
  • R5: Gateway never constructs SharedWorkbench directly
  • --strict flag for CI enforcement

Package Ownership Docs

  • packages/projection-engine/ARCHITECTURE.md — responsibilities, prohibited behaviors
  • packages/connectors/ARCHITECTURE.md — responsibilities, prohibited behaviors
  • packages/types/OWNERSHIP.md — purpose, dependencies, public APIs
  • packages/core/OWNERSHIP.md — purpose, dependencies, public APIs

Changed

Gateway BFF (services/gateway/)

  • src/projections.ts — Rewrote to delegate all composition to ProjectionEngine
  • Added @integratewise/projection-engine as workspace dependency
  • Gateway now handles only: auth, routing, response formatting

Web App (apps/web/)

  • useSpineData hook now uses projection contracts
  • Governed error panel for operational errors
  • Department-specific workbench views (Sales, HR, Partnerships, etc.)
  • Integrations view reachable from all workspace domains

Removed

  • packages/shared/ — Empty, unused directory

Fixed

  • Blank page in production — lazy Descope init + committed build env
  • task-management — register tasks.watch capability handler
  • schema-ai — pass test script with no test files to unblock pre-push

Architecture Rules (Enforced)

External Systems → Workspace Activation → Connector Runtime → Loader Runtime → Adaptive Spine → Projection Engine → SharedWorkbench → Gateway → Human + Twin → Capability Fabric → External Systems

Closed operational loop. No package may produce SharedWorkbench except the Projection Engine.

[0.x] — 2026-07-15 to 2026-07-20

Added

  • Schema AI service — platform layer between Discovery and Capability Registry
  • Task management scheduling, cron, watch, templates, and MCP pool registrations
  • Marketplace + Connector Activation Pipeline extracted from onboarding
  • Cloudflare Pages deployment contract

Changed

  • Extracted onboarding as standalone route surface
  • Domain docs moved to docs/domains/
  • Repository cleanup — removed .hermes, .iw, docs/status bloat

Fixed

  • Render marketing routes directly instead of blank external redirect
  • Sync pnpm-lock.yaml with services/schema-ai
  • Connector catalog and marketing on Cloudflare restored

[0.x] — 2026-07-01 to 2026-07-14

Added

  • Connector architecture foundation
  • Normalizer service schema matrix
  • Integration tests framework
  • Auth init fallback timeout

Changed

  • Environment config and dependency versions updated
  • CF deploy workflows pointed to root domain integratewise.ai

Versioning

  • Major (X.0.0): Architecture-breaking changes, new runtime layers
  • Minor (0.X.0): New features, capabilities, connector additions
  • Patch (0.0.X): Bug fixes, documentation, configuration changes

Links