spine-framework 0.3.144 → 0.4.0

package/.framework/src/components/app-shell/GenericListPage.tsx

@@ -1,22 +1,12 @@
-
-
-
-
-// CIL[BEGIN chunk_id="genericlistpage_module_header_1783930597" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import hooks and runtime components for generic list page"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide data fetching and UI rendering dependencies"]
-// CIL[DOC-CONTEXT module="generic-list-page" layer="frontend-component" 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/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports schema hook, entity list hook, and runtime UI components" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericListPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/app-shell/GenericListPage.tsx"]
+// CIL[DOC-MACRO purpose="Imports and module setup for the generic list page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide dependencies for GenericListPage rendering"]
+// CIL[DOC-CONTEXT module="app-shell" layer="framework" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/runtime/DataFilters.tsx,.framework/src/components/runtime/DataHeader.tsx,.framework/src/components/runtime/DataStats.tsx,.framework/src/components/runtime/DataTable.tsx,.framework/src/hooks/useEntityList.ts,.framework/src/hooks/useListSchema.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports hooks and UI subcomponents used by the list 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-component. 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/components/ui/dialog.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"]
+// CIL[DOC-AUDIENCE audience="framework"]
 import { useListSchema } from '../../hooks/useListSchema'
 import { useEntityList } from '../../hooks/useEntityList'
 import { DataHeader } from '../runtime/DataHeader'
@@ -24,54 +14,54 @@ import { DataStats } from '../runtime/DataStats'
 import { DataFilters } from '../runtime/DataFilters'
 import { DataTable } from '../runtime/DataTable'
 import { PageInstructions } from '../admin/PageInstructions'
-// CIL[END chunk_id="genericlistpage_module_header_1783930597"]
-// CIL[BEGIN chunk_id="genericlistpage_genericlistpageprops_1783930597" type="interface" identity="GenericListPageProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for generic list page component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify configuration for schema-driven list display"]
-// CIL[DOC-CONTEXT module="generic-list-page" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".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 with type slug, view configuration, and routing paths" 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-component. 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/functions/_shared/schema-utils.ts, .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='Imports and module setup for the generic list page'; No verified external callers; imports: .framework/src/hooks/useListSchema.ts,.framework/src/hooks/useEntityList.ts,.framework/src/components/runtime/DataHeader.tsx"]
+// 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/components/app-shell/GenericListPage.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericListPage.tsx:genericlistpageprops:interface" type="interface" identity="genericlistpageprops" parent="~/.framework/src/components/app-shell/GenericListPage.tsx"]
+// CIL[DOC-MACRO purpose="Props interface for GenericListPage"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the expected props for the list page"]
+// CIL[DOC-CONTEXT module="app-shell" layer="framework" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/components/runtime/DataFilters.tsx,.framework/src/components/runtime/DataHeader.tsx,.framework/src/components/runtime/DataStats.tsx,.framework/src/components/runtime/DataTable.tsx,.framework/src/hooks/useEntityList.ts,.framework/src/hooks/useListSchema.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface describing typeSlug, viewSlug, appPrefix, and detailPath" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface GenericListPageProps {
   typeSlug: string
   viewSlug?: string
   appPrefix: string
   detailPath: string
 }
