spine-framework 0.3.145 → 0.4.0

package/.framework/src/types/types.ts

@@ -1,18 +1,14 @@
-
-// CIL[BEGIN chunk_id="types_fielddefinition_1783637731" type="interface" identity="FieldDefinition" parent="none"]
-// CIL[DOC-MACRO purpose="Define a single field in a design schema that drives UI rendering and client-side validation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent field specifications including data type, validation rules, and role-based permissions"]
-// CIL[DOC-CONTEXT module="src/types/types" layer="frontend-hook" related_files="[\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Represent field specifications including data type, validation rules, and role-based permissions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:FieldDefinition:interface" type="interface" identity="FieldDefinition" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines the shape and validation rules for a single design schema field."]
+// CIL[DOC-RESPONSIBILITY responsibility="Describes data types, labels, constraints, options, and permissions for a field."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="FieldDefinition interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports FieldDefinition with all possible field-level configuration properties." notable_decisions="Options may be strings or labeled objects; permissions are keyed by role."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+
+
+
 
 
 
@@ -60,26 +56,27 @@ export interface FieldDefinition {
     [role: string]: string[] 
   }
 }
-// CIL[END chunk_id="types_fielddefinition_1783637731"]
-// CIL[BEGIN chunk_id="types_viewfieldconfig_1783637731" type="interface" identity="ViewFieldConfig" parent="none"]
-// CIL[DOC-MACRO purpose="Define per-field display/behaviour config within a view for UI rendering"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent view-specific field overrides including widget type and interaction flags"]
-// CIL[DOC-CONTEXT module="src/types/types" layer="frontend-hook" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Represent view-specific field overrides including widget type and interaction flags" 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/principal.ts, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.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="context" content="purpose='Defines the shape and validation rules for a single design schema field.'; No verified external callers; imports: none"]
+// 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/types/types.ts:FieldDefinition:interface"]
 
 
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:ViewFieldConfig:interface" type="interface" identity="ViewFieldConfig" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines how a field is displayed and behaves in a list or detail view."]
+// CIL[DOC-RESPONSIBILITY responsibility="Specifies display type, sortability, and searchability for view columns."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ViewFieldConfig interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports ViewFieldConfig used in list/detail view field maps." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface ViewFieldConfig {
   display_type: 'input' | 'textarea' | 'rich_text' | 'select' | 'multiselect' | 
                  'radio' | 'checkbox' | 'switch' | 'date_picker' | 'datetime_picker' | 
@@ -89,24 +86,25 @@ export interface ViewFieldConfig {
   sortable?: boolean
   searchable?: boolean
 }
-// CIL[END chunk_id="types_viewfieldconfig_1783637731"]
-// CIL[BEGIN chunk_id="types_listview_1783637731" type="interface" identity="ListView" parent="none"]
-// CIL[DOC-MACRO purpose="Define a list view configuration for rendering data as table, card grid, or Kanban board"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent list display settings including fields, sorting, filters, stats, and grouping"]
-// CIL[DOC-CONTEXT module="src/types/types" layer="frontend-hook" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Represent list display settings including fields, sorting, filters, stats, and grouping" 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: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines how a field is displayed and behaves in a list or detail view.'; No verified external callers; imports: none"]
+// 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/types/types.ts:ViewFieldConfig:interface"]
+
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:ListView:interface" type="interface" identity="ListView" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a list view configuration for a type."]
+// CIL[DOC-RESPONSIBILITY responsibility="Describes table/card/board list fields, filters, stats, sorting, and grouping."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ListView interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports ListView with fields as a record of ViewFieldConfig." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface ListView {
   type: 'list'
   display: 'table' | 'card' | 'board'
@@ -126,91 +124,95 @@ export interface ListView {
   }>
   group_by?: string 
 }
