@soleri/core 2.12.0 → 7.0.0

package/data/flows/build.flow.yaml

@@ -0,0 +1,128 @@
+# Build Component Flow
+# Orchestrates component creation with vault-first knowledge and validation gates.
+
+id: BUILD-flow
+name: Build Component
+description: >
+  Full component build workflow: search vault for patterns, check for duplicates,
+  gather architecture guidance, get component workflow, then validate the result.
+version: "1.0.0"
+
+on-missing-capability:
+  default: skip-with-warning
+  blocking: [vault.search]
+
+triggers:
+  modes:
+    - BUILD
+    - component-build
+  contexts:
+    - component
+    - feature
+    - ui
+  min-confidence: MEDIUM
+
+steps:
+  - id: search-vault
+    name: Search Vault Patterns
+    description: Search vault for existing patterns, anti-patterns, and prior art related to the build target.
+    needs: [vault.search, memory.search]
+    chains:
+      - vault-search
+      - memory-search
+    output:
+      - vault-patterns
+      - memory-hits
+
+  - id: check-duplicates
+    name: Check for Duplicates
+    description: Verify that a similar component does not already exist before building.
+    needs: [component.search]
+    chains:
+      - component-search
+    output:
+      - duplicate-check-result
+    gate:
+      type: GATE
+      condition: "count == 0"
+      on-false:
+        action: STOP
+        message: "Duplicate component detected. Review existing component before building a new one."
+
+  - id: get-design-recommendation
+    name: Get Design Recommendation
+    description: Query design intelligence for style, palette, and typography guidance before building.
+    needs: [design.recommend]
+    chains:
+      - recommend-design-system
+    output:
+      - design-recommendation
+
+  - id: get-architecture
+    name: Get Architecture Guidance
+    description: Fetch architecture patterns and brain recommendations in parallel.
+    needs: [architecture.search, brain.recommend]
+    chains:
+      - architecture-search
+      - brain-recommend
+    parallel: true
+    output:
+      - architecture-patterns
+      - brain-recommendations
+
+  - id: get-workflow
+    name: Get Component Workflow
+    description: Retrieve the component build workflow from the design system.
+    needs: [component.workflow]
+    chains:
+      - component-workflow
+    output:
+      - workflow-steps
+
+  - id: validate
+    name: Validate Component
+    description: Run design system validation and score the output quality.
+    needs: [component.validate, token.check]
+    chains:
+      - validate-component
+      - validate-tokens
+    output:
+      - validation-score
+    gate:
+      type: SCORE
+      min: 80
+      grade-thresholds:
+        A: 95
+        B: 85
+        C: 75
+      on-false:
+        action: BRANCH
+        goto: get-workflow
+        message: "Validation score below threshold. Re-run workflow."
+
+scoring:
+  weights:
+    vault-search: 0.15
+    duplicate-check: 0.10
+    architecture: 0.15
+    workflow: 0.20
+    validation: 0.40
+  formula: "weighted-sum"
+
+on-error:
+  default:
+    action: STOP
+    message: "Build flow encountered an error."
+    recovery: "Retry from the failed step."
+  max-retries: 2
+  escalation:
+    action: STOP
+    message: "Build flow failed after retries. Escalate to user."
+
+metadata:
+  author: soleri
+  domain: component-build
+  tags:
+    - build
+    - component
+    - vault-first

package/data/flows/deliver.flow.yaml

