spine-framework 0.3.144 → 0.4.0

package/.framework/src/hooks/useListSchema.ts

@@ -1,43 +1,55 @@
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useListSchema.ts:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/hooks/useListSchema.ts"]
+// CIL[DOC-AUDIENCE audience="frontend"]
+// CIL[DOC-CONTEXT module="useListSchema" layer="hooks" related_files=".framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React hooks, apiFetch and DesignSchema/View imports available to the module" errors="none" side_effects="none"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-MACRO purpose="React hook module for loading entity list design schemas"]
+// CIL[DOC-MICRO logic_summary="Imports useState, useEffect, apiFetch and local DesignSchema/View types" notable_decisions="[]"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the useListSchema hook and its option/result type definitions"]
+// CIL[DOC-STABILITY stability="stable"]
+
 import { useState, useEffect } from 'react'
 import { apiFetch } from '../lib/api'
 import { DesignSchema, View } from '../types/types'
+// CIL[DOC-VECTOR type="context" content="purpose='React hook module for loading entity list design schemas'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useListSchema.ts:module_header:module_header"]
 
 
 
-// CIL[BEGIN chunk_id="uselistschema_module_header_1783718716" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Define options interface for useListSchema hook"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own the UseListSchemaOptions interface definition"]
-// CIL[DOC-CONTEXT module="useListSchema" layer="frontend-hook" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple interface with entity and optional viewSlug" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useListSchema.ts:UseListSchemaOptions:interface" type="interface" identity="UseListSchemaOptions" parent="~/.framework/src/hooks/useListSchema.ts"]
+// CIL[DOC-MACRO purpose="Defines the input options for the useListSchema hook"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare entity and optional viewSlug used to resolve the list schema"]
+// CIL[DOC-CONTEXT module="useListSchema" layer="hooks" related_files=".framework/src/hooks/useListSchema.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="entity: string and viewSlug?: string" 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-hook. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .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 UseListSchemaOptions {
   entity: string
   viewSlug?: string
 }
-// CIL[END chunk_id="uselistschema_module_header_1783718716"]
-// CIL[BEGIN chunk_id="uselistschema_useresult_1783718716" type="interface" identity="UseListSchemaResult" parent="none"]
-// CIL[DOC-MACRO purpose="Define return type for useListSchema hook"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own the UseListSchemaResult interface definition"]
-// CIL[DOC-CONTEXT module="useListSchema" layer="frontend-hook" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/db.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with schema, view, loading, error, and refetch fields" 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-hook. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, .framework/functions/_shared/db.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the input options for the useListSchema hook'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useListSchema.ts:UseListSchemaOptions:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useListSchema.ts:UseListSchemaResult:interface" type="interface" identity="UseListSchemaResult" parent="~/.framework/src/hooks/useListSchema.ts"]
+// CIL[DOC-MACRO purpose="Defines the return shape of the useListSchema hook"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare schema, view, loading state, error and refetch callback"]
+// CIL[DOC-CONTEXT module="useListSchema" layer="hooks" related_files=".framework/src/hooks/useListSchema.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="schema, view, loading, error and refetch fields" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface UseListSchemaResult {
   schema: DesignSchema | null
   view: View | null
@@ -45,23 +57,22 @@ interface UseListSchemaResult {
   error: string | null
   refetch: () => void
 }
