spine-framework-cortex 0.1.1

package/functions/custom_tag_management.ts

@@ -0,0 +1,314 @@
+import { createHandler } from './_shared/middleware'
+import { adminDb } from './_shared/db'
+
+/**
+ * Custom Tag Management Handler
+ *
+ * Actions:
+ * - POST ?action=create_or_get_tag - Get existing tag or create new one
+ * - POST ?action=list_tags - List tags with filtering
+ * - POST ?action=update_tag_usage - Increment tag usage count
+ * - POST ?action=merge_tags - Merge duplicate tags
+ * 
+ * Provides centralized tag management for case analysis and other systems.
+ */
+
+// ─── CONSTANTS ────────────────────────────────────────────────────────────────
+
+const TAG_TYPE_ID = 'tag' // Will be looked up by slug
+
+// ─── TYPES ────────────────────────────────────────────────────────────────────
+
+interface TagRequest {
+  slug: string
+  name: string
+  purpose?: string
+  category: 'bug_classification' | 'knowledge_value' | 'process_type' | 'sentiment'
+  applicable_to?: string[]
+}
+
+interface TagResponse {
+  id: string
+  slug: string
+  name: string
+  purpose?: string
+  category: string
+  applicable_to: string[]
+  usage_count: number
+  created_at: string
+  updated_at: string
+}
+
+interface ListTagsRequest {
+  category?: string
+  applicable_to?: string
+  limit?: number
+  offset?: number
+}
+
+// ─── HELPERS ──────────────────────────────────────────────────────────────────
+
+async function getTagTypeId(): Promise<string> {
+  const { data: tagType } = await adminDb
+    .from('types')
+    .select('id')
+    .eq('slug', 'tag')
+    .single()
+  
+  if (!tagType) throw new Error('Tag type not found')
+  return tagType.id
+}
+
+async function findExistingTag(slug: string): Promise<TagResponse | null> {
+  const { data: tag } = await adminDb
+    .from('items')
+    .select('*')
+    .eq('type_id', await getTagTypeId())
+    .eq('data->>slug', slug)
+    .single()
+  
+  if (!tag) return null
+  
+  return {
+    id: tag.id,
+    slug: tag.data?.slug || '',
+    name: tag.title,
+    purpose: tag.description,
+    category: tag.data?.category || '',
+    applicable_to: tag.data?.applicable_to || ['ticket'],
+    usage_count: tag.data?.usage_count || 0,
+    created_at: tag.created_at,
+    updated_at: tag.updated_at
+  }
+}
+
+async function createTag(
+  tagData: TagRequest,
+  accountId: string
+): Promise<TagResponse> {
+  const tagTypeId = await getTagTypeId()
+  
+  const { data: tag, error } = await adminDb
+    .from('items')
+    .insert({
+      type_id: tagTypeId,
+      account_id: accountId,
+      title: tagData.name,
+      description: tagData.purpose,
+      data: {
+        slug: tagData.slug,
+        name: tagData.name,
+        purpose: tagData.purpose,
+        applicable_to: tagData.applicable_to || ['ticket'],
+        category: tagData.category,
+        usage_count: 1
+      },
+      status: 'active'
+    })
+    .select('*')
+    .single()
+  
+  if (error || !tag) throw new Error(`Failed to create tag: ${error?.message}`)
+  
+  return {
+    id: tag.id,
+    slug: tag.data?.slug || '',
+    name: tag.title,
+    purpose: tag.description,
+    category: tag.data?.category || '',
+    applicable_to: tag.data?.applicable_to || ['ticket'],
+    usage_count: tag.data?.usage_count || 0,
+    created_at: tag.created_at,
+    updated_at: tag.updated_at
+  }
+}
+
+async function incrementTagUsage(tagId: string): Promise<void> {
+  await adminDb
+    .from('items')
+    .update({
+      data: adminDb.sql`jsonb_set(data, '{usage_count}', COALESCE((data->>'usage_count')::int, 0) + 1)`,
+      updated_at: new Date().toISOString()
+    })
+    .eq('id', tagId)
+}
+
+// ─── ACTIONS ───────────────────────────────────────────────────────────────────
+
+async function handleCreateOrGetTag(
+  ctx: any,
+  body: TagRequest
+): Promise<TagResponse> {
+  const account_id = ctx.accountId as string
+  
+  if (!account_id) throw new Error('Account context required')
+  if (!body.slug || !body.name || !body.category) {
+    throw new Error('slug, name, and category are required')
+  }
+
+  // Validate slug format
+  if (!/^[a-z0-9_-]+$/.test(body.slug)) {
+    throw new Error('Slug must contain only lowercase letters, numbers, hyphens, and underscores')
+  }
+
+  // Try to find existing tag
+  const existingTag = await findExistingTag(body.slug)
+  
+  if (existingTag) {
+    // Increment usage count
+    await incrementTagUsage(existingTag.id)
+    
+    // Return updated tag with incremented count
+    const updatedTag = await findExistingTag(body.slug)
+    if (!updatedTag) throw new Error('Failed to retrieve updated tag')
+    
+    return updatedTag
+  }
+  
+  // Create new tag
+  return await createTag(body, account_id)
+}
+
+async function handleListTags(
+  ctx: any,
+  body: ListTagsRequest
+): Promise<{ tags: TagResponse[]; total: number }> {
+  const { category, applicable_to, limit = 50, offset = 0 } = body
+  const tagTypeId = await getTagTypeId()
+  
+  let query = adminDb
+    .from('items')
+    .select('*', { count: 'exact' })
+    .eq('type_id', tagTypeId)
+    .eq('status', 'active')
+    .order('data->>usage_count', { ascending: false })
+    .range(offset, offset + limit - 1)
+  
+  // Add filters
+  if (category) {
+    query = query.eq('data->>category', category)
+  }
+  
+  if (applicable_to) {
+    query = query.contains('data->>applicable_to', [applicable_to])
+  }
+  
+  const { data: tags, error, count } = await query
+  
+  if (error) throw new Error(`Failed to list tags: ${error?.message}`)
+  
+  const formattedTags: TagResponse[] = (tags || []).map(tag => ({
+    id: tag.id,
+    slug: tag.data?.slug || '',
+    name: tag.title,
+    purpose: tag.description,
+    category: tag.data?.category || '',
+    applicable_to: tag.data?.applicable_to || ['ticket'],
+    usage_count: tag.data?.usage_count || 0,
+    created_at: tag.created_at,
+    updated_at: tag.updated_at
+  }))
+  
+  return {
+    tags: formattedTags,
+    total: count || 0
+  }
+}
+
+async function handleUpdateTagUsage(
+  ctx: any,
+  body: { tag_id: string }
+): Promise<void> {
+  if (!body.tag_id) throw new Error('tag_id is required')
+  
+  await incrementTagUsage(body.tag_id)
+}
+
+async function handleMergeTags(
+  ctx: any,
+  body: { source_tag_id: string; target_tag_id: string }
+): Promise<{ merged_count: number }> {
+  const { source_tag_id, target_tag_id } = body
+  
+  if (!source_tag_id || !target_tag_id) {
+    throw new Error('source_tag_id and target_tag_id are required')
+  }
+  
+  if (source_tag_id === target_tag_id) {
+    throw new Error('Source and target tags cannot be the same')
+  }
+  
+  // Get source tag info
+  const { data: sourceTag } = await adminDb
+    .from('items')
+    .select('data')
+    .eq('id', source_tag_id)
+    .single()
+  
+  if (!sourceTag) throw new Error('Source tag not found')
+  
+  // Update all references to source tag to point to target tag
+  const sourceTagSlug = sourceTag.data?.slug
+  
+  // Update ticket analysis_tags arrays
+  const { data: ticketsToUpdate } = await adminDb
+    .from('items')
+    .select('id, data')
+    .eq('status', 'active')
+    .contains('data->>case_analysis->>analysis_tags', [source_tag_id])
+  
+  let mergedCount = 0
+  
+  for (const ticket of ticketsToUpdate || []) {
+    const caseAnalysis = ticket.data?.case_analysis || {}
+    const analysisTags = caseAnalysis.analysis_tags || []
+    
+    // Replace source tag with target tag
+    const updatedTags = analysisTags.map((tagId: string) => 
+      tagId === source_tag_id ? target_tag_id : tagId
+    )
+    
+    await adminDb
+      .from('items')
+      .update({
+        data: adminDb.sql`jsonb_set(data, '{case_analysis,analysis_tags}', ${updatedTags}::jsonb)`,
+        updated_at: new Date().toISOString()
+      })
+      .eq('id', ticket.id)
+    
+    mergedCount++
+  }
+  
+  // Increment target tag usage by source tag's usage count
+  const sourceUsage = sourceTag.data?.usage_count || 0
+  for (let i = 0; i < sourceUsage; i++) {
+    await incrementTagUsage(target_tag_id)
+  }
+  
+  // Delete source tag
+  await adminDb
+    .from('items')
+    .update({ status: 'deleted', updated_at: new Date().toISOString() })
+    .eq('id', source_tag_id)
+  
+  return { merged_count }
+}
+
+// ─── HANDLER ──────────────────────────────────────────────────────────────────
+
+export const handler = createHandler(async (ctx, body) => {
+  const action = ctx.query?.action
+
+  switch (action) {
+    case 'create_or_get_tag':
+      return await handleCreateOrGetTag(ctx, body)
+    case 'list_tags':
+      return await handleListTags(ctx, body)
+    case 'update_tag_usage':
+      return await handleUpdateTagUsage(ctx, body)
+    case 'merge_tags':
+      return await handleMergeTags(ctx, body)
+    default:
+      throw new Error(`Unknown action: ${action}. Use create_or_get_tag, list_tags, update_tag_usage, or merge_tags.`)
+  }
+})

