mcp-efficiency-engine 0.1.0

package/scripts/setup/optimize-engines.ps1

@@ -0,0 +1,183 @@
+param(
+    [switch]$InstallMissing,
+    [switch]$DeepGitNexus,
+    [switch]$SkipRepomixRefresh,
+    [switch]$SkipCbmAutoIndex
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+function Get-PythonCommand {
+    if (Get-Command py -ErrorAction SilentlyContinue) {
+        return @('py', '-3.14')
+    }
+    if (Get-Command python -ErrorAction SilentlyContinue) {
+        return @('python')
+    }
+    throw 'Python no esta disponible (py/python).'
+}
+
+function Require-Command {
+    param(
+        [Parameter(Mandatory = $true)][string]$Name,
+        [switch]$Optional
+    )
+
+    if (Get-Command $Name -ErrorAction SilentlyContinue) {
+        Write-Host "[ok] comando disponible: $Name"
+        return $true
+    }
+
+    if ($Optional) {
+        Write-Host "[info] comando opcional ausente: $Name" -ForegroundColor DarkYellow
+        return $false
+    }
+
+    throw "Comando requerido no disponible: $Name"
+}
+
+$repoRoot = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
+Set-Location $repoRoot
+
+Write-Host '=== OPTIMIZE ENGINES ===' -ForegroundColor Cyan
+Write-Host "Repo: $repoRoot"
+
+if ($InstallMissing) {
+    Write-Host '[step] Instalando prerequisitos MCP faltantes...'
+    & pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\setup-prerequisites.ps1
+    if ($LASTEXITCODE -ne 0) {
+        throw "setup-prerequisites fallo con exit code $LASTEXITCODE"
+    }
+}
+
+Write-Host '[step] Validando contexto base...'
+& pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\validate-context.ps1
+if ($LASTEXITCODE -ne 0) {
+    throw "validate-context fallo con exit code $LASTEXITCODE"
+}
+
+Require-Command -Name 'codegraph' | Out-Null
+Require-Command -Name 'gitnexus' | Out-Null
+Require-Command -Name 'token-saver-mcp' | Out-Null
+Require-Command -Name 'codebase-memory-mcp' | Out-Null
+$hasRepomix = Require-Command -Name 'repomix' -Optional
+
+Write-Host '[step] Afinando .vscode/mcp.json para arranque local rapido...'
+$mcpPath = Join-Path $repoRoot '.vscode/mcp.json'
+$mcp = Get-Content -Raw -Path $mcpPath | ConvertFrom-Json -Depth 20
+
+$mcp.servers.gitnexus.command = 'gitnexus'
+$mcp.servers.gitnexus.args = @('mcp')
+
+$gitnexusServer = $mcp.servers.gitnexus
+$gitnexusEnv = [ordered]@{}
+if (($gitnexusServer.PSObject.Properties.Name -contains 'env') -and $gitnexusServer.env) {
+    if ($gitnexusServer.env -is [System.Collections.IDictionary]) {
+        foreach ($k in $gitnexusServer.env.Keys) {
+            $gitnexusEnv[[string]$k] = [string]$gitnexusServer.env[$k]
+        }
+    }
+    else {
+        foreach ($p in $gitnexusServer.env.PSObject.Properties) {
+            $gitnexusEnv[[string]$p.Name] = [string]$p.Value
+        }
+    }
+}
+
+# VECTOR index no esta disponible en Windows para LadybugDB; subimos el limite de exact-scan semantico.
+$gitnexusEnv['GITNEXUS_SEMANTIC_EXACT_SCAN_LIMIT'] = '50000'
+$gitnexusEnv['GITNEXUS_EMBEDDING_THREADS'] = '4'
+
+if ($gitnexusServer.PSObject.Properties.Name -contains 'env') {
+    $gitnexusServer.env = $gitnexusEnv
+}
+else {
+    $gitnexusServer | Add-Member -NotePropertyName env -NotePropertyValue $gitnexusEnv -Force
+}
+
+if ($hasRepomix) {
+    $mcp.servers.repomix.command = 'repomix'
+    $mcp.servers.repomix.args = @('--mcp')
+}
+
+$mcp | ConvertTo-Json -Depth 20 | Set-Content -Path $mcpPath -Encoding UTF8
+
+Write-Host '[step] Sincronizando CodeGraph...'
+& codegraph sync
+if ($LASTEXITCODE -ne 0) {
+    throw "codegraph sync fallo con exit code $LASTEXITCODE"
+}
+& codegraph status
+
+Write-Host '[step] Validando/optimizando indice GitNexus...'
+$doctor = gitnexus doctor | Out-String
+if ($doctor -match 'VECTOR index:\s+unavailable') {
+    Write-Host '[info] GitNexus sin VECTOR index en esta plataforma; se usa exact-scan con limite aumentado en MCP.' -ForegroundColor DarkYellow
+}
+$gStatus = gitnexus status | Out-String
+if ($gStatus -match 'Repository not indexed') {
+    gitnexus analyze . --skills
+}
+elseif ($DeepGitNexus) {
+    gitnexus analyze . --skills --embeddings
+}
+else {
+    Write-Host '[ok] GitNexus index presente; usa -DeepGitNexus para optimizacion completa con embeddings.'
+}
+
+Write-Host '[step] Validando runtime de Graphify...'
+$py = Get-PythonCommand
+$pyCmd = $py[0]
+$pyArgs = @()
+if ($py.Length -gt 1) {
+    $pyArgs = $py[1..($py.Length - 1)]
+}
+
+& $pyCmd @pyArgs -c "import graphify.serve, mcp; print('GRAPHIFY_OK')"
+if ($LASTEXITCODE -ne 0) {
+    throw 'Graphify runtime no disponible.'
+}
+
+if (-not $SkipCbmAutoIndex) {
+    Write-Host '[step] Habilitando auto-index en codebase-memory-mcp...'
+    & codebase-memory-mcp config set auto_index true
+    if ($LASTEXITCODE -ne 0) {
+        throw "codebase-memory-mcp config set auto_index fallo con exit code $LASTEXITCODE"
+    }
+    & codebase-memory-mcp config set auto_index_limit 50000
+    if ($LASTEXITCODE -ne 0) {
+        throw "codebase-memory-mcp config set auto_index_limit fallo con exit code $LASTEXITCODE"
+    }
+}
+
+if (-not (Test-Path '.\context\graphify-out\graph.json')) {
+    Write-Host '[step] Generando graph.json de Graphify...'
+    & $pyCmd @pyArgs -m graphify extract scripts --no-cluster --out context
+    if ($LASTEXITCODE -ne 0) {
+        throw "graphify extract fallo con exit code $LASTEXITCODE"
+    }
+}
+
+if (-not $SkipRepomixRefresh) {
+    if ($hasRepomix) {
+        Write-Host '[step] Refrescando snapshot Repomix...'
+        & pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\context\build-repomix.ps1
+        if ($LASTEXITCODE -ne 0) {
+            throw "build-repomix fallo con exit code $LASTEXITCODE"
+        }
+    }
+    else {
+        Write-Host '[info] Repomix no instalado; se omite refresh de snapshot.' -ForegroundColor DarkYellow
+    }
+}
+
+Write-Host '[step] Ejecutando smoke de routing...'
+& $pyCmd @pyArgs .\scripts\intake\run-routing-evals.py
+if ($LASTEXITCODE -ne 0) {
+    throw "run-routing-evals fallo con exit code $LASTEXITCODE"
+}
+
+Write-Host ''
+Write-Host 'Motores optimizados y validados.' -ForegroundColor Green
+Write-Host 'Recomendado: reiniciar VS Code/Copilot Chat para recargar MCP con los comandos locales.'

package/scripts/setup/setup-codegraph.ps1

@@ -0,0 +1,3 @@
+npm install -g @colbymchenry/codegraph
+codegraph install
+codegraph init

package/scripts/setup/setup-gitnexus.ps1

@@ -0,0 +1,3 @@
+npm install -g gitnexus@latest
+gitnexus setup
+gitnexus analyze

package/scripts/setup/setup-graphify.ps1

@@ -0,0 +1,2 @@
+uv tool install graphify
+graphify install --project

package/scripts/setup/setup-prerequisites.ps1

@@ -0,0 +1,205 @@
+param(
+    [switch]$SkipCodebaseMemory,
+    [switch]$SkipTokenSaver,
+    [switch]$SkipCodegraph,
+    [switch]$SkipGitnexus,
+    [switch]$SkipGraphify,
+    [switch]$SkipRepomix,
+    [switch]$PortableMode
+)
+
+$ErrorActionPreference = 'Stop'
+
+$repoRoot = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
+Set-Location $repoRoot
+$toolingManifestPath = Join-Path $repoRoot 'tooling/tooling.manifest.json'
+
+function Test-Command {
+    param([Parameter(Mandatory = $true)][string]$Name)
+
+    return [bool](Get-Command -Name $Name -ErrorAction SilentlyContinue)
+}
+
+function Install-NpmGlobalPackage {
+    param(
+        [Parameter(Mandatory = $true)][string]$Package,
+        [Parameter(Mandatory = $true)][string]$ExpectedCommand
+    )
+
+    if (Test-Command $ExpectedCommand) {
+        Write-Host "[ok] $ExpectedCommand already installed"
+        return
+    }
+
+    if (-not (Test-Command 'npm')) {
+        throw "npm is required to install $Package. Install Node.js first: https://nodejs.org/"
+    }
+
+    Write-Host "[install] npm install -g $Package"
+    npm install -g $Package
+}
+
+function Get-ToolingManifest {
+    param([Parameter(Mandatory = $true)][string]$Path)
+
+    if (-not (Test-Path $Path)) {
+        throw "Missing tooling manifest: $Path"
+    }
+
+    return Get-Content -Raw -Path $Path | ConvertFrom-Json -Depth 20
+}
+
+function Install-ToolFromManifest {
+    param([Parameter(Mandatory = $true)][object]$Tool)
+
+    $commandName = [string]$Tool.command
+    if (Test-Command $commandName) {
+        Write-Host "[ok] $commandName already installed"
+        return
+    }
+
+    $install = $Tool.install
+    $installKind = [string]$install.kind
+
+    switch ($installKind) {
+        'npm-global' {
+            Install-NpmGlobalPackage -Package ([string]$install.package) -ExpectedCommand $commandName
+        }
+        'powershell-script' {
+            $scriptUrl = [string]$install.script_url
+            if (-not $scriptUrl) {
+                throw "Missing script_url for manifest tool $($Tool.name)"
+            }
+
+            Write-Host "[install] $commandName via official Windows setup script"
+            Invoke-RestMethod $scriptUrl | Invoke-Expression
+        }
+        default {
+            throw "Unsupported install kind '$installKind' for manifest tool $($Tool.name)"
+        }
+    }
+}
+
+function Test-PythonImport {
+    param(
+        [Parameter(Mandatory = $true)][string]$PythonCommand,
+        [string[]]$PythonArgs = @(),
+        [Parameter(Mandatory = $true)][string]$Module
+    )
+
+    & $PythonCommand @PythonArgs -c "import $Module" *> $null
+    return ($LASTEXITCODE -eq 0)
+}
+
+function Install-PythonRequirements {
+    param(
+        [Parameter(Mandatory = $true)][string]$PythonCommand,
+        [string[]]$PythonArgs = @(),
+        [Parameter(Mandatory = $true)][string]$RequirementsPath
+    )
+
+    if (-not (Test-Path $RequirementsPath)) {
+        throw "Missing Python requirements file: $RequirementsPath"
+    }
+
+    Write-Host "[install] $PythonCommand $($PythonArgs -join ' ') -m pip install -r $RequirementsPath"
+    & $PythonCommand @PythonArgs -m pip install -r $RequirementsPath
+    if ($LASTEXITCODE -ne 0) {
+        throw "Failed to install Python requirements from $RequirementsPath"
+    }
+}
+
+function Resolve-PythonCommand {
+    if (Test-Command 'py') {
+        return @('py', '-3.14')
+    }
+    if (Test-Command 'python') {
+        return @('python')
+    }
+    throw 'Python 3.14 is required for graphify MCP. Install Python first: https://www.python.org/downloads/'
+}
+
+Write-Host '== MCP platform prerequisites setup =='
+
+$toolingManifest = Get-ToolingManifest -Path $toolingManifestPath
+$externalCliEntries = @($toolingManifest.external_clis)
+$toolByCommand = @{}
+foreach ($tool in $externalCliEntries) {
+    $toolByCommand[[string]$tool.command] = $tool
+}
+
+if (-not $SkipCodebaseMemory) {
+    Install-ToolFromManifest -Tool $toolByCommand['codebase-memory-mcp']
+}
+
+if (-not $SkipTokenSaver) {
+    Install-ToolFromManifest -Tool $toolByCommand['token-saver-mcp']
+}
+
+if (-not $SkipCodegraph) {
+    Install-ToolFromManifest -Tool $toolByCommand['codegraph']
+    Write-Host '[setup] codegraph install'
+    codegraph install
+    if (-not (Test-Path '.codegraph')) {
+        Write-Host '[setup] codegraph init -i'
+        codegraph init -i
+    }
+    else {
+        Write-Host '[ok] .codegraph index already exists'
+    }
+}
+
+if (-not $SkipGitnexus) {
+    Install-ToolFromManifest -Tool $toolByCommand['gitnexus']
+    Write-Host '[setup] gitnexus setup'
+    gitnexus setup
+}
+
+if (-not $SkipRepomix) {
+    Install-ToolFromManifest -Tool $toolByCommand['repomix']
+}
+
+if (-not $SkipGraphify) {
+    $py = Resolve-PythonCommand
+    $pyCmd = $py[0]
+    $pyArgs = @()
+    if ($py.Length -gt 1) {
+        $pyArgs = $py[1..($py.Length - 1)]
+    }
+
+    if ($py.Length -gt 1) {
+        Write-Host "[setup] Using Python launcher: $($py -join ' ')"
+    }
+    else {
+        Write-Host "[setup] Using Python launcher: $pyCmd"
+    }
+
+    Install-PythonRequirements -PythonCommand $pyCmd -PythonArgs $pyArgs -RequirementsPath 'requirements.txt'
+
+    if (-not (Test-PythonImport -PythonCommand $pyCmd -PythonArgs $pyArgs -Module 'graphify.serve')) {
+        throw 'graphify.serve import failed after installation.'
+    }
+
+    if (-not (Test-PythonImport -PythonCommand $pyCmd -PythonArgs $pyArgs -Module 'mcp')) {
+        throw 'mcp module import failed after graphify installation.'
+    }
+
+    if (-not (Test-Path 'context/graphify-out/graph.json')) {
+        Write-Host '[setup] graphify extract scripts --no-cluster --out context'
+        & $pyCmd @pyArgs -m graphify extract scripts --no-cluster --out context
+    }
+    else {
+        Write-Host '[ok] context/graphify-out/graph.json already exists'
+    }
+}
+
+Write-Host ''
+Write-Host 'Setup complete. Recommended next checks:'
+if ($PortableMode) {
+    Write-Host '  1) .\scripts\setup\validate-context.ps1 -PortableMode'
+}
+else {
+    Write-Host '  1) .\scripts\setup\validate-context.ps1'
+}
+Write-Host '  2) .\scripts\intake\run-repo-intake.cmd'
+Write-Host '  3) /mcp (in your agent) to verify servers are active'

package/scripts/setup/start-gitnexus.ps1

@@ -0,0 +1,71 @@
+param(
+    [switch]$ForceReindex,
+    [switch]$NoServe,
+    [switch]$NoOpenBrowser,
+    [string]$BindHost = '127.0.0.1',
+    [int]$Port = 4747,
+    [int]$WaitSeconds = 12
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Test-GitNexusEndpoint {
+    param(
+        [string]$Url
+    )
+
+    try {
+        $response = Invoke-WebRequest -UseBasicParsing -Uri $Url -TimeoutSec 2
+        return ($response.StatusCode -ge 200 -and $response.StatusCode -lt 500)
+    }
+    catch {
+        return $false
+    }
+}
+
+if (-not (Get-Command gitnexus -ErrorAction SilentlyContinue)) {
+    throw 'gitnexus no esta instalado o no esta en PATH. Ejecuta scripts/setup/setup-prerequisites.ps1 primero.'
+}
+
+$status = gitnexus status | Out-String
+$needsIndex = $ForceReindex -or ($status -match 'Repository not indexed')
+
+if ($needsIndex) {
+    Write-Host '[gitnexus] Indexando repositorio actual...'
+    gitnexus analyze .
+}
+else {
+    Write-Host '[gitnexus] Repositorio ya indexado.'
+}
+
+$url = "http://$BindHost`:$Port"
+
+if (-not $NoServe) {
+    if (Test-GitNexusEndpoint -Url $url) {
+        Write-Host "[gitnexus] Backend ya activo en $url"
+    }
+    else {
+        Write-Host "[gitnexus] Iniciando backend en $url ..."
+        Start-Process -FilePath 'cmd.exe' -ArgumentList "/c gitnexus serve --host $BindHost --port $Port" -WindowStyle Minimized | Out-Null
+
+        $started = $false
+        for ($i = 0; $i -lt $WaitSeconds; $i++) {
+            Start-Sleep -Seconds 1
+            if (Test-GitNexusEndpoint -Url $url) {
+                $started = $true
+                break
+            }
+        }
+
+        if (-not $started) {
+            Write-Host "[gitnexus] Aviso: no hubo respuesta HTTP en $url tras $WaitSeconds s." -ForegroundColor DarkYellow
+        }
+    }
+}
+
+if (-not $NoOpenBrowser) {
+    Write-Host "[gitnexus] Abriendo UI: $url"
+    Start-Process $url
+}
+
+Write-Host '[gitnexus] Listo.'