aios-core 4.2.6 → 4.2.7

package/.aios-core/product/templates/brownfield-risk-report-tmpl.yaml

@@ -0,0 +1,277 @@
+# Brownfield Risk Report Template
+# Story AIOS-DIFF-4.3.2: Template de relatório de risco por fase
+
+template:
+  id: brownfield-risk-report
+  name: Brownfield Migration Risk Report
+  version: "1.0"
+  type: product
+  description: >
+    Template for generating risk assessment reports during brownfield
+    migration phases. Used by @analyst to create executive-level reports.
+
+# ═══════════════════════════════════════════════════════════════════════════════
+#                              REPORT STRUCTURE
+# ═══════════════════════════════════════════════════════════════════════════════
+
+sections:
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # EXECUTIVE SUMMARY
+  # ─────────────────────────────────────────────────────────────────────────────
+
+  executive_summary:
+    title: "Executive Summary"
+    content: |
+      ## 📊 Risk Assessment Summary
+
+      **Project:** {{project_name}}
+      **Phase:** {{current_phase}}
+      **Date:** {{report_date}}
+      **Assessor:** @analyst
+
+      ### Overall Risk Level: {{overall_risk_level}}
+
+      | Metric | Value |
+      |--------|-------|
+      | Critical Risks | {{critical_count}} |
+      | High Risks | {{high_count}} |
+      | Medium Risks | {{medium_count}} |
+      | Low Risks | {{low_count}} |
+      | Mitigated | {{mitigated_count}} |
+
+      ### Key Findings
+      {{key_findings}}
+
+      ### Recommended Action
+      {{recommended_action}}
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # PHASE-SPECIFIC RISKS
+  # ─────────────────────────────────────────────────────────────────────────────
+
+  phase_risks:
+    title: "Phase-Specific Risk Analysis"
+    phases:
+
+      discovery:
+        name: "Discovery Phase"
+        description: "Initial codebase analysis and documentation"
+        typical_risks:
+          - id: DISC-001
+            name: "Incomplete Documentation"
+            description: "Existing system poorly documented, discovery may miss critical components"
+            probability: medium
+            impact: high
+            mitigation: "Cross-reference with running system, interview stakeholders"
+          - id: DISC-002
+            name: "Hidden Dependencies"
+            description: "Undocumented external services or databases"
+            probability: medium
+            impact: critical
+            mitigation: "Network traffic analysis, env var audit"
+          - id: DISC-003
+            name: "Time Underestimation"
+            description: "Discovery takes longer than 4-8h estimate"
+            probability: low
+            impact: medium
+            mitigation: "Checkpoint after each sub-phase, adjust timeline"
+
+      planning:
+        name: "Planning Phase"
+        description: "PRD and architecture design"
+        typical_risks:
+          - id: PLAN-001
+            name: "Scope Creep"
+            description: "Technical debt resolution expands beyond initial estimate"
+            probability: high
+            impact: medium
+            mitigation: "Fixed scope per phase, explicit out-of-scope list"
+          - id: PLAN-002
+            name: "Architecture Mismatch"
+            description: "Proposed architecture conflicts with existing constraints"
+            probability: medium
+            impact: high
+            mitigation: "Validate with existing code, incremental changes only"
+          - id: PLAN-003
+            name: "Stakeholder Misalignment"
+            description: "Business priorities differ from technical recommendations"
+            probability: medium
+            impact: high
+            mitigation: "Executive report before implementation, explicit tradeoffs"
+
+      migration:
+        name: "Migration Phase"
+        description: "Implementation of changes"
+        typical_risks:
+          - id: MIG-001
+            name: "Breaking Changes"
+            description: "New code breaks existing functionality"
+            probability: medium
+            impact: critical
+            mitigation: "Feature flags, comprehensive test coverage before changes"
+          - id: MIG-002
+            name: "Data Loss"
+            description: "Database migration causes data corruption or loss"
+            probability: low
+            impact: critical
+            mitigation: "Backup before migration, dry-run on staging, rollback script ready"
+          - id: MIG-003
+            name: "Downtime"
+            description: "Migration requires extended system downtime"
+            probability: medium
+            impact: high
+            mitigation: "Zero-downtime migration strategy, maintenance window planning"
+
+      rollout:
+        name: "Rollout Phase"
+        description: "Progressive deployment"
+        typical_risks:
+          - id: ROLL-001
+            name: "Performance Degradation"
+            description: "New code slower than existing implementation"
+            probability: medium
+            impact: high
+            mitigation: "Load testing before rollout, monitoring during rollout"
+          - id: ROLL-002
+            name: "User Disruption"
+            description: "Changed UX confuses existing users"
+            probability: medium
+            impact: medium
+            mitigation: "Gradual rollout (10% → 50% → 100%), feedback collection"
+          - id: ROLL-003
+            name: "Rollback Failure"
+            description: "Unable to revert to previous state"
+            probability: low
+            impact: critical
+            mitigation: "Test rollback before production rollout, checkpoint commits"
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # RISK MATRIX
+  # ─────────────────────────────────────────────────────────────────────────────
+
+  risk_matrix:
+    title: "Risk Assessment Matrix"
+    content: |
+      ## Risk Classification
+
+      | Probability / Impact | Low | Medium | High | Critical |
+      |----------------------|-----|--------|------|----------|
+      | **High** | Medium | High | Critical | Critical |
+      | **Medium** | Low | Medium | High | Critical |
+      | **Low** | Low | Low | Medium | High |
+
+      ### Risk Levels
+
+      - **Critical**: Immediate action required, blocks progress
+      - **High**: Must be mitigated before proceeding to next phase
+      - **Medium**: Should be addressed, can proceed with monitoring
+      - **Low**: Acceptable, document and monitor
+
+      ### Current Phase Risks
+
+      | ID | Risk | Probability | Impact | Level | Status |
+      |----|------|-------------|--------|-------|--------|
+      {{risk_table}}
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # MITIGATION PLAN
+  # ─────────────────────────────────────────────────────────────────────────────
+
+  mitigation_plan:
+    title: "Mitigation Plan"
+    content: |
+      ## Mitigation Strategies
+
+      ### Critical & High Risks
+
+      {{critical_mitigations}}
+
+      ### Medium Risks
+
+      {{medium_mitigations}}
+
+      ### Monitoring Plan
+
+      | Risk ID | Metric to Watch | Threshold | Action if Exceeded |
+      |---------|-----------------|-----------|-------------------|
+      {{monitoring_table}}
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # ROLLBACK STRATEGY
+  # ─────────────────────────────────────────────────────────────────────────────
+
+  rollback_strategy:
+    title: "Rollback Strategy"
+    content: |
+      ## Rollback Checkpoints
+
+      ### Phase Checkpoints
+
+      | Phase | Checkpoint | Rollback Command | Recovery Time |
+      |-------|------------|------------------|---------------|
+      | Discovery | Pre-analysis | N/A (read-only) | N/A |
+      | Planning | Pre-PRD | `git checkout {{pre_planning_commit}}` | < 1 min |
+      | Migration | Pre-migration | `git checkout {{pre_migration_commit}}` | < 5 min |
+      | Rollout | Pre-rollout | `git checkout {{pre_rollout_commit}}` | < 5 min |
+
+      ### Database Rollback
+
+      ```bash
+      # If database migration was applied:
+      npm run db:rollback -- --to={{last_good_migration}}
+
+      # If data was modified:
+      # Restore from backup taken at {{backup_timestamp}}
+      ```
+
+      ### Rollback Triggers
+
+      Automatic rollback if:
+      - [ ] Error rate exceeds 5% for 5 minutes
+      - [ ] Response time increases >200% from baseline
+      - [ ] Critical functionality fails health check
+
+      Manual rollback decision by:
+      - [ ] Tech lead approval for partial rollback
+      - [ ] CTO approval for full rollback
+
+  # ─────────────────────────────────────────────────────────────────────────────
+  # SIGN-OFF
+  # ─────────────────────────────────────────────────────────────────────────────
+
+  sign_off:
+    title: "Sign-Off"
+    content: |
+      ## Phase Approval
+
+      | Role | Name | Approval | Date |
+      |------|------|----------|------|
+      | Technical Lead | | [ ] Approved | |
+      | Product Owner | | [ ] Approved | |
+      | QA Lead | | [ ] Approved | |
+
+      ### Conditions for Proceeding
+
+      - [ ] All critical risks mitigated
+      - [ ] All high risks have mitigation plan
+      - [ ] Rollback tested and verified
+      - [ ] Stakeholders notified
+
+      ---
+
+      **Report Generated By:** @analyst
+      **Template Version:** 1.0
+      **Story:** AIOS-DIFF-4.3.2
+
+# ═══════════════════════════════════════════════════════════════════════════════
+#                              USAGE
+# ═══════════════════════════════════════════════════════════════════════════════
+
+usage:
+  command: "@analyst → *create-doc brownfield-risk-report"
+  output: "docs/reports/BROWNFIELD-RISK-REPORT-{{phase}}.md"
+  triggers:
+    - Before each brownfield phase transition
+    - When new risks are identified
+    - Before stakeholder review meetings

