@3fn/core 14.0.0 → 14.1.0

package/governance/Component-Family-Form-Inputs.md

@@ -106,20 +106,20 @@ All text input components in the Form Inputs family inherit these 8 foundational
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
-| `float_label_animation` | Label animates on focus | 2.3.3 | web, ios, android |
-| `validates_on_blur` | Validation triggers on blur | 3.3.1 | web, ios, android |
-| `error_state_display` | Shows error message and styling | 3.3.1, 1.4.1 | web, ios, android |
-| `success_state_display` | Shows success styling | 1.4.1 | web, ios, android |
-| `trailing_icon_display` | Shows contextual trailing icons | 1.4.1 | web, ios, android |
-| `focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
-| `reduced_motion_support` | Respects prefers-reduced-motion | 2.3.3 | web, ios, android |
+| `interaction_focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
+| `content_float_label` | Label animates on focus | 2.3.3 | web, ios, android |
+| `validation_on_blur` | Validation triggers on blur | 3.3.1 | web, ios, android |
+| `state_error` | Shows error message and styling | 3.3.1, 1.4.1 | web, ios, android |
+| `state_success` | Shows success styling | 1.4.1 | web, ios, android |
+| `content_trailing_icon` | Shows contextual trailing icons | 1.4.1 | web, ios, android |
+| `interaction_focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
+| `accessibility_reduced_motion` | Respects prefers-reduced-motion | 2.3.3 | web, ios, android |
 
-**Excluded**: `disabled_state` — DesignerPunk does not support disabled states for usability and accessibility reasons. If an input is unavailable, it should not be rendered (adjudicated 2026-07-15; see `.kiro/issues/button-cta-disabled-state-adjudication.md`).
+**Excluded**: `state_disabled` — DesignerPunk does not support disabled states for usability and accessibility reasons. If an input is unavailable, it should not be rendered (adjudicated 2026-07-15; see `.kiro/issues/button-cta-disabled-state-adjudication.md`).
 
 ### Contract Details
 
-#### focusable
+#### interaction_focusable
 
 **Description**: Component can receive keyboard focus via Tab key navigation.
 
@@ -127,7 +127,7 @@ All text input components in the Form Inputs family inherit these 8 foundational
 
 **WCAG Compliance**: 2.1.1 Keyboard
 
-#### float_label_animation
+#### content_float_label
 
 **Description**: Label smoothly transitions from placeholder position inside input to floated position above input when focused or filled.
 
@@ -135,7 +135,7 @@ All text input components in the Form Inputs family inherit these 8 foundational
 
 **WCAG Compliance**: 2.3.3 Animation from Interactions
 
-#### error_state_display
+#### state_error
 
 **Description**: When in error state, component displays red border, red label text, error icon, and error message.
 
@@ -143,7 +143,7 @@ All text input components in the Form Inputs family inherit these 8 foundational
 
 **WCAG Compliance**: 3.3.1 Error Identification, 1.4.1 Use of Color
 
-#### focus_ring
+#### interaction_focus_ring
 
 **Description**: When focused via keyboard, component displays a visible focus indicator.
 
@@ -157,24 +157,24 @@ All text input components in the Form Inputs family inherit these 8 foundational
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `validates_email_format` | Validates email against RFC 5322 pattern | 3.3.1 |
-| `provides_email_autocomplete` | Enables browser/platform email autofill | 1.3.5 |
+| `validation_email_format` | Validates email against RFC 5322 pattern | 3.3.1 |
+| `interaction_email_autocomplete` | Enables browser/platform email autofill | 1.3.5 |
 
 #### Input-Text-Password Extended Contracts
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `provides_secure_input` | Masks password input by default | 3.3.2 |
-| `supports_password_toggle` | Provides show/hide password functionality | 2.1.1, 4.1.2 |
-| `provides_password_autocomplete` | Enables browser/platform password autofill | 1.3.5 |
+| `interaction_secure_input` | Masks password input by default | 3.3.2 |
+| `interaction_password_toggle` | Provides show/hide password functionality | 2.1.1, 4.1.2 |
+| `interaction_password_autocomplete` | Enables browser/platform password autofill | 1.3.5 |
 
 #### Input-Text-PhoneNumber Extended Contracts
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `validates_phone_format` | Validates phone number against country-specific patterns | 3.3.1 |
-| `provides_phone_formatting` | Formats phone numbers as user types | 3.3.2 |
-| `supports_international_formats` | Handles multiple country phone number formats | 3.3.2 |
+| `validation_phone_format` | Validates phone number against country-specific patterns | 3.3.1 |
+| `content_phone_formatting` | Formats phone numbers as user types | 3.3.2 |
+| `content_international_formats` | Handles multiple country phone number formats | 3.3.2 |
 
 ### Checkbox Base Contracts (Inherited by Checkbox Components)
 
@@ -182,19 +182,19 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
-| `pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
-| `hover_state` | Visual feedback on hover (web) | 1.4.13 | web |
-| `pressed_state` | Visual feedback when pressed | 2.4.7 | web, ios, android |
-| `checked_state` | Shows checkmark icon when checked | 1.4.1 | web, ios, android |
-| `indeterminate_state` | Shows minus icon for partial selection | 1.4.1 | web, ios, android |
-| `error_state_display` | Shows error border and message | 3.3.1 | web, ios, android |
-| `focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
-| `form_integration` | Native form submission and reset | 4.1.2 | web, ios, android |
+| `interaction_focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
+| `interaction_pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
+| `interaction_hover` | Visual feedback on hover (web) | 1.4.13 | web |
+| `interaction_pressed` | Visual feedback when pressed | 2.4.7 | web, ios, android |
+| `state_checked` | Shows checkmark icon when checked | 1.4.1 | web, ios, android |
+| `state_indeterminate` | Shows minus icon for partial selection | 1.4.1 | web, ios, android |
+| `state_error` | Shows error border and message | 3.3.1 | web, ios, android |
+| `interaction_focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
+| `validation_form_integration` | Native form submission and reset | 4.1.2 | web, ios, android |
 
 ### Checkbox Contract Details
 
