aiox-core 5.0.3 → 5.0.4

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

@@ -1,165 +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*
+# 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

@@ -1,155 +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}}`*
+# 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}}`*