aios-core 4.2.5 → 4.2.7

package/.aios-core/install-manifest.yaml

@@ -7,10 +7,10 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 4.2.5
-generated_at: "2026-02-16T02:46:13.044Z"
+version: 4.2.7
+generated_at: "2026-02-16T14:10:16.018Z"
 generator: scripts/generate-install-manifest.js
-file_count: 995
+file_count: 1004
 files:
   - path: cli/commands/config/index.js
     hash: sha256:ebcad2ce3807eda29dcddff76d7a95ddc9b7fa160df21fd608f94b802237e862
@@ -180,6 +180,26 @@ files:
     hash: sha256:c1266389772b3fcf3e4c91df085bd38dc0b01d0a5f98bdf977d134972ccaf49b
     type: config
     size: 9392
+  - path: core/code-intel/code-intel-client.js
+    hash: sha256:bd88497c8c8f312e95f746121e627c088e93d27af093d411f0521712bd17ba94
+    type: core
+    size: 7541
+  - path: core/code-intel/code-intel-enricher.js
+    hash: sha256:0bea0c1953a21621afbb4c9755e782842940cf54cdc88a4318dd7242f1fb02a8
+    type: core
+    size: 4320
+  - path: core/code-intel/index.js
+    hash: sha256:ca8c54c2decbf64183d890ab42dc8ca2deafa675d4433492cb6ce423a284ad4d
+    type: core
+    size: 3802
+  - path: core/code-intel/providers/code-graph-provider.js
+    hash: sha256:0c5ffd7b3faf82453ed1cb77f52ef10a3e67d3a1b2e2df5aac89a4fb2ac6583b
+    type: core
+    size: 6335
+  - path: core/code-intel/providers/provider-interface.js
+    hash: sha256:7d16aa715155e9c077720a6bffc7e9e5411b65f821b6b4e5e909f226796e7acb
+    type: core
+    size: 3079
   - path: core/config/config-cache.js
     hash: sha256:527a788cbe650aa6b13d1101ebc16419489bfef20b2ee93042f6eb6a51e898e9
     type: core
@@ -641,13 +661,13 @@ files:
     type: core
     size: 10845
   - path: core/orchestration/context-manager.js
-    hash: sha256:91b4e84f1a6246f9a1c94191a096bf9ee26b668610cc3fe7aec893931f54d241
+    hash: sha256:0dd03e84d0a2ea06165825c5eb7154531337ef98275918119ccd03769af576c3
     type: core
-    size: 7299
+    size: 16842
   - path: core/orchestration/dashboard-integration.js
-    hash: sha256:2099a762e039d7b536b0472231d648a39c34c386d04bdcb1a265c5dd4d261514
+    hash: sha256:fc96589a18302ac91036a52a8f4da2f9a1ba8e3f9dc45a4bacb8a279fc6db39d
     type: core
-    size: 14603
+    size: 15116
   - path: core/orchestration/data-lifecycle-manager.js
     hash: sha256:0d5df61805502204c0a467ae9900c940f869743ee332fa19839c9f9cacfe824d
     type: core
@@ -656,6 +676,10 @@ files:
     hash: sha256:4f342f7fc05f404de2b899358f86143106737b56d6c486c98e988a67d420078b
     type: core
     size: 12310
+  - path: core/orchestration/execution-profile-resolver.js
+    hash: sha256:bb35f1c16c47c9306128c5f3e6c90df3ed91f9358576ea97a59007b74f5e9927
+    type: core
+    size: 2696
   - path: core/orchestration/executor-assignment.js
     hash: sha256:d022d8bc01432958857894bc424e48e42d21287f44fe2e0cacfbdf03b412d33f
     type: core
@@ -697,9 +721,9 @@ files:
     type: core
     size: 35270
   - path: core/orchestration/index.js
-    hash: sha256:a71fc2cf4facd2725d9f330806076424450f7e5eee3dc876aae1fc0335166da7
+    hash: sha256:1d1b5471585647512327e7d5836ad826442b4c9bd588f82729fa455b41fa28b9
     type: core
-    size: 8630
+    size: 8835
   - path: core/orchestration/lock-manager.js
     hash: sha256:7764b9e79444e75577931a561444f1bf950d893004abc39fa8c2476f632bb481
     type: core
@@ -725,13 +749,13 @@ files:
     type: core
     size: 24732
   - path: core/orchestration/skill-dispatcher.js
-    hash: sha256:0a2dcf12cb8b04c26006c57016cf0d651332e60dee09762f88927c216464abde
+    hash: sha256:4a54fec3a3338431d1d9634ebf06f3983d06903570c45d67d0ac15d25c95eb05
     type: core
-    size: 10372
+    size: 10490
   - path: core/orchestration/subagent-prompt-builder.js
-    hash: sha256:3da03371fa4cafa4221299f241acd3c37697b395e29ea0c5c65c81bc13f51326
+    hash: sha256:967cc17e019ae030148b276b6fdc6a698ae5f42a05f20e80484cb87ea81ed7af
     type: core
-    size: 11255
+    size: 11395
   - path: core/orchestration/surface-checker.js
     hash: sha256:92e9d5bea78c3db4940c39f79e537821b36451cd524d69e6b738272aa63c08b6
     type: core
@@ -753,9 +777,9 @@ files:
     type: core
     size: 36350
   - path: core/orchestration/workflow-orchestrator.js
-    hash: sha256:fb89682ea86d33bf8453062f82be0313fbfdf4da42ebf0220dd12dc29238a50a
+    hash: sha256:5d3f14d5f12742ce87c3ae8745f82f4ac9f3df3d1889cf16bfc13743130963f9
     type: core