-// CIL[END chunk_id="types_listview_1783637731"]
-// CIL[BEGIN chunk_id="types_detailviewsection_1783637731" type="interface" identity="DetailViewSection" parent="none"]
-// CIL[DOC-MACRO purpose="Define a single section within a DetailView that groups related fields"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent logical groupings of fields with optional titles for detail forms"]
-// CIL[DOC-CONTEXT module="src/types/types" layer="frontend-hook" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Represent logical groupings of fields with optional titles for detail forms" 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/IntegrationsPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, .framework/src/components/ui/table-primitives.tsx, .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='Defines a list view configuration for a type.'; No verified external callers; imports: none"]
+// 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/types/types.ts:ListView:interface"]
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:DetailViewSection:interface" type="interface" identity="DetailViewSection" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a section within a detail view."]
+// CIL[DOC-RESPONSIBILITY responsibility="Groups fields into titled sections for detail UIs."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="DetailViewSection interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports DetailViewSection as a title and field map." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface DetailViewSection {
   title: string
   fields: Record<string, ViewFieldConfig>
   
 }
-// CIL[END chunk_id="types_detailviewsection_1783637731"]
-// CIL[BEGIN chunk_id="types_detailview_1783637731" type="interface" identity="DetailView" parent="none"]
-// CIL[DOC-MACRO purpose="Define a detail view configuration for rendering sectioned record forms"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent detail form layout with multiple field sections"]
-// CIL[DOC-CONTEXT module="src/types/types" layer="frontend-hook" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Represent detail form layout with multiple field sections" 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/principal.ts, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.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='Defines a section within a detail view.'; No verified external callers; imports: none"]
+// 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/types/types.ts:DetailViewSection:interface"]
+
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:DetailView:interface" type="interface" identity="DetailView" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a detail view configuration for a type."]
+// CIL[DOC-RESPONSIBILITY responsibility="Aggregates DetailViewSection entries into a single detail page layout."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="DetailView interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports DetailView with type 'detail' and an ordered sections array." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface DetailView {
   type: 'detail'
   label: string
   sections: DetailViewSection[]
 }
-// CIL[END chunk_id="types_detailview_1783637731"]
-// CIL[BEGIN chunk_id="types_view_1783637731" type="type" identity="View" parent="none"]
-// CIL[DOC-MACRO purpose="Define discriminated union of all supported view types for schema-driven UI"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent all possible view configurations (list and detail)"]
-// CIL[DOC-CONTEXT module="View" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements View" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines a detail view configuration for a type.'; No verified external callers; imports: none"]
+// 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/types/types.ts:DetailView:interface"]
 
 
 
-export type View = ListView | DetailView
-// CIL[END chunk_id="types_view_1783637731"]
-// CIL[BEGIN chunk_id="types_functionalitybindings_1783637731" type="interface" identity="FunctionalityBindings" parent="none"]
-// CIL[DOC-MACRO purpose="Define optional automation and integration bindings attached to a DesignSchema"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent trigger conditions and targets for pipelines, AI agents, embeddings, integrations, and constraints"]
-// CIL[DOC-CONTEXT module="FunctionalityBindings" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements FunctionalityBindings" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:View:type" type="type" identity="View" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Union of supported view kinds for a design schema."]
+// CIL[DOC-RESPONSIBILITY responsibility="Distinguishes list and detail views for type rendering."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="View type definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports View as ListView | DetailView." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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."]
+export type View = ListView | DetailView
+// CIL[DOC-VECTOR type="context" content="purpose='Union of supported view kinds for a design schema.'; No verified external callers; imports: none"]
+// 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/types/types.ts:View:type"]
+
 
 
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:FunctionalityBindings:interface" type="interface" identity="FunctionalityBindings" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines automation, AI, embedding, integration, and constraint bindings."]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares pipeline, agent, embedding, integration, and constraint arrays."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="FunctionalityBindings interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports FunctionalityBindings for optional schema functionality." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface FunctionalityBindings {
   pipelines?: Array<{
     pipeline_id: string
@@ -251,26 +253,27 @@ export interface FunctionalityBindings {
     after?: 'create' | 'update' 
   }>
 }
