@instawp/cli 0.0.1-beta.2 → 0.0.1-beta.4

package/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+## 0.0.1-beta.4 (2026-05-22)
+
+### Windows — Zero-Install Support
+- Bundled `rsync.exe` (with msys2 runtime DLLs) and BusyBox-w64 (`awk` provider) in `bin/win32/`. No more "install Git for Windows / cwRsync" prerequisite — `instawp local clone`, `local push/pull`, and `sync push/pull` work out of the box on Windows.
+- Replaced the external `sqlite3` CLI dependency with the `better-sqlite3` Node module.
+- New `src/lib/windows-binaries.ts` resolves bundled binaries; falls back to PATH then common Git-for-Windows install dirs.
+
+### Bug Fixes (Windows)
+- `instawp local clone` now resolves the bundled `mysql2sqlite` script correctly (was broken by `new URL(import.meta.url).pathname` returning `/C:/...`).
+- `mysql2sqlite` is invoked as `awk -f script` explicitly; no longer relies on shebang interpretation.
+- `rsync` no longer treats Windows drive paths (`C:\...`) as remote hostnames — paths are converted to msys style (`/c/...`) inside `rsyncViaSsh`.
+- `-e ssh -i <key>` argument uses forward slashes + quoted paths so msys/cygwin sh inside rsync parses the key path correctly.
+- Eliminated the SQL injection risk in `local clone`'s URL search-replace (now uses bound parameters via better-sqlite3).
+
+### Internals
+- New `scripts/fetch-windows-binaries.sh` (maintainer-only) refreshes the Windows bundle from MSYS2 + frippery.org.
+- 32 new tests covering path conversion and bundled-binary resolution.
+
+## 0.0.1-beta.3 (2026-04-12)
+
+### New Commands
+- `local create` — Create local WordPress sites (powered by WordPress Playground, no Docker needed)
+- `local clone <site>` — Clone an InstaWP cloud site to local (files + database)
+- `local start/stop` — Start in foreground or `--background` mode
+- `local push/pull` — Sync wp-content between local and cloud (incremental rsync)
+- `local list` — Show local sites with running/stopped status
+- `local delete` — Remove local sites
+- `sites php <site>` — View or update PHP version and settings
+- `sites update <site>` — Update site label, description, or expiration
+- `teams switch <team>` — Switch active team context
+
+### Improvements
+- `create --wp <version>` — Specify WordPress version when creating sites
+- `sites list` — 50 per page default, `--all` flag, pagination hints
+- Login now shows user name and team after success
+- Site resolver caches name-to-ID lookups for 10 minutes
+- rsync only shows actually changed files (`--itemize-changes`)
+- Magic login URL fixed to use correct `/wordpress-auto-login` endpoint
+
+### Bug Fixes
+- Windows: SSH key generation now works (removed Unix-specific shell commands)
+- Windows: command detection uses `where` instead of `which`
+- `exec/wp --api` flag now works at any position in the command
+- Terminal restored after local site Ctrl+C (`stty sane`)
+
+## 0.0.1-beta.2 (2026-03-23)
+
+### New Commands
+- `local create/clone/start/stop/push/pull/list/delete` — Full local development workflow
+- `teams switch` — Client-side team context
+
+### Improvements
+- Site resolver caching
+- Incremental rsync output
+
+## 0.0.1-beta.1 (2026-03-02)
+
+### Initial Release
+- `login` — OAuth browser flow or `--token`
+- `whoami` — Show current session
+- `create` — Create WordPress sites with provisioning progress
+- `sites list/delete` — Manage sites
+- `exec/wp` — Run commands via SSH or API
+- `ssh` — Interactive SSH sessions
+- `sync push/pull` — rsync wp-content via SSH
+- `teams list/members` — View teams
+- `--json` mode for all commands

package/bin/win32/NOTICE.md

