aios-core 4.0.2 → 4.0.4

package/.claude/rules/workflow-execution.md

@@ -0,0 +1,150 @@
+# Workflow Execution — Detailed Rules
+
+## Task-First Principle
+
+**Workflows são compostos por tasks conectadas, não por agentes conectados.** Cada task define seus inputs, outputs, pre/post-conditions e execution modes. Os agentes listados abaixo são os **executores padrão** de cada task — mas a sequência, as regras e as dependências vêm das definições de tasks em `.aios-core/development/tasks/`.
+
+Uma task validada é lei: deve ser executada conforme configurada, com todas as suas dependências respeitadas, independente de quem a executa (agent, worker, clone ou humano).
+
+---
+
+## 4 Primary Workflows
+
+### 1. Story Development Cycle (SDC) — PRIMARY
+
+**Full 4-phase workflow for all development work.**
+
+#### Phase 1: Create (@sm)
+- **Task:** `create-next-story.md`
+- **Inputs:** PRD sharded, epic context
+- **Output:** `{epicNum}.{storyNum}.story.md`
+- **Status:** Draft
+
+#### Phase 2: Validate (@po)
+- **Task:** `validate-next-story.md`
+- **10-point checklist** (see `story-lifecycle.md`)
+- **Decision:** GO (>=7) or NO-GO (required fixes listed)
+
+#### Phase 3: Implement (@dev)
+- **Task:** `dev-develop-story.md`
+- **Modes:** Interactive / YOLO / Pre-Flight
+- **CodeRabbit:** Self-healing max 2 iterations
+- **Status:** Ready → InProgress
+
+#### Phase 4: QA Gate (@qa)
+- **Task:** `qa-gate.md`
+- **7 quality checks** (see `story-lifecycle.md`)
+- **Decision:** PASS / CONCERNS / FAIL / WAIVED
+- **Status:** InProgress → InReview → Done
+
+---
+
+### 2. QA Loop — ITERATIVE REVIEW
+
+**Automated review-fix cycle after initial QA gate.**
+
+```
+@qa review → verdict → @dev fixes → re-review (max 5)
+```
+
+**Commands:**
+- `*qa-loop {storyId}` — Start loop
+- `*qa-loop-review` — Resume from review
+- `*qa-loop-fix` — Resume from fix
+- `*stop-qa-loop` — Pause, save state
+- `*resume-qa-loop` — Resume from state
+- `*escalate-qa-loop` — Force escalation
+
+**Config:**
+- Max iterations: 5 (`autoClaude.qaLoop.maxIterations`)
+- Status file: `qa/loop-status.json`
+
+**Verdicts:**
+- APPROVE → Complete, mark Done
+- REJECT → @dev fixes, re-review
+- BLOCKED → Escalate immediately
+
+**Escalation triggers:**
+- `max_iterations_reached`
+- `verdict_blocked`
+- `fix_failure`
+- `manual_escalate`
+
+---
+
+### 3. Spec Pipeline — PRE-IMPLEMENTATION
+
+**Transform informal requirements into executable spec.**
+
+| Phase | Agent | Output | Skip If |
+|-------|-------|--------|---------|
+| 1. Gather | @pm | `requirements.json` | Never |
+| 2. Assess | @architect | `complexity.json` | source=simple |
+| 3. Research | @analyst | `research.json` | SIMPLE class |
+| 4. Write Spec | @pm | `spec.md` | Never |
+| 5. Critique | @qa | `critique.json` | Never |
+| 6. Plan | @architect | `implementation.yaml` | If APPROVED |
+
+**Complexity Classes:**
+
+| Score | Class | Phases |
+|-------|-------|--------|
+| <= 8 | SIMPLE | gather → spec → critique (3) |
+| 9-15 | STANDARD | All 6 phases |
+| >= 16 | COMPLEX | 6 phases + revision cycle |
+
+**5 Complexity Dimensions (scored 1-5):**
+- **Scope:** Files affected
+- **Integration:** External APIs
+- **Infrastructure:** Changes needed
+- **Knowledge:** Team familiarity
+- **Risk:** Criticality level
+
+**Critique Verdicts:**
+
+| Verdict | Average Score | Next Step |
+|---------|--------------|-----------|
+| APPROVED | >= 4.0 | Plan (Phase 6) |
+| NEEDS_REVISION | 3.0-3.9 | Revise (Phase 5b) |
+| BLOCKED | < 3.0 | Escalate to @architect |
+
+**Constitutional Gate (Article IV — No Invention):**
+Every statement in spec.md MUST trace to FR-*, NFR-*, CON-*, or research finding. NO invented features.
+
+---
+
+### 4. Brownfield Discovery — LEGACY ASSESSMENT
+
+**10-phase technical debt assessment for existing codebases.**
+
+**Data Collection (Phases 1-3):**
+- Phase 1: @architect → `system-architecture.md`
+- Phase 2: @data-engineer → `SCHEMA.md` + `DB-AUDIT.md` (if DB exists)
+- Phase 3: @ux-design-expert → `frontend-spec.md`
+
+**Draft & Validation (Phases 4-7):**
+- Phase 4: @architect → `technical-debt-DRAFT.md`
+- Phase 5: @data-engineer → `db-specialist-review.md`
+- Phase 6: @ux-design-expert → `ux-specialist-review.md`
+- Phase 7: @qa → `qa-review.md` (QA Gate: APPROVED | NEEDS WORK)
+
+**Finalization (Phases 8-10):**
+- Phase 8: @architect → `technical-debt-assessment.md` (final)
+- Phase 9: @analyst → `TECHNICAL-DEBT-REPORT.md` (executive)
+- Phase 10: @pm → Epic + stories ready for development
+
+**QA Gate (Phase 7):**
+- **APPROVED:** All debits validated, no critical gaps, dependencies mapped
+- **NEEDS WORK:** Gaps not addressed, return to Phase 4
+
+---
+
+## Workflow Selection Guide
+
+| Situation | Workflow |
+|-----------|---------|
+| New story from epic | Story Development Cycle |
+| QA found issues, need iteration | QA Loop |
+| Complex feature needs spec | Spec Pipeline → then SDC |
+| Joining existing project | Brownfield Discovery |
+| Simple bug fix | SDC only (YOLO mode) |

