spine-framework-cortex 0.1.19 → 0.2.1

package/{functions/custom_cortex-handler.ts → api/cortex-handler.ts}

@@ -1,19 +1,17 @@
 /**
  * Cortex Webhook Handler
  * 
- * Convention: custom_*.ts files are assembled into /functions/
- * and loaded by integration-routes via: import('./custom_cortex-handler')
- *
- * Receives: (sanitizedData, context, event)
- * Returns: plain text or object
+ * Returns "Serenity" for valid requests
+ * Receives sanitized data and full context from integration-routes
  */
-export default async function cortexHandler(
-  data: Record<string, any>,
+
+export default async function handler(
+  data: any,
   ctx: {
     integrationId: string
     accountId: string
     slug: string
-    principal: { id: string; type: string; accountId: string }
+    principal: any
     requestId: string
     headers: Record<string, string>
   },
@@ -25,11 +23,13 @@ export default async function cortexHandler(
     queryStringParameters: Record<string, string>
   }
 ): Promise<string> {
+  // Log the received data for debugging
   console.log(`[${ctx.requestId}] Cortex handler received:`, {
     testText: data['test-text'],
     integrationId: ctx.integrationId,
     accountId: ctx.accountId
   })
 
-  return data['test-text']
+  // Return Serenity as plain text
+  return 'Serenity'
 }

package/components/CliInstancesCard.tsx

@@ -0,0 +1,144 @@
+import { useState, useEffect } from 'react'
+import { Card, CardContent, CardHeader, CardTitle } from '@core/components/ui/card'
+import { Badge } from '@core/components/ui/badge'
+import { Skeleton } from '@core/components/ui/skeleton'
+import { Terminal, CheckCircle } from 'lucide-react'
+import { apiFetch } from '@core/lib/api'
+
+interface CliInstance {
+  id: string
+  serial: string
+  app_slug: string
+  version: string
+  first_seen_at: string
+  last_signal_at: string
+  claimed_at?: string
+  claimed_by_person_id?: string
+}
+
+interface CliInstancesCardProps {
+  accountId?: string
+  personId?: string
+  title?: string
+}
+
+export function CliInstancesCard({ 
+  accountId, 
+  personId,
+  title = "CLI Installations" 
+}: CliInstancesCardProps) {
+  const [instances, setInstances] = useState<CliInstance[]>([])
+  const [loading, setLoading] = useState(true)
+
+  useEffect(() => {
+    async function loadInstances() {
+      if (!accountId && !personId) return
+
+      try {
+        setLoading(true)
+        const endpoint = accountId 
+          ? `/custom_api/account-cli-instances?account_id=${accountId}`
+          : `/custom_api/person-cli-instances?person_id=${personId}`
+        
+        const { data } = await apiFetch(endpoint)
+        setInstances(data || [])
+      } catch (e) {
+        console.error('Failed to load CLI instances:', e)
+      } finally {
+        setLoading(false)
+      }
+    }
+
+    loadInstances()
+  }, [accountId, personId])
+
+  // Truncate serial for display
+  const truncateSerial = (serial: string) => {
+    if (!serial || serial.length < 20) return serial
+    return `${serial.slice(0, 8)}***${serial.slice(-6)}`
+  }
+
+  if (loading) {
+    return (
+      <Card>
+        <CardHeader>
+          <CardTitle className="text-base flex items-center gap-2">
+            <Terminal className="w-4 h-4" />
+            {title}
+          </CardTitle>
+        </CardHeader>
+        <CardContent>
+          <Skeleton className="h-12" />
+        </CardContent>
+      </Card>
+    )
+  }
+
+  if (instances.length === 0) {
+    return (
+      <Card>
+        <CardHeader>
+          <CardTitle className="text-base flex items-center gap-2">
+            <Terminal className="w-4 h-4" />
+            {title}
+          </CardTitle>
+        </CardHeader>
+        <CardContent>
+          <p className="text-sm text-muted-foreground">
+            No CLI installations claimed yet
+          </p>
+        </CardContent>
+      </Card>
+    )
+  }
+
+  return (
+    <Card>
+      <CardHeader>
+        <div className="flex items-center justify-between">
+          <CardTitle className="text-base flex items-center gap-2">
+            <Terminal className="w-4 h-4" />
+            {title}
+          </CardTitle>
+          <Badge variant="secondary" className="text-xs">
+            {instances.length}
+          </Badge>
+        </div>
+      </CardHeader>
+      <CardContent>
+        <div className="space-y-2">
+          {instances.map((instance) => (
+            <div 
+              key={instance.id}
+              className="flex items-center justify-between p-2 rounded-md border hover:bg-muted/50 transition-colors"
+            >
+              <div className="space-y-1">
+                <div className="flex items-center gap-2">
+                  <code className="text-xs font-mono bg-muted px-1.5 py-0.5 rounded">
+                    {truncateSerial(instance.serial)}
+                  </code>
+                  <Badge variant="outline" className="text-[10px] px-1 py-0">
+                    {instance.app_slug}
+                  </Badge>
+                  <span className="text-xs text-muted-foreground">
+                    v{instance.version}
+                  </span>
+                </div>
+                <div className="flex items-center gap-2 text-xs text-muted-foreground">
+                  <span>First seen {new Date(instance.first_seen_at).toLocaleDateString()}</span>
+                  {instance.last_signal_at && (
+                    <>
+                      <span>•</span>
+                      <span>Active {new Date(instance.last_signal_at).toLocaleDateString()}</span>
+                    </>
+                  )}
+                </div>
+              </div>
+              <CheckCircle className="w-4 h-4 text-green-500" />
+            </div>
+          ))}
+        </div>
+      </CardContent>
+    </Card>
+  )
+}

package/components/CortexSidebar.tsx

@@ -8,9 +8,8 @@
  */
 
 import * as React from "react"
-import { Link, useNavigate, useLocation } from "react-router-dom"
+import { useNavigate, useLocation } from "react-router-dom"
 import { useAuth } from "@core/contexts/AuthContext"
-import { useCurrentApp } from "@core/contexts/AppContext"
 import {
   LayoutDashboard,
   Building2,
@@ -21,8 +20,8 @@ import {
   Handshake,
   Activity,
   Heart,
-  Flame,
-  ScanSearch,
+  BarChart3,
+  Search,
   Download,
 } from "lucide-react"
 import {
@@ -39,36 +38,29 @@ import {
   SidebarRail,
 } from "@core/components/ui/sidebar"
 
+const crmItems = [
+  { title: "Dashboard", url: "/cortex/dashboard", icon: LayoutDashboard },
+  { title: "Accounts", url: "/cortex/crm/accounts", icon: Building2 },
+  { title: "Contacts", url: "/cortex/crm/contacts", icon: Users },
+  { title: "Deals", url: "/cortex/crm/deals", icon: Handshake },
+  { title: "Health", url: "/cortex/crm/health", icon: Heart },
+  { title: "Activity", url: "/cortex/crm/activity", icon: Activity },
+]
+
+const opsItems = [
+  { title: "Operations Dashboard", url: "/cortex/operations", icon: BarChart3 },
+  { title: "Audit Funnel", url: "/cortex/operations/audit-funnel", icon: Search },
+  { title: "Install Funnel", url: "/cortex/operations/install-funnel", icon: Download },
+  { title: "Support", url: "/cortex/support", icon: Headphones },
+  { title: "Community", url: "/cortex/community", icon: Users },
+  { title: "Knowledge Base", url: "/cortex/kb", icon: BookOpen },
+  { title: "Courses", url: "/cortex/courses", icon: GraduationCap },
+]
+
 export function CortexSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
   const navigate = useNavigate()
   const location = useLocation()
   const { user } = useAuth()
-  const app = useCurrentApp()
-
-  // Normalize route_prefix: '/' becomes '' so all paths are /dashboard, /crm/accounts, etc.
-  const base = app.route_prefix === '/' ? '' : (app.route_prefix || '')
-
-  const crmItems = [
-    { title: "Dashboard", url: `${base}/dashboard`, icon: LayoutDashboard },
-    { title: "Accounts", url: `${base}/crm/accounts`, icon: Building2 },
-    { title: "Contacts", url: `${base}/crm/contacts`, icon: Users },
-    { title: "Deals", url: `${base}/crm/deals`, icon: Handshake },
-    { title: "Health", url: `${base}/crm/health`, icon: Heart },
-    { title: "Activity", url: `${base}/crm/activity`, icon: Activity },
-  ]
-
-  const revenueItems = [
-    { title: "Command Center", url: `${base}/ops/command-center`, icon: Flame },
-    { title: "Audit Funnel", url: `${base}/ops/audit-funnel`, icon: ScanSearch },
-    { title: "Install Funnel", url: `${base}/ops/install-funnel`, icon: Download },
-  ]
-
-  const opsItems = [
-    { title: "Support", url: `${base}/support`, icon: Headphones },
-    { title: "Community", url: `${base}/community`, icon: Users },
-    { title: "Knowledge Base", url: `${base}/kb`, icon: BookOpen },
-    { title: "Courses", url: `${base}/courses`, icon: GraduationCap },
-  ]
 
   const isActive = (url: string) => location.pathname.startsWith(url)
 
@@ -77,7 +69,7 @@ export function CortexSidebar({ ...props }: React.ComponentProps<typeof Sidebar>
       <SidebarHeader>
         <SidebarMenu>
           <SidebarMenuItem>
-            <SidebarMenuButton size="lg" onClick={() => navigate(`${base}/dashboard`)}>
+            <SidebarMenuButton size="lg" onClick={() => navigate("/cortex/dashboard")}>
               <div className="flex aspect-square size-8 items-center justify-center rounded-lg bg-primary text-primary-foreground">
                 <span className="text-sm font-bold">Cx</span>
               </div>
@@ -101,28 +93,10 @@ export function CortexSidebar({ ...props }: React.ComponentProps<typeof Sidebar>
                     asChild
                     isActive={isActive(item.url)}
                   >
-                    <Link to={item.url}>
-                      <item.icon className="h-4 w-4" />
-                      <span>{item.title}</span>
-                    </Link>
-                  </SidebarMenuButton>
-                </SidebarMenuItem>
-              ))}
-            </SidebarMenu>
-          </SidebarGroupContent>
-        </SidebarGroup>
-
-        <SidebarGroup>
-          <SidebarGroupLabel>Revenue</SidebarGroupLabel>
-          <SidebarGroupContent>
-            <SidebarMenu>
-              {revenueItems.map((item) => (
-                <SidebarMenuItem key={item.title}>
-                  <SidebarMenuButton asChild isActive={isActive(item.url)}>
-                    <Link to={item.url}>
+                    <a href={item.url}>
                       <item.icon className="h-4 w-4" />
                       <span>{item.title}</span>
-                    </Link>
+                    </a>
                   </SidebarMenuButton>
                 </SidebarMenuItem>
               ))}
@@ -140,10 +114,10 @@ export function CortexSidebar({ ...props }: React.ComponentProps<typeof Sidebar>
                     asChild
                     isActive={isActive(item.url)}
                   >
-                    <Link to={item.url}>
+                    <a href={item.url}>
                       <item.icon className="h-4 w-4" />
                       <span>{item.title}</span>
-                    </Link>
+                    </a>
                   </SidebarMenuButton>
                 </SidebarMenuItem>
               ))}

