mcp-efficiency-engine 0.1.6 → 0.1.8

package/FINAL_USAGE_GUIDE.md

@@ -95,6 +95,14 @@ npm install mcp-efficiency-engine
 
 Si el entorno bloquea scripts de npm (`allow-scripts`), ejecutar manualmente:
 
+```powershell
+npm install mcp-efficiency-engine
+npm approve-scripts mcp-efficiency-engine
+npm rebuild mcp-efficiency-engine
+```
+
+Alternativa manual equivalente:
+
 ```powershell
 npx mcp-efficiency-engine install
 npx mcp-efficiency-engine validate -PortableMode

package/README.md

@@ -190,13 +190,21 @@ Comportamiento esperado:
 
 - copia al proyecto host los artefactos canonicos del engine (`scripts`, `.github`, `.vscode`, `repo-intake`, `orchestrator`, `policies`, `observability`, `autodocs/schema`, `memory`, etc.)
 - instala motores y herramientas via bootstrap portable
-- si no existe `repo-registry/repos.yml`, pregunta por owner/prefix y si quieres registrar un repo inicial para intake
-- si no añades repos en ese momento, deja el registry plantilla listo para añadirlos despues y rerun de intake
+- si no existe `repo-registry/repos.yml`, en modo interactivo pregunta por owner/prefix y repo inicial para intake
+- si la instalacion corre en modo no interactivo (comun en lifecycle scripts de npm), crea automaticamente un repo inicial por defecto: dominio `dev`, location `.`
 
 Nota npm (entornos con politicas de scripts):
 
-- si `npm` bloquea `install`/`postinstall` (por ejemplo con `allow-scripts`), el scaffold/bootstrapping puede no ejecutarse automaticamente
-- en ese caso, aprueba scripts (`npm approve-scripts`) o ejecuta manualmente:
+- si `npm` bloquea `install`/`postinstall` (por ejemplo con `allow-scripts`), el scaffold/bootstrapping no se ejecuta automaticamente
+- flujo recomendado en dos pasos:
+
+```powershell
+npm install mcp-efficiency-engine
+npm approve-scripts mcp-efficiency-engine
+npm rebuild mcp-efficiency-engine
+```
+
+- alternativa manual equivalente:
 
 ```powershell
 npx mcp-efficiency-engine install
@@ -217,6 +225,44 @@ npm install -g mcp-efficiency-engine
 mcpee install
 ```
 
+### Cuando se conectan boosts/repos auxiliares
+
+Resumen rapido:
+
+- `npm install` + `rebuild` instala/configura el engine.
+- La conexion real de boosts/repos ocurre al ejecutar intake.
+- Si no configuras repos adicionales, se usa el repo inicial por defecto.
+
+Flujo recomendado para nuevos usuarios:
+
+- `repo-registry/repos.template.json`: plantilla guiada con dominios y ejemplos.
+- `repo-registry/repos.yml`: registry operativo que consume el intake.
+- `scripts/intake/init-template-registry.cmd`: inicializa `repos.yml` desde la plantilla y pregunta owner/prefix/repo inicial.
+
+Pasos recomendados despues de instalar:
+
+```powershell
+# 1) Inicializar registry operativo desde la plantilla (modo asistido)
+.\scripts\intake\init-template-registry.cmd
+
+# 2) (Opcional) ajustar repos auxiliares/boosts
+notepad .\repo-registry\repos.yml
+
+# 3) materializar capacidades de todos los repos del registry
+.\scripts\intake\run-repo-intake.cmd
+
+# 4) validar que el router ya los ve
+.\scripts\ops\hi.ps1
+```
+
+Si quieres preparar entradas manuales, usa los ejemplos de `repo-registry/repos.template.json` (`local`, `github`, `rag_local_github`, `azure_rag_github`) y copialos a `repos.yml`.
+
+Si quieres que te pregunte por owner/prefix/repo inicial en modo asistido, ejecuta:
+
+```powershell
+npx mcp-efficiency-engine install
+```
+
 ### 2) Validación mínima
 
 ```powershell