-// CIL[END chunk_id="types_functionalitybindings_1783637731"]
-// CIL[BEGIN chunk_id="types_designschema_1783637731" type="interface" identity="DesignSchema" parent="none"]
-// CIL[DOC-MACRO purpose="Define the complete design schema for a types record stored as JSONB in the database"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent the full schema definition including fields, views, permissions, and functionality bindings"]
-// CIL[DOC-CONTEXT module="DesignSchema" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements DesignSchema" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines automation, AI, embedding, integration, and constraint bindings.'; No verified external callers; imports: none"]
+// 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/types/types.ts:FunctionalityBindings:interface"]
 
 
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:DesignSchema:interface" type="interface" identity="DesignSchema" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines the complete design schema for an item type."]
+// CIL[DOC-RESPONSIBILITY responsibility="Holds record permissions, field definitions, views, and functionality bindings."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="DesignSchema interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports DesignSchema used by item type definitions." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface DesignSchema {
   record_permissions: {
     [role: string]: string[] 
@@ -279,26 +282,27 @@ export interface DesignSchema {
   views: Record<string, View>
   functionality?: FunctionalityBindings
 }
-// CIL[END chunk_id="types_designschema_1783637731"]
-// CIL[BEGIN chunk_id="types_itemtype_1783637731" type="interface" identity="ItemType" parent="none"]
-// CIL[DOC-MACRO purpose="Define a type record from the v2.types table with complete schema and validation configuration"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent a configurable data type with design schema, validation rules, and metadata"]
-// CIL[DOC-CONTEXT module="ItemType" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements ItemType" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines the complete design schema for an item type.'; No verified external callers; imports: none"]
+// 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/types/types.ts:DesignSchema:interface"]
+
 
 
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:ItemType:interface" type="interface" identity="ItemType" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines the runtime type record including schema and ownership metadata."]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares item type identity, schemas, ownership, and lifecycle fields."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ItemType interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports ItemType as the core public.types table shape." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface ItemType {
   id: string
   name: string
@@ -322,24 +326,25 @@ export interface ItemType {
   created_at: string
   updated_at: string
 }
-// CIL[END chunk_id="types_itemtype_1783637731"]
-// CIL[BEGIN chunk_id="types_item_1783637731" type="interface" identity="Item" parent="none"]
-// CIL[DOC-MACRO purpose="Define a data item record from the v2.items table representing an instance of a type"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent a concrete data record with type reference, data payload, and metadata"]
-// CIL[DOC-CONTEXT module="Item" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements Item" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines the runtime type record including schema and ownership metadata.'; No verified external callers; imports: none"]
+// 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/types/types.ts:ItemType:interface"]
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:Item:interface" type="interface" identity="Item" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a runtime item record belonging to an item type."]
+// CIL[DOC-RESPONSIBILITY responsibility="Holds item data, status, ownership, and audit timestamps."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Item interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports Item used by admin-data and custom app runtimes." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface Item {
   id: string
   item_type_id: string
@@ -357,48 +362,50 @@ export interface Item {
   design_schema?: Record<string, any> 
   validation_schema?: Record<string, any> 
 }
-// CIL[END chunk_id="types_item_1783637731"]
-// CIL[BEGIN chunk_id="types_validationerror_1783637731" type="interface" identity="ValidationError" parent="none"]
-// CIL[DOC-MACRO purpose="Define a validation error for form field validation feedback"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent field-specific validation errors with messages"]
-// CIL[DOC-CONTEXT module="ValidationError" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements ValidationError" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines a runtime item record belonging to an item type.'; No verified external callers; imports: none"]
+// 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/types/types.ts:Item:interface"]
+
 
 
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:ValidationError:interface" type="interface" identity="ValidationError" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a field validation error."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides field name and human-readable error message."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ValidationError interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports ValidationError for form and API validation." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface ValidationError {
   field: string
   message: string
 }
-// CIL[END chunk_id="types_validationerror_1783637731"]
-// CIL[BEGIN chunk_id="types_formstate_1783637731" type="interface" identity="FormState" parent="none"]
-// CIL[DOC-MACRO purpose="Define form state management for reactive forms with data, errors, and submission status"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent complete form state including data, validation errors, touched fields, and submission status"]
-// CIL[DOC-CONTEXT module="FormState" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements FormState" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines a field validation error.'; No verified external callers; imports: none"]
+// 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/types/types.ts:ValidationError:interface"]
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:FormState:interface" type="interface" identity="FormState" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines reactive form state for data entry."]
+// CIL[DOC-RESPONSIBILITY responsibility="Tracks data, errors, touched fields, and submission/valid state."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="FormState interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports FormState for UI form components." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface FormState {
   data: Record<string, any>
   errors: Record<string, string>
