spine-framework 0.3.124 → 0.3.126

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

@@ -1,25 +1,29 @@
-/**
- * @module src/components/ui/ItemListView
- * @audience installer
- * @layer frontend-component
- * @stability stable
- *
- * Switchable item view widget and page shell.
- *
- * **`ItemListView`** — renders items in either a compact `ItemGrid` or a
- * full `DataTable` view, toggled by icon buttons. Derives unique type
- * filter options from the items array and builds a fixed table column
- * set. The primary display field is resolved from the first `text` or
- * `textarea` field in the item type's `design_schema`.
- *
- * **`ItemListPage`** — wraps `ItemListView` with a page-level title and
- * description header. Use as a standalone page component.
- *
- * @seeAlso src/components/ui/ItemCard.tsx
- * @seeAlso src/components/ui/DataTable.tsx
- * @seeAlso src/types/types.ts (Item, ItemType)
- */
 
+
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="ItemListView_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React and item list dependencies"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for item list view components"]
+// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React, useState, item types, UI components" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks, item types, DataTable, ItemCard, UI components" 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-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/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.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"]
 import React, { useState } from 'react'
 import { Item, ItemType } from '../../types/types'
 import { DataTable } from './DataTable'
@@ -28,20 +32,21 @@ import { Badge } from './badge'
 import { Button } from './button'
 import { Squares2X2Icon, List, Plus } from 'lucide-react';
 import { formatDateTime } from '../../lib/utils'
-
-/**
- * Props for `ItemListView`.
- *
- * @prop items - Typed item array with resolved `item_type`
- * @prop loading - Shows spinner while fetching
- * @prop onEdit / onDelete / onView - Row/card action callbacks
- * @prop onCreate - Create button callback
- * @prop searchable - Enables search in table view (default: `true`)
- * @prop filterable - Enables column filters in table view (default: `true`)
- * @prop emptyMessage - Empty-state label
- * @prop showCreateButton - Shows the create button (default: `true`)
- * @prop createButtonText - Create button label (default: `'Create Item'`)
- */
+// CIL[END chunk_id="ItemListView_moduleheader_1783907801"]
+// CIL[BEGIN chunk_id="ItemListView_itemlistviewprops_1783907801" type="interface" identity="ItemListViewProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props for item list view component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for ItemListView component configuration"]
+// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ItemListViewProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Props for items array, loading state, actions, and display options" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/components/ui/dialog.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: 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 ItemListViewProps {
   items: (Item & { item_type: ItemType })[]
   loading?: boolean
@@ -55,14 +60,21 @@ interface ItemListViewProps {
   showCreateButton?: boolean
   createButtonText?: string
 }
