spine-framework 0.4.4 → 0.5.0-rc.4

package/.framework/src/components/ErrorBoundary.tsx

@@ -0,0 +1,136 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ErrorBoundary.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ErrorBoundary.tsx"]
+/**
+ * @module   ErrorBoundary
+ * @audience internal
+ * @layer    app-specific
+ * @stability stable
+ *
+ * This module provides an Error Boundary component that captures JavaScript errors in its child component tree, logs those errors, and displays a fallback UI. It plays a crucial role in enhancing the user experience by preventing the entire application from crashing due to errors in specific components.
+ * INVARIANT: The Error Boundary must wrap components that may throw errors to function correctly.
+ *
+ * @seeAlso ui/button (provides the button UI used in the fallback UI.)
+ * @seeAlso ReactNode (used for rendering child components.)
+ *
+ * @cil-generated
+ */
+
+import { Component, ErrorInfo, ReactNode } from 'react'
+import { Button } from './ui/button'
+// CIL[END stable_id="~/.framework/src/components/ErrorBoundary.tsx:module_header:module_header"]
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ErrorBoundary.tsx:ErrorBoundaryProps:interface" type="interface" identity="ErrorBoundaryProps" parent="~/.framework/src/components/ErrorBoundary.tsx"]
+/**
+ * ErrorBoundaryProps defines the properties for the ErrorBoundary component, which is used to handle errors in React component trees. It ensures that child components can be rendered safely even when an error occurs.
+ *
+ * @sideEffects none
+ * @stability   stable
+ * @cil-generated
+ */
+interface ErrorBoundaryProps {
+  children: ReactNode
+}
+// CIL[END stable_id="~/.framework/src/components/ErrorBoundary.tsx:ErrorBoundaryProps:interface"]
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ErrorBoundary.tsx:ErrorBoundaryState:interface" type="interface" identity="ErrorBoundaryState" parent="~/.framework/src/components/ErrorBoundary.tsx"]
+/**
+ * The ErrorBoundaryState interface defines the structure of the state used in an error boundary component to manage errors that occur during rendering. This facilitates organized error handling in React components.
+ *
+ * @sideEffects none
+ * @stability   stable
+ * @cil-generated
+ */
+interface ErrorBoundaryState {
+  error: Error | null
+}
+// CIL[END stable_id="~/.framework/src/components/ErrorBoundary.tsx:ErrorBoundaryState:interface"]
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ErrorBoundary.tsx:ErrorBoundary:class" type="class" identity="ErrorBoundary" parent="~/.framework/src/components/ErrorBoundary.tsx"]
+/**
+ * The ErrorBoundary class catches JavaScript errors in its child component tree, logs those errors, and displays a fallback UI to enhance user experience. This prevents the entire application from crashing due to UI errors.
+ *
+ * @macro       Error handling component that provides a fallback UI for its children upon encountering errors.
+ * @micro       Utilizes React's error boundary lifecycle methods to manage error state and render fallback content.
+ * @inputSpec
+ *   props: ErrorBoundaryProps (required) — properties passed to the component.
+ * @outputSpec  JSX.Element — renders either the children or an error fallback UI.
+ * @sideEffects logs errors to the console
+ * @stability   stable
+ * @calls       console.error
+ * @errorHandling none
+ * @cil-generated
+ */
+export class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+  constructor(props: ErrorBoundaryProps) {
+    super(props)
+    this.state = { error: null }
+  }
+
+  static getDerivedStateFromError(error: Error): ErrorBoundaryState {
+    return { error }
+  }
+
+  componentDidCatch(error: Error, info: ErrorInfo) {
+    console.error('ErrorBoundary caught an error:', error, info.componentStack)
+  }
+
+  render() {
+    if (!this.state.error) {
+      return this.props.children
+    }
+
+    return (
+      <div className="min-h-[400px] flex items-center justify-center p-8">
+        <div className="text-center max-w-lg">
+          <h1 className="text-xl font-semibold text-foreground mb-2">Something went wrong</h1>
+          <p className="text-sm text-muted-foreground mb-4">
+            This page hit an unexpected error. The rest of the app is unaffected.
+          </p>
+          <pre className="bg-muted rounded-lg p-4 text-left text-xs text-destructive overflow-auto mb-4 max-h-40">
+            {this.state.error.message}
+          </pre>
+          <div className="flex gap-2 justify-center">
+            <Button variant="outline" onClick={() => this.setState({ error: null })}>
+              Try again
+            </Button>
+            <Button variant="outline" onClick={() => { window.location.href = '/spine-framework/admin/configs/types' }}>
+              Back to admin home
+            </Button>
+          </div>
+        </div>
+      </div>
+    )
+  }
+}
+// CIL[END stable_id="~/.framework/src/components/ErrorBoundary.tsx:ErrorBoundary:class"]
+
+

