spine-framework-cortex 0.1.1

package/seed/accounts.json

@@ -0,0 +1,9 @@
+[
+  {
+    "slug": "unidentified-visitors",
+    "display_name": "Unidentified Visitors",
+    "description": "Container account for anonymous funnel signals and sessions before identity stitching",
+    "type_slug": "account",
+    "is_active": true
+  }
+]

package/seed/link-types.json

@@ -0,0 +1,44 @@
+[
+  {
+    "slug": "account_opportunities",
+    "name": "Account Opportunities",
+    "description": "Links accounts to their opportunity queue entries",
+    "config": {
+      "cardinality": "many-to-many",
+      "source_type": "account",
+      "target_type": "item"
+    },
+    "is_active": true
+  },
+  {
+    "slug": "account_signals",
+    "name": "Account Signals",
+    "description": "Links accounts to their funnel signals",
+    "config": {
+      "cardinality": "many-to-many",
+      "source_type": "account",
+      "target_type": "item"
+    },
+    "is_active": true
+  },
+  {
+    "slug": "analyzed_by",
+    "name": "Analyzed By",
+    "description": "Ticket analyzed by case analysis",
+    "config": {
+      "forward_label": "analyzed by",
+      "reverse_label": "analysis of"
+    },
+    "is_active": true
+  },
+  {
+    "slug": "tagged_with",
+    "name": "Tagged With",
+    "description": "Entity tagged with a specific tag",
+    "config": {
+      "forward_label": "tagged with",
+      "reverse_label": "applied to"
+    },
+    "is_active": true
+  }
+]

package/seed/triggers.json

@@ -0,0 +1,80 @@
+[
+  {
+    "name": "Case Resolution Analysis",
+    "description": "Automatically triggers case analysis when support tickets are resolved",
+    "trigger_type": "event_driven",
+    "event_type": "item_updated",
+    "config": {
+      "filters": [
+        { "field": "status", "value": "resolved", "operator": "$eq" },
+        { "field": "type_id", "value": "82320862-a99c-4a84-b7ed-c2832cf519cd", "operator": "$eq" }
+      ],
+      "debounce_ms": 5000,
+      "entity_type": "items",
+      "retry_count": 3,
+      "retry_delay_ms": 1000
+    },
+    "ownership": "tenant",
+    "is_system": false,
+    "is_active": true
+  },
+  {
+    "name": "Funnel Signal Lead Scoring",
+    "description": "Processes funnel signals to update lead scores and lifecycle stages",
+    "trigger_type": "event",
+    "event_type": "item_created",
+    "config": {
+      "filters": {},
+      "type_slug": "funnel_signal",
+      "entity_type": "item"
+    },
+    "ownership": "tenant",
+    "is_system": false,
+    "is_active": true
+  },
+  {
+    "name": "Funnel: Aggregation",
+    "description": "Hourly dashboard metric aggregation",
+    "trigger_type": "cron",
+    "event_type": null,
+    "config": {
+      "function": "funnel-timers.aggregation",
+      "schedule": "0 * * * *",
+      "timezone": "UTC",
+      "description": "Hourly dashboard metric aggregation"
+    },
+    "ownership": "tenant",
+    "is_system": false,
+    "is_active": true
+  },
+  {
+    "name": "Funnel: Score Decay",
+    "description": "Daily recalculation of account ratings for score decay",
+    "trigger_type": "cron",
+    "event_type": null,
+    "config": {
+      "function": "funnel-timers.scoreDecay",
+      "schedule": "59 23 * * *",
+      "timezone": "UTC",
+      "description": "Daily recalculation of account ratings for score decay"
+    },
+    "ownership": "tenant",
+    "is_system": false,
+    "is_active": true
+  },
+  {
+    "name": "Funnel: Session Cleanup",
+    "description": "Daily purge of expired anonymous sessions",
+    "trigger_type": "cron",
+    "event_type": null,
+    "config": {
+      "function": "funnel-timers.sessionCleanup",
+      "schedule": "0 2 * * *",
+      "timezone": "UTC",
+      "description": "Daily purge of expired anonymous sessions"
+    },
+    "ownership": "tenant",
+    "is_system": false,
+    "is_active": true
+  }
+]

