spine-framework 0.3.145 → 0.4.0

package/.framework/src/main.tsx

@@ -1,21 +1,12 @@
-
-
-
-// CIL[BEGIN chunk_id="main_module_header_1783672456" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and app dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import all required modules for app bootstrap"]
-// CIL[DOC-CONTEXT module="main" layer="frontend-entry" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, routing, state management, and app components" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/main.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/main.tsx"]
+// CIL[DOC-MACRO purpose="Initialize the React application root, configure providers, and mount the app into the DOM"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import dependencies, create the query client, and render the application root"]
+// CIL[DOC-CONTEXT module="main" layer="ui_entry" related_files=".framework/src/App.tsx,.framework/src/contexts/AuthContext.tsx,.framework/src/index.css"]
+// CIL[DOC-CONTRACT inputs="none" outputs="mounted React root" errors="runtime if #root is missing or providers fail" side_effects="renders into DOM"]
+// CIL[DOC-MICRO logic_summary="Imports React, DOM, router, query client, App, auth context and global styles, then creates the query client and mounts the app" notable_decisions=""]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-entry. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/functions/custom_cil-embeddings.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="frontend maintainers"]
 import React from 'react'
 import ReactDOM from 'react-dom/client'
 import { BrowserRouter } from 'react-router-dom'
@@ -23,21 +14,22 @@ import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
 import App from './App'
 import { AuthProvider } from './contexts/AuthContext'
 import './index.css'
-// CIL[END chunk_id="main_module_header_1783672456"]
-// CIL[BEGIN chunk_id="main_queryclient_1783672456" type="variable" identity="queryClient" parent="none"]
-// CIL[DOC-MACRO purpose="Configure React Query client"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create and configure query client instance"]
-// CIL[DOC-CONTEXT module="main" layer="frontend-entry" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="QueryClient instance" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Creates QueryClient with retry and refetch options" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-entry. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Initialize the React application root, configure providers, and mount the app into the DOM'; No verified external callers; imports: .framework/src/App.tsx,.framework/src/contexts/AuthContext.tsx,.framework/src/index.css"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/main.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/main.tsx:queryclient:constant" type="constant" identity="queryclient" parent="~/.framework/src/main.tsx"]
+// CIL[DOC-MACRO purpose="Create a configured TanStack Query client for the application"]
+// CIL[DOC-RESPONSIBILITY responsibility="Hold the query client instance with default query options"]
+// CIL[DOC-CONTEXT module="main" layer="data_fetching" related_files=".framework/src/App.tsx,.framework/src/contexts/AuthContext.tsx,.framework/src/index.css,.framework/src/main.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="queryClient instance" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Instantiates QueryClient with retry set to 1 and window focus refetch disabled" notable_decisions=""]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const queryClient = new QueryClient({
   defaultOptions: {
     queries: {
@@ -46,21 +38,22 @@ const queryClient = new QueryClient({
     },
   },
 })
-// CIL[END chunk_id="main_queryclient_1783672456"]
-// CIL[BEGIN chunk_id="main_render_1783672456" type="function" identity="render" parent="none"]
-// CIL[DOC-MACRO purpose="Render React app to DOM"]
-// CIL[DOC-RESPONSIBILITY responsibility="Bootstrap React application"]
-// CIL[DOC-CONTEXT module="main" layer="frontend-entry" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="DOM render" errors="none" side_effects="DOM manipulation"]
-// CIL[DOC-MICRO logic_summary="Creates root and renders app with providers" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-entry. Direct callers: 2. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 2. Total affected: 2."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Create a configured TanStack Query client for the application'; No verified external callers; imports: .framework/src/App.tsx,.framework/src/contexts/AuthContext.tsx,.framework/src/index.css"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/main.tsx:queryclient:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/main.tsx:render:statement" type="statement" identity="render" parent="~/.framework/src/main.tsx"]
+// CIL[DOC-MACRO purpose="Mount the React application to the DOM root"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the application inside the query, router and auth providers"]
+// CIL[DOC-CONTEXT module="main" layer="ui_entry" related_files=".framework/src/App.tsx,.framework/src/contexts/AuthContext.tsx,.framework/src/index.css,.framework/src/main.tsx"]
+// CIL[DOC-CONTRACT inputs="queryClient" outputs="rendered React tree" errors="error if root element is missing" side_effects="mutates DOM"]
+// CIL[DOC-MICRO logic_summary="Calls ReactDOM.createRoot on the #root element and renders the provider hierarchy with App" notable_decisions="uses non-null assertion for getElementById"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 ReactDOM.createRoot(document.getElementById('root')!).render(
   <QueryClientProvider client={queryClient}>
     <BrowserRouter>
