spine-framework-cortex 0.1.1 → 0.1.5

package/README.md

@@ -0,0 +1,27 @@
+# spine-framework-cortex
+
+AI-powered support, CRM, and knowledge base app for Spine Framework.
+
+## Installation
+
+```bash
+npm install spine-framework-cortex
+```
+
+## Usage
+
+```bash
+npx spine-framework install-app cortex
+```
+
+## Features
+
+- Knowledge Base (KB) management with AI-powered article generation
+- Support ticket routing with AI triage
+- Anonymous visitor tracking and funnel signal processing
+- Opportunity queue for high-engagement prospects
+- Case analysis and resolution tracking
+
+## License
+
+MIT

package/functions/webhook-handlers.ts

@@ -0,0 +1,28 @@
+/**
+ * Webhook Handler Self-Registration
+ *
+ * Registers custom webhook handlers in the dynamic `webhook_handlers` table.
+ * Core resolves handlers at runtime via `webhook-registry.ts` — no static imports needed.
+ *
+ * To add a new handler:
+ * 1. Create custom/functions/custom_{name}.ts with a default export function
+ * 2. Add a registerWebhookHandler() call below
+ * 3. Set integration config handler.path = the handler name
+ */
+
+import { registerWebhookHandler } from './_shared/webhook-registration'
+
+// Self-register on module load (idempotent)
+registerWebhookHandler({
+  name: 'cortex-handler',
+  functionName: 'custom_cortex-handler',
+  description: 'Cortex integration webhook handler',
+  events: ['integration.webhook'],
+}).catch(console.error)
+
+registerWebhookHandler({
+  name: 'funnel-signal',
+  functionName: 'custom_funnel-signal',
+  description: 'Funnel signal processing webhook handler',
+  events: ['integration.webhook'],
+}).catch(console.error)

package/lib/resolveTypeId.ts

@@ -0,0 +1,16 @@
+// Frontend type ID resolution — never hardcode UUIDs in custom app code.
+// IDs differ on every fresh install; always resolve by slug at call time.
+
+import { apiFetch } from '@core/lib/api'
+
+const cache: Record<string, string> = {}
+
+export async function resolveTypeId(slug: string): Promise<string> {
+  if (cache[slug]) return cache[slug]
+
+  const data = await apiFetch(`/.netlify/functions/types?action=getBySlug&slug=${encodeURIComponent(slug)}`)
+  if (!data?.id) throw new Error(`Type not found: ${slug}`)
+
+  cache[slug] = data.id
+  return data.id
+}

package/manifest.json

@@ -3,7 +3,7 @@
   "slug": "cortex",
   "description": "Unified workspace for CRM, Support, Community, and Knowledge Base",
   "version": "1.0.0",
-  "required_roles": ["member"],
+  "required_roles": ["support"],
   "routes": [
     "/cortex",
     "/cortex/dashboard",
@@ -78,5 +78,6 @@
   "features": ["crm", "support", "community", "kb", "courses", "intelligence"],
   "dependencies": ["items", "accounts", "pipelines", "integrations"],
   "entry_point": "./index.tsx",
+  "directories": ["pages", "components", "hooks", "config", "seed", "functions", "migrations", "tests"],
   "sidebar_component": "./components/CortexSidebar.tsx"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework-cortex",
-  "version": "0.1.1",
+  "version": "0.1.5",
   "description": "Cortex — AI-powered support, CRM, and knowledge base app for Spine Framework",
   "type": "module",
   "license": "MIT",
@@ -19,6 +19,7 @@
     "pages/",
     "components/",
     "functions/",
+    "lib/",
     "README.md"
   ],
   "spine": {

package/pages/courses/CoursesPage.tsx

@@ -1,5 +1,5 @@
 import { useState, useEffect } from 'react'
-import { resolveTypeId } from '../../../lib/resolveTypeId'
+import { resolveTypeId } from '../../lib/resolveTypeId'
 import { useNavigate } from 'react-router-dom'
 import { apiFetch } from '@core/lib/api'
 import { Button } from '@core/components/ui/button'

package/pages/support/RedactionReview.tsx

@@ -1,5 +1,5 @@
 import { useState, useEffect, useCallback } from 'react'
-import { resolveTypeId } from '../../../lib/resolveTypeId'
+import { resolveTypeId } from '../../lib/resolveTypeId'
 import { useParams, useNavigate } from 'react-router-dom'
 import { apiFetch } from '@core/lib/api'
 import { Button } from '@core/components/ui/button'

package/seed/link-types.json

@@ -3,10 +3,11 @@
     "slug": "account_opportunities",
     "name": "Account Opportunities",
     "description": "Links accounts to their opportunity queue entries",
+    "source_type_slug": "account",
+    "target_type_slug": "item",
+    "relationship_type": "many-to-many",
     "config": {
-      "cardinality": "many-to-many",
-      "source_type": "account",
-      "target_type": "item"
+      "cardinality": "many-to-many"
     },
     "is_active": true
   },