-// CIL[END chunk_id="genericlistpage_genericlistpageprops_1783930597"]
-// CIL[BEGIN chunk_id="genericlistpage_genericlistpage_1783930597" type="function" identity="GenericListPage" parent="none"]
-// CIL[DOC-LEARNING topic="runtime-type:generic/list_view" content="GenericListPage uses record.design_schema.views.default_list with type list and display table/card/board. It reads fields map for display_type, sortable, and searchable. It also uses default_sort, stats, filters, and group_by when present."]
-// CIL[DOC-NOTE type="design_schema_caveat" content="A missing default_list view causes the list to render no columns unless useListSchema falls back to the types table. display_type must be one FieldRenderer recognizes or the cell falls back to text."]
-// CIL[DOC-MACRO purpose="Schema-driven list page with data table and filters"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render list view based on type schema and view configuration"]
-// CIL[DOC-CONTEXT module="generic-list-page" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX list page with data table" errors="Schema loading errors" side_effects="Data fetching, renders UI components"]
-// CIL[DOC-MICRO logic_summary="Resolves schema and view, builds config, fetches data, renders runtime components" 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-component. 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/IntegrationsPage.tsx, .framework/migrations/015_simplify_apps_table.sql, .framework/src/pages/admin/TypeDetailPage.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='Props interface for GenericListPage'; No verified external callers; imports: .framework/src/hooks/useListSchema.ts,.framework/src/hooks/useEntityList.ts,.framework/src/components/runtime/DataHeader.tsx"]
+// 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/components/app-shell/GenericListPage.tsx:genericlistpageprops:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/app-shell/GenericListPage.tsx:genericlistpage:function" type="function" identity="genericlistpage" parent="~/.framework/src/components/app-shell/GenericListPage.tsx"]
+// CIL[DOC-MACRO purpose="Render the generic list page for an app type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a sortable, filterable data table with schema-driven headers, stats, filters, and instructions"]
+// CIL[DOC-CONTEXT module="app-shell" layer="framework" related_files=".framework/src/components/admin/PageInstructions.tsx,.framework/src/components/app-shell/GenericListPage.tsx,.framework/src/components/runtime/DataFilters.tsx,.framework/src/components/runtime/DataHeader.tsx,.framework/src/components/runtime/DataStats.tsx,.framework/src/components/runtime/DataTable.tsx,.framework/src/hooks/useEntityList.ts,.framework/src/hooks/useListSchema.ts"]
+// CIL[DOC-CONTRACT inputs="typeSlug: string, viewSlug?: string, appPrefix: string, detailPath: string" outputs="JSX.Element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Resolve the list schema, build a config, load entity data, and render the list page with header, instructions, stats, filters, and table" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function GenericListPage({ typeSlug, viewSlug, appPrefix, detailPath }: GenericListPageProps) {
   const resolvedViewSlug = viewSlug || 'default_list'
 
-  
+
   const { schema, view, loading: schemaLoading, error: schemaError } = useListSchema({
     entity: 'items',
     viewSlug: resolvedViewSlug
   })
 
-  
+
   const config = view && schema ? {
     entity: 'items',
     typeSlug,
@@ -180,4 +170,10 @@ export function GenericListPage({ typeSlug, viewSlug, appPrefix, detailPath }: G
     </div>
   )
 }
-// CIL[END chunk_id="genericlistpage_genericlistpage_1783930597"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render the generic list page for an app type'; No verified external callers; imports: .framework/src/hooks/useListSchema.ts,.framework/src/hooks/useEntityList.ts,.framework/src/components/runtime/DataHeader.tsx"]
+// 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/components/app-shell/GenericListPage.tsx:genericlistpage:function"]

package/.framework/src/components/app-sidebar.tsx

@@ -1,22 +1,12 @@
-
-
-
-
-// CIL[BEGIN chunk_id="app-sidebar_module_header_1783930597" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and UI components for sidebar navigation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for the sidebar component"]
-// CIL[DOC-CONTEXT module="app-sidebar" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, UI components, and icons needed for sidebar" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/app-sidebar.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/app-sidebar.tsx:file"]
+// CIL[DOC-MACRO purpose="Provides a documentation navigation sidebar with collapsible sections and search integration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Imports React, local sidebar primitives, the search form, and Lucide icons used by AppSidebar"]
+// CIL[DOC-CONTEXT module="app-sidebar.tsx" layer="components" related_files=".framework/src/components/search-form.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="local bindings for React, Sidebar primitives, SearchForm, and Lucide icons" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, sidebar UI components, search-form, and icons for the documentation sidebar." 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-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.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"]
+// CIL[DOC-AUDIENCE audience="UI component consumers, React developers, design system maintainers"]
 import * as React from "react"
 
 import { SearchForm } from "./search-form"
@@ -39,21 +29,21 @@ import {
   SidebarRail,
 } from "./ui/sidebar"
 import { GalleryVerticalEndIcon, PlusIcon, MinusIcon } from "lucide-react"
-// CIL[END chunk_id="app-sidebar_module_header_1783930597"]
-// CIL[BEGIN chunk_id="app-sidebar_data_1783930597" type="constant" identity="data" parent="none"]
-// CIL[DOC-MACRO purpose="Define navigation structure for documentation sidebar"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide hierarchical navigation data with sections and items"]
-// CIL[DOC-CONTEXT module="app-sidebar" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Navigation data object" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Static navigation tree with Getting Started, Build Your Application, API Reference, Architecture, and Community sections" 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-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.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='Provides a documentation navigation sidebar with collapsible sections and search integration'; No verified external callers; imports: .framework/src/components/search-form.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
+// 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/components/app-sidebar.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/app-sidebar.tsx:data:constant" type="constant" identity="data" parent="~/.framework/src/components/app-sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Defines the static navigation data for the documentation sidebar sections"]
+// CIL[DOC-RESPONSIBILITY responsibility="Holds the navMain array of documentation topics, URLs, and nested items"]
+// CIL[DOC-CONTEXT module="app-sidebar.tsx" layer="components" related_files=".framework/src/components/app-sidebar.tsx,.framework/src/components/search-form.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="data object with navMain navigation tree" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Constant object defining documentation navigation sections with titles, URLs, and nested items." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const data = {
   navMain: [
     {
@@ -193,21 +183,22 @@ const data = {
     },
   ],
 }