@@ -70,4 +63,10 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
     </BrowserRouter>
   </QueryClientProvider>,
 )
-// CIL[END chunk_id="main_render_1783672456"]
+// CIL[DOC-VECTOR type="context" content="purpose='Mount the React application to the DOM root'; No verified external callers; imports: .framework/src/App.tsx,.framework/src/contexts/AuthContext.tsx,.framework/src/index.css"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/main.tsx:render:statement"]

package/.framework/src/pages/DashboardPage.tsx

@@ -1,63 +1,58 @@
-
-
-
-// CIL[BEGIN chunk_id="dashboardpage_module_header_1783672456" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and dashboard dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import dashboard components and hooks"]
-// CIL[DOC-CONTEXT module="DashboardPage" layer="frontend-page" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React hooks and components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, hooks, routing, and icons" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/pages/DashboardPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/pages/DashboardPage.tsx"]
+// CIL[DOC-MACRO purpose="Admin dashboard page module"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the dashboard page entry point and declare its dependencies"]
+// CIL[DOC-CONTEXT module="dashboard" layer="page" related_files=".framework/src/contexts/AuthContext.tsx,.framework/src/hooks/useApi.ts,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="module exports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, auth context, API helpers, routing, and icons for the dashboard page" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
 // CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+
+
 import React, { useState, useEffect } from 'react'
 import { useAuth } from '../contexts/AuthContext'
 import { useApi } from '../hooks/useApi'
 import { apiFetch } from '../lib/api'
 import { useNavigate } from 'react-router-dom'
 import { Box, UserGroupIcon, FileText, BarChart3, Settings, Plus, CubeIcon } from 'lucide-react';
-// CIL[END chunk_id="dashboardpage_module_header_1783672456"]
-// CIL[BEGIN chunk_id="dashboardpage_typestat_1783672456" type="interface" identity="TypeStat" parent="none"]
-// CIL[DOC-MACRO purpose="Define type statistics interface"]
-// CIL[DOC-RESPONSIBILITY responsibility="Type definition for dashboard stats"]
-// CIL[DOC-CONTEXT module="DashboardPage" layer="frontend-page" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/db.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface for entity type statistics" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/db.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Admin dashboard page module'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/hooks/useApi.ts,.framework/src/lib/api.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/pages/DashboardPage.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/DashboardPage.tsx:TypeStat:interface" type="interface" identity="TypeStat" parent="~/.framework/src/pages/DashboardPage.tsx"]
+// CIL[DOC-MACRO purpose="Type definition for a single entity type statistic"]
+// CIL[DOC-RESPONSIBILITY responsibility="Describe the fields of a type stat object"]
+// CIL[DOC-CONTEXT module="dashboard" layer="type" related_files=".framework/src/contexts/AuthContext.tsx,.framework/src/hooks/useApi.ts,.framework/src/lib/api.ts,.framework/src/pages/DashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="TypeStat interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares name, count, slug, and icon fields for a statistic card" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface TypeStat {
   name: string
   count: number
   slug: string
   icon: any
 }
-// CIL[END chunk_id="dashboardpage_typestat_1783672456"]
-// CIL[BEGIN chunk_id="dashboardpage_dashboardpage_1783672456" type="function" identity="DashboardPage" parent="none"]
-// CIL[DOC-MACRO purpose="Render admin dashboard"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display entity overview and quick actions"]
-// CIL[DOC-CONTEXT module="DashboardPage" layer="frontend-page" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Dashboard JSX" errors="Network errors" side_effects="API calls, navigation"]
-// CIL[DOC-MICRO logic_summary="Fetches type stats, displays overview cards and actions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Type definition for a single entity type statistic'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/hooks/useApi.ts,.framework/src/lib/api.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/pages/DashboardPage.tsx:TypeStat:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/DashboardPage.tsx:DashboardPage:component" type="component" identity="DashboardPage" parent="~/.framework/src/pages/DashboardPage.tsx"]
+// CIL[DOC-MACRO purpose="Render the admin dashboard page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch item type statistics, render entity cards, and provide quick-action navigation"]
+// CIL[DOC-CONTEXT module="dashboard" layer="page" related_files=".framework/src/contexts/AuthContext.tsx,.framework/src/hooks/useApi.ts,.framework/src/lib/api.ts,.framework/src/pages/DashboardPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX dashboard UI" errors="console.error on failed fetches" side_effects="apiFetch calls and client-side navigation"]
+// CIL[DOC-MICRO logic_summary="On mount fetch active item types, counts per type, and renders a grid of cards plus quick action buttons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function DashboardPage() {
   const { user } = useAuth()
   const navigate = useNavigate()
@@ -201,4 +196,10 @@ export function DashboardPage() {
     </div>
   )
 }