package/.framework/src/components/admin/AdminListPage.tsx

@@ -1,14 +1,29 @@
-// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminListPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
-// CIL[DOC-MACRO purpose="Admin list page component module imports and entry point."]
-// CIL[DOC-RESPONSIBILITY responsibility="Import dependencies and declare the AdminListPage component module."]
-// CIL[DOC-CONTEXT module="AdminListPage" layer="components/admin" related_files=".framework/src/components/admin/AdminStatsCard.tsx,.framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/select.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/utils.ts"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Aggregates imports for the admin list page UI: React, UI primitives, icons, local components, and utils." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="module"]
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminListPage.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/admin/AdminListPage.tsx"]
+/**
+ * @module   AdminListPage
+ * @audience internal
+ * @layer    app-specific
+ * @stability stable
+ *
+ * The AdminListPage module is responsible for rendering the admin interface that displays a list of administrative items and provides functionalities for searching and filtering. It serves as a key component in the admin dashboard, allowing users to navigate through various admin-related tasks. INVARIANT: The user must have admin privileges to access this page.
+ *
+ * @seeAlso AdminStatsCard (provides statistics relevant to the admin interface).
+ * @seeAlso PageInstructions (offers guidance on using the admin features).
+ *
+ * @cil-generated
+ */
+
+
+
+
+
+
+
+
+
 
 import React, { ReactNode } from 'react'
+import { useNavigate } from 'react-router-dom'
 import { Button } from '../ui/button'
 import { Card, CardContent } from '../ui/card'
 import { Input } from '../ui/input'
@@ -17,28 +32,37 @@ import { Skeleton } from '../ui/skeleton'
 import { Search } from 'lucide-react'
 import { LucideIcon } from 'lucide-react'
 import { AdminStatsCard } from './AdminStatsCard'
-import { PageInstructions } from './PageInstructions'
+
 import { cn } from '../../lib/utils'