package/LICENSE

@@ -1,48 +1,48 @@
-Commons Clause License Condition v1.0
-
-The Software is provided to you by the Licensor under the License,
-as defined below, subject to the following condition.
-
-Without limiting other conditions in the License, the grant of rights
-under the License will not include, and the License does not grant to
-you, the right to Sell the Software.
-
-For purposes of the foregoing, "Sell" means practicing any or all of
-the rights granted to you under the License to provide to third parties,
-for a fee or other consideration (including without limitation fees for
-hosting or consulting/support services related to the Software), a
-product or service whose value derives, entirely or substantially, from
-the functionality of the Software.
-
-Any license notice or attribution required by the License must also
-include this Commons Clause License Condition notice.
-
----
-
-MIT License
-
-Copyright (c) 2025 SynkraAI Inc. - AIOS Framework
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-Software: Synkra AIOS (AI-Orchestrated System for Full Stack Development)
-License: MIT
-Licensor: SynkraAI Inc.
+Commons Clause License Condition v1.0
+
+The Software is provided to you by the Licensor under the License,
+as defined below, subject to the following condition.
+
+Without limiting other conditions in the License, the grant of rights
+under the License will not include, and the License does not grant to
+you, the right to Sell the Software.
+
+For purposes of the foregoing, "Sell" means practicing any or all of
+the rights granted to you under the License to provide to third parties,
+for a fee or other consideration (including without limitation fees for
+hosting or consulting/support services related to the Software), a
+product or service whose value derives, entirely or substantially, from
+the functionality of the Software.
+
+Any license notice or attribution required by the License must also
+include this Commons Clause License Condition notice.
+
+---
+
+MIT License
+
+Copyright (c) 2025 SynkraAI Inc. - AIOS Framework
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Software: Synkra AIOS (AI-Orchestrated System for Full Stack Development)
+License: MIT
+Licensor: SynkraAI Inc.

package/README.md

@@ -90,7 +90,7 @@ Esta abordagem de duas fases elimina tanto a **inconsistência de planejamento**
 **Mantenha-se atualizado sem esforço!** Para atualizar sua instalação AIOS existente:
 
 ```bash
-npx github:SynkraAI/aios-core install
+npx aios-core@latest install
 ```
 
 Isto vai:
@@ -155,7 +155,7 @@ O Synkra AIOS agora inclui uma experiência de instalação interativa de últim
 Se você já tem o AIOS instalado:
 
 ```bash
-npx github:SynkraAI/aios-core install
+npx aios-core@latest install
 # O instalador detectará sua instalação existente e a atualizará
 ```
 
@@ -368,13 +368,13 @@ npm run install:aios
 Para membros da equipe ingressando no projeto:
 
 ```bash
-# Instalar AIOS com configuração GitHub
-npx github:SynkraAI/aios-core setup
+# Instalar AIOS no projeto
+npx aios-core@latest install
 
 # Isto vai:
-# 1. Verificar/instalar GitHub CLI
-# 2. Autenticar com GitHub
-# 3. Executar o instalador AIOS
+# 1. Detectar instalação existente (se houver)
+# 2. Instalar/atualizar framework AIOS
+# 3. Configurar agentes e workflows
 ```
 
 ## 🌟 Além do Desenvolvimento de Software - Squads