package/index.tsx

@@ -0,0 +1,103 @@
+import { lazy, Suspense } from 'react'
+import { Routes, Route, Navigate, useLocation } from 'react-router-dom'
+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'
+
+const CortexDashboard = lazy(() => import('./pages/CortexDashboard'))
+
+// CRM
+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'))
+const ActivityPage = lazy(() => import('./pages/crm/ActivityPage'))
+
+// Support
+const SupportPage = lazy(() => import('./pages/support/SupportPage'))
+const TicketDetailPage = lazy(() => import('./pages/support/TicketDetailPage'))
+const RedactionReview = lazy(() => import('./pages/support/RedactionReview'))
+
+// Community
+const CommunityPage = lazy(() => import('./pages/community/CommunityPage'))
+
+// KB
+const KBPage = lazy(() => import('./pages/kb/KBPage'))
+const KBEditorPage = lazy(() => import('./pages/kb/KBEditorPage'))
+const KBIngestionPage = lazy(() => import('./pages/kb/KBIngestionPage'))
+
+// Courses
+const CoursesPage = lazy(() => import('./pages/courses/CoursesPage'))
+
+// Intelligence
+const IntelligencePage = lazy(() => import('./pages/intelligence/IntelligencePage'))
+
+const Fallback = <div className="min-h-[400px] flex items-center justify-center"><LoadingSpinner /></div>
+
+function CortexLayout() {
+  const location = useLocation()
+  const segments = location.pathname.split('/').filter(Boolean)
+  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 (segments[2]) {
+    breadcrumbs.push({ title: segments[2].charAt(0).toUpperCase() + segments[2].slice(1) })
+  }
+
+  return (
+    <AppShell sidebar={<CortexSidebar />} breadcrumbs={breadcrumbs}>
+      <Suspense fallback={Fallback}>
+        <Routes>
+          <Route index element={<Navigate to="dashboard" replace />} />
+          <Route path="dashboard" element={<CortexDashboard />} />
+
+          {/* 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 />} />
+          <Route path="crm/deals" element={<DealsPage />} />
+          <Route path="crm/health" element={<HealthPage />} />
+          <Route path="crm/activity" element={<ActivityPage />} />
+
+          {/* Support */}
+          <Route path="support/:id/kb-review" element={<RedactionReview />} />
+          <Route path="support/:id" element={<TicketDetailPage />} />
+          <Route path="support" element={<SupportPage />} />
+
+          {/* Community */}
+          <Route path="community" element={<CommunityPage />} />
+
+          {/* KB */}
+          <Route path="kb/new" element={<KBEditorPage />} />
+          <Route path="kb/:id/edit" element={<KBEditorPage />} />
+          <Route path="kb/ingestion" element={<KBIngestionPage />} />
+          <Route path="kb" element={<KBPage />} />
+
+          {/* Courses */}
+          <Route path="courses/*" element={<CoursesPage />} />
+
+          {/* Intelligence */}
+          <Route path="intelligence" element={<IntelligencePage />} />
+
+          <Route path="*" element={<Navigate to="dashboard" replace />} />
+        </Routes>
+      </Suspense>
+    </AppShell>
+  )
+}
+
+export default function CortexApp() {
+  return (
+    <TooltipProvider>
+      <CortexLayout />
+    </TooltipProvider>
+  )
+}