@@ -14,10 +15,11 @@
     "slug": "account_signals",
     "name": "Account Signals",
     "description": "Links accounts to their funnel signals",
+    "source_type_slug": "account",
+    "target_type_slug": "item",
+    "relationship_type": "many-to-many",
     "config": {
-      "cardinality": "many-to-many",
-      "source_type": "account",
-      "target_type": "item"
+      "cardinality": "many-to-many"
     },
     "is_active": true
   },
@@ -25,6 +27,9 @@
     "slug": "analyzed_by",
     "name": "Analyzed By",
     "description": "Ticket analyzed by case analysis",
+    "source_type_slug": "item",
+    "target_type_slug": "item",
+    "relationship_type": "many-to-many",
     "config": {
       "forward_label": "analyzed by",
       "reverse_label": "analysis of"
@@ -35,6 +40,9 @@
     "slug": "tagged_with",
     "name": "Tagged With",
     "description": "Entity tagged with a specific tag",
+    "source_type_slug": "item",
+    "target_type_slug": "item",
+    "relationship_type": "many-to-many",
     "config": {
       "forward_label": "tagged with",
       "reverse_label": "applied to"

package/seed/pipelines.json

@@ -0,0 +1,30 @@
+[
+  {
+    "name": "Case Analysis Pipeline",
+    "description": "Automatically analyzes resolved support tickets to extract insights and create tags",
+    "steps": [
+      {
+        "name": "Analyze Ticket",
+        "type": "function",
+        "config": {
+          "function": "case_analysis.analyze"
+        }
+      },
+      {
+        "name": "Generate Tags",
+        "type": "function",
+        "config": {
+          "function": "tag_management.generate"
+        }
+      }
+    ],
+    "config": {
+      "debounce_ms": 5000,
+      "retry_count": 3,
+      "retry_delay_ms": 1000
+    },
+    "ownership": "tenant",
+    "is_system": false,
+    "is_active": true
+  }
+]

package/seed/roles.json

@@ -0,0 +1,12 @@
+[
+  {
+    "slug": "support",
+    "app_slug": "cortex",
+    "name": "Support",
+    "description": "Support agent with full CRM and support access",
+    "permissions": ["*"],
+    "is_system": true,
+    "is_active": true,
+    "is_protected": false
+  }
+]

package/seed/triggers.json

@@ -2,12 +2,13 @@
   {
     "name": "Case Resolution Analysis",
     "description": "Automatically triggers case analysis when support tickets are resolved",
-    "trigger_type": "event_driven",
+    "trigger_type": "event",
     "event_type": "item_updated",
+    "scope": "account",
     "config": {
       "filters": [
         { "field": "status", "value": "resolved", "operator": "$eq" },
-        { "field": "type_id", "value": "82320862-a99c-4a84-b7ed-c2832cf519cd", "operator": "$eq" }
+        { "field": "type_id", "type_slug": "support_ticket", "operator": "$eq" }
       ],
       "debounce_ms": 5000,
       "entity_type": "items",
@@ -23,6 +24,7 @@
     "description": "Processes funnel signals to update lead scores and lifecycle stages",
     "trigger_type": "event",
     "event_type": "item_created",
+    "scope": "account",
     "config": {
       "filters": {},
       "type_slug": "funnel_signal",
@@ -37,6 +39,7 @@
     "description": "Hourly dashboard metric aggregation",
     "trigger_type": "cron",
     "event_type": null,
+    "scope": "account",
     "config": {
       "function": "funnel-timers.aggregation",
       "schedule": "0 * * * *",
@@ -52,6 +55,7 @@
     "description": "Daily recalculation of account ratings for score decay",
     "trigger_type": "cron",
     "event_type": null,
+    "scope": "account",
     "config": {
       "function": "funnel-timers.scoreDecay",
       "schedule": "59 23 * * *",
@@ -67,6 +71,7 @@
     "description": "Daily purge of expired anonymous sessions",
     "trigger_type": "cron",
     "event_type": null,
+    "scope": "account",
     "config": {
       "function": "funnel-timers.sessionCleanup",
       "schedule": "0 2 * * *",