@@ -406,115 +413,120 @@ export interface FormState {
   isSubmitting: boolean
   isValid: boolean
 }
-// CIL[END chunk_id="types_formstate_1783637731"]
-// CIL[BEGIN chunk_id="types_paginationparams_1783637731" type="interface" identity="PaginationParams" parent="none"]
-// CIL[DOC-MACRO purpose="Define pagination parameters for list queries with limit, offset, and page options"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent pagination controls for data list APIs"]
-// CIL[DOC-CONTEXT module="PaginationParams" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements PaginationParams" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines reactive form state for data entry.'; No verified external callers; imports: none"]
+// 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/types/types.ts:FormState:interface"]
+
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:PaginationParams:interface" type="interface" identity="PaginationParams" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines pagination parameters for list queries."]
+// CIL[DOC-RESPONSIBILITY responsibility="Supports limit, offset, and page query options."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="PaginationParams interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports PaginationParams for list request input." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface PaginationParams {
   limit?: number
   offset?: number
   page?: number
 }
-// CIL[END chunk_id="types_paginationparams_1783637731"]
-// CIL[BEGIN chunk_id="types_sortparams_1783637731" type="interface" identity="SortParams" parent="none"]
-// CIL[DOC-MACRO purpose="Define sorting parameters for list queries with field and direction"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent sorting controls for ordered data display"]
-// CIL[DOC-CONTEXT module="SortParams" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements SortParams" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines pagination parameters for list queries.'; No verified external callers; imports: none"]
+// 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/types/types.ts:PaginationParams:interface"]
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:SortParams:interface" type="interface" identity="SortParams" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a single sort criterion."]
+// CIL[DOC-RESPONSIBILITY responsibility="Specifies field name and asc/desc direction."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="SortParams interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports SortParams for list sorting." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface SortParams {
   field: string
   direction: 'asc' | 'desc'
 }
-// CIL[END chunk_id="types_sortparams_1783637731"]
-// CIL[BEGIN chunk_id="types_filterparams_1783637731" type="interface" identity="FilterParams" parent="none"]
-// CIL[DOC-MACRO purpose="Define filter parameters for list queries with flexible key-value filtering"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent filter controls for data list APIs"]
-// CIL[DOC-CONTEXT module="FilterParams" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements FilterParams" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines a single sort criterion.'; No verified external callers; imports: none"]
+// 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/types/types.ts:SortParams:interface"]
+
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:FilterParams:interface" type="interface" identity="FilterParams" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines an open-ended filter bag for list queries."]
+// CIL[DOC-RESPONSIBILITY responsibility="Allows arbitrary key/value query filters."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="FilterParams interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports FilterParams as Record<string, any>." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface FilterParams {
   [key: string]: any
 }
-// CIL[END chunk_id="types_filterparams_1783637731"]
-// CIL[BEGIN chunk_id="types_searchparams_1783637731" type="interface" identity="SearchParams" parent="none"]
-// CIL[DOC-MACRO purpose="Define comprehensive search parameters combining pagination, search, sort, and filters"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent complete search controls for data list APIs"]
-// CIL[DOC-CONTEXT module="SearchParams" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements SearchParams" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines an open-ended filter bag for list queries.'; No verified external callers; imports: none"]
+// 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/types/types.ts:FilterParams:interface"]
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:SearchParams:interface" type="interface" identity="SearchParams" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines combined search, sort, filter, and pagination input."]
+// CIL[DOC-RESPONSIBILITY responsibility="Extends PaginationParams with search, sort, and filters."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="SearchParams interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports SearchParams for list/search endpoints." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface SearchParams extends PaginationParams {
   search?: string
   sort?: SortParams
   filters?: FilterParams
 }
-// CIL[END chunk_id="types_searchparams_1783637731"]
-// CIL[BEGIN chunk_id="types_entitycolumn_1783637731" type="interface" identity="EntityColumn" parent="none"]
-// CIL[DOC-MACRO purpose="Define column configuration for entity list display with sorting and display options"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent column metadata for data table rendering"]
-// CIL[DOC-CONTEXT module="EntityColumn" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements EntityColumn" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines combined search, sort, filter, and pagination input.'; No verified external callers; imports: none"]
+// 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/types/types.ts:SearchParams:interface"]
+
 
 
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:EntityColumn:interface" type="interface" identity="EntityColumn" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a column in a generic entity list table."]
+// CIL[DOC-RESPONSIBILITY responsibility="Describes key, label, sortability, type, display type, and badge colors."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="EntityColumn interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports EntityColumn for GenericListPage." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface EntityColumn {
   key: string
   label: string
