mcp-efficiency-engine 0.1.0

package/.github/skills/human-in-the-loop/SKILL.md

@@ -0,0 +1,47 @@
+# Human In The Loop (HITL)
+
+## Purpose
+
+Asegurar confirmacion humana solo cuando una decision o accion tiene riesgo alto, impacto externo o potencial destructivo.
+
+## Scope
+
+Aplicar en todas las rutas del sistema como capa transversal.
+
+## Always-On Behavior
+
+- Deteccion automatica de riesgo desde intent/domain/source/notes de routing.
+- No pedir confirmacion para rutas de bajo riesgo.
+- Pedir confirmacion cuando exista riesgo alto o fallback de routing.
+- Bloquear ejecucion para acciones destructivas hasta aprobacion explicita.
+
+## Risk Triggers
+
+- deploy, production
+- migrate, migration
+- delete, drop, destroy, remove
+- governance, policy
+- security, rbac, role
+- unresolved_dependencies
+- routing_fallback
+
+## Actions
+
+- `none`: continuar sin aprobacion.
+- `request_human_confirmation`: solicitar confirmacion antes de ejecutar.
+- `block_until_human_approval`: bloquear hasta aprobacion humana.
+
+## Observability Contract
+
+Cada evento de routing debe incluir `hitl`:
+
+- `mode`: `always_on_auto`
+- `required`: `true|false`
+- `action`: `none|request_human_confirmation|block_until_human_approval`
+- `reason`: motivo legible y trazable
+
+## Guardrails
+
+- Nunca cachear secretos, credenciales, tokens o PII.
+- Si hay duda de sensibilidad, declarar gap y no cachear.
+- Confirmaciones humanas solo para impacto real; evitar friccion en bajo riesgo.

package/.github/skills/iot-architecture/SKILL.md

@@ -0,0 +1,22 @@
+# IoT Architecture Skill
+
+## Purpose
+
+Handle IoT/edge/telemetry tasks combining code and technical docs.
+
+## When To Use
+
+- IoT architecture questions
+- edge data-flow analysis
+- mixed code+docs diagnostics in IoT domain
+
+## Workflow
+
+1. Map device-edge-cloud flow.
+2. Identify protocol, telemetry and dependency boundaries.
+3. Recommend minimal-risk architectural or code changes.
+
+## Guardrails
+
+- Keep retrieval targeted.
+- State assumptions about runtime topology.

package/.github/skills/legacy-migration/SKILL.md

@@ -0,0 +1,22 @@
+# Legacy Migration Skill
+
+## Purpose
+
+Assess legacy and multi-repo change impact before execution.
+
+## When To Use
+
+- migration plans
+- legacy code modernization
+- high-blast-radius refactors
+
+## Workflow
+
+1. Map dependencies and downstream consumers.
+2. Identify breakage risks and migration order.
+3. Propose phased rollout and rollback strategy.
+
+## Guardrails
+
+- Prefer compatibility-first changes.
+- Highlight unknowns explicitly.

package/.github/skills/rag-knowledge/SKILL.md

@@ -0,0 +1,21 @@
+# RAG Knowledge Skill
+
+## Purpose
+
+Answer technical/local documentation questions from local knowledge sources.
+
+## When To Use
+
+- source_type is `technical-docs`
+- agent route is `rag-local`
+
+## Workflow
+
+1. Retrieve minimal relevant local nodes/chunks.
+2. Synthesize concise technical answer.
+3. Mention evidence basis or declare a gap.
+
+## Guardrails
+
+- No unsupported claims.
+- Keep context scope minimal.

package/.github/skills/token-saver/SKILL.md

@@ -0,0 +1,36 @@
+# Token Saver Skill — Always On
+
+## Estado
+
+Siempre activo.
+
+## Propósito
+
+Reducir coste, contexto y ruido en cualquier herramienta o agente.
+
+## Reglas
+
+1. Iniciar toda tarea identificando el contexto mínimo necesario.
+2. Evitar discovery completo.
+3. Preferir consultas estructuradas:
+   - símbolo,
+   - endpoint,
+   - tabla,
+   - nodo,
+   - chunk,
+   - fuente,
+   - manifest.
+4. Limitar Azure RAG a fuentes relevantes.
+5. Limitar Graphify a nodos/reportes relevantes.
+6. Limitar Repomix por scope.
+7. Registrar gap cuando falte evidencia.
+
+## Por agente
+
+- backend: CodeGraph con símbolo/call path.
+- legacy: GitNexus con flow/dependency concreto.
+- dba: Graphify con schema/query relevante.
+- rag-local: Graphify con nodos/fuentes.
+- rag-azure: Azure RAG Builder con fuentes y top-k limitado.
+- iot: combinar solo si hace falta.
+- community-manager: contexto suficiente, no todo el corpus.

