pikakit 3.9.125 → 3.9.126

package/bin/cli.mjs

@@ -1,29 +1,30 @@
 #!/usr/bin/env node
-/**
- * PikaKit CLI - Main Entry Point
- * Routes to install wizard or kit commands
- * Using .mjs extension for Windows npx compatibility
- */
-
-const args = process.argv.slice(2);
-const firstArg = args[0] || '';
-
-// List of commands that should go to kit.mjs (not installer)
-const kitCommands = [
-    'uninstall', 'remove', 'rm',
-    'update',
-    'init', 'list', 'ls',
-    'lock', 'cache',
-    'verify', 'doctor', 'validate', 'check', 'analyze',
-    'info', 'show',
-    'help', '--help', '-h',
-    '--version', '-V'
-];
-
-if (kitCommands.includes(firstArg)) {
-    // Route to kit commands
-    import('./kit.mjs');
-} else {
-    // Default: installation wizard (no args or org/repo syntax)
-    import('./install.mjs');
-}
+/**
+ * PikaKit CLI - Main Entry Point
+ * Routes to install wizard or kit commands
+ * Using .mjs extension for Windows npx compatibility
+ */
+
+const args = process.argv.slice(2);
+const firstArg = args[0] || '';
+
+// List of commands that should go to kit.mjs (not installer)
+const kitCommands = [
+    'uninstall', 'remove', 'rm',
+    'update',
+    'init', 'list', 'ls',
+    'lock', 'cache',
+    'verify', 'doctor', 'validate', 'check', 'analyze',
+    'cdp', 'devtools',
+    'info', 'show',
+    'help', '--help', '-h',
+    '--version', '-V'
+];
+
+if (kitCommands.includes(firstArg)) {
+    // Route to kit commands
+    import('./kit.mjs');
+} else {
+    // Default: installation wizard (no args or org/repo syntax)
+    import('./install.mjs');
+}

package/bin/kit.mjs