package/manifest.json

@@ -0,0 +1,82 @@
+{
+  "name": "Cortex",
+  "slug": "cortex",
+  "description": "Unified workspace for CRM, Support, Community, and Knowledge Base",
+  "version": "1.0.0",
+  "required_roles": ["member"],
+  "routes": [
+    "/cortex",
+    "/cortex/dashboard",
+    "/cortex/crm",
+    "/cortex/crm/accounts",
+    "/cortex/crm/accounts/:id",
+    "/cortex/crm/contacts",
+    "/cortex/crm/deals",
+    "/cortex/crm/deals/:id",
+    "/cortex/crm/health",
+    "/cortex/crm/activity",
+    "/cortex/support",
+    "/cortex/support/:id",
+    "/cortex/community",
+    "/cortex/kb",
+    "/cortex/kb/editor",
+    "/cortex/kb/ingestion",
+    "/cortex/courses",
+    "/cortex/intelligence"
+  ],
+  "nav_items": [
+    {
+      "title": "Dashboard",
+      "path": "/cortex/dashboard",
+      "icon": "LayoutDashboard",
+      "order": 1
+    },
+    {
+      "title": "CRM",
+      "path": "/cortex/crm",
+      "icon": "Users",
+      "order": 2,
+      "children": [
+        { "title": "Accounts", "path": "/cortex/crm/accounts" },
+        { "title": "Contacts", "path": "/cortex/crm/contacts" },
+        { "title": "Deals", "path": "/cortex/crm/deals" },
+        { "title": "Health", "path": "/cortex/crm/health" },
+        { "title": "Activity", "path": "/cortex/crm/activity" }
+      ]
+    },
+    {
+      "title": "Support",
+      "path": "/cortex/support",
+      "icon": "Headphones",
+      "order": 3
+    },
+    {
+      "title": "Community",
+      "path": "/cortex/community",
+      "icon": "Users",
+      "order": 4
+    },
+    {
+      "title": "Knowledge Base",
+      "path": "/cortex/kb",
+      "icon": "BookOpen",
+      "order": 5
+    },
+    {
+      "title": "Courses",
+      "path": "/cortex/courses",
+      "icon": "GraduationCap",
+      "order": 6
+    },
+    {
+      "title": "Intelligence",
+      "path": "/cortex/intelligence",
+      "icon": "Brain",
+      "order": 7
+    }
+  ],
+  "features": ["crm", "support", "community", "kb", "courses", "intelligence"],
+  "dependencies": ["items", "accounts", "pipelines", "integrations"],
+  "entry_point": "./index.tsx",
+  "sidebar_component": "./components/CortexSidebar.tsx"
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "spine-framework-cortex",
+  "version": "0.1.1",
+  "description": "Cortex — AI-powered support, CRM, and knowledge base app for Spine Framework",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/art-mojo-admin/spine",
+    "directory": "custom/apps/cortex"
+  },
+  "peerDependencies": {
+    "spine-framework": ">=0.1.0"
+  },
+  "files": [
+    "index.tsx",
+    "manifest.json",
+    "seed/",
+    "pages/",
+    "components/",
+    "functions/",
+    "README.md"
+  ],
+  "spine": {
+    "type": "app",
+    "slug": "cortex",
+    "manifestPath": "manifest.json"
+  }
+}