@@ -0,0 +1,110 @@
+# Deliver Feature Flow
+# Orchestrates delivery with validation, testing, performance, and delivery workflow.
+
+id: DELIVER-flow
+name: Deliver Feature
+description: >
+  Feature delivery workflow: validate code quality, check test coverage,
+  assess performance, then execute the delivery workflow.
+version: "1.0.0"
+
+on-missing-capability:
+  default: skip-with-warning
+  blocking: [vault.search]
+
+triggers:
+  modes:
+    - DELIVER
+    - ship
+  contexts:
+    - deploy
+    - release
+    - ship
+  min-confidence: HIGH
+
+steps:
+  - id: validate-code
+    name: Validate Code Quality
+    description: Run full code validation against design system rules and token usage.
+    needs: [component.validate, token.check, design.rules]
+    chains:
+      - validate-component
+      - validate-tokens
+      - design-rules-check
+    output:
+      - code-validation-result
+    gate:
+      type: GATE
+      condition: "pass == true"
+      on-false:
+        action: STOP
+        message: "Code validation failed. Fix issues before delivery."
+
+  - id: check-testing
+    name: Check Test Coverage
+    description: Verify that adequate tests exist and pass.
+    needs: [test.coverage]
+    chains:
+      - test-coverage-check
+    output:
+      - test-results
+    gate:
+      type: GATE
+      condition: "coverage >= 80"
+      on-false:
+        action: STOP
+        message: "Test coverage below threshold. Add tests before delivery."
+
+  - id: check-performance
+    name: Check Performance
+    description: Assess performance metrics against established baselines.
+    needs: [perf.audit]
+    chains:
+      - performance-audit
+    output:
+      - performance-results
+
+  - id: delivery-workflow
+    name: Execute Delivery Workflow
+    description: Run the delivery checklist and finalize for release.
+    needs: [deliver.checklist]
+    chains:
+      - delivery-checklist
+    output:
+      - delivery-status
+      - delivery-grade
+    gate:
+      type: SCORE
+      min: 85
+      grade-thresholds:
+        A: 95
+        B: 85
+        C: 75
+      on-false:
+        action: STOP
+        message: "Delivery score below threshold. Address issues before shipping."
+
+scoring:
+  weights:
+    code-validation: 0.30
+    testing: 0.25
+    performance: 0.20
+    delivery: 0.25
+  formula: "weighted-sum"
+
+on-error:
+  default:
+    action: STOP
+    message: "Delivery flow encountered an error. Do not proceed."
+  max-retries: 1
+  escalation:
+    action: STOP
+    message: "Delivery flow failed. Manual review required."
+
+metadata:
+  author: soleri
+  domain: delivery
+  tags:
+    - deliver
+    - ship
+    - release

package/data/flows/design.flow.yaml

@@ -0,0 +1,108 @@
+# Design System Recommendation Flow
+# Orchestrates design knowledge queries: style, palette, typography, and stack guidelines.
+
+id: DESIGN-flow
+name: Design System Recommendation
+description: >
+  Design workflow: search vault for existing design patterns, query Cognee knowledge graph
+  for curated design intelligence, then provide a full design system recommendation
+  (style + palette + typography + landing pattern + anti-patterns).
+version: "1.0.0"
+
+on-missing-capability:
+  default: skip-with-warning
+  blocking: [vault.search]
+
+triggers:
+  modes:
+    - DESIGN
+    - design-system
+  contexts:
+    - design
+    - style
+    - color
+    - typography
+    - theme
+  min-confidence: MEDIUM
+
+steps:
+  - id: search-vault-design
+    name: Search Vault Design Patterns
+    description: Search vault for existing design patterns, decisions, and anti-patterns related to the request.
+    needs: [vault.search, memory.search]
+    chains:
+      - vault-search
+      - memory-search
+    output:
+      - vault-patterns
+      - memory-hits
+
+  - id: search-cognee-design
+    name: Search Cognee Design Knowledge
+    description: Query the Cognee knowledge graph for curated design intelligence.
+    needs: [cognee.search]
+    chains:
+      - cognee-design-search
+    output:
+      - cognee-design-results
+
+  - id: recommend-design-system
+    name: Recommend Design System
+    description: >
+      Generate a full design system recommendation: UI style, color palette,
+      font pairing, landing page pattern, and anti-patterns to avoid.
+    needs: [design.recommend, design.style, design.palette, design.typography]
+    chains:
+      - recommend-design-system
+      - recommend-style
+      - recommend-palette
+      - recommend-typography
+    parallel: true
+    output:
+      - design-system-recommendation
+      - style-recommendation
+      - palette-recommendation
+      - typography-recommendation
+
+  - id: get-stack-guidelines
+    name: Get Stack Guidelines
+    description: Retrieve implementation guidelines for the target tech stack.
+    needs: [stack.guidelines]
+    chains:
+      - get-stack-guidelines
+    output:
+      - stack-guidelines
+
+  - id: brain-recommend
+    name: Brain Recommendations
+    description: Check brain for proven design patterns from previous sessions.
+    needs: [brain.recommend]
+    chains:
+      - brain-recommend
+    output:
+      - brain-recommendations
+
+scoring:
+  weights:
+    vault-search: 0.15
+    cognee-search: 0.10
+    design-system: 0.40
+    stack-guidelines: 0.15
+    brain-recommend: 0.20
+  formula: "weighted-sum"
+
+on-error:
+  default:
+    action: CONTINUE
+    message: "Design recommendation step encountered an error. Continuing with available data."
+  max-retries: 1
+
+metadata:
+  author: soleri
+  domain: design-system
+  tags:
+    - design
+    - style
+    - color
+    - typography
+    - vault-first