@@ -27,6 +27,9 @@ const COMMANDS = {
     // Metrics & Observability
     metrics: { module: "./lib/commands/metrics.js", hasParam: true, aliases: ["stats"] },
 
+    // Tools
+    cdp: { module: "./lib/commands/cdp.js", aliases: ["devtools"] },
+
     // Info
     info: { module: "./lib/commands/info.js", hasParam: true, aliases: ["show"] },
     help: { module: "./lib/commands/help.js", aliases: ["--help", "-h"] }

package/bin/lib/commands/cdp.js

@@ -0,0 +1,391 @@
+/**
+ * @fileoverview CDP command - Setup Chrome DevTools Protocol for Antigravity
+ * 
+ * Automates the entire CDP setup process:
+ * 1. Detects Antigravity installation path
+ * 2. Kills ghost processes holding the CDP port
+ * 3. Creates/patches desktop shortcut with --remote-debugging-port flag
+ * 4. Launches Antigravity with CDP enabled
+ * 5. Verifies CDP is active
+ */
+
+import { execSync, spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { step, stepLine, S, c, spinner, confirm, isCancel, cancel, select } from "../ui.js";
+
+/** Default CDP port */
+const DEFAULT_PORT = 9000;
+
+/** Common Antigravity installation paths */
+const ANTIGRAVITY_PATHS = [
+    path.join(os.homedir(), "AppData", "Local", "Programs", "Antigravity", "Antigravity.exe"),
+    path.join("C:", "Program Files", "Antigravity", "Antigravity.exe"),
+    path.join("C:", "Program Files (x86)", "Antigravity", "Antigravity.exe"),
+];
+
+/** Desktop shortcut path */
+const DESKTOP_SHORTCUT = path.join(os.homedir(), "Desktop", "Antigravity.lnk");
+
+/**
+ * Find Antigravity executable
+ * @returns {string|null}
+ */
+function findAntigravity() {
+    // Check common paths
+    for (const p of ANTIGRAVITY_PATHS) {
+        if (fs.existsSync(p)) return p;
+    }
+
+    // Try to find from running processes (Windows)
+    if (process.platform === "win32") {
+        try {
+            const result = execSync(
+                'powershell -Command "Get-CimInstance Win32_Process | Where-Object { $_.Name -like \'*Antigravity*\' -and $_.CommandLine -notlike \'*--type=*\' } | Select-Object -First 1 -ExpandProperty ExecutablePath"',
+                { encoding: "utf-8", timeout: 10000 }
+            ).trim();
+            if (result && fs.existsSync(result)) return result;
+        } catch { /* not running */ }
+    }
+
+    return null;
+}
+
+/**
+ * Check if a port is in use
+ * @param {number} port
+ * @returns {{ inUse: boolean, pid: number|null }}
+ */
+function checkPort(port) {
+    if (process.platform !== "win32") {
+        return { inUse: false, pid: null };
+    }
+
+    try {
+        const result = execSync(
+            `netstat -ano | findstr ":${port}" | findstr "LISTENING"`,
+            { encoding: "utf-8", timeout: 5000 }
+        ).trim();
+
+        if (result) {
+            const parts = result.split(/\s+/);
+            const pid = parseInt(parts[parts.length - 1], 10);
+            return { inUse: true, pid: isNaN(pid) ? null : pid };
+        }
+    } catch { /* port not in use */ }
+
+    return { inUse: false, pid: null };
+}
+
+/**
+ * Kill a process by PID
+ * @param {number} pid 
+ * @returns {boolean}
+ */
+function killProcess(pid) {
+    try {
+        execSync(`taskkill /F /PID ${pid}`, { timeout: 5000 });
+        return true;
+    } catch { return false; }
+}
+
+/**
+ * Kill all Antigravity processes
+ * @returns {number} Number of processes killed
+ */
+function killAllAntigravity() {
+    try {
+        const result = execSync(
+            'powershell -Command "(Get-Process -Name Antigravity -ErrorAction SilentlyContinue).Count"',
+            { encoding: "utf-8", timeout: 5000 }
+        ).trim();
+
+        const count = parseInt(result, 10) || 0;
+
+        if (count > 0) {
+            execSync(
+                'powershell -Command "Stop-Process -Name Antigravity -Force -ErrorAction SilentlyContinue"',
+                { timeout: 10000 }
+            );
+        }
+
+        return count;
+    } catch {
+        return 0;
+    }
+}
+
+/**
+ * Check if desktop shortcut already has CDP flag
+ * @param {string} shortcutPath 
+ * @returns {{ exists: boolean, hasCDP: boolean, port: number|null, targetPath: string|null }}
+ */
+function checkShortcut(shortcutPath) {
+    if (!fs.existsSync(shortcutPath)) {
+        return { exists: false, hasCDP: false, port: null, targetPath: null };
+    }
+
+    try {
+        const result = execSync(
+            `powershell -Command "$ws = New-Object -COM WScript.Shell; $s = $ws.CreateShortcut('${shortcutPath.replace(/'/g, "''")}'); Write-Output $s.Arguments; Write-Output '---SEPARATOR---'; Write-Output $s.TargetPath"`,
+            { encoding: "utf-8", timeout: 5000 }
+        ).trim();
+
+        const [args, , targetPath] = result.split("---SEPARATOR---");
+        const match = (args || "").match(/--remote-debugging-port=(\d+)/);
+
+        return {
+            exists: true,
+            hasCDP: !!match,
+            port: match ? parseInt(match[1], 10) : null,
+            targetPath: (targetPath || "").trim()
+        };
+    } catch {
+        return { exists: true, hasCDP: false, port: null, targetPath: null };
+    }
+}
+
+/**
+ * Patch desktop shortcut to include CDP flag
+ * @param {string} shortcutPath 
+ * @param {string} exePath 
+ * @param {number} port 
+ * @returns {boolean}
+ */
+function patchShortcut(shortcutPath, exePath, port) {
+    try {
+        const escapedShortcut = shortcutPath.replace(/'/g, "''");
+        const escapedExe = exePath.replace(/'/g, "''");
+        const startIn = path.dirname(exePath).replace(/'/g, "''");
+
+        const script = `$ws = New-Object -COM WScript.Shell;$s = $ws.CreateShortcut('${escapedShortcut}');$s.TargetPath = '${escapedExe}';$s.Arguments = '--remote-debugging-port=${port}';$s.WorkingDirectory = '${startIn}';$s.Save()`;
+
+        execSync(`powershell -Command "${script.replace(/"/g, '\\"')}"`, { timeout: 10000 });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * Create a new desktop shortcut with CDP flag
+ * @param {string} exePath 
+ * @param {number} port 
+ * @returns {boolean}
+ */
+function createShortcut(exePath, port) {
+    return patchShortcut(DESKTOP_SHORTCUT, exePath, port);
+}
+
+/**
+ * Launch Antigravity with CDP flag
+ * @param {string} exePath 
+ * @param {number} port 
+ */
+function launchAntigravity(exePath, port) {
+    const child = spawn(exePath, [`--remote-debugging-port=${port}`], {
+        detached: true,
+        stdio: "ignore"
+    });
+    child.unref();
+}
+
+/**
+ * Wait for CDP to become available
+ * @param {number} port 
+ * @param {number} timeoutMs 
+ * @returns {Promise<boolean>}
+ */
+async function waitForCDP(port, timeoutMs = 15000) {
+    const start = Date.now();
+
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const result = execSync(
+                `powershell -Command "try { $r = Invoke-WebRequest -Uri 'http://127.0.0.1:${port}/json/version' -UseBasicParsing -TimeoutSec 2; Write-Output 'OK' } catch { Write-Output 'FAIL' }"`,
+                { encoding: "utf-8", timeout: 5000 }
+            ).trim();
+
+            if (result === "OK") return true;
+        } catch { /* retry */ }
+
+        // Wait 1 second before retry
+        await new Promise(r => setTimeout(r, 1000));
+    }
+
+    return false;
+}
+
+/**
+ * Main CDP setup command
+ */
+export async function run() {
+    stepLine();
+    step(c.bold("CDP Setup — Chrome DevTools Protocol"), S.diamondFilled, "cyan");
+    stepLine();
+
+    // --- Step 1: Detect Antigravity ---
+    step("Detecting Antigravity installation...", S.diamond, "cyan");
+
+    const exePath = findAntigravity();
+
+    if (!exePath) {
+        step(c.red("Antigravity not found!"), S.cross, "red");
+        step(c.dim("Install Antigravity first, then run this command again."), S.branch, "gray");
+        return;
+    }
+
+    step(`Found: ${c.green(exePath)}`, S.check, "green");
+
+    // --- Step 2 & 3: Find available port ---
+    let port = DEFAULT_PORT;
+    let isPortAvailable = false;
+    const MAX_PORT = 9003;
+
+    stepLine();
+    step("Scanning for available CDP port (9000-9003)...", S.diamond, "cyan");
+
+    for (let p = DEFAULT_PORT; p <= MAX_PORT; p++) {
+        const portStatus = checkPort(p);
+
+        if (!portStatus.inUse) {
+            port = p;
+            isPortAvailable = true;
+            step(c.green(`Port ${port} is available`), S.check, "green");
+            break;
+        }
+
+        step(c.yellow(`Port ${p} is occupied by PID ${portStatus.pid}`), S.diamond, "yellow");
+
+        // Check if it's an Antigravity process
+        let isAntigravity = false;
+        if (portStatus.pid) {
+            try {
+                const name = execSync(
+                    `powershell -Command "(Get-Process -Id ${portStatus.pid} -ErrorAction SilentlyContinue).ProcessName"`,
+                    { encoding: "utf-8", timeout: 5000 }
+                ).trim();
+                isAntigravity = name.toLowerCase().includes("antigravity");
+            } catch { /* process may have ended */ }
+        }
+
+        if (isAntigravity) {
+            step("Port is held by a running Antigravity instance", S.diamond, "yellow");
+            step(c.dim("We will restart it safely to avoid abruptly killing your terminal."), S.branch, "gray");
+            port = p;
+            isPortAvailable = true;
+            break;
+        } else {
+            step("Port is held by another process or ghost process. Attempting to free...", S.diamond, "yellow");
+
+            if (portStatus.pid) killProcess(portStatus.pid);
+
+            // Wait for port to be freed
+            await new Promise(r => setTimeout(r, 2000));
+
+            const recheck = checkPort(p);
+            if (!recheck.inUse) {
+                port = p;
+                isPortAvailable = true;
+                step(c.green(`Port ${port} freed successfully`), S.check, "green");
+                break;
+            } else {
+                step(c.dim(`Could not free port ${p}. Trying next port...`), S.branch, "gray");
+            }
+        }
+    }
+
+    if (!isPortAvailable) {
+        step(c.red(`Could not find any available port between 9000-9003.`), S.cross, "red");
+        step(c.dim(`Please try restarting your computer.`), S.branch, "gray");
+        return;
+    }
+
+    // --- Step 4: Setup shortcut ---
+    stepLine();
+    step("Setting up Desktop shortcut...", S.diamond, "cyan");
+
+    const shortcutInfo = checkShortcut(DESKTOP_SHORTCUT);
+
+    if (shortcutInfo.exists && shortcutInfo.hasCDP && shortcutInfo.port === port) {
+        step(c.green("Shortcut already configured with CDP"), S.check, "green");
+    } else if (shortcutInfo.exists) {
+        // Patch existing shortcut
+        const patched = patchShortcut(DESKTOP_SHORTCUT, exePath, port);
+        if (patched) {
+            step(c.green(`Shortcut updated with --remote-debugging-port=${port}`), S.check, "green");
+        } else {
+            step(c.yellow("Could not update shortcut (run as Admin?)"), S.diamond, "yellow");
+        }
+    } else {
+        // Create new shortcut
+        const created = createShortcut(exePath, port);
+        if (created) {
+            step(c.green(`Shortcut created on Desktop with CDP enabled`), S.check, "green");
+        } else {
+            step(c.yellow("Could not create shortcut"), S.diamond, "yellow");
+        }
+    }
+
+    // --- Step 5: Ask to launch ---
+    stepLine();
+
+    const shouldLaunch = await confirm({
+        message: "Restart Antigravity to enable CDP now? (Will close current window)",
+        initialValue: true
+    });
+
+    if (isCancel(shouldLaunch) || !shouldLaunch) {
+        stepLine();
+        step(c.green("CDP setup complete!"), S.check, "green");
+        step(c.dim("Please close and re-launch Antigravity from the Desktop shortcut to use CDP."), S.branch, "gray");
+        stepLine();
+        return;
+    }
+
+    // --- Step 6: Launch & verify ---
+    step(c.cyan("Preparing to restart Antigravity..."), S.diamond, "cyan");
+
+    // Write a self-deleting .bat file that handles the restart sequence.
+    // This is more reliable than spawning a detached child process because:
+    // 1. The .bat file persists on disk even when the parent (Antigravity) dies
+    // 2. cmd.exe /c start launches it in a truly independent process
+    // 3. The bat file cleans itself up after execution
+    const batPath = path.join(os.tmpdir(), `pikakit-cdp-restart-${Date.now()}.bat`);
+    const batContent = [
+        "@echo off",
+        "timeout /t 3 /nobreak >nul",
+        "taskkill /IM Antigravity.exe /F >nul 2>&1",
+        "timeout /t 2 /nobreak >nul",
+        `start "" "${exePath}" --remote-debugging-port=${port}`,
+        `del "%~f0"`
+    ].join("\r\n");
+
+    fs.writeFileSync(batPath, batContent, "utf-8");
+
+    // Launch the bat file in a fully detached, hidden window via wscript
+    // This ensures it runs even after our process and Antigravity are killed
+    const vbsPath = path.join(os.tmpdir(), `pikakit-cdp-launcher-${Date.now()}.vbs`);
+    const vbsContent = `CreateObject("Wscript.Shell").Run """${batPath}""", 0, False`;
+    fs.writeFileSync(vbsPath, vbsContent, "utf-8");
+
+    const child = spawn("wscript.exe", [vbsPath], {
+        detached: true,
+        stdio: "ignore"
+    });
+    child.unref();
+
+    // --- Summary ---
+    stepLine();
+    step(c.bold(c.green("✓ CDP Setup Complete - Restarting System")), S.diamondFilled, "green");
+    stepLine();
+
+    console.log(`${c.gray(S.branch)}  ${c.dim("Status:")}   The editor will close automatically in 2 seconds...`);
+    console.log(`${c.gray(S.branch)}  ${c.dim("Action:")}   It will restart with CDP turned ${c.green("ON")}.`);
+    stepLine();
+    
+    // We do not wait for CDP because we are about to be killed
+    process.exit(0);
+    stepLine();
+}

package/bin/lib/commands/help.js

@@ -91,6 +91,11 @@ async function showCommands() {
   step(c.cyan("lock") + c.dim("                Generate skill-lock.json"));
   stepLine();
 
+  // Tools
+  step(c.bold(c.blue("Tools")));
+  step(c.cyan("cdp") + c.dim("                 Setup CDP (Chrome DevTools Protocol)"));
+  stepLine();
+
   // Developer Commands
   step(c.bold(c.magenta("Developer Commands")));
   step(c.cyan("validate [skill]") + c.dim("    Validate against spec"));
@@ -199,6 +204,11 @@ function showQuickStart() {
   step("   " + c.cyan("npx pikakit doctor"));
   stepLine();
 
-  step(c.bold("5. Use in your AI"));
+  step(c.bold("5. Enable CDP (Browser Control)"));
+  step("   " + c.cyan("npx pikakit cdp"));
+  step("   " + c.dim("→ Auto-setup CDP for Antigravity (kills ghost processes, patches shortcut)"));
+  stepLine();
+
+  step(c.bold("6. Use in your AI"));
   step("   " + c.dim("Skills are now available in .agent/skills/"));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pikakit",
-  "version": "3.9.125",
+  "version": "3.9.126",
   "description": "PikaKit FAANG-Grade AI Operating System — Install 51 skills, 18 workflows.",
   "license": "Proprietary",
   "author": "pikakit <pikakit@gmail.com>",

package/packages/pikakit-extension/README.md

@@ -36,7 +36,7 @@ The extension is installed automatically during skill installation.
 cd packages/pikakit-extension
 npm install && npm run compile
 npx @vscode/vsce package --allow-missing-repository
-code --install-extension pikakit-engine-3.9.125.vsix
+code --install-extension pikakit-engine-3.9.126.vsix
 ```
 
 ### Local Development
@@ -121,4 +121,4 @@ Autopilot includes dangerous command blocking for:
 
 ---
 
-⚡ PikaKit Engine v3.9.125
+⚡ PikaKit Engine v3.9.126