package/hooks/useTypeRegistry.ts

@@ -0,0 +1,74 @@
+import { useState, useEffect } from 'react'
+import { supabase } from '@core/lib/supabase'
+
+interface TypeRecord {
+  id: string
+  slug: string
+  name: string
+  description?: string
+}
+
+// Module-level cache - persists across renders, shared across hooks
+let typeCache: Map<string, TypeRecord> | null = null
+let loadPromise: Promise<Map<string, TypeRecord>> | null = null
+
+async function fetchTypes(): Promise<Map<string, TypeRecord>> {
+  if (typeCache) return typeCache
+  if (loadPromise) return loadPromise
+
+  loadPromise = (async () => {
+    try {
+      // Query Supabase directly - types is a config table, not exposed via admin-data
+      const { data: types, error } = await supabase
+        .from('types')
+        .select('id, slug, name, description')
+        .eq('is_active', true)
+        .limit(100)
+
+      if (error) throw error
+
+      typeCache = new Map((types || []).map(t => [t.slug, t]))
+      return typeCache
+    } catch (e) {
+      console.error('Failed to load types:', e)
+      typeCache = new Map() // Empty cache on error
+      return typeCache
+    } finally {
+      loadPromise = null
+    }
+  })()
+
+  return loadPromise
+}
+
+export function useTypeRegistry() {
+  const [types, setTypes] = useState<Map<string, TypeRecord>>(typeCache || new Map())
+  const [loading, setLoading] = useState(!typeCache)
+  const [error, setError] = useState<string | null>(null)
+
+  useEffect(() => {
+    if (typeCache) return
+
+    fetchTypes()
+      .then(cache => {
+        setTypes(cache)
+        setLoading(false)
+      })
+      .catch(e => {
+        setError(e.message)
+        setLoading(false)
+      })
+  }, [])
+
+  const getTypeId = (slug: string): string | null => {
+    return types.get(slug)?.id || null
+  }
+
+  return { types, loading, error, getTypeId }
+}
+
+// Synchronous version for use inside async functions
+export async function getTypeIdAsync(slug: string): Promise<string | null> {
+  const cache = await fetchTypes()
+  return cache.get(slug)?.id || null
+}

