spine-framework 0.3.145 → 0.4.0

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

@@ -1,34 +1,74 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/shared/InviteManager.tsx"]
+// CIL[DOC-MACRO purpose="Provide shared InviteManager React component and related type definitions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React hooks, utility API client, and declare exported types for invite management"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="InviteManager component, InviteScope, AllowedRole, InviteManagerProps, InviteRow, and helper functions" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Import React hooks and apiFetch, then define types and the InviteManager component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="framework-developers,ui-developers"]
 
 
+import React, { useState, useEffect, useCallback, useMemo } from 'react'
+import { apiFetch } from '../../lib/api'
+// CIL[DOC-VECTOR type="context" content="purpose='Provide shared InviteManager React component and related type definitions'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:module_header:module_header"]
 
 
-
-
-
-// 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[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:invitescope:type" type="type" identity="invitescope" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Define the possible scopes for an invite"]
+// CIL[DOC-RESPONSIBILITY responsibility="Constrain invite scope to account or system"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="InviteScope union type" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Export a string-literal union for invite scope values" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/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."]
+
+export type InviteScope = 'account' | 'system'
+// CIL[DOC-VECTOR type="context" content="purpose='Define the possible scopes for an invite'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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"]
-import React, { useState, useEffect, useCallback, useMemo } from 'react'
-import { apiFetch } from '../../lib/api'
+// CIL[END stable_id="~/.framework/src/components/shared/InviteManager.tsx:invitescope:type"]
 
-export type InviteScope = 'account' | 'system'
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:allowedrole:interface" type="interface" identity="allowedrole" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Describe an allowed role selection entry"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the slug and display name of a role that can be assigned in an invite"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="AllowedRole interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declare an object with role slug and human-readable name" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 export interface AllowedRole {
   slug: string
   name: string
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Describe an allowed role selection entry'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:allowedrole:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:InviteManagerProps:interface" type="interface" identity="InviteManagerProps" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Define props consumed by the InviteManager component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type check the account id, allowed roles, optional role filter, and scope passed to InviteManager"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="props object" outputs="InviteManagerProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declare optional accountId, allowedRoles array, optional roleSlugsFilter, and scope" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 export interface InviteManagerProps {
   accountId?: string
