spine-framework 0.3.125 → 0.3.127

package/.framework/src/components/ui/toggle.tsx

@@ -1,9 +1,42 @@
+
+
+
+
+// CIL[BEGIN chunk_id="toggle_module_header_1783750525" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for toggle UI components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React, CVA, Radix UI primitives, and utility functions"]
+// CIL[DOC-CONTEXT module="toggle-ui" layer="ui-components" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React, cva, VariantProps, TogglePrimitive, cn" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports required libraries and utilities for toggle implementation" 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: ui-components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/table-primitives.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.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 * as React from "react"
 import { cva, type VariantProps } from "class-variance-authority"
 import { Toggle as TogglePrimitive } from "radix-ui"
 
 import { cn } from "@/lib/utils"
-
+// CIL[END chunk_id="toggle_module_header_1783750525"]
+// CIL[BEGIN chunk_id="toggle_togglevariants_1783750525" type="const" identity="toggleVariants" parent="none"]
+// CIL[DOC-MACRO purpose="Define styling variants for toggle component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide CVA configuration for toggle styling with variants and sizes"]
+// CIL[DOC-CONTEXT module="toggle-ui" layer="ui-components" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="cva config object" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Creates default/outline variants and sm/default/lg sizes with state-aware styling" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 2. Direct calls: 0. Related files: .framework/src/components/ui/table-primitives.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, \."]
+// 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 const toggleVariants = cva(
   "group/toggle inline-flex items-center justify-center gap-1 rounded-md text-xs font-medium whitespace-nowrap transition-all outline-none hover:bg-muted hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-destructive/20 aria-pressed:bg-muted data-[state=on]:bg-muted dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
   {
@@ -25,7 +58,21 @@ const toggleVariants = cva(
     },
   }
 )