-// CIL[END chunk_id="dashboardpage_dashboardpage_1783672456"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render the admin dashboard page'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx,.framework/src/hooks/useApi.ts,.framework/src/lib/api.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/pages/DashboardPage.tsx:DashboardPage:component"]

package/.framework/src/pages/NoAppPage.tsx

@@ -0,0 +1,50 @@
+// CIL[BEGIN stable_id="~/.framework/src/pages/NoAppPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/pages/NoAppPage.tsx"]
+// CIL[DOC-MACRO purpose="Neutral landing page for authenticated users with no routable apps"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a 'no apps installed' state with a sign-out action instead of a 404"]
+// CIL[DOC-CONTEXT module="pages" layer="page" related_files=".framework/src/contexts/AuthContext.tsx,.framework/src/App.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares imports for the NoAppPage component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="experimental"]
+// CIL[DOC-AUDIENCE audience="developers"]
+
+import React from 'react'
+import { useAuth } from '../contexts/AuthContext'
+// CIL[END stable_id="~/.framework/src/pages/NoAppPage.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/NoAppPage.tsx:noapppage:component" type="component" identity="NoAppPage" parent="~/.framework/src/pages/NoAppPage.tsx"]
+// CIL[DOC-MACRO purpose="Render a neutral landing when the account has no accessible apps"]
+// CIL[DOC-RESPONSIBILITY responsibility="Show a friendly empty state and a sign-out button for placed users whose account has no routable apps"]
+// CIL[DOC-CONTEXT module="pages" layer="page" related_files=".framework/src/contexts/AuthContext.tsx,.framework/src/App.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX landing page" errors="none" side_effects="calls logout() from useAuth on sign-out click"]
+// CIL[DOC-MICRO logic_summary="Static centered card: logo, 'no apps' message, sign-out button" notable_decisions="Rendered at '/' by AuthenticatedRouter when the user is not system_admin and no routable app prefix exists — replaces the previous Navigate-to-'/' → NotFound fallthrough"]
+// CIL[DOC-CONFIDENCE pass="first" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="experimental"]
+export function NoAppPage() {
+  const { logout } = useAuth()
+
+  return (
+    <div className="min-h-screen flex items-center justify-center bg-slate-50 px-4">
+      <div className="max-w-md w-full text-center space-y-6">
+        <div className="mx-auto flex items-center justify-center">
+          <img src="/spine-logo.svg" alt="Spine Framework" className="h-14 w-auto" />
+        </div>
+        <div className="space-y-2">
+          <h1 className="text-2xl font-semibold text-slate-900">No apps yet</h1>
+          <p className="text-slate-600">
+            No apps are installed for your account yet. Contact your administrator
+            to get access, or sign out and try a different account.
+          </p>
+        </div>
+        <button
+          type="button"
+          onClick={() => logout()}
+          className="py-2 px-4 rounded-[5px] bg-slate-900 text-white text-sm font-medium hover:bg-slate-800"
+        >
+          Sign out
+        </button>
+      </div>
+    </div>
+  )
+}
+// CIL[END stable_id="~/.framework/src/pages/NoAppPage.tsx:noapppage:component"]

package/.framework/src/pages/NotFoundPage.tsx

@@ -1,38 +1,35 @@
+// CIL[BEGIN stable_id="~/.framework/src/pages/NotFoundPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/pages/NotFoundPage.tsx"]
+// CIL[DOC-MACRO purpose="Import dependencies used by the NotFoundPage 404 component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide React, react-router-dom Link, and lucide-react Home icon for the page"]
+// CIL[DOC-CONTEXT module=".framework/src/pages" layer="page" related_files=".framework/src/pages/NotFoundPage.tsx"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Imports React, Link, and Home icon; no runtime logic" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="Spine framework page authors"]
+
 
 
-// CIL[BEGIN chunk_id="notfoundpage_module_header_1783672456" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and components"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import required dependencies"]
-// CIL[DOC-CONTEXT module="NotFoundPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, Link, and Home icon" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React from 'react'
 import { Link } from 'react-router-dom'
 import { Home } from 'lucide-react';
