spine-framework 0.3.124 → 0.3.126

package/.framework/src/components/shared/FieldRenderer.tsx

@@ -1,48 +1,35 @@
-/**
- * @module src/components/shared/FieldRenderer
- * @audience installer
- * @layer frontend-component
- * @stability stable
- *
- * Low-level field rendering primitive. Given a `FieldDefinition` and a
- * current value, renders the appropriate input widget (edit mode) or
- * display element (read-only mode).
- *
- * **Render type resolution** (`resolveRenderType`):
- * 1. If `displayType` is set (from the view config), it maps to a canonical
- *    render type first — this lets a view override how a field looks without
- *    changing the underlying `FieldDefinition`.
- * 2. Falls back to `field.data_type`.
- *
- * **Supported render types:**
- * `text`, `textarea`, `email`, `phone`, `url`, `number`, `date`,
- * `datetime`, `select`, `multiselect`, `radio`, `checkbox`, `json`,
- * `file`, `color`, `range`
- *
- * **Error display:** when `error` is set, a red helper text is shown below
- * the field and `border-red-500` is applied where applicable.
- *
- * **Label + description:** rendered above / below the input respectively,
- * with a red `*` suffix when `field.required` is true.
- *
- * @seeAlso src/components/shared/SchemaFields.tsx (mounts this component)
- * @seeAlso src/types/types.ts (FieldDefinition)
- */
 
+
+
+// CIL[BEGIN chunk_id="FieldRenderer_module_header_1783927912" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and define field renderer component interfaces"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage React imports and field renderer prop types"]
+// CIL[DOC-CONTEXT module="field-renderer" 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/components/ui/table-primitives.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules and interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, field types, and defines FieldRendererProps interface" 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/components/ui/table-primitives.tsx, .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React from 'react'
+import DOMPurify from 'dompurify'
+import { marked } from 'marked'
 import { FieldDefinition } from '../../types/types'
+import { RichTextEditor } from '../ui/RichTextEditor'
+
+function toSafeHtml(raw: string | undefined): string {
+  const source = (raw ?? '').trim()
+  if (!source) return '<p class="text-slate-400 italic">—</p>'
+  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)
+  const html = likelyHtml ? source : (marked.parse(source, { async: false }) as string)
+  return DOMPurify.sanitize(html)
+}
 
-/**
- * Props for `FieldRenderer`.
- *
- * @prop field - Full field definition including data_type, options, validation
- * @prop value - Current controlled value
- * @prop onChange - Value change callback (omit or pass `undefined` for read-only)
- * @prop onBlur - Optional blur callback for validation triggers
- * @prop readonly - If true, renders a display element instead of an input
- * @prop error - Validation error message to display below the field
- * @prop displayType - View-config widget override (e.g. `'textarea'`, `'select'`)
- */
 interface FieldRendererProps {
   field: FieldDefinition
   value: any
@@ -50,27 +37,32 @@ interface FieldRendererProps {
   onBlur?: () => void
   readonly?: boolean
   error?: string
-  displayType?: string // From view config — controls rendering without polluting field data contract
+  displayType?: string
 }
-
-/**
- * Resolves the canonical render type for a field.
- *
- * `displayType` (from view config) takes precedence over `field.data_type`
- * so view authors can choose a different widget without changing the
- * underlying schema.
- *
- * @param field - Field definition
- * @param displayType - Optional view-config widget override
- * @returns Canonical render type string (e.g. `'text'`, `'select'`, `'checkbox'`)
- */
+// CIL[END chunk_id="FieldRenderer_module_header_1783927912"]
+// CIL[BEGIN chunk_id="FieldRenderer_resolverendertype_1783927912" type="function" identity="resolveRenderType" parent="none"]
+// CIL[DOC-LEARNING topic="runtime-type:generic/field_rendering" content="FieldRenderer maps field.data_type or display_type to a widget: text, textarea, email, phone, url, number, date, datetime, checkbox, select, multiselect, radio, color, file, json. display_type overrides data_type when provided."]
+// CIL[DOC-NOTE type="design_schema_caveat" content="Unknown data_type or display_type silently falls back to text. Select/multiselect fields must define options or the user sees an empty control."]
+// CIL[DOC-MACRO purpose="Resolve canonical render type from field definition and display type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Map display types and data types to render types"]
+// CIL[DOC-CONTEXT module="field-renderer" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Render type string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Display type overrides data type, maps to canonical render types" 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: .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/migrations/025_retype_threads_messages.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function resolveRenderType(field: FieldDefinition, displayType?: string): string {
-  // displayType from view config overrides data_type for rendering decisions
   if (displayType) {
     switch (displayType) {
       case 'textarea':
-      case 'rich_text':
         return 'textarea'
+      case 'rich_text':
+        return 'rich_text'
       case 'select':
         return 'select'
       case 'multiselect':
@@ -93,11 +85,11 @@ function resolveRenderType(field: FieldDefinition, displayType?: string): string
         return 'file'
     }
   }
-  // Fall back to data_type
   switch (field.data_type) {
     case 'textarea':
-    case 'rich_text':
       return 'textarea'
+    case 'rich_text':
+      return 'rich_text'
     case 'email':
       return 'email'
     case 'phone':
@@ -132,14 +124,21 @@ function resolveRenderType(field: FieldDefinition, displayType?: string): string
       return 'text'
   }
 }
