aiox-core 5.0.3 → 5.0.4

package/pro/squads/design/data/integration-patterns.md

@@ -1,207 +1,207 @@
-# Integration Patterns with Squads
-
-**Purpose:** How design system integrates with MMOS, CreatorOS, InnerLens
-**Agent:** Design System (Builder Mode)
-
----
-
-## Integration Architecture
-
-```typescript
-// Design system provides hooks
-interface DesignSystemHook {
-    getTokens(context: Context): Tokens;
-    getComponents(): ComponentLibrary;
-    applyTheme(theme: Theme): void;
-}
-
-// Expansion packs consume
-const designSystem = useDesignSystem();
-const tokens = designSystem.getTokens({ personality: 'formal' });
-```
-
----
-
-## MMOS Integration
-
-### Use Case: Cognitive Clone Interfaces
-
-**Problem:** Each clone needs consistent UI that matches personality.
-
-**Solution:** Personality-based token variations.
-
-```typescript
-// Personality token mapping
-const personalityTokens = {
-    formal: {
-        fontFamily: 'var(--font-serif)',
-        fontSize: 'var(--font-size-base)',
-        spacing: 'var(--space-formal)',      // Generous
-        colorPrimary: 'var(--color-corporate)',
-        colorBackground: 'var(--color-neutral-50)',
-    },
-
-    casual: {
-        fontFamily: 'var(--font-sans)',
-        fontSize: 'var(--font-size-lg)',
-        spacing: 'var(--space-relaxed)',
-        colorPrimary: 'var(--color-friendly)',
-        colorBackground: 'var(--color-warm)',
-    },
-
-    technical: {
-        fontFamily: 'var(--font-mono)',
-        fontSize: 'var(--font-size-sm)',
-        spacing: 'var(--space-compact)',
-        colorPrimary: 'var(--color-technical)',
-        colorBackground: 'var(--color-dark)',
-    },
-};
-
-// Usage in MMOS
-<CloneChatInterface
-    personality="formal"
-    tokens={personalityTokens.formal}
-/>
-```
-
-### Components Generated
-
-- `CloneChatInterface` (Input + MessageBubble + Avatar)
-- `CloneAvatar` (with personality-based styling)
-- `CloneSettings` (form fields for clone config)
-
----
-
-## CreatorOS Integration
-
-### Use Case: Course Platform UIs
-
-**Problem:** Educational interfaces need readability and accessibility.
-
-**Solution:** Learning-optimized tokens.
-
-```typescript
-// Educational tokens
-const educationalTokens = {
-    fontSize: '18px',              // Larger for readability
-    lineHeight: 1.6,               // Comprehension
-    spacing: 'var(--space-generous)',
-    colorFocus: 'var(--color-highlight)',
-    colorProgress: 'var(--color-success)',
-    colorError: 'var(--color-error)',
-};
-
-// Usage in CreatorOS
-<CourseVideoPlayer
-    tokens={educationalTokens}
-    accessibility="WCAG AAA"
-/>
-```
-
-### Components Generated
-
-- `CourseVideoPlayer` (with controls, transcript, progress)
-- `QuizQuestion` (with validation UI)
-- `ProgressBar` (visual reinforcement)
-- `ChapterNavigation` (clear structure)
-
----
-
-## InnerLens Integration
-
-### Use Case: Psychometric Assessment Forms
-
-**Problem:** Tests need minimal distractions, neutral design.
-
-**Solution:** Minimal distraction tokens.
-
-```typescript
-// Minimal tokens
-const minimalTokens = {
-    colorPrimary: 'var(--color-neutral-700)',
-    colorBackground: 'var(--color-neutral-50)',
-    colorBorder: 'var(--color-neutral-200)',
-    spacing: 'var(--space-balanced)',
-    fontSize: 'var(--font-size-base)',
-    // No decorative elements
-};
-
-// Usage in InnerLens
-<AssessmentForm
-    tokens={minimalTokens}
-    questionUI={<QuestionPrompt />}
-    inputUI={<RadioGroup />}
-/>
-```
-
-### Components Generated
-
-- `QuestionPrompt` (clear, minimal)
-- `RadioGroup` (clean radio buttons)
-- `ScaleInput` (Likert scale UI)
-- `ProgressIndicator` (non-distracting)
-
----
-
-## Integration Workflow
-
-### Step 1: Define Pack-Specific Tokens
-
-```yaml
-# squads/mmos/.design-system/tokens/
-formal-personality.yaml
-casual-personality.yaml
-technical-personality.yaml
-```
-
-### Step 2: Generate Pack Components
-
-```bash
-*agent design-system
-*integrate mmos
-
-# Generates MMOS-specific components
-# Uses personality tokens
-# Creates integration docs
-```
-
-### Step 3: Test Integration
-
-```typescript
-// Test that MMOS can use design system
-import { CloneChatInterface } from '@design-system/mmos';
-import { personalityTokens } from '@design-system/tokens';
-
-test('formal clone uses correct tokens', () => {
-    const { container } = render(
-        <CloneChatInterface personality="formal" />
-    );
-
-    expect(container).toHaveStyle({
-        fontFamily: personalityTokens.formal.fontFamily,
-    });
-});
-```
-
----
-
-## Integration Checklist
-
-- [ ] Token variations defined for pack
-- [ ] Pack-specific components generated
-- [ ] Integration tests pass
-- [ ] Documentation created
-- [ ] No regressions in pack functionality
-- [ ] Pack can import and use components
-- [ ] Token changes propagate to pack
-
----
-
-## Notes
-
-- Each pack has unique requirements
-- Token variations maintain consistency
-- Components extend base system (don't replace)
-- Integration is bidirectional (pack ↔ design system)
-- Document in both pack README and design system docs
+# Integration Patterns with Squads
+
+**Purpose:** How design system integrates with MMOS, CreatorOS, InnerLens
+**Agent:** Design System (Builder Mode)
+
+---
+
+## Integration Architecture
+
+```typescript
+// Design system provides hooks
+interface DesignSystemHook {
+    getTokens(context: Context): Tokens;
+    getComponents(): ComponentLibrary;
+    applyTheme(theme: Theme): void;
+}
+
+// Expansion packs consume
+const designSystem = useDesignSystem();
+const tokens = designSystem.getTokens({ personality: 'formal' });
+```
+
+---
+
+## MMOS Integration
+
+### Use Case: Cognitive Clone Interfaces
+
+**Problem:** Each clone needs consistent UI that matches personality.
+
+**Solution:** Personality-based token variations.
+
+```typescript
+// Personality token mapping
+const personalityTokens = {
+    formal: {
+        fontFamily: 'var(--font-serif)',
+        fontSize: 'var(--font-size-base)',
+        spacing: 'var(--space-formal)',      // Generous
+        colorPrimary: 'var(--color-corporate)',
+        colorBackground: 'var(--color-neutral-50)',
+    },
+
+    casual: {
+        fontFamily: 'var(--font-sans)',
+        fontSize: 'var(--font-size-lg)',
+        spacing: 'var(--space-relaxed)',
+        colorPrimary: 'var(--color-friendly)',
+        colorBackground: 'var(--color-warm)',
+    },
+
+    technical: {
+        fontFamily: 'var(--font-mono)',
+        fontSize: 'var(--font-size-sm)',
+        spacing: 'var(--space-compact)',
+        colorPrimary: 'var(--color-technical)',
+        colorBackground: 'var(--color-dark)',
+    },
+};
+
+// Usage in MMOS
+<CloneChatInterface
+    personality="formal"
+    tokens={personalityTokens.formal}
+/>
+```
+
+### Components Generated
+
+- `CloneChatInterface` (Input + MessageBubble + Avatar)
+- `CloneAvatar` (with personality-based styling)
+- `CloneSettings` (form fields for clone config)
+
+---
+
+## CreatorOS Integration
+
+### Use Case: Course Platform UIs
+
+**Problem:** Educational interfaces need readability and accessibility.
+
+**Solution:** Learning-optimized tokens.
+
+```typescript
+// Educational tokens
+const educationalTokens = {
+    fontSize: '18px',              // Larger for readability
+    lineHeight: 1.6,               // Comprehension
+    spacing: 'var(--space-generous)',
+    colorFocus: 'var(--color-highlight)',
+    colorProgress: 'var(--color-success)',
+    colorError: 'var(--color-error)',
+};
+
+// Usage in CreatorOS
+<CourseVideoPlayer
+    tokens={educationalTokens}
+    accessibility="WCAG AAA"
+/>
+```
+
+### Components Generated
+
+- `CourseVideoPlayer` (with controls, transcript, progress)
+- `QuizQuestion` (with validation UI)
+- `ProgressBar` (visual reinforcement)
+- `ChapterNavigation` (clear structure)
+
+---
+
+## InnerLens Integration
+
+### Use Case: Psychometric Assessment Forms
+
+**Problem:** Tests need minimal distractions, neutral design.
+
+**Solution:** Minimal distraction tokens.
+
+```typescript
+// Minimal tokens
+const minimalTokens = {
+    colorPrimary: 'var(--color-neutral-700)',
+    colorBackground: 'var(--color-neutral-50)',
+    colorBorder: 'var(--color-neutral-200)',
+    spacing: 'var(--space-balanced)',
+    fontSize: 'var(--font-size-base)',
+    // No decorative elements
+};
+
+// Usage in InnerLens
+<AssessmentForm
+    tokens={minimalTokens}
+    questionUI={<QuestionPrompt />}
+    inputUI={<RadioGroup />}
+/>
+```
+
+### Components Generated
+
+- `QuestionPrompt` (clear, minimal)
+- `RadioGroup` (clean radio buttons)
+- `ScaleInput` (Likert scale UI)
+- `ProgressIndicator` (non-distracting)
+
+---
+
+## Integration Workflow
+
+### Step 1: Define Pack-Specific Tokens
+
+```yaml
+# squads/mmos/.design-system/tokens/
+formal-personality.yaml
+casual-personality.yaml
+technical-personality.yaml
+```
+
+### Step 2: Generate Pack Components
+
+```bash
+*agent design-system
+*integrate mmos
+
+# Generates MMOS-specific components
+# Uses personality tokens
+# Creates integration docs
+```
+
+### Step 3: Test Integration
+
+```typescript
+// Test that MMOS can use design system
+import { CloneChatInterface } from '@design-system/mmos';
+import { personalityTokens } from '@design-system/tokens';
+
+test('formal clone uses correct tokens', () => {
+    const { container } = render(
+        <CloneChatInterface personality="formal" />
+    );
+
+    expect(container).toHaveStyle({
+        fontFamily: personalityTokens.formal.fontFamily,
+    });
+});
+```
+
+---
+
+## Integration Checklist
+
+- [ ] Token variations defined for pack
+- [ ] Pack-specific components generated
+- [ ] Integration tests pass
+- [ ] Documentation created
+- [ ] No regressions in pack functionality
+- [ ] Pack can import and use components
+- [ ] Token changes propagate to pack
+
+---
+
+## Notes
+
+- Each pack has unique requirements
+- Token variations maintain consistency
+- Components extend base system (don't replace)
+- Integration is bidirectional (pack ↔ design system)
+- Document in both pack README and design system docs

package/pro/squads/design/data/internal-quality-chain.yaml

@@ -1,48 +1,48 @@
-version: "1.0.0"
-updated: "2026-02-17"
-owner: "design-chief"
-policy: "internal-first"
-
-description: >
-  Cadeia minima obrigatoria de validacoes internas para concluir entregas do
-  squad de design system.
-
-required_commands:
-  - id: ds_qc_001
-    command: "node squads/design/scripts/design-system/generate_components_metadata.cjs"
-    purpose: "Regenerar catalogo de componentes"
-  - id: ds_qc_002
-    command: "node squads/design/scripts/design-system/validate_components_metadata.cjs"
-    purpose: "Validar consistencia dos metadados de componentes"
-  - id: ds_qc_003
-    command: "node squads/design/scripts/design-system/sync_design_manifest.cjs"
-    purpose: "Sincronizar manifest de design com squad.yaml"
-  - id: ds_qc_004
-    command: "node squads/design/scripts/design-system/validate_design_manifest_drift.cjs"
-    purpose: "Bloquear drift entre manifest e configuracao"
-  - id: ds_qc_005
-    command: "node squads/design/scripts/design-system/validate_task_checklist_bindings.cjs"
-    purpose: "Garantir binding task-checklist"
-  - id: ds_qc_006
-    command: "node squads/design/scripts/design-system/validate_mcp_skeleton.cjs"
-    purpose: "Validar presenca de skeleton MCP"
-
-optional_commands:
-  - id: ds_qc_opt_001
-    command: "node squads/design/scripts/design-system/test_mcp_tools.cjs"
-    purpose: "Healthcheck de ferramentas MCP do design system"
-
-gate:
-  mode: blocking
-  require_all_required_commands: true
-  release_condition: "all_required_passed"
-
-exception_policy:
-  external_tool_allowed_when:
-    - "capability_not_covered_internally"
-    - "internal_path_unavailable_or_insufficient_with_evidence"
-  requirements:
-    - "document capability gap"
-    - "document selected external tool and rationale"
-    - "record fallback or rollback path"
-  enforcement: "external_allowed_with_justification"
+version: "1.0.0"
+updated: "2026-02-17"
+owner: "design-chief"
+policy: "internal-first"
+
+description: >
+  Cadeia minima obrigatoria de validacoes internas para concluir entregas do
+  squad de design system.
+
+required_commands:
+  - id: ds_qc_001
+    command: "node squads/design/scripts/design-system/generate_components_metadata.cjs"
+    purpose: "Regenerar catalogo de componentes"
+  - id: ds_qc_002
+    command: "node squads/design/scripts/design-system/validate_components_metadata.cjs"
+    purpose: "Validar consistencia dos metadados de componentes"
+  - id: ds_qc_003
+    command: "node squads/design/scripts/design-system/sync_design_manifest.cjs"
+    purpose: "Sincronizar manifest de design com squad.yaml"
+  - id: ds_qc_004
+    command: "node squads/design/scripts/design-system/validate_design_manifest_drift.cjs"
+    purpose: "Bloquear drift entre manifest e configuracao"
+  - id: ds_qc_005
+    command: "node squads/design/scripts/design-system/validate_task_checklist_bindings.cjs"
+    purpose: "Garantir binding task-checklist"
+  - id: ds_qc_006
+    command: "node squads/design/scripts/design-system/validate_mcp_skeleton.cjs"
+    purpose: "Validar presenca de skeleton MCP"
+
+optional_commands:
+  - id: ds_qc_opt_001
+    command: "node squads/design/scripts/design-system/test_mcp_tools.cjs"
+    purpose: "Healthcheck de ferramentas MCP do design system"
+
+gate:
+  mode: blocking
+  require_all_required_commands: true
+  release_condition: "all_required_passed"
+
+exception_policy:
+  external_tool_allowed_when:
+    - "capability_not_covered_internally"
+    - "internal_path_unavailable_or_insufficient_with_evidence"
+  requirements:
+    - "document capability gap"
+    - "document selected external tool and rationale"
+    - "record fallback or rollback path"
+  enforcement: "external_allowed_with_justification"