@@ -536,6 +536,29 @@ Squads são equipes modulares de agentes IA. Veja a [Visão Geral de Squads](doc
 
 - **[hybrid-ops](https://github.com/SynkraAI/aios-hybrid-ops-pedro-valerio)** - Operações híbridas humano-agente (repositório separado)
 
+## AIOS Pro
+
+O **AIOS Pro** (`@aios-fullstack/pro`) é o módulo premium do Synkra AIOS, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.
+
+> **Disponibilidade restrita:** O AIOS Pro está disponível exclusivamente para membros do **AIOS Cohort Advanced**. [Saiba mais sobre o programa](https://synkra.ai).
+
+### Instalação
+
+```bash
+npm install @aios-fullstack/pro
+```
+
+### Features Premium
+
+- **Squads Avançados** - Squads especializados com capacidades expandidas
+- **Memory Layer** - Memória persistente de padrões e insights entre sessões
+- **Métricas & Analytics** - Dashboard de produtividade e métricas de desenvolvimento
+- **Integrações Enterprise** - Conectores para Jira, Linear, Notion e mais
+- **Configuração em Camadas** - Sistema de configuração L1-L4 com herança
+- **Licenciamento** - Gerenciamento de licença via `aios pro activate --key <KEY>`
+
+Para mais informações, execute `npx aios-core pro --help` após a instalação.
+
 ## Suporte & Comunidade
 
 - 📖 [Guia da Comunidade](docs/community.md) - Como participar e contribuir

package/bin/aios.js

@@ -59,16 +59,16 @@ AIOS-FullStack v${packageJson.version}
 AI-Orchestrated System for Full Stack Development
 
 USAGE:
-  npx @synkra/aios-core@latest              # Run installation wizard
-  npx @synkra/aios-core@latest install      # Install in current project
-  npx @synkra/aios-core@latest init <name>  # Create new project
-  npx @synkra/aios-core@latest update       # Update to latest version
-  npx @synkra/aios-core@latest validate     # Validate installation integrity
-  npx @synkra/aios-core@latest info         # Show system info
-  npx @synkra/aios-core@latest doctor       # Run diagnostics
-  npx @synkra/aios-core@latest --version    # Show version
-  npx @synkra/aios-core@latest --version -d # Show detailed version info
-  npx @synkra/aios-core@latest --help       # Show this help
+  npx aios-core@latest              # Run installation wizard
+  npx aios-core@latest install      # Install in current project
+  npx aios-core@latest init <name>  # Create new project
+  npx aios-core@latest update       # Update to latest version
+  npx aios-core@latest validate     # Validate installation integrity
+  npx aios-core@latest info         # Show system info
+  npx aios-core@latest doctor       # Run diagnostics
+  npx aios-core@latest --version    # Show version
+  npx aios-core@latest --version -d # Show detailed version info
+  npx aios-core@latest --help       # Show this help
 
 UPDATE:
   aios update                    # Update to latest version
@@ -99,13 +99,13 @@ SERVICE DISCOVERY:
 
 EXAMPLES:
   # Install in current directory
-  npx @synkra/aios-core@latest
+  npx aios-core@latest
 
   # Install with minimal mode (only expansion-creator)
-  npx @synkra/aios-core-minimal@latest
+  npx aios-core-minimal@latest
 
   # Create new project
-  npx @synkra/aios-core@latest init my-project
+  npx aios-core@latest init my-project
 
   # Search for workers
   aios workers search "json csv"
@@ -126,7 +126,7 @@ async function showVersion() {
 
   // Detailed version output (Story 7.2: Version Tracking)
   console.log(`AIOS-FullStack v${packageJson.version}`);
-  console.log('Package: @synkra/aios-core');
+  console.log('Package: aios-core');
 
   // Check for local installation
   const localVersionPath = path.join(process.cwd(), '.aios-core', 'version.json');
@@ -485,7 +485,7 @@ Examples:
     });
     hasErrors = true;
     console.log('✗ AIOS Core not installed');
-    console.log('  Run: npx @synkra/aios-core@latest');
+    console.log('  Run: npx aios-core@latest');
   }
 
   // Check 5: AIOS Pro license status (Task 5.1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "bin": {
     "aios": "bin/aios.js",
@@ -18,9 +18,7 @@
     ".aios-core/",
     ".claude/CLAUDE.md",
     ".claude/rules/",
-    ".claude/hooks/synapse-engine.js",
-    ".claude/hooks/precompact-session-digest.js",
-    ".claude/hooks/README.md",
+    ".claude/hooks/",
     "README.md",
     "LICENSE"
   ],