package/data/flows/enhance.flow.yaml

@@ -0,0 +1,90 @@
+# Enhance Feature Flow
+# Orchestrates feature improvement with vault knowledge and validation.
+
+id: ENHANCE-flow
+name: Enhance Feature
+description: >
+  Feature enhancement workflow: search vault for improvement patterns,
+  gather architecture guidance, then validate the enhancement.
+version: "1.0.0"
+
+on-missing-capability:
+  default: skip-with-warning
+  blocking: [vault.search]
+
+triggers:
+  modes:
+    - IMPROVE
+    - enhance
+  contexts:
+    - performance
+    - refactor
+    - improvement
+  min-confidence: MEDIUM
+
+steps:
+  - id: search-vault
+    name: Search Vault Patterns
+    description: Search vault for enhancement patterns, best practices, and previous improvements.
+    needs: [vault.search, memory.search]
+    chains:
+      - vault-search
+      - memory-search
+    output:
+      - vault-patterns
+      - memory-hits
+
+  - id: get-architecture
+    name: Get Architecture Guidance
+    description: Fetch architecture guidance and brain recommendations for the enhancement.
+    needs: [architecture.search, brain.recommend]
+    chains:
+      - architecture-search
+      - brain-recommend
+    parallel: true
+    output:
+      - architecture-patterns
+      - brain-recommendations
+
+  - id: validate
+    name: Validate Enhancement
+    description: Validate the enhanced code against design rules and quality standards.
+    needs: [component.validate, token.check]
+    chains:
+      - validate-component
+      - validate-tokens
+    output:
+      - validation-score
+    gate:
+      type: SCORE
+      min: 75
+      grade-thresholds:
+        A: 95
+        B: 85
+        C: 75
+      on-false:
+        action: BRANCH
+        goto: get-architecture
+        message: "Enhancement validation below threshold. Revisit architecture guidance."
+
+scoring:
+  weights:
+    vault-search: 0.20
+    architecture: 0.30
+    validation: 0.50
+  formula: "weighted-sum"
+
+on-error:
+  default:
+    action: STOP
+    message: "Enhancement flow encountered an error."
+    recovery: "Retry from the failed step."
+  max-retries: 2
+
+metadata:
+  author: soleri
+  domain: enhancement
+  tags:
+    - enhance
+    - improve
+    - refactor

package/data/flows/explore.flow.yaml

@@ -0,0 +1,84 @@
+# Explore Knowledge Flow
+# Orchestrates knowledge exploration across vault, memory, brain, and playbooks.
+
+id: EXPLORE-flow
+name: Explore Knowledge
+description: >
+  Knowledge exploration workflow: search vault patterns, cross-project memory,
+  brain pattern strengths, and playbooks to surface all relevant knowledge.
+version: "1.0.0"
+
+on-missing-capability:
+  default: skip-with-warning
+  blocking: [vault.search]
+
+triggers:
+  modes:
+    - EXPLORE
+    - research
+  contexts:
+    - knowledge
+    - learning
+    - discovery
+  min-confidence: LOW
+
+steps:
+  - id: search-vault
+    name: Search Vault Patterns
+    description: Search vault for patterns, anti-patterns, and domain knowledge.
+    needs: [vault.search]
+    chains:
+      - vault-search
+    output:
+      - vault-patterns
+
+  - id: search-memory
+    name: Search Cross-Project Memory
+    description: Search memory for cross-project knowledge and historical context.
+    needs: [memory.search]
+    chains:
+      - memory-search
+    output:
+      - memory-hits
+
+  - id: check-brain
+    name: Check Brain Patterns
+    description: Query brain for pattern strengths and recommendations.
+    needs: [brain.strengths, brain.recommend]
+    chains:
+      - brain-strengths
+      - brain-recommend
+    output:
+      - brain-patterns
+      - brain-recommendations
+
+  - id: check-playbooks
+    name: Check Playbooks
+    description: Search playbooks for operational runbooks and guides.
+    needs: [vault.playbook]
+    chains:
+      - playbook-search
+    output:
+      - playbook-results
+
+scoring:
+  weights:
+    vault-search: 0.30
+    memory-search: 0.25
+    brain-check: 0.25
+    playbook-check: 0.20
+  formula: "weighted-sum"
+
+on-error:
+  default:
+    action: CONTINUE
+    message: "Exploration step failed; continuing with remaining sources."
+  max-retries: 1
+
+metadata:
+  author: soleri
+  domain: knowledge
+  tags:
+    - explore
+    - knowledge
+    - research

package/data/flows/fix.flow.yaml