package/bin/install-host.js

@@ -238,6 +238,15 @@ function deriveRepoPrefix(targetRoot, options) {
   return `${path.basename(targetRoot).replace(/[^a-zA-Z0-9_-]/g, "-").toLowerCase()}_`;
 }
 
+function deriveDefaultRepoName(targetRoot, options) {
+  if (options.initialRepoName) {
+    return options.initialRepoName;
+  }
+
+  const safeBaseName = path.basename(targetRoot).replace(/[^a-zA-Z0-9_-]/g, "-").toLowerCase();
+  return `${deriveRepoPrefix(targetRoot, options)}${safeBaseName}`;
+}
+
 function initializeTemplateRegistry(targetRoot, options) {
   const registryPath = path.join(targetRoot, "repo-registry", "repos.yml");
   if (fs.existsSync(registryPath)) {
@@ -245,14 +254,28 @@ function initializeTemplateRegistry(targetRoot, options) {
   }
 
   const initScript = path.join(targetRoot, "scripts", "intake", "init-template-registry.ps1");
+  const resolvedPrefix = deriveRepoPrefix(targetRoot, options);
   const args = [
     "-Owner",
     options.owner || "your-team",
     "-RepoNamePrefix",
-    deriveRepoPrefix(targetRoot, options),
-    "-SkipInitialRepo",
+    resolvedPrefix,
   ];
 
+  if (options.skipInitialRepo) {
+    args.push("-SkipInitialRepo");
+  }
+  else {
+    args.push(
+      "-InitialRepoName",
+      deriveDefaultRepoName(targetRoot, options),
+      "-InitialRepoDomain",
+      options.initialRepoDomain || "dev",
+      "-InitialRepoLocation",
+      options.initialRepoLocation || ".",
+    );
+  }
+
   return runPowerShell(initScript, args, targetRoot);
 }
 
@@ -314,7 +337,8 @@ function runHostInstall(rawOptions) {
       return hookStatus;
     }
 
-    process.stdout.write("[mcpee] Modo no interactivo detectado. Se inicializo el registry plantilla y se omitio bootstrap interactivo.\n");
+    process.stdout.write("[mcpee] Modo no interactivo detectado. Se inicializo repos.yml con un repo inicial por defecto y se omitio bootstrap interactivo.\n");
+    process.stdout.write("[mcpee] Si npm bloqueo scripts, ejecuta: npm approve-scripts mcp-efficiency-engine ; npm rebuild mcp-efficiency-engine\n");
     return 0;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-efficiency-engine",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Motor de orquestacion para agentes MCP con routing por dominio y bootstrap portable.",
   "license": "MIT",
   "type": "commonjs",

package/repo-registry/repos.template.json

@@ -1,6 +1,33 @@
 {
   "registry_mode": "template",
   "schema_version": "2.0",
+  "onboarding_help": {
+    "what_is_this": "Define aqui los repos/boosts que quieres conectar al motor de routing.",
+    "quick_start": [
+      "1) Duplica un ejemplo de repo_examples dentro de repos[]",
+      "2) Ajusta domain, type y location/repo_url",
+      "3) Ejecuta scripts/intake/run-repo-intake.cmd",
+      "4) Ejecuta scripts/ops/hi.ps1 para validar"
+    ],
+    "required_fields": [
+      "name",
+      "domain",
+      "type",
+      "location (si type=local)",
+      "repo_url (si type=github)"
+    ],
+    "domain_reference": {
+      "backend": "Codigo backend en repo unico (CodeGraph)",
+      "frontend": "Codigo frontend en repo unico (CodeGraph)",
+      "community-content": "Contenido/comunidad/documentacion de apoyo",
+      "legacy": "Migracion/impacto multi-repo (GitNexus)",
+      "dba": "SQL, esquema y conocimiento de base de datos",
+      "iot": "IoT/edge/telemetria",
+      "ux-ui": "Patrones de diseno, UX y design system",
+      "azure-rag": "Contratos/politicas enterprise con Azure RAG",
+      "rag": "RAG local con docs tecnicas"
+    }
+  },
   "governance": {
     "owner": "your-team",
     "approval_required": false,
@@ -12,7 +39,14 @@
       "name": "your-prefix_backend_local",
       "domain": "backend",
       "type": "local",
-      "location": "../your-backend-repo"
+      "location": "../your-backend-repo",
+      "optional": false,
+      "dependencies": [],
+      "engines": {
+        "knowledge": "codegraph",
+        "execution": "none",
+        "snapshot": "repomix"
+      }
     },
     "github": {
       "name": "your-prefix_backend_remote",
@@ -20,7 +54,44 @@
       "type": "github",
       "repo_url": "https://github.com/your-org/your-repo.git",
       "branch": "main",
-      "cache_location": ".cache/github-repos/your-prefix_backend_remote"
+      "cache_location": ".cache/github-repos/your-prefix_backend_remote",
+      "optional": false,
+      "dependencies": [],
+      "engines": {
+        "knowledge": "codegraph",
+        "execution": "none",
+        "snapshot": "repomix"
+      }
+    },
+    "rag_local_github": {
+      "name": "your-prefix_rag_local",
+      "domain": "rag",
+      "type": "github",
+      "repo_url": "https://github.com/your-org/your-rag-docs.git",
+      "branch": "main",
+      "cache_location": ".cache/github-repos/your-prefix_rag_local",
+      "optional": true,
+      "dependencies": [],
+      "engines": {
+        "knowledge": "graphify",
+        "execution": "none",
+        "snapshot": "repomix"
+      }
+    },
+    "azure_rag_github": {
+      "name": "your-prefix_azure_rag",
+      "domain": "azure-rag",
+      "type": "github",
+      "repo_url": "https://github.com/your-org/your-enterprise-docs.git",
+      "branch": "main",
+      "cache_location": ".cache/github-repos/your-prefix_azure_rag",
+      "optional": true,
+      "dependencies": [],
+      "engines": {
+        "knowledge": "azure-rag-builder",
+        "execution": "none",
+        "snapshot": "repomix"
+      }
     }
   }
 }