package/.github/skills/ux-ui-governance/SKILL.md

@@ -0,0 +1,24 @@
+# UX UI Governance Skill
+
+## Purpose
+
+Apply UX/UI quality gates and design-intent controls grounded in project guidelines.
+
+## When To Use
+
+- ux-ui reviews
+- design system alignment checks
+- accessibility and consistency checks before delivery
+
+## Workflow
+
+1. Recover UX/UI context and constraints from approved sources.
+2. Evaluate consistency, usability, accessibility, and design intent.
+3. Produce prioritized findings with actionable fixes.
+4. Register validated learnings for future routing.
+
+## Guardrails
+
+- Do not redesign outside requested scope.
+- Preserve existing product constraints and brand language.
+- Prefer minimal changes with measurable UX impact.

package/.github/skills/wiki-tools.json

@@ -0,0 +1,24 @@
+{
+  "skills": [
+    {
+      "name": "compile_autodocs",
+      "description": "Ejecuta de forma incremental el compilador de AutoDocs para procesar nodos sucios de conocimiento y proyectarlos a Markdown.",
+      "command": "py -3 -m scripts.wiki.wiki_compiler",
+      "parameters": {}
+    },
+    {
+      "name": "query_autodocs_graph",
+      "description": "Consulta directa del Grafo de Conocimiento Unificado estructurado en formato JSON.",
+      "command": "py -3 -c \"import json; print(json.load(open('autodocs/generated/unified-graph.json', encoding='utf-8')))\"",
+      "parameters": {}
+    },
+    {
+      "name": "query_autodocs_search",
+      "description": "Busqueda local simple sobre el manifest de AutoDocs por titulo, resumen, kind o tags.",
+      "command": "py -3 -m scripts.wiki.query_autodocs",
+      "parameters": {
+        "query": "string"
+      }
+    }
+  ]
+}

package/.github/workflows/auto-devlog.yml

@@ -0,0 +1,56 @@
+name: Auto-Generate DevLog
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      commits_to_analyze:
+        description: 'Commits to analyze'
+        required: false
+        default: '10'
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  devlog:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 100
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install PowerShell
+        run: sudo apt-get update && sudo apt-get install -y powershell
+
+      - name: Generate devlog
+        run: pwsh scripts/github/create-devlog.ps1 -CommitsToAnalyze 10 -DryRun
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        continue-on-error: true
+
+      - name: Check if devlog was created
+        id: check_devlog
+        run: |
+          if (Test-Path "autodocs/site/devlog/devlog-$(Get-Date -Format 'yyyy-MM-dd').md") {
+            echo "created=true" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
+            echo "filename=devlog-$(Get-Date -Format 'yyyy-MM-dd').md" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
+          } else {
+            echo "created=false" | Out-File -FilePath $env:GITHUB_OUTPUT -Encoding utf8 -Append
+          }
+        shell: pwsh
+        continue-on-error: true
+
+      - name: Report summary
+        run: |
+          echo "✅ DevLog workflow completed" >> $GITHUB_STEP_SUMMARY
+          echo "- Analyzed commits: 10" >> $GITHUB_STEP_SUMMARY
+          echo "- Devlog created: ${{ steps.check_devlog.outputs.created }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Next:** DevLog files are in autodocs/site/devlog/" >> $GITHUB_STEP_SUMMARY

package/.github/workflows/auto-manage-issues.yml