-
-/**
- * Switchable grid/table item view.
- *
- * @param props - `ItemListViewProps`
- * @returns Header with view-mode toggle + `ItemGrid` or `DataTable`
- * @sideEffects none (delegates actions and creation to prop callbacks)
- */
+// CIL[END chunk_id="ItemListView_itemlistviewprops_1783907801"]
+// CIL[BEGIN chunk_id="ItemListView_itemlistview_1783907801" type="function" identity="ItemListView" parent="none"]
+// CIL[DOC-MACRO purpose="Render switchable grid/table item view with mode toggle"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle view mode switching and item display rendering"]
+// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="View mode toggle + ItemGrid or DataTable" errors="none" side_effects="Calls action callbacks"]
+// CIL[DOC-MICRO logic_summary="Manages view mode state, builds table columns, renders appropriate view" 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/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .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"]
 export function ItemListView({
   items,
   loading = false,
@@ -78,7 +90,7 @@ export function ItemListView({
 }: ItemListViewProps) {
   const [viewMode, setViewMode] = useState<'grid' | 'table'>('grid')
 
-  // Get unique types for filtering
+  
   const typesMap = new Map<string, ItemType>()
   items.forEach(item => {
     typesMap.set(item.item_type.id, item.item_type)
@@ -88,7 +100,7 @@ export function ItemListView({
     label: type.name
   }))
 
-  // Table columns
+  
   const tableColumns = [
     {
       key: 'data' as const,
@@ -235,14 +247,21 @@ export function ItemListView({
     </div>
   )
 }
-
-/**
- * Props for `ItemListPage`.
- *
- * @prop title - Page heading (default: `'Items'`)
- * @prop description - Page subtitle (default: `'Manage and organize your items'`)
- * (other props same as `ItemListViewProps`)
- */
+// CIL[END chunk_id="ItemListView_itemlistview_1783907801"]
+// CIL[BEGIN chunk_id="ItemListView_itemlistpageprops_1783907801" type="interface" identity="ItemListPageProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props for item list page component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for ItemListPage component configuration"]
+// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ItemListPageProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Extends ItemListViewProps with page-level title and description" 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, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.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"]
 interface ItemListPageProps {
   items: (Item & { item_type: ItemType })[]
   loading?: boolean
@@ -258,14 +277,21 @@ interface ItemListPageProps {
   title?: string
   description?: string
 }
-
-/**
- * Full item list page with title header and switchable view.
- *
- * @param props - `ItemListPageProps`
- * @returns Page header + `ItemListView`
- * @sideEffects none (pure rendering)
- */
+// CIL[END chunk_id="ItemListView_itemlistpageprops_1783907801"]
+// CIL[BEGIN chunk_id="ItemListView_itemlistpage_1783907801" type="function" identity="ItemListPage" parent="none"]
+// CIL[DOC-MACRO purpose="Render full item list page with header and switchable view"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide page-level wrapper with title and ItemListView"]
+// CIL[DOC-CONTEXT module="ItemListView" 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\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Page with header + ItemListView" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders page header with title/description, wraps ItemListView component" 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/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"]
 export function ItemListPage({
   items,
   loading = false,
@@ -306,3 +332,4 @@ export function ItemListPage({
     </div>
   )
 }
+// CIL[END chunk_id="ItemListView_itemlistpage_1783907801"]

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

@@ -1,38 +1,62 @@
-/**
- * @module src/components/ui/LoadingSpinner
- * @audience installer
- * @layer frontend-component
- * @stability stable
- *
- * Animated CSS spinner used to indicate loading state inline or as a
- * centred overlay. Uses `border-t-blue-600` as the active segment colour
- * and `border-slate-200` for the track.
- *
- * @seeAlso src/lib/utils.ts (cn)
- */
 
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="LoadingSpinner_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React and spinner dependencies"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for loading spinner component"]
+// CIL[DOC-CONTEXT module="LoadingSpinner" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React, Loader2 icon, cn utility" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, lucide-react Loader2 icon, and utility function" 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-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/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"]
 import React from 'react'
 import { Loader2 } from 'lucide-react'
 import { cn } from '../../lib/utils'
-
-/**
- * Props for `LoadingSpinner`.
- *
- * @prop size - Diameter: `'sm'` (16px), `'md'` (24px), `'lg'` (32px)
- * @prop className - Additional Tailwind classes
- */
+// CIL[END chunk_id="LoadingSpinner_moduleheader_1783907801"]
+// CIL[BEGIN chunk_id="LoadingSpinner_loadingspinnerprops_1783907801" type="interface" identity="LoadingSpinnerProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props for loading spinner component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for LoadingSpinner component configuration"]
+// CIL[DOC-CONTEXT module="LoadingSpinner" layer="frontend-component" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="LoadingSpinnerProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Props for optional className and size (sm/md/lg)" 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/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, .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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface LoadingSpinnerProps {
   className?: string
   size?: 'sm' | 'md' | 'lg'
 }
-
-/**
- * Inline animated spinner.
- *
- * @param props - `LoadingSpinnerProps`
- * @returns `<Loader2>` styled as a spinning ring
- * @sideEffects none (pure rendering)
- */
+// CIL[END chunk_id="LoadingSpinner_loadingspinnerprops_1783907801"]
+// CIL[BEGIN chunk_id="LoadingSpinner_loadingspinner_1783907801" type="function" identity="LoadingSpinner" parent="none"]
+// CIL[DOC-MACRO purpose="Render animated loading spinner with configurable size"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display spinning loader icon with size and styling options"]
+// CIL[DOC-CONTEXT module="LoadingSpinner" layer="frontend-component" related_files="[\"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="Animated Loader2 component" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps size prop to Tailwind classes, applies animation and custom classes" 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: 1. Direct calls: 0. Related files: 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: 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 LoadingSpinner({ className, size = 'md' }: LoadingSpinnerProps) {
   const sizeClasses = {
     sm: 'h-4 w-4',
@@ -50,3 +74,4 @@ export function LoadingSpinner({ className, size = 'md' }: LoadingSpinnerProps)
     />
   )
 }
+// CIL[END chunk_id="LoadingSpinner_loadingspinner_1783907801"]

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

@@ -1,3 +1,23 @@
+
+
+
+
+
+// CIL[BEGIN chunk_id="Modal_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
+// CIL[DOC-MACRO purpose="Import React and dialog dependencies"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for modal components"]
+// CIL[DOC-CONTEXT module="Modal" 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/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React, cn, Dialog components" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, utility function, and shadcn dialog primitives" 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-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/RolesPage.tsx, .framework/functions/_shared/principal.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React from 'react'
 import { cn } from '../../lib/utils'
 import {
@@ -7,7 +27,21 @@ import {
   DialogTitle,
   DialogDescription,
 } from './dialog'
-
+// CIL[END chunk_id="Modal_moduleheader_1783907801"]
+// CIL[BEGIN chunk_id="Modal_modalprops_1783907801" type="interface" identity="ModalProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define main modal component props interface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for Modal component configuration"]
+// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ModalProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Props for open state, close handler, content, and sizing" 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/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/functions/_shared/schema-utils.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 ModalProps {
   isOpen: boolean
   onClose: () => void
@@ -16,7 +50,21 @@ interface ModalProps {
   children: React.ReactNode
   size?: 'sm' | 'md' | 'lg' | 'xl'
 }
-
+// CIL[END chunk_id="Modal_modalprops_1783907801"]
+// CIL[BEGIN chunk_id="Modal_modal_1783907801" type="function" identity="Modal" parent="none"]
+// CIL[DOC-MACRO purpose="Render modal dialog with configurable size and content"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle modal open/close state and content rendering"]
+// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Dialog wrapper" errors="none" side_effects="Calls onClose when dialog closed"]
+// CIL[DOC-MICRO logic_summary="Maps size prop to Tailwind max-width classes, conditionally renders header" 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, .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/table-primitives.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"]
 export function Modal({
   isOpen,
   onClose,
@@ -46,12 +94,40 @@ export function Modal({
     </Dialog>
   )
 }
-
+// CIL[END chunk_id="Modal_modal_1783907801"]
+// CIL[BEGIN chunk_id="Modal_modalfooterprops_1783907801" type="interface" identity="ModalFooterProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props for modal footer container"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify props for modal footer content and styling"]
+// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ModalFooterProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Props for children content and optional styling classes" 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/principal.ts, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface ModalFooterProps {
   children: React.ReactNode
   className?: string
 }
-
+// CIL[END chunk_id="Modal_modalfooterprops_1783907801"]
+// CIL[BEGIN chunk_id="Modal_modalfooter_1783907801" type="function" identity="ModalFooter" parent="none"]
+// CIL[DOC-MACRO purpose="Render modal footer with action buttons"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide styled container for modal action buttons"]
+// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Footer div container" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Uses Tailwind classes for flex layout, border, and spacing" 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, .framework/src/components/ui/table-primitives.tsx, .framework/functions/_shared/schema-utils.ts, .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"]
 export function ModalFooter({ children, className }: ModalFooterProps) {
   return (
     <div className={cn('flex justify-end gap-3 border-t px-6 py-4 mt-6', className)}>
@@ -59,3 +135,4 @@ export function ModalFooter({ children, className }: ModalFooterProps) {
     </div>
   )
 }
+// CIL[END chunk_id="Modal_modalfooter_1783907801"]

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

@@ -1,3 +1,25 @@
+
+
+
+
+
+// CIL[BEGIN chunk_id="richtexteditor_module_header_1783883196" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import TipTap editor, extensions, syntax highlighting, and UI dependencies"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide external dependencies for rich text editor system"]
+// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="TipTap, extensions, lowlight, icons, utils" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports TipTap editor core, extensions, syntax highlighting libraries, icons, and utilities" 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. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, \."]
+// 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 DOMPurify from 'dompurify'
+import { marked } from 'marked'
 import { useEditor, EditorContent } from '@tiptap/react'
 import StarterKit from '@tiptap/starter-kit'
 import CodeBlockLowlight from '@tiptap/extension-code-block-lowlight'
@@ -8,7 +30,7 @@ import javascript from 'highlight.js/lib/languages/javascript'
 import json from 'highlight.js/lib/languages/json'
 import bash from 'highlight.js/lib/languages/bash'
 import sql from 'highlight.js/lib/languages/sql'
-import { useEffect } from 'react'
+import { useEffect, useMemo } from 'react'
 import {
   Bold,
   Italic,
@@ -21,7 +43,21 @@ import {
   Minus,
 } from 'lucide-react'
 import { cn } from '@core/lib/utils'
-
+// CIL[END chunk_id="richtexteditor_module_header_1783883196"]
+// CIL[BEGIN chunk_id="richtexteditor_lowlight_1783883196" type="setup" identity="lowlight" parent="none"]
+// CIL[DOC-MACRO purpose="Configure syntax highlighting for code blocks"]
+// CIL[DOC-RESPONSIBILITY responsibility="Set up lowlight with multiple programming languages"]
+// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="lowlight instance" errors="none" side_effects="global config"]
+// CIL[DOC-MICRO logic_summary="Creates lowlight instance and registers TypeScript, JavaScript, JSON, Bash, SQL languages" 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. 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/functions/_shared/schema-utils.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"]
 const lowlight = createLowlight()
 lowlight.register('typescript', typescript)
 lowlight.register('javascript', javascript)
@@ -29,6 +65,28 @@ lowlight.register('json', json)
 lowlight.register('bash', bash)
 lowlight.register('sql', sql)
 
+function toHtml(raw: string | undefined): string {
+  const source = (raw ?? '').trim()
+  if (!source) return ''
+  const likelyHtml = /<\/?(?:h[1-6]|p|div|ul|ol|li|pre|code|br|span|strong|em|a|table|tr|td|th|thead|tbody|blockquote)\b/i.test(source)
+  return likelyHtml ? source : (marked.parse(source, { async: false }) as string)
+}
+
+// CIL[END chunk_id="richtexteditor_lowlight_1783883196"]
+// CIL[BEGIN chunk_id="richtexteditor_richtexteditorprops_1783883196" type="interface" identity="RichTextEditorProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define props interface for RichTextEditor component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Specify component configuration and behavior options"]
+// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" 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="RichTextEditorProps interface" errors="none" side_effects="type definition"]
+// CIL[DOC-MICRO logic_summary="Defines value, onChange, placeholder, readonly, className, minHeight props" 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. 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 interface RichTextEditorProps {
   value: string
   onChange?: (html: string) => void
@@ -37,7 +95,21 @@ interface RichTextEditorProps {
   className?: string
   minHeight?: string
 }
-
+// CIL[END chunk_id="richtexteditor_richtexteditorprops_1783883196"]
+// CIL[BEGIN chunk_id="richtexteditor_toolbarbutton_1783883196" type="function" identity="ToolbarButton" parent="none"]
+// CIL[DOC-MACRO purpose="Toolbar button component with active state styling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render styled toolbar button with active/inactive states"]
+// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX button element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Creates button with active styling, hover effects, and click handling" 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. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .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 ToolbarButton({
   onClick,
   active,
@@ -65,7 +137,21 @@ function ToolbarButton({
     </button>
   )
 }
-
+// CIL[END chunk_id="richtexteditor_toolbarbutton_1783883196"]
+// CIL[BEGIN chunk_id="richtexteditor_richtexteditor_1783883196" type="function" identity="RichTextEditor" parent="none"]
+// CIL[DOC-MACRO purpose="Main rich text editor with toolbar and content editing"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render complete rich text editor with formatting toolbar and content area"]
+// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="JSX editor component" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Creates TipTap editor with toolbar, readonly mode, content styling, and synchronization" 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. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 export function RichTextEditor({
   value,
   onChange,
@@ -74,6 +160,8 @@ export function RichTextEditor({
   className,
   minHeight = '300px',
 }: RichTextEditorProps) {
+  const htmlValue = useMemo(() => DOMPurify.sanitize(toHtml(value)), [value])
+
   const editor = useEditor({
     extensions: [
       StarterKit.configure({
@@ -82,7 +170,7 @@ export function RichTextEditor({
       CodeBlockLowlight.configure({ lowlight }),
       Placeholder.configure({ placeholder }),
     ],
-    content: value,
+    content: htmlValue,
     editable: !readonly,
     onUpdate: ({ editor }) => {
       onChange?.(editor.getHTML())
@@ -92,10 +180,10 @@ export function RichTextEditor({
   useEffect(() => {
     if (!editor) return
     const current = editor.getHTML()
-    if (current !== value) {
-      editor.commands.setContent(value || '', false)
+    if (current !== htmlValue) {
+      editor.commands.setContent(htmlValue, false)
     }
-  }, [value, editor])
+  }, [htmlValue, editor])
 
   useEffect(() => {
     if (editor) editor.setEditable(!readonly)
@@ -110,7 +198,10 @@ export function RichTextEditor({
           'prose-code:bg-muted prose-code:px-1 prose-code:rounded prose-code:text-xs prose-code:font-mono',
           className
         )}
-        dangerouslySetInnerHTML={{ __html: value || '' }}
+        // Sanitize before injecting: `value` may be rich-text HTML or legacy
+        // markdown stored in records, and must never execute scripts/handlers
+        // for readers (stored-XSS defense).
+        dangerouslySetInnerHTML={{ __html: DOMPurify.sanitize(htmlValue) }}
       />
     )
   }
@@ -208,3 +299,4 @@ export function RichTextEditor({
     </div>
   )
 }
+// CIL[END chunk_id="richtexteditor_richtexteditor_1783883196"]