package/scripts/intake/init-template-registry.ps1

@@ -125,16 +125,30 @@ function Get-DefaultEnginesForDomain {
   param([Parameter(Mandatory = $true)][string]$Domain)
 
   switch ($Domain) {
-    'dev' {
+    'backend' {
       return [pscustomobject]@{
         knowledge = 'codegraph'
         execution = 'none'
         snapshot = 'repomix'
       }
     }
-    'legacy' {
+    'frontend' {
+      return [pscustomobject]@{
+        knowledge = 'codegraph'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
+    'community-content' {
       return [pscustomobject]@{
         knowledge = 'graphify'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
+    'legacy' {
+      return [pscustomobject]@{
+        knowledge = 'gitnexus'
         execution = 'gitnexus'
         snapshot = 'repomix'
       }
@@ -160,6 +174,20 @@ function Get-DefaultEnginesForDomain {
         snapshot = 'repomix'
       }
     }
+    'rag' {
+      return [pscustomobject]@{
+        knowledge = 'graphify'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
+    'ux-ui' {
+      return [pscustomobject]@{
+        knowledge = 'graphify'
+        execution = 'none'
+        snapshot = 'repomix'
+      }
+    }
     default {
       return [pscustomobject]@{
         knowledge = 'codegraph'
@@ -218,11 +246,11 @@ else {
 $templateRegistry.repos = @()
 if ($addInitialRepo) {
   $defaultRepoName = if ([string]::IsNullOrWhiteSpace($InitialRepoName)) { "$resolvedPrefix$((Split-Path $repoRoot -Leaf).ToLowerInvariant())" } else { $InitialRepoName }
-  $defaultRepoDomain = if ([string]::IsNullOrWhiteSpace($InitialRepoDomain)) { 'dev' } else { $InitialRepoDomain }
+  $defaultRepoDomain = if ([string]::IsNullOrWhiteSpace($InitialRepoDomain)) { 'backend' } else { $InitialRepoDomain }
   $defaultRepoLocation = if ([string]::IsNullOrWhiteSpace($InitialRepoLocation)) { '.' } else { $InitialRepoLocation }
 
   $resolvedRepoName = Read-RequiredValue -Prompt 'Initial repo name' -DefaultValue $defaultRepoName -ProvidedValue $InitialRepoName
-  $resolvedRepoDomain = Read-ChoiceValue -Prompt 'Initial repo domain' -AllowedValues @('dev', 'legacy', 'dba', 'iot', 'azure-rag') -DefaultValue $defaultRepoDomain -ProvidedValue $InitialRepoDomain
+  $resolvedRepoDomain = Read-ChoiceValue -Prompt 'Initial repo domain' -AllowedValues @('backend', 'frontend', 'community-content', 'legacy', 'dba', 'iot', 'ux-ui', 'azure-rag', 'rag') -DefaultValue $defaultRepoDomain -ProvidedValue $InitialRepoDomain
   $resolvedRepoLocation = Read-RequiredValue -Prompt 'Initial repo location' -DefaultValue $defaultRepoLocation -ProvidedValue $InitialRepoLocation
   $resolvedEngines = Get-DefaultEnginesForDomain -Domain $resolvedRepoDomain
 

package/scripts/ops/hi.ps1

@@ -569,6 +569,10 @@ function Ensure-CodegraphInitialized {
 }
 
 function Ensure-SetupPrerequisites {
+    param(
+        [string]$Reason = 'missing prerequisite'
+    )
+
     if ($script:SetupAttempted) {
         if (-not $script:SetupSucceeded) {
             throw 'setup-prerequisites was already attempted and failed earlier in this run'
@@ -577,11 +581,15 @@ function Ensure-SetupPrerequisites {
     }
 
     $script:SetupAttempted = $true
-    Write-Host '[info] Missing prerequisite detected. Running setup-prerequisites automatically...' -ForegroundColor DarkYellow
-    & pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\setup-prerequisites.ps1
-    if ($LASTEXITCODE -ne 0) {
+    Write-Host ("[info] Missing prerequisite detected ({0}). Running setup-prerequisites automatically..." -f $Reason) -ForegroundColor DarkYellow
+    try {
+        $script:StepLogs['setup-prerequisites-auto'] = Invoke-LoggedAction -StepName 'setup-prerequisites-auto' -InfoLines @("Auto-recovery reason: $Reason") -Action {
+            & pwsh -NoProfile -ExecutionPolicy Bypass -File .\scripts\setup\setup-prerequisites.ps1 -VerboseTrace
+        }
+    }
+    catch {
         $script:SetupSucceeded = $false
-        throw "setup-prerequisites failed with exit code $LASTEXITCODE"
+        throw $_.Exception.Message
     }
 
     $script:SetupSucceeded = $true
@@ -656,7 +664,7 @@ Invoke-Step -Name 'Validate context' -Action $validateContextAction -Required $t
 if ($script:HasFailures) {
     $script:HasFailures = $false
     Invoke-Step -Name 'Setup prerequisites' -Action {
-        [void](Ensure-SetupPrerequisites)
+        [void](Ensure-SetupPrerequisites -Reason 'validate-context failed')
     } -Required $true
 
     Invoke-Step -Name 'Validate context (retry)' -Action $validateContextAction -Required $true
@@ -691,7 +699,7 @@ Invoke-Step -Name 'Validate memory/cache artifacts' -Action {
     }
 
     if (-not (Get-Command codebase-memory-mcp -ErrorAction SilentlyContinue)) {
-        [void](Ensure-SetupPrerequisites)
+        [void](Ensure-SetupPrerequisites -Reason 'codebase-memory-mcp command not found')
     }
 
     if (-not (Get-Command codebase-memory-mcp -ErrorAction SilentlyContinue)) {
@@ -701,7 +709,7 @@ Invoke-Step -Name 'Validate memory/cache artifacts' -Action {
 
 Invoke-Step -Name 'Activate token-saver mode' -Action {
     if (-not (Test-CommandAvailable -Name 'token-saver-mcp')) {
-        [void](Ensure-SetupPrerequisites)
+        [void](Ensure-SetupPrerequisites -Reason 'token-saver-mcp command not found')
     }
 
     if (-not (Test-CommandAvailable -Name 'token-saver-mcp')) {

package/scripts/setup/setup-prerequisites.ps1

@@ -5,7 +5,8 @@ param(
     [switch]$SkipGitnexus,
     [switch]$SkipGraphify,
     [switch]$SkipRepomix,
-    [switch]$PortableMode
+    [switch]$PortableMode,
+    [switch]$VerboseTrace
 )
 
 $ErrorActionPreference = 'Stop'
@@ -20,6 +21,17 @@ function Test-Command {
     return [bool](Get-Command -Name $Name -ErrorAction SilentlyContinue)
 }
 
+function Write-TraceStep {
+    param(
+        [Parameter(Mandatory = $true)][string]$Message
+    )
+
+    if ($VerboseTrace) {
+        $stamp = (Get-Date).ToString('HH:mm:ss')
+        Write-Host ("[trace {0}] {1}" -f $stamp, $Message) -ForegroundColor DarkGray
+    }
+}
+
 function Install-NpmGlobalPackage {
     param(
         [Parameter(Mandatory = $true)][string]$Package,
@@ -143,7 +155,29 @@ function Ensure-PythonModuleInstalled {
     }
 }
 
+function Sync-GraphifyArtifactsFromScripts {
+    $scriptsGraphPath = 'scripts/graphify-out/graph.json'
+    $contextGraphDir = 'context/graphify-out'
+    $contextGraphPath = Join-Path $contextGraphDir 'graph.json'
+
+    if (-not (Test-Path $scriptsGraphPath)) {
+        return $false
+    }
+
+    New-Item -ItemType Directory -Path $contextGraphDir -Force | Out-Null
+    Copy-Item -Path $scriptsGraphPath -Destination $contextGraphPath -Force
+
+    $scriptsManifestPath = 'scripts/graphify-out/manifest.json'
+    $contextManifestPath = Join-Path $contextGraphDir 'manifest.json'
+    if (Test-Path $scriptsManifestPath) {
+        Copy-Item -Path $scriptsManifestPath -Destination $contextManifestPath -Force
+    }
+
+    return $true
+}
+
 Write-Host '== MCP platform prerequisites setup =='
+Write-TraceStep -Message ("repoRoot={0}" -f $repoRoot)
 
 $toolingManifest = Get-ToolingManifest -Path $toolingManifestPath
 $externalCliEntries = @($toolingManifest.external_clis)
@@ -153,14 +187,17 @@ foreach ($tool in $externalCliEntries) {
 }
 
 if (-not $SkipCodebaseMemory) {
+    Write-TraceStep -Message 'Installing codebase-memory-mcp from tooling manifest'
     Install-ToolFromManifest -Tool $toolByCommand['codebase-memory-mcp']
 }
 
 if (-not $SkipTokenSaver) {
+    Write-TraceStep -Message 'Installing token-saver-mcp from tooling manifest'
     Install-ToolFromManifest -Tool $toolByCommand['token-saver-mcp']
 }
 
 if (-not $SkipCodegraph) {
+    Write-TraceStep -Message 'Installing/verifying codegraph'
     Install-ToolFromManifest -Tool $toolByCommand['codegraph']
     Write-Host '[setup] codegraph install'
     codegraph install
@@ -174,12 +211,14 @@ if (-not $SkipCodegraph) {
 }
 
 if (-not $SkipGitnexus) {
+    Write-TraceStep -Message 'Installing/verifying gitnexus'
     Install-ToolFromManifest -Tool $toolByCommand['gitnexus']
     Write-Host '[setup] gitnexus setup'
     gitnexus setup
 }
 
 if (-not $SkipRepomix) {
+    Write-TraceStep -Message 'Installing/verifying repomix'
     Install-ToolFromManifest -Tool $toolByCommand['repomix']
 }
 
@@ -198,9 +237,11 @@ else {
 }
 
 # Core observability dependency used by KPI publishing and telemetry export.
+Write-TraceStep -Message 'Ensuring Python module langsmith'
 Ensure-PythonModuleInstalled -PythonCommand $pyCmd -PythonArgs $pyArgs -Module 'langsmith' -Package 'langsmith'
 
 if (-not $SkipGraphify) {
+    Write-TraceStep -Message 'Installing Python requirements for graphify runtime'
     Install-PythonRequirements -PythonCommand $pyCmd -PythonArgs $pyArgs -RequirementsPath 'requirements.txt'
 
     if (-not (Test-PythonImport -PythonCommand $pyCmd -PythonArgs $pyArgs -Module 'graphify.serve')) {
@@ -212,11 +253,20 @@ if (-not $SkipGraphify) {
     }
 
     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
+        Write-Host '[setup] graphify update scripts --no-cluster'
+        Write-TraceStep -Message ("Running: {0} {1} -m graphify update scripts --no-cluster" -f $pyCmd, ($pyArgs -join ' '))
+        & $pyCmd @pyArgs -m graphify update scripts --no-cluster
+        if ($LASTEXITCODE -ne 0) {
+            throw "graphify update failed with exit code $LASTEXITCODE"
+        }
+
+        if (Sync-GraphifyArtifactsFromScripts) {
+            Write-Host '[ok] graphify output synced from scripts/graphify-out to context/graphify-out'
+        }
     }
     else {
         Write-Host '[ok] context/graphify-out/graph.json already exists'
+        Write-TraceStep -Message 'Skipping graphify update because context graph already exists'
     }
 }
 

package/scripts/setup/validate-context.ps1

@@ -69,6 +69,44 @@ function Write-SetupValidationReport {
   $Report | ConvertTo-Json -Depth 20 | Set-Content -Path $Path -Encoding utf8
 }
 
+function Sync-GraphifyArtifactsIfNeeded {
+  $contextGraphDir = Join-Path $repoRoot 'context/graphify-out'
+  $contextGraphPath = Join-Path $contextGraphDir 'graph.json'
+  $scriptsGraphDir = Join-Path $repoRoot 'scripts/graphify-out'
+  $scriptsGraphPath = Join-Path $scriptsGraphDir 'graph.json'
+
+  if ((-not (Test-Path $contextGraphPath)) -and (Test-Path $scriptsGraphPath)) {
+    New-Item -ItemType Directory -Path $contextGraphDir -Force | Out-Null
+    Copy-Item -Path $scriptsGraphPath -Destination $contextGraphPath -Force
+
+    $scriptsManifestPath = Join-Path $scriptsGraphDir 'manifest.json'
+    $contextManifestPath = Join-Path $contextGraphDir 'manifest.json'
+    if ((-not (Test-Path $contextManifestPath)) -and (Test-Path $scriptsManifestPath)) {
+      Copy-Item -Path $scriptsManifestPath -Destination $contextManifestPath -Force
+    }
+  }
+}
+
+function Resolve-PythonLauncher {
+  if (Get-Command py -ErrorAction SilentlyContinue) {
+    return [pscustomobject]@{
+      command = 'py'
+      args = @('-3')
+      printable = 'py -3'
+    }
+  }
+
+  if (Get-Command python -ErrorAction SilentlyContinue) {
+    return [pscustomobject]@{
+      command = 'python'
+      args = @()
+      printable = 'python'
+    }
+  }
+
+  return $null
+}
+
 # Ensure report directory exists
 $reportDir = Split-Path -Parent $setupValidationReportPath
 if (-not (Test-Path $reportDir)) {
@@ -192,8 +230,9 @@ if ($toolingManifest -and ($toolingManifest.PSObject.Properties.Name -contains '
 
 try {
   $mcpRaw = Get-Content -Raw -Path '.vscode/mcp.json' | ConvertFrom-Json -Depth 20
-  if ($mcpRaw.servers.gitnexus.command -ne 'gitnexus') {
-    $errors += 'MCP gitnexus command should be local `gitnexus` (avoid npx startup latency).'
+  $gitnexusCommand = [string]$mcpRaw.servers.gitnexus.command
+  if ($gitnexusCommand -eq 'npx') {
+    $errors += 'MCP gitnexus command should avoid `npx` (startup latency). Use local `gitnexus` or local wrapper script.'
   }
   $scanLimit = 0
   $gitnexusHasEnv = ($mcpRaw.servers.gitnexus.PSObject.Properties.Name -contains 'env')
@@ -215,6 +254,8 @@ catch {
   $errors += "Unable to parse .vscode/mcp.json: $($_.Exception.Message)"
 }
 
+Sync-GraphifyArtifactsIfNeeded
+
 $specFiles = @(
   "specs/architecture.spec.md",
   "specs/azure-rag.spec.md",
@@ -312,29 +353,32 @@ if (-not (Get-Command py -ErrorAction SilentlyContinue) -and -not (Get-Command p
   }
 }
 else {
-  $pythonCmd = "python"
-  $pythonArgs = @("-c", "import graphify.serve, mcp; print('ok')")
-  if (Get-Command py -ErrorAction SilentlyContinue) {
-    $pythonCmd = "py"
-    $pythonArgs = @("-3.14", "-c", "import graphify.serve, mcp; print('ok')")
-  }
+  $pythonLauncher = Resolve-PythonLauncher
+  $pythonCmd = [string]$pythonLauncher.command
+  $pythonArgs = @($pythonLauncher.args + @("-c", "import graphify.serve, mcp; print('ok')"))
 
   & $pythonCmd @pythonArgs *> $null
   $setupValidationReport.python_modules += @{
-    launcher = $pythonCmd
+    launcher = [string]$pythonLauncher.printable
     args = $pythonArgs
     import_ok = ($LASTEXITCODE -eq 0)
   }
   if ($LASTEXITCODE -ne 0) {
     if (-not ($CIMode)) {
-      $errors += 'Graphify MCP runtime missing. Run: py -3.14 -m pip install -r requirements.txt'
+      $errors += "Graphify MCP runtime missing. Run: $($pythonLauncher.printable) -m pip install -r requirements.txt"
     }
   }
 }
 
-if (-not (Test-Path "context/graphify-out/graph.json")) {
+if ((-not (Test-Path "context/graphify-out/graph.json")) -and (-not (Test-Path "scripts/graphify-out/graph.json"))) {
   if (-not ($CIMode)) {
-    $errors += "Missing context/graphify-out/graph.json. Run: py -3.14 -m graphify extract scripts --no-cluster --out context"
+    $pythonLauncher = Resolve-PythonLauncher
+    if ($null -ne $pythonLauncher) {
+      $errors += "Missing graphify graph output. Run: $($pythonLauncher.printable) -m graphify update scripts --no-cluster"
+    }
+    else {
+      $errors += 'Missing graphify graph output. Run: python -m graphify update scripts --no-cluster'
+    }
   }
 }