mcp-efficiency-engine 0.1.5 → 0.1.6

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/README.md

@@ -233,6 +233,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/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.6",
   "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.'