-// CIL[END chunk_id="uselistschema_useresult_1783718716"]
-// CIL[BEGIN chunk_id="uselistschema_usefunction_1783718716" type="function" identity="useListSchema" parent="none"]
-// CIL[DOC-LEARNING topic="runtime-type:generic/list_schema" content="useListSchema first tries to use a sample record's stamped design_schema and views.default_list. If the sample lacks a schema, it falls back to the types table for the current entity's type."]
-// CIL[DOC-NOTE type="design_schema_caveat" content="Falling back to the types table only works when a single type is selected. Multiple types in a list require every type to define a compatible default_list view."]
-// CIL[DOC-MACRO purpose="Resolve DesignSchema and View for list pages with fallback strategy"]
-// CIL[DOC-RESPONSIBILITY responsibility="Fetch schema with two-stage fallback and manage React state"]
-// CIL[DOC-CONTEXT module="useListSchema" layer="frontend-hook" 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/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="resolved schema and view" errors="network errors, auth errors" side_effects="React state mutations, network requests, setTimeout"]
-// CIL[DOC-MICRO logic_summary="Fetch sample record, use stamped schema or fallback to types table, handle auth retry with 300ms delay" notable_decisions="['auth_retry_delay', 'fallback_schema_for_empty_data']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-hook. Direct callers: 3. 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/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 3. Total affected: 5."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the return shape of the useListSchema hook'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useListSchema.ts:UseListSchemaResult:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useListSchema.ts:useListSchema:hook" type="hook" identity="useListSchema" parent="~/.framework/src/hooks/useListSchema.ts"]
+// CIL[DOC-CONTEXT module="useListSchema" layer="hooks" related_files=".framework/src/hooks/useListSchema.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="options: UseListSchemaOptions" outputs="UseListSchemaResult" errors="Network or API errors set the error string" side_effects="Calls apiFetch on mount and when entity/viewSlug changes; updates local state"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-MACRO purpose="React hook that loads the design schema and view definition for an entity list"]
+// CIL[DOC-MICRO logic_summary="Fetches a sample record to read stamped design_schema; falls back to type lookup and generic fallback views; supports JWT retry" notable_decisions="[]"]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch and resolve the list design schema and selected view for a given entity"]
+// CIL[DOC-STABILITY stability="stable"]
 export function useListSchema(options: UseListSchemaOptions): UseListSchemaResult {
   const { entity, viewSlug = 'default_list' } = options
   
@@ -232,4 +243,10 @@ export function useListSchema(options: UseListSchemaOptions): UseListSchemaResul
     refetch: fetchSchema
   }
 }
-// CIL[END chunk_id="uselistschema_usefunction_1783718716"]
+// CIL[DOC-VECTOR type="context" content="purpose='React hook that loads the design schema and view definition for an entity list'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useListSchema.ts:useListSchema:hook"]

package/.framework/src/hooks/useSchemaRecord.ts

@@ -1,28 +1,38 @@
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Provides React hooks and TypeScript interfaces for managing schema records and type selection in the Spine framework UI."]
+// CIL[DOC-RESPONSIBILITY responsibility="Define shared data shapes and reusable hooks for schema record editing and type selection."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Module-level header; no runtime logic." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="framework-ui"]
 import { useState, useEffect, useCallback } from 'react'
 import { apiFetch } from '../lib/api'
 import { FieldDefinition, ItemType } from '../types/types'
 
+// CIL[DOC-VECTOR type="context" content="purpose='Provides React hooks and TypeScript interfaces for managing schema records and type selection in the Spine framework UI.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:module_header:module_header"]
 
 
 
 
 
 
-// CIL[BEGIN chunk_id="uschemarecord_module_header_1783718716" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Define SchemaType interface for type records"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own the SchemaType interface definition"]
-// CIL[DOC-CONTEXT module="useSchemaRecord" layer="frontend-hook" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/db.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with id, name, slug, optional fields, and design_schema" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:schematype:interface"]
+// CIL[DOC-MACRO purpose="Describe the shape of a schema type definition."]
+// CIL[DOC-RESPONSIBILITY responsibility="Strongly type schema type metadata including design schema fields."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/hooks/useSchemaRecord.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="SchemaType interface" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Interface with optional and required fields for a type definition." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-hook. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/db.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 interface SchemaType {
   id: string
   name: string
@@ -33,21 +43,22 @@ export interface SchemaType {
   app_id?: string
   design_schema: ItemType['design_schema']
 }
-// CIL[END chunk_id="uschemarecord_module_header_1783718716"]
-// CIL[BEGIN chunk_id="uschemarecord_schemarecord_1783718716" type="interface" identity="SchemaRecord" parent="none"]
-// CIL[DOC-MACRO purpose="Define SchemaRecord interface for generic records"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own the SchemaRecord interface definition"]
-// CIL[DOC-CONTEXT module="useSchemaRecord" layer="frontend-hook" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with id, optional type_id/type, data JSONB, and index signature" 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-hook. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Describe the shape of a schema type definition.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:schematype:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:schemarecord:interface"]
+// CIL[DOC-MACRO purpose="Describe a runtime record of a schema type."]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the data container that holds record values and optional resolved type."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/hooks/useSchemaRecord.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="SchemaRecord interface" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Interface includes dynamic key index for legacy field access." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface SchemaRecord {
   id: string
   type_id?: string