-// CIL[DOC-VECTOR type="context" content="purpose='Admin list page component module imports and entry point.'; No verified external callers; imports: .framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.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/admin/AdminListPage.tsx:module_header:module_header"]
-// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminListPage.tsx:adminlistpageprops:interface" type="interface" identity="AdminListPageProps" parent="adminlistpage:function"]
-// CIL[DOC-MACRO purpose="Props contract for the AdminListPage component."]
-// CIL[DOC-RESPONSIBILITY responsibility="Define the typed input surface for AdminListPage."]
-// CIL[DOC-CONTEXT module="AdminListPage" layer="components/admin" related_files=".framework/src/components/admin/AdminListPage.tsx,.framework/src/components/admin/AdminStatsCard.tsx,.framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/select.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/utils.ts"]
-// CIL[DOC-CONTRACT inputs="property bag: title, description, statsCards, children, optional search/filter/loading/error/new-button fields" outputs="typed props interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Describes the complete prop surface for the admin list page, including stats, search, filters, loading, error, and children." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminListPage.tsx:AdminListPageProps:interface" type="interface" identity="AdminListPageProps" parent="~/.framework/src/components/admin/AdminListPage.tsx"]
+/**
+ * AdminListPageProps defines the properties required for rendering the Admin List Page component, facilitating the configuration of various UI elements and behaviors within the admin interface.
+ *
+ * @sideEffects none
+ * @stability   stable
+ * @cil-generated
+ */
 interface AdminListPageProps {
   title: string
   description: string
-  noPageInstructions?: boolean
   newButtonText?: string
   newButtonHref?: string
   onNewClick?: () => void
@@ -64,28 +88,31 @@ interface AdminListPageProps {
   emptyMessage?: string
   emptyIcon?: LucideIcon
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Props contract for the AdminListPage component.'; No verified external callers; imports: .framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.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/admin/AdminListPage.tsx:adminlistpageprops:interface"]
-
-
-// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminListPage.tsx:adminlistpage:function" type="function" identity="AdminListPage" parent=""]
-// CIL[DOC-MACRO purpose="Render a reusable admin list page with header, instructions, stats, search, filters, and content."]
-// CIL[DOC-RESPONSIBILITY responsibility="Compose and render the admin list page layout and its interactive controls."]
-// CIL[DOC-CONTEXT module="AdminListPage" layer="components/admin" related_files=".framework/src/components/admin/AdminListPage.tsx,.framework/src/components/admin/AdminStatsCard.tsx,.framework/src/components/admin/PageInstructions.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/select.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/lib/utils.ts"]
-// CIL[DOC-CONTRACT inputs="AdminListPageProps" outputs="JSX.Element" errors="Error state rendered inside card" side_effects="Sets window.location.href when new button is clicked and no onNewClick handler provided"]
-// CIL[DOC-MICRO logic_summary="Builds a vertical page layout with title/actions, optional instructional help, stats cards, search/filter bar, and a content card that shows skeleton, error, or children." notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
+// CIL[END stable_id="~/.framework/src/components/admin/AdminListPage.tsx:AdminListPageProps:interface"]
+
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminListPage.tsx:AdminListPage:component" type="component" identity="AdminListPage" parent="~/.framework/src/components/admin/AdminListPage.tsx"]
 export function AdminListPage({
   title,
   description,
-  noPageInstructions,
   newButtonText,
   newButtonHref = '#',
   onNewClick,
@@ -99,6 +126,7 @@ export function AdminListPage({
   error = null,
   onRetry,
 }: AdminListPageProps) {
+  const navigate = useNavigate()
   return (
     <div className="space-y-6">
       <div className="flex justify-between items-center">
@@ -108,34 +136,12 @@ export function AdminListPage({
         </div>
         
         {newButtonText && (
-          <Button onClick={() => onNewClick ? onNewClick() : (window.location.href = newButtonHref!)}>
+          <Button onClick={() => onNewClick ? onNewClick() : navigate(newButtonHref)}>
             {newButtonText}
           </Button>
         )}
       </div>
 
-      {!noPageInstructions && (
-        <PageInstructions
-          sections={[
-            {
-              title: 'What this page is for',
-              content: `This page is the administrative list for ${title.toLowerCase()}. It shows all records in the system, their current state, and provides tools to search, filter, and create new records.`,
-            },
-            {
-              title: 'How to find records',
-              content: `Use the search field at the top of the list to look for records by name or keyword. Use the filter dropdowns to narrow the list by status, type, or other categories. Click any column header to sort ascending or descending.`,
-            },
-            {
-              title: 'How to create, view, and edit records',
-              content: `${newButtonText ? `Click the ${newButtonText} button in the top-right to create a new record. ` : ''}Click any row in the table to open its detail page. From the detail page you can review all fields, edit the record, and, if allowed, delete it. Deleting a record usually cannot be undone.`,
-            },
-            {
-              title: 'Understanding the stats',
-              content: `The summary cards above the table show the most important counts for this record type. Use them as a quick health check or to spot trends before drilling into the list.`,
-            },
-          ]}
-        />
-      )}
 
       <div className="grid grid-cols-1 gap-5 sm:grid-cols-2 lg:grid-cols-4">
         {statsCards.map((stat, index) => (
@@ -160,6 +166,7 @@ export function AdminListPage({
                     placeholder={searchPlaceholder}
                     value={searchValue}
                     onChange={(e) => onSearchChange(e.target.value)}
+
                     className="pl-9"
                   />
                 </div>
@@ -211,10 +218,11 @@ export function AdminListPage({
     </div>
   )
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Render a reusable admin list page with header, instructions, stats, search, filters, and content.'; No verified external callers; imports: .framework/src/components/ui/button.tsx,.framework/src/components/ui/card.tsx,.framework/src/components/ui/input.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/admin/AdminListPage.tsx:adminlistpage:function"]
+// CIL[END stable_id="~/.framework/src/components/admin/AdminListPage.tsx:AdminListPage:component"]
+
+
+
+
+
+
+

package/.framework/src/components/admin/AdminSidebar.tsx

@@ -1,12 +1,28 @@
-// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Provides React, router, icons, and UI component imports for the admin sidebar module"]
-// CIL[DOC-RESPONSIBILITY responsibility="Declares module-level imports required by AdminSidebar"]
-// CIL[DOC-CONTEXT module="admin" layer="presentation" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
-// CIL[DOC-CONTRACT inputs="none" outputs="imported symbols" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, react-router-dom hooks, lucide-react icons, and local sidebar/collapsible UI primitives" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/admin/AdminSidebar.tsx"]
+/**
+ * @module   AdminSidebar
+ * @audience both
+ * @layer    shared-core
+ * @stability stable
+ *
+ * The AdminSidebar module provides a navigational sidebar for the admin interface, allowing users to access various administrative functions and settings. It utilizes React components and icons to create an interactive and visually appealing sidebar layout.
+ * INVARIANT: The sidebar must always reflect the current user's permissions and available actions.
+ *
+ * @seeAlso useBranding (provides branding context for the sidebar).
+ * @seeAlso ../ui/sidebar (contains UI components used in the sidebar).
+ * @seeAlso ../ui/collapsible (provides collapsible functionality for sidebar groups).
+ *
+ * @cil-generated
+ */
+
+
+
+
+
+
+
+
+
 
 
 
@@ -14,13 +30,10 @@
 import * as React from "react"
 import { Link, useLocation } from "react-router-dom"
 import { 
-  PlusIcon, 
-  Database, 
-  Settings, 
+// CIL[END stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:module_header:module_header"]
+    Settings, 
   Type, 
-  Users, 
   Layout, 
-  FileText,
   BarChart3,
   AlertTriangle,
   Activity,
@@ -36,7 +49,6 @@ import {
   Lightbulb,
   Key,
   Truck,
-  TestTube,
   UserPlus,
   BookOpen,
   ChevronRight,
@@ -58,25 +70,33 @@ import {
   SidebarMenuSubItem,
   SidebarRail,
 } from "../ui/sidebar"
-import { Button } from "../ui/button"
+
 import { useBranding } from "../../hooks/useBranding"
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "../ui/collapsible"
-// CIL[DOC-VECTOR type="context" content="purpose='Provides React, router, icons, and UI component imports for the admin sidebar module'; No verified external callers; imports: .framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/collapsible.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/admin/AdminSidebar.tsx:module_header:module_header"]
-// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:navigationsections:constant" type="constant" identity="navigationSections" parent="none"]
-// CIL[DOC-MACRO purpose="Defines the static navigation section structure for the admin sidebar"]
-// CIL[DOC-RESPONSIBILITY responsibility="Maintain the ordered list of admin navigation sections, routes, and optional nested children"]
-// CIL[DOC-CONTEXT module="admin" layer="presentation" related_files=".framework/src/components/admin/AdminSidebar.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/collapsible.tsx,.framework/src/components/ui/sidebar.tsx"]
-// CIL[DOC-CONTRACT inputs="none" outputs="navigationSections: NavigationSection[]" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Static array of navigation sections with title, icon, optional children, and route URLs" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:navigationSections:constant" type="constant" identity="navigationSections" parent="~/.framework/src/components/admin/AdminSidebar.tsx"]
+/**
+ * The 'navigationSections' constant defines the structure of the sidebar navigation for the admin interface, organizing various sections for configuration, access, security, observability, testing, knowledge base, and CIL functionalities. This organization provides a clear and consistent navigation experience for users managing admin functionalities.
+ *
+ * @sideEffects none
+ * @stability   internal
+ * @cil-generated
+ */
 const navigationSections = [
   {
     title: "Configs",
@@ -112,20 +132,6 @@ const navigationSections = [
       { title: "Flagged Actors", url: "/spine-framework/admin/security", icon: Shield },
     ]
   },
-  {
-    title: "Runtime",
-    items: [
-      { title: "Items", url: "/spine-framework/admin/runtime/items", icon: Database },
-      { title: "Accounts", url: "/spine-framework/admin/runtime/accounts", icon: Users },
-      { title: "People", url: "/spine-framework/admin/runtime/people", icon: Users },
-      { title: "Threads", url: "/spine-framework/admin/runtime/threads", icon: MessageSquare },
-      { title: "Messages", url: "/spine-framework/admin/runtime/messages", icon: FileText },
-      { title: "Attachments", url: "/spine-framework/admin/runtime/attachments", icon: FileSearch },
-      { title: "Watchers", url: "/spine-framework/admin/runtime/watchers", icon: Activity },
-      { title: "Links", url: "/spine-framework/admin/runtime/links", icon: Puzzle },
-      { title: "Progress", url: "/spine-framework/admin/runtime/item_progress", icon: BarChart3 },
-    ]
-  },
   {
     title: "Observability",
     items: [
@@ -135,12 +141,6 @@ const navigationSections = [
       { title: "Logs", url: "/spine-framework/admin/observability/logs", icon: FileSearch },
     ]
   },
-  {
-    title: "Testing",
-    items: [
-      { title: "Test Runs", url: "/spine-framework/admin/testing", icon: TestTube },
-    ]
-  },
   {
     title: "KB Engine",
     items: [
@@ -159,22 +159,37 @@ const navigationSections = [
     ]
   }
 ]
-// CIL[DOC-VECTOR type="context" content="purpose='Defines the static navigation section structure for the admin sidebar'; No verified external callers; imports: .framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/collapsible.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/admin/AdminSidebar.tsx:navigationsections:constant"]
-// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:adminsidebar:function" type="function" identity="AdminSidebar" parent="none"]
-// CIL[DOC-MACRO purpose="Renders the admin sidebar with navigation sections and active route highlighting"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render the admin sidebar UI and compute active route state from useLocation"]
-// CIL[DOC-CONTEXT module="admin" layer="presentation" related_files=".framework/src/components/admin/AdminSidebar.tsx,.framework/src/components/ui/button.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="Reads useLocation and renders react-router Link components"]
-// CIL[DOC-MICRO logic_summary="Uses useLocation to determine active routes; maps navigationSections into collapsible sidebar groups and nested items" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
+// CIL[END stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:navigationSections:constant"]
+
+
+
+
+
+
+
 
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:AdminSidebar:component" type="component" identity="AdminSidebar" parent="~/.framework/src/components/admin/AdminSidebar.tsx"]
+/**
+ * The AdminSidebar component provides a navigational sidebar for admin functionalities, integrating branding and dynamic navigation sections. It enhances user experience by visually indicating active routes.
+ *
+ * @macro       Sidebar navigation component for admin interface.
+ * @micro       Utilizes React Router for navigation and manages active states based on the current URL.
+ * @inputSpec
+ *   props: React.ComponentProps<typeof Sidebar> (required) — properties passed to the Sidebar component.
+ * @outputSpec  JSX.Element — renders the sidebar layout with navigation items.
+ * @sideEffects none
+ * @stability   internal
+ * @calls       useBranding, useLocation, Link
+ * @cil-generated
+ */
 export function AdminSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
   const branding = useBranding()
   const location = useLocation()
@@ -199,12 +214,6 @@ export function AdminSidebar({ ...props }: React.ComponentProps<typeof Sidebar>)
           </SidebarMenuItem>
         </SidebarMenu>
 
-        <SidebarGroup className="py-2">
-          <Button className="w-full" size="sm">
-            <PlusIcon className="mr-2 h-4 w-4" />
-            Quick Create
-          </Button>
-        </SidebarGroup>
       </SidebarHeader>
 
       <SidebarContent>
@@ -288,10 +297,10 @@ export function AdminSidebar({ ...props }: React.ComponentProps<typeof Sidebar>)
     </Sidebar>
   )
 }
-// CIL[DOC-VECTOR type="context" content="purpose='Renders the admin sidebar with navigation sections and active route highlighting'; No verified external callers; imports: .framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/collapsible.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/admin/AdminSidebar.tsx:adminsidebar:function"]
+// CIL[END stable_id="~/.framework/src/components/admin/AdminSidebar.tsx:AdminSidebar:component"]
+
+
+
+
+
+