aiox-core 5.0.1 → 5.0.3

package/pro/squads/design/templates/critical-eye-cycle-report-tmpl.md

@@ -0,0 +1,165 @@
+# Critical Eye — Cycle Report Template
+
+> Template ID: critical-eye-cycle-report-tmpl
+> Squad: Design
+> Version: 1.0.0
+> Governance Protocol: `squads/design/protocols/ai-first-governance.md`
+
+## Purpose
+
+Template para o relatorio de ciclo do Critical Eye. Preenchido automaticamente pela task `ds-critical-eye-report` ao final de cada ciclo de avaliacao.
+
+---
+
+## Report Structure
+
+```markdown
+# Critical Eye — Cycle Report #{CYCLE_NUMBER}
+
+**Date:** {TIMESTAMP}
+**Scoring Rules Version:** {SCORING_RULES_VERSION}
+**Catalog Version:** {CATALOG_VERSION}
+
+---
+
+## Executive Summary
+
+- **Variants evaluated:** {TOTAL_VARIANTS}
+- **New variants this cycle:** {NEW_VARIANTS}
+- **Transitions executed:** {TRANSITIONS_COUNT}
+- **Proposals pending review:** {PROPOSALS_COUNT}
+- **Average score:** {AVG_SCORE}/100
+- **Highest score:** {MAX_SCORE} ({MAX_SCORE_VARIANT})
+- **Lowest score (non-REJECT):** {MIN_SCORE} ({MIN_SCORE_VARIANT})
+
+---
+
+## Lifecycle Distribution
+
+| State | Count | Change |
+|-------|-------|--------|
+| CANDIDATE | {N} | {+/-N} |
+| EXPERIMENTAL | {N} | {+/-N} |
+| STABLE | {N} | {+/-N} |
+| CANONICAL | {N} | {+/-N} |
+| DEPRECATED | {N} | {+/-N} |
+| REJECT | {N} | {+/-N} |
+
+---
+
+## Transitions Executed
+
+### Auto-Transitions
+
+| Variant | From | To | Score | Reason | Authority |
+|---------|------|----|-------|--------|-----------|
+| {VARIANT_ID} | {FROM} | {TO} | {SCORE} | {REASON} | {AUTHORITY} |
+
+### Proposals Awaiting Review
+
+| Variant | Proposed | Score | Category Leader? | Requires |
+|---------|----------|-------|-----------------|----------|
+| {VARIANT_ID} | {TRANSITION} | {SCORE} | {YES/NO} | design-chief approval |
+
+---
+
+## Category Breakdown
+
+### {CATEGORY_NAME} ({VARIANT_COUNT} variants)
+
+**Leader:** {LEADER_VARIANT} — {LEADER_SCORE}/100
+**Health:** avg={AVG}, spread={SPREAD}
+
+| Rank | Variant | Score | Lifecycle | Breadth | Quality | Consistency | Maturity | Simplicity |
+|------|---------|-------|-----------|---------|---------|-------------|----------|------------|
+| 1 | {ID} | {TOTAL} | {STATE} | {B}/25 | {Q}/30 | {C}/20 | {M}/15 | {S}/10 |
+
+**Dimension Winners (head-to-head):**
+- Breadth: {WINNER}
+- Quality: {WINNER}
+- Consistency: {WINNER}
+- Maturity: {WINNER}
+- Simplicity: {WINNER}
+
+**Recommendation:** {CATEGORY_RECOMMENDATION}
+
+---
+
+{REPEAT FOR EACH CATEGORY}
+
+---
+
+## Tiebreakers Applied
+
+| Variants | Margin | Winner | Reason |
+|----------|--------|--------|--------|
+| {A} vs {B} | {N}% | {WINNER} | Higher breadth ({N} vs {N}) |
+
+---
+
+## Categories Needing Attention
+
+| Category | Avg Score | Issue | Recommendation |
+|----------|-----------|-------|----------------|
+| {CATEGORY} | {AVG} | {ISSUE} | {RECOMMENDATION} |
+
+---
+
+## Recommendations for Next Cycle
+
+### Immediate Actions
+{LIST_OF_IMMEDIATE_ACTIONS}
+
+### Source Gaps
+{LIST_OF_VARIANTS_NEEDING_MORE_SOURCES}
+
+### Quality Improvements
+{LIST_OF_QUALITY_GAPS}
+
+### Accessibility Concerns
+{LIST_OF_A11Y_ISSUES}
+
+---
+
+## Appendix: Full Score Matrix
+
+| Variant | Category | Lifecycle | Total | B | Q.tok | Q.sta | Q.a11y | Q.res | Q.com | Q.rlc | C.nam | C.api | C.vis | M.stb | M.doc | M.tst | S.cpx | S.dep |
+|---------|----------|-----------|-------|---|-------|-------|--------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|-------|
+| {ID} | {CAT} | {STATE} | {TOT} | {B} | {QT} | {QS} | {QA} | {QR} | {QC} | {QRL} | {CN} | {CA} | {CV} | {MS} | {MD} | {MT} | {SC} | {SD} |
+
+---
+
+*Generated by Critical Eye v{VERSION} — Cycle #{CYCLE_NUMBER}*
+*Scoring Authority: Nathan Curtis, Brad Frost, GOV.UK, USWDS, Adobe Spectrum*
+```
+
+---
+
+## Field Reference
+
+| Placeholder | Source | Description |
+|-------------|--------|-------------|
+| `{CYCLE_NUMBER}` | catalog.evaluationCycle | Current cycle |
+| `{TIMESTAMP}` | ISO-8601 | Generation time |
+| `{SCORING_RULES_VERSION}` | scoring-rules.version | Rules version |
+| `{TOTAL_VARIANTS}` | inventory.totalVariants | Count from inventory |
+| `{NEW_VARIANTS}` | inventory.newVariants | New since last cycle |
+| `{TRANSITIONS_COUNT}` | decisions.length | Auto-transitions |
+| `{PROPOSALS_COUNT}` | proposals.length | Pending reviews |
+| `{AVG_SCORE}` | Calculated | Mean of all total scores |
+| `{MAX_SCORE}` | Calculated | Highest total score |
+| `{MIN_SCORE}` | Calculated | Lowest non-REJECT score |
+
+---
+
+## Usage
+
+This template is consumed by `ds-critical-eye-report` task (Step 6 of the Critical Eye workflow). It should NOT be filled manually — the task reads all cycle data files and renders this template automatically.
+
+To generate manually (emergency): read all cycle JSON files from `outputs/design-system/critical-eye/cycle-{N}/` and fill placeholders.
+
+---
+
+*Template criado: 2026-02-18*
+*Squad: Design*
+*Workflow: critical-eye*