package/index.tsx

@@ -4,7 +4,6 @@ import { LoadingSpinner } from '@core/components/ui/LoadingSpinner'
 import { AppShell } from '@core/components/layout/AppShell'
 import { CortexSidebar } from './components/CortexSidebar'
 import { TooltipProvider } from '@core/components/ui/tooltip'
-import { useCurrentApp } from '@core/contexts/AppContext'
 
 const CortexDashboard = lazy(() => import('./pages/CortexDashboard'))
 
@@ -12,7 +11,6 @@ const CortexDashboard = lazy(() => import('./pages/CortexDashboard'))
 const AccountsPage = lazy(() => import('./pages/crm/AccountsPage'))
 const AccountDetailPage = lazy(() => import('./pages/crm/AccountDetailPage'))
 const ContactsPage = lazy(() => import('./pages/crm/ContactsPage'))
-const ContactDetailPage = lazy(() => import('./pages/crm/ContactDetailPage'))
 const DealsPage = lazy(() => import('./pages/crm/DealsPage'))
 const DealDetailPage = lazy(() => import('./pages/crm/DealDetailPage'))
 const HealthPage = lazy(() => import('./pages/crm/HealthPage'))
@@ -37,30 +35,22 @@ const CoursesPage = lazy(() => import('./pages/courses/CoursesPage'))
 // Intelligence
 const IntelligencePage = lazy(() => import('./pages/intelligence/IntelligencePage'))
 