@@ -0,0 +1,38 @@
+# Bundled Windows binaries
+
+Files in this directory are third-party binaries bundled into the npm package
+so that `instawp local clone`, `instawp local push/pull`, and `instawp sync`
+work on Windows without requiring users to install rsync, awk, or sqlite3.
+
+Populate this directory by running `scripts/fetch-windows-binaries.sh`.
+
+## Components and licenses
+
+### busybox.exe
+- **Source**: BusyBox-w64 by Ron Yorston — https://frippery.org/busybox/
+- **License**: GPL-2.0
+- **Used for**: provides `awk` (invoked as `busybox.exe awk -f ...`) for
+  converting MySQL dumps to SQLite via the vendored `scripts/mysql2sqlite`
+  awk script.
+
+### rsync.exe + msys-*.dll
+- **Source**: Git for Windows portable distribution — https://gitforwindows.org/
+- **License**: rsync is GPL-3.0; msys2-runtime DLLs are mixed (mostly LGPL/MIT)
+- **Used for**: file sync between local and remote sites in `sync push/pull`
+  and `local push/pull/clone`.
+
+The `msys-2.0.dll` and other `msys-*.dll` files must remain colocated with
+rsync.exe — rsync.exe links against them at runtime.
+
+## License compliance
+
+The CLI is MIT-licensed, but the bundled GPL binaries impose obligations on
+**redistribution**:
+
+- Users who receive the binaries are entitled to the corresponding source.
+- BusyBox source: https://busybox.net/downloads/
+- rsync source: https://download.samba.org/pub/rsync/src/
+- Git for Windows source: https://github.com/git-for-windows/git
+
+The maintainer's responsibility is to keep this NOTICE.md shipped alongside
+the binaries in the npm tarball.

package/dist/commands/exec.js

@@ -108,6 +108,19 @@ export function registerExecCommand(program) {
         .option('--api', 'Use API transport instead of SSH')
         .option('--timeout <seconds>', 'Command timeout in seconds (API mode only)', '30')
         .action(async (siteIdentifier, args, opts) => {
+        // passThroughOptions may swallow --api/--timeout into args — extract them
+        const extractedApi = args.includes('--api');
+        const timeoutIdx = args.indexOf('--timeout');
+        let extractedTimeout;
+        if (timeoutIdx !== -1 && args[timeoutIdx + 1]) {
+            extractedTimeout = args[timeoutIdx + 1];
+            args = args.filter((_, i) => i !== timeoutIdx && i !== timeoutIdx + 1);
+        }
+        args = args.filter(a => a !== '--api');
+        if (extractedApi)
+            opts.api = true;
+        if (extractedTimeout)
+            opts.timeout = extractedTimeout;
         await execAction(siteIdentifier, args, opts);
     });
 }
@@ -120,6 +133,19 @@ export function registerWpCommand(program) {
         .option('--api', 'Use API transport instead of SSH')
         .option('--timeout <seconds>', 'Command timeout in seconds (API mode only)', '30')
         .action(async (siteIdentifier, args, opts) => {
+        // passThroughOptions may swallow --api/--timeout into args — extract them
+        const extractedApi = args.includes('--api');
+        const timeoutIdx = args.indexOf('--timeout');
+        let extractedTimeout;
+        if (timeoutIdx !== -1 && args[timeoutIdx + 1]) {
+            extractedTimeout = args[timeoutIdx + 1];
+            args = args.filter((_, i) => i !== timeoutIdx && i !== timeoutIdx + 1);
+        }
+        args = args.filter(a => a !== '--api');
+        if (extractedApi)
+            opts.api = true;
+        if (extractedTimeout)
+            opts.timeout = extractedTimeout;
         await execAction(siteIdentifier, ['wp', ...args], opts);
     });
 }

package/dist/commands/exec.js.map