-// CIL[END chunk_id="notfoundpage_module_header_1783672456"]
-// CIL[BEGIN chunk_id="notfoundpage_notfoundpage_1783672456" type="function" identity="NotFoundPage" parent="none"]
-// CIL[DOC-MACRO purpose="Render 404 error page"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display not found error with navigation"]
-// CIL[DOC-CONTEXT module="NotFoundPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="404 page JSX" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Shows 404 message and login link" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Import dependencies used by the NotFoundPage 404 component'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/pages/NotFoundPage.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/NotFoundPage.tsx:NotFoundPage:component" type="component" identity="NotFoundPage" parent="~/.framework/src/pages/NotFoundPage.tsx"]
+// CIL[DOC-MACRO purpose="Render a friendly 404 not found page with a link back to sign in"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a centered 404 message and a Home icon link that navigates to /login"]
+// CIL[DOC-CONTEXT module=".framework/src/pages" layer="page" related_files=".framework/src/pages/NotFoundPage.tsx"]
+// CIL[DOC-CONTRACT inputs="None" outputs="JSX 404 page" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Renders a full-screen 404 page with a heading, description, and a Link to /login" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="End users who reach an unknown route"]
 export function NotFoundPage() {
   return (
     <div className="min-h-screen bg-slate-50 flex flex-col justify-center py-12 sm:px-6 lg:px-8">
@@ -58,4 +55,10 @@ export function NotFoundPage() {
     </div>
   )
 }
-// CIL[END chunk_id="notfoundpage_notfoundpage_1783672456"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a friendly 404 not found page with a link back to sign in'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/pages/NotFoundPage.tsx:NotFoundPage:component"]

package/.framework/src/pages/SetupPage.tsx

@@ -1,44 +1,39 @@
+// CIL[BEGIN stable_id="~/.framework/src/pages/SetupPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/pages/SetupPage.tsx"]
+// CIL[DOC-MACRO purpose="Declare module-level imports for the Setup page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React and the Link routing component so SetupPage can render"]
+// CIL[DOC-CONTEXT module=".framework/src/pages/SetupPage.tsx" layer="ui" related_files=".framework/src/pages/SetupPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React and Link bindings available to the module" errors="Module load fails if react-router-dom is not installed" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Import React and Link from react-router-dom" notable_decisions="Keeps imports minimal and localized to the page"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="developers"]
 
-
-// CIL[BEGIN chunk_id="setuppage_module_header_1783672456" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and routing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import required components"]
-// CIL[DOC-CONTEXT module="SetupPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React and Link for setup page" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React from 'react'
 import { Link } from 'react-router-dom'
-// CIL[END chunk_id="setuppage_module_header_1783672456"]
-// CIL[BEGIN chunk_id="setuppage_setuppage_1783672456" type="function" identity="SetupPage" parent="none"]
-// CIL[DOC-MACRO purpose="Render setup instructions page"]
-// CIL[DOC-RESPONSIBILITY responsibility="Show initial setup guide"]
-// CIL[DOC-CONTEXT module="SetupPage" layer="frontend-page" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Setup page JSX" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Displays setup steps and login link" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-page. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Declare module-level imports for the Setup page'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/pages/SetupPage.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/pages/SetupPage.tsx:SetupPage:component" type="component" identity="SetupPage" parent="~/.framework/src/pages/SetupPage.tsx"]
+// CIL[DOC-MACRO purpose="Render a welcome/setup landing page when no apps are installed"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display onboarding instructions and a link to the login page"]
+// CIL[DOC-CONTEXT module=".framework/src/pages/SetupPage.tsx" layer="ui" related_files=".framework/src/pages/SetupPage.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX for the setup page with instructions and login link" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Return a centered layout with the logo, getting started steps, and a login link" notable_decisions="Uses Tailwind utility classes for layout and styling, keeps the component stateless and presentational"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stable]
+
 export function SetupPage() {
   return (
     <div className="min-h-screen flex items-center justify-center bg-slate-50 py-12 px-4 sm:px-6 lg:px-8">
       <div className="max-w-lg w-full space-y-8">
         <div className="text-center">
-          <div className="mx-auto h-12 w-12 flex items-center justify-center rounded-full bg-slate-900">
-            <span className="text-white font-bold text-xl">S</span>
+          <div className="mx-auto flex items-center justify-center">
+            <img src="/spine-logo.svg" alt="Spine Framework" className="h-14 w-auto" />
           </div>
           <h2 className="mt-6 text-3xl font-extrabold text-slate-900">
             Welcome to Spine
@@ -62,7 +57,7 @@ export function SetupPage() {
             </li>
             <li>
               Install an app:{' '}
-              <code className="bg-slate-100 px-1 rounded">npx spine-framework install-app spine-framework-cortex@next</code>
+              <code className="bg-slate-100 px-1 rounded">npx spine-framework install-app &lt;app-package&gt;</code>
             </li>
             <li>
               Reassemble:{' '}
@@ -83,4 +78,10 @@ export function SetupPage() {
     </div>
   )
 }
-// CIL[END chunk_id="setuppage_setuppage_1783672456"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a welcome/setup landing page when no apps are installed'; No verified external callers; imports: none"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/pages/SetupPage.tsx:SetupPage:component"]