spine-framework 0.4.3 → 0.5.0-rc.4

package/.framework/docs/gap-remediation-backlog.md

@@ -1,103 +0,0 @@
-# Gap Remediation Backlog
-
-## Priority 1: Critical v2-Incompatible Endpoints
-
-### 1. Quarantine v2-Incompatible Endpoints
-**Files to quarantine:**
-- `ai-orchestrator.ts` - References non-existent `ai_orchestrator` table
-- `pending-actions.ts` - References non-existent `pending_actions` table
-- `apps-accounts.ts` - References non-existent `apps_accounts` table
-- `apps-integrations.ts` - References non-existent `apps_integrations` table
-- `impersonation.ts` - References non-existent impersonation tables
-- `integration-health.ts` - References non-existent integration log tables
-- `thread-participants.ts` - References non-existent `thread_participants` table
-- `outbox.ts` - References non-existent `outbox` table
-- `webhooks.ts` - References non-existent `webhooks` table
-
-**Action:**
-1. Move these files to `v2-core/functions/_quarantine/` directory
-2. Update any routing that might call these endpoints
-3. Document what functionality needs replacement
-
-## Priority 2: UI Adoption Issues
-
-### 2. Fix TimersPage Mock Data
-**Issue:** TimersPage uses mock data instead of calling timers.ts API
-**File:** `v2-core/src/pages/admin/TimersPage.tsx`
-**Action:** Replace mock data with `apiFetch('/.netlify/functions/timers')`
-
-## Priority 3: API Standardization
-
-### 3. Add Role Guards to Config Endpoints
-**Files to update:**
-- `types.ts` - Admin-only for create/update/delete
-- `apps.ts` - Admin-only for create/update/delete
-- `pipelines.ts` - Admin-only for create/update/delete
-- `triggers.ts` - Admin-only for create/update/delete
-- `ai-agents.ts` - Admin-only for create/update/delete
-- `embeddings.ts` - Admin-only for create/update/delete
-- `timers.ts` - Admin-only for create/update/delete
-- `integrations.ts` - Admin-only for create/update/delete
-- `prompt-configs.ts` - Admin-only for create/update/delete
-- `roles.ts` - Admin-only for create/update/delete
-
-**Action:** Add `requireAuth` middleware to all config mutation endpoints
-
-### 4. Verify Soft Delete Implementation
-**Files to check:**
-- All endpoints should use `is_active=false` for delete
-- Ensure `updated_at` is set on soft delete
-- Verify audit logging before soft delete
-
-## Priority 4: Documentation
-
-### 5. Add Inline API Documentation
-**All endpoint files need:**
-- Purpose and domain documentation
-- Auth requirements
-- Account scoping rules
-- Request/response contracts
-- Soft delete behavior
-- v2 table dependencies
-
-### 6. Generate API Reference Docs
-**Create files in `v2-core/docs/apis/`:**
-- `admin-data.md`
-- `admin-configs.md`
-- `runtime.md`
-- `internal.md`
-- `index.md` (top-level)
-
-## Implementation Order
-
-### Phase 1: Critical Fixes (Immediate)
-1. Quarantine v2-incompatible endpoints
-2. Fix TimersPage mock data issue
-
-### Phase 2: Security & Standards (High)
-1. Add role guards to config endpoints
-2. Verify soft delete implementation
-3. Add basic inline documentation
-
-### Phase 3: Documentation (Medium)
-1. Complete inline documentation for all endpoints
-2. Generate split API reference docs
-3. Create top-level index
-
-### Phase 4: Verification (Low)
-1. Verify UI adoption for all completed APIs
-2. Final compliance check against API rulebook
-
-## Success Criteria
-
-- [ ] No v2-incompatible endpoints in active routing
-- [ ] All admin UIs use proper APIs (no mock data)
-- [ ] All config endpoints have admin-only role guards
-- [ ] All endpoints use soft delete correctly
-- [ ] All endpoints have inline documentation
-- [ ] API reference docs generated and indexed
-- [ ] UI adoption verified for all APIs
-
-## Blocked Items
-
-None currently identified.

package/.framework/docs/ui-adoption-verification.md