@@ -0,0 +1,64 @@
+name: Auto-Manage Issues
+
+on:
+  schedule:
+    - cron: '0 9 * * MON'  # Every Monday at 9 AM UTC
+  workflow_dispatch:
+    inputs:
+      action:
+        description: 'Action: assign, review, or close'
+        required: true
+        default: 'assign'
+        type: choice
+        options:
+          - assign
+          - review
+          - close
+          - all
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+jobs:
+  manage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - name: Install PowerShell
+        run: sudo apt-get update && sudo apt-get install -y powershell
+
+      - name: Install PowerShell
+        run: sudo apt-get update && sudo apt-get install -y powershell
+
+      - name: Run issue management (DryRun)
+        run: |
+          echo "👥 Checking open issues..."
+          gh issue list --limit 5 --json title,state
+          echo ""
+          echo "Workflow ready for manual execution"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        continue-on-error: true
+
+      - name: Create activity report
+        run: |
+          echo "📊 Issue Management Report — $(date)" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Status:** Ready for manual trigger" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Available actions:" >> $GITHUB_STEP_SUMMARY
+          echo "- \`gh workflow run auto-manage-issues.yml\` (default: assign)" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "To manage issues manually:" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+          echo "pwsh scripts/github/manage-issues.ps1 -Action assign" >> $GITHUB_STEP_SUMMARY
+          echo "pwsh scripts/github/manage-issues.ps1 -Action review" >> $GITHUB_STEP_SUMMARY
+          echo "pwsh scripts/github/manage-issues.ps1 -Action close" >> $GITHUB_STEP_SUMMARY
+          echo "\`\`\`" >> $GITHUB_STEP_SUMMARY

package/.github/workflows/auto-sync.yml

@@ -0,0 +1,54 @@
+name: Auto-Sync to boost_sertxIA
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'projects/**'
+      - '.github/specs/**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+
+      - uses: azure/setup-kubectl@v3
+
+      - name: Install PowerShell
+        run: sudo apt-get update && sudo apt-get install -y powershell
+
+      - name: Configure GitHub CLI
+        run: |
+          gh auth status || echo "✓ GitHub CLI disponible"
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install PowerShell
+        run: sudo apt-get update && sudo apt-get install -y powershell
+
+      - name: Run sync script (DryRun)
+        run: pwsh scripts/github/sync-repo.ps1 -DryRun
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        continue-on-error: true
+
+      - name: Report summary
+        run: |
+          echo "✅ Auto-Sync workflow completed" >> $GITHUB_STEP_SUMMARY
+          echo "- Sync check: Completed" >> $GITHUB_STEP_SUMMARY
+          echo "- Source: projects/** changes" >> $GITHUB_STEP_SUMMARY
+          echo "- Target: boost_sertxIA" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Note:** Running in DryRun mode. Manual sync available on demand." >> $GITHUB_STEP_SUMMARY

package/.github/workflows/autodocs-sync.yml

@@ -0,0 +1,114 @@
+name: AutoDocs Sync
+
+on:
+  push:
+    branches: [ main, develop ]
+    paths:
+      - 'repo-intake/generated/**'
+      - 'autodocs/**'
+      - 'scripts/wiki/**'
+      - 'orchestrator/wiki/**'
+      - '.github/skills/wiki-tools.json'
+      - '.github/agents/wiki-agent.agent.md'
+  pull_request:
+    branches: [ main, develop ]
+    paths:
+      - 'repo-intake/generated/**'
+      - 'autodocs/**'
+      - 'scripts/wiki/**'
+      - 'orchestrator/wiki/**'
+      - '.github/skills/wiki-tools.json'
+      - '.github/agents/wiki-agent.agent.md'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  autodocs-pr-check:
+    if: github.event_name == 'pull_request'
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+
+      - name: Compile AutoDocs
+        run: py -3 -m scripts.wiki.wiki_compiler
+        shell: pwsh
+
+      - name: Validate generated artifacts are committed
+        shell: pwsh
+        run: |
+          git add autodocs/generated
+          git add autodocs/site
+          $changes = git status --porcelain -- autodocs/generated autodocs/site
+          if ([string]::IsNullOrWhiteSpace($changes)) {
+            Write-Host "AutoDocs artifacts are up to date"
+          } else {
+            Write-Host "Detected generated drift:"
+            Write-Host $changes
+            Write-Error "AutoDocs artifacts are outdated. Run: py -3 -m scripts.wiki.wiki_compiler and commit generated changes."
+            exit 1
+          }
+
+      - name: Summary
+        shell: pwsh
+        run: |
+          echo "## AutoDocs PR Check" >> $env:GITHUB_STEP_SUMMARY
+          echo "- Validation mode: strict" >> $env:GITHUB_STEP_SUMMARY
+          echo "- Entrypoint: py -3 -m scripts.wiki.wiki_compiler" >> $env:GITHUB_STEP_SUMMARY
+          echo "- Required artifacts: autodocs/generated + autodocs/site" >> $env:GITHUB_STEP_SUMMARY
+
+  autodocs-sync:
+    if: github.event_name != 'pull_request' && github.actor != 'github-actions[bot]'
+    permissions:
+      contents: write
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+
+      - name: Compile AutoDocs
+        run: py -3 -m scripts.wiki.wiki_compiler
+        shell: pwsh
+
+      - name: Commit projected docs and unified graph
+        shell: pwsh
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add autodocs/generated
+          git add autodocs/site
+          $changes = git status --porcelain -- autodocs/generated autodocs/site
+          if ([string]::IsNullOrWhiteSpace($changes)) {
+            Write-Host "No AutoDocs changes to commit"
+          } else {
+            Write-Host "Detected generated drift:"
+            Write-Host $changes
+            git commit -m "chore(autodocs): refresh unified graph and projection"
+            git push
+          }
+
+      - name: Summary
+        shell: pwsh
+        run: |
+          echo "## AutoDocs Sync" >> $env:GITHUB_STEP_SUMMARY
+          echo "- Entrypoint: py -3 -m scripts.wiki.wiki_compiler" >> $env:GITHUB_STEP_SUMMARY
+          echo "- Output graph: autodocs/generated/unified-graph.json" >> $env:GITHUB_STEP_SUMMARY
+          echo "- Projection dir: autodocs/site" >> $env:GITHUB_STEP_SUMMARY