@@ -1 +1 @@
-{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/commands/exec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/commands/exec.ts"],"names":[],"mappings":"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"}

package/dist/commands/local.js

@@ -1,8 +1,11 @@
 import { spawnSync } from 'node:child_process';
-import { join, resolve } from 'node:path';
+import { join } from 'node:path';
 import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import chalk from 'chalk';
 import open from 'open';
+import Database from 'better-sqlite3';
+import { resolveFromModule } from '../lib/paths.js';
+import { bundledBusybox, bundledRsync } from '../lib/windows-binaries.js';
 import { getLocalInstances, getLocalInstance, setLocalInstance, removeLocalInstance, } from '../lib/config.js';
 import { getNextPort, createInstanceDir, deleteInstanceDir, startServer, startServerBackground, stopServer as stopServerProcess, isServerRunning, checkPlaygroundConnectivity, ensureAutoLogin, } from '../lib/local-env.js';
 import { requireAuth, getClient } from '../lib/api.js';
@@ -54,11 +57,11 @@ export function registerLocalCommand(program) {
                 createdAt: new Date().toISOString(),
             };
             setLocalInstance(instance);
-            success(`Instance "${name}" created`);
-            console.log(`
-${chalk.dim('#')} Starting WordPress ${opts.wp} with PHP ${opts.php}...
-${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
-`);
+            if (!isJsonMode()) {
+                success(`Instance "${name}" created`);
+                console.log(`\n${chalk.dim('#')} Starting WordPress ${opts.wp} with PHP ${opts.php}...`);
+                console.log(`${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}\n`);
+            }
             await launchServer(instance, opts);
         }
         catch (err) {
@@ -176,6 +179,7 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
     local
         .command('push <local-name> [cloud-site]')
         .description('Push local wp-content to an InstaWP cloud site')
+        .option('--include <pattern...>', 'Include patterns (e.g. .git)')
         .option('--exclude <pattern...>', 'Additional exclude patterns')
         .option('--dry-run', 'Show what would be transferred')
         .action(async (localName, cloudSiteArg, opts) => {
@@ -186,7 +190,7 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
             process.exit(1);
         }
         if (!checkRsync()) {
-            error('rsync is required. Install: brew install rsync');
+            error('rsync is required.' + (process.platform === 'win32' ? ' Reinstall the CLI — the bundled rsync.exe is missing.' : ' Install: brew install rsync'));
             process.exit(1);
         }
         const localWpContent = join(instance.path, 'wp-content') + '/';
@@ -282,6 +286,7 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
     local
         .command('pull <local-name> <cloud-site>')
         .description('Pull wp-content from an InstaWP cloud site to local')
+        .option('--include <pattern...>', 'Include patterns (e.g. .git)')
         .option('--exclude <pattern...>', 'Additional exclude patterns')
         .option('--dry-run', 'Show what would be transferred')
         .action(async (localName, cloudSiteArg, opts) => {
@@ -292,7 +297,7 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
             process.exit(1);
         }
         if (!checkRsync()) {
-            error('rsync is required. Install: brew install rsync');
+            error('rsync is required.' + (process.platform === 'win32' ? ' Reinstall the CLI — the bundled rsync.exe is missing.' : ' Install: brew install rsync'));
             process.exit(1);
         }
         const localWpContent = join(instance.path, 'wp-content') + '/';
@@ -309,11 +314,14 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
         }
         const conn = await ensureSshAccess(site.id);
         const remotePath = `/home/${conn.username}/web/${conn.domain}/public_html/wp-content/`;
-        const extraArgs = [
-            '--exclude=database', // Don't overwrite local SQLite database
-            '--exclude=db.php',
-            '--exclude=mu-plugins',
-        ];
+        const extraArgs = [];
+        if (opts.include) {
+            for (const pattern of opts.include) {
+                extraArgs.push(`--include=${pattern}`);
+            }
+        }
+        extraArgs.push('--exclude=database', // Don't overwrite local SQLite database
+        '--exclude=db.php', '--exclude=mu-plugins');
         if (opts.exclude) {
             for (const pattern of opts.exclude) {
                 extraArgs.push(`--exclude=${pattern}`);
@@ -338,10 +346,12 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
         .description('Clone a complete InstaWP cloud site to local')
         .option('--name <name>', 'Local instance name (defaults to cloud site name)')
         .option('--no-start', 'Do not start the local site after cloning')
+        .option('--force', 'Overwrite existing local instance')
+        .option('--include <pattern...>', 'Include patterns for rsync (e.g. .git)')
         .action(async (cloudSiteArg, opts) => {
         requireAuth();
         if (!checkRsync()) {
-            error('rsync is required. Install: brew install rsync');
+            error('rsync is required.' + (process.platform === 'win32' ? ' Reinstall the CLI — the bundled rsync.exe is missing.' : ' Install: brew install rsync'));
             process.exit(1);
         }
         // 1. Resolve cloud site
@@ -360,8 +370,15 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
         const instances = getLocalInstances();
         const name = sanitizeName(opts.name || site.name || site.sub_domain || `site-${site.id}`);
         if (instances[name]) {
-            error(`Local instance "${name}" already exists. Use --name to pick a different name.`);
-            process.exit(1);
+            if (!opts.force) {
+                error(`Local instance "${name}" already exists. Use --force to overwrite or --name to pick a different name.`);
+                process.exit(1);
+            }
+            // Force: delete existing instance first
+            stopServerProcess(instances[name]);
+            deleteInstanceDir(name);
+            removeLocalInstance(name);
+            info(`Existing instance "${name}" removed.`);
         }
         const port = await getNextPort(instances);
         const dir = createInstanceDir(name);
@@ -402,7 +419,14 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
         const remotePath = `/home/${conn.username}/web/${conn.domain}/public_html/wp-content/`;
         const remoteSource = `${conn.username}@${conn.host}:${remotePath}`;
         info(`Pulling wp-content from ${chalk.dim(conn.domain)}...`);
+        const includeArgs = [];
+        if (opts.include) {
+            for (const pattern of opts.include) {
+                includeArgs.push(`--include=${pattern}`);
+            }
+        }
         const rsyncExit = rsyncViaSsh(conn, remoteSource, localWpContent, [
+            ...includeArgs,
             '--exclude=cache',
             '--exclude=upgrade',
             '--exclude=wflogs',
@@ -433,7 +457,7 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
             const dbSpin2 = spinner('Importing database...');
             dbSpin2.start();
             try {
-                const mysql2sqlitePath = resolve(join(new URL(import.meta.url).pathname, '..', '..', '..', 'scripts', 'mysql2sqlite'));
+                const mysql2sqlitePath = resolveFromModule(import.meta.url, '..', '..', 'scripts', 'mysql2sqlite');
                 const dbDir = join(dir, 'wp-content', 'database');
                 const sqliteDbPath = join(dbDir, '.ht.sqlite');
                 // Clean slate for database dir
@@ -446,8 +470,15 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
                 if (sqlStart > 0) {
                     writeFileSync(dumpPath, rawDump.substring(sqlStart));
                 }
-                // Convert MySQL → SQLite
-                const convertResult = spawnSync(mysql2sqlitePath, [dumpPath], {
+                // Convert MySQL → SQLite via awk (mysql2sqlite is an awk script).
+                // Windows doesn't honor shebangs, so invoke awk explicitly.
+                const awk = findAwk();
+                if (!awk) {
+                    throw new Error('awk not found. ' + (process.platform === 'win32'
+                        ? 'Reinstall the CLI — the bundled busybox.exe is missing.'
+                        : 'Install awk/gawk.'));
+                }
+                const convertResult = spawnSync(awk.cmd, [...awk.prefixArgs, '-f', mysql2sqlitePath, dumpPath], {
                     encoding: 'utf-8',
                     maxBuffer: 500 * 1024 * 1024,
                     timeout: 120000,
@@ -458,69 +489,54 @@ ${chalk.dim('#')} Data stored at: ${chalk.dim(dir)}
                 // Add DROP TABLE before each CREATE TABLE
                 let sqliteSql = convertResult.stdout;
                 sqliteSql = sqliteSql.replace(/^(CREATE TABLE `([^`]+)`)/gm, 'DROP TABLE IF EXISTS `$2`;\n$1');
-                // Write and import into SQLite
-                const tmpSql = join(dir, 'sqlite-import.sql');
-                writeFileSync(tmpSql, sqliteSql);
-                spawnSync('sqlite3', [sqliteDbPath], {
-                    input: `.read ${tmpSql}\n`,
-                    encoding: 'utf-8',
-                    timeout: 120000,
-                });
-                // Find the table prefix and rename to wp_
-                const tablesResult = spawnSync('sqlite3', [sqliteDbPath, '.tables'], { encoding: 'utf-8' });
-                const allTables = (tablesResult.stdout || '').split(/\s+/).filter(Boolean);
-                const optionsTable = allTables.find((t) => t.endsWith('_options'));
-                const oldPrefix = optionsTable ? optionsTable.replace('options', '') : 'wp_';
-                if (oldPrefix !== 'wp_') {
-                    // Rename tables
-                    const renameStatements = allTables
-                        .filter((t) => t.startsWith(oldPrefix))
-                        .map((t) => `ALTER TABLE \`${t}\` RENAME TO \`wp_${t.substring(oldPrefix.length)}\`;`)
-                        .join('\n');
-                    spawnSync('sqlite3', [sqliteDbPath, renameStatements], { encoding: 'utf-8' });
-                    // Rename meta keys and option names that contain the old prefix
-                    const fixPrefixSql = [
-                        `UPDATE wp_usermeta SET meta_key = REPLACE(meta_key, '${oldPrefix}', 'wp_') WHERE meta_key LIKE '${oldPrefix}%';`,
-                        `UPDATE wp_options SET option_name = REPLACE(option_name, '${oldPrefix}', 'wp_') WHERE option_name LIKE '${oldPrefix}%';`,
-                    ].join('\n');
-                    spawnSync('sqlite3', [sqliteDbPath, fixPrefixSql], { encoding: 'utf-8' });
-                }
-                // Search-replace old cloud URL → localhost
-                const localUrl = `http://127.0.0.1:${instance.port}`;
-                const oldDomain = site.url || site.sub_domain || '';
-                const oldUrls = [
-                    oldDomain,
-                    oldDomain.replace('https://', 'http://'),
-                ].filter(Boolean);
-                for (const oldUrl of oldUrls) {
-                    const replaceSql = [
-                        `UPDATE wp_options SET option_value = REPLACE(option_value, '${oldUrl}', '${localUrl}') WHERE option_value LIKE '%${oldUrl}%';`,
-                        `UPDATE wp_posts SET post_content = REPLACE(post_content, '${oldUrl}', '${localUrl}') WHERE post_content LIKE '%${oldUrl}%';`,
-                        `UPDATE wp_posts SET guid = REPLACE(guid, '${oldUrl}', '${localUrl}') WHERE guid LIKE '%${oldUrl}%';`,
-                        `UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, '${oldUrl}', '${localUrl}') WHERE meta_value LIKE '%${oldUrl}%';`,
-                        `UPDATE wp_comments SET comment_content = REPLACE(comment_content, '${oldUrl}', '${localUrl}') WHERE comment_content LIKE '%${oldUrl}%';`,
-                    ].join('\n');
-                    spawnSync('sqlite3', [sqliteDbPath, replaceSql], { encoding: 'utf-8' });
-                }
-                // Ensure siteurl/home are correct
-                spawnSync('sqlite3', [sqliteDbPath,
-                    `UPDATE wp_options SET option_value='${localUrl}' WHERE option_name IN ('siteurl','home');`,
-                ], { encoding: 'utf-8' });
-                // Get admin username for blueprint login step
-                const adminResult = spawnSync('sqlite3', [sqliteDbPath,
-                    "SELECT user_login FROM wp_users WHERE ID = (SELECT user_id FROM wp_usermeta WHERE meta_key = 'wp_capabilities' AND meta_value LIKE '%administrator%' LIMIT 1);",
-                ], { encoding: 'utf-8' });
-                adminUsername = (adminResult.stdout || '').trim() || 'admin';
-                // Count tables for output
-                const countResult = spawnSync('sqlite3', [sqliteDbPath,
-                    "SELECT COUNT(*) FROM sqlite_master WHERE type='table';",
-                ], { encoding: 'utf-8' });
-                // Clean up temp file
+                // Import directly via better-sqlite3 (no external sqlite3 CLI needed)
+                const db = new Database(sqliteDbPath);
                 try {
-                    rmSync(tmpSql);
+                    db.exec(sqliteSql);
+                    // Find the table prefix and rename to wp_
+                    const tableRows = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'").all();
+                    const allTables = tableRows.map(r => r.name);
+                    const optionsTable = allTables.find(t => t.endsWith('_options'));
+                    const oldPrefix = optionsTable ? optionsTable.replace('options', '') : 'wp_';
+                    if (oldPrefix !== 'wp_') {
+                        const renames = allTables
+                            .filter(t => t.startsWith(oldPrefix))
+                            .map(t => `ALTER TABLE \`${t}\` RENAME TO \`wp_${t.substring(oldPrefix.length)}\``);
+                        db.exec(renames.join(';\n') + ';');
+                        // Rename meta keys and option names that contain the old prefix
+                        db.prepare('UPDATE wp_usermeta SET meta_key = REPLACE(meta_key, ?, ?) WHERE meta_key LIKE ?').run(oldPrefix, 'wp_', oldPrefix + '%');
+                        db.prepare('UPDATE wp_options SET option_name = REPLACE(option_name, ?, ?) WHERE option_name LIKE ?').run(oldPrefix, 'wp_', oldPrefix + '%');
+                    }
+                    // Search-replace old cloud URL → localhost (bound params: no SQL injection)
+                    const localUrl = `http://127.0.0.1:${instance.port}`;
+                    const oldDomain = site.url || site.sub_domain || '';
+                    const oldUrls = [
+                        oldDomain,
+                        oldDomain.replace('https://', 'http://'),
+                    ].filter(Boolean);
+                    const replaceStmts = [
+                        'UPDATE wp_options SET option_value = REPLACE(option_value, ?, ?) WHERE option_value LIKE ?',
+                        'UPDATE wp_posts SET post_content = REPLACE(post_content, ?, ?) WHERE post_content LIKE ?',
+                        'UPDATE wp_posts SET guid = REPLACE(guid, ?, ?) WHERE guid LIKE ?',
+                        'UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, ?, ?) WHERE meta_value LIKE ?',
+                        'UPDATE wp_comments SET comment_content = REPLACE(comment_content, ?, ?) WHERE comment_content LIKE ?',
+                    ].map(s => db.prepare(s));
+                    for (const oldUrl of oldUrls) {
+                        const likePattern = '%' + oldUrl + '%';
+                        for (const stmt of replaceStmts) {
+                            stmt.run(oldUrl, localUrl, likePattern);
+                        }
+                    }
+                    db.prepare("UPDATE wp_options SET option_value = ? WHERE option_name IN ('siteurl','home')").run(localUrl);
+                    // Get admin username for blueprint login step
+                    const adminRow = db.prepare("SELECT user_login FROM wp_users WHERE ID = (SELECT user_id FROM wp_usermeta WHERE meta_key = 'wp_capabilities' AND meta_value LIKE '%administrator%' LIMIT 1)").get();
+                    adminUsername = adminRow?.user_login || 'admin';
+                    const tableCount = db.prepare("SELECT COUNT(*) AS c FROM sqlite_master WHERE type='table'").get().c;
+                    dbSpin2.succeed(`Database imported (${tableCount} tables, admin: ${adminUsername})`);
+                }
+                finally {
+                    db.close();
                 }
-                catch { }
-                dbSpin2.succeed(`Database imported (${(countResult.stdout || '').trim()} tables, admin: ${adminUsername})`);
             }
             catch (err) {
                 dbSpin2.fail('Database import failed: ' + err.message);
@@ -579,9 +595,46 @@ ${chalk.bold.green('Clone complete!')}
     });
 }
 function checkRsync() {
-    const result = spawnSync('which', ['rsync'], { stdio: 'ignore' });
+    if (bundledRsync())
+        return true;
+    const cmd = process.platform === 'win32' ? 'where' : 'which';
+    const result = spawnSync(cmd, ['rsync'], { stdio: 'ignore' });
     return result.status === 0;
 }
+/**
+ * Locate an awk-compatible interpreter. Resolution order:
+ *   1. Bundled BusyBox-w64 in bin/win32/ (Windows only — invoked as `busybox awk`)
+ *   2. `awk` or `gawk` in PATH
+ *   3. Common Git-for-Windows install dirs (Windows only)
+ *
+ * Returns the command path plus any arg-prefix that must precede the awk
+ * arguments (busybox uses `busybox awk -f script input`).
+ */
+function findAwk() {
+    const bb = bundledBusybox();
+    if (bb)
+        return { cmd: bb, prefixArgs: ['awk'] };
+    const cmd = process.platform === 'win32' ? 'where' : 'which';
+    for (const name of ['awk', 'gawk']) {
+        const r = spawnSync(cmd, [name], { stdio: 'pipe' });
+        if (r.status === 0)
+            return { cmd: name, prefixArgs: [] };
+    }
+    if (process.platform === 'win32') {
+        const candidates = [
+            'C:\\Program Files\\Git\\usr\\bin\\awk.exe',
+            'C:\\Program Files (x86)\\Git\\usr\\bin\\awk.exe',
+        ];
+        if (process.env.PROGRAMFILES) {
+            candidates.push(process.env.PROGRAMFILES + '\\Git\\usr\\bin\\awk.exe');
+        }
+        for (const c of candidates) {
+            if (existsSync(c))
+                return { cmd: c, prefixArgs: [] };
+        }
+    }
+    return null;
+}
 function sanitizeName(name) {
     return name.replace(/[^a-zA-Z0-9_-]/g, '-').toLowerCase();
 }
@@ -611,27 +664,51 @@ function printUrls(port) {
 }
 async function launchServer(instance, opts) {
     const shouldOpen = opts.open !== false;
+    const json = isJsonMode();
     if (opts.background) {
-        const spin = spinner(`Starting "${instance.name}" in background...`);
-        spin.start();
+        const spin = json ? null : spinner(`Starting "${instance.name}" in background...`);
+        spin?.start();
         try {
             const { pid, url } = await startServerBackground(instance, opts.blueprint);
-            spin.succeed(`Running in background (PID: ${pid})`);
-            printUrls(instance.port);
+            if (json) {
+                console.log(JSON.stringify({
+                    success: true,
+                    data: {
+                        name: instance.name,
+                        url,
+                        port: instance.port,
+                        pid,
+                        wp: instance.wp,
+                        php: instance.php,
+                        path: instance.path,
+                    },
+                }));
+            }
+            else {
+                spin?.succeed(`Running in background (PID: ${pid})`);
+                printUrls(instance.port);
+                info(`Stop with: instawp local stop ${instance.name}`);
+                info(`Logs: ${instance.path}/server.log`);
+            }
             if (shouldOpen)
                 await openWpAdmin(url);
-            info(`Stop with: instawp local stop ${instance.name}`);
-            info(`Logs: ${instance.path}/server.log`);
         }
         catch (err) {
-            spin.fail('Failed to start');
-            error(err.message);
+            if (json) {
+                console.log(JSON.stringify({ success: false, error: err.message }));
+            }
+            else {
+                spin?.fail('Failed to start');
+                error(err.message);
+            }
             process.exit(1);
         }
     }
     else {
-        printUrls(instance.port);
-        console.log(chalk.dim('\nPress Ctrl+C to stop.\n'));
+        if (!json) {
+            printUrls(instance.port);
+            console.log(chalk.dim('\nPress Ctrl+C to stop.\n'));
+        }
         try {
             await startServer(instance, {
                 blueprint: opts.blueprint,