-#### checked_state
+#### state_checked
 
 **Description**: When checked, component displays filled background with checkmark icon via Icon-Base.
 
@@ -202,7 +202,7 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 **WCAG Compliance**: 1.4.1 Use of Color (icon provides non-color indication)
 
-#### indeterminate_state
+#### state_indeterminate
 
 **Description**: When indeterminate, component displays filled background with horizontal minus icon via Icon-Base.
 
@@ -210,7 +210,7 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 **WCAG Compliance**: 1.4.1 Use of Color (icon provides non-color indication)
 
-#### form_integration
+#### validation_form_integration
 
 **Description**: Checkbox integrates with native form submission and reset.
 
@@ -222,8 +222,8 @@ All checkbox components in the Form Inputs family inherit these 9 foundational c
 
 | Contract | Description | WCAG |
 |----------|-------------|------|
-| `explicit_consent` | Prevents pre-checking with console warning | N/A |
-| `audit_trail` | Provides ISO 8601 timestamp and metadata | N/A |
+| `validation_explicit_consent` | Prevents pre-checking with console warning | N/A |
+| `validation_audit_trail` | Provides ISO 8601 timestamp and metadata | N/A |
 | `required_indicator` | Shows "Required" indicator by default | 3.3.2 |
 
 ### Radio Base Contracts (Inherited by Radio Components)
