aios-core 2.3.1 → 3.1.0

package/.aios-core/development/tasks/squad-creator-sync-synkra.md

@@ -0,0 +1,83 @@
+---
+task: Sync Squad to Synkra
+responsavel: "@squad-creator"
+responsavel_type: agent
+atomic_layer: task
+status: placeholder
+sprint: 8
+Entrada: |
+  - name: Nome do squad para sincronizar
+  - pricing: Modelo de preco (free | premium | subscription)
+Saida: |
+  - api_url: URL na Synkra API
+  - dashboard_url: URL do dashboard de gestao
+  - status: Sucesso ou erro
+Checklist:
+  - "[ ] Implementar em Sprint 8 (SQS-5)"
+---
+
+# *sync-squad-synkra
+
+> **PLACEHOLDER** - Implementation scheduled for Sprint 8 (Story SQS-5)
+
+## Planned Functionality
+
+Syncs a local squad to the Synkra API marketplace for distribution and monetization.
+
+## Planned Usage
+
+```bash
+@squad-creator
+
+*sync-squad-synkra meu-squad
+# → Syncs to api.synkra.dev/squads (free tier)
+
+*sync-squad-synkra meu-squad --pricing premium --price 9.99
+# → Syncs as premium squad with pricing
+
+*sync-squad-synkra meu-squad --update
+# → Updates existing squad in marketplace
+```
+
+## Planned Features
+
+1. **Authentication**
+   - Require Synkra API key
+   - Validate account permissions
+   - Support team accounts
+
+2. **Pricing Models**
+   - Free: Available to all users
+   - Premium: One-time purchase
+   - Subscription: Monthly/yearly
+
+3. **Version Management**
+   - Semantic versioning
+   - Changelog generation
+   - Update existing squads
+
+4. **Analytics Dashboard**
+   - Download statistics
+   - Revenue tracking (for paid)
+   - User feedback
+
+## Synkra API Endpoints
+
+```http
+POST   /api/v1/squads           # Create new squad
+PUT    /api/v1/squads/{id}      # Update existing
+GET    /api/v1/squads/{id}      # Get squad info
+DELETE /api/v1/squads/{id}      # Remove squad
+GET    /api/v1/squads/me        # List my squads
+```
+
+## Related Story
+
+- **SQS-5:** SquadSyncService (Sprint 8)
+
+## Current Status
+
+This task is a placeholder. The full implementation will be done in Sprint 8.
+
+The Synkra API is under development at:
+- https://api.synkra.dev (planned)

package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml

@@ -88,6 +88,47 @@ deployment:
       staging: ["staging", "needs-review"]
       production: ["production", "promotion"]
 
+# =============================================================================
+# GITHUB INTEGRATION
+# Pull Request and semantic-release configuration
+# =============================================================================
+github:
+  enabled: true
+  cli_required: false
+
+  # Pull Request Configuration
+  # Controls how @devops *create-pr generates PR titles
+  pr:
+    # Title format options:
+    # - "conventional": For semantic-release (feat: description [Story X.Y])
+    # - "story-first": Simple format ([Story X.Y] Description) - DEFAULT
+    # - "branch-based": Just branch name as title
+    title_format: {{PR_TITLE_FORMAT}}
+
+    include_story_id: true
+
+    # Only used when title_format: conventional
+    conventional_commits:
+      enabled: {{CONVENTIONAL_COMMITS_ENABLED}}
+      branch_type_map:
+        feature/: feat
+        feat/: feat
+        fix/: fix
+        bugfix/: fix
+        hotfix/: fix
+        docs/: docs
+        chore/: chore
+        refactor/: refactor
+        test/: test
+      default_type: feat
+
+    auto_assign_reviewers: false
+    draft_by_default: false
+
+  # Semantic Release (only for NPM packages)
+  semantic_release:
+    enabled: {{SEMANTIC_RELEASE_ENABLED}}
+
 # =============================================================================
 # AGENT CONFIGURATION
 # Agent-specific settings

package/.aios-core/schemas/squad-design-schema.json