package/.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI General — Spec Validation
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  validate:
+    name: Validate Specs & Code (Windows)
+    runs-on: windows-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Compile Python scripts
+        run: python -m compileall -q .\scripts
+        shell: pwsh
+        env:
+          PYTHONIOENCODING: utf-8
+
+      - name: Validate routing evals
+        run: py -3 .\scripts\intake\run-routing-evals.py
+        shell: pwsh
+        env:
+          PYTHONIOENCODING: utf-8
+
+      - name: Validate security
+        run: py -3 .\scripts\intake\validate-security.py
+        shell: pwsh
+        env:
+          PYTHONIOENCODING: utf-8
+
+      - name: Validate database routing
+        run: py -3 .\scripts\intake\validate-database-routing.py
+        shell: pwsh
+        env:
+          PYTHONIOENCODING: utf-8
+
+      - name: Validate RAG routing
+        run: py -3 .\scripts\intake\validate-rag-routing.py
+        shell: pwsh
+        env:
+          PYTHONIOENCODING: utf-8
+
+      - name: Validate context
+        run: pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\validate-context.ps1 -CIMode
+        shell: pwsh
+
+      - name: Upload eval report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: routing-eval-report
+          path: observability/evals/routing-eval-report.json
+          retention-days: 30
+

package/.github/workflows/pages.yml

@@ -0,0 +1,59 @@
+name: Deploy GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - "autodocs/**"
+      - ".github/workflows/pages.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build documentation
+    runs-on: ubuntu-latest
+    
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby + Bundler
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.1'
+          bundler-cache: true
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Build with Jekyll
+        run: bundle exec jekyll build --source ./autodocs/site --destination ./build
+        env:
+          JEKYLL_ENV: production
+
+      - name: Upload artifacts
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './build'
+
+  deploy:
+    name: Deploy to GitHub Pages
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

package/.github/workflows/routing-evals.yml

@@ -0,0 +1,59 @@
+name: Routing Evals Gate
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: routing-evals-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  routing-evals:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Run routing evals
+        run: python ./scripts/intake/run-routing-evals.py
+
+      - name: Verify all tests passed
+        run: |
+          python - <<'PY'
+          import json
+          from pathlib import Path
+          
+          report = Path('observability/evals/routing-eval-report.json')
+          if not report.exists():
+              raise SystemExit('routing-eval-report.json not found')
+          
+          data = json.loads(report.read_text(encoding='utf-8'))
+          failed = int(data.get('cases_failed', 0))
+          total = int(data.get('cases_total', 0))
+          passed = int(data.get('cases_passed', 0))
+          print(f'Routing evals: {passed}/{total} passed, failed={failed}')
+          if failed > 0:
+              raise SystemExit(1)
+          PY
+
+      - name: Upload eval report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: routing-eval-report
+          path: observability/evals/routing-eval-report.json
+          retention-days: 30