@@ -36,6 +76,23 @@ export interface InviteManagerProps {
   roleSlugsFilter?: string
   scope: InviteScope
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Define props consumed by the InviteManager component'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:InviteManagerProps:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:InviteRow:interface" type="interface" identity="InviteRow" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Describe the shape of an invite or access request record"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the fields returned from the invites API including status, expiration, blocking, and related account and role"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="InviteRow interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declare all fields for a single invite row with their statuses and timestamps" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 interface InviteRow {
   id: string
@@ -49,21 +106,23 @@ interface InviteRow {
   account: { id: string; slug: string; display_name: string } | null
   role: { id: string; slug: string; name: string } | null
 }
-// 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="context" content="purpose='Describe the shape of an invite or access request record'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:InviteRow:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:callInvitesApi:function" type="function" identity="callInvitesApi" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Call the Netlify invites function endpoint"]
+// CIL[DOC-RESPONSIBILITY responsibility="Build GET or POST requests to the /.netlify/functions/invites endpoint and return JSON"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="action: string, params: Record<string, any>, method: GET | POST" outputs="JSON response body from apiFetch" errors="throws if fetch fails" side_effects="makes HTTP request to invites function"]
+// CIL[DOC-MICRO logic_summary="Serialize parameters to query string for GET or JSON body for POST and await apiFetch" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 async function callInvitesApi(action: string, params: Record<string, any> = {}, method: 'GET' | 'POST' = 'GET') {
   const base = '/.netlify/functions/invites'
   if (method === 'GET') {
@@ -78,21 +137,23 @@ 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="context" content="purpose='Call the Netlify invites function endpoint'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:callInvitesApi:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:deriveDisplayStatus:function" type="function" identity="deriveDisplayStatus" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Map an InviteRow status to a human-readable display status"]
+// CIL[DOC-RESPONSIBILITY responsibility="Interpret blocked, inactive, active, pending, and invited states to produce a UI label"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="row: InviteRow" outputs="human-readable status string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Check blocked_at first, then status and kind, then expiration for invited rows" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function deriveDisplayStatus(row: InviteRow): string {
   if (row.blocked_at) return 'blocked'
   if (row.status === 'inactive') return 'revoked'
@@ -105,21 +166,24 @@ 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="context" content="purpose='Map an InviteRow status to a human-readable display status'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:deriveDisplayStatus:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:status_classes:constant" type="constant" identity="status_classes" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Provide Tailwind color classes for display status badges"]
+// CIL[DOC-RESPONSIBILITY responsibility="Map each display status label to a background and text color class string"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="STATUS_CLASSES record" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Define a Record from display status strings to Tailwind utility classes" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 const STATUS_CLASSES: Record<string, string> = {
   pending:            'bg-yellow-100 text-yellow-800',
   'pending approval': 'bg-blue-100 text-blue-800',
@@ -129,21 +193,25 @@ 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="context" content="purpose='Provide Tailwind color classes for display status badges'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:status_classes:constant"]
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:timeUntil:function" type="function" identity="timeUntil" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Format the remaining time until an ISO expiration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Convert an ISO timestamp into days or hours remaining, or a dash if missing"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="iso: string | null" outputs="formatted remaining time string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Compute difference between target and now, returning days, hours, expired, or em dash" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function timeUntil(iso: string | null): string {
   if (!iso) return '—'
   const diff = new Date(iso).getTime() - Date.now()
@@ -153,21 +221,23 @@ function timeUntil(iso: string | null): string {
   if (days > 0) return `${days}d`
   return `${hours}h`
 }
-// 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="context" content="purpose='Format the remaining time until an ISO expiration'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:timeUntil:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:InviteManager:component" type="component" identity="InviteManager" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render an invite management UI for generating and administering invites"]
+// CIL[DOC-RESPONSIBILITY responsibility="Load, search, sort, generate, reinvite, and approve or deny invites in account or system scope"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="accountId, allowedRoles, roleSlugsFilter, scope" outputs="JSX invite list and generation form" errors="sets error state on API failures" side_effects="calls invites API, reads clipboard, updates local state and reloads list"]
+// CIL[DOC-MICRO logic_summary="Maintain invite list, form state, search and sort, handle create, reinvite, approve and deny actions, and render a table of rows with status badges and action buttons" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope }: InviteManagerProps) {
   const [invites, setInvites] = useState<InviteRow[]>([])
   const [loading, setLoading] = useState(true)
@@ -428,15 +498,39 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
             </thead>
             <tbody className="divide-y divide-slate-100">
               {filteredInvites.map(row => {
+
+
                 const displayStatus = deriveDisplayStatus(row)
+
+
+
                 const isPending   = row.status === 'invited' && !row.blocked_at && !(row.expires_at && new Date(row.expires_at) < new Date())
+
+
+
                 const isExpired   = displayStatus === 'expired'
+
+
+
                 const isBlocked   = displayStatus === 'blocked'
+
+
+
                 const isRevoked   = displayStatus === 'revoked'
+
+
+
                 const isClaimed   = displayStatus === 'claimed'
+
+
+
                 const isApproved  = displayStatus === 'approved'
+
+
+
                 const isAccessReq = row.status === 'pending' && row.kind === 'access_request'
 
+
                 return (
                   <tr key={row.id} className="hover:bg-slate-50">
                     <td className="px-4 py-3 text-sm text-slate-900">{row.full_name || '—'}</td>
@@ -556,21 +650,31 @@ export function InviteManager({ accountId, allowedRoles, roleSlugsFilter, scope
     </div>
   )
 }
-// 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="context" content="purpose='Render an invite management UI for generating and administering invites'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:InviteManager:component"]
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/InviteManager.tsx:SortTh:component" type="component" identity="SortTh" parent="~/.framework/src/components/shared/InviteManager.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a clickable table header for sorting"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a column label with ascending, descending, or both indicator and trigger sort callback on click"]
+// CIL[DOC-CONTEXT module="components/shared" layer="ui" related_files=".framework/src/components/shared/InviteManager.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="label, col, current, dir, onSort" outputs="th element with sort arrow" errors="none" side_effects="calls onSort with the selected column"]
+// CIL[DOC-MICRO logic_summary="Show an up, down, or bidirectional arrow based on active state and direction" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function SortTh({
   label, col, current, dir, onSort
 }: {
@@ -591,4 +695,10 @@ function SortTh({
     </th>
   )
 }
-// CIL[END chunk_id="InviteManager_sortth_1783927912"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a clickable table header for sorting'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/InviteManager.tsx:SortTh:component"]

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

@@ -1,11 +1,53 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/MemberList.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/shared/MemberList.tsx"]
+// CIL[DOC-MACRO purpose="MemberList shared component module"]
+// CIL[DOC-RESPONSIBILITY responsibility="Imports React hooks and the shared apiFetch client for the MemberList component."]
+// CIL[DOC-CONTEXT module="shared" layer="ui" related_files=".framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Sets up the MemberList module by importing React hooks and the shared apiFetch utility." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="shared-ui"]
+
 import React, { useState, useEffect, useCallback, useMemo } from 'react'
 import { apiFetch } from '../../lib/api'
 
+// CIL[DOC-VECTOR type="context" content="purpose='MemberList shared component module'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/MemberList.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/MemberList.tsx:allowedrole:interface" type="interface" identity="allowedrole" parent="~/.framework/src/components/shared/MemberList.tsx"]
+// CIL[DOC-MACRO purpose="AllowedRole interface definition"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the shape of a selectable role for members."]
+// CIL[DOC-CONTEXT module="shared" layer="ui" related_files=".framework/src/components/shared/MemberList.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="AllowedRole object" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares slug and name properties for an allowed role." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface AllowedRole {
   slug: string
   name: string
 }
+// CIL[DOC-VECTOR type="context" content="purpose='AllowedRole interface definition'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/MemberList.tsx:allowedrole:interface"]
+
 
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/MemberList.tsx:member:interface" type="interface" identity="member" parent="~/.framework/src/components/shared/MemberList.tsx"]
+// CIL[DOC-MACRO purpose="Member interface definition"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the shape of a member row returned by the invites API."]
+// CIL[DOC-CONTEXT module="shared" layer="ui" related_files=".framework/src/components/shared/MemberList.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Member object" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares id, full_name, email, status, nested role, and is_active fields for a member." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface Member {
   id: string
   full_name: string | null
@@ -14,7 +56,23 @@ interface Member {
   role: { id: string; slug: string; name: string } | null
   is_active: boolean
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Member interface definition'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/MemberList.tsx:member:interface"]
 
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/MemberList.tsx:callinvitesapi:function" type="function" identity="callinvitesapi" parent="~/.framework/src/components/shared/MemberList.tsx"]
+// CIL[DOC-MACRO purpose="Call invites API helper"]
+// CIL[DOC-RESPONSIBILITY responsibility="Sends GET or POST requests to the Netlify invites function endpoint."]
+// CIL[DOC-CONTEXT module="shared" layer="ui" related_files=".framework/src/components/shared/MemberList.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="action: string, params: Record<string, any>, method: 'GET' | 'POST'" outputs="JSON response" errors="throws on network or invalid response" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Builds a query string for GET requests and a JSON body for POST requests, then fetches via apiFetch." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 async function callInvitesApi(action: string, params: Record<string, any> = {}, method: 'GET' | 'POST' = 'GET') {
   const base = '/.netlify/functions/invites'
   if (method === 'GET') {
@@ -29,12 +87,44 @@ async function callInvitesApi(action: string, params: Record<string, any> = {},
   })
   return res.json()
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Call invites API helper'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/MemberList.tsx:callinvitesapi:function"]
+
 
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/MemberList.tsx:memberlistprops:interface" type="interface" identity="memberlistprops" parent="~/.framework/src/components/shared/MemberList.tsx"]
+// CIL[DOC-MACRO purpose="MemberListProps interface definition"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the props accepted by the MemberList component."]
+// CIL[DOC-CONTEXT module="shared" layer="ui" related_files=".framework/src/components/shared/MemberList.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="MemberListProps object" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares optional accountId and required allowedRoles props for MemberList." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface MemberListProps {
   accountId?: string
   allowedRoles: AllowedRole[]
 }
+// CIL[DOC-VECTOR type="context" content="purpose='MemberListProps interface definition'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/MemberList.tsx:memberlistprops:interface"]
+
 
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/MemberList.tsx:memberlist:function" type="function" identity="memberlist" parent="~/.framework/src/components/shared/MemberList.tsx"]
+// CIL[DOC-MACRO purpose="MemberList React component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Renders a searchable, role-editable table of active account members."]
+// CIL[DOC-CONTEXT module="shared" layer="ui" related_files=".framework/src/components/shared/MemberList.tsx,.framework/src/lib/api.ts"]
+// CIL[DOC-CONTRACT inputs="accountId: string | undefined, allowedRoles: AllowedRole[]" outputs="JSX table of active members" errors="displays API errors inline" side_effects="calls invites API on load and role/deactivate actions"]
+// CIL[DOC-MICRO logic_summary="Loads active members, filters by search string, renders role selects and action buttons, and supports updating or deactivating members." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function MemberList({ accountId, allowedRoles }: MemberListProps) {
   const [members, setMembers] = useState<Member[]>([])
   const [loading, setLoading] = useState(true)
@@ -180,3 +270,10 @@ export function MemberList({ accountId, allowedRoles }: MemberListProps) {
     </div>
   )
 }
+// CIL[DOC-VECTOR type="context" content="purpose='MemberList React component'; No verified external callers; imports: .framework/src/lib/api.ts"]
+// 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/shared/MemberList.tsx:memberlist:function"]