spine-framework-cortex 0.1.7 → 0.1.10

package/LICENSE.md

@@ -0,0 +1,13 @@
+# Spine Framework Internal Use License 1.0.0
+
+**Source-available. Free for internal use. Commercial rights reserved.**
+
+Copyright © 2026 Dahl Ventures Inc. All rights reserved.
+
+This software is licensed under the Spine Framework Internal Use License 1.0.0.
+
+For full license terms, see: https://github.com/spine-framework/spine-framework/blob/main/LICENSE.md
+
+**Summary:** You may use this software for internal business use only. Commercial use, resale, SaaS offering, white-labeling, and distribution require a separate Commercial License.
+
+Contact: webmaster@spine-framework.com

package/README.md

@@ -1,27 +1,69 @@
 # spine-framework-cortex
 
-AI-powered support, CRM, and knowledge base app for Spine Framework.
+**We're building Spine in the open.** The source is visible, the roadmap is public, and we share what we learn along the way. That said, Spine is not open source — commercial use requires a license. See [LICENSE.md](./LICENSE.md) for details.
+
+---
+
+Cortex is an AI-powered internal workspace app for Spine Framework. It gives your team a unified interface for CRM, customer support, knowledge base management, community, and AI-assisted intelligence — all wired into the same data model your portal customers interact with.
+
+## Requirements
+
+- [Spine Framework](https://www.npmjs.com/package/spine-framework) `>=0.1.0`
+- A Spine project initialized with `npx spine-framework init`
 
 ## Installation
 
 ```bash
-npm install spine-framework-cortex
+npx spine-framework install-app spine-framework-cortex@latest
 ```
 
-## Usage
+This seeds the required roles, types, and configuration into your database and registers the app with Spine's navigation system.
+
+## Features
+
+- **CRM** — accounts, contacts, deals, health scoring, and activity tracking
+- **Support** — ticket queue with AI triage and case resolution tracking
+- **Knowledge base** — article management with AI-powered generation and ingestion
+- **Community** — internal view of discussion threads and Q&A
+- **Courses** — course and lesson content management
+- **Intelligence** — visitor tracking, funnel signal processing, and opportunity queue
+
+## Routes
+
+| Path | Description |
+|------|-------------|
+| `/cortex/dashboard` | Cortex home |
+| `/cortex/crm` | CRM overview |
+| `/cortex/crm/accounts` | Account list |
+| `/cortex/crm/accounts/:id` | Account detail |
+| `/cortex/crm/contacts` | Contacts |
+| `/cortex/crm/deals` | Deals |
+| `/cortex/crm/deals/:id` | Deal detail |
+| `/cortex/crm/health` | Health scores |
+| `/cortex/crm/activity` | Activity feed |
+| `/cortex/support` | Support queue |
+| `/cortex/support/:id` | Ticket detail |
+| `/cortex/community` | Community |
+| `/cortex/kb` | Knowledge base |
+| `/cortex/kb/editor` | KB editor |
+| `/cortex/kb/ingestion` | KB ingestion |
+| `/cortex/courses` | Courses |
+| `/cortex/intelligence` | Intelligence |
+
+## Uninstalling
 
 ```bash
-npx spine-framework install-app cortex
+npx spine-framework uninstall-app spine-framework-cortex
 ```
 
-## Features
+## License
 
-- 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
+Spine Framework Cortex is **source-available, free for internal use**. Commercial use requires a separate license.
 
-## License
+See [LICENSE.md](./LICENSE.md) for full terms.
+
+For commercial licensing: [spine-framework.com](https://spine-framework.com) · webmaster@spine-framework.com
+
+---
 
-MIT
+Copyright © 2026 Dahl Ventures Inc. All rights reserved.

package/components/CortexSidebar.tsx

@@ -8,8 +8,9 @@
  */
 
 import * as React from "react"
-import { useNavigate, useLocation } from "react-router-dom"
+import { Link, useNavigate, useLocation } from "react-router-dom"
 import { useAuth } from "@core/contexts/AuthContext"
+import { useCurrentApp } from "@core/contexts/AppContext"
 import {
   LayoutDashboard,
   Building2,
@@ -35,26 +36,30 @@ 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: "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 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)
 
@@ -63,7 +68,7 @@ export function CortexSidebar({ ...props }: React.ComponentProps<typeof Sidebar>
       <SidebarHeader>
         <SidebarMenu>
           <SidebarMenuItem>
-            <SidebarMenuButton size="lg" onClick={() => navigate("/cortex/dashboard")}>
+            <SidebarMenuButton size="lg" onClick={() => navigate(`${base}/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>
@@ -87,10 +92,10 @@ export function CortexSidebar({ ...props }: React.ComponentProps<typeof Sidebar>
                     asChild
                     isActive={isActive(item.url)}
                   >
-                    <a href={item.url}>
+                    <Link to={item.url}>
                       <item.icon className="h-4 w-4" />
                       <span>{item.title}</span>
-                    </a>
+                    </Link>
                   </SidebarMenuButton>
                 </SidebarMenuItem>
               ))}
@@ -108,10 +113,10 @@ export function CortexSidebar({ ...props }: React.ComponentProps<typeof Sidebar>
                     asChild
                     isActive={isActive(item.url)}
                   >
-                    <a href={item.url}>
+                    <Link to={item.url}>
                       <item.icon className="h-4 w-4" />
                       <span>{item.title}</span>
-                    </a>
+                    </Link>
                   </SidebarMenuButton>
                 </SidebarMenuItem>
               ))}

package/index.tsx

@@ -4,6 +4,7 @@ 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'))
 
@@ -40,13 +41,21 @@ const Fallback = <div className="min-h-[400px] flex items-center justify-center"
 
 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 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) })
+  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) })
   }
-  if (segments[2]) {
-    breadcrumbs.push({ title: segments[2].charAt(0).toUpperCase() + segments[2].slice(1) })
+  if (appSegments[1]) {
+    breadcrumbs.push({ title: appSegments[1].charAt(0).toUpperCase() + appSegments[1].slice(1) })
   }
 
   return (

package/manifest.json

@@ -5,7 +5,6 @@
   "version": "1.0.0",
   "required_roles": ["support"],
   "routes": [
-    "/cortex",
     "/cortex/dashboard",
     "/cortex/crm",
     "/cortex/crm/accounts",
@@ -75,6 +74,18 @@
       "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",

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "spine-framework-cortex",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "description": "Cortex — AI-powered support, CRM, and knowledge base app for Spine Framework",
   "type": "module",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
     "type": "git",
-    "url": "https://github.com/art-mojo-admin/spine",
+    "url": "https://github.com/spine-framework/cortex",
     "directory": "custom/apps/cortex"
   },
   "peerDependencies": {
@@ -20,7 +20,8 @@
     "components/",
     "functions/",
     "lib/",
-    "README.md"
+    "README.md",
+    "LICENSE.md"
   ],
   "spine": {
     "type": "app",

package/pages/crm/AccountDetailPage.tsx

@@ -7,7 +7,7 @@ import { Skeleton } from '@core/components/ui/skeleton'
 import { Button } from '@core/components/ui/button'
 import { ScrollArea } from '@core/components/ui/scroll-area'
 import { Separator } from '@core/components/ui/separator'
-import { ArrowLeft, User, Ticket, Handshake, Activity, Heart, Funnel, TrendingUp, Target, Clock } from 'lucide-react'
+import { ArrowLeft, User, Ticket, Handshake, Activity, Heart, Filter, TrendingUp, Target, Clock } from 'lucide-react'
 
 interface Account {
   id: string
@@ -140,7 +140,7 @@ function ActivityTab({ accountId }: { accountId: string }) {
   )
 }
 
-function FunnelTab({ account }: { account: Account }) {
+function FilterTab({ account }: { account: Account }) {
   const stage = account.data?.lifecycle_stage
   const score = account.data?.lead_score ?? 0
   const temp = account.data?.temperature
@@ -217,7 +217,7 @@ function FunnelTab({ account }: { account: Account }) {
       {queue?.pending_opportunity_id && (
         <div className="border rounded-lg p-4 bg-yellow-50 border-yellow-200">
           <div className="flex items-center gap-2">
-            <Funnel className="h-4 w-4 text-yellow-600" />
+            <Filter className="h-4 w-4 text-yellow-600" />
             <span className="font-medium text-sm">Opportunity in Queue</span>
           </div>
           <p className="text-xs text-muted-foreground mt-1">
@@ -317,7 +317,7 @@ function FunnelTab({ account }: { account: Account }) {
       {/* Empty State */}
       {!stage && !score && !temp && !ratings && !queue?.pending_opportunity_id && (
         <div className="text-center py-12 text-muted-foreground">
-          <Funnel className="h-10 w-10 mx-auto mb-3 opacity-30" />
+          <Filter className="h-10 w-10 mx-auto mb-3 opacity-30" />
           <p className="text-sm">No funnel data yet.</p>
           <p className="text-xs mt-1">Signals will appear here as they are processed.</p>
         </div>
@@ -364,7 +364,7 @@ export default function AccountDetailPage() {
           <TabsList className="h-9 bg-transparent p-0 gap-4">
             {[
               { value: 'people', label: 'People', icon: User },
-              { value: 'funnel', label: 'Funnel', icon: Funnel },
+              { value: 'funnel', label: 'Funnel', icon: Filter },
               { value: 'tickets', label: 'Tickets', icon: Ticket },
               { value: 'deals', label: 'Deals', icon: Handshake },
               { value: 'health', label: 'Health', icon: Heart },
@@ -381,7 +381,7 @@ export default function AccountDetailPage() {
 
         <ScrollArea className="flex-1">
           <TabsContent value="people" className="mt-0"><PeopleTab accountId={id!} /></TabsContent>
-          <TabsContent value="funnel" className="mt-0"><FunnelTab account={account} /></TabsContent>
+          <TabsContent value="funnel" className="mt-0"><FilterTab account={account} /></TabsContent>
           <TabsContent value="tickets" className="mt-0"><ItemsTab accountId={id!} typeSlug="support_ticket" emptyText="No tickets." /></TabsContent>
           <TabsContent value="deals" className="mt-0"><ItemsTab accountId={id!} typeSlug="deal" emptyText="No deals." /></TabsContent>
           <TabsContent value="health" className="mt-0"><ItemsTab accountId={id!} typeSlug="csm_health" emptyText="No health records." /></TabsContent>