-    size: 26902
+    size: 30727
   - path: core/permissions/__tests__/permission-mode.test.js
     hash: sha256:87df5f29666a599fb0fec917e0360ae6fa9dd90512f0816ae62fa453dbab7fbb
     type: core
@@ -1013,9 +1037,9 @@ files:
     type: data
     size: 34251
   - path: data/entity-registry.yaml
-    hash: sha256:ac383b2adae912c065b537029c218a05a0bd20cd89b41d8d83abf70b01a65569
+    hash: sha256:7b9bb3a5354107f9ec29105b5948d5c538e2a3b19d49fa42e2e785e4a767c38b
     type: data
-    size: 289345
+    size: 289966
   - path: data/learned-patterns.yaml
     hash: sha256:24ac0b160615583a0ff783d3da8af80b7f94191575d6db2054ec8e10a3f945dc
     type: data
@@ -1105,13 +1129,17 @@ files:
     type: agent
     size: 12076
   - path: development/agents/ux-design-expert.md
-    hash: sha256:5dde817f220f1f452b53026643e267eb027e4a131d1e5fc4bbcf6ebd772da3bb
+    hash: sha256:ae3f98570fa6cbd714ecd0aa2f44c7db005f0469b5bd04191d8da3b133bc65f1
     type: agent
-    size: 18376
+    size: 18377
   - path: development/checklists/agent-quality-gate.md
     hash: sha256:04d1bf12dd4b0b3d10de04c1825efab742e6475087d3ac9d5c86ca7ff8ec9057
     type: checklist
     size: 16148
+  - path: development/checklists/brownfield-compatibility-checklist.md
+    hash: sha256:d07b1f9e2fcb78f62188ef05a6e6f75a94821b6bb297ea67f2e782e260d27f49
+    type: checklist
+    size: 3335
   - path: development/checklists/self-critique-checklist.md
     hash: sha256:869fbc8fbc333ac8eea4eca3ea4ab9ca79917fa5e53735b70d634c85ac6420c8
     type: checklist
@@ -1397,9 +1425,9 @@ files:
     type: script
     size: 9847
   - path: development/scripts/workflow-state-manager.js
-    hash: sha256:56758b8af8b53b74b89b758d84feda85b73ea196704c2969573d183025f052d7
+    hash: sha256:f3573ec1ebd022d31422bf8dcd48df5891f698ab5a9489031bd56e0893087109
     type: script
-    size: 15764
+    size: 20129
   - path: development/scripts/workflow-validator.js
     hash: sha256:cb1c698f39984f128918e8a3a4e5aed254ca445c57b9f99fa183ef14abc0f0dc
     type: script
@@ -1849,9 +1877,9 @@ files:
     type: task
     size: 13356
   - path: development/tasks/next.md
-    hash: sha256:8ba7dc4567c0c7bf7001f0a26650767f72f45442d312daeb0e321ba4605ce429
+    hash: sha256:d9c84f8892367cd8e1bd453dd08876d051bcc368ca9eacf5d2babb26235427fb
     type: task
-    size: 6556
+    size: 7641
   - path: development/tasks/orchestrate-resume.md
     hash: sha256:5da88a904fc9e77d7428344fb83e55f6f4a3cae4f9d21d77092d1c67664c3d86
     type: task
@@ -2452,6 +2480,10 @@ files:
     hash: sha256:e46e4b86e48e22a6f0b7ccb91e7e901bfc779479d4ebc7e776fca6dd4de5b30b
     type: code
     size: 753
+  - path: infrastructure/contracts/compatibility/aios-4.0.4.yaml
+    hash: sha256:e8bea648df5d62a22a979b9d70e3987690db4e19a1ed3beec11d232746297136
+    type: infrastructure
+    size: 1074
   - path: infrastructure/index.js
     hash: sha256:8e05caec57188938d6f348444ad3abce2c06b53bdb46993fb2e8ff81c27fca4c
     type: infrastructure
@@ -2969,9 +3001,9 @@ files:
     type: script
     size: 6692
   - path: infrastructure/scripts/validate-parity.js
-    hash: sha256:1ec3b6c5863b4130a30f3844f9f148e86969011a8e557ca8b8d8f3bd5e96bd83
+    hash: sha256:527948d4a35a85c2f558b261f4b0a921d0482cab979e7dffe988b6fa11b7b2a1
     type: script
-    size: 3929
+    size: 12683
   - path: infrastructure/scripts/validate-paths.js
     hash: sha256:4360d0735ec2c717a97c1670855c5423cf5172005a93c4698b5305ccec48bc2e
     type: script
@@ -3344,6 +3376,10 @@ files:
     hash: sha256:bc1852d15e3a383c7519e5976094de3055c494fdd467acd83137700c900c4c61
     type: template
     size: 14755
+  - path: product/templates/brownfield-risk-report-tmpl.yaml
+    hash: sha256:173adec3131f0924bc7d64c10f54386bb85dcadc14e6ff3fb9bb2f8172caf162
+    type: template
+    size: 12211
   - path: product/templates/changelog-template.md
     hash: sha256:af44d857c9bf8808e89419d1d859557c3c827de143be3c0f36f2a053c9ee9197
     type: template
@@ -3941,9 +3977,9 @@ files:
     type: workflow-intelligence
     size: 8436
   - path: workflow-intelligence/engine/suggestion-engine.js
-    hash: sha256:1283f4a80e4bb00fe22b34822695c282d7a2ca3e2d1394f2923cd57b99a91f32
+    hash: sha256:7e07146e644edc39c5337bfc2f5eee621c39446be40cf303cdf418de97111796
     type: workflow-intelligence
-    size: 19809
+    size: 23441
   - path: workflow-intelligence/engine/wave-analyzer.js
     hash: sha256:0d017b70213584a11cad354d54d442be977b183353e6a5e31cc1de4291d0afb9
     type: workflow-intelligence

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.