@@ -524,24 +536,25 @@ export interface EntityColumn {
   badgeColors?: Record<string, string>
   maxLength?: number
 }
-// CIL[END chunk_id="types_entitycolumn_1783637731"]
-// CIL[BEGIN chunk_id="types_entitystat_1783637731" type="interface" identity="EntityStat" parent="none"]
-// CIL[DOC-MACRO purpose="Define stat card configuration for entity list summaries with counts and filters"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent summary statistics display for data lists"]
-// CIL[DOC-CONTEXT module="EntityStat" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements EntityStat" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines a column in a generic entity list table.'; No verified external callers; imports: none"]
+// 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/types/types.ts:EntityColumn:interface"]
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:EntityStat:interface" type="interface" identity="EntityStat" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a stat card shown on a generic entity list."]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares count/filter_count stat metadata and optional filter."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="EntityStat interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports EntityStat for GenericListPage." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface EntityStat {
   title: string
   type: 'count' | 'filter_count'
@@ -549,50 +562,52 @@ export interface EntityStat {
   color: string
   filter?: Record<string, any>
 }
-// CIL[END chunk_id="types_entitystat_1783637731"]
-// CIL[BEGIN chunk_id="types_entityfilter_1783637731" type="interface" identity="EntityFilter" parent="none"]
-// CIL[DOC-MACRO purpose="Define filter configuration for entity lists with search, enum, and boolean filter types"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent filter controls for data list filtering"]
-// CIL[DOC-CONTEXT module="EntityFilter" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements EntityFilter" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines a stat card shown on a generic entity list.'; No verified external callers; imports: none"]
+// 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/types/types.ts:EntityStat:interface"]
+
 
 
 
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:EntityFilter:interface" type="interface" identity="EntityFilter" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a filter control in a generic entity list."]
+// CIL[DOC-RESPONSIBILITY responsibility="Specifies key, label, filter type, and enum options."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="EntityFilter interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports EntityFilter for GenericListPage." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface EntityFilter {
   key: string
   label: string
   type: 'search' | 'enum' | 'boolean'
   options?: string[]
 }
-// CIL[END chunk_id="types_entityfilter_1783637731"]
-// CIL[BEGIN chunk_id="types_itemprogress_1783637731" type="interface" identity="ItemProgress" parent="none"]
-// CIL[DOC-MACRO purpose="Define progress tracking for items with status, scoring, and detailed progress data"]
-// CIL[DOC-RESPONSIBILITY responsibility="Represent user progress through items with completion status and metadata"]
-// CIL[DOC-CONTEXT module="ItemProgress" layer="unknown" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Implements ItemProgress" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: unknown. 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='Defines a filter control in a generic entity list.'; No verified external callers; imports: none"]
+// 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/types/types.ts:EntityFilter:interface"]
 
 
 
 
 
+
+// CIL[BEGIN stable_id="~/.framework/src/types/types.ts:ItemProgress:interface" type="interface" identity="ItemProgress" parent="~/.framework/src/types/types.ts"]
+// CIL[DOC-MACRO purpose="Defines a progress-tracking record for an item."]
+// CIL[DOC-RESPONSIBILITY responsibility="Holds status, score, attempts, time spent, and related metadata."]
+// CIL[DOC-CONTEXT module=".framework/src/types" layer="types" related_files=".framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ItemProgress interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Exports ItemProgress used by learning and task tracking features." notable_decisions="Fields marked optional with '?'; validation and permissions are nested sub-types."]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export interface ItemProgress {
   id: string
   type_id: string
@@ -620,4 +635,10 @@ export interface ItemProgress {
   created_at: string
   updated_at: string
 }
-// CIL[END chunk_id="types_itemprogress_1783637731"]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines a progress-tracking record for an item.'; No verified external callers; imports: none"]
+// 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/types/types.ts:ItemProgress:interface"]