package/.aios-core/workflow-intelligence/engine/suggestion-engine.js

@@ -22,6 +22,7 @@ const path = require('path');
 let wis = null;
 let SessionContextLoader = null;
 let learning = null;
+let WorkflowStateManager = null;
 
 /**
  * Default cache TTL for suggestions (5 minutes)
@@ -93,6 +94,15 @@ class SuggestionEngine {
         learning = null;
       }
     }
+
+    if (!WorkflowStateManager) {
+      try {
+        ({ WorkflowStateManager } = require('../../development/scripts/workflow-state-manager'));
+      } catch (error) {
+        console.warn('[SuggestionEngine] Failed to load WorkflowStateManager:', error.message);
+        WorkflowStateManager = null;
+      }
+    }
   }
 
   /**
@@ -154,11 +164,12 @@ class SuggestionEngine {
    */
   async suggestNext(context) {
     this._loadDependencies();
+    const runtimeNext = this._getRuntimeNextRecommendation(context);
 
     // Check cache first
     const cacheKey = this._generateCacheKey(context);
     if (this._isCacheValid(cacheKey)) {
-      return this.suggestionCache;
+      return this._withRuntimeRecommendation(this.suggestionCache, runtimeNext);
     }
 
     // Default result for when WIS is not available
@@ -172,7 +183,7 @@ class SuggestionEngine {
     };
 
     if (!wis) {
-      return defaultResult;
+      return this._withRuntimeRecommendation(defaultResult, runtimeNext);
     }
 
     try {
@@ -180,10 +191,10 @@ class SuggestionEngine {
       const suggestions = wis.getSuggestions(context);
 
       if (!suggestions || suggestions.length === 0) {
-        return {
+        return this._withRuntimeRecommendation({
           ...defaultResult,
           message: 'No matching workflow found for current context',
-        };
+        }, runtimeNext);
       }
 
       // Get workflow match info
@@ -222,7 +233,7 @@ class SuggestionEngine {
           : 0;
 
       // Build result
-      const result = {
+      let result = {
         workflow: match?.name || suggestions[0]?.workflow || null,
         currentState: suggestions[0]?.state || null,
         confidence: Math.round(finalAvgConfidence * 100) / 100,
@@ -231,6 +242,8 @@ class SuggestionEngine {
         message: null,
       };
 
+      result = this._withRuntimeRecommendation(result, runtimeNext);
+
       // Cache the result
       this._cacheResult(cacheKey, result);
 
@@ -244,6 +257,102 @@ class SuggestionEngine {
     }
   }
 
+  /**
+   * Build runtime execution signals for deterministic next-action recommendation
+   * @param {Object} context - Current session context
+   * @returns {Object} Normalized runtime signals
+   * @private
+   */
+  _buildRuntimeSignals(context = {}) {
+    const projectState = context.projectState || {};
+    const hasUncommitted =
+      typeof projectState.hasUncommittedChanges === 'boolean'
+        ? projectState.hasUncommittedChanges
+        : false;
+
+    const baseSignals = {
+      story_status:
+        projectState.story_status || projectState.storyStatus || (projectState.activeStory ? 'in_progress' : 'unknown'),
+      qa_status: projectState.qa_status || projectState.qaStatus || 'unknown',
+      ci_status:
+        projectState.ci_status ||
+        projectState.ciStatus ||
+        (projectState.failingTests ? 'failed' : 'unknown'),
+      has_uncommitted_changes: hasUncommitted,
+    };
+
+    return {
+      ...baseSignals,
+      ...(context.executionSignals || {}),
+    };
+  }
+
+  /**
+   * Get deterministic runtime-first recommendation if signals are available
+   * @param {Object} context - Current session context
+   * @returns {Object|null} Runtime recommendation or null
+   * @private
+   */
+  _getRuntimeNextRecommendation(context = {}) {
+    if (!WorkflowStateManager) {
+      return null;
+    }
+
+    try {
+      const manager = new WorkflowStateManager();
+      const runtimeSignals = this._buildRuntimeSignals(context);
+      const recommendation = manager.getNextActionRecommendation(runtimeSignals, {
+        story: context.storyPath || '',
+      });
+
+      if (!recommendation || recommendation.state === 'unknown') {
+        return null;
+      }
+
+      return recommendation;
+    } catch (_error) {
+      return null;
+    }
+  }
+
+  /**
+   * Merge runtime-first deterministic recommendation into suggestion result.
+   * @param {Object} result - Suggestion result
+   * @param {Object|null} runtimeNext - Runtime recommendation
+   * @returns {Object} Enhanced result
+   * @private
+   */
+  _withRuntimeRecommendation(result, runtimeNext) {
+    if (!result || !runtimeNext) {
+      return result;
+    }
+
+    const runtimeSuggestion = {
+      command: runtimeNext.command,
+      args: '',
+      description: runtimeNext.rationale,
+      confidence: runtimeNext.confidence,
+      priority: 0,
+      source: 'runtime_first',
+      agent: runtimeNext.agent,
+      executionState: runtimeNext.state,
+    };
+
+    const existing = Array.isArray(result.suggestions) ? result.suggestions : [];
+    const normalizedRuntimeCommand = String(runtimeSuggestion.command || '').trim().toLowerCase();
+    const deduped = existing.filter(
+      (s) => String((s.command || '') + (s.args ? ` ${s.args}` : '')).trim().toLowerCase() !== normalizedRuntimeCommand,
+    );
+
+    return {
+      ...result,
+      suggestions: [runtimeSuggestion, ...deduped],
+      confidence: Math.max(result.confidence || 0, runtimeNext.confidence || 0),
+      isUncertain: false,
+      runtimeState: runtimeNext.state,
+    };
+  }
+
   /**
    * Detect current active agent from environment or session
    * @returns {string} Agent ID

package/LICENSE

@@ -1,6 +1,12 @@
 MIT License
 
-Copyright (c) 2025 SynkraAI Inc. - AIOS Framework
+Copyright (c) 2025 BMad Code, LLC (BMad Method - original work)
+Copyright (c) 2025 SynkraAI Inc. (AIOS Framework - derivative work)
+
+This project was originally derived from the BMad Method
+(https://github.com/bmad-code-org/BMAD-METHOD), created by Brian Madison.
+Synkra AIOS is NOT affiliated with, endorsed by, or sanctioned by the
+BMad Method or BMad Code, LLC.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -19,3 +25,9 @@ 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.
+
+TRADEMARK NOTICE:
+BMad, BMad Method, and BMad Core are trademarks of BMad Code, LLC.
+These trademarks are NOT licensed under the MIT License. See the BMad Method
+TRADEMARK.md (https://github.com/bmad-code-org/BMAD-METHOD/blob/main/TRADEMARK.md)
+for detailed guidelines on trademark usage.

package/README.md

@@ -12,6 +12,30 @@
 
 Framework de Desenvolvimento Auto-Modificável Alimentado por IA. Fundado em Desenvolvimento Ágil Dirigido por Agentes, oferecendo capacidades revolucionárias para desenvolvimento dirigido por IA e muito mais. Transforme qualquer domínio com expertise especializada de IA: desenvolvimento de software, entretenimento, escrita criativa, estratégia de negócios, bem-estar pessoal e muito mais.
 
+## Comece Aqui (10 Min)
+
+Se é sua primeira vez no AIOS, siga este caminho linear:
+
+1. Instale em um projeto novo ou existente:
+```bash
+# novo projeto
+npx aios-core init meu-projeto
+
+# projeto existente
+cd seu-projeto
+npx aios-core install
+```
+2. Escolha sua IDE/CLI e o caminho de ativação:
+- Claude Code: `/agent-name`
+- Gemini CLI: `/aios-menu` → `/aios-<agent>`
+- Codex CLI: `/skills` → `aios-<agent-id>`
+- Cursor/Copilot/AntiGravity: siga os limites e workarounds em `docs/ide-integration.md`
+3. Ative 1 agente e confirme o greeting.
+4. Rode 1 comando inicial (`*help` ou equivalente) para validar first-value.
+
+Definição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em <= 10 minutos.
+
+
 ## Compatibilidade de Hooks por IDE (Realidade AIOS 4.0.4)
 
 Muitos recursos avançados do AIOS dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs/plataformas:
@@ -27,11 +51,15 @@ Muitos recursos avançados do AIOS dependem de eventos de ciclo de vida (hooks).
 
 Impactos e mitigação detalhados: `docs/ide-integration.md`.
 
-## Nota Sobre BMAD
+## Acknowledgments & Attribution
+
+Synkra AIOS was originally derived from the [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD), created by [Brian Madison](https://github.com/bmadcode) (BMad Code, LLC). We gratefully acknowledge the BMad Method for providing the foundation from which this project began.
 
-O AIOS evoluiu significativamente e **não depende de BMAD** para operação atual.
-Quando BMAD aparece em histórico de changelog/migração, é apenas contexto histórico.
-O caminho oficial e atual é AIOS 4.x com terminologia e arquitetura próprias.
+**Important:** This project is **NOT affiliated with, endorsed by, or sanctioned by** the BMad Method or BMad Code, LLC. Contributors appearing in the git history from the original BMad Method repository do not imply active participation in or endorsement of Synkra AIOS.
+
+Since its origin, AIOS has evolved significantly with its own architecture, terminology, and features (v4.x+), and does not depend on BMad for current operation. The BMad Method remains an excellent framework in its own right — please visit the [official BMad Method repository](https://github.com/bmad-code-org/BMAD-METHOD) to learn more.
+
+BMad, BMad Method, and BMad Core are trademarks of BMad Code, LLC. See [TRADEMARK.md](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/TRADEMARK.md) for usage guidelines.
 
 ## Visão Geral
 
@@ -104,7 +132,7 @@ Esta abordagem de duas fases elimina tanto a **inconsistência de planejamento**
 - **[Criar meus próprios agentes IA](#criando-seu-próprio-squad)** → Construir agentes para seu domínio
 - **[Navegar Squads prontos](docs/guides/squads-overview.md)** → Veja como criar e usar equipes de agentes IA
 - **[Entender a arquitetura](docs/architecture/ARCHITECTURE-INDEX.md)** → Mergulho técnico profundo
-- **[Juntar-se à comunidade](https://discord.gg/gk8jAdXWmj)** → Obter ajuda e compartilhar ideias
+- **[Reportar problemas](https://github.com/SynkraAI/aios-core/issues)** → Bug reports e feature requests
 
 ## Importante: Mantenha Sua Instalação AIOS Atualizada
 
@@ -601,12 +629,10 @@ npm install @aios-fullstack/pro
 
 Para mais informações, execute `npx aios-core pro --help` após a instalação.
 
-## Suporte & Comunidade
+## Suporte
 
-- 📖 [Guia da Comunidade](docs/community.md) - Como participar e contribuir
-- 💬 [Discussões GitHub](https://github.com/SynkraAI/aios-core/discussions) - Hub central da comunidade
+- 🐛 [Rastreador de Issues](https://github.com/SynkraAI/aios-core/issues) - Bug reports e feature requests
 - 💡 [Processo de Features](docs/FEATURE_PROCESS.md) - Como propor novas funcionalidades
-- 🐛 [Rastreador de Issues](https://github.com/SynkraAI/aios-core/issues)
 - 📋 [Como Contribuir](CONTRIBUTING.md)
 - 🗺️ [Roadmap](docs/roadmap.md) - Veja o que estamos construindo
 - 🤖 [Guia de Squads](docs/guides/squads-guide.md) - Crie equipes de agentes IA
@@ -704,6 +730,10 @@ Veja também:
 
 ## Reconhecimentos
 
+This project was originally derived from the [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD) by [Brian Madison](https://github.com/bmadcode). We thank Brian and all BMad Method contributors for the original work that made this project possible.
+
+**Note:** Some contributors shown in the GitHub contributors graph are inherited from the original BMad Method git history and do not represent active participation in or endorsement of Synkra AIOS.
+
 [![Contributors](https://contrib.rocks/image?repo=SynkraAI/aios-core)](https://github.com/SynkraAI/aios-core/graphs/contributors)
 
 <sub>Construído com ❤️ para a comunidade de desenvolvimento assistido por IA</sub>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "4.2.6",
+  "version": "4.2.7",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "bin": {
     "aios": "bin/aios.js",
@@ -56,10 +56,11 @@
     "sync:skills:codex": "node .aios-core/infrastructure/scripts/codex-skills-sync/index.js",
     "sync:skills:codex:global": "node .aios-core/infrastructure/scripts/codex-skills-sync/index.js --global --global-only",
   "validate:codex-skills": "node .aios-core/infrastructure/scripts/codex-skills-sync/validate.js --strict",
-  "validate:paths": "node .aios-core/infrastructure/scripts/validate-paths.js",
-  "validate:parity": "node .aios-core/infrastructure/scripts/validate-parity.js",
-  "manifest:ensure": "node scripts/ensure-manifest.js",
-  "sync:ide:cursor": "node .aios-core/infrastructure/scripts/ide-sync/index.js sync --ide cursor",
+    "validate:paths": "node .aios-core/infrastructure/scripts/validate-paths.js",
+    "validate:parity": "node .aios-core/infrastructure/scripts/validate-parity.js",
+    "validate:semantic-lint": "node scripts/semantic-lint.js",
+    "manifest:ensure": "node scripts/ensure-manifest.js",
+    "sync:ide:cursor": "node .aios-core/infrastructure/scripts/ide-sync/index.js sync --ide cursor",
     "prepublishOnly": "npm run generate:manifest && npm run validate:manifest",
     "prepare": "husky"
   },
@@ -139,7 +140,8 @@
       "prettier --write"
     ],
     "*.md": [
-      "prettier --write"
+      "prettier --write",
+      "node scripts/semantic-lint.js --staged"
     ],
     ".aios-core/development/agents/*.md": [
       "npm run sync:ide"