-
-/**
- * Renders a single schema field as an input widget or read-only display.
- *
- * @param props - `FieldRendererProps`
- * @returns Label + field widget + description + error message
- * @sideEffects none (delegates changes to `onChange`)
- */
+// CIL[END chunk_id="FieldRenderer_resolverendertype_1783927912"]
+// CIL[BEGIN chunk_id="FieldRenderer_fieldrenderer_1783927912" type="function" identity="FieldRenderer" parent="none"]
+// CIL[DOC-MACRO purpose="Render appropriate input widget or display element for field type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display field as editable input or read-only value based on type"]
+// CIL[DOC-CONTEXT module="field-renderer" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/migrations/025_retype_threads_messages.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Rendered field widget" errors="none" side_effects="Renders UI, calls onChange"]
+// CIL[DOC-MICRO logic_summary="Switches on render type to return appropriate input or display 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: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/migrations/025_retype_threads_messages.sql, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 export function FieldRenderer({ field, value, onChange, readonly = false, error, displayType }: FieldRendererProps) {
   const renderType = resolveRenderType(field, displayType)
 
@@ -160,6 +159,24 @@ export function FieldRenderer({ field, value, onChange, readonly = false, error,
           />
         )
 
+      case 'rich_text':
+        return readonly ? (
+          <div
+            className={`prose prose-sm dark:prose-invert max-w-none ${error ? 'border-red-500' : ''}`}
+            // 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: toSafeHtml(value) }}
+          />
+        ) : (
+          <RichTextEditor
+            value={value || ''}
+            onChange={onChange}
+            placeholder={field.placeholder}
+            minHeight="200px"
+          />
+        )
+
       case 'textarea':
         return readonly ? (
           <div className={`text-slate-900 whitespace-pre-wrap ${error ? 'border-red-500' : ''}`}>
@@ -355,7 +372,6 @@ export function FieldRenderer({ field, value, onChange, readonly = false, error,
               try {
                 onChange?.(JSON.parse(e.target.value))
               } catch {
-                // Invalid JSON, don't update
               }
             }}
             className={`textarea font-mono text-sm ${error ? 'border-red-500' : ''}`}
@@ -476,3 +492,4 @@ export function FieldRenderer({ field, value, onChange, readonly = false, error,
     </div>
   )
 }
+// CIL[END chunk_id="FieldRenderer_fieldrenderer_1783927912"]

package/.framework/src/components/shared/InviteManager.tsx

@@ -1,36 +1,28 @@
-/**
- * @module src/components/shared/InviteManager
- * @audience installer
- * @layer frontend-component
- * @stability stable
- *
- * Reusable invite and access-request management UI.
- * Consumed by Cortex TeamPage, Portal TeamPage, and the Admin InvitesPage.
- *
- * Layout:
- *   [ Name input ]  [ Email input ]  [ Role picker ]  [ Generate Link button ]
- *   ─────────────────────────────────────────────────────────────────────────
- *   Searchable/sortable invite list table with status + actions
- *
- * @prop accountId       - Scope invites to this account UUID.
- *                         Omit (system_admin only) to show all accounts.
- * @prop allowedRoles    - Roles the admin may assign. First entry is the default.
- *                         If only one entry, no picker is shown.
- * @prop roleSlugsFilter - Comma-separated role slugs to pass to list-invites.
- *                         Limits which people appear in the list.
- * @prop scope           - 'account' = scoped to one account | 'system' = all accounts
- *
- * @seeAlso functions/invites.ts  (API)
- * @seeAlso pages/admin/InvitesPage.tsx
- * @seeAlso custom/apps/cortex/pages/team/TeamPage.tsx
- * @seeAlso custom/apps/portal/pages/team/TeamPage.tsx
- */
 
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="InviteManager_module_header_1783927912" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import dependencies and define invite management component interfaces"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage React imports and invite component prop types"]
+// CIL[DOC-CONTEXT module="invite-manager" 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/components/ui/table-primitives.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules and interfaces" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React hooks and API, defines invite-related types and interfaces" 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/components/ui/table-primitives.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React, { useState, useEffect, useCallback, useMemo } from 'react'
 import { apiFetch } from '../../lib/api'
 
-// ─── TYPES ────────────────────────────────────────────────────────────────────
-
 export type InviteScope = 'account' | 'system'
 
 export interface AllowedRole {
@@ -41,7 +33,7 @@ export interface AllowedRole {
 export interface InviteManagerProps {
   accountId?: string
   allowedRoles: AllowedRole[]
-  roleSlugsFilter?: string        // comma-separated, passed to list-invites
+  roleSlugsFilter?: string
   scope: InviteScope
 }
 
@@ -57,9 +49,21 @@ interface InviteRow {
   account: { id: string; slug: string; display_name: string } | null
   role: { id: string; slug: string; name: string } | null
 }
-
-// ─── HELPERS ──────────────────────────────────────────────────────────────────
-
+// CIL[END chunk_id="InviteManager_module_header_1783927912"]
+// CIL[BEGIN chunk_id="InviteManager_callinvitesapi_1783927912" type="function" identity="callInvitesApi" parent="none"]
+// CIL[DOC-MACRO purpose="Make API calls to invites endpoint with proper method handling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Handle GET/POST requests to invites API functions"]
+// CIL[DOC-CONTEXT module="invite-manager" layer="frontend-component" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="API response JSON" errors="API errors" side_effects="Network requests"]
+// CIL[DOC-MICRO logic_summary="Builds query strings for GET, sends JSON for POST to invites endpoint" 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/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/table-primitives.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"]
 async function callInvitesApi(action: string, params: Record<string, any> = {}, method: 'GET' | 'POST' = 'GET') {
   const base = '/.netlify/functions/invites'
   if (method === 'GET') {
@@ -74,7 +78,21 @@ async function callInvitesApi(action: string, params: Record<string, any> = {},
   })
   return res.json()
 }
-
+// CIL[END chunk_id="InviteManager_callinvitesapi_1783927912"]
+// CIL[BEGIN chunk_id="InviteManager_derivedisplaystatus_1783927912" type="function" identity="deriveDisplayStatus" parent="none"]
+// CIL[DOC-MACRO purpose="Convert invite status to human-readable display text"]
+// CIL[DOC-RESPONSIBILITY responsibility="Map internal status codes to user-friendly labels"]
+// CIL[DOC-CONTEXT module="invite-manager" layer="frontend-component" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Display status string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Handles special cases like expiration, blocking, and invite vs access request" 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: .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.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"]
 function deriveDisplayStatus(row: InviteRow): string {
   if (row.blocked_at) return 'blocked'
   if (row.status === 'inactive') return 'revoked'
@@ -87,7 +105,21 @@ function deriveDisplayStatus(row: InviteRow): string {
   }
   return row.status
 }
-
+// CIL[END chunk_id="InviteManager_derivedisplaystatus_1783927912"]
+// CIL[BEGIN chunk_id="InviteManager_statusclasses_1783927912" type="constant" identity="STATUS_CLASSES" parent="none"]
+// CIL[DOC-MACRO purpose="Define CSS classes for different invite status colors"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide styling mappings for status badge components"]
+// CIL[DOC-CONTEXT module="invite-manager" layer="frontend-component" related_files="[\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CSS class mapping object" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps status strings to Tailwind color classes for consistent styling" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 const STATUS_CLASSES: Record<string, string> = {
   pending:            'bg-yellow-100 text-yellow-800',
   'pending approval': 'bg-blue-100 text-blue-800',
@@ -97,7 +129,21 @@ const STATUS_CLASSES: Record<string, string> = {
   blocked:            'bg-red-100 text-red-800',
   revoked:            'bg-slate-100 text-slate-500',
 }
-
+// CIL[END chunk_id="InviteManager_statusclasses_1783927912"]
+// CIL[BEGIN chunk_id="InviteManager_timeuntil_1783927912" type="function" identity="timeUntil" parent="none"]
+// CIL[DOC-MACRO purpose="Calculate human-readable time until expiration from ISO date"]
+// CIL[DOC-RESPONSIBILITY responsibility="Format time remaining as days or hours until expiry"]
+// CIL[DOC-CONTEXT module="invite-manager" layer="frontend-component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Time remaining string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes time difference, returns days/hours or 'expired' if past" 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: .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function timeUntil(iso: string | null): string {
   if (!iso) return '—'
   const diff = new Date(iso).getTime() - Date.now()
@@ -107,9 +153,21 @@ function timeUntil(iso: string | null): string {
   if (days > 0) return `${days}d`
   return `${hours}h`
 }
-
-// ─── COMPONENT ────────────────────────────────────────────────────────────────
-
+// CIL[END chunk_id="InviteManager_timeuntil_1783927912"]
+// CIL[BEGIN chunk_id="InviteManager_invitemanager_1783927912" type="function" identity="InviteManager" parent="none"]
+// CIL[DOC-MACRO purpose="Manage invite creation, listing, and actions with searchable table UI"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide complete invite management interface with form and table"]
+// CIL[DOC-CONTEXT module="invite-manager" layer="frontend-component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Invite management UI" errors="API errors" side_effects="Renders UI, API calls"]
+// CIL[DOC-MICRO logic_summary="Handles invite generation, listing, searching, sorting, and bulk actions" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope }: InviteManagerProps) {
   const [invites, setInvites] = useState<InviteRow[]>([])
   const [loading, setLoading] = useState(true)
@@ -122,19 +180,15 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
   const [generateError, setGenerateError] = useState('')
   const [copiedId, setCopiedId] = useState<string | null>(null)
 
-  // Search / sort state
   const [search, setSearch] = useState('')
   const [sortKey, setSortKey] = useState<'full_name' | 'email' | 'status' | 'created_at'>('created_at')
   const [sortDir, setSortDir] = useState<'asc' | 'desc'>('desc')
-
-  // Keep selectedRoleSlug in sync if allowedRoles changes
   useEffect(() => {
     if (!allowedRoles.find(r => r.slug === selectedRoleSlug)) {
       setSelectedRoleSlug(allowedRoles[0]?.slug ?? '')
     }
   }, [allowedRoles, selectedRoleSlug])
 
-  // ── Load invites ──────────────────────────────────────────────────────────
   const loadInvites = useCallback(async () => {
     setLoading(true)
     setError('')
@@ -153,7 +207,6 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
 
   useEffect(() => { loadInvites() }, [loadInvites])
 
-  // ── Filtered + sorted list ─────────────────────────────────────────────────
   const filteredInvites = useMemo(() => {
     const q = search.toLowerCase()
     const filtered = q
@@ -185,7 +238,6 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
     }
   }
 
-  // ── Generate invite ────────────────────────────────────────────────────────
   const handleGenerate = async (e: React.FormEvent) => {
     e.preventDefault()
     if (!newEmail.trim() || !accountId) return
@@ -208,7 +260,6 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
       return
     }
 
-    // Copy URL to clipboard automatically
     if (result.data?.invite_url) {
       navigator.clipboard.writeText(result.data.invite_url).catch(() => {})
     }
@@ -218,7 +269,6 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
     await loadInvites()
   }
 
-  // ── Reinvite (issues new token, copies URL) ────────────────────────────────
   const handleReinvite = async (personId: string) => {
     const result = await callInvitesApi('reinvite', {
       person_id: personId,
@@ -236,7 +286,6 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
     }
   }
 
-  // ── Generic action (revoke, approve, deny, block) ─────────────────────────
   const handleAction = async (action: string, personId: string) => {
     const result = await callInvitesApi(action, { person_id: personId }, 'POST')
     if (result.error) {
@@ -246,7 +295,6 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
     }
   }
 
-  // ── Render ─────────────────────────────────────────────────────────────────
   const canGenerate = !!accountId || scope === 'system'
   const showRolePicker = allowedRoles.length > 1
 
@@ -508,9 +556,21 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
     </div>
   )
 }
-
-// ─── SORT HEADER ──────────────────────────────────────────────────────────────
-
+// CIL[END chunk_id="InviteManager_invitemanager_1783927912"]
+// CIL[BEGIN chunk_id="InviteManager_sortth_1783927912" type="function" identity="SortTh" parent="none"]
+// CIL[DOC-MACRO purpose="Render sortable table header with sort direction indicator"]
+// CIL[DOC-RESPONSIBILITY responsibility="Create clickable table header with visual sort state"]
+// CIL[DOC-CONTEXT module="invite-manager" layer="frontend-component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Table header element" errors="none" side_effects="Renders UI, calls onSort"]
+// CIL[DOC-MICRO logic_summary="Shows sort arrows and handles click events for column sorting" 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: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SortTh({
   label, col, current, dir, onSort
 }: {
@@ -531,3 +591,4 @@ function SortTh({
     </th>
   )
 }
+// CIL[END chunk_id="InviteManager_sortth_1783927912"]