@@ -0,0 +1,299 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://synkra.dev/schemas/squad-design.json",
+  "title": "Squad Design Blueprint",
+  "description": "Schema for squad design blueprints generated by *design-squad",
+  "type": "object",
+  "required": ["squad", "recommendations", "metadata"],
+  "properties": {
+    "squad": {
+      "type": "object",
+      "description": "Basic squad information",
+      "required": ["name", "domain"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9](-squad)?$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Squad name in kebab-case"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 500,
+          "description": "Human-readable description of the squad"
+        },
+        "domain": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 50,
+          "description": "Domain identifier in kebab-case"
+        }
+      }
+    },
+    "analysis": {
+      "type": "object",
+      "description": "Domain analysis results",
+      "properties": {
+        "entities": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 50,
+          "description": "Extracted domain entities"
+        },
+        "workflows": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+            "minLength": 2,
+            "maxLength": 100
+          },
+          "maxItems": 50,
+          "description": "Identified workflows in kebab-case"
+        },
+        "integrations": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 30,
+          "description": "External integrations detected"
+        },
+        "stakeholders": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Stakeholder roles identified"
+        }
+      }
+    },
+    "recommendations": {
+      "type": "object",
+      "description": "Generated recommendations",
+      "required": ["agents", "tasks"],
+      "properties": {
+        "agents": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/agentRecommendation"
+          },
+          "minItems": 0,
+          "maxItems": 10,
+          "description": "Recommended agents"
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/taskRecommendation"
+          },
+          "minItems": 0,
+          "maxItems": 50,
+          "description": "Recommended tasks"
+        },
+        "template": {
+          "type": "string",
+          "enum": ["basic", "etl", "agent-only", "custom"],
+          "default": "basic",
+          "description": "Recommended squad template"
+        },
+        "config_mode": {
+          "type": "string",
+          "enum": ["extend", "override", "none"],
+          "default": "extend",
+          "description": "Configuration inheritance mode"
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Blueprint metadata",
+      "required": ["created_at"],
+      "properties": {
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of blueprint creation"
+        },
+        "source_docs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Paths to source documentation files"
+        },
+        "user_adjustments": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0,
+          "description": "Number of user modifications made"
+        },
+        "overall_confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Overall confidence score (0-1)"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "agentRecommendation": {
+      "type": "object",
+      "required": ["id", "role", "confidence"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Agent identifier in kebab-case"
+        },
+        "role": {
+          "type": "string",
+          "minLength": 5,
+          "maxLength": 200,
+          "description": "Agent role description"
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+            "minLength": 2,
+            "maxLength": 64
+          },
+          "maxItems": 20,
+          "description": "Agent commands in kebab-case"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Recommendation confidence score (0-1)"
+        },
+        "user_added": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this agent was added by user"
+        },
+        "user_modified": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this agent was modified by user"
+        }
+      }
+    },
+    "taskRecommendation": {
+      "type": "object",
+      "required": ["name", "agent", "confidence"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Task name in kebab-case (without .md extension)"
+        },
+        "agent": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
+          "minLength": 2,
+          "maxLength": 64,
+          "description": "Owning agent identifier"
+        },
+        "entrada": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Task input parameters"
+        },
+        "saida": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 100
+          },
+          "maxItems": 20,
+          "description": "Task output parameters"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Recommendation confidence score (0-1)"
+        },
+        "checklist": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "maxItems": 20,
+          "description": "Task checklist items"
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "squad": {
+        "name": "order-management-squad",
+        "description": "Squad for order management system",
+        "domain": "order-management"
+      },
+      "analysis": {
+        "entities": ["Order", "Customer", "Product", "Payment"],
+        "workflows": ["create-order", "process-payment", "ship-order"],
+        "integrations": ["Stripe API", "Inventory Service"],
+        "stakeholders": ["Customer", "Admin", "Support"]
+      },
+      "recommendations": {
+        "agents": [
+          {
+            "id": "order-manager",
+            "role": "Manages order lifecycle from creation to fulfillment",
+            "commands": ["create-order", "update-order", "cancel-order"],
+            "confidence": 0.92,
+            "user_added": false,
+            "user_modified": false
+          }
+        ],
+        "tasks": [
+          {
+            "name": "create-order",
+            "agent": "order-manager",
+            "entrada": ["customer_id", "items", "payment_method"],
+            "saida": ["order_id", "status"],
+            "confidence": 0.88
+          }
+        ],
+        "template": "basic",
+        "config_mode": "extend"
+      },
+      "metadata": {
+        "created_at": "2025-12-18T00:00:00Z",
+        "source_docs": ["./docs/prd/orders.md"],
+        "user_adjustments": 2,
+        "overall_confidence": 0.87
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "2.3.1",
+  "version": "3.1.0",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",

package/squads/.designs/duplicate-test-design.yaml

@@ -0,0 +1,23 @@
+# Squad Design Blueprint
+# Generated by *design-squad
+# Source: Interactive input
+# Created: 2025-12-18T23:01:55.322Z
+
+squad:
+  name: duplicate-test
+  domain: test
+analysis:
+  entities: []
+  workflows: []
+  integrations: []
+  stakeholders: []
+recommendations:
+  agents: []
+  tasks: []
+  template: basic
+  config_mode: extend
+metadata:
+  created_at: '2025-12-18T23:01:55.322Z'
+  source_docs: []
+  user_adjustments: 0
+  overall_confidence: 0.5

package/squads/.designs/force-test-design.yaml

@@ -0,0 +1,23 @@
+# Squad Design Blueprint
+# Generated by *design-squad
+# Source: Interactive input
+# Created: 2025-12-18T23:01:55.323Z
+
+squad:
+  name: force-test
+  domain: test-v1
+analysis:
+  entities: []
+  workflows: []
+  integrations: []
+  stakeholders: []
+recommendations:
+  agents: []
+  tasks: []
+  template: basic
+  config_mode: extend
+metadata:
+  created_at: '2025-12-18T23:01:55.323Z'
+  source_docs: []
+  user_adjustments: 0
+  overall_confidence: 0.5

package/squads/.designs/nested-test-design.yaml

@@ -0,0 +1,23 @@
+# Squad Design Blueprint
+# Generated by *design-squad
+# Source: Interactive input
+# Created: 2025-12-18T23:01:55.321Z
+
+squad:
+  name: nested-test
+  domain: test
+analysis:
+  entities: []
+  workflows: []
+  integrations: []
+  stakeholders: []
+recommendations:
+  agents: []
+  tasks: []
+  template: basic
+  config_mode: extend
+metadata:
+  created_at: '2025-12-18T23:01:55.321Z'
+  source_docs: []
+  user_adjustments: 0
+  overall_confidence: 0.5

package/squads/.designs/test-squad-design.yaml

@@ -0,0 +1,23 @@
+# Squad Design Blueprint
+# Generated by *design-squad
+# Source: Interactive input
+# Created: 2025-12-18T23:01:55.317Z
+
+squad:
+  name: test-squad
+  domain: test-domain
+analysis:
+  entities: []
+  workflows: []
+  integrations: []
+  stakeholders: []
+recommendations:
+  agents: []
+  tasks: []
+  template: basic
+  config_mode: extend
+metadata:
+  created_at: '2025-12-18T23:01:55.317Z'
+  source_docs: []
+  user_adjustments: 0
+  overall_confidence: 0.5