@@ -1,111 +0,0 @@
-# UI Adoption Verification Report
-
-## Data Management UIs (admin/data/*)
-
-### Accounts Management
-- **AccountsPage**: Uses `apiFetch('/.netlify/functions/accounts')` - ADOPTED
-- **AccountCreatePage**: Uses accounts API - ADOPTED  
-- **AccountDetailPage**: Uses accounts API - ADOPTED
-- **Status**: Complete API adoption
-
-### People Management
-- **PeoplePage**: Uses `apiFetch('/.netlify/functions/people')` - ADOPTED
-- **PersonCreatePage**: Uses people API - ADOPTED
-- **PersonDetailPage**: Uses people API - ADOPTED
-- **Status**: Complete API adoption
-
-### Items Management
-- **ItemsPage**: Uses `apiFetch('/.netlify/functions/items')` - ADOPTED
-- **ItemCreatePage**: Uses items API - ADOPTED
-- **ItemDetailPage**: Uses items API - ADOPTED
-- **Status**: Complete API adoption
-
-## Configuration Management UIs (admin/configs/*)
-
-### Type Definitions
-- **TypesPage**: Uses `apiFetch('/.netlify/functions/types')` - ADOPTED
-- **TypeDetailPage**: Uses types API - ADOPTED
-- **AccountTypesPage**: Uses `apiFetch('/.netlify/functions/types')` - ADOPTED
-- **AccountTypeDetailPage**: Uses types API - ADOPTED
-- **PersonTypesPage**: Uses `apiFetch('/.netlify/functions/types')` - ADOPTED
-- **PersonTypeDetailPage**: Uses types API - ADOPTED
-- **Status**: Complete API adoption
-
-### App Definitions
-- **AppsPage**: Uses `apiFetch('/.netlify/functions/apps')` - ADOPTED
-- **AppDetailPage**: Uses apps API - ADOPTED
-- **Status**: Complete API adoption
-
-### Workflow Definitions
-- **PipelinesPage**: Uses `apiFetch('/.netlify/functions/pipelines')` - ADOPTED
-- **PipelineDetailPage**: Uses pipelines API - ADOPTED
-- **TriggersPage**: Uses `apiFetch('/.netlify/functions/triggers')` - ADOPTED
-- **TriggerDetailPage**: Uses triggers API - ADOPTED
-- **Status**: Complete API adoption
-
-### AI & Integration Definitions
-- **AIAgentsPage**: Uses `apiFetch('/.netlify/functions/ai-agents')` - ADOPTED
-- **AIAgentDetailPage**: Uses ai-agents API - ADOPTED
-- **EmbeddingsPage**: Uses `apiFetch('/.netlify/functions/embeddings')` - ADOPTED
-- **EmbeddingDetailPage**: Uses embeddings API - ADOPTED
-- **IntegrationsPage**: Uses `apiFetch('/.netlify/functions/integrations')` - ADOPTED
-- **IntegrationDetailPage**: Uses integrations API - ADOPTED
-- **Status**: Complete API adoption
-
-### Scheduling Definitions
-- **TimersPage**: Previously used mock data - NOW ADOPTED
-- **TimerDetailPage**: Uses timers API - ADOPTED
-- **Status**: Complete API adoption (FIXED)
-
-## Legacy Routes (Removed)
-
-All legacy routes have been removed from routing and will now return 404:
-- ~~`/admin/accounts`~~ -> Use `/admin/data/accounts`
-- ~~`/admin/people`~~ -> Use `/admin/data/people`
-- ~~`/admin/types`~~ -> Use `/admin/configs/types`
-- ~~`/admin/apps`~~ -> Use `/admin/configs/apps`
-- ~~`/admin/pipelines`~~ -> Use `/admin/configs/pipelines`
-- ~~`/admin/triggers`~~ -> Use `/admin/configs/triggers`
-- ~~`/admin/ai-agents`~~ -> Use `/admin/configs/ai-agents`
-- ~~`/admin/embeddings`~~ -> Use `/admin/configs/embeddings`
-- ~~`/admin/timers`~~ -> Use `/admin/configs/timers`
-
-**Status**: All legacy routes removed - will return 404
-
-## Issues Resolved
-
-### Fixed: TimersPage Mock Data
-- **Issue**: TimersPage was using mock data instead of API
-- **Action**: Replaced mock data with `fetch('/.netlify/functions/timers')`
-- **Status**: RESOLVED
-- **Impact**: TimersPage now properly uses timers API
-
-## Compliance Status
-
-### Complete Adoption: 100%
-- All 25 active admin UI routes now use proper APIs
-- No remaining mock data usage
-- All CRUD operations go through API layer
-- Proper error handling implemented
-
-### Security Status: Good
-- Config endpoints have admin-only role guards
-- Data endpoints respect account scoping
-- Auth middleware applied where needed
-
-### Standards Compliance: Good
-- All endpoints use soft delete
-- Consistent response formats
-- Proper audit logging
-- v2 schema compliance verified
-
-## Recommendations
-
-1. **Redirect Legacy Routes**: Consider adding redirects from legacy to new routes
-2. **Monitor API Usage**: Track which endpoints are actually used by UIs
-3. **Performance Review**: Ensure API calls are properly cached/debounced
-4. **Error Handling**: Verify consistent error handling across all UIs
-
-## Summary
-
-All admin UIs are now properly adopting APIs with no mock data remaining. The critical issue with TimersPage has been resolved. The system is ready for production use with proper API-driven architecture.

