{"slug":"documentation/CHANGELOG","title":"Changelog","section":"documentation","sectionLabel":"Documentation","status":"unclassified","type":"document","path":"documentation/CHANGELOG.mdx","bytes":7252,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\nAll notable changes to IntegrateWise will be documented in this file.\n\nFormat based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).\n\n---\n\n## [1.1.0] — 2026-08-10\n\n### Refactored\n\n#### OmniRouter Execution Engine (`packages/omni-router/`)\n\n- Implemented per-user sliding-window rate limiting — returns `RATE_LIMIT_EXCEEDED` with retryable flag when threshold exceeded\n- Added automatic credential refresh prior to tool execution — stale tokens are transparently refreshed via `executor.refreshCredentials()` before retry\n- Tenant-isolated execution cache keys — prefixed with `tenantId` to prevent cross-tenant cache contamination\n- Corrected concurrency tracking to match against `connector.tools` list in addition to provider prefix\n\n#### MCP API Route (`apps/web/app/api/mcp/route.ts`)\n\n- MCP tool execution failures now return structured `${error.code}: ${error.message}` strings for downstream diagnostic clarity\n\n#### Monorepo Application Consolidation (`apps/`)\n\n- Removed `apps/one-access-console` — 100% duplicate clone of `apps/connector` (`@integratewise/one-access-connector`)\n- Consolidated `apps/platform-console` into `apps/platform` — operator surfaces unified under single canonical Platform Control Board\n- Removed stub `apps/workspace` — workspace runtime projections served directly by `apps/web`\n- `apps/` reduced from 15 to 12 canonical, distinct applications\n\n#### Platform API Clients & Types\n\n- Added `get()`, `post()`, `patch()`, `delete()` HTTP helpers to `IntegrateWiseClient`\n- Added `user` optional field to `AuthSession` interface; `useAuthSession()` now returns `client` instance\n- Fixed `SpineRelationshipQuery.type` → `SpineRelationshipQuery.relationshipType` alignment\n- Introduced `SpineSummaryEntity` interface in `lib/platform/data.ts` for dashboard-level entity projections\n- Added `CapabilityId` type export to `lib/data/types.ts`\n\n### Test Coverage\n\n- Added 3 new integration tests in `@integratewise/omni-router`:\n  - `refreshes invalid credentials before executing tool`\n  - `enforces sliding window rate limits per user`\n  - `isolates cache keys by tenant ID`\n- All 96 tests across monorepo passing (8 omni-router, 88 web)\n\n### Build Gate\n\n- `pnpm build`: 38/38 monorepo tasks clean\n- `pnpm test`: 96/96 tests passing\n\n---\n\n## [1.0.0-alpha] — 2026-07-21\n\n### Architecture Freeze\n\nThis release declares the **architecture freeze** for the composition layer. The core runtime responsibilities are now clearly separated and documented.\n\n### Added\n\n#### Projection Engine (`packages/projection-engine/`)\n\n- **Sole composition layer** that produces `SharedWorkbench`\n- `ProjectionEngine` class with `compose()`, `morningContext()`, `entity360()`, `inbox()` methods\n- `EntityAssembler` — transforms raw spine entities into workbench shape\n- `RelationshipResolver` — builds entity relationship graph\n- `CapabilityResolver` — discovers and status-maps workspace capabilities\n- `GovernanceEvaluator` — evaluates policy gates for each capability\n- `KnowledgeEnricher` — attaches IQ Hub context (topics, learnings, conversations)\n- `SignalEnricher` — attaches intelligence signals\n- `ReadinessCalculator` — computes department operational readiness score\n- Smoke tests (3/3 passing)\n\n#### Frozen SharedWorkbench Contract (`contracts/shared-workbench/`)\n\n- `v1.ts` — Canonical TypeScript types, frozen at v1.0.0\n- `schema.json` — JSON Schema for validation\n- `CHANGELOG.md` — Version history and change rules\n\n#### Architecture Decision Records (`docs/adr/`)\n\n- ADR-001: Projection Engine is the sole composition layer\n- ADR-002: SharedWorkbench is the sole composed output\n- ADR-003: Gateway never assembles entities\n- ADR-004: Loader Runtime is the only canonical writer\n- ADR-005: IQ Hub stores derived intelligence only\n- ADR-006: Capability Fabric executes actions\n- ADR-007: Governance at composition and execution\n\n#### CI Architecture Boundary Checks (`scripts/check-architecture-boundaries.mjs`)\n\n- R1: Gateway cannot import connector internals\n- R2: UI packages cannot import backend Spine services directly\n- R3: Only Projection Engine exports SharedWorkbench\n- R4: Projection Engine cannot import UI packages\n- R5: Gateway never constructs SharedWorkbench directly\n- `--strict` flag for CI enforcement\n\n#### Package Ownership Docs\n\n- `packages/projection-engine/ARCHITECTURE.md` — responsibilities, prohibited behaviors\n- `packages/connectors/ARCHITECTURE.md` — responsibilities, prohibited behaviors\n- `packages/types/OWNERSHIP.md` — purpose, dependencies, public APIs\n- `packages/core/OWNERSHIP.md` — purpose, dependencies, public APIs\n\n### Changed\n\n#### Gateway BFF (`services/gateway/`)\n\n- `src/projections.ts` — Rewrote to delegate all composition to `ProjectionEngine`\n- Added `@integratewise/projection-engine` as workspace dependency\n- Gateway now handles only: auth, routing, response formatting\n\n#### Web App (`apps/web/`)\n\n- `useSpineData` hook now uses projection contracts\n- Governed error panel for operational errors\n- Department-specific workbench views (Sales, HR, Partnerships, etc.)\n- Integrations view reachable from all workspace domains\n\n### Removed\n\n- `packages/shared/` — Empty, unused directory\n\n### Fixed\n\n- Blank page in production — lazy Descope init + committed build env\n- `task-management` — register `tasks.watch` capability handler\n- `schema-ai` — pass test script with no test files to unblock pre-push\n\n### Architecture Rules (Enforced)\n\n```\nExternal Systems → Workspace Activation → Connector Runtime → Loader Runtime → Adaptive Spine → Projection Engine → SharedWorkbench → Gateway → Human + Twin → Capability Fabric → External Systems\n```\n\n**Closed operational loop. No package may produce `SharedWorkbench` except the Projection Engine.**\n\n---\n\n## [0.x] — 2026-07-15 to 2026-07-20\n\n### Added\n\n- Schema AI service — platform layer between Discovery and Capability Registry\n- Task management scheduling, cron, watch, templates, and MCP pool registrations\n- Marketplace + Connector Activation Pipeline extracted from onboarding\n- Cloudflare Pages deployment contract\n\n### Changed\n\n- Extracted onboarding as standalone route surface\n- Domain docs moved to `docs/domains/`\n- Repository cleanup — removed `.hermes`, `.iw`, `docs/status` bloat\n\n### Fixed\n\n- Render marketing routes directly instead of blank external redirect\n- Sync `pnpm-lock.yaml` with `services/schema-ai`\n- Connector catalog and marketing on Cloudflare restored\n\n---\n\n## [0.x] — 2026-07-01 to 2026-07-14\n\n### Added\n\n- Connector architecture foundation\n- Normalizer service schema matrix\n- Integration tests framework\n- Auth init fallback timeout\n\n### Changed\n\n- Environment config and dependency versions updated\n- CF deploy workflows pointed to root domain `integratewise.ai`\n\n---\n\n## Versioning\n\n- **Major** (X.0.0): Architecture-breaking changes, new runtime layers\n- **Minor** (0.X.0): New features, capabilities, connector additions\n- **Patch** (0.0.X): Bug fixes, documentation, configuration changes\n\n## Links\n\n- [GitHub Repository](https://github.com/NirmalPrinceJ/integratewise-live)\n- [Architecture Decision Records](docs/adr/)\n- [SharedWorkbench Contract](contracts/shared-workbench/)\n"}