package/pages/CortexDashboard.tsx

@@ -0,0 +1,97 @@
+import { useEffect, useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import { apiFetch } from '@core/lib/api'
+import { Card, CardContent, CardHeader, CardTitle } from '@core/components/ui/card'
+import { Skeleton } from '@core/components/ui/skeleton'
+import { Building2, Headphones, MessageSquare, BookOpen, GraduationCap, TrendingUp } from 'lucide-react'
+
+interface Stats {
+  accounts: number
+  openTickets: number
+  unansweredPosts: number
+  kbArticles: number
+  pipeline: number
+  deals: number
+}
+
+function StatCard({
+  title, value, sub, icon: Icon, href, loading
+}: {
+  title: string; value: string | number; sub?: string; icon: React.ElementType; href: string; loading: boolean
+}) {
+  const navigate = useNavigate()
+  return (
+    <Card className="cursor-pointer hover:shadow-md transition-shadow" onClick={() => navigate(href)}>
+      <CardHeader className="flex flex-row items-center justify-between pb-2">
+        <CardTitle className="text-sm font-medium text-muted-foreground">{title}</CardTitle>
+        <Icon className="h-4 w-4 text-muted-foreground" />
+      </CardHeader>
+      <CardContent>
+        {loading ? (
+          <Skeleton className="h-8 w-16" />
+        ) : (
+          <div className="text-3xl font-bold">{value}</div>
+        )}
+        {sub && <p className="text-xs text-muted-foreground mt-1">{sub}</p>}
+      </CardContent>
+    </Card>
+  )
+}
+
+export default function CortexDashboard() {
+  const [stats, setStats] = useState<Stats>({ accounts: 0, openTickets: 0, unansweredPosts: 0, kbArticles: 0, pipeline: 0, deals: 0 })
+  const [loading, setLoading] = useState(true)
+
+  useEffect(() => {
+    Promise.all([
+      apiFetch('/api/admin-data?action=list&entity=accounts&limit=1').then(r => r.json()),
+      apiFetch('/api/admin-data?action=list&entity=items&type_slug=support_ticket&limit=200').then(r => r.json()),
+      apiFetch('/api/admin-data?action=list&entity=items&type_slug=community_post&limit=200').then(r => r.json()),
+      apiFetch('/api/admin-data?action=list&entity=items&type_slug=kb_article&limit=1').then(r => r.json()),
+      apiFetch('/api/admin-data?action=list&entity=items&type_slug=deal&limit=200').then(r => r.json()),
+    ]).then(([ar, tr, pr, kr, dr]) => {
+      const accounts = ar?.data ?? ar
+      const tickets = tr?.data ?? tr
+      const posts = pr?.data ?? pr
+      const kbArticles = kr?.data ?? kr
+      const deals = dr?.data ?? dr
+      const openTickets = (tickets || []).filter((t: any) => !['resolved', 'closed'].includes(t.status))
+      const pipeline = (deals || [])
+        .filter((d: any) => !['closed_won', 'closed_lost'].includes(d.data?.stage))
+        .reduce((sum: number, d: any) => sum + (d.data?.value || 0), 0)
+      setStats({
+        accounts: ar?.meta?.total ?? (accounts || []).length,
+        openTickets: openTickets.length,
+        unansweredPosts: (posts || []).length,
+        kbArticles: kr?.meta?.total ?? (kbArticles || []).length,
+        pipeline,
+        deals: (deals || []).length,
+      })
+    }).catch(() => {}).finally(() => setLoading(false))
+  }, [])
+
+  return (
+    <div className="p-6 space-y-6">
+      <div>
+        <h1 className="text-2xl font-bold">Cortex</h1>
+        <p className="text-muted-foreground text-sm mt-1">Operations overview</p>
+      </div>
+
+      <div className="grid grid-cols-2 lg:grid-cols-3 xl:grid-cols-6 gap-4">
+        <StatCard title="Accounts" value={stats.accounts} icon={Building2} href="/cortex/crm/accounts" loading={loading} />
+        <StatCard title="Open Tickets" value={stats.openTickets} sub="support queue" icon={Headphones} href="/cortex/support" loading={loading} />
+        <StatCard title="Community Posts" value={stats.unansweredPosts} sub="all channels" icon={MessageSquare} href="/cortex/community" loading={loading} />
+        <StatCard title="KB Articles" value={stats.kbArticles} icon={BookOpen} href="/cortex/kb" loading={loading} />
+        <StatCard title="Deals" value={stats.deals} sub="all stages" icon={TrendingUp} href="/cortex/crm/deals" loading={loading} />
+        <StatCard
+          title="Pipeline"
+          value={loading ? '…' : `$${(stats.pipeline / 1000).toFixed(0)}k`}
+          sub="open deal value"
+          icon={GraduationCap}
+          href="/cortex/crm/deals"
+          loading={false}
+        />
+      </div>
+    </div>
+  )
+}