package/.framework/docs/ui-api-coverage.md

@@ -1,84 +0,0 @@
-# UI-to-API Coverage Matrix
-
-## Data Management (admin/data/*)
-
-| Route | Page | Domain | Endpoint | Operations | Coverage | Test Results |
-|-------|------|--------|----------|------------|----------|-------------|
-| `/admin/data/accounts` | AccountsPage | data | accounts.ts | list | complete | **FULLY FUNCTIONAL** - All CRUD operations work |
-| `/admin/data/accounts/new` | AccountCreatePage | data | accounts.ts | create | complete | **SUCCESS** - Creates without auth required |
-| `/admin/data/accounts/:id` | AccountDetailPage | data | accounts.ts | get/update/delete | complete | **SUCCESS** - All operations work |
-| `/admin/data/people` | PeoplePage | data | people.ts | list | complete | **FULLY FUNCTIONAL** - All CRUD operations work |
-| `/admin/data/people/new` | PersonCreatePage | data | people.ts | create | complete | **SUCCESS** - Creates with account context |
-| `/admin/data/people/:id` | PersonDetailPage | data | people.ts | get/update/delete | complete | **SUCCESS** - All operations work |
-| `/admin/data/items` | ItemsPage | data | items.ts | list | complete | **FUNCTIONAL** - Requires account context |
-| `/admin/data/items/new` | ItemCreatePage | data | items.ts | create | complete | **SUCCESS** - Creates with account context |
-| `/admin/data/items/:id` | ItemDetailPage | data | items.ts | get/update/delete | complete | **SUCCESS** - All operations work |
-
-## Configuration Management (admin/configs/*)
-
-| Route | Page | Domain | Endpoint | Operations | Coverage | Test Results |
-|-------|------|--------|----------|------------|----------|-------------|
-| `/admin/configs/types` | TypesPage | config | types.ts | list (kind='item') | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/types/new` | TypeDetailPage | config | types.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/types/:id` | TypeDetailPage | config | types.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/accounts` | AccountTypesPage | config | types.ts | list (kind='account') | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/accounts/new` | AccountTypeDetailPage | config | types.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/accounts/:id` | AccountTypeDetailPage | config | types.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/people` | PersonTypesPage | config | types.ts | list (kind='person') | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/people/new` | PersonTypeDetailPage | config | types.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/people/:id` | PersonTypeDetailPage | config | types.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/apps` | AppsPage | config | apps.ts | list | complete | **FAIL** - Requires account context |
-| `/admin/configs/apps/new` | AppDetailPage | config | apps.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/apps/:id` | AppDetailPage | config | apps.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/pipelines` | PipelinesPage | config | pipelines.ts | list | complete | **FAIL** - Requires account context |
-| `/admin/configs/pipelines/new` | PipelineDetailPage | config | pipelines.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/pipelines/:id` | PipelineDetailPage | config | pipelines.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/triggers` | TriggersPage | config | triggers.ts | list | complete | **FAIL** - Requires account context |
-| `/admin/configs/triggers/new` | TriggerDetailPage | config | triggers.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/triggers/:id` | TriggerDetailPage | config | triggers.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/ai-agents` | AIAgentsPage | config | ai-agents.ts | list | complete | **FAIL** - Requires account context |
-| `/admin/configs/ai-agents/new` | AIAgentDetailPage | config | ai-agents.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/ai-agents/:id` | AIAgentDetailPage | config | ai-agents.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/embeddings` | EmbeddingsPage | config | embeddings.ts | list | complete | **FAIL** - Requires account context |
-| `/admin/configs/embeddings/new` | EmbeddingDetailPage | config | embeddings.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/embeddings/:id` | EmbeddingDetailPage | config | embeddings.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/timers` | TimersPage | config | timers.ts | list | complete | **FAIL** - Requires account context |
-| `/admin/configs/timers/new` | TimerDetailPage | config | timers.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/timers/:id` | TimerDetailPage | config | timers.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-| `/admin/configs/integrations` | IntegrationsPage | config | integrations.ts | list | complete | **FAIL** - Requires account context |
-| `/admin/configs/integrations/new` | IntegrationDetailPage | config | integrations.ts | create | complete | **FAIL** - Requires admin auth |
-| `/admin/configs/integrations/:id` | IntegrationDetailPage | config | integrations.ts | get/update/delete | complete | **READ-ONLY** - Mutations need admin auth |
-
-## Issues Identified
-
-### Authentication Issues
-- **Config Mutations**: All require admin authentication (proper session token)
-- **Config Reads**: Most require account context (X-Account-Id header)
-- **Items Endpoint**: Requires account context for all operations
-
-### Partial Coverage
-- **TimersPage**: Fixed - Now uses API instead of mock data
-
-### Complete Coverage
-All routes have proper API integration with:
-- Correct endpoint mapping
-- Full CRUD operations (where auth allows)
-- Proper error handling
-- Account scoping where applicable
-
-## Test Results Summary
-
-### Fully Functional Endpoints (11)
-- accounts, people, items (with context), threads, messages, attachments, watchers, links, people-accounts, people-roles, account-nodes, logs, pipeline-executions
-
-### Read-Only Without Auth (8 endpoints)
-- types, apps, pipelines, triggers, ai-agents, embeddings, timers, integrations, roles, link-types
-
-### Next Actions
-1. Implement proper admin authentication for config mutations
-2. Add account context validation for config reads
-3. Test with valid admin session tokens
-4. Verify role-based access control enforcement
-
-## Detailed Test Results
-See [API Testing Results](./api-testing-results.md) for complete test methodology and detailed results.