package/pro/squads/design/templates/design-fidelity-report-tmpl.md

@@ -0,0 +1,155 @@
+# Design Fidelity Report
+
+**Reference:** {{reference_name}}
+**Implementation:** {{implementation_path}}
+**Generated:** {{timestamp}}
+**Fidelity Score:** {{overall_score}}%
+
+---
+
+## Summary
+
+| Category | Matches | Total | Score |
+|----------|---------|-------|-------|
+| Colors | {{colors_match}} | {{colors_total}} | {{colors_score}}% |
+| Spacing | {{spacing_match}} | {{spacing_total}} | {{spacing_score}}% |
+| Typography | {{typography_match}} | {{typography_total}} | {{typography_score}}% |
+| Effects | {{effects_match}} | {{effects_total}} | {{effects_score}}% |
+| **Overall** | **{{total_match}}** | **{{total_total}}** | **{{overall_score}}%** |
+
+---
+
+## Score Interpretation
+
+| Score | Grade | Meaning |
+|-------|-------|---------|
+| 95-100% | A | Production ready |
+| 85-94% | B | Minor adjustments needed |
+| 70-84% | C | Significant drift |
+| 50-69% | D | Major revision required |
+| <50% | F | Rebuild recommended |
+
+**This implementation:** Grade {{grade}}
+
+---
+
+## Color Comparison
+
+| Token | Design | Code | Match | Fix |
+|-------|--------|------|-------|-----|
+{{#each colors}}
+| {{this.name}} | {{this.design}} | {{this.code}} | {{this.status}} | {{this.fix}} |
+{{/each}}
+
+---
+
+## Spacing Comparison
+
+| Location | Design | Code | Match | Fix |
+|----------|--------|------|-------|-----|
+{{#each spacing}}
+| {{this.location}} | {{this.design}} | {{this.code}} | {{this.status}} | {{this.fix}} |
+{{/each}}
+
+---
+
+## Typography Comparison
+
+| Element | Design | Code | Match | Fix |
+|---------|--------|------|-------|-----|
+{{#each typography}}
+| {{this.element}} | {{this.design}} | {{this.code}} | {{this.status}} | {{this.fix}} |
+{{/each}}
+
+---
+
+## Effects Comparison
+
+| Effect | Design | Code | Match |
+|--------|--------|------|-------|
+{{#each effects}}
+| {{this.name}} | {{this.design}} | {{this.code}} | {{this.status}} |
+{{/each}}
+
+---
+
+## Actionable Fixes
+
+### Priority 1: High Impact
+{{#each fixes_priority_1}}
+{{this.index}}. **{{this.description}}:** `{{this.from}}` -> `{{this.to}}`
+   - Files: {{this.files}}
+   - Impact: {{this.impact}} instances
+{{/each}}
+
+### Priority 2: Medium Impact
+{{#each fixes_priority_2}}
+{{this.index}}. **{{this.description}}:** `{{this.from}}` -> `{{this.to}}`
+   - Files: {{this.files}}
+   - Impact: {{this.impact}} instances
+{{/each}}
+
+### Priority 3: Low Impact
+{{#each fixes_priority_3}}
+{{this.index}}. **{{this.description}}:** `{{this.from}}` -> `{{this.to}}`
+   - Files: {{this.files}}
+   - Impact: {{this.impact}} instances
+{{/each}}
+
+---
+
+## Token Recommendations
+
+Based on this analysis, consider adding/updating these tokens:
+
+```yaml
+{{token_recommendations}}
+```
+
+---
+
+## Extracted Design Tokens
+
+Reference: `{{design_yaml_path}}`
+
+```yaml
+{{design_tokens_yaml}}
+```
+
+---
+
+## Extracted Code Tokens
+
+Reference: `{{code_yaml_path}}`
+
+```yaml
+{{code_tokens_yaml}}
+```
+
+---
+
+## Next Steps
+
+1. [ ] Apply Priority 1 fixes ({{priority_1_count}} changes)
+2. [ ] Apply Priority 2 fixes ({{priority_2_count}} changes)
+3. [ ] Apply Priority 3 fixes ({{priority_3_count}} changes)
+4. [ ] Re-run `*design-compare` to validate improvements
+5. [ ] Update tokens.yaml with recommendations
+6. [ ] Run `*validate-tokens` to ensure no hardcoded values
+
+---
+
+## Comparison Thresholds Used
+
+| Category | Threshold | Method |
+|----------|-----------|--------|
+| Colors | 5% | HSL distance |
+| Spacing | ±4px | Absolute difference |
+| Typography size | ±2px | Absolute difference |
+| Typography weight | exact | Exact match |
+| Border radius | ±2px | Absolute difference |
+
+---
+
+*Generated by Brad Frost (Design System Architect) v3.5.0*
+*Command: `*design-compare {{reference_name}} {{implementation_path}}`*

package/pro/squads/design/templates/ds-ai-component-metadata-schema-tmpl.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://synkra.ai/schemas/design-system/component-metadata.schema.json",
+  "title": "Design System Component Metadata",
+  "type": "object",
+  "required": [
+    "id",
+    "name",
+    "source",
+    "intent",
+    "props",
+    "variants",
+    "a11y",
+    "tokens"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(_[a-z0-9]+)*$"
+    },
+    "name": {
+      "type": "string"
+    },
+    "source": {
+      "type": "object",
+      "required": ["workspacePath", "exportName"],
+      "properties": {
+        "workspacePath": { "type": "string" },
+        "exportName": { "type": "string" },
+        "registryKey": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "intent": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 1
+    },
+    "contexts": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "props": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "type", "required"],
+        "properties": {
+          "name": { "type": "string" },
+          "type": { "type": "string" },
+          "required": { "type": "boolean" },
+          "default": {},
+          "description": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "variants": {
+      "type": "object",
+      "properties": {
+        "axes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        },
+        "compound": {
+          "type": "array",
+          "items": { "type": "object" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "a11y": {
+      "type": "object",
+      "required": ["role", "keyboard", "aria"],
+      "properties": {
+        "role": { "type": "string" },
+        "keyboard": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "aria": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "tokens": {
+      "type": "object",
+      "required": ["semantic", "component"],
+      "properties": {
+        "semantic": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "component": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "dependencies": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "examples": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "governance": {
+      "type": "object",
+      "properties": {
+        "protocol": {
+          "type": "string",
+          "const": "squads/design/protocols/ai-first-governance.md"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["Implemented", "Partially implemented", "Concept only"]
+        },
+        "canonicalSourcesChecked": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "contradictionsFound": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/pro/squads/design/templates/ds-artifact-analysis.md

@@ -0,0 +1,70 @@
+# Artifact Analysis Report #{{ARTIFACT_ID}}
+## {{ARTIFACT_NAME}}
+
+**Artifact ID**: {{ARTIFACT_ID}}
+**Name**: {{ARTIFACT_NAME}}
+**Type**: {{SCAN_TYPE}}
+**Date Analyzed**: {{TIMESTAMP}}
+**Analyzed By**: {{AGENT}}
+
+---
+
+## 📊 Overview
+
+{{OVERVIEW_TEXT}}
+
+**Primary Purpose**: {{PURPOSE}}
+
+---
+
+## 🎨 Color System
+
+### Colors Extracted
+```yaml
+colors:
+{{COLORS_LIST}}
+```
+
+---
+
+## 🔤 Typography System
+
+### Fonts and Scales
+```yaml
+typography:
+{{TYPOGRAPHY_DATA}}
+```
+
+---
+
+## 🧩 Components Identified
+
+{{COMPONENTS_SECTION}}
+
+---
+
+## 📐 Design Patterns
+
+{{PATTERNS_SECTION}}
+
+---
+
+## 📊 Metrics Summary
+
+| Metric | Value |
+|--------|-------|
+| Colors | {{COLORS_COUNT}} |
+| Components | {{COMPONENTS_COUNT}} |
+| Patterns | {{PATTERNS_COUNT}} |
+
+---
+
+## 💡 Recommendations
+
+{{RECOMMENDATIONS}}
+
+---
+
+*Analysis completed: {{TIMESTAMP}}*
+*Report version: 1.0*
+*Design System Agent*