@@ -232,18 +232,18 @@ All radio components in the Form Inputs family inherit these 8 foundational cont
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
-| `pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
-| `hover_state` | Visual feedback on hover (web) | 1.4.13 | web |
-| `pressed_state` | Visual feedback when pressed | 2.4.7 | web, ios, android |
-| `selected_state` | Shows filled dot when selected | 1.4.1 | web, ios, android |
-| `error_state` | Shows error border and message | 3.3.1 | web, ios, android |
-| `focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
-| `form_integration` | Native form submission | 4.1.2 | web, ios, android |
+| `interaction_focusable` | Can receive keyboard focus | 2.1.1 | web, ios, android |
+| `interaction_pressable` | Responds to click/tap on entire label area | 2.1.1 | web, ios, android |
+| `interaction_hover` | Visual feedback on hover (web) | 1.4.13 | web |
+| `interaction_pressed` | Visual feedback when pressed | 2.4.7 | web, ios, android |
+| `state_selected` | Shows filled dot when selected | 1.4.1 | web, ios, android |
+| `state_error` | Shows error border and message | 3.3.1 | web, ios, android |
+| `interaction_focus_ring` | WCAG 2.4.7 focus visible indicator | 2.4.7 | web, ios, android |
+| `validation_form_integration` | Native form submission | 4.1.2 | web, ios, android |
 
 ### Radio Contract Details
 
-#### selected_state
+#### state_selected
 
 **Description**: When selected, component displays a filled circular dot centered within the outer circle.
 
@@ -263,21 +263,21 @@ All radio components in the Form Inputs family inherit these 8 foundational cont
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `mutual_exclusivity` | Only one radio selected at a time | N/A | web, ios, android |
-| `keyboard_navigation` | Arrow keys navigate within group | 2.1.1 | web, ios, android |
-| `group_validation` | Required validation at group level | 3.3.1 | web, ios, android |
-| `error_announcement` | Error message announced to screen readers | 4.1.3 | web, ios, android |
-| `radiogroup_role` | Proper ARIA role for group | 4.1.2 | web, ios, android |
+| `composition_mutual_exclusivity` | Only one radio selected at a time | N/A | web, ios, android |
+| `interaction_keyboard_navigation` | Arrow keys navigate within group | 2.1.1 | web, ios, android |
+| `validation_group_required` | Required validation at group level | 3.3.1 | web, ios, android |
+| `accessibility_error_announcement` | Error message announced to screen readers | 4.1.3 | web, ios, android |
+| `accessibility_radiogroup_role` | Proper ARIA role for group | 4.1.2 | web, ios, android |
 
 ### Radio Set Contract Details
 
-#### mutual_exclusivity
+#### composition_mutual_exclusivity
 
 **Description**: Only one radio within the group can be selected at any time.
 
 **Behavior**: When a user selects a radio, the previously selected radio becomes unselected. Clicking an already-selected radio does NOT deselect it (radio convention). The Set coordinates this via event listening (web), environment values (iOS), or CompositionLocal (Android).
 
-#### keyboard_navigation
+#### interaction_keyboard_navigation
 
 **Description**: Arrow keys navigate between radios within the group following WAI-ARIA radio group pattern.
 
