spine-framework 0.1.0

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

@@ -0,0 +1,84 @@
+# 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

@@ -0,0 +1,228 @@
+# 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/functions/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the functions directory is tracked by git