@@ -55,39 +66,41 @@ export interface SchemaRecord {
   data: Record<string, any>
   [key: string]: any
 }
-// CIL[END chunk_id="uschemarecord_schemarecord_1783718716"]
-// CIL[BEGIN chunk_id="uschemarecord_options_1783718716" type="interface" identity="UseSchemaRecordOptions" parent="none"]
-// CIL[DOC-MACRO purpose="Define options interface for useSchemaRecord hook"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own the UseSchemaRecordOptions interface definition"]
-// CIL[DOC-CONTEXT module="useSchemaRecord" layer="frontend-hook" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple interface with typeApiKind field" 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-hook. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Describe a runtime record of a schema type.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:schemarecord:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:useschemarecordoptions:interface"]
+// CIL[DOC-MACRO purpose="Configure the useSchemaRecord hook."]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the required kind argument for type resolution."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/hooks/useSchemaRecord.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="UseSchemaRecordOptions interface" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Single-property options interface." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface UseSchemaRecordOptions {
   typeApiKind: string
 }
-// CIL[END chunk_id="uschemarecord_options_1783718716"]
-// CIL[BEGIN chunk_id="uschemarecord_result_1783718716" type="interface" identity="UseSchemaRecordResult" parent="none"]
-// CIL[DOC-MACRO purpose="Define return type for useSchemaRecord hook"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own the UseSchemaRecordResult interface definition"]
-// CIL[DOC-CONTEXT module="useSchemaRecord" layer="frontend-hook" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/db.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with fields array, managed data, setters, and metadata" 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-hook. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, .framework/functions/_shared/db.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Configure the useSchemaRecord hook.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:useschemarecordoptions:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:useschemarecordresult:interface"]
+// CIL[DOC-MACRO purpose="Return value shape of the useSchemaRecord hook."]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose record data, field definitions, setters, and metadata to consumers."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/hooks/useSchemaRecord.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="UseSchemaRecordResult interface" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Return object for useSchemaRecord." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface UseSchemaRecordResult {
   fields: FieldDefinition[]
   data: Record<string, any>
@@ -97,23 +110,22 @@ export interface UseSchemaRecordResult {
   loading: boolean
   error: string | null
 }
-// CIL[END chunk_id="uschemarecord_result_1783718716"]
-// CIL[BEGIN chunk_id="uschemarecord_usefunction_1783718716" type="function" identity="useSchemaRecord" parent="none"]
-// CIL[DOC-LEARNING topic="runtime-type:generic/schema_defaults" content="useSchemaRecord seeds empty record state from schemaType.design_schema.fields using each field's default value. It provides the schema used by GenericDetailPage for new records."]
-// CIL[DOC-NOTE type="design_schema_caveat" content="A field missing a default will be undefined. The hook depends on the type record being loaded from the types table, which can fail if the type slug or kind is wrong."]
-// CIL[DOC-MACRO purpose="Manage record data state with schema defaults and field definitions"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide derived state management for record data and fields"]
-// CIL[DOC-CONTEXT module="useSchemaRecord" layer="frontend-hook" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="managed data, field definitions, setters" errors="none" side_effects="React state mutations"]
-// CIL[DOC-MICRO logic_summary="Seed data from record.data with schema defaults, provide field setters, re-seed only on record/type change" notable_decisions="['reseed_on_id_change_only', 'default_value_seeding']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-hook. 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='Return value shape of the useSchemaRecord hook.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:useschemarecordresult:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:useschemarecord:function"]
+// CIL[DOC-MACRO purpose="Manage local record data state and default values from a schema type."]
+// CIL[DOC-RESPONSIBILITY responsibility="Synchronize record data with schema defaults and expose field setters."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/hooks/useSchemaRecord.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="record: SchemaRecord | null, schemaType: SchemaType | null" outputs="UseSchemaRecordResult" errors="Returns null schemaType and empty data on missing inputs" side_effects="Calls React setState during initial sync and field updates"]
+// CIL[DOC-MICRO logic_summary="Initializes data from record and applies per-field defaults from schemaType.design_schema.fields; exposes setData and setField callbacks." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function useSchemaRecord(
   record: SchemaRecord | null,
   schemaType: SchemaType | null
