aios-core 3.0.0 → 3.1.0

package/.aios-core/development/tasks/squad-creator-list.md

@@ -0,0 +1,225 @@
+---
+task: List Squads
+responsavel: "@squad-creator"
+responsavel_type: agent
+atomic_layer: task
+Entrada: |
+  - path: Caminho alternativo (opcional, default: ./squads)
+  - format: Formato de output (table | json | yaml)
+Saida: |
+  - squads: Lista de squads encontrados
+  - count: Numero total de squads
+Checklist:
+  - "[ ] Usar squad-generator.listLocal()"
+  - "[ ] Formatar output conforme format"
+  - "[ ] Exibir informacoes basicas de cada squad"
+---
+
+# *list-squads
+
+Lista todos os squads locais do projeto.
+
+## Uso
+
+```
+@squad-creator
+*list-squads
+*list-squads --format json
+*list-squads --path ./custom-squads
+```
+
+## Parametros
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `--path` | string | ./squads | Path to squads directory |
+| `--format` | string | table | Output format: table, json, yaml |
+| `--include-invalid` | flag | false | Include squads without valid manifest |
+
+## Output Exemplo (Table)
+
+```
+Local Squads (./squads/)
+
+┌─────────────────────┬─────────┬─────────────────────────────┬────────┐
+│ Name                │ Version │ Description                 │ Status │
+├─────────────────────┼─────────┼─────────────────────────────┼────────┤
+│ meu-dominio-squad   │ 1.0.0   │ Squad para automacao de X   │ ✅     │
+│ outro-squad         │ 2.1.0   │ Outro squad customizado     │ ✅     │
+│ legacy-pack         │ 1.0.0   │ Using config.yaml           │ ⚠️     │
+└─────────────────────┴─────────┴─────────────────────────────┴────────┘
+
+Total: 3 squads (2 valid, 1 deprecated)
+```
+
+## Output Exemplo (JSON)
+
+```json
+{
+  "squads": [
+    {
+      "name": "meu-dominio-squad",
+      "version": "1.0.0",
+      "description": "Squad para automacao de X",
+      "path": "./squads/meu-dominio-squad",
+      "status": "valid"
+    },
+    {
+      "name": "outro-squad",
+      "version": "2.1.0",
+      "description": "Outro squad customizado",
+      "path": "./squads/outro-squad",
+      "status": "valid"
+    }
+  ],
+  "count": 2,
+  "path": "./squads"
+}
+```
+
+## Output Exemplo (YAML)
+
+```yaml
+squads:
+  - name: meu-dominio-squad
+    version: 1.0.0
+    description: Squad para automacao de X
+    path: ./squads/meu-dominio-squad
+    status: valid
+  - name: outro-squad
+    version: 2.1.0
+    description: Outro squad customizado
+    path: ./squads/outro-squad
+    status: valid
+count: 2
+path: ./squads
+```
+
+## Status Indicators
+
+| Status | Icon | Description |
+|--------|------|-------------|
+| valid | ✅ | Valid squad.yaml manifest |
+| deprecated | ⚠️ | Using config.yaml (deprecated) |
+| invalid | ❌ | No manifest found |
+
+## Flow
+
+```
+1. Parse arguments
+   ├── Get path (default: ./squads)
+   └── Get format (default: table)
+
+2. List squads
+   ├── Call SquadGenerator.listLocal()
+   └── Get array of squad info
+
+3. Filter results
+   ├── If --include-invalid → show all
+   └── If not → filter out invalid
+
+4. Format output
+   ├── If table → format as ASCII table
+   ├── If json → JSON.stringify
+   └── If yaml → yaml.dump
+
+5. Display result
+   └── Output formatted list
+```
+
+## Implementation
+
+```javascript
+const { SquadGenerator } = require('./.aios-core/development/scripts/squad');
+
+async function listSquads(options) {
+  const { path: squadsPath, format, includeInvalid } = options;
+
+  // List local squads
+  const generator = new SquadGenerator({ squadsPath });
+  let squads = await generator.listLocal();
+
+  // Filter if needed
+  if (!includeInvalid) {
+    squads = squads.filter(s => !s.invalid);
+  }
+
+  // Format output
+  switch (format) {
+    case 'json':
+      return JSON.stringify({ squads, count: squads.length, path: squadsPath }, null, 2);
+
+    case 'yaml':
+      return formatYaml({ squads, count: squads.length, path: squadsPath });
+
+    case 'table':
+    default:
+      return formatTable(squads, squadsPath);
+  }
+}
+
+function formatTable(squads, squadsPath) {
+  if (squads.length === 0) {
+    return `No squads found in ${squadsPath}/\n\nCreate one with: @squad-creator *create-squad my-squad`;
+  }
+
+  let output = `Local Squads (${squadsPath}/)\n\n`;
+
+  // Header
+  output += '┌' + '─'.repeat(22) + '┬' + '─'.repeat(9) + '┬' + '─'.repeat(30) + '┬' + '─'.repeat(8) + '┐\n';
+  output += '│ Name                 │ Version │ Description                  │ Status │\n';
+  output += '├' + '─'.repeat(22) + '┼' + '─'.repeat(9) + '┼' + '─'.repeat(30) + '┼' + '─'.repeat(8) + '┤\n';
+
+  // Rows
+  for (const squad of squads) {
+    const name = squad.name.padEnd(20).substring(0, 20);
+    const version = squad.version.padEnd(7).substring(0, 7);
+    const desc = (squad.description || '').padEnd(28).substring(0, 28);
+    const status = squad.invalid ? '❌' : squad.deprecated ? '⚠️' : '✅';
+    output += `│ ${name} │ ${version} │ ${desc} │ ${status}     │\n`;
+  }
+
+  output += '└' + '─'.repeat(22) + '┴' + '─'.repeat(9) + '┴' + '─'.repeat(30) + '┴' + '─'.repeat(8) + '┘\n';
+
+  // Summary
+  const valid = squads.filter(s => !s.invalid && !s.deprecated).length;
+  const deprecated = squads.filter(s => s.deprecated).length;
+  const invalid = squads.filter(s => s.invalid).length;
+
+  output += `\nTotal: ${squads.length} squads`;
+  if (deprecated > 0 || invalid > 0) {
+    output += ` (${valid} valid`;
+    if (deprecated > 0) output += `, ${deprecated} deprecated`;
+    if (invalid > 0) output += `, ${invalid} invalid`;
+    output += ')';
+  }
+
+  return output;
+}
+```
+
+## Empty State
+
+When no squads are found:
+
+```
+No squads found in ./squads/
+
+Create one with: @squad-creator *create-squad my-squad
+
+Or download a public squad: @squad-creator *download-squad squad-name
+```
+
+## Error Handling
+
+| Error | Cause | Resolution |
+|-------|-------|------------|
+| `ENOENT` | Squads directory doesn't exist | Will return empty list |
+| `PERMISSION_DENIED` | Can't read directory | Check permissions |
+
+## Related
+
+- **Agent:** @squad-creator (Craft)
+- **Script:** squad-generator.js (listLocal method)
+- **Create:** *create-squad
+- **Validate:** *validate-squad

package/.aios-core/development/tasks/squad-creator-publish.md

@@ -0,0 +1,86 @@
+---
+task: Publish Squad
+responsavel: "@squad-creator"
+responsavel_type: agent
+atomic_layer: task
+status: placeholder
+sprint: 8
+Entrada: |
+  - name: Nome do squad para publicar
+  - target: Destino (aios-squads | synkra-api)
+Saida: |
+  - pr_url: URL do PR criado (para aios-squads)
+  - api_url: URL na API (para synkra-api)
+  - status: Sucesso ou erro
+Checklist:
+  - "[ ] Implementar em Sprint 8 (SQS-6)"
+---
+
+# *publish-squad
+
+> **PLACEHOLDER** - Implementation scheduled for Sprint 8 (Story SQS-6)
+
+## Planned Functionality
+
+Publishes a local squad to the aios-squads repository (via PR) or Synkra API marketplace.
+
+## Planned Usage
+
+```
+@squad-creator
+
+*publish-squad meu-squad
+# → Creates PR to github.com/SynkraAI/aios-squads
+
+*publish-squad meu-squad --target synkra-api
+# → Publishes to api.synkra.dev/squads (requires auth)
+```
+
+## Planned Features
+
+1. **Pre-publish Validation**
+   - Run *validate-squad before publishing
+   - Check required fields in squad.yaml
+   - Verify license and author info
+
+2. **GitHub Repository (Default)**
+   - Fork aios-squads if needed
+   - Copy squad to squads/{name}/
+   - Create PR with description
+   - Add appropriate labels
+
+3. **Synkra API**
+   - Upload to api.synkra.dev/squads
+   - Support pricing configuration
+   - Manage versions and updates
+
+## Workflow
+
+```
+1. Validate squad
+   ├── Run *validate-squad
+   └── Ensure no errors
+
+2. Prepare for publishing
+   ├── Check license
+   ├── Check author
+   └── Generate changelog
+
+3. Publish
+   ├── If aios-squads → Create PR
+   └── If synkra-api → Upload via API
+
+4. Display result
+   └── Show URL and next steps
+```
+
+## Related Story
+
+- **SQS-6:** Registry Integration (Sprint 8)
+
+## Current Status
+
+This task is a placeholder. The full implementation will be done in Sprint 8.
+
+For now, manually create PRs at:
+- https://github.com/SynkraAI/aios-squads

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/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": "3.0.0",
+  "version": "3.1.0",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",