aios-core 4.2.15 → 4.4.0

package/.aios-core/product/templates/epic.hbs

@@ -1,212 +1,212 @@
----
-template_id: epic
-template_name: Epic
-version: 1.0
-variables:
-  - name: id
-    type: string
-    required: true
-    prompt: "Epic ID (e.g., EPIC-S3):"
-  - name: title
-    type: string
-    required: true
-    prompt: "Epic title:"
-  - name: status
-    type: choice
-    required: true
-    choices: [Planning, In Progress, Completed, On Hold, Cancelled]
-    default: Planning
-  - name: owner
-    type: string
-    required: true
-    prompt: "Epic owner:"
-  - name: objective
-    type: text
-    required: true
-    prompt: "What is the epic's main objective?"
----
-
-# {{id}}: {{title}}
-
-**Status:** {{#ifEqual status "Planning"}}📋{{/ifEqual}}{{#ifEqual status "In Progress"}}🔄{{/ifEqual}}{{#ifEqual status "Completed"}}✅{{/ifEqual}}{{#ifEqual status "On Hold"}}⏸️{{/ifEqual}}{{#ifEqual status "Cancelled"}}❌{{/ifEqual}} {{status}}
-**Owner:** {{owner}}
-**Created:** {{formatDate now "YYYY-MM-DD"}}
-{{#if updated}}**Updated:** {{updated}}{{/if}}
-
----
-
-## Objective
-
-{{objective}}
-
-{{#if businessValue}}
-## Business Value
-
-{{businessValue}}
-{{/if}}
-
----
-
-{{#if stakeholders}}
-## Stakeholders
-
-{{#each stakeholders}}
-- {{this}}
-{{/each}}
-{{/if}}
-
----
-
-## Scope
-
-{{#if scope}}
-### In Scope
-{{#each scope.inScope}}
-- {{this}}
-{{/each}}
-
-{{#if scope.outOfScope}}
-### Out of Scope
-{{#each scope.outOfScope}}
-- {{this}}
-{{/each}}
-{{/if}}
-{{else}}
-_Scope to be defined._
-{{/if}}
-
----
-
-## Stories
-
-{{#if stories}}
-| ID | Title | Points | Priority | Status |
-|----|-------|--------|----------|--------|
-{{#each stories}}
-| [{{this.id}}](./stories/story-{{this.id}}.md) | {{this.title}} | {{default this.points "-"}} | {{default this.priority "Medium"}} | {{default this.status "Draft"}} |
-{{/each}}
-
-**Total Points:** {{#if progress}}{{progress.totalPoints}}{{else}}_TBD_{{/if}}
-{{else}}
-_Stories to be defined._
-{{/if}}
-
----
-
-{{#if sprints}}
-## Sprint Planning
-
-{{#each sprints}}
-### Sprint {{this.number}}
-{{#if this.goal}}**Goal:** {{this.goal}}{{/if}}
-
-{{#if this.stories}}
-**Stories:**
-{{#each this.stories}}
-- {{this}}
-{{/each}}
-{{/if}}
-
-{{/each}}
-{{/if}}
-
----
-
-## Success Criteria
-
-{{#if successCriteria}}
-{{#each successCriteria}}
-- [ ] {{this.criteria}}{{#if this.metric}} ({{this.metric}}: {{this.target}}){{/if}}
-{{/each}}
-{{else}}
-_Success criteria to be defined._
-{{/if}}
-
----
-
-## Technical Requirements
-
-{{#if technicalRequirements}}
-{{#each technicalRequirements}}
-- {{this}}
-{{/each}}
-{{else}}
-_Technical requirements to be defined._
-{{/if}}
-
----
-
-## Risks
-
-{{#if risks}}
-| Risk | Impact | Mitigation |
-|------|--------|------------|
-{{#each risks}}
-| {{this.risk}} | {{default this.impact "Medium"}} | {{default this.mitigation "TBD"}} |
-{{/each}}
-{{else}}
-_No risks identified._
-{{/if}}
-
----
-
-## Dependencies
-
-{{#if dependencies}}
-**Depends on:**
-{{#each dependencies.dependsOn}}
-- {{this}}
-{{/each}}
-
-{{#if dependencies.blocks}}
-**Blocks:**
-{{#each dependencies.blocks}}
-- {{this}}
-{{/each}}
-{{/if}}
-{{else}}
-_No dependencies._
-{{/if}}
-
----
-
-## Documentation
-
-{{#if documentation}}
-| Type | Location | Status |
-|------|----------|--------|
-{{#each documentation}}
-| {{this.type}} | {{this.location}} | {{default this.status "Pending"}} |
-{{/each}}
-{{else}}
-_Documentation requirements to be defined._
-{{/if}}
-
----
-
-## Progress
-
-{{#if progress}}
-- **Total Points:** {{progress.totalPoints}}
-- **Completed Points:** {{progress.completedPoints}}
-- **Progress:** {{progress.percentComplete}}%
-
-```
-[{{#times 10}}{{#if (lt @index (divide ../progress.percentComplete 10))}}█{{else}}░{{/if}}{{/times}}] {{progress.percentComplete}}%
-```
-{{else}}
-_Progress tracking to be updated._
-{{/if}}
-
----
-
-## Change Log
-
-| Date | Version | Description | Author |
-|------|---------|-------------|--------|
-| {{formatDate now "YYYY-MM-DD"}} | 1.0 | Epic created | AIOS Template Engine |
-
----
-
-**Generated by:** AIOS Template Engine v2.0
-**Template Version:** epic-1.0
+---
+template_id: epic
+template_name: Epic
+version: 1.0
+variables:
+  - name: id
+    type: string
+    required: true
+    prompt: "Epic ID (e.g., EPIC-S3):"
+  - name: title
+    type: string
+    required: true
+    prompt: "Epic title:"
+  - name: status
+    type: choice
+    required: true
+    choices: [Planning, In Progress, Completed, On Hold, Cancelled]
+    default: Planning
+  - name: owner
+    type: string
+    required: true
+    prompt: "Epic owner:"
+  - name: objective
+    type: text
+    required: true
+    prompt: "What is the epic's main objective?"
+---
+
+# {{id}}: {{title}}
+
+**Status:** {{#ifEqual status "Planning"}}📋{{/ifEqual}}{{#ifEqual status "In Progress"}}🔄{{/ifEqual}}{{#ifEqual status "Completed"}}✅{{/ifEqual}}{{#ifEqual status "On Hold"}}⏸️{{/ifEqual}}{{#ifEqual status "Cancelled"}}❌{{/ifEqual}} {{status}}
+**Owner:** {{owner}}
+**Created:** {{formatDate now "YYYY-MM-DD"}}
+{{#if updated}}**Updated:** {{updated}}{{/if}}
+
+---
+
+## Objective
+
+{{objective}}
+
+{{#if businessValue}}
+## Business Value
+
+{{businessValue}}
+{{/if}}
+
+---
+
+{{#if stakeholders}}
+## Stakeholders
+
+{{#each stakeholders}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+## Scope
+
+{{#if scope}}
+### In Scope
+{{#each scope.inScope}}
+- {{this}}
+{{/each}}
+
+{{#if scope.outOfScope}}
+### Out of Scope
+{{#each scope.outOfScope}}
+- {{this}}
+{{/each}}
+{{/if}}
+{{else}}
+_Scope to be defined._
+{{/if}}
+
+---
+
+## Stories
+
+{{#if stories}}
+| ID | Title | Points | Priority | Status |
+|----|-------|--------|----------|--------|
+{{#each stories}}
+| [{{this.id}}](./stories/story-{{this.id}}.md) | {{this.title}} | {{default this.points "-"}} | {{default this.priority "Medium"}} | {{default this.status "Draft"}} |
+{{/each}}
+
+**Total Points:** {{#if progress}}{{progress.totalPoints}}{{else}}_TBD_{{/if}}
+{{else}}
+_Stories to be defined._
+{{/if}}
+
+---
+
+{{#if sprints}}
+## Sprint Planning
+
+{{#each sprints}}
+### Sprint {{this.number}}
+{{#if this.goal}}**Goal:** {{this.goal}}{{/if}}
+
+{{#if this.stories}}
+**Stories:**
+{{#each this.stories}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+---
+
+## Success Criteria
+
+{{#if successCriteria}}
+{{#each successCriteria}}
+- [ ] {{this.criteria}}{{#if this.metric}} ({{this.metric}}: {{this.target}}){{/if}}
+{{/each}}
+{{else}}
+_Success criteria to be defined._
+{{/if}}
+
+---
+
+## Technical Requirements
+
+{{#if technicalRequirements}}
+{{#each technicalRequirements}}
+- {{this}}
+{{/each}}
+{{else}}
+_Technical requirements to be defined._
+{{/if}}
+
+---
+
+## Risks
+
+{{#if risks}}
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+{{#each risks}}
+| {{this.risk}} | {{default this.impact "Medium"}} | {{default this.mitigation "TBD"}} |
+{{/each}}
+{{else}}
+_No risks identified._
+{{/if}}
+
+---
+
+## Dependencies
+
+{{#if dependencies}}
+**Depends on:**
+{{#each dependencies.dependsOn}}
+- {{this}}
+{{/each}}
+
+{{#if dependencies.blocks}}
+**Blocks:**
+{{#each dependencies.blocks}}
+- {{this}}
+{{/each}}
+{{/if}}
+{{else}}
+_No dependencies._
+{{/if}}
+
+---
+
+## Documentation
+
+{{#if documentation}}
+| Type | Location | Status |
+|------|----------|--------|
+{{#each documentation}}
+| {{this.type}} | {{this.location}} | {{default this.status "Pending"}} |
+{{/each}}
+{{else}}
+_Documentation requirements to be defined._
+{{/if}}
+
+---
+
+## Progress
+
+{{#if progress}}
+- **Total Points:** {{progress.totalPoints}}
+- **Completed Points:** {{progress.completedPoints}}
+- **Progress:** {{progress.percentComplete}}%
+
+```
+[{{#times 10}}{{#if (lt @index (divide ../progress.percentComplete 10))}}█{{else}}░{{/if}}{{/times}}] {{progress.percentComplete}}%
+```
+{{else}}
+_Progress tracking to be updated._
+{{/if}}
+
+---
+
+## Change Log
+
+| Date | Version | Description | Author |
+|------|---------|-------------|--------|
+| {{formatDate now "YYYY-MM-DD"}} | 1.0 | Epic created | AIOS Template Engine |
+
+---
+
+**Generated by:** AIOS Template Engine v2.0
+**Template Version:** epic-1.0

package/.aios-core/product/templates/ide-rules/claude-rules.md

@@ -8,6 +8,54 @@ You are working with Synkra AIOS, an AI-Orchestrated System for Full Stack Devel
 Synkra AIOS is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
 <!-- AIOS-MANAGED-END: core-framework -->
 
+<!-- AIOS-MANAGED-START: constitution -->
+## Constitution
+
+O AIOS possui uma **Constitution formal** com princípios inegociáveis e gates automáticos.
+
+**Documento completo:** `.aios-core/constitution.md`
+
+**Princípios fundamentais:**
+
+| Artigo | Princípio | Severidade |
+|--------|-----------|------------|
+| I | CLI First | NON-NEGOTIABLE |
+| II | Agent Authority | NON-NEGOTIABLE |
+| III | Story-Driven Development | MUST |
+| IV | No Invention | MUST |
+| V | Quality First | MUST |
+| VI | Absolute Imports | SHOULD |
+
+**Gates automáticos bloqueiam violações.** Consulte a Constitution para detalhes completos.
+<!-- AIOS-MANAGED-END: constitution -->
+
+<!-- AIOS-MANAGED-START: sistema-de-agentes -->
+## Sistema de Agentes
+
+### Ativação de Agentes
+Use `@agent-name` ou `/AIOS:agents:agent-name`:
+
+| Agente | Persona | Escopo Principal |
+|--------|---------|------------------|
+| `@dev` | Dex | Implementação de código |
+| `@qa` | Quinn | Testes e qualidade |
+| `@architect` | Aria | Arquitetura e design técnico |
+| `@pm` | Morgan | Product Management |
+| `@po` | Pax | Product Owner, stories/epics |
+| `@sm` | River | Scrum Master |
+| `@analyst` | Alex | Pesquisa e análise |
+| `@data-engineer` | Dara | Database design |
+| `@ux-design-expert` | Uma | UX/UI design |
+| `@devops` | Gage | CI/CD, git push (EXCLUSIVO) |
+
+### Comandos de Agentes
+Use prefixo `*` para comandos:
+- `*help` - Mostrar comandos disponíveis
+- `*create-story` - Criar story de desenvolvimento
+- `*task {name}` - Executar task específica
+- `*exit` - Sair do modo agente
+<!-- AIOS-MANAGED-END: sistema-de-agentes -->
+
 <!-- AIOS-MANAGED-START: agent-system -->
 ## Agent System
 
@@ -65,6 +113,83 @@ docs/
 ```
 <!-- AIOS-MANAGED-END: framework-structure -->
 
+<!-- AIOS-MANAGED-START: framework-boundary -->
+## Framework vs Project Boundary
+
+O AIOS usa um modelo de 4 camadas (L1-L4) para separar artefatos do framework e do projeto. Deny rules em `.claude/settings.json` reforçam isso deterministicamente.
+
+| Camada | Mutabilidade | Paths | Notas |
+|--------|-------------|-------|-------|
+| **L1** Framework Core | NEVER modify | `.aios-core/core/`, `.aios-core/constitution.md`, `bin/aios.js`, `bin/aios-init.js` | Protegido por deny rules |
+| **L2** Framework Templates | NEVER modify | `.aios-core/development/tasks/`, `.aios-core/development/templates/`, `.aios-core/development/checklists/`, `.aios-core/development/workflows/`, `.aios-core/infrastructure/` | Extend-only |
+| **L3** Project Config | Mutable (exceptions) | `.aios-core/data/`, `agents/*/MEMORY.md`, `core-config.yaml` | Allow rules permitem |
+| **L4** Project Runtime | ALWAYS modify | `docs/stories/`, `packages/`, `squads/`, `tests/` | Trabalho do projeto |
+
+**Toggle:** `core-config.yaml` → `boundary.frameworkProtection: true/false` controla se deny rules são ativas (default: true para projetos, false para contribuidores do framework).
+
+> **Referência formal:** `.claude/settings.json` (deny/allow rules), `.claude/rules/agent-authority.md`
+<!-- AIOS-MANAGED-END: framework-boundary -->
+
+<!-- AIOS-MANAGED-START: rules-system -->
+## Rules System
+
+O AIOS carrega regras contextuais de `.claude/rules/` automaticamente. Regras com frontmatter `paths:` só carregam quando arquivos correspondentes são editados.
+
+| Rule File | Description |
+|-----------|-------------|
+| `agent-authority.md` | Agent delegation matrix and exclusive operations |
+| `agent-handoff.md` | Agent switch compaction protocol for context optimization |
+| `agent-memory-imports.md` | Agent memory lifecycle and CLAUDE.md ownership |
+| `coderabbit-integration.md` | Automated code review integration rules |
+| `ids-principles.md` | Incremental Development System principles |
+| `mcp-usage.md` | MCP server usage rules and tool selection priority |
+| `story-lifecycle.md` | Story status transitions and quality gates |
+| `workflow-execution.md` | 4 primary workflows (SDC, QA Loop, Spec Pipeline, Brownfield) |
+
+> **Diretório:** `.claude/rules/` — rules são carregadas automaticamente pelo Claude Code quando relevantes.
+<!-- AIOS-MANAGED-END: rules-system -->
+
+<!-- AIOS-MANAGED-START: code-intelligence -->
+## Code Intelligence
+
+O AIOS possui um sistema de code intelligence opcional que enriquece operações com dados de análise de código.
+
+| Status | Descrição | Comportamento |
+|--------|-----------|---------------|
+| **Configured** | Provider ativo e funcional | Enrichment completo disponível |
+| **Fallback** | Provider indisponível | Sistema opera normalmente sem enrichment — graceful degradation |
+| **Disabled** | Nenhum provider configurado | Funcionalidade de code-intel ignorada silenciosamente |
+
+**Graceful Fallback:** Code intelligence é sempre opcional. `isCodeIntelAvailable()` verifica disponibilidade antes de qualquer operação. Se indisponível, o sistema retorna o resultado base sem modificação — nunca falha.
+
+**Diagnóstico:** `aios doctor` inclui check de code-intel provider status.
+
+> **Referência:** `.aios-core/core/code-intel/` — provider interface, enricher, client
+<!-- AIOS-MANAGED-END: code-intelligence -->
+
+<!-- AIOS-MANAGED-START: graph-dashboard -->
+## Graph Dashboard
+
+O CLI `aios graph` visualiza dependências, estatísticas de entidades e status de providers.
+
+### Comandos
+
+```bash
+aios graph --deps                        # Dependency tree (ASCII)
+aios graph --deps --format=json          # Output como JSON
+aios graph --deps --format=html          # Interactive HTML (abre browser)
+aios graph --deps --format=mermaid       # Mermaid diagram
+aios graph --deps --format=dot           # DOT format (Graphviz)
+aios graph --deps --watch                # Live mode com auto-refresh
+aios graph --deps --watch --interval=10  # Refresh a cada 10 segundos
+aios graph --stats                       # Entity stats e cache metrics
+```
+
+**Formatos de saída:** ascii (default), json, dot, mermaid, html
+
+> **Referência:** `.aios-core/core/graph-dashboard/` — CLI, renderers, data sources
+<!-- AIOS-MANAGED-END: graph-dashboard -->
+
 ## Workflow Execution
 
 ### Task Execution Pattern