@@ -161,21 +173,22 @@ export function useSchemaRecord(
     error: null
   }
 }
-// CIL[END chunk_id="uschemarecord_usefunction_1783718716"]
-// CIL[BEGIN chunk_id="uschemarecord_typeselectionresult_1783718716" type="interface" identity="UseTypeSelectionResult" parent="none"]
-// CIL[DOC-MACRO purpose="Define return type for useTypeSelection hook"]
-// CIL[DOC-RESPONSIBILITY responsibility="Own the UseTypeSelectionResult interface definition"]
-// CIL[DOC-CONTEXT module="useSchemaRecord" layer="frontend-hook" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="interface definition" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Interface with types array, selected type/id, setters, and loading state" 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-hook. 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='Manage local record data state and default values from a schema type.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:useschemarecord:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:usetypeselectionresult:interface"]
+// CIL[DOC-MACRO purpose="Return value shape of the useTypeSelection hook."]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose loaded types, selected type, and selection controls."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/hooks/useSchemaRecord.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="UseTypeSelectionResult interface" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Return object for useTypeSelection." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface UseTypeSelectionResult {
   types: SchemaType[]
   selectedType: SchemaType | null
@@ -184,21 +197,22 @@ export interface UseTypeSelectionResult {
   loading: boolean
   error: string | null
 }
-// CIL[END chunk_id="uschemarecord_typeselectionresult_1783718716"]
-// CIL[BEGIN chunk_id="uschemarecord_typeselection_1783718716" type="function" identity="useTypeSelection" parent="none"]
-// CIL[DOC-MACRO purpose="Fetch and manage type selection for create flows"]
-// CIL[DOC-RESPONSIBILITY responsibility="Fetch active types by kind and manage selection state"]
-// CIL[DOC-CONTEXT module="useSchemaRecord" layer="frontend-hook" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="types array, selected type, selection state" errors="network errors" side_effects="Network requests, React state mutations"]
-// CIL[DOC-MICRO logic_summary="Fetch active types by kind on mount and kind change, manage selectedTypeId state, resolve selectedType by id" notable_decisions="['controlled_selection_state', 'fetch_on_kind_change']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-hook. 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='Return value shape of the useTypeSelection hook.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:usetypeselectionresult:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/hooks/useSchemaRecord.ts:usetypeselection:function"]
+// CIL[DOC-MACRO purpose="Load and select a schema type by kind for the current context."]
+// CIL[DOC-RESPONSIBILITY responsibility="Fetch active types from the API and maintain selection state."]
+// CIL[DOC-CONTEXT module="framework hooks" layer="ui" related_files=".framework/src/hooks/useSchemaRecord.ts,.framework/src/lib/api.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="kind: string" outputs="UseTypeSelectionResult" errors="Sets error state on API failures" side_effects="Fetches /api/types on mount and kind changes; uses React state"]
+// CIL[DOC-MICRO logic_summary="Fetches active types for a kind, tracks selected type ID, and memoizes the selected type." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function useTypeSelection(kind: string): UseTypeSelectionResult {
   const [types, setTypes] = useState<SchemaType[]>([])
   const [selectedTypeId, setSelectedTypeId] = useState('')
@@ -229,4 +243,10 @@ export function useTypeSelection(kind: string): UseTypeSelectionResult {
 
   return { types, selectedType, selectedTypeId, setSelectedTypeId, loading, error }
 }
-// CIL[END chunk_id="uschemarecord_typeselection_1783718716"]
+// CIL[DOC-VECTOR type="context" content="purpose='Load and select a schema type by kind for the current context.'; No verified external callers; imports: .framework/src/lib/api.ts,.framework/src/types/types.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/hooks/useSchemaRecord.ts:usetypeselection:function"]