@@ -0,0 +1,90 @@
+# Fix Issue Flow
+# Orchestrates bug fixing with anti-pattern awareness and validation.
+
+id: FIX-flow
+name: Fix Issue
+description: >
+  Issue fix workflow: search for known anti-patterns, gather error patterns
+  in parallel, then validate the fix.
+version: "1.0.0"
+
+on-missing-capability:
+  default: skip-with-warning
+  blocking: [vault.search]
+
+triggers:
+  modes:
+    - FIX
+    - bug-fix
+  contexts:
+    - bug
+    - error
+    - regression
+  min-confidence: MEDIUM
+
+steps:
+  - id: search-anti-patterns
+    name: Search Anti-Patterns
+    description: Search vault for known anti-patterns related to the reported issue.
+    needs: [vault.search, memory.search]
+    chains:
+      - vault-search-antipatterns
+      - memory-search
+    output:
+      - anti-patterns
+      - memory-hits
+
+  - id: get-error-patterns
+    name: Get Error Patterns
+    description: Gather error patterns and brain insights in parallel.
+    needs: [debug.patterns, brain.recommend]
+    chains:
+      - error-pattern-search
+      - brain-recommend
+    parallel: true
+    output:
+      - error-patterns
+      - brain-recommendations
+
+  - id: validate
+    name: Validate Fix
+    description: Validate the fix against design rules and run relevant checks.
+    needs: [component.validate, token.check]
+    chains:
+      - validate-component
+      - validate-tokens
+    output:
+      - validation-score
+    gate:
+      type: SCORE
+      min: 70
+      grade-thresholds:
+        A: 95
+        B: 80
+        C: 70
+      on-false:
+        action: BRANCH
+        goto: search-anti-patterns
+        message: "Fix validation below threshold. Re-examine anti-patterns."
+
+scoring:
+  weights:
+    anti-pattern-search: 0.25
+    error-patterns: 0.25
+    validation: 0.50
+  formula: "weighted-sum"
+
+on-error:
+  default:
+    action: STOP
+    message: "Fix flow encountered an error."
+    recovery: "Retry from the failed step."
+  max-retries: 2
+
+metadata:
+  author: soleri
+  domain: bug-fix
+  tags:
+    - fix
+    - bug
+    - anti-pattern

package/data/flows/plan.flow.yaml

@@ -0,0 +1,87 @@
+# Plan Feature Flow
+# Orchestrates feature planning with vault-first knowledge and checkpoint gate.
+
+id: PLAN-flow
+name: Plan Feature
+description: >
+  Feature planning workflow: search vault for prior art, brainstorm design
+  approaches, then create a structured plan with a checkpoint gate for approval.
+version: "1.0.0"
+
+on-missing-capability:
+  default: skip-with-warning
+  blocking: [vault.search]
+
+triggers:
+  modes:
+    - PLAN
+    - plan-iteration
+  contexts:
+    - feature
+    - architecture
+    - design
+  min-confidence: MEDIUM
+
+steps:
+  - id: search-vault
+    name: Search Vault Knowledge
+    description: Search vault for patterns, anti-patterns, and previous plans related to the feature.
+    needs: [vault.search, memory.search]
+    chains:
+      - vault-search
+      - memory-search
+    output:
+      - vault-patterns
+      - memory-hits
+
+  - id: brainstorm
+    name: Brainstorm Approaches
+    description: Generate design approaches informed by vault knowledge and brain recommendations.
+    needs: [brain.recommend, architecture.search]
+    chains:
+      - brain-recommend
+      - architecture-search
+    output:
+      - brainstorm-options
+      - architecture-guidance
+
+  - id: create-plan
+    name: Create Plan
+    description: Produce a structured implementation plan and present it for approval.
+    needs: [plan.create]
+    chains:
+      - plan-create
+    output:
+      - plan-document
+      - plan-grade
+    gate:
+      type: CHECKPOINT
+      condition: "grade >= 'B'"
+      save:
+        - plan-document
+        - vault-patterns
+      on-false:
+        action: BRANCH
+        goto: brainstorm
+        message: "Plan did not meet quality threshold. Re-brainstorm."
+
+scoring:
+  weights:
+    vault-search: 0.20
+    brainstorm: 0.30
+    plan-creation: 0.50
+  formula: "weighted-sum"
+
+on-error:
+  default:
+    action: STOP
+    message: "Planning flow encountered an error."
+  max-retries: 1
+
+metadata:
+  author: soleri
+  domain: planning
+  tags:
+    - plan
+    - architecture
+    - vault-first