mcp-efficiency-engine 0.1.5 → 0.1.7

package/.vscode/mcp.json

@@ -7,16 +7,23 @@
       "command": "codebase-memory-mcp"
     },
     "codegraph": {
-      "command": "codegraph",
+      "command": "pwsh",
       "args": [
-        "serve",
-        "--mcp"
+        "-NoProfile",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-File",
+        "scripts/ops/start-codegraph-mcp.ps1"
       ]
     },
     "gitnexus": {
-      "command": "gitnexus",
+      "command": "pwsh",
       "args": [
-        "mcp"
+        "-NoProfile",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-File",
+        "scripts/ops/start-gitnexus-mcp.ps1"
       ],
       "env": {
         "GITNEXUS_SEMANTIC_EXACT_SCAN_LIMIT": "50000",

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,33 @@ 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.
+
+Pasos recomendados despues de instalar:
+
+```powershell
+# 1) (Opcional) editar repos auxiliares/boosts
+notepad .\repo-registry\repos.yml
+
+# 2) materializar capacidades de todos los repos del registry
+.\scripts\intake\run-repo-intake.cmd
+
+# 3) validar que el router ya los ve
+.\scripts\ops\hi.ps1
+```
+
+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
@@ -233,6 +268,17 @@ py -3 .\scripts\intake\run-routing-evals.py
 .\scripts\ops\bye.ps1
 ```
 
+Telemetría de terminal (PowerShell, opcional):
+
+```powershell
+mcpee observe-on
+# ... comandos interactivos ...
+mcpee observe-off
+```
+
+- `mcpee observe-on` instala un hook global de perfil PowerShell para emitir un evento de telemetría por comando usando `scripts/ops/emit-terminal-command-telemetry.py`.
+- `mcpee observe-off` elimina el hook global y restaura el perfil sin instrumentación.
+
 Validación extendida recomendada:
 
 ```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/bin/mcpee.js

@@ -12,8 +12,77 @@ const commandMap = {
   hi: "scripts/ops/hi.ps1",
   bye: "scripts/ops/bye.ps1",
   intake: "scripts/intake/run-repo-intake.ps1",
+  "observe-on": "scripts/ops/install-terminal-telemetry-hook.ps1",
+  "observe-off": "scripts/ops/uninstall-terminal-telemetry-hook.ps1",
 };
 
+function resolveSessionId() {
+  const explicitSessionId = (process.env.MCP_SESSION_ID || "").trim();
+  if (explicitSessionId) {
+    return explicitSessionId;
+  }
+
+  const sessionLogHint = (process.env.VSCODE_TARGET_SESSION_LOG || "").trim();
+  if (sessionLogHint) {
+    const match = sessionLogHint.match(/[0-9a-fA-F-]{36}/);
+    if (match && match[0]) {
+      return match[0];
+    }
+  }
+
+  return "mcpee-cli";
+}
+
+function resolvePythonCandidates() {
+  if (process.platform === "win32") {
+    return [
+      ["py", ["-3"]],
+      ["python", []],
+      ["python3", []],
+    ];
+  }
+
+  return [
+    ["python3", []],
+    ["python", []],
+  ];
+}
+
+function runCopilotUsageIngest(repoRootPath) {
+  const sessionLogHint = (process.env.VSCODE_TARGET_SESSION_LOG || "").trim();
+  if (!sessionLogHint) {
+    return;
+  }
+
+  const ingestScriptPath = path.join(repoRootPath, "scripts", "learning", "ingest-copilot-session-usage.py");
+  if (!fs.existsSync(ingestScriptPath)) {
+    return;
+  }
+
+  for (const [pythonCommand, pythonPrefixArgs] of resolvePythonCandidates()) {
+    const ingestResult = spawnSync(
+      pythonCommand,
+      [
+        ...pythonPrefixArgs,
+        ingestScriptPath,
+        "--session-log",
+        sessionLogHint,
+      ],
+      {
+        cwd: repoRootPath,
+        stdio: "ignore",
+      },
+    );
+
+    if (ingestResult.error && ingestResult.error.code === "ENOENT") {
+      continue;
+    }
+
+    // La ingesta es best-effort: si falla no bloquea el comando principal.
+    return;
+  }
+}
+
 function resolveExecutionRoot(scriptRelativePath) {
   const configuredTarget = process.env.MCPEE_TARGET_DIR ? path.resolve(process.env.MCPEE_TARGET_DIR) : "";
   const cwdRoot = process.cwd();
@@ -41,6 +110,8 @@ function printHelp() {
       "  hi         Ejecuta el preflight diario.",
       "  bye        Ejecuta el cierre diario.",
       "  intake     Ejecuta el repo intake.",
+      "  observe-on Activa telemetria global del terminal (hook PowerShell).",
+      "  observe-off Desactiva telemetria global del terminal.",
       "",
       "Ejemplos:",
       "  npx mcp-efficiency-engine bootstrap",
@@ -61,6 +132,10 @@ function runPowerShellScript(scriptRelativePath, forwardedArgs) {
   const executionRoot = resolveExecutionRoot(scriptRelativePath);
   const scriptPath = path.join(executionRoot, scriptRelativePath);
   const tracerScriptPath = path.join(repoRoot, "scripts", "ops", "trace-command.py");
+  const sessionId = resolveSessionId();
+
+  runCopilotUsageIngest(repoRoot);
+
   if (!fs.existsSync(scriptPath)) {
     process.stderr.write(`Script no encontrado: ${scriptRelativePath}\n`);
     return 1;
@@ -70,37 +145,42 @@ function runPowerShellScript(scriptRelativePath, forwardedArgs) {
   for (const shellCommand of shellCandidates) {
     if (fs.existsSync(tracerScriptPath)) {
       const operation = `mcpee.${path.basename(scriptRelativePath, path.extname(scriptRelativePath))}`;
-      const tracedResult = spawnSync(
-        "py",
-        [
-          "-3",
-          tracerScriptPath,
-          "--operation",
-          operation,
-          "--session-id",
-          "mcpee-cli",
-          "--cwd",
-          executionRoot,
-          "--",
-          shellCommand,
-          "-NoProfile",
-          "-ExecutionPolicy",
-          "Bypass",
-          "-File",
-          scriptPath,
-          ...forwardedArgs,
-        ],
-        {
-          cwd: repoRoot,
-          stdio: "inherit",
-        },
-      );
-
-      if (!tracedResult.error || tracedResult.error.code !== "ENOENT") {
+      for (const [pythonCommand, pythonPrefixArgs] of resolvePythonCandidates()) {
+        const tracedResult = spawnSync(
+          pythonCommand,
+          [
+            ...pythonPrefixArgs,
+            tracerScriptPath,
+            "--operation",
+            operation,
+            "--session-id",
+            sessionId,
+            "--cwd",
+            executionRoot,
+            "--",
+            shellCommand,
+            "-NoProfile",
+            "-ExecutionPolicy",
+            "Bypass",
+            "-File",
+            scriptPath,
+            ...forwardedArgs,
+          ],
+          {
+            cwd: repoRoot,
+            stdio: "inherit",
+          },
+        );
+
+        if (tracedResult.error && tracedResult.error.code === "ENOENT") {
+          continue;
+        }
+
         if (tracedResult.error) {
           process.stderr.write(`${tracedResult.error.message}\n`);
           return 1;
         }
+
         return tracedResult.status ?? 0;
       }
     }

package/package.json

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

package/scripts/ops/emit-terminal-command-telemetry.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+import argparse
+import hashlib
+import sys
+from pathlib import Path
+
+
+def _bootstrap_repo_root() -> Path:
+    repo_root = Path(__file__).resolve().parents[2]
+    if str(repo_root) not in sys.path:
+        sys.path.insert(0, str(repo_root))
+    return repo_root
+
+
+def _hash_command(command: str) -> str:
+    return hashlib.sha256(command.encode("utf-8")).hexdigest()[:16]
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Emit telemetry for an already executed terminal command.")
+    parser.add_argument("--session-id", default="terminal-session", help="Session identifier")
+    parser.add_argument("--cwd", default=".", help="Current working directory")
+    parser.add_argument("--command", default="", help="Executed command text")
+    parser.add_argument("--success", default="true", help="Whether command succeeded (true/false)")
+    parser.add_argument("--exit-code", type=int, default=0, help="Exit code for native commands")
+    args = parser.parse_args()
+
+    command_text = (args.command or "").strip()
+    if not command_text:
+        return 0
+
+    repo_root = _bootstrap_repo_root()
+    from telemetry import build_telemetry_collector
+
+    collector = build_telemetry_collector(repo_root)
+
+    success = str(args.success).strip().lower() in {"1", "true", "yes", "ok"}
+    normalized_cwd = str(Path(args.cwd).resolve())
+
+    with collector.start_execution(
+        operation="terminal.command",
+        session_id=str(args.session_id).strip() or "terminal-session",
+        model="powershell",
+        provider="local-shell",
+    ):
+        with collector.start_span(
+            name="terminal.executed_command",
+            kind="TOOL",
+            attributes={
+                "cwd": normalized_cwd,
+                "command_hash": _hash_command(command_text),
+                "success": success,
+                "exit_code": int(args.exit_code),
+            },
+        ):
+            collector.record_event(
+                "RoutingResolved",
+                {
+                    "source": "terminal-hook",
+                    "cwd": normalized_cwd,
+                    "success": success,
+                    "exit_code": int(args.exit_code),
+                },
+                level="INFO",
+            )
+            collector.record_metric("terminal_command_count", 1.0, unit="count")
+            collector.record_metric("terminal_last_exit_code", float(int(args.exit_code)), unit="code")
+            if not success:
+                collector.record_event(
+                    "ExceptionThrown",
+                    {
+                        "source": "terminal-hook",
+                        "message": "command_reported_failure",
+                        "exit_code": int(args.exit_code),
+                    },
+                    level="ERROR",
+                )
+
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/scripts/ops/install-terminal-telemetry-hook.ps1

@@ -0,0 +1,152 @@
+param(
+    [switch]$AllHosts,
+    [switch]$CurrentProcess,
+    [string]$SessionId = ''
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$repoRoot = (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
+$sessionIdResolved = if ([string]::IsNullOrWhiteSpace($SessionId)) {
+    if (-not [string]::IsNullOrWhiteSpace($env:MCP_SESSION_ID)) { $env:MCP_SESSION_ID }
+    elseif (-not [string]::IsNullOrWhiteSpace($env:VSCODE_TARGET_SESSION_LOG) -and $env:VSCODE_TARGET_SESSION_LOG -match '([0-9a-fA-F-]{36})') { $Matches[1] }
+    else { 'terminal-session' }
+}
+else {
+    $SessionId
+}
+
+$hookBlock = @"
+# >>> MCPEE_TERMINAL_TELEMETRY_START >>>
+`$global:MCPEE_TELEMETRY_REPO_ROOT = '$repoRoot'
+`$global:MCPEE_TELEMETRY_SESSION_ID = '$sessionIdResolved'
+`$global:MCPEE_TELEMETRY_LAST_HISTORY_ID = -1
+`$global:MCPEE_TELEMETRY_LAST_STAMP = ''
+
+function global:Get-McpeeTelemetryPythonCommand {
+    if (Get-Command py -ErrorAction SilentlyContinue) {
+        return @('py', '-3')
+    }
+    if (Get-Command python -ErrorAction SilentlyContinue) {
+        return @('python')
+    }
+    if (Get-Command python3 -ErrorAction SilentlyContinue) {
+        return @('python3')
+    }
+    return @()
+}
+
+function global:Invoke-McpeeTerminalTelemetry {
+    try {
+        `$last = Get-History -Count 1 -ErrorAction SilentlyContinue
+        if (`$null -eq `$last) { return }
+
+        `$historyId = [int]`$last.Id
+        if (`$historyId -le [int]`$global:MCPEE_TELEMETRY_LAST_HISTORY_ID) { return }
+
+        `$commandText = [string]`$last.CommandLine
+        if ([string]::IsNullOrWhiteSpace(`$commandText)) { return }
+
+        `$commandTrim = `$commandText.Trim()
+        if (`$commandTrim -match 'Invoke-McpeeTerminalTelemetry|emit-terminal-command-telemetry\.py') { 
+            `$global:MCPEE_TELEMETRY_LAST_HISTORY_ID = `$historyId
+            return 
+        }
+
+        `$stamp = ('{0}:{1}' -f `$historyId, `$commandTrim)
+        if (`$stamp -eq `$global:MCPEE_TELEMETRY_LAST_STAMP) {
+            `$global:MCPEE_TELEMETRY_LAST_HISTORY_ID = `$historyId
+            return
+        }
+
+        `$py = Get-McpeeTelemetryPythonCommand
+        if (`$py.Count -eq 0) {
+            `$global:MCPEE_TELEMETRY_LAST_HISTORY_ID = `$historyId
+            `$global:MCPEE_TELEMETRY_LAST_STAMP = `$stamp
+            return
+        }
+
+        `$scriptPath = Join-Path `$global:MCPEE_TELEMETRY_REPO_ROOT 'scripts/ops/emit-terminal-command-telemetry.py'
+        if (-not (Test-Path `$scriptPath)) {
+            `$global:MCPEE_TELEMETRY_LAST_HISTORY_ID = `$historyId
+            `$global:MCPEE_TELEMETRY_LAST_STAMP = `$stamp
+            return
+        }
+
+        `$success = if (`$?) { 'true' } else { 'false' }
+        `$nativeExit = if (`$null -eq `$LASTEXITCODE) { 0 } else { [int]`$LASTEXITCODE }
+
+        `$pyArgs = @()
+        if (`$py.Count -gt 1) {
+            `$pyArgs = `$py[1..(`$py.Count-1)]
+        }
+
+        & `$py[0] @(`$pyArgs) `$scriptPath --session-id `$global:MCPEE_TELEMETRY_SESSION_ID --cwd `$PWD.Path --command `$commandTrim --success `$success --exit-code `$nativeExit *> `$null
+
+        `$global:MCPEE_TELEMETRY_LAST_HISTORY_ID = `$historyId
+        `$global:MCPEE_TELEMETRY_LAST_STAMP = `$stamp
+    }
+    catch {
+        # Hook de telemetria best-effort: nunca romper la consola.
+    }
+}
+
+if (-not (Test-Path Function:\global:MCPEE_ORIGINAL_PROMPT)) {
+    `$originalPromptBody = if (Test-Path Function:\global:prompt) { (Get-Command prompt -CommandType Function).ScriptBlock.ToString() } else { '"PS " + `$executionContext.SessionState.Path.CurrentLocation + "> "' }
+    Set-Item -Path Function:\global:MCPEE_ORIGINAL_PROMPT -Value ([ScriptBlock]::Create(`$originalPromptBody)) -Force
+}
+
+function global:prompt {
+    Invoke-McpeeTerminalTelemetry
+    & global:MCPEE_ORIGINAL_PROMPT
+}
+# <<< MCPEE_TERMINAL_TELEMETRY_END <<<
+"@
+
+function Install-InProfile {
+    param([string]$ProfilePath)
+
+    $dir = Split-Path $ProfilePath -Parent
+    if (-not (Test-Path $dir)) {
+        New-Item -ItemType Directory -Path $dir -Force | Out-Null
+    }
+
+    if (-not (Test-Path $ProfilePath)) {
+        New-Item -ItemType File -Path $ProfilePath -Force | Out-Null
+    }
+
+    $content = Get-Content -Path $ProfilePath -Raw -ErrorAction SilentlyContinue
+    if ($null -eq $content) { $content = '' }
+
+    if ($content -match 'MCPEE_TERMINAL_TELEMETRY_START') {
+        $updated = [regex]::Replace(
+            $content,
+            '(?s)# >>> MCPEE_TERMINAL_TELEMETRY_START >>>.*?# <<< MCPEE_TERMINAL_TELEMETRY_END <<<',
+            $hookBlock
+        )
+        Set-Content -Path $ProfilePath -Value $updated -Encoding UTF8
+    }
+    else {
+        if (-not [string]::IsNullOrWhiteSpace($content) -and -not $content.EndsWith("`n")) {
+            $content += "`r`n"
+        }
+        $content += "`r`n$hookBlock`r`n"
+        Set-Content -Path $ProfilePath -Value $content -Encoding UTF8
+    }
+
+    Write-Host "[ok] Hook instalado/actualizado en: $ProfilePath"
+}
+
+if ($CurrentProcess) {
+    Invoke-Expression $hookBlock
+    Write-Host '[ok] Hook cargado en la sesion actual.'
+}
+
+Install-InProfile -ProfilePath $PROFILE.CurrentUserCurrentHost
+if ($AllHosts) {
+    Install-InProfile -ProfilePath $PROFILE.CurrentUserAllHosts
+}
+
+Write-Host '[ok] Telemetria global de terminal activada (best-effort).'
+Write-Host '[hint] Para desinstalar usa: mcpee observe-off'

package/scripts/ops/migrate-localdb-to-azure-sql.ps1

@@ -0,0 +1,98 @@
+param(
+    [string]$SourceConnectionString = 'Server=(localdb)\MSSQLLocalDB;Database=TechRidersDev;Trusted_Connection=True;MultipleActiveResultSets=True;TrustServerCertificate=True',
+    [string]$TargetServer = 'sql-techriders-dev-ohbnpr4l4fihc.database.windows.net',
+    [string]$TargetDatabase = 'sqldb-techriders-dev',
+    [string]$TargetUser = 'sqladminuser'
+)
+
+$ErrorActionPreference = 'Stop'
+Add-Type -AssemblyName System.Data
+
+if ([string]::IsNullOrWhiteSpace($env:SQL_ADMIN_PASSWORD)) {
+    throw 'Missing SQL_ADMIN_PASSWORD environment variable.'
+}
+
+$targetConnectionString = "Server=tcp:$TargetServer,1433;Initial Catalog=$TargetDatabase;Persist Security Info=False;User ID=$TargetUser;Password=$($env:SQL_ADMIN_PASSWORD);MultipleActiveResultSets=True;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
+
+$sourceConn = New-Object System.Data.SqlClient.SqlConnection $SourceConnectionString
+$targetConn = New-Object System.Data.SqlClient.SqlConnection $targetConnectionString
+
+try {
+    $sourceConn.Open()
+    $targetConn.Open()
+
+    $tableCmd = $sourceConn.CreateCommand()
+    $tableCmd.CommandText = @"
+SELECT s.name AS SchemaName, t.name AS TableName
+FROM sys.tables t
+JOIN sys.schemas s ON s.schema_id = t.schema_id
+WHERE t.is_ms_shipped = 0
+ORDER BY s.name, t.name;
+"@
+
+    $reader = $tableCmd.ExecuteReader()
+    $tables = New-Object System.Collections.Generic.List[object]
+    while ($reader.Read()) {
+        $schema = $reader.GetString(0)
+        $table = $reader.GetString(1)
+        if ($table -ne '__EFMigrationsHistory') {
+            $tables.Add([PSCustomObject]@{ Schema = $schema; Table = $table })
+        }
+    }
+    $reader.Close()
+
+    if ($tables.Count -eq 0) {
+        throw 'No source user tables found.'
+    }
+
+    foreach ($t in $tables) {
+        $fullName = "[$($t.Schema)].[$($t.Table)]"
+        $disableCmd = $targetConn.CreateCommand()
+        $disableCmd.CommandText = "ALTER TABLE $fullName NOCHECK CONSTRAINT ALL;"
+        [void]$disableCmd.ExecuteNonQuery()
+    }
+
+    $summary = New-Object System.Collections.Generic.List[object]
+
+    foreach ($t in $tables) {
+        $fullName = "[$($t.Schema)].[$($t.Table)]"
+
+        $deleteCmd = $targetConn.CreateCommand()
+        $deleteCmd.CommandText = "DELETE FROM $fullName;"
+        [void]$deleteCmd.ExecuteNonQuery()
+
+        $selectCmd = $sourceConn.CreateCommand()
+        $selectCmd.CommandText = "SELECT * FROM $fullName;"
+
+        $adapter = New-Object System.Data.SqlClient.SqlDataAdapter $selectCmd
+        $dataTable = New-Object System.Data.DataTable
+        [void]$adapter.Fill($dataTable)
+
+        if ($dataTable.Rows.Count -gt 0) {
+            $bulkCopy = New-Object System.Data.SqlClient.SqlBulkCopy($targetConn, [System.Data.SqlClient.SqlBulkCopyOptions]::KeepIdentity, $null)
+            $bulkCopy.DestinationTableName = $fullName
+            $bulkCopy.BulkCopyTimeout = 0
+            foreach ($col in $dataTable.Columns) {
+                [void]$bulkCopy.ColumnMappings.Add($col.ColumnName, $col.ColumnName)
+            }
+            $bulkCopy.WriteToServer($dataTable)
+            $bulkCopy.Close()
+        }
+
+        $summary.Add([PSCustomObject]@{ Table = $fullName; Rows = $dataTable.Rows.Count })
+    }
+
+    foreach ($t in $tables) {
+        $fullName = "[$($t.Schema)].[$($t.Table)]"
+        $enableCmd = $targetConn.CreateCommand()
+        $enableCmd.CommandText = "ALTER TABLE $fullName WITH CHECK CHECK CONSTRAINT ALL;"
+        [void]$enableCmd.ExecuteNonQuery()
+    }
+
+    $summary | Sort-Object Table | Format-Table -AutoSize | Out-String | Write-Output
+    Write-Output 'MIGRATION_COMPLETED'
+}
+finally {
+    if ($sourceConn.State -eq 'Open') { $sourceConn.Close() }
+    if ($targetConn.State -eq 'Open') { $targetConn.Close() }
+}

package/scripts/ops/start-codegraph-mcp.ps1

@@ -0,0 +1,67 @@
+param(
+    [switch]$DryRun
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Resolve-RepoRoot {
+    return (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
+}
+
+function Has-CodegraphIndex([string]$path) {
+    return (Test-Path (Join-Path $path '.codegraph'))
+}
+
+function Resolve-TargetPath {
+    param([string]$RepoRoot)
+
+    $envPath = [Environment]::GetEnvironmentVariable('CODEGRAPH_PROJECT_PATH')
+    if (-not [string]::IsNullOrWhiteSpace($envPath)) {
+        $resolvedEnvPath = $null
+        try {
+            $resolvedEnvPath = (Resolve-Path $envPath).Path
+        }
+        catch {
+            $resolvedEnvPath = $null
+        }
+
+        if ($resolvedEnvPath -and (Has-CodegraphIndex $resolvedEnvPath)) {
+            return $resolvedEnvPath
+        }
+    }
+
+    $projectCandidates = @()
+    $projectsRoot = Join-Path $RepoRoot 'projects'
+    if (Test-Path $projectsRoot) {
+        foreach ($projectDir in Get-ChildItem -Path $projectsRoot -Directory -ErrorAction SilentlyContinue) {
+            if (Has-CodegraphIndex $projectDir.FullName) {
+                $projectCandidates += $projectDir.FullName
+            }
+        }
+    }
+
+    if ($projectCandidates.Count -eq 1) {
+        return $projectCandidates[0]
+    }
+
+    if (Has-CodegraphIndex $RepoRoot) {
+        return $RepoRoot
+    }
+
+    if ($projectCandidates.Count -gt 1) {
+        return $projectCandidates[0]
+    }
+
+    return $RepoRoot
+}
+
+$repoRoot = Resolve-RepoRoot
+$targetPath = Resolve-TargetPath -RepoRoot $repoRoot
+
+if ($DryRun) {
+    Write-Output $targetPath
+    exit 0
+}
+
+& codegraph serve --mcp --path $targetPath
+exit $LASTEXITCODE

package/scripts/ops/start-gitnexus-mcp.ps1

@@ -0,0 +1,85 @@
+param(
+    [switch]$DryRun
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Resolve-RepoRoot {
+    return (Resolve-Path (Join-Path $PSScriptRoot '..\..')).Path
+}
+
+function Is-GitRepo([string]$path) {
+    return (Test-Path (Join-Path $path '.git'))
+}
+
+function Has-GitNexusIndex([string]$path) {
+    return (Test-Path (Join-Path $path '.gitnexus'))
+}
+
+function Resolve-TargetPath {
+    param([string]$RepoRoot)
+
+    $envPath = [Environment]::GetEnvironmentVariable('GITNEXUS_PROJECT_PATH')
+    if (-not [string]::IsNullOrWhiteSpace($envPath)) {
+        $resolvedEnvPath = $null
+        try {
+            $resolvedEnvPath = (Resolve-Path $envPath).Path
+        }
+        catch {
+            $resolvedEnvPath = $null
+        }
+
+        if ($resolvedEnvPath -and (Is-GitRepo $resolvedEnvPath)) {
+            return $resolvedEnvPath
+        }
+    }
+
+    $projectCandidates = @()
+    $indexedProjectCandidates = @()
+    $projectsRoot = Join-Path $RepoRoot 'projects'
+
+    if (Test-Path $projectsRoot) {
+        foreach ($projectDir in Get-ChildItem -Path $projectsRoot -Directory -ErrorAction SilentlyContinue) {
+            if (Is-GitRepo $projectDir.FullName) {
+                $projectCandidates += $projectDir.FullName
+                if (Has-GitNexusIndex $projectDir.FullName) {
+                    $indexedProjectCandidates += $projectDir.FullName
+                }
+            }
+        }
+    }
+
+    if ($indexedProjectCandidates.Count -eq 1) {
+        return $indexedProjectCandidates[0]
+    }
+
+    if ((Has-GitNexusIndex $RepoRoot) -and (Is-GitRepo $RepoRoot)) {
+        return $RepoRoot
+    }
+
+    if ($indexedProjectCandidates.Count -gt 1) {
+        return $indexedProjectCandidates[0]
+    }
+
+    if ($projectCandidates.Count -eq 1) {
+        return $projectCandidates[0]
+    }
+
+    if ($projectCandidates.Count -gt 1) {
+        return $projectCandidates[0]
+    }
+
+    return $RepoRoot
+}
+
+$repoRoot = Resolve-RepoRoot
+$targetPath = Resolve-TargetPath -RepoRoot $repoRoot
+
+if ($DryRun) {
+    Write-Output $targetPath
+    exit 0
+}
+
+Set-Location $targetPath
+& gitnexus mcp
+exit $LASTEXITCODE

package/scripts/ops/uninstall-terminal-telemetry-hook.ps1

@@ -0,0 +1,53 @@
+param(
+    [switch]$AllHosts,
+    [switch]$CurrentProcess
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+function Remove-FromProfile {
+    param([string]$ProfilePath)
+
+    if (-not (Test-Path $ProfilePath)) {
+        return
+    }
+
+    $content = Get-Content -Path $ProfilePath -Raw -ErrorAction SilentlyContinue
+    if ($null -eq $content) {
+        return
+    }
+
+    if ($content -match 'MCPEE_TERMINAL_TELEMETRY_START') {
+        $updated = [regex]::Replace(
+            $content,
+            '(?s)\r?\n?# >>> MCPEE_TERMINAL_TELEMETRY_START >>>.*?# <<< MCPEE_TERMINAL_TELEMETRY_END <<<\r?\n?',
+            "`r`n"
+        )
+        Set-Content -Path $ProfilePath -Value $updated -Encoding UTF8
+        Write-Host "[ok] Hook eliminado de: $ProfilePath"
+    }
+}
+
+if ($CurrentProcess) {
+    Remove-Item Function:\global:prompt -ErrorAction SilentlyContinue
+    if (Test-Path Function:\global:MCPEE_ORIGINAL_PROMPT) {
+        Set-Item -Path Function:\global:prompt -Value ((Get-Command MCPEE_ORIGINAL_PROMPT -CommandType Function).ScriptBlock) -Force
+        Remove-Item Function:\global:MCPEE_ORIGINAL_PROMPT -ErrorAction SilentlyContinue
+    }
+
+    Remove-Item Function:\global:Invoke-McpeeTerminalTelemetry -ErrorAction SilentlyContinue
+    Remove-Item Function:\global:Get-McpeeTelemetryPythonCommand -ErrorAction SilentlyContinue
+    Remove-Variable MCPEE_TELEMETRY_REPO_ROOT -Scope Global -ErrorAction SilentlyContinue
+    Remove-Variable MCPEE_TELEMETRY_SESSION_ID -Scope Global -ErrorAction SilentlyContinue
+    Remove-Variable MCPEE_TELEMETRY_LAST_HISTORY_ID -Scope Global -ErrorAction SilentlyContinue
+    Remove-Variable MCPEE_TELEMETRY_LAST_STAMP -Scope Global -ErrorAction SilentlyContinue
+    Write-Host '[ok] Hook desactivado en la sesion actual.'
+}
+
+Remove-FromProfile -ProfilePath $PROFILE.CurrentUserCurrentHost
+if ($AllHosts) {
+    Remove-FromProfile -ProfilePath $PROFILE.CurrentUserAllHosts
+}
+
+Write-Host '[ok] Telemetria global de terminal desactivada.'

package/scripts/setup/setup-prerequisites.ps1

@@ -143,6 +143,27 @@ 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 =='
 
 $toolingManifest = Get-ToolingManifest -Path $toolingManifestPath
@@ -212,8 +233,15 @@ 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'
+        & $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'

package/scripts/setup/validate-context.ps1

@@ -69,6 +69,24 @@ 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
+    }
+  }
+}
+
 # Ensure report directory exists
 $reportDir = Split-Path -Parent $setupValidationReportPath
 if (-not (Test-Path $reportDir)) {
@@ -192,8 +210,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 +234,8 @@ catch {
   $errors += "Unable to parse .vscode/mcp.json: $($_.Exception.Message)"
 }
 
+Sync-GraphifyArtifactsIfNeeded
+
 $specFiles = @(
   "specs/architecture.spec.md",
   "specs/azure-rag.spec.md",
@@ -332,9 +353,9 @@ else {
   }
 }
 
-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"
+    $errors += "Missing graphify graph output. Run: py -3.14 -m graphify update scripts --no-cluster"
   }
 }