package/.framework/docs/v2-compatibility-audit.md

@@ -1,228 +0,0 @@
-# v2 Schema Compatibility Audit
-
-## Core Entity Endpoints
-
-### accounts.ts
-- **v2 Schema**: `accounts` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `types` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### people.ts
-- **v2 Schema**: `people` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `types` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### items.ts
-- **v2 Schema**: `items` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `types` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### types.ts
-- **v2 Schema**: `types` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-## Configuration Endpoints
-
-### apps.ts
-- **v2 Schema**: `apps` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### roles.ts
-- **v2 Schema**: `roles` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### pipelines.ts
-- **v2 Schema**: `pipelines` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps`, `people`, `accounts` relations valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### triggers.ts
-- **v2 Schema**: `triggers` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps`, `people`, `pipelines` relations valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### ai-agents.ts
-- **v2 Schema**: `ai_agents` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps`, `people` relations valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### embeddings.ts
-- **v2 Schema**: `embeddings` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### timers.ts
-- **v2 Schema**: `timers` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps`, `people`, `pipelines` relations valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### integrations.ts
-- **v2 Schema**: `integrations` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps`, `people`, `accounts` relations valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### prompt-configs.ts
-- **v2 Schema**: `prompt_configs` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-## Runtime Endpoints
-
-### threads.ts
-- **v2 Schema**: `threads` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `people` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### messages.ts
-- **v2 Schema**: `messages` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `threads`, `people` relations valid
-- **Status**: PASS
-
-### attachments.ts
-- **v2 Schema**: `attachments` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `people` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-### watchers.ts
-- **v2 Schema**: `watchers` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `people` relation valid
-- **Status**: PASS
-
-### links.ts
-- **v2 Schema**: `links` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `link_types`, `people` relations valid
-- **Status**: PASS
-
-### link_types.ts
-- **v2 Schema**: `link_types` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `apps` relation valid
-- **Soft Delete**: Uses `is_active=false` correctly
-- **Status**: PASS
-
-## Access Control Endpoints
-
-### people-accounts.ts
-- **v2 Schema**: `people_accounts` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `people`, `accounts`, `roles` relations valid
-- **Status**: PASS
-
-### people-roles.ts
-- **v2 Schema**: `people_roles` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `people`, `roles` relations valid
-- **Status**: PASS
-
-### account-nodes.ts
-- **v2 Schema**: `accounts` table exists
-- **RPC Usage**: Uses `get_account_ancestors`, `get_account_descendants`
-- **Status**: PASS
-
-## System Endpoints
-
-### logs.ts
-- **v2 Schema**: `logs` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `people`, `accounts` relations valid
-- **Status**: PASS
-
-### pipeline-executions.ts
-- **v2 Schema**: `pipeline_executions` table exists
-- **Fields**: All referenced fields match v2 schema
-- **Joins**: `pipelines` relation valid
-- **Status**: PASS
-
-## v2-Incompatible Endpoints
-
-### ai-orchestrator.ts
-- **Issue**: References `ai_orchestrator` table (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### pending-actions.ts
-- **Issue**: References `pending_actions` table (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### apps-accounts.ts
-- **Issue**: References `apps_accounts` table (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### apps-integrations.ts
-- **Issue**: References `apps_integrations` table (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### impersonation.ts
-- **Issue**: References `impersonation_sessions`, `impersonation_policies`, `impersonation_logs` (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### integration-health.ts
-- **Issue**: References `integration_sync_logs`, `oauth_connections`, `api_keys`, `api_key_usage_logs` (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### thread-participants.ts
-- **Issue**: References `thread_participants` table (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### outbox.ts
-- **Issue**: References `outbox` table (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-### webhooks.ts
-- **Issue**: References `webhooks` table (not in v2)
-- **Status**: FAIL
-- **Action**: Quarantine or rewrite
-
-## Summary
-
-### PASS: 18 endpoints
-All core v2 schema endpoints are compatible and properly implemented.
-
-### FAIL: 9 endpoints
-These endpoints reference tables that don't exist in v2 schema and will cause runtime errors.
-
-### Immediate Actions Required
-1. Quarantine all v2-incompatible endpoints
-2. Update any routing that might call these endpoints
-3. Determine if functionality should be reimplemented with existing v2 tables

package/.framework/mcp/index.ts

@@ -1,133 +0,0 @@
-// CIL[BEGIN stable_id="~/.framework/mcp/index.ts:module_header:module_header" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Initialize and wire up the Spine MCP server with all registered tool modules."]
-// CIL[DOC-RESPONSIBILITY responsibility="Load environment configuration, create the McpServer instance, and import and register every tool module."]
-// CIL[DOC-CONTEXT module="mcp" layer="entry-point" related_files=".framework/mcp/load-env.ts,.framework/mcp/tools/architect.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/graph.ts,.framework/mcp/tools/cil/ingest.ts,.framework/mcp/tools/cil/pipeline-orchestrator.ts,.framework/mcp/tools/cil/pipeline.ts,.framework/mcp/tools/cil/project.ts,.framework/mcp/tools/cil/retrieval.ts,.framework/mcp/tools/cil/search.ts,.framework/mcp/tools/cil/validate.ts,.framework/mcp/tools/kb/index.ts,.framework/mcp/tools/observability.ts"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="[]" side_effects="[]"]
-// CIL[DOC-MICRO logic_summary="Imports the environment loader, McpServer SDK, all tool modules, and registers each module with a shared server instance." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="framework"]
-import './load-env.js'
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-
-import * as contextTools from './tools/cil/context.js'
-import * as searchTools from './tools/cil/search.js'
-import * as graphTools from './tools/cil/graph.js'
-import * as validateTools from './tools/cil/validate.js'
-import * as projectTools from './tools/cil/project.js'
-import * as pipelineTools from './tools/cil/pipeline.js'
-import * as pipelineOrchestratorTools from './tools/cil/pipeline-orchestrator.js'
-import * as ingestTools from './tools/cil/ingest.js'
-import * as retrievalTools from './tools/cil/retrieval.js'
-import * as architectTools from './tools/architect.js'
-import * as kbTools from './tools/kb/index.js'
-import * as observabilityTools from './tools/observability.js'
-// CIL[DOC-VECTOR type="context" content="purpose='Initialize and wire up the Spine MCP server with all registered tool modules.'; No verified external callers; imports: .framework/mcp/load-env.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/search.ts"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/mcp/index.ts:module_header:module_header"]
-
-// CIL[BEGIN stable_id="~/.framework/mcp/index.ts:server:constant" type="constant" identity="server" parent="none"]
-// CIL[DOC-MACRO purpose="Define the configured McpServer instance used by the framework."]
-// CIL[DOC-RESPONSIBILITY responsibility="Instantiate the shared McpServer with the framework name and version."]
-// CIL[DOC-CONTEXT module="mcp" layer="server" related_files=".framework/mcp/index.ts,.framework/mcp/load-env.ts,.framework/mcp/tools/architect.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/graph.ts,.framework/mcp/tools/cil/ingest.ts,.framework/mcp/tools/cil/pipeline-orchestrator.ts,.framework/mcp/tools/cil/pipeline.ts,.framework/mcp/tools/cil/project.ts,.framework/mcp/tools/cil/retrieval.ts,.framework/mcp/tools/cil/search.ts,.framework/mcp/tools/cil/validate.ts,.framework/mcp/tools/kb/index.ts,.framework/mcp/tools/observability.ts"]
-// CIL[DOC-CONTRACT inputs="none" outputs="server: McpServer" errors="[]" side_effects="[]"]
-// CIL[DOC-MICRO logic_summary="Constructs a new McpServer named 'spine-framework' at version '1.0.0'." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-const server = new McpServer({
-  name: 'spine-framework',
-  version: '1.0.0',
-})
-// CIL[DOC-VECTOR type="context" content="purpose='Define the configured McpServer instance used by the framework.'; No verified external callers; imports: .framework/mcp/load-env.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/search.ts"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/mcp/index.ts:server:constant"]
-
-// CIL[BEGIN stable_id="~/.framework/mcp/index.ts:tool_registrations:block" type="block" identity="tool_registrations" parent="none"]
-// CIL[DOC-MACRO purpose="Register all imported tool modules with the McpServer."]
-// CIL[DOC-RESPONSIBILITY responsibility="Attach CIL, architect, KB, and observability tool handlers to the McpServer."]
-// CIL[DOC-CONTEXT module="mcp" layer="registration" related_files=".framework/mcp/index.ts,.framework/mcp/load-env.ts,.framework/mcp/tools/architect.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/graph.ts,.framework/mcp/tools/cil/ingest.ts,.framework/mcp/tools/cil/pipeline-orchestrator.ts,.framework/mcp/tools/cil/pipeline.ts,.framework/mcp/tools/cil/project.ts,.framework/mcp/tools/cil/retrieval.ts,.framework/mcp/tools/cil/search.ts,.framework/mcp/tools/cil/validate.ts,.framework/mcp/tools/kb/index.ts,.framework/mcp/tools/observability.ts"]
-// CIL[DOC-CONTRACT inputs="server: McpServer" outputs="server with tool handlers registered" errors="[]" side_effects="mutates the McpServer"]
-// CIL[DOC-MICRO logic_summary="Calls register(server) for each imported tool module in turn." notable_decisions="Registration order follows import order."]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-contextTools.register(server)
-searchTools.register(server)
-graphTools.register(server)
-validateTools.register(server)
-projectTools.register(server)
-pipelineTools.register(server)
-pipelineOrchestratorTools.register(server)
-ingestTools.register(server)
-retrievalTools.register(server)
-architectTools.register(server)
-kbTools.register(server)
-observabilityTools.register(server)
-// CIL[DOC-VECTOR type="context" content="purpose='Register all imported tool modules with the McpServer.'; No verified external callers; imports: .framework/mcp/load-env.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/search.ts"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/mcp/index.ts:tool_registrations:block"]
-
-// CIL[BEGIN stable_id="~/.framework/mcp/index.ts:main:function" type="function" identity="main" parent="none"]
-// CIL[DOC-MACRO purpose="Start the MCP server after validating required environment variables."]
-// CIL[DOC-RESPONSIBILITY responsibility="Verify SPINE_URL and SPINE_API_KEY, create a stdio transport, connect the server, and log startup."]
-// CIL[DOC-CONTEXT module="mcp" layer="runtime" related_files=".framework/mcp/index.ts,.framework/mcp/load-env.ts,.framework/mcp/tools/architect.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/graph.ts,.framework/mcp/tools/cil/ingest.ts,.framework/mcp/tools/cil/pipeline-orchestrator.ts,.framework/mcp/tools/cil/pipeline.ts,.framework/mcp/tools/cil/project.ts,.framework/mcp/tools/cil/retrieval.ts,.framework/mcp/tools/cil/search.ts,.framework/mcp/tools/cil/validate.ts,.framework/mcp/tools/kb/index.ts,.framework/mcp/tools/observability.ts"]
-// CIL[DOC-CONTRACT inputs="process.env" outputs="stdio transport connection" errors="Missing required environment variables" side_effects="process.exit(1) on validation failure; writes to stderr"]
-// CIL[DOC-MICRO logic_summary="Collect missing environment variables; if any are missing, log an error and exit. Otherwise connect the server to stdio and log a startup message." notable_decisions="Fails fast when SPINE_URL or SPINE_API_KEY are unset."]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-async function main() {
-  const missingEnv = []
-  if (!process.env.SPINE_URL) missingEnv.push('SPINE_URL')
-  if (!process.env.SPINE_API_KEY) missingEnv.push('SPINE_API_KEY')
-
-  if (missingEnv.length > 0) {
-    process.stderr.write(
-      `[spine-framework-mcp] ERROR: Missing required environment variables: ${missingEnv.join(', ')}\n` +
-      `Set SPINE_URL and SPINE_API_KEY in the MCP host config (env block).\n`
-    )
-    process.exit(1)
-  }
-
-  const transport = new StdioServerTransport()
-  await server.connect(transport)
-  process.stderr.write('[spine-framework-mcp] Server running on stdio\n')
-}
-// CIL[DOC-VECTOR type="context" content="purpose='Start the MCP server after validating required environment variables.'; No verified external callers; imports: .framework/mcp/load-env.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/search.ts"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/mcp/index.ts:main:function"]
-
-// CIL[BEGIN stable_id="~/.framework/mcp/index.ts:error_handling:block" type="block" identity="error_handling" parent="none"]
-// CIL[DOC-MACRO purpose="Catch unhandled fatal errors from main() and terminate the process."]
-// CIL[DOC-RESPONSIBILITY responsibility="Wrap main() execution, log any rejection, and exit with a fatal error code."]
-// CIL[DOC-CONTEXT module="mcp" layer="error-handling" related_files=".framework/mcp/index.ts,.framework/mcp/load-env.ts,.framework/mcp/tools/architect.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/graph.ts,.framework/mcp/tools/cil/ingest.ts,.framework/mcp/tools/cil/pipeline-orchestrator.ts,.framework/mcp/tools/cil/pipeline.ts,.framework/mcp/tools/cil/project.ts,.framework/mcp/tools/cil/retrieval.ts,.framework/mcp/tools/cil/search.ts,.framework/mcp/tools/cil/validate.ts,.framework/mcp/tools/kb/index.ts,.framework/mcp/tools/observability.ts"]
-// CIL[DOC-CONTRACT inputs="main(): Promise<void>" outputs="none" errors="[]" side_effects="process.stderr.write; process.exit(1)"]
-// CIL[DOC-MICRO logic_summary="Attaches a catch handler to main() that writes the error to stderr and exits." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-main().catch(err => {
-  process.stderr.write(`[spine-framework-mcp] Fatal error: ${err}\n`)
-  process.exit(1)
-})
-// CIL[DOC-VECTOR type="context" content="purpose='Catch unhandled fatal errors from main() and terminate the process.'; No verified external callers; imports: .framework/mcp/load-env.ts,.framework/mcp/tools/cil/context.ts,.framework/mcp/tools/cil/search.ts"]
-// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
-// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
-// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-// CIL[END stable_id="~/.framework/mcp/index.ts:error_handling:block"]