@@ -372,8 +372,8 @@ InputTextBase(
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `validates_email_format` | Validates email against RFC 5322 pattern on blur | web, ios, android |
-| `provides_email_autocomplete` | Enables browser/platform email autofill | web, ios, android |
+| `validation_email_format` | Validates email against RFC 5322 pattern on blur | web, ios, android |
+| `interaction_email_autocomplete` | Enables browser/platform email autofill | web, ios, android |
 
 #### Usage Example
 
@@ -426,9 +426,9 @@ InputTextEmail(
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `provides_secure_input` | Masks password input by default | web, ios, android |
-| `supports_password_toggle` | Provides show/hide password functionality | web, ios, android |
-| `provides_password_autocomplete` | Enables browser/platform password autofill | web, ios, android |
+| `interaction_secure_input` | Masks password input by default | web, ios, android |
+| `interaction_password_toggle` | Provides show/hide password functionality | web, ios, android |
+| `interaction_password_autocomplete` | Enables browser/platform password autofill | web, ios, android |
 
 #### Usage Example
 
@@ -480,9 +480,9 @@ InputTextPassword(
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `validates_phone_format` | Validates phone number against country-specific patterns | web, ios, android |
-| `provides_phone_formatting` | Formats phone numbers as user types | web, ios, android |
-| `supports_international_formats` | Handles multiple country phone number formats | web, ios, android |
+| `validation_phone_format` | Validates phone number against country-specific patterns | web, ios, android |
+| `content_phone_formatting` | Formats phone numbers as user types | web, ios, android |
+| `content_international_formats` | Handles multiple country phone number formats | web, ios, android |
 
 #### Supported Countries
 
@@ -666,8 +666,8 @@ interface ConsentChangeData {
 
 | Contract | Description | Platforms |
 |----------|-------------|-----------|
-| `explicit_consent` | Prevents pre-checking with console warning | web, ios, android |
-| `audit_trail` | Provides ISO 8601 timestamp and metadata | web, ios, android |
+| `validation_explicit_consent` | Prevents pre-checking with console warning | web, ios, android |
+| `validation_audit_trail` | Provides ISO 8601 timestamp and metadata | web, ios, android |
 | `required_indicator` | Shows "Required" indicator by default | web, ios, android |
 
 #### Usage Example

package/governance/Component-Family-Icon.md

@@ -84,15 +84,15 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 | Contract | Description | WCAG | Platforms |
 |----------|-------------|------|-----------|
-| `renders_svg` | Renders inline SVG with correct viewBox and stroke | N/A | web, ios, android |
-| `color_inheritance` | Inherits color from parent via currentColor | 1.4.1 | web, ios, android |
-| `size_variants` | Supports 11 size variants from typography scale | N/A | web, ios, android |
-| `optical_balance` | Optional 8% lighter blend for icon-text pairing | 1.4.3 | web, ios, android |
+| `visual_renders_svg` | Renders inline SVG with correct viewBox and stroke | N/A | web, ios, android |
+| `visual_color_inheritance` | Inherits color from parent via currentColor | 1.4.1 | web, ios, android |
+| `visual_size_variants` | Supports 11 size variants from typography scale | N/A | web, ios, android |
+| `visual_optical_balance` | Optional 8% lighter blend for icon-text pairing | 1.4.3 | web, ios, android |
 | `accessibility_hidden` | Decorative icons hidden from assistive technology | 1.1.1 | web, ios, android |
 
 ### Contract Details
 
-#### renders_svg
+#### visual_renders_svg
 
 **Description**: Renders inline SVG with correct viewBox and stroke attributes.
 
@@ -100,7 +100,7 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 **WCAG Compliance**: N/A
 
-#### color_inheritance
+#### visual_color_inheritance
 
 **Description**: Inherits color from parent via currentColor.
 
@@ -108,7 +108,7 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 **WCAG Compliance**: 1.4.1 Use of Color
 
-#### size_variants
+#### visual_size_variants
 
 **Description**: Supports 11 size variants calculated from typography scale.
 
@@ -125,7 +125,7 @@ All components in the Icons family inherit these 5 foundational contracts from I
 
 **WCAG Compliance**: N/A
 
-#### optical_balance
+#### visual_optical_balance
 
 **Description**: Optional 8% lighter blend for icon-text pairing.
 

package/governance/Component-Family-Navigation.md

@@ -143,7 +143,7 @@ Nav-Header-Base (Primitive) [PLANNED]
 | `accessibility_touch_target` | accessibility | 2.5.5 | web, ios, android |
 | `validation_selection_constraints` | validation | — | web, ios, android |
 
-**Exclusions**: `state_disabled`, `interaction_hoverable` — No disabled or hover states on tab bar.
+**Exclusions**: `state_disabled`, `interaction_hover` — No disabled or hover states on tab bar.
 
 ---
 

package/governance/Component-Inheritance-Structures.md

@@ -76,22 +76,23 @@ Input-Text-Base (Primitive) │ ├── Input-Text-Email (Semantic) │ └─
 
 ### Behavioral Contracts
 
-**Base Contracts (8 total)**:
-- `focusable` - Keyboard focus support (WCAG 2.1.1)
-- `float_label_animation` - Label animates on focus (WCAG 2.3.3)
-- `validates_on_blur` - Validation triggers on blur (WCAG 3.3.1)
-- `error_state_display` - Error message and styling (WCAG 3.3.1, 1.4.1)
-- `success_state_display` - Success styling (WCAG 1.4.1)
-- `trailing_icon_display` - Contextual trailing icons
-- `focus_ring` - WCAG 2.4.7 focus visible indicator
-- `reduced_motion_support` - Respects prefers-reduced-motion
-
-**Excluded**: `disabled_state` — DesignerPunk does not support disabled states for usability and accessibility reasons (adjudicated 2026-07-15; see `.kiro/issues/button-cta-disabled-state-adjudication.md`).
+**Base Contracts (9 total)**:
+- `interaction_focusable` - Keyboard focus support (WCAG 2.1.1)
+- `content_float_label` - Label animates on focus (WCAG 2.3.3)
+- `validation_on_blur` - Validation triggers on blur (WCAG 3.3.1)
+- `state_error` - Error message and styling (WCAG 3.3.1)
+- `state_readonly` - Non-editable value that stays perceivable, selectable, and copyable — never disabled semantics (WCAG 4.1.2)
+- `state_success` - Success styling (WCAG 1.4.1)
+- `content_trailing_icon` - Contextual trailing icons (WCAG 1.4.1)
+- `interaction_focus_ring` - WCAG 2.4.7 focus visible indicator
+- `accessibility_reduced_motion` - Respects prefers-reduced-motion (WCAG 2.3.3)
+
+**Excluded**: `state_disabled` — DesignerPunk does not support disabled states for usability and accessibility reasons (adjudicated 2026-07-15; see `.kiro/issues/button-cta-disabled-state-adjudication.md`).
 
 **Extended Contracts by Variant**:
-- **Email**: `validates_email_format`, `provides_email_autocomplete`
-- **Password**: `provides_secure_input`, `supports_password_toggle`, `provides_password_autocomplete`
-- **PhoneNumber**: `validates_phone_format`, `provides_phone_formatting`, `supports_international_formats`
+- **Email**: `validation_email_format`, `interaction_email_autocomplete`
+- **Password**: `interaction_secure_input`, `interaction_password_toggle`, `interaction_password_autocomplete` (also excludes `state_readonly`)
+- **PhoneNumber**: `validation_phone_format`, `content_phone_formatting`, `content_international_formats`
 
 ### Token Dependencies
 
@@ -144,14 +145,14 @@ Button-CTA uses the `[Family]-[Type]` pattern (not `[Family]-[Type]-Base`) becau
 ### Behavioral Contracts
 
 **Contracts (6 total)**:
-- `clickable` - Responds to click/tap interactions (WCAG 2.1.1)
-- `focusable` - Keyboard focus support (WCAG 2.1.1)
-- `loading_state` - Shows loading indicator during async operations
+- `interaction_pressable` - Responds to click/tap interactions (WCAG 2.1.1)
+- `interaction_focusable` - Keyboard focus support (WCAG 2.1.1)
+- `state_loading` - Shows loading indicator during async operations
 - `icon_support` - Supports leading/trailing icons
-- `focus_ring` - WCAG 2.4.7 focus visible indicator
+- `interaction_focus_ring` - WCAG 2.4.7 focus visible indicator
 - `reduced_motion_support` - Respects prefers-reduced-motion
 
-**Excluded**: `disabled_state` — DesignerPunk does not support disabled states for usability and accessibility reasons (adjudicated 2026-07-15; see `.kiro/issues/button-cta-disabled-state-adjudication.md`).
+**Excluded**: `state_disabled` — DesignerPunk does not support disabled states for usability and accessibility reasons (adjudicated 2026-07-15; see `.kiro/issues/button-cta-disabled-state-adjudication.md`).
 
 ### Token Dependencies
 
@@ -200,12 +201,12 @@ Container-Base uses the `[Family]-Base` pattern because:
 ### Behavioral Contracts
 
 **Contracts (7 total)**:
-- `contains_children` - Can contain child components
-- `applies_padding` - Applies consistent internal padding
-- `applies_background` - Supports background color/image
-- `applies_border` - Supports border styling
-- `applies_shadow` - Supports elevation shadow
-- `applies_radius` - Supports border radius
+- `layout_contains_children` - Can contain child components
+- `layout_padding` - Applies consistent internal padding
+- `visual_background` - Supports background color/image
+- `visual_border` - Supports border styling
+- `visual_shadow` - Supports elevation shadow
+- `visual_radius` - Supports border radius
 - `responsive_layout` - Adapts to container width
 
 ### Token Dependencies
@@ -253,9 +254,9 @@ Icon-Base uses the `[Family]-Base` pattern because:
 ### Behavioral Contracts
 
 **Contracts (5 total)**:
-- `renders_svg` - Renders SVG icon content
-- `scales_with_size` - Scales proportionally with size prop
-- `inherits_color` - Inherits color from parent or uses explicit color
+- `visual_renders_svg` - Renders SVG icon content
+- `visual_size_variants` - Scales proportionally with size prop
+- `visual_color_inheritance` - Inherits color from parent or uses explicit color
 - `accessible_label` - Provides accessible label for screen readers
 - `decorative_mode` - Can be marked as decorative (aria-hidden)
 

package/governance/Component-Readiness-Status.md

@@ -520,17 +520,16 @@ metadata:
 **Query component readiness**:
 ```
 get_section({ 
-  path: "component-family-form-inputs", 
-  heading: "Component Readiness" 
+  path: "component-readiness-status", 
+  heading: "Individual Component Status" 
 })
 ```
 
 **Response includes**:
-- Component name
-- Current readiness status
-- Status indicator emoji
-- Usage recommendations
-- Migration guidance (if deprecated)
+- Component name and family
+- Roll-up status indicator (production-ready / web-ready-mobile-scaffold / scaffold)
+- Per-platform readiness breakdown (web / iOS / Android)
+- Implementation path
 
 ---
 

package/governance/Component-Templates.md

@@ -696,7 +696,7 @@ Use when semantic variants represent different states or statuses.
 #### Focusable Contract
 
 ```yaml
-focusable:
+interaction_focusable:
   description: Can receive keyboard focus
   behavior: |
     Component can receive focus via Tab key navigation.
@@ -712,7 +712,7 @@ focusable:
 #### Pressable Contract
 
 ```yaml
-pressable:
+interaction_pressable:
   description: Responds to press/click events
   behavior: |
     Component responds to click, tap, Enter key, and Space key.
@@ -729,7 +729,7 @@ pressable:
 #### Hoverable Contract
 
 ```yaml
-hoverable:
+interaction_hover:
   description: Visual feedback on hover (pointer devices only)
   behavior: |
     On pointer devices, component shows visual feedback when mouse
@@ -783,7 +783,7 @@ see the exclusion reason above and the 2026-07-15 adjudication ruling
 #### Error State Contract
 
 ```yaml
-error_state:
+state_error:
   description: Shows error message and styling
   behavior: |
     When in error state, component displays:
@@ -804,7 +804,7 @@ error_state:
 #### Success State Contract
 
 ```yaml
-success_state:
+state_success:
   description: Shows success styling
   behavior: |
     When in success state, component displays:
@@ -822,7 +822,7 @@ success_state:
 #### Loading State Contract
 
 ```yaml
-loading_state:
+state_loading:
   description: Shows loading indicator during async operations
   behavior: |
     When in loading state, component:
@@ -846,7 +846,7 @@ loading_state:
 #### Focus Ring Contract
 
 ```yaml
-focus_ring:
+interaction_focus_ring:
   description: WCAG 2.4.7 focus visible indicator
   behavior: |
     When focused via keyboard, component displays:
@@ -867,7 +867,7 @@ focus_ring:
 #### Reduced Motion Support Contract
 
 ```yaml
-reduced_motion_support:
+accessibility_reduced_motion:
   description: Respects prefers-reduced-motion
   behavior: |
     When user has reduced motion preference:
@@ -910,7 +910,7 @@ accessibility_hidden:
 #### Float Label Animation Contract
 
 ```yaml
-float_label_animation:
+content_float_label:
   description: Label animates on focus
   behavior: |
     Label smoothly transitions from placeholder position inside component
@@ -929,7 +929,7 @@ float_label_animation:
 #### Pressed State Visual Contract
 
 ```yaml
-pressed_state:
+interaction_pressed:
   description: Visual feedback when pressed
   behavior: |
     Component shows visual feedback during active press/click.
@@ -949,7 +949,7 @@ pressed_state:
 #### Gradient Glow Contract
 
 ```yaml
-gradient_glow:
+visual_gradient_glow:
   description: Radial gradient background providing state-dependent visual emphasis
   behavior: |
     Component renders an elliptical radial gradient background on
@@ -975,7 +975,7 @@ gradient_glow:
 #### Validates On Blur Contract
 
 ```yaml
-validates_on_blur:
+validation_on_blur:
   description: Validation triggers on blur
   behavior: |
     Validation state is evaluated when component loses focus.
@@ -1014,7 +1014,7 @@ custom_validation:
 #### Contains Children Contract
 
 ```yaml
-contains_children:
+layout_contains_children:
   description: Can contain child components
   behavior: |
     Component can contain any child components or content.
@@ -1034,7 +1034,7 @@ contains_children:
 #### Renders SVG Contract
 
 ```yaml
-renders_svg:
+visual_renders_svg:
   description: Renders inline SVG with correct attributes
   behavior: |
     Component renders an inline SVG element with:
@@ -1042,7 +1042,7 @@ renders_svg:
     - Appropriate fill/stroke attributes
     - Proper sizing based on size prop
     SVG content is loaded based on name from internal map.
-  wcag: N/A
+  wcag: null
   platforms: [web, ios, android]
   validation: |
     - SVG element renders with correct viewBox
@@ -1077,18 +1077,18 @@ renders_svg:
 
 | Behavior Needed | Contract(s) to Include |
 |-----------------|------------------------|
-| Keyboard navigation | focusable, focus_ring |
-| Click/tap interaction | pressable, pressed_state |
-| Mouse hover feedback | hoverable |
-| Action temporarily unavailable | state_loading (in-flight), validates_on_blur (invalid input), or do not render (no valid path) — never a disabled-state contract; see "No Disabled States — Standardized Exclusion" |
-| Error handling | error_state, validates_on_blur |
-| Success feedback | success_state |
-| Loading indication | loading_state |
-| Animation support | reduced_motion_support |
+| Keyboard navigation | interaction_focusable, interaction_focus_ring |
+| Click/tap interaction | interaction_pressable, interaction_pressed |
+| Mouse hover feedback | interaction_hover |
+| Action temporarily unavailable | state_loading (in-flight), validation_on_blur (invalid input), or do not render (no valid path) — never a disabled-state contract; see "No Disabled States — Standardized Exclusion" |
+| Error handling | state_error, validation_on_blur |
+| Success feedback | state_success |
+| Loading indication | state_loading |
+| Animation support | accessibility_reduced_motion |
 | Decorative elements | accessibility_hidden |
-| Form validation | validates_on_blur, custom_validation |
-| Container behavior | contains_children |
-| Icon rendering | renders_svg, accessibility_hidden |
+| Form validation | validation_on_blur, custom_validation |
+| Container behavior | layout_contains_children |
+| Icon rendering | visual_renders_svg, accessibility_hidden |
 
 ### Application MCP Checklist
 

package/governance/Contract-System-Reference.md

@@ -180,7 +180,7 @@ excludes:
 | `category` | Taxonomy category (redundant with name prefix — enables validation) |
 | `description` | Short description of the behavioral guarantee |
 | `behavior` | Detailed behavior description |
-| `wcag` | WCAG criterion this contract supports (null if not applicable) |
+| `wcag` | WCAG criterion this contract supports — required for allowlisted contracts (use the 'N/A' sentinel when genuinely not applicable); null only for non-allowlisted contracts |
 | `platforms` | Platforms where this contract applies |
 | `validation` | Testable criteria for verifying the contract |
 | `test_approach` | How to test this contract |

package/governance/Process-Development-Workflow.md

@@ -8,7 +8,7 @@ description: Development workflow and task completion practices — task complet
 # Development Workflow and Task Completion Practices
 
 **Date**: 2025-10-20
-**Last Reviewed**: 2026-07-14
+**Last Reviewed**: 2026-08-12
 **Purpose**: Task completion workflow and git practices for all development work
 **Organization**: process-standard
 **Scope**: cross-project
@@ -32,7 +32,7 @@ description: Development workflow and task completion practices — task complet
 
 **MCP Queries for Detailed Guidance** (query when needed):
 - **Completion Documentation**: `get_section({ path: "completion-documentation-guide", heading: "Two-Document Workflow" })`
-- **Release Detection**: `get_section({ path: "release-management-system", heading: "Release Pipeline Architecture" })`
+- **Releases**: `get_section({ path: "release-management-system", heading: "The Release Recipe" })`
 - **File Organization**: `get_section({ path: "process-file-organization", heading: "Organization Implementation (Conditional Loading)" })`
 - **Hook Operations**: `get_section({ path: "process-hook-operations", heading: "Agent Hook Dependency Chains" })`
 
@@ -109,7 +109,7 @@ get_section({ path: "completion-documentation-guide", heading: "Naming Conventio
 2. **Manually update tasks.md**: Change task status from `[ ]` to `[x]`
 3. **Open the Task PR**: Run `./.kiro/hooks/complete-task.sh "Task Name"` to commit on the task branch, push, and open the PR
 4. **Merge = completion**: Peter merges on green; the merged PR is the verification
-5. **[OPTIONAL]** **Release Analysis**: Run `npm run release:analyze` for detailed local analysis (the standing analysis runs post-merge on `main`)
+5. **[OPTIONAL]** **Release-delta check**: `git log $(git describe --tags --abbrev=0)..main --oneline` shows everything shipped since the last release (squash titles are the changelog spine — see Release Management System)
 
 **When to use this approach:**
 - Quick fixes or minor changes
@@ -246,7 +246,7 @@ get_section({ path: "process-hook-operations", heading: "Quick Reference: Diagno
 
 **Quick Reference - Error Recovery**:
 - If commit fails: Fix issues and re-run the tooling
-- If push fails: Push the TASK BRANCH manually (`git push -u origin <branch>`) — never `main`
+- If push fails: Push the TASK BRANCH manually (`git push -u origin <branch>`)
 - If the PR title is wrong: Edit the PR title on GitHub (squash-merge takes the title as the commit subject)
 
 

package/governance/Process-File-Organization.md

@@ -109,10 +109,7 @@ All files use explicit metadata to declare organizational intent, enabling safe
 **Task**: Associated task number and name (if applicable)
 ```
 
-**Civitas Governance Note:** Steering documents require additional metadata fields (`Last Reviewed`, `Layer`, `Relevant Tasks`, `inclusion` in YAML frontmatter). For the complete steering doc metadata requirements and lifecycle process (creation → review → update → deprecation), see Thurgood's Civitas Steward operational mode or query:
-```
-get_section({ path: ".kiro/steering/Civitas-System-Overview.md", heading: "Governance Processes" })
-```
+**Civitas Governance Note:** Steering documents require additional metadata fields (`Last Reviewed`, `Layer`, `Relevant Tasks`, `inclusion` in YAML frontmatter). For the complete steering doc metadata requirements and lifecycle process (creation → review → update → deprecation), see Thurgood's Civitas Steward operational mode, or the always-loaded Civitas System Overview § "Governance Processes" (an identity doc — never MCP-served, already in every agent's context; no query needed).
 
 #### Optional: `aliases:` frontmatter field (steering docs)