spine-framework-cortex 0.1.18 → 0.2.0

package/functions/custom_tag_management.ts

@@ -1,314 +0,0 @@
-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/functions/webhook-handlers.ts

@@ -1,29 +0,0 @@
-/**
- * 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

@@ -1,16 +0,0 @@
-// 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/pages/crm/ContactDetailPage.tsx

@@ -1,184 +0,0 @@
-import { useEffect, useState } from 'react'
-import { useParams, useNavigate } from 'react-router-dom'
-import { apiFetch } from '@core/lib/api'
-import { Badge } from '@core/components/ui/badge'
-import { Skeleton } from '@core/components/ui/skeleton'
-import { Button } from '@core/components/ui/button'
-import { Separator } from '@core/components/ui/separator'
-import { ArrowLeft, User, Mail, Phone, Building2, Calendar } from 'lucide-react'
-
-interface Person {
-  id: string
-  email?: string
-  full_name?: string
-  phone?: string
-  status?: string
-  avatar_url?: string
-  account_id?: string
-  data?: Record<string, any>
-  is_active?: boolean
-  created_at: string
-  updated_at?: string
-}
-
-interface Account {
-  id: string
-  slug?: string
-  display_name?: string
-}
-
-export default function ContactDetailPage() {
-  const { id } = useParams<{ id: string }>()
-  const navigate = useNavigate()
-  const [person, setPerson] = useState<Person | null>(null)
-  const [account, setAccount] = useState<Account | null>(null)
-  const [loading, setLoading] = useState(true)
-  const [error, setError] = useState<string | null>(null)
-
-  useEffect(() => {
-    if (!id) return
-    setLoading(true)
-    apiFetch(`/api/admin-data?action=get&entity=people&id=${id}`)
-      .then(r => r.json())
-      .then(json => {
-        const p = json?.data || json
-        if (!p?.id) throw new Error('Contact not found')
-        setPerson(p)
-        if (p.account_id) {
-          return apiFetch(`/api/admin-data?action=get&entity=accounts&id=${p.account_id}`)
-            .then(r2 => r2.json())
-            .then(aj => setAccount(aj?.data || aj || null))
-        }
-      })
-      .catch(err => setError(err.message || 'Failed to load contact'))
-      .finally(() => setLoading(false))
-  }, [id])
-
-  if (loading) {
-    return (
-      <div className="p-6 space-y-4">
-        <Skeleton className="h-8 w-48" />
-        <Skeleton className="h-64 w-full" />
-      </div>
-    )
-  }
-
-  if (error || !person) {
-    return (
-      <div className="p-6">
-        <Button variant="ghost" size="sm" onClick={() => navigate('/cortex/crm/contacts')}>
-          <ArrowLeft className="h-4 w-4 mr-2" /> Back to Contacts
-        </Button>
-        <div className="mt-8 text-center text-slate-400">{error || 'Contact not found'}</div>
-      </div>
-    )
-  }
-
-  const initials = (person.full_name || '?')
-    .split(' ')
-    .map(w => w[0])
-    .join('')
-    .toUpperCase()
-    .slice(0, 2)
-
-  return (
-    <div className="p-6 space-y-6 max-w-4xl">
-      {/* Header */}
-      <div className="flex items-center gap-3">
-        <Button variant="ghost" size="icon" onClick={() => navigate('/cortex/crm/contacts')}>
-          <ArrowLeft className="h-4 w-4" />
-        </Button>
-        <div className="h-12 w-12 rounded-full bg-blue-100 text-blue-700 flex items-center justify-center text-lg font-semibold shrink-0">
-          {initials}
-        </div>
-        <div className="flex-1 min-w-0">
-          <h1 className="text-2xl font-bold text-slate-900 truncate">{person.full_name || 'Unnamed Contact'}</h1>
-          <p className="text-sm text-slate-500">{person.email || '—'}</p>
-        </div>
-        <div className="flex items-center gap-2">
-          {person.status && (
-            <Badge variant={person.status === 'active' ? 'default' : 'secondary'}>{person.status}</Badge>
-          )}
-          {person.is_active === false && (
-            <Badge variant="destructive">Inactive</Badge>
-          )}
-        </div>
-      </div>
-
-      <Separator />
-
-      {/* Details grid */}
-      <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
-        {/* Profile card */}
-        <div className="bg-white rounded-lg border border-slate-200 p-5 space-y-4">
-          <h2 className="text-sm font-semibold text-slate-700 uppercase tracking-wider">Profile</h2>
-
-          <div className="space-y-3">
-            <div className="flex items-center gap-3 text-sm">
-              <User className="h-4 w-4 text-slate-400 shrink-0" />
-              <span className="text-slate-500 w-20">Name</span>
-              <span className="text-slate-900 font-medium">{person.full_name || '—'}</span>
-            </div>
-
-            <div className="flex items-center gap-3 text-sm">
-              <Mail className="h-4 w-4 text-slate-400 shrink-0" />
-              <span className="text-slate-500 w-20">Email</span>
-              <span className="text-slate-900">{person.email || '—'}</span>
-            </div>
-
-            <div className="flex items-center gap-3 text-sm">
-              <Phone className="h-4 w-4 text-slate-400 shrink-0" />
-              <span className="text-slate-500 w-20">Phone</span>
-              <span className="text-slate-900">{person.phone || '—'}</span>
-            </div>
-
-            <div className="flex items-center gap-3 text-sm">
-              <Calendar className="h-4 w-4 text-slate-400 shrink-0" />
-              <span className="text-slate-500 w-20">Joined</span>
-              <span className="text-slate-900">{new Date(person.created_at).toLocaleDateString()}</span>
-            </div>
-          </div>
-        </div>
-
-        {/* Account card */}
-        <div className="bg-white rounded-lg border border-slate-200 p-5 space-y-4">
-          <h2 className="text-sm font-semibold text-slate-700 uppercase tracking-wider">Account</h2>
-
-          {account ? (
-            <div
-              className="flex items-center gap-3 p-3 rounded-md hover:bg-slate-50 cursor-pointer transition-colors"
-              onClick={() => navigate(`/cortex/crm/accounts/${account.id}`)}
-            >
-              <div className="h-9 w-9 rounded-lg bg-slate-100 flex items-center justify-center shrink-0">
-                <Building2 className="h-4 w-4 text-slate-500" />
-              </div>
-              <div>
-                <p className="text-sm font-medium text-slate-900">{account.display_name || account.slug || '—'}</p>
-                {account.slug && <p className="text-xs text-slate-400">{account.slug}</p>}
-              </div>
-            </div>
-          ) : (
-            <p className="text-sm text-slate-400">No account linked</p>
-          )}
-        </div>
-      </div>
-
-      {/* Data section */}
-      {person.data && Object.keys(person.data).length > 0 && (
-        <div className="bg-white rounded-lg border border-slate-200 p-5 space-y-3">
-          <h2 className="text-sm font-semibold text-slate-700 uppercase tracking-wider">Additional Data</h2>
-          <div className="grid grid-cols-1 md:grid-cols-2 gap-3">
-            {Object.entries(person.data).map(([key, value]) => (
-              <div key={key} className="text-sm">
-                <span className="text-slate-500">{key.replace(/_/g, ' ')}: </span>
-                <span className="text-slate-900 font-medium">
-                  {typeof value === 'object' ? JSON.stringify(value) : String(value ?? '—')}
-                </span>
-              </div>
-            ))}
-          </div>
-        </div>
-      )}
-    </div>
-  )
-}