-// Ops / Revenue
-const CommandCenterPage = lazy(() => import('./pages/ops/CommandCenterPage'))
-const AuditFunnelPage = lazy(() => import('./pages/ops/AuditFunnelPage'))
-const InstallFunnelPage = lazy(() => import('./pages/ops/InstallFunnelPage'))
+// Operations
+const OperationsDashboard = lazy(() => import('./pages/operations/OperationsDashboard'))
+const AuditFunnelPage = lazy(() => import('./pages/operations/AuditFunnelPage'))
+const InstallFunnelPage = lazy(() => import('./pages/operations/InstallFunnelPage'))
 
 const Fallback = <div className="min-h-[400px] flex items-center justify-center"><LoadingSpinner /></div>
 
 function CortexLayout() {
   const location = useLocation()
-  const app = useCurrentApp()
-
-  // Normalize route_prefix: '/' → '' so paths are /dashboard, /crm/accounts, etc.
-  const base = app.route_prefix === '/' ? '' : (app.route_prefix || '')
-  const prefixDepth = base.split('/').filter(Boolean).length
-
   const segments = location.pathname.split('/').filter(Boolean)
-  const appSegments = segments.slice(prefixDepth) // strips the prefix segments
-
-  const breadcrumbs: { title: string; url?: string }[] = [{ title: 'Cortex', url: `${base}/dashboard` }]
-  if (appSegments[0] && appSegments[0] !== 'dashboard') {
-    breadcrumbs.push({ title: appSegments[0].charAt(0).toUpperCase() + appSegments[0].slice(1) })
+  const breadcrumbs: { title: string; url?: string }[] = [{ title: 'Cortex', url: '/cortex/dashboard' }]
+  if (segments[1] && segments[1] !== 'dashboard') {
+    breadcrumbs.push({ title: segments[1].charAt(0).toUpperCase() + segments[1].slice(1) })
   }
-  if (appSegments[1]) {
-    breadcrumbs.push({ title: appSegments[1].charAt(0).toUpperCase() + appSegments[1].slice(1) })
+  if (segments[2]) {
+    breadcrumbs.push({ title: segments[2].charAt(0).toUpperCase() + segments[2].slice(1) })
   }
 
   return (
@@ -73,7 +63,6 @@ function CortexLayout() {
           {/* CRM */}
           <Route path="crm/accounts/:id" element={<AccountDetailPage />} />
           <Route path="crm/accounts" element={<AccountsPage />} />
-          <Route path="crm/contacts/:id" element={<ContactDetailPage />} />
           <Route path="crm/contacts" element={<ContactsPage />} />
           <Route path="crm/deals/new" element={<DealDetailPage />} />
           <Route path="crm/deals/:id" element={<DealDetailPage />} />
@@ -101,10 +90,10 @@ function CortexLayout() {
           {/* Intelligence */}
           <Route path="intelligence" element={<IntelligencePage />} />
 
-          {/* Ops / Revenue */}
-          <Route path="ops/command-center" element={<CommandCenterPage />} />
-          <Route path="ops/audit-funnel" element={<AuditFunnelPage />} />
-          <Route path="ops/install-funnel" element={<InstallFunnelPage />} />
+          {/* Operations */}
+          <Route path="operations" element={<OperationsDashboard />} />
+          <Route path="operations/audit-funnel" element={<AuditFunnelPage />} />
+          <Route path="operations/install-funnel" element={<InstallFunnelPage />} />
 
           <Route path="*" element={<Navigate to="dashboard" replace />} />
         </Routes>

package/manifest.json

@@ -5,6 +5,7 @@
   "version": "1.0.0",
   "required_roles": ["support"],
   "routes": [
+    "/cortex",
     "/cortex/dashboard",
     "/cortex/crm",
     "/cortex/crm/accounts",
@@ -74,21 +75,8 @@
       "order": 7
     }
   ],
-  "changelog": [
-    {
-      "version": "1.0.0",
-      "notes": [
-        "Root-relative nav paths for subdomain deployment model",
-        "Prefix-aware sidebar navigation via useCurrentApp()",
-        "Prefix-aware breadcrumbs with Navigate index redirect",
-        "FilterTab replaces FunnelTab (lucide Filter icon)",
-        "Initial release"
-      ]
-    }
-  ],
   "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,18 +1,11 @@
 {
   "name": "spine-framework-cortex",
-  "version": "0.1.19",
+  "version": "0.2.1",
+  "private": false,
   "description": "Cortex — AI-powered support, CRM, and knowledge base app for Spine Framework",
-  "type": "module",
-  "license": "SEE LICENSE IN LICENSE.md",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/spine-framework/cortex",
-    "directory": "custom/apps/cortex"
-  },
-  "scripts": {
-    "publish:next": "npm publish --tag next --access public",
-    "publish:promote": "node -e \"const v=require('./package.json').version;require('child_process').execSync('npm dist-tag add spine-framework-cortex@'+v+' latest',{stdio:'inherit'})\""
-  },
+  "keywords": ["spine-framework", "crm", "support", "knowledge-base", "community"],
+  "author": "Spine Team",
+  "license": "MIT",
   "peerDependencies": {
     "spine-framework": ">=0.1.0"
   },
@@ -22,15 +15,13 @@
     "seed/",
     "pages/",
     "components/",
-    "functions/",
-    "lib/",
-    "README.md",
-    "LICENSE.md",
-    "CHANGELOG.md"
+    "api/",
+    "hooks/",
+    "README.md"
   ],
   "spine": {
-    "type": "app",
-    "slug": "cortex",
-    "manifestPath": "manifest.json"
+    "app_slug": "cortex",
+    "entry_point": "./index.tsx",
+    "manifest": "./manifest.json"
   }
 }

package/pages/courses/CoursesPage.tsx

@@ -1,7 +1,7 @@
-import { useState, useEffect } from 'react'
-import { resolveTypeId } from '../../lib/resolveTypeId'
+import { useState, useEffect, useRef } from 'react'
 import { useNavigate } from 'react-router-dom'
 import { apiFetch } from '@core/lib/api'
+import { getTypeIdAsync } from '../hooks/useTypeRegistry'
 import { Button } from '@core/components/ui/button'
 import { Input } from '@core/components/ui/input'
 import { Badge } from '@core/components/ui/badge'
@@ -31,6 +31,13 @@ function DiscussionPanel({ lesson }: { lesson: Lesson }) {
   const [loading, setLoading] = useState(true)
   const [newMessage, setNewMessage] = useState('')
   const [submitting, setSubmitting] = useState(false)
+  const messageTypeIdRef = useRef<string>('')
+
+  useEffect(() => {
+    getTypeIdAsync('message').then(id => {
+      if (id) messageTypeIdRef.current = id
+    })
+  }, [])
 
   useEffect(() => {
     setLoading(true)
@@ -46,6 +53,10 @@ function DiscussionPanel({ lesson }: { lesson: Lesson }) {
   const handleSubmit = async (e: React.FormEvent) => {
     e.preventDefault()
     if (!newMessage.trim() || submitting) return
+    if (!messageTypeIdRef.current) {
+      console.error('Message type not loaded')
+      return
+    }
 
     setSubmitting(true)
     try {
@@ -68,12 +79,11 @@ function DiscussionPanel({ lesson }: { lesson: Lesson }) {
       }
 
       // Create message
-      const messageTypeId = await resolveTypeId('message')
       const messageResponse = await apiFetch('/api/admin-data?action=create&entity=messages', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
-          type_id: messageTypeId,
+          type_id: messageTypeIdRef.current,
           thread_id: currentThread.id,
           content: newMessage.trim(),
           direction: 'inbound',