package/seed/types.json

@@ -0,0 +1,352 @@
+[
+  {
+    "kind": "item",
+    "slug": "case_analysis",
+    "name": "Case Analysis",
+    "description": "AI-generated case resolution analysis and insights",
+    "icon": "analysis",
+    "color": "#10B981",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "fields": {
+        "ticket_id": { "type": "string", "label": "Original Ticket ID", "required": true },
+        "ai_agent_id": { "type": "string", "label": "AI Agent Used", "readonly": true },
+        "analysis_data": { "type": "json", "label": "Complete Analysis Data", "required": true },
+        "confidence_score": { "min": 0, "max": 1, "type": "number", "label": "AI Analysis Confidence" },
+        "analysis_timestamp": { "type": "timestamp", "label": "Analysis Timestamp", "readonly": true }
+      }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "course",
+    "name": "Course",
+    "description": "Top-level course container",
+    "icon": "graduation-cap",
+    "color": "#6366f1",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": { "scope": "platform" },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "course_chapter",
+    "name": "Course Chapter",
+    "description": "Chapter grouping lessons within a course",
+    "icon": "book-open",
+    "color": "#8b5cf6",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": { "scope": "platform" },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "csm_health",
+    "name": "CSM Health Record",
+    "description": "Customer success health: temperature, churn risk, adoption, NPS",
+    "icon": "heart-pulse",
+    "color": "#10B981",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "scope": "account",
+      "fields": {
+        "title": { "label": "Title", "system": true, "required": true, "data_type": "text" },
+        "status": { "label": "Status", "system": true, "required": false, "data_type": "text" },
+        "is_active": { "label": "Active", "system": true, "required": true, "data_type": "boolean" },
+        "temperature": { "label": "Health Temperature", "system": false, "required": true, "data_type": "text" },
+        "nps_score": { "label": "NPS Score", "system": false, "required": false, "data_type": "number" },
+        "adoption_score": { "label": "Adoption Score", "system": false, "required": false, "data_type": "number" },
+        "churn_risk_score": { "label": "Churn Risk Score", "system": false, "required": false, "data_type": "number" },
+        "notes": { "label": "CSM Notes", "system": false, "required": false, "data_type": "textarea" },
+        "description": { "label": "Description", "system": true, "required": false, "data_type": "textarea" },
+        "created_at": { "label": "Created", "system": true, "readonly": true, "required": false, "data_type": "datetime" },
+        "updated_at": { "label": "Updated", "system": true, "readonly": true, "required": false, "data_type": "datetime" }
+      },
+      "record_permissions": { "system_admin": ["create", "read", "update", "delete"] }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "deal",
+    "name": "Deal",
+    "description": "Sales opportunity with stage, value, and close date",
+    "icon": "briefcase",
+    "color": "#3B82F6",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "scope": "account",
+      "fields": {
+        "title": { "label": "Title", "system": true, "required": true, "data_type": "text" },
+        "status": { "label": "Status", "system": true, "required": false, "data_type": "text" },
+        "is_active": { "label": "Active", "system": true, "required": true, "data_type": "boolean" },
+        "stage": { "label": "Stage", "system": false, "required": true, "data_type": "text" },
+        "value": { "label": "Deal Value", "system": false, "required": false, "data_type": "number" },
+        "source": { "label": "Lead Source", "system": false, "required": false, "data_type": "text" },
+        "close_date": { "label": "Close Date", "system": false, "required": false, "data_type": "datetime" },
+        "probability": { "label": "Probability %", "system": false, "required": false, "data_type": "number" },
+        "description": { "label": "Description", "system": true, "required": false, "data_type": "textarea" },
+        "created_at": { "label": "Created", "system": true, "readonly": true, "required": false, "data_type": "datetime" },
+        "updated_at": { "label": "Updated", "system": true, "readonly": true, "required": false, "data_type": "datetime" }
+      },
+      "record_permissions": { "system_admin": ["create", "read", "update", "delete"] }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "kb_article",
+    "name": "Knowledge Base Article",
+    "description": "Help documentation and knowledge base article",
+    "icon": "book-open",
+    "color": "#0EA5E9",
+    "ownership": "system",
+    "is_active": true,
+    "design_schema": {
+      "scope": "platform",
+      "fields": {
+        "title": { "label": "Title", "system": true, "required": true, "data_type": "text", "validation": { "minLength": 1, "maxLength": 255 } },
+        "status": { "label": "Status", "system": true, "required": true, "data_type": "select", "options": [{"label":"Draft","value":"draft"},{"label":"Under Review","value":"review"},{"label":"Published","value":"published"},{"label":"Deprecated","value":"deprecated"},{"label":"Archived","value":"archived"},{"label":"Restricted Access","value":"restricted"}] },
+        "kb_type": { "label": "Knowledge Base Type", "required": true, "data_type": "select", "options": [{"label":"Article","value":"article"},{"label":"Care Guide","value":"care_guide"},{"label":"Process Guide","value":"process_guide"},{"label":"Code Chunk","value":"code_chunk"},{"label":"API Reference","value":"api_reference"},{"label":"Troubleshooting","value":"troubleshooting"},{"label":"FAQ","value":"faq"},{"label":"Policy","value":"policy"},{"label":"Tutorial","value":"tutorial"}] },
+        "description": { "label": "Description", "required": true, "data_type": "rich_text" },
+        "audience": { "label": "Audience", "required": false, "data_type": "multiselect", "options": [{"label":"End User","value":"end_user"},{"label":"Support Agent","value":"support_agent"},{"label":"Developer","value":"developer"},{"label":"Administrator","value":"admin"},{"label":"Manager","value":"manager"},{"label":"AI System","value":"ai_system"},{"label":"Internal Only","value":"internal_only"}] },
+        "category": { "label": "Category", "required": false, "data_type": "select", "options": [{"label":"Getting Started","value":"getting_started"},{"label":"User Guide","value":"user_guide"},{"label":"Technical","value":"technical"},{"label":"Billing","value":"billing"},{"label":"Security","value":"security"},{"label":"Integration","value":"integration"},{"label":"Troubleshooting","value":"troubleshooting"},{"label":"Reference","value":"reference"},{"label":"Best Practices","value":"best_practices"},{"label":"Policies","value":"policies"}] },
+        "priority": { "label": "Priority", "required": true, "data_type": "select", "options": [{"label":"Low","value":"low"},{"label":"Medium","value":"medium"},{"label":"High","value":"high"},{"label":"Critical","value":"critical"},{"label":"Emergency","value":"emergency"}] },
+        "security_level": { "label": "Security Level", "required": false, "data_type": "select", "options": [{"label":"Public","value":"public"},{"label":"Internal","value":"internal"},{"label":"Confidential","value":"confidential"},{"label":"Restricted","value":"restricted"}] },
+        "tags": { "label": "Tags", "required": false, "data_type": "json" },
+        "version": { "label": "Version", "required": false, "data_type": "text" },
+        "expires_at": { "label": "Expires At", "required": false, "data_type": "datetime" },
+        "last_reviewed_at": { "label": "Last Reviewed At", "required": false, "data_type": "datetime" },
+        "view_count": { "label": "View Count", "required": false, "data_type": "number", "validation": { "min": 0 } },
+        "helpful_count": { "label": "Helpful Votes", "required": false, "data_type": "number", "validation": { "min": 0 } },
+        "not_helpful_count": { "label": "Not Helpful Votes", "required": false, "data_type": "number", "validation": { "min": 0 } },
+        "related_articles": { "label": "Related Articles", "required": false, "data_type": "json" },
+        "source_info": { "label": "Source Info", "required": false, "data_type": "json" },
+        "care_metadata": { "label": "Care Metadata", "required": false, "data_type": "json" },
+        "code_metadata": { "label": "Code Metadata", "required": false, "data_type": "json" },
+        "process_metadata": { "label": "Process Metadata", "required": false, "data_type": "json" }
+      },
+      "record_permissions": { "guest": ["read"], "member": ["read"], "support": ["create", "read", "update"], "system-admin": ["create", "read", "update", "delete"] }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "marketing_touch",
+    "name": "Marketing Touch",
+    "description": "Marketing touchpoint: channel, campaign, content, conversion",
+    "icon": "megaphone",
+    "color": "#F59E0B",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "scope": "account",
+      "fields": {
+        "title": { "label": "Title", "system": true, "required": true, "data_type": "text" },
+        "status": { "label": "Status", "system": true, "required": false, "data_type": "text" },
+        "is_active": { "label": "Active", "system": true, "required": true, "data_type": "boolean" },
+        "channel": { "label": "Channel", "system": false, "required": true, "data_type": "text" },
+        "campaign": { "label": "Campaign", "system": false, "required": false, "data_type": "text" },
+        "content": { "label": "Content/Asset", "system": false, "required": false, "data_type": "text" },
+        "converted": { "label": "Converted", "system": false, "required": false, "data_type": "boolean" },
+        "created_at": { "label": "Created", "system": true, "readonly": true, "required": false, "data_type": "datetime" },
+        "updated_at": { "label": "Updated", "system": true, "readonly": true, "required": false, "data_type": "datetime" }
+      },
+      "record_permissions": { "system_admin": ["create", "read", "update", "delete"] }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "note",
+    "name": "Note",
+    "description": "Internal account note",
+    "icon": "sticky-note",
+    "color": "#f59e0b",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": { "scope": "account" },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "site_visit",
+    "name": "Site Visit",
+    "description": "Website visit tracking event",
+    "icon": "eye",
+    "color": "#8B5CF6",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "scope": "account",
+      "fields": {
+        "title": { "label": "Title", "system": true, "required": true, "data_type": "text" },
+        "status": { "label": "Status", "system": true, "required": false, "data_type": "text" },
+        "is_active": { "label": "Active", "system": true, "required": true, "data_type": "boolean" },
+        "url": { "label": "Page URL", "system": false, "required": true, "data_type": "text" },
+        "source": { "label": "Traffic Source", "system": false, "required": false, "data_type": "text" },
+        "referrer": { "label": "Referrer URL", "system": false, "required": false, "data_type": "text" },
+        "duration_seconds": { "label": "Duration (sec)", "system": false, "required": false, "data_type": "number" },
+        "utm_source": { "label": "UTM Source", "system": false, "required": false, "data_type": "text" },
+        "utm_medium": { "label": "UTM Medium", "system": false, "required": false, "data_type": "text" },
+        "utm_campaign": { "label": "UTM Campaign", "system": false, "required": false, "data_type": "text" },
+        "created_at": { "label": "Created", "system": true, "readonly": true, "required": false, "data_type": "datetime" }
+      },
+      "record_permissions": { "system_admin": ["create", "read", "update", "delete"] }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "support_queue",
+    "name": "Support Queue Entry",
+    "description": "Human-assignable support ticket from AI escalation",
+    "icon": "inbox",
+    "color": "#f59e0b",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "fields": {
+        "ticket_id": { "type": "string", "label": "Source Ticket" },
+        "assigned_to": { "type": "string", "label": "Assignee" },
+        "sla_deadline": { "type": "timestamp", "label": "SLA Deadline" },
+        "priority_score": { "type": "number", "label": "Priority Score" },
+        "escalation_reason": { "type": "select", "label": "Escalation Reason", "options": ["low_confidence", "thumbs_down", "customer_request"] }
+      }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "tag",
+    "name": "Tag",
+    "description": "Reusable tags for categorization and analysis across entities",
+    "icon": "tag",
+    "color": "#8B5CF6",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "fields": {
+        "name": { "type": "string", "label": "Tag Name", "required": true },
+        "slug": { "type": "string", "label": "Tag Slug", "required": true, "validation": { "pattern": "^[a-z0-9_-]+$" } },
+        "purpose": { "type": "text", "label": "Purpose Description" },
+        "category": { "type": "select", "label": "Category", "required": true, "options": ["bug_classification", "knowledge_value", "process_type", "sentiment"] },
+        "applicable_to": { "type": "array", "items": { "type": "string" }, "label": "Applicable To", "default": ["ticket"], "required": true },
+        "usage_count": { "type": "number", "label": "Usage Count", "default": 0, "readonly": true }
+      }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "anonymous_session",
+    "name": "Anonymous Session",
+    "description": "Pre-identification visitor session with locked first-touch attribution",
+    "icon": "user",
+    "color": "#8b5cf6",
+    "ownership": "system",
+    "is_active": true,
+    "design_schema": {
+      "scoring": {
+        "ratings": { "anonymous": { "rating": { "max": 5, "min": 1, "type": "integer" }, "raw_score": { "type": "float" }, "signal_count": { "type": "integer" }, "calculated_at": { "type": "timestamp" }, "best_signal_id": { "type": "uuid", "nullable": true } } },
+        "temperature": { "type": "enum", "options": ["cold", "warm", "hot"] },
+        "current_stage": { "type": "enum", "default": "anonymous", "options": ["anonymous"] }
+      },
+      "identity": { "anonymous_id": { "type": "uuid" } },
+      "lifecycle": { "created_at": { "type": "timestamp" }, "stitched_at": { "type": "timestamp", "nullable": true }, "last_activity_at": { "type": "timestamp" }, "stitched_to_person_id": { "type": "uuid", "nullable": true }, "stitched_to_account_id": { "type": "uuid", "nullable": true } },
+      "retention": { "purge_after": { "type": "timestamp" }, "retention_days": { "type": "integer", "default": 90 } },
+      "attribution": {
+        "first_touch": { "utm_medium": { "type": "string", "nullable": true }, "utm_source": { "type": "string", "nullable": true }, "occurred_at": { "type": "timestamp" }, "landing_page": { "type": "string" }, "referrer_url": { "type": "string" }, "utm_campaign": { "type": "string", "nullable": true }, "referrer_domain": { "type": "string" }, "referrer_category": { "type": "enum", "options": ["social", "search", "direct", "referral", "email", "ad"] }, "landing_page_category": { "type": "string", "nullable": true } },
+        "current_referrer": { "occurred_at": { "type": "timestamp", "nullable": true }, "referrer_url": { "type": "string", "nullable": true }, "referrer_domain": { "type": "string", "nullable": true } }
+      }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "funnel_signal",
+    "name": "Funnel Signal",
+    "description": "Individual prospect/customer activity with engagement scoring",
+    "icon": "activity",
+    "color": "#3b82f6",
+    "ownership": "system",
+    "is_active": true,
+    "design_schema": {
+      "action": { "action_type": { "type": "string" }, "action_value": { "enum": [1, 2, 5], "type": "integer" }, "action_description": { "type": "string", "nullable": true } },
+      "identity": { "person_id": { "type": "uuid", "nullable": true }, "account_id": { "type": "uuid", "nullable": true }, "session_id": { "type": "string", "nullable": true }, "anonymous_id": { "type": "uuid", "nullable": true } },
+      "processing": { "scored_at": { "type": "timestamp" }, "enriched_at": { "type": "timestamp" }, "received_at": { "type": "timestamp" }, "stitched_at": { "type": "timestamp", "nullable": true }, "stitched_to_account_id": { "type": "uuid", "nullable": true } },
+      "attribution": { "utm_medium": { "type": "string", "nullable": true }, "utm_source": { "type": "string", "nullable": true }, "utm_campaign": { "type": "string", "nullable": true }, "immediate_referrer": { "type": "string", "nullable": true }, "first_touch_landing_page": { "type": "string", "nullable": true }, "first_touch_referrer_url": { "type": "string", "nullable": true }, "first_touch_referrer_domain": { "type": "string", "nullable": true } },
+      "classification": { "stage": { "type": "enum", "options": ["anonymous", "identified", "installed"] }, "source": { "type": "enum", "options": ["mar", "int", "use", "manual"] } },
+      "scoring_components": {
+        "recency": { "window": { "type": "enum", "options": ["fresh", "cooling", "stale", "expired"] }, "divisor": { "enum": [1, 2, 5], "type": "integer" }, "age_days": { "type": "float" } },
+        "raw_score": { "rating": { "max": 5, "min": 1, "type": "integer" }, "calculated": { "type": "float" }, "max_possible": { "type": "float", "default": 25 } },
+        "engagement": { "type": { "enum": [1, 2, 5], "type": "integer" }, "context": { "type": "enum", "options": ["first_visit", "deep_session", "return_visit"] }, "session_depth": { "type": "integer" }, "prior_session_count": { "type": "integer", "nullable": true } }
+      }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "opportunity_queue",
+    "name": "Opportunity Queue Entry",
+    "description": "Manual review queue for high-engagement prospects",
+    "icon": "star",
+    "color": "#f59e0b",
+    "ownership": "system",
+    "is_active": true,
+    "design_schema": {
+      "notes": { "auto_reason": { "type": "string", "nullable": true }, "reviewer_notes": { "type": "string", "nullable": true } },
+      "review": { "status": { "type": "enum", "options": ["pending", "accepted", "rejected", "converted"] }, "reviewed_at": { "type": "timestamp", "nullable": true }, "reviewed_by": { "type": "uuid", "nullable": true }, "conversion_opportunity_id": { "type": "uuid", "nullable": true } },
+      "trigger": { "trigger_stage": { "type": "enum", "options": ["anonymous", "identified", "installed"] }, "trigger_rating": { "max": 5, "min": 1, "type": "integer" }, "trigger_reason": { "type": "string" }, "source_signal_id": { "type": "uuid" }, "trigger_raw_score": { "type": "float" } },
+      "identity": { "person_id": { "type": "uuid", "nullable": true }, "account_id": { "type": "uuid", "nullable": true } },
+      "recommendation": { "confidence": { "type": "enum", "options": ["low", "medium", "high"] }, "opportunity_type": { "type": "enum", "options": ["advanced_portal", "implementation", "support_plan", "managed_services", "expansion", "advocate"] }, "suggested_priority": { "max": 5, "min": 1, "type": "integer" } }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "funnel_aggregation",
+    "name": "Funnel Aggregation",
+    "description": "Pre-computed funnel metrics for dashboard performance",
+    "icon": "bar-chart-2",
+    "color": "#10b981",
+    "ownership": "system",
+    "is_active": true,
+    "design_schema": {
+      "metrics": { "queue_summary": { "type": "jsonb" }, "signal_volume": { "type": "jsonb" }, "top_referrers": { "type": "jsonb" }, "conversion_rates": { "type": "jsonb" }, "avg_time_in_stage": { "type": "jsonb" }, "stage_distribution": { "type": "jsonb" }, "temperature_distribution": { "type": "jsonb" } },
+      "identity": { "account_id": { "type": "uuid", "nullable": true }, "aggregation_scope": { "type": "enum", "options": ["system", "account"] } },
+      "metadata": { "ttl_hours": { "type": "integer", "default": 1 }, "period_end": { "type": "timestamp" }, "computed_at": { "type": "timestamp" }, "period_start": { "type": "timestamp" } }
+    },
+    "validation_schema": {}
+  },
+  {
+    "kind": "item",
+    "slug": "kb_tag",
+    "name": "Knowledge Base Tag",
+    "description": "Tag for categorizing and organizing knowledge base content",
+    "icon": "tag",
+    "color": "#8B5CF6",
+    "ownership": "tenant",
+    "is_active": true,
+    "design_schema": {
+      "scope": "platform",
+      "views": {
+        "default_list": { "type": "list", "label": "KB Tags", "fields": { "name": { "sortable": true, "display_type": "text" }, "color": { "sortable": false, "display_type": "color" }, "created_at": { "sortable": true, "display_type": "date" } }, "display": "table", "default_sort": { "field": "name", "direction": "asc" } },
+        "default_detail": { "type": "detail", "label": "KB Tag", "sections": [{ "title": "Tag Details", "fields": ["name", "description", "color"] }, { "title": "Metadata", "fields": ["created_at", "updated_at"] }] }
+      },
+      "fields": {
+        "name": { "label": "Tag Name", "required": true, "data_type": "text" },
+        "color": { "label": "Color", "default": "#8B5CF6", "data_type": "text" },
+        "description": { "label": "Description", "data_type": "text" }
+      },
+      "record_permissions": { "member": ["read"], "support": ["read", "create", "update"], "system_admin": ["create", "read", "update", "delete"] }
+    },
+    "validation_schema": {}
+  }
+]