aiox-core 5.0.2 → 5.0.3

package/pro/squads/design/templates/state-persistence-tmpl.yaml

@@ -0,0 +1,219 @@
+# .state.yaml
+# Design System State Tracking
+# Brad writes audit/consolidation/tokenization data
+# Merovingian reads and writes component building data
+# Enables seamless handoff between agents
+
+version: "1.0"
+project_name: "{{project_name}}"
+created_at: "{{created_timestamp}}"
+updated_at: "{{updated_timestamp}}"
+tailwind_version: "{{tailwind_version}}"
+
+# Current phase in design system workflow
+system_state:
+  phase: "{{current_phase}}"  # audit_complete | consolidation_complete | tokenize_complete | migration_strategy_complete | setup_complete | building_components
+
+  # Phase 1: Inventory (Brad)
+  inventory:
+    scanned_at: "{{scan_timestamp}}"
+    scan_path: "{{scan_path}}"
+    total_files: {{total_files}}
+    frameworks_detected:
+      react: {{has_react}}
+      vue: {{has_vue}}
+      html: {{has_html}}
+    patterns:
+      buttons:
+        unique: {{buttons_unique}}
+        instances: {{buttons_instances}}
+        redundancy_factor: {{buttons_redundancy}}
+      colors:
+        unique: {{colors_unique}}
+        instances: {{colors_instances}}
+        redundancy_factor: {{colors_redundancy}}
+      spacing:
+        unique_padding: {{spacing_padding}}
+        unique_margin: {{spacing_margin}}
+      typography:
+        unique_fonts: {{typography_fonts}}
+        unique_sizes: {{typography_sizes}}
+        unique_weights: {{typography_weights}}
+      forms:
+        unique_inputs: {{forms_inputs}}
+        unique_forms: {{forms_forms}}
+    estimated_monthly_cost: "{{estimated_cost}}"
+
+  # Phase 2: Consolidation (Brad)
+  consolidation:
+    completed_at: "{{consolidation_timestamp}}"
+    patterns_consolidated:
+      colors:
+        before: {{colors_before}}
+        after: {{colors_after}}
+        reduction: "{{colors_reduction}}%"
+        clusters: {{colors_clusters}}
+      buttons:
+        before: {{buttons_before}}
+        after: {{buttons_after}}
+        reduction: "{{buttons_reduction}}%"
+        variants: {{buttons_variants}}
+      spacing:
+        before: {{spacing_before}}
+        after: {{spacing_after}}
+        reduction: "{{spacing_reduction}}%"
+        scale: {{spacing_scale}}
+      typography:
+        before: {{typography_before}}
+        after: {{typography_after}}
+        reduction: "{{typography_reduction}}%"
+    overall_reduction: "{{overall_reduction}}%"
+    target_met: {{target_met}}
+    user_overrides: {{user_overrides}}
+
+  # Phase 3: Tokenization (Brad)
+  tokens:
+    generated_at: "{{token_timestamp}}"
+    version: "{{token_version}}"
+    location: "{{token_location}}"
+    exports:
+      - tokens.yaml
+      - tokens.json
+      - tokens.css
+      - tokens.tailwind.js
+      - tokens.scss
+      - tokens.dtcg.json
+    categories:
+      color: {{token_color_count}}
+      spacing: {{token_spacing_count}}
+      typography: {{token_typography_count}}
+      radius: {{token_radius_count}}
+      shadow: {{token_shadow_count}}
+    total_tokens: {{total_tokens}}
+    coverage: "{{token_coverage}}%"
+    dtcg_compliant: {{token_dtcg_compliant}}
+    color_space: "{{token_color_space}}"
+
+  # Phase 4: ROI Analysis (Brad)
+  roi:
+    calculated_at: "{{roi_timestamp}}"
+    before:
+      patterns: {{patterns_before}}
+      monthly_cost: {{monthly_cost_before}}
+      annual_cost: {{annual_cost_before}}
+    after:
+      patterns: {{patterns_after}}
+      monthly_cost: {{monthly_cost_after}}
+      annual_cost: {{annual_cost_after}}
+    savings:
+      monthly: {{monthly_savings}}
+      annual: {{annual_savings}}
+    implementation:
+      estimated_cost: {{implementation_cost}}
+    roi_metrics:
+      ratio: {{roi_ratio}}
+      breakeven_months: {{breakeven_months}}
+
+  # Phase 5: Migration Strategy (Brad)
+  migration:
+    strategy_created_at: "{{migration_timestamp}}"
+    phases:
+      - phase: 1
+        name: "Foundation"
+        duration_sprints: 1
+        status: {{phase1_status}}
+      - phase: 2
+        name: "High-Impact"
+        duration_sprints: 2-3
+        priorities: {{phase2_priorities}}
+        status: {{phase2_status}}
+      - phase: 3
+        name: "Long-Tail"
+        duration_sprints: 2-4
+        status: {{phase3_status}}
+      - phase: 4
+        name: "Enforcement"
+        duration_sprints: 1
+        status: {{phase4_status}}
+    current_phase: {{current_migration_phase}}
+    completion_percentage: {{migration_completion}}
+    estimated_completion: "{{migration_completion_date}}"
+
+  # Phase 6: Merovingian Setup
+  atlas_setup:
+    completed_at: "{{atlas_setup_timestamp}}"
+    starting_point: "{{starting_point}}"  # brownfield | greenfield
+    configuration:
+      component_directory: "{{component_dir}}"
+      css_approach: "{{css_approach}}"
+      test_framework: "{{test_framework}}"
+      storybook_enabled: {{storybook_enabled}}
+    tokens_loaded: {{tokens_loaded_success}}
+
+  # Phase 7: Component Building (Merovingian)
+  patterns_built:
+    atoms:
+      total: {{atoms_total}}
+      components: {{atoms_list}}
+    molecules:
+      total: {{molecules_total}}
+      components: {{molecules_list}}
+    organisms:
+      total: {{organisms_total}}
+      components: {{organisms_list}}
+    templates:
+      total: {{templates_total}}
+      components: {{templates_list}}
+
+  # Documentation (Merovingian)
+  documentation:
+    generated_at: "{{docs_timestamp}}"
+    components_documented: {{docs_components}}
+    pattern_library_location: "{{docs_location}}"
+
+  # Integration (Merovingian)
+  integrations:
+    mmos:
+      status: {{mmos_integration_status}}
+      components: {{mmos_components}}
+    creator_os:
+      status: {{creator_os_integration_status}}
+      components: {{creator_os_components}}
+    innerlens:
+      status: {{innerlens_integration_status}}
+      components: {{innerlens_components}}
+
+  tooling:
+    tailwind:
+      version: "{{tailwind_version}}"
+      upgraded_at: "{{tailwind_upgraded_at}}"
+      oxide_benchmark:
+        full_build_ms: {{tailwind_full_build_ms}}
+        incremental_build_us: {{tailwind_incremental_build_us}}
+      theme_layers_validated: {{tailwind_theme_validated}}
+    design_tokens:
+      dtcg_version: "{{dtcg_version}}"
+      exports:
+        json: {{dtcg_json_path}}
+        yaml: {{dtcg_yaml_path}}
+      okclh_coverage: "{{oklch_coverage}}"
+    shadcn:
+      bootstrap_completed_at: "{{shadcn_bootstrap_timestamp}}"
+      components_installed: {{shadcn_components}}
+    dark_mode:
+      enabled: {{dark_mode_enabled}}
+      parity_score: "{{dark_mode_parity_score}}"
+
+# Agent execution history (for debugging and handoff)
+agent_history:
+  - agent: "{{agent_name}}"
+    command: "{{command}}"
+    timestamp: "{{command_timestamp}}"
+    args: {{command_args}}
+    status: "{{command_status}}"
+
+# Flags for agent communication
+flags:
+  ready_for_atlas: {{ready_for_atlas}}
+  ready_for_migration: {{ready_for_migration}}
+  system_complete: {{system_complete}}