-
+// CIL[END chunk_id="toggle_togglevariants_1783750525"]
+// CIL[BEGIN chunk_id="toggle_toggle_1783750525" type="function" identity="Toggle" parent="none"]
+// CIL[DOC-MACRO purpose="Toggle button component with variant and size support"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render toggle with Radix UI and CVA styling"]
+// CIL[DOC-CONTEXT module="toggle-ui" layer="ui-components" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Wraps Radix Root with variant and size-aware styling using toggleVariants" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/RolesPage.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"]
 function Toggle({
   className,
   variant = "default",
@@ -41,5 +88,20 @@ function Toggle({
     />
   )
 }
-
+// CIL[END chunk_id="toggle_toggle_1783750525"]
+// CIL[BEGIN chunk_id="toggle_export_1783750525" type="export" identity="export" parent="none"]
+// CIL[DOC-MACRO purpose="Export toggle component and variants"]
+// CIL[DOC-RESPONSIBILITY responsibility="Make toggle components available for import"]
+// CIL[DOC-CONTEXT module="toggle-ui" layer="ui-components" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="named exports" errors="none" side_effects="module exports"]
+// CIL[DOC-MICRO logic_summary="Exports Toggle component and toggleVariants for external use" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/RolesPage.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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export { Toggle, toggleVariants }
+// CIL[END chunk_id="toggle_export_1783750525"]

package/.framework/src/components/ui/tooltip.tsx

@@ -1,10 +1,45 @@
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="tooltip_module_header_1783750525" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies for tooltip UI components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React, Radix UI primitives, and utility functions"]
+// CIL[DOC-CONTEXT module="tooltip-ui" layer="ui-components" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React, TooltipPrimitive, cn" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports required libraries and utilities for tooltip implementation" 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: ui-components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/TypeDetailPage.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"]
 "use client"
 
 import * as React from "react"
 import { Tooltip as TooltipPrimitive } from "radix-ui"
 
 import { cn } from "@/lib/utils"
-
+// CIL[END chunk_id="tooltip_module_header_1783750525"]
+// CIL[BEGIN chunk_id="tooltip_tooltipprovider_1783750525" type="function" identity="TooltipProvider" parent="none"]
+// CIL[DOC-MACRO purpose="Provider for tooltip context with delay configuration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render tooltip provider with customizable delay duration"]
+// CIL[DOC-CONTEXT module="tooltip-ui" layer="ui-components" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Wraps Radix Provider with delay duration configuration" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.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"]
 function TooltipProvider({
   delayDuration = 0,
   ...props
@@ -17,19 +52,61 @@ function TooltipProvider({
     />
   )
 }
-
+// CIL[END chunk_id="tooltip_tooltipprovider_1783750525"]
+// CIL[BEGIN chunk_id="tooltip_tooltip_1783750525" type="function" identity="Tooltip" parent="none"]
+// CIL[DOC-MACRO purpose="Root tooltip container component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render tooltip root with data attribute"]
+// CIL[DOC-CONTEXT module="tooltip-ui" layer="ui-components" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Wraps Radix Root with tooltip data slot" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/layout/Sidebar.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.tsx, .framework/src/pages/admin/RolesPage.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"]
 function Tooltip({
   ...props
 }: React.ComponentProps<typeof TooltipPrimitive.Root>) {
   return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
 }
-
+// CIL[END chunk_id="tooltip_tooltip_1783750525"]
+// CIL[BEGIN chunk_id="tooltip_tooltiptrigger_1783750525" type="function" identity="TooltipTrigger" parent="none"]
+// CIL[DOC-MACRO purpose="Tooltip trigger element for hover/focus interaction"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render trigger with data attribute for tooltip activation"]
+// CIL[DOC-CONTEXT module="tooltip-ui" layer="ui-components" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Wraps Radix Trigger with tooltip data slot" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.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"]
 function TooltipTrigger({
   ...props
 }: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
   return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />
 }
-
+// CIL[END chunk_id="tooltip_tooltiptrigger_1783750525"]
+// CIL[BEGIN chunk_id="tooltip_tooltipcontent_1783750525" type="function" identity="TooltipContent" parent="none"]
+// CIL[DOC-MACRO purpose="Tooltip content panel with portal and animations"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render tooltip content with portal, styling, and arrow"]
+// CIL[DOC-CONTEXT module="tooltip-ui" layer="ui-components" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Wraps Radix Content with portal, animations, and arrow styling" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.tsx, .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/RolesPage.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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function TooltipContent({
   className,
   sideOffset = 0,
@@ -53,5 +130,20 @@ function TooltipContent({
     </TooltipPrimitive.Portal>
   )
 }
-
+// CIL[END chunk_id="tooltip_tooltipcontent_1783750525"]
+// CIL[BEGIN chunk_id="tooltip_export_1783750525" type="export" identity="export" parent="none"]
+// CIL[DOC-MACRO purpose="Export all tooltip components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Make tooltip components available for import"]
+// CIL[DOC-CONTEXT module="tooltip-ui" layer="ui-components" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="named exports" errors="none" side_effects="module exports"]
+// CIL[DOC-MICRO logic_summary="Exports Tooltip, TooltipContent, TooltipProvider, and TooltipTrigger" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: ui-components. Direct callers: 0. Direct calls: 0. Related files: none."]
+// 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"]
 export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger }
+// CIL[END chunk_id="tooltip_export_1783750525"]

package/.framework/src/contexts/AppContext.tsx

@@ -1,20 +1,50 @@
+
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="AppContext_module_header_1783749485" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports and type definitions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define React context types and import dependencies"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-context" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/db.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="type definitions" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Sets up imports and context interfaces for app management" 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-context. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/db.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, { createContext, useContext, useState, useEffect, useRef, useCallback } from 'react'
 import { AppRecord } from '../hooks/useApps'
 import { apiFetch } from '../lib/api'
 import { useAuth } from './AuthContext'
-
-// ─── Current App Context (per-route) ───────────────────────────────────────────
-
 interface AppContextType {
   app: AppRecord
 }
 
 const AppContext = createContext<AppContextType | undefined>(undefined)
-
-/**
- * Returns the current app record from the nearest AppProvider.
- * Must be called inside an AppProvider (i.e., inside an app route).
- */
+// CIL[END chunk_id="AppContext_module_header_1783749485"]
+// CIL[BEGIN chunk_id="AppContext_usecurrentapp_1783749485" type="function" identity="useCurrentApp" parent="none"]
+// CIL[DOC-MACRO purpose="Access current app from context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide current app record to components"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-hook" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="AppRecord" errors="throws if no provider" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Returns app from React context with safety check" 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-hook. Direct callers: 1. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 8."]
+// 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"]
 export function useCurrentApp(): AppRecord {
   const context = useContext(AppContext)
   if (context === undefined) {
@@ -22,15 +52,40 @@ export function useCurrentApp(): AppRecord {
   }
   return context.app
 }
-
+// CIL[END chunk_id="AppContext_usecurrentapp_1783749485"]
+// CIL[BEGIN chunk_id="AppContext_appproviderprops_1783749485" type="interface" identity="AppProviderProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define provider props interface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definition for AppProvider component"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-types" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Simple props interface with app and children" 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-types. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface AppProviderProps {
   app: AppRecord
   children: React.ReactNode
 }
-
-/**
- * Provides the current app record to all descendants via useCurrentApp().
- */
+// CIL[END chunk_id="AppContext_appproviderprops_1783749485"]
+// CIL[BEGIN chunk_id="AppContext_appprovider_1783749485" type="function" identity="AppProvider" parent="none"]
+// CIL[DOC-MACRO purpose="Provide current app context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Wrap components with app context"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-provider" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Provider component" errors="none" side_effects="context provider"]
+// CIL[DOC-MICRO logic_summary="Simple React context provider wrapper" 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-provider. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/functions/custom_cil-embeddings.ts, 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function AppProvider({ app, children }: AppProviderProps) {
   return (
     <AppContext.Provider value={{ app }}>
@@ -38,9 +93,21 @@ export function AppProvider({ app, children }: AppProviderProps) {
     </AppContext.Provider>
   )
 }
-
-// ─── Apps Registry Context (global, fetch-once) ─────────────────────────────
-
+// CIL[END chunk_id="AppContext_appprovider_1783749485"]
+// CIL[BEGIN chunk_id="AppContext_appsregistrycontexttype_1783749485" type="interface" identity="AppsRegistryContextType" parent="none"]
+// CIL[DOC-MACRO purpose="Define apps registry context type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definition for apps registry context"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-types" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines shape of apps registry context with apps list and loading state" 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-types. Direct callers: 0. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface AppsRegistryContextType {
   apps: AppRecord[]
   routableApps: AppRecord[]
@@ -50,12 +117,21 @@ interface AppsRegistryContextType {
 }
 
 const AppsRegistryContext = createContext<AppsRegistryContextType | undefined>(undefined)
-
-/**
- * Returns the global apps registry (all accessible apps for this user).
- * Fetches once on mount after auth, cached for the session.
- * Use this instead of useApps() to avoid per-page refetches.
- */
+// CIL[END chunk_id="AppContext_appsregistrycontexttype_1783749485"]
+// CIL[BEGIN chunk_id="AppContext_useappsregistry_1783749485" type="function" identity="useAppsRegistry" parent="none"]
+// CIL[DOC-MACRO purpose="Access apps registry from context"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide apps registry data to components"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-hook" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="AppsRegistryContextType" errors="throws if no provider" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Returns apps registry context with safety check" 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-hook. Direct callers: 1. Direct calls: 0. Related files: .framework/migrations/015_simplify_apps_table.sql, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
+// 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"]
 export function useAppsRegistry(): AppsRegistryContextType {
   const context = useContext(AppsRegistryContext)
   if (context === undefined) {
@@ -63,31 +139,45 @@ export function useAppsRegistry(): AppsRegistryContextType {
   }
   return context
 }
-
+// CIL[END chunk_id="AppContext_useappsregistry_1783749485"]
+// CIL[BEGIN chunk_id="AppContext_appsregistryproviderprops_1783749485" type="interface" identity="AppsRegistryProviderProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define registry provider props interface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type definition for AppsRegistryProvider component"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-types" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Simple props interface with only children" 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-types. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface AppsRegistryProviderProps {
   children: React.ReactNode
 }
-
-/**
- * Fetches accessible apps for the current user and provides them globally.
- *
- * Role-based filtering is done server-side by the `get_account_apps` RPC
- * (migration 020). The client trusts the backend response and only filters
- * for routability (has a route_prefix and a renderer) and the current
- * environment's domain (preview_domain or prod_domain, selected by
- * `VITE_ENVIRONMENT`).
- *
- * Uses an AbortController to cancel in-flight fetches when dependencies
- * change, preventing interleaved responses from stale requests.
- */
+// CIL[END chunk_id="AppContext_appsregistryproviderprops_1783749485"]
+// CIL[BEGIN chunk_id="AppContext_appsregistryprovider_1783749485" type="function" identity="AppsRegistryProvider" parent="none"]
+// CIL[DOC-MACRO purpose="Fetch and provide apps registry"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage apps registry state and API calls"]
+// CIL[DOC-CONTEXT module="AppContext" layer="frontend-provider" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Provider component" errors="network errors" side_effects="API calls, state updates"]
+// CIL[DOC-MICRO logic_summary="Fetches apps list, filters by domain, provides registry context" 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-provider. Direct callers: 0. Direct calls: 0. Related files: none."]
+// 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"]
 export function AppsRegistryProvider({ children }: AppsRegistryProviderProps) {
   const { user } = useAuth()
   const [apps, setApps] = useState<AppRecord[]>([])
   const [loading, setLoading] = useState(true)
   const [error, setError] = useState<string | null>(null)
   const abortRef = useRef<AbortController | null>(null)
-  // Track which user the current `apps` + `loading` state belongs to.
-  // When user changes, we know to treat state as stale until the new fetch lands.
   const loadedForUserRef = useRef<string | null>(null)
 
   const fetchApps = useCallback(async (signal?: AbortSignal) => {
@@ -111,7 +201,6 @@ export function AppsRegistryProvider({ children }: AppsRegistryProviderProps) {
       const data = await response.json()
       if (data.error) throw new Error(data.error)
 
-      // Backend already filters by role — no client-side role check needed
       const allApps: AppRecord[] = data.data || data || []
       setApps(allApps)
       loadedForUserRef.current = user.id
@@ -124,11 +213,8 @@ export function AppsRegistryProvider({ children }: AppsRegistryProviderProps) {
     }
   }, [user])
 
-  // Fetch when user identity or roles change.
-  // Abort any in-flight request before starting a new one.
   const rolesKey = user?.roles?.join(',') || ''
   useEffect(() => {
-    // Cancel previous fetch
     abortRef.current?.abort()
     const controller = new AbortController()
     abortRef.current = controller
@@ -138,8 +224,6 @@ export function AppsRegistryProvider({ children }: AppsRegistryProviderProps) {
     return () => controller.abort()
   }, [user?.id, user?.account_id, rolesKey, fetchApps])
 
-  // Derive effective loading: if user changed but we haven't fetched for them
-  // yet (effect hasn't fired), treat as loading to prevent 404 flash.
   const effectiveLoading = loading || (!!user && loadedForUserRef.current !== user.id)
 
   const environment = (import.meta.env.VITE_ENVIRONMENT as string) || 'prod'
@@ -148,7 +232,6 @@ export function AppsRegistryProvider({ children }: AppsRegistryProviderProps) {
   const appMatchesDomain = (app: AppRecord): boolean => {
     const domain = environment === 'preview' ? app.preview_domain : app.prod_domain
     if (!domain) return true
-    // Accept both "hostname.com" and "https://hostname.com" formats
     const hostname = domain.includes('://') ? new URL(domain).hostname : domain.split(':')[0]
     return currentHost === hostname
   }
@@ -170,3 +253,4 @@ export function AppsRegistryProvider({ children }: AppsRegistryProviderProps) {
     </AppsRegistryContext.Provider>
   )
 }
+// CIL[END chunk_id="AppContext_appsregistryprovider_1783749485"]