-// CIL[END chunk_id="app-sidebar_data_1783930597"]
-// CIL[BEGIN chunk_id="app-sidebar_appsidebar_1783930597" type="function" identity="AppSidebar" parent="none"]
-// CIL[DOC-MACRO purpose="Render main navigation sidebar with collapsible sections"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create sidebar UI with header, navigation items, and search"]
-// CIL[DOC-CONTEXT module="app-sidebar" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX sidebar component" errors="none" side_effects="Renders navigation UI"]
-// CIL[DOC-MICRO logic_summary="Maps navigation data to collapsible sidebar sections with icons and active states" 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-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/RolesPage.tsx, .framework/src/components/ui/dialog.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='Defines the static navigation data for the documentation sidebar sections'; No verified external callers; imports: .framework/src/components/search-form.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
+// 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/components/app-sidebar.tsx:data:constant"]
+// CIL[BEGIN stable_id="~/.framework/src/components/app-sidebar.tsx:appsidebar:function" type="function" identity="AppSidebar" parent="~/.framework/src/components/app-sidebar.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the application sidebar with a header, search, and collapsible navigation menu"]
+// CIL[DOC-RESPONSIBILITY responsibility="Displays the documentation navigation sidebar using the data constant and UI primitives"]
+// CIL[DOC-CONTEXT module="app-sidebar.tsx" layer="components" related_files=".framework/src/components/app-sidebar.tsx,.framework/src/components/search-form.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
+// CIL[DOC-CONTRACT inputs="props (React.ComponentProps<typeof Sidebar>)" outputs="JSX.Element" errors="none" side_effects="Renders sidebar DOM elements"]
+// CIL[DOC-MICRO logic_summary="Renders a Sidebar with header, SearchForm, and collapsible nav groups driven by data.navMain." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function AppSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
   return (
     <Sidebar {...props}>
@@ -272,4 +263,10 @@ export function AppSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
     </Sidebar>
   )
 }
-// CIL[END chunk_id="app-sidebar_appsidebar_1783930597"]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders the application sidebar with a header, search, and collapsible navigation menu'; No verified external callers; imports: .framework/src/components/search-form.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
+// 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/components/app-sidebar.tsx:appsidebar:function"]

package/.framework/src/components/auth/ProtectedRoute.tsx

@@ -5,58 +5,59 @@
 
 
 
-// CIL[BEGIN chunk_id="protectedroute_module_header_1783930597" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and routing components for authentication"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide core dependencies for route protection"]
-// CIL[DOC-CONTEXT module="protected-route" layer="frontend-component" 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/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, Navigate for routing, and useAuth hook" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/auth/ProtectedRoute.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
+// CIL[DOC-MACRO purpose="Provide the module-level imports for the ProtectedRoute component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import the React runtime, Navigate router utility, and the Auth context hook"]
+// CIL[DOC-CONTEXT module="components/auth" layer="presentation" related_files=".framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, Navigate from react-router-dom, and useAuth from the AuthContext for use by the ProtectedRoute function" 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-component. 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/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"]
+// CIL[DOC-AUDIENCE audience="developers"]
+
 import React from 'react'
 import { Navigate } from 'react-router-dom'
 import { useAuth } from '../../contexts/AuthContext'
-// CIL[END chunk_id="protectedroute_module_header_1783930597"]
-// CIL[BEGIN chunk_id="protectedroute_protectedrouteprops_1783930597" type="interface" identity="ProtectedRouteProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for route protection component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify configurable options for protected routes"]
-// CIL[DOC-CONTEXT module="protected-route" layer="frontend-component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Type definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with optional system admin requirement flag" 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-component. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, 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='Provide the module-level imports for the ProtectedRoute component'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx"]
+// 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/components/auth/ProtectedRoute.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/auth/ProtectedRoute.tsx:protectedrouteprops:interface" type="interface" identity="ProtectedRouteProps" parent="module_header"]
+// CIL[DOC-MACRO purpose="Define the props contract for the ProtectedRoute component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare the typed shape of props accepted by the ProtectedRoute function"]
+// CIL[DOC-CONTEXT module="components/auth" layer="presentation" related_files=".framework/src/components/auth/ProtectedRoute.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="children React.ReactNode, requireSystemAdmin boolean" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines an interface with children of type React.ReactNode and an optional requireSystemAdmin boolean" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 interface ProtectedRouteProps {
   children: React.ReactNode
   requireSystemAdmin?: boolean
 }
-// CIL[END chunk_id="protectedroute_protectedrouteprops_1783930597"]
-// CIL[BEGIN chunk_id="protectedroute_protectedroute_1783930597" type="function" identity="ProtectedRoute" parent="none"]
-// CIL[DOC-MACRO purpose="Route guard component enforcing authentication and role checks"]
-// CIL[DOC-RESPONSIBILITY responsibility="Protect routes from unauthorized access with optional admin validation"]
-// CIL[DOC-CONTEXT module="protected-route" layer="frontend-component" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Protected content or redirect/denial UI" errors="none" side_effects="Navigation redirects, renders access denied UI"]
-// CIL[DOC-MICRO logic_summary="Checks user auth state and optional system_admin role, redirects to login or shows access denied" 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-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.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='Define the props contract for the ProtectedRoute component'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx"]
+// 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/components/auth/ProtectedRoute.tsx:protectedrouteprops:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/auth/ProtectedRoute.tsx:protectedroute:function" type="function" identity="ProtectedRoute" parent="module_header"]
+// CIL[DOC-MACRO purpose="Guard a React route by authentication and optional system-admin role"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render children when the user is authenticated and authorized, redirect anonymous users to login, and deny non-admin users when required"]
+// CIL[DOC-CONTEXT module="components/auth" layer="presentation" related_files=".framework/src/components/auth/ProtectedRoute.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="children React.ReactNode, requireSystemAdmin boolean" outputs="ReactElement | null" errors="none" side_effects="Navigates to /login via Navigate, and to /dashboard via window.location when denied"]
+// CIL[DOC-MICRO logic_summary="Obtains user from useAuth; if user is missing redirects to /login; if requireSystemAdmin is true and user does not hold system_admin role renders an Access Denied view with a dashboard button; otherwise renders children" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export function ProtectedRoute({ children, requireSystemAdmin = false }: ProtectedRouteProps) {
   const { user } = useAuth()
 
@@ -93,4 +94,10 @@ export function ProtectedRoute({ children, requireSystemAdmin = false }: Protect
 
   return <>{children}</>
 }
-// CIL[END chunk_id="protectedroute_protectedroute_1783930597"]
+// CIL[DOC-VECTOR type="context" content="purpose='Guard a React route by authentication and optional system-admin role'; No verified external callers; imports: .framework/src/contexts/AuthContext.tsx"]
+// 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/components/auth/ProtectedRoute.tsx:protectedroute:function"]

package/.framework/src/components/auth/TurnstileWidget.tsx

@@ -0,0 +1,27 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/auth/TurnstileWidget.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/auth/TurnstileWidget.tsx"]
+// CIL[DOC-MACRO purpose="Optional Cloudflare Turnstile bot-protection widget for auth surfaces"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a Turnstile challenge when VITE_TURNSTILE_SITE_KEY is configured; render nothing and stay inert otherwise"]
+// CIL[DOC-CONTEXT module="auth" layer="presentation" related_files=".framework/src/pages/auth/RegisterPage.tsx,.framework/src/pages/auth/LoginPage.tsx,.framework/src/pages/auth/ForgotPasswordPage.tsx,.framework/src/contexts/AuthContext.tsx"]
+// CIL[DOC-CONTRACT inputs="onToken: (token|null)=>void" outputs="JSX | null; token via callback" errors="onError/onExpire clear the token" side_effects="loads challenges.cloudflare.com script when rendered"]
+// CIL[DOC-MICRO logic_summary="Site key comes from import.meta.env at build time; absent key returns null so packaged installs and local dev keep existing behavior" notable_decisions="One Turnstile site should cover both the prod domain and localhost so the same key works everywhere"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="internal"]
+
+import { Turnstile } from '@marsidev/react-turnstile'
+
+const SITE_KEY = (import.meta.env.VITE_TURNSTILE_SITE_KEY as string | undefined) || ''
+
+export const turnstileEnabled = !!SITE_KEY
+
+export function TurnstileWidget({ onToken }: { onToken: (token: string | null) => void }) {
+  if (!SITE_KEY) return null
+  return (
+    <Turnstile
+      siteKey={SITE_KEY}
+      onSuccess={onToken}
+      onExpire={() => onToken(null)}
+      onError={() => onToken(null)}
+    />
+  )
+}
+// CIL[END stable_id="~/.framework/src/components/auth/TurnstileWidget.tsx:module_header:module_header"]