package/pro/squads/design/templates/tokens-schema-tmpl.yaml

@@ -0,0 +1,305 @@
+---
+template_name: "Design Tokens Schema"
+template_version: "1.0.0"
+output_format: "yaml"
+destination: "tokens/tokens.yaml"
+description: "Source of truth for all design tokens - generated by Brad from consolidated patterns"
+---
+
+# Design Tokens
+# Generated by Brad (Design System Architect)
+# Source: Pattern consolidation and extraction
+# All design decisions codified as reusable tokens
+
+metadata:
+  version: "1.0.0"
+  generated_by: "Brad"
+  generated_at: "{{timestamp}}"
+  dtcg_spec: "2025.10"
+  color_space: "oklch"
+  coverage: "{{coverage_percentage}}%"
+  reduction: "{{patterns_before}} → {{patterns_after}}"
+
+layers:
+  core:
+    color:
+      "$type": "color"
+      neutral-50:
+        "$value": "{{color_neutral_50}}"
+        "$description": "Lightest neutral"
+      neutral-100:
+        "$value": "{{color_neutral_100}}"
+      neutral-200:
+        "$value": "{{color_neutral_200}}"
+      neutral-300:
+        "$value": "{{color_neutral_300}}"
+      neutral-400:
+        "$value": "{{color_neutral_400}}"
+      neutral-500:
+        "$value": "{{color_neutral_500}}"
+      neutral-600:
+        "$value": "{{color_neutral_600}}"
+      neutral-700:
+        "$value": "{{color_neutral_700}}"
+      neutral-800:
+        "$value": "{{color_neutral_800}}"
+      neutral-900:
+        "$value": "{{color_neutral_900}}"
+      accent-primary:
+        "$value": "{{color_primary}}"
+        "$description": "Primary brand hue"
+      accent-secondary:
+        "$value": "{{color_secondary}}"
+      accent-success:
+        "$value": "{{color_success}}"
+      accent-warning:
+        "$value": "{{color_warning}}"
+      accent-error:
+        "$value": "{{color_error}}"
+      accent-info:
+        "$value": "{{color_info}}"
+    spacing:
+      "$type": "dimension"
+      base-unit:
+        "$value": "{{spacing_base_unit}}"
+      xs:
+        "$value": "{{spacing_xs}}"
+      sm:
+        "$value": "{{spacing_sm}}"
+      md:
+        "$value": "{{spacing_md}}"
+      lg:
+        "$value": "{{spacing_lg}}"
+      xl:
+        "$value": "{{spacing_xl}}"
+      2xl:
+        "$value": "{{spacing_2xl}}"
+      3xl:
+        "$value": "{{spacing_3xl}}"
+    typography:
+      "$type": "typography"
+      font-base:
+        "$value":
+          family: "{{font_family_base}}"
+      font-heading:
+        "$value":
+          family: "{{font_family_heading}}"
+      font-mono:
+        "$value":
+          family: "{{font_family_mono}}"
+      sizes:
+        "$type": "dimension"
+        xs:
+          "$value": "{{font_size_xs}}"
+        sm:
+          "$value": "{{font_size_sm}}"
+        base:
+          "$value": "{{font_size_base}}"
+        lg:
+          "$value": "{{font_size_lg}}"
+        xl:
+          "$value": "{{font_size_xl}}"
+        2xl:
+          "$value": "{{font_size_2xl}}"
+        3xl:
+          "$value": "{{font_size_3xl}}"
+      weights:
+        "$type": "number"
+        light:
+          "$value": {{font_weight_light}}
+        normal:
+          "$value": {{font_weight_normal}}
+        medium:
+          "$value": {{font_weight_medium}}
+        semibold:
+          "$value": {{font_weight_semibold}}
+        bold:
+          "$value": {{font_weight_bold}}
+      line-height:
+        "$type": "number"
+        tight:
+          "$value": {{line_height_tight}}
+        normal:
+          "$value": {{line_height_normal}}
+        relaxed:
+          "$value": {{line_height_relaxed}}
+    radius:
+      "$type": "dimension"
+      none:
+        "$value": "0"
+      sm:
+        "$value": "{{radius_sm}}"
+      base:
+        "$value": "{{radius_base}}"
+      lg:
+        "$value": "{{radius_lg}}"
+      xl:
+        "$value": "{{radius_xl}}"
+      full:
+        "$value": "9999px"
+    shadow:
+      "$type": "shadow"
+      sm:
+        "$value": "{{shadow_sm}}"
+      base:
+        "$value": "{{shadow_base}}"
+      md:
+        "$value": "{{shadow_md}}"
+      lg:
+        "$value": "{{shadow_lg}}"
+      xl:
+        "$value": "{{shadow_xl}}"
+    transition:
+      "$type": "duration"
+      fast:
+        "$value": "{{transition_fast}}"
+      base:
+        "$value": "{{transition_base}}"
+      slow:
+        "$value": "{{transition_slow}}"
+      easing:
+        "$type": "cubic-bezier"
+        "$value": "{{transition_easing}}"
+    elevation:
+      "$type": "number"
+      dropdown:
+        "$value": {{z_index_dropdown}}
+      sticky:
+        "$value": {{z_index_sticky}}
+      modal:
+        "$value": {{z_index_modal}}
+      popover:
+        "$value": {{z_index_popover}}
+      tooltip:
+        "$value": {{z_index_tooltip}}
+    breakpoint:
+      "$type": "dimension"
+      mobile:
+        "$value": "{{breakpoint_mobile}}"
+      tablet:
+        "$value": "{{breakpoint_tablet}}"
+      desktop:
+        "$value": "{{breakpoint_desktop}}"
+      wide:
+        "$value": "{{breakpoint_wide}}"
+
+  semantic:
+    color:
+      "$type": "color"
+      foreground:
+        "$value": "{{color_text}}"
+      background:
+        "$value": "{{color_background}}"
+      primary:
+        "$value": "{{color_primary}}"
+      primary-hover:
+        "$value": "{{color_primary_dark}}"
+      primary-disabled:
+        "$value": "{{color_primary_light}}"
+      secondary:
+        "$value": "{{color_secondary}}"
+      secondary-hover:
+        "$value": "{{color_secondary_dark}}"
+      success:
+        "$value": "{{color_success}}"
+      success-light:
+        "$value": "{{color_success_light}}"
+      warning:
+        "$value": "{{color_warning}}"
+      warning-light:
+        "$value": "{{color_warning_light}}"
+      error:
+        "$value": "{{color_error}}"
+      error-light:
+        "$value": "{{color_error_light}}"
+      info:
+        "$value": "{{color_info}}"
+      info-light:
+        "$value": "{{color_info_light}}"
+    spacing:
+      "$type": "dimension"
+      inset-xs:
+        "$value": "{{spacing_xs}}"
+      inset-sm:
+        "$value": "{{spacing_sm}}"
+      inset-md:
+        "$value": "{{spacing_md}}"
+      inset-lg:
+        "$value": "{{spacing_lg}}"
+      inset-xl:
+        "$value": "{{spacing_xl}}"
+    typography:
+      "$type": "typography"
+      body:
+        "$value":
+          family: "{{font_family_base}}"
+          size: "{{font_size_base}}"
+          lineHeight: {{line_height_normal}}
+          weight: {{font_weight_normal}}
+      heading:
+        "$value":
+          family: "{{font_family_heading}}"
+          size: "{{font_size_2xl}}"
+          lineHeight: {{line_height_tight}}
+          weight: {{font_weight_semibold}}
+      code:
+        "$value":
+          family: "{{font_family_mono}}"
+          size: "{{font_size_sm}}"
+          lineHeight: {{line_height_normal}}
+          weight: {{font_weight_medium}}
+
+  component:
+    button:
+      "$type": "object"
+      primary:
+        background:
+          "$type": "color"
+          "$value": "{{color_primary}}"
+        background-hover:
+          "$value": "{{color_primary_dark}}"
+        text:
+          "$value": "{{color_neutral_50}}"
+        border-radius:
+          "$value": "{{radius_base}}"
+        padding-inline:
+          "$value": "{{spacing_md}}"
+        padding-block:
+          "$value": "{{spacing_sm}}"
+      secondary:
+        background:
+          "$value": "{{color_secondary}}"
+        background-hover:
+          "$value": "{{color_secondary_dark}}"
+        text:
+          "$value": "{{color_neutral_900}}"
+    card:
+      "$type": "object"
+      background:
+        "$value": "{{color_background}}"
+      border:
+        "$value": "{{color_neutral_200}}"
+      radius:
+        "$value": "{{radius_lg}}"
+      padding:
+        "$value": "{{spacing_lg}}"
+    input:
+      "$type": "object"
+      background:
+        "$value": "{{color_background}}"
+      border:
+        "$value": "{{color_neutral_300}}"
+      border-focus:
+        "$value": "{{color_primary}}"
+      text:
+        "$value": "{{color_text}}"
+      placeholder:
+        "$value": "{{color_neutral_500}}"
+
+exports:
+  yaml: tokens.yaml
+  json: tokens.json
+  css: tokens.css
+  tailwind: tokens.tailwind.js
+  scss: tokens.scss
+  dtcg: tokens.dtcg.json

package/pro/squads/design/workflows/agentic-readiness.yaml

@@ -0,0 +1,83 @@
+# Agentic Readiness Workflow
+# Prepare design system artifacts for high-fidelity AI consumption.
+
+workflow:
+  id: "design-system-agentic-readiness"
+  name: "Design System Agentic Readiness"
+  description: "Audit and setup machine-readable artifacts so AI agents can safely consume the design system."
+  version: "1.0.0"
+  type: "sequential"
+
+metadata:
+  author: "Brad (Design System Architect)"
+  created_date: "2026-02-17"
+  last_modified: "2026-02-17"
+  tags:
+    - design-system
+    - agentic
+    - metadata
+    - governance
+
+inputs:
+  codebase_path:
+    type: "string"
+    description: "Path to evaluate for agentic readiness"
+    required: true
+
+  project_name:
+    type: "string"
+    description: "Project namespace for outputs"
+    required: true
+    default: "my-app"
+
+steps:
+  - id: "step_1_agentic_audit"
+    name: "Audit Agentic Readiness"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*agentic-audit"
+    inputs:
+      path: "{{codebase_path}}"
+    outputs:
+      report: "outputs/design-system/{{project_name}}/agentic/agentic-audit.md"
+    error_handling:
+      strategy: "fail"
+
+  - id: "step_2_agentic_setup"
+    name: "Setup Agentic Foundations"
+    type: "agent"
+    agent: "brad-frost"
+    command: "*agentic-setup"
+    inputs:
+      audit_report: "{{step_1_agentic_audit.report}}"
+    outputs:
+      setup_report: "outputs/design-system/{{project_name}}/agentic/agentic-setup.md"
+      metadata_file: "workspace/domains/design-system/metadata/components.json"
+    error_handling:
+      strategy: "fail"
+
+outputs:
+  readiness_complete:
+    type: "boolean"
+    source: "step_2_agentic_setup.success"
+  readiness_report:
+    type: "string"
+    source: "step_2_agentic_setup.setup_report"
+
+quality_gates:
+  internal_quality_chain:
+    required:
+      - "node squads/design/scripts/design-system/generate_components_metadata.cjs"
+      - "node squads/design/scripts/design-system/validate_components_metadata.cjs"
+      - "node squads/design/scripts/design-system/sync_design_manifest.cjs"
+      - "node squads/design/scripts/design-system/validate_design_manifest_drift.cjs"
+      - "node squads/design/scripts/design-system/validate_task_checklist_bindings.cjs"
+      - "node squads/design/scripts/design-system/validate_mcp_skeleton.cjs"
+    optional:
+      - "node squads/design/scripts/design-system/test_mcp_tools.cjs"
+    blocking: true
+    policy: "internal-first"
+    exception:
+      external_tool_allowed_with:
+        - "capability_gap_documented"
+        - "rationale_recorded"