@wp-playground/cli 3.0.40 → 3.0.41

package/{run-cli-pLJHMn5d.js → run-cli-vem_UKTF.js}

@@ -1,24 +1,26 @@
-import { logger as u, LogSeverity as V, errorLogPath as Z } from "@php-wasm/logger";
-import { PHPResponse as _, consumeAPI as D, SupportedPHPVersions as he, printDebugDetails as me, exposeAPI as we, exposeSyncAPI as ge } from "@php-wasm/universal";
-import { resolveRemoteBlueprint as ye, resolveRuntimeConfiguration as Y, compileBlueprintV1 as be, isBlueprintBundle as Pe, runBlueprintV1Steps as ve } from "@wp-playground/blueprints";
-import { zipDirectory as ke, RecommendedPHPVersion as re } from "@wp-playground/common";
-import p, { existsSync as se, mkdirSync as G } from "fs";
-import { Worker as Q, MessageChannel as xe } from "worker_threads";
-import { createNodeFsMountHandler as Se, FileLockManagerForNode as Ie } from "@php-wasm/node";
-import w, { basename as R, join as ne } from "path";
-import Te from "express";
-import ie, { cpus as $e } from "os";
-import { jspi as Ee } from "wasm-feature-detect";
-import Ce from "yargs";
-import { NodeJsFilesystem as We, OverlayFilesystem as Be, InMemoryFilesystem as Le, ZipFilesystem as Me } from "@wp-playground/storage";
-import { EmscriptenDownloadMonitor as Re, ProgressTracker as De } from "@php-wasm/progress";
-import { resolveWordPressRelease as Fe } from "@wp-playground/wordpress";
+import { logger as u, LogSeverity as N, errorLogPath as ee } from "@php-wasm/logger";
+import { PHPResponse as j, consumeAPI as D, SupportedPHPVersions as te, printDebugDetails as ye, exposeAPI as be, exposeSyncAPI as Pe } from "@php-wasm/universal";
+import { resolveRemoteBlueprint as ve, resolveRuntimeConfiguration as oe, compileBlueprintV1 as ke, isBlueprintBundle as xe, runBlueprintV1Steps as Se } from "@wp-playground/blueprints";
+import { zipDirectory as Ie, RecommendedPHPVersion as q } from "@wp-playground/common";
+import f, { existsSync as Y, rmdirSync as $e, mkdirSync as z, readdirSync as Te } from "fs";
+import { MessageChannel as Ee, Worker as re } from "worker_threads";
+import { createNodeFsMountHandler as Ce, FileLockManagerForNode as We } from "@php-wasm/node";
+import h, { basename as R, join as de } from "path";
+import Be from "express";
+import U, { cpus as Me } from "os";
+import { jspi as Le } from "wasm-feature-detect";
+import Re from "yargs";
+import { NodeJsFilesystem as De, OverlayFilesystem as Ue, InMemoryFilesystem as Fe, ZipFilesystem as Ae } from "@wp-playground/storage";
+import { EmscriptenDownloadMonitor as He, ProgressTracker as Ve } from "@php-wasm/progress";
+import { resolveWordPressRelease as Ne } from "@wp-playground/wordpress";
 import C from "fs-extra";
-import { startBridge as Ue } from "@php-wasm/xdebug-bridge";
-import { dir as Ae, setGracefulCleanup as He } from "tmp-promise";
-import Ve from "ps-man";
-import { removeTempDirSymlink as Ne, createTempDirSymlink as _e, clearXdebugIDEConfig as Oe, addXdebugIDEConfig as je } from "@php-wasm/cli-util";
-function J(e) {
+import { startBridge as Oe } from "@php-wasm/xdebug-bridge";
+import { exec as _e } from "child_process";
+import { dir as je, setGracefulCleanup as qe } from "tmp-promise";
+import ze from "ps-man";
+import { removeTempDirSymlink as Xe, createTempDirSymlink as Ye, clearXdebugIDEConfig as Ze, addXdebugIDEConfig as Ge } from "@php-wasm/cli-util";
+import { createHash as Je } from "crypto";
+function O(e) {
   const t = [];
   for (const o of e) {
     const n = o.split(":");
@@ -28,35 +30,35 @@ function J(e) {
 				If your path contains a colon, e.g. C:\\myplugin, use the --mount-dir option instead.
 				Example: --mount-dir C:\\my-plugin /wordpress/wp-content/plugins/my-plugin`);
     const [r, s] = n;
-    if (!se(r))
+    if (!Y(r))
       throw new Error(`Host path does not exist: ${r}`);
     t.push({ hostPath: r, vfsPath: s });
   }
   return t;
 }
-function K(e) {
+function se(e) {
   if (e.length % 2 !== 0)
     throw new Error("Invalid mount format. Expected: /host/path /vfs/path");
   const t = [];
   for (let o = 0; o < e.length; o += 2) {
     const n = e[o], r = e[o + 1];
-    if (!se(n))
+    if (!Y(n))
       throw new Error(`Host path does not exist: ${n}`);
     t.push({
-      hostPath: w.resolve(process.cwd(), n),
+      hostPath: h.resolve(process.cwd(), n),
       vfsPath: r
     });
   }
   return t;
 }
-async function At(e, t) {
+async function Zt(e, t) {
   for (const o of t)
     await e.mount(
       o.vfsPath,
-      Se(o.hostPath)
+      Ce(o.hostPath)
     );
 }
-const ee = {
+const ne = {
   step: "runPHP",
   code: {
     filename: "activate-theme.php",
@@ -75,7 +77,7 @@ const ee = {
 		`
   }
 };
-function qe(e) {
+function ue(e) {
   const t = e.autoMount, o = [...e.mount || []], n = [...e["mount-before-install"] || []], r = {
     ...e,
     mount: o,
@@ -84,7 +86,7 @@ function qe(e) {
       ...e["additional-blueprint-steps"] || []
     ]
   };
-  if (Ye(t)) {
+  if (tt(t)) {
     const s = R(t);
     o.push({
       hostPath: t,
@@ -93,7 +95,7 @@ function qe(e) {
       step: "activatePlugin",
       pluginPath: `/wordpress/wp-content/plugins/${R(t)}`
     });
-  } else if (Ze(t)) {
+  } else if (et(t)) {
     const s = R(t);
     o.push({
       hostPath: t,
@@ -107,80 +109,80 @@ function qe(e) {
         themeFolderName: s
       }
     );
-  } else if (Xe(t)) {
-    const s = p.readdirSync(t);
-    for (const a of s)
-      a !== "index.php" && o.push({
-        hostPath: `${t}/${a}`,
-        vfsPath: `/wordpress/wp-content/${a}`
+  } else if (Ke(t)) {
+    const s = f.readdirSync(t);
+    for (const i of s)
+      i !== "index.php" && o.push({
+        hostPath: `${t}/${i}`,
+        vfsPath: `/wordpress/wp-content/${i}`
       });
-    r["additional-blueprint-steps"].push(ee);
-  } else ze(t) ? (n.push({ hostPath: t, vfsPath: "/wordpress" }), r.mode = "apply-to-existing-site", r["additional-blueprint-steps"].push(ee), r.wordpressInstallMode || (r.wordpressInstallMode = "install-from-existing-files-if-needed")) : (o.push({ hostPath: t, vfsPath: "/wordpress" }), r.mode = "mount-only");
+    r["additional-blueprint-steps"].push(ne);
+  } else Qe(t) && (n.push({ hostPath: t, vfsPath: "/wordpress" }), r.mode = "apply-to-existing-site", r["additional-blueprint-steps"].push(ne), r.wordpressInstallMode || (r.wordpressInstallMode = "install-from-existing-files-if-needed"));
   return r;
 }
-function ze(e) {
-  const t = p.readdirSync(e);
+function Qe(e) {
+  const t = f.readdirSync(e);
   return t.includes("wp-admin") && t.includes("wp-includes") && t.includes("wp-content");
 }
-function Xe(e) {
-  const t = p.readdirSync(e);
+function Ke(e) {
+  const t = f.readdirSync(e);
   return t.includes("themes") || t.includes("plugins") || t.includes("mu-plugins") || t.includes("uploads");
 }
-function Ze(e) {
-  if (!p.readdirSync(e).includes("style.css"))
+function et(e) {
+  if (!f.readdirSync(e).includes("style.css"))
     return !1;
-  const o = p.readFileSync(ne(e, "style.css"), "utf8");
+  const o = f.readFileSync(de(e, "style.css"), "utf8");
   return !!/^(?:[ \t]*<\?php)?[ \t/*#@]*Theme Name:(.*)$/im.exec(o);
 }
-function Ye(e) {
-  const t = p.readdirSync(e), o = /^(?:[ \t]*<\?php)?[ \t/*#@]*Plugin Name:(.*)$/im;
+function tt(e) {
+  const t = f.readdirSync(e), o = /^(?:[ \t]*<\?php)?[ \t/*#@]*Plugin Name:(.*)$/im;
   return !!t.filter((r) => r.endsWith(".php")).find((r) => {
-    const s = p.readFileSync(ne(e, r), "utf8");
+    const s = f.readFileSync(de(e, r), "utf8");
     return !!o.exec(s);
   });
 }
-async function Ge(e) {
-  const t = Te(), o = await new Promise((s, a) => {
+async function ot(e) {
+  const t = Be(), o = await new Promise((s, i) => {
     const l = t.listen(e.port, () => {
       const d = l.address();
-      d === null || typeof d == "string" ? a(new Error("Server address is not available")) : s(l);
+      d === null || typeof d == "string" ? i(new Error("Server address is not available")) : s(l);
     });
   });
-  t.use("/", async (s, a) => {
+  t.use("/", async (s, i) => {
     let l;
     try {
       l = await e.handleRequest({
         url: s.url,
-        headers: Je(s),
+        headers: st(s),
         method: s.method,
-        body: await Qe(s)
+        body: await rt(s)
       });
     } catch (d) {
-      u.error(d), l = _.forHttpCode(500);
+      u.error(d), l = j.forHttpCode(500);
     }
-    a.statusCode = l.httpStatusCode;
+    i.statusCode = l.httpStatusCode;
     for (const d in l.headers)
-      a.setHeader(d, l.headers[d]);
-    a.end(l.bytes);
+      i.setHeader(d, l.headers[d]);
+    i.end(l.bytes);
   });
   const r = o.address().port;
   return await e.onBind(o, r);
 }
-const Qe = async (e) => await new Promise((t) => {
+const rt = async (e) => await new Promise((t) => {
   const o = [];
   e.on("data", (n) => {
     o.push(n);
   }), e.on("end", () => {
     t(new Uint8Array(Buffer.concat(o)));
   });
-}), Je = (e) => {
+}), st = (e) => {
   const t = {};
   if (e.rawHeaders && e.rawHeaders.length)
     for (let o = 0; o < e.rawHeaders.length; o += 2)
       t[e.rawHeaders[o].toLowerCase()] = e.rawHeaders[o + 1];
   return t;
 };
-class Ke {
+class nt {
   constructor(t) {
     this.workerLoads = [], this.addWorker(t);
   }
@@ -211,33 +213,33 @@ class Ke {
     });
   }
 }
-function et(e) {
+function it(e) {
   return /^latest$|^trunk$|^nightly$|^(?:(\d+)\.(\d+)(?:\.(\d+))?)((?:-beta(?:\d+)?)|(?:-RC(?:\d+)?))?$/.test(e);
 }
-async function tt({
+async function at({
   sourceString: e,
   blueprintMayReadAdjacentFiles: t
 }) {
   if (!e)
     return;
   if (e.startsWith("http://") || e.startsWith("https://"))
-    return await ye(e);
-  let o = w.resolve(process.cwd(), e);
-  if (!p.existsSync(o))
+    return await ve(e);
+  let o = h.resolve(process.cwd(), e);
+  if (!f.existsSync(o))
     throw new Error(`Blueprint file does not exist: ${o}`);
-  const n = p.statSync(o);
-  if (n.isDirectory() && (o = w.join(o, "blueprint.json")), !n.isFile() && n.isSymbolicLink())
+  const n = f.statSync(o);
+  if (n.isDirectory() && (o = h.join(o, "blueprint.json")), !n.isFile() && n.isSymbolicLink())
     throw new Error(
       `Blueprint path is neither a file nor a directory: ${o}`
     );
-  const r = w.extname(o);
+  const r = h.extname(o);
   switch (r) {
     case ".zip":
-      return Me.fromArrayBuffer(
-        p.readFileSync(o).buffer
+      return Ae.fromArrayBuffer(
+        f.readFileSync(o).buffer
       );
     case ".json": {
-      const s = p.readFileSync(o, "utf-8");
+      const s = f.readFileSync(o, "utf-8");
       try {
         JSON.parse(s);
       } catch {
@@ -245,9 +247,9 @@ async function tt({
           `Blueprint file at ${o} is not a valid JSON file`
         );
       }
-      const a = w.dirname(o), l = new We(a);
-      return new Be([
-        new Le({
+      const i = h.dirname(o), l = new De(i);
+      return new Ue([
+        new Fe({
           "blueprint.json": s
         }),
         /**
@@ -273,10 +275,10 @@ You can allow this Blueprint to read files from the same parent directory by exp
       );
   }
 }
-function ae(e) {
+function ce(e) {
   return process.env.CI === "true" || process.env.CI === "1" || process.env.GITHUB_ACTIONS === "true" || process.env.GITHUB_ACTIONS === "1" || (process.env.TERM || "").toLowerCase() === "dumb" ? !1 : e ? !!e.isTTY : process.stdout.isTTY;
 }
-class ot {
+class lt {
   constructor(t, o) {
     this.lastProgressMessage = "", this.args = t, this.siteUrl = o.siteUrl, this.processIdSpaceLength = o.processIdSpaceLength, this.phpVersion = t.php;
   }
@@ -292,7 +294,7 @@ class ot {
       siteUrl: this.siteUrl,
       firstProcessId: 1,
       processIdSpaceLength: this.processIdSpaceLength,
-      trace: this.args.debug || !1,
+      trace: this.args.verbosity === "debug",
       blueprint: this.args.blueprint,
       withIntl: this.args.intl,
       // We do not enable Xdebug by default for the initial worker
@@ -315,58 +317,58 @@ class ot {
   }) {
     const s = D(t.phpPort);
     await s.useFileLockManager(o);
-    const a = {
+    const i = {
       ...this.args,
       phpVersion: this.phpVersion,
       siteUrl: this.siteUrl,
       firstProcessId: n,
       processIdSpaceLength: this.processIdSpaceLength,
-      trace: this.args.debug || !1,
+      trace: this.args.verbosity === "debug",
       withIntl: this.args.intl,
       withXdebug: !!this.args.xdebug,
       nativeInternalDirPath: r,
       mountsBeforeWpInstall: this.args["mount-before-install"] || [],
       mountsAfterWpInstall: this.args.mount || []
     };
-    return await s.bootWorker(a), s;
+    return await s.bootWorker(i), s;
   }
   writeProgressUpdate(t, o, n) {
-    ae(t) && o !== this.lastProgressMessage && (this.lastProgressMessage = o, t.isTTY ? (t.cursorTo(0), t.write(o), t.clearLine(1), n && t.write(`
+    ce(t) && o !== this.lastProgressMessage && (this.lastProgressMessage = o, t.isTTY ? (t.cursorTo(0), t.write(o), t.clearLine(1), n && t.write(`
 `)) : t.write(`${o}
 `));
   }
 }
-const O = w.join(ie.homedir(), ".wordpress-playground");
-async function rt(e) {
-  return await le(
+const X = h.join(U.homedir(), ".wordpress-playground");
+async function dt(e) {
+  return await pe(
     "https://github.com/WordPress/sqlite-database-integration/archive/refs/heads/develop.zip",
     "sqlite.zip",
     e
   );
 }
-async function le(e, t, o) {
-  const n = w.join(O, t);
-  return C.existsSync(n) || (C.ensureDirSync(O), await st(e, n, o)), de(n);
+async function pe(e, t, o) {
+  const n = h.join(X, t);
+  return C.existsSync(n) || (C.ensureDirSync(X), await ut(e, n, o)), fe(n);
 }
-async function st(e, t, o) {
-  const r = (await o.monitorFetch(fetch(e))).body.getReader(), s = `${t}.partial`, a = C.createWriteStream(s);
+async function ut(e, t, o) {
+  const r = (await o.monitorFetch(fetch(e))).body.getReader(), s = `${t}.partial`, i = C.createWriteStream(s);
   for (; ; ) {
     const { done: l, value: d } = await r.read();
-    if (d && a.write(d), l)
+    if (d && i.write(d), l)
       break;
   }
-  a.close(), a.closed || await new Promise((l, d) => {
-    a.on("finish", () => {
+  i.close(), i.closed || await new Promise((l, d) => {
+    i.on("finish", () => {
       C.renameSync(s, t), l(null);
-    }), a.on("error", (f) => {
-      C.removeSync(s), d(f);
+    }), i.on("error", (b) => {
+      C.removeSync(s), d(b);
     });
   });
 }
-function de(e, t) {
+function fe(e, t) {
   return new File([C.readFileSync(e)], R(e));
 }
-class nt {
+class ct {
   constructor(t, o) {
     this.lastProgressMessage = "", this.args = t, this.siteUrl = o.siteUrl, this.processIdSpaceLength = o.processIdSpaceLength;
   }
@@ -374,25 +376,25 @@ class nt {
     return "v1";
   }
   async bootAndSetUpInitialPlayground(t, o, n) {
-    let r, s, a;
-    const l = new Re();
+    let r, s, i;
+    const l = new He();
     if (this.args.wordpressInstallMode === "download-and-install") {
-      let I = !1;
-      l.addEventListener("progress", (q) => {
-        if (I)
+      let v = !1;
+      l.addEventListener("progress", (W) => {
+        if (v)
           return;
-        const { loaded: F, total: x } = q.detail, W = Math.floor(
-          Math.min(100, 100 * F / x)
+        const { loaded: G, total: F } = W.detail, k = Math.floor(
+          Math.min(100, 100 * G / F)
         );
-        I = W === 100, this.writeProgressUpdate(
+        v = k === 100, this.writeProgressUpdate(
           process.stdout,
-          `Downloading WordPress ${W}%...`,
-          I
+          `Downloading WordPress ${k}%...`,
+          v
         );
-      }), r = await Fe(this.args.wp), a = w.join(
-        O,
+      }), r = await Ne(this.args.wp), i = h.join(
+        X,
         `prebuilt-wp-content-for-wp-${r.version}.zip`
-      ), s = p.existsSync(a) ? de(a) : await le(
+      ), s = f.existsSync(i) ? fe(i) : await pe(
         r.releaseUrl,
         `${r.version}.zip`,
         l
@@ -401,25 +403,25 @@ class nt {
       );
     }
     let d;
-    this.args.skipSqliteSetup ? (u.log("Skipping SQLite integration plugin setup..."), d = void 0) : (u.log("Fetching SQLite integration plugin..."), d = await rt(l));
-    const f = this.args.followSymlinks === !0, i = this.args.experimentalTrace === !0, y = this.args["mount-before-install"] || [], g = this.args.mount || [], P = D(t);
-    await P.isConnected(), u.log("Booting WordPress...");
-    const k = await Y(
+    this.args.skipSqliteSetup ? (u.log("Skipping SQLite integration plugin setup..."), d = void 0) : (u.log("Fetching SQLite integration plugin..."), d = await dt(l));
+    const b = this.args.followSymlinks === !0, g = this.args.experimentalTrace === !0, a = this.args["mount-before-install"] || [], y = this.args.mount || [], p = D(t);
+    await p.isConnected(), u.log("Booting WordPress...");
+    const I = await oe(
       this.getEffectiveBlueprint()
     );
-    return await P.useFileLockManager(o), await P.bootAndSetUpInitialWorker({
-      phpVersion: k.phpVersion,
-      wpVersion: k.wpVersion,
+    return await p.useFileLockManager(o), await p.bootAndSetUpInitialWorker({
+      phpVersion: I.phpVersion,
+      wpVersion: I.wpVersion,
       siteUrl: this.siteUrl,
-      mountsBeforeWpInstall: y,
-      mountsAfterWpInstall: g,
+      mountsBeforeWpInstall: a,
+      mountsAfterWpInstall: y,
       wordpressInstallMode: this.args.wordpressInstallMode || "download-and-install",
       wordPressZip: s && await s.arrayBuffer(),
       sqliteIntegrationPluginZip: await d?.arrayBuffer(),
       firstProcessId: 0,
       processIdSpaceLength: this.processIdSpaceLength,
-      followSymlinks: f,
-      trace: i,
+      followSymlinks: b,
+      trace: g,
       internalCookieStore: this.args.internalCookieStore,
       withIntl: this.args.intl,
       // We do not enable Xdebug by default for the initial worker
@@ -428,10 +430,10 @@ class nt {
       // TODO: Consider supporting Xdebug for the initial worker via a dedicated flag.
       withXdebug: !1,
       nativeInternalDirPath: n
-    }), a && !this.args["mount-before-install"] && !p.existsSync(a) && (u.log("Caching preinstalled WordPress for the next boot..."), p.writeFileSync(
-      a,
-      await ke(P, "/wordpress")
-    ), u.log("Cached!")), P;
+    }), i && !this.args["mount-before-install"] && !f.existsSync(i) && (u.log("Caching preinstalled WordPress for the next boot..."), f.writeFileSync(
+      i,
+      await Ie(p, "/wordpress")
+    ), u.log("Cached!")), p;
   }
   async bootPlayground({
     worker: t,
@@ -443,11 +445,11 @@ class nt {
       t.phpPort
     );
     await s.isConnected();
-    const a = await Y(
+    const i = await oe(
       this.getEffectiveBlueprint()
     );
     return await s.useFileLockManager(o), await s.bootWorker({
-      phpVersion: a.phpVersion,
+      phpVersion: i.phpVersion,
       siteUrl: this.siteUrl,
       mountsBeforeWpInstall: this.args["mount-before-install"] || [],
       mountsAfterWpInstall: this.args.mount || [],
@@ -464,45 +466,45 @@ class nt {
     }), await s.isReady(), s;
   }
   async compileInputBlueprint(t) {
-    const o = this.getEffectiveBlueprint(), n = new De();
+    const o = this.getEffectiveBlueprint(), n = new Ve();
     let r = "", s = !1;
-    return n.addEventListener("progress", (a) => {
+    return n.addEventListener("progress", (i) => {
       if (s)
         return;
-      s = a.detail.progress === 100;
-      const l = Math.floor(a.detail.progress);
-      r = a.detail.caption || r || "Running the Blueprint";
+      s = i.detail.progress === 100;
+      const l = Math.floor(i.detail.progress);
+      r = i.detail.caption || r || "Running the Blueprint";
       const d = `${r.trim()} – ${l}%`;
       this.writeProgressUpdate(
         process.stdout,
         d,
         s
       );
-    }), await be(o, {
+    }), await ke(o, {
       progress: n,
       additionalSteps: t
     });
   }
   getEffectiveBlueprint() {
     const t = this.args.blueprint;
-    return Pe(t) ? t : {
+    return xe(t) ? t : {
       login: this.args.login,
       ...t || {},
       preferredVersions: {
-        php: this.args.php ?? t?.preferredVersions?.php ?? re,
+        php: this.args.php ?? t?.preferredVersions?.php ?? q,
         wp: this.args.wp ?? t?.preferredVersions?.wp ?? "latest",
         ...t?.preferredVersions || {}
       }
     };
   }
   writeProgressUpdate(t, o, n) {
-    this.args.verbosity !== j.Quiet.name && ae(t) && o !== this.lastProgressMessage && (this.lastProgressMessage = o, t.isTTY ? (t.cursorTo(0), t.write(o), t.clearLine(1), n && t.write(`
+    this.args.verbosity !== Z.Quiet.name && ce(t) && o !== this.lastProgressMessage && (this.lastProgressMessage = o, t.isTTY ? (t.cursorTo(0), t.write(o), t.clearLine(1), n && t.write(`
 `)) : t.write(`${o}
 `));
   }
 }
-async function it(e, t = !0) {
-  const n = `${w.basename(process.argv0)}${e}${process.pid}-`, r = await Ae({
+async function pt(e, t = !0) {
+  const n = `${h.basename(process.argv0)}${e}${process.pid}-`, r = await je({
     prefix: n,
     /*
      * Allow recursive cleanup on process exit.
@@ -514,32 +516,32 @@ async function it(e, t = !0) {
      */
     unsafeCleanup: !0
   });
-  return t && He(), r;
+  return t && qe(), r;
 }
-async function at(e, t, o) {
-  const r = (await lt(
+async function ft(e, t, o) {
+  const r = (await ht(
     e,
     t,
     o
   )).map(
-    (s) => new Promise((a) => {
-      p.rm(s, { recursive: !0 }, (l) => {
+    (s) => new Promise((i) => {
+      f.rm(s, { recursive: !0 }, (l) => {
         l ? u.warn(
           `Failed to delete stale Playground temp dir: ${s}`,
           l
         ) : u.info(
           `Deleted stale Playground temp dir: ${s}`
-        ), a();
+        ), i();
       });
     })
   );
   await Promise.all(r);
 }
-async function lt(e, t, o) {
+async function ht(e, t, o) {
   try {
-    const n = p.readdirSync(o).map((s) => w.join(o, s)), r = [];
+    const n = f.readdirSync(o).map((s) => h.join(o, s)), r = [];
     for (const s of n)
-      await dt(
+      await mt(
         e,
         t,
         s
@@ -549,10 +551,10 @@ async function lt(e, t, o) {
     return u.warn(`Failed to find stale Playground temp dirs: ${n}`), [];
   }
 }
-async function dt(e, t, o) {
-  if (!p.lstatSync(o).isDirectory())
+async function mt(e, t, o) {
+  if (!f.lstatSync(o).isDirectory())
     return !1;
-  const r = w.basename(o);
+  const r = h.basename(o);
   if (!r.includes(e))
     return !1;
   const s = r.match(
@@ -560,39 +562,39 @@ async function dt(e, t, o) {
   );
   if (!s)
     return !1;
-  const a = {
+  const i = {
     executableName: s[1],
     pid: s[2]
   };
-  if (await ut(a.pid, a.executableName))
+  if (await wt(i.pid, i.executableName))
     return !1;
   const l = Date.now() - t;
-  return p.statSync(o).mtime.getTime() < l;
+  return f.statSync(o).mtime.getTime() < l;
 }
-async function ut(e, t) {
+async function wt(e, t) {
   const [o] = await new Promise(
     (n, r) => {
-      Ve.list(
+      ze.list(
         {
           pid: e,
           name: t,
           // Remove path from executable name in the results.
           clean: !0
         },
-        (s, a) => {
-          s ? r(s) : n(a);
+        (s, i) => {
+          s ? r(s) : n(i);
         }
       );
     }
   );
   return !!o && o.pid === e && o.command === t;
 }
-const j = {
-  Quiet: { name: "quiet", severity: V.Fatal },
-  Normal: { name: "normal", severity: V.Info },
-  Debug: { name: "debug", severity: V.Debug }
+const Z = {
+  Quiet: { name: "quiet", severity: N.Fatal },
+  Normal: { name: "normal", severity: N.Info },
+  Debug: { name: "debug", severity: N.Debug }
 };
-async function Ht(e) {
+async function Gt(e) {
   try {
     const t = {
       "site-url": {
@@ -602,8 +604,8 @@ async function Ht(e) {
       php: {
         describe: "PHP version to use.",
         type: "string",
-        default: re,
-        choices: he
+        default: q,
+        choices: te
       },
       wp: {
         describe: "WordPress version to use.",
@@ -616,27 +618,27 @@ async function Ht(e) {
         describe: "Mount a directory to the PHP runtime (can be used multiple times). Format: /host/path:/vfs/path",
         type: "array",
         string: !0,
-        coerce: J
+        coerce: O
       },
       "mount-before-install": {
         describe: "Mount a directory to the PHP runtime before WordPress installation (can be used multiple times). Format: /host/path:/vfs/path",
         type: "array",
         string: !0,
-        coerce: J
+        coerce: O
       },
       "mount-dir": {
         describe: 'Mount a directory to the PHP runtime (can be used multiple times). Format: "/host/path" "/vfs/path"',
         type: "array",
         nargs: 2,
         array: !0,
-        coerce: K
+        coerce: se
       },
       "mount-dir-before-install": {
         describe: 'Mount a directory before WordPress installation (can be used multiple times). Format: "/host/path" "/vfs/path"',
         type: "string",
         nargs: 2,
         array: !0,
-        coerce: K
+        coerce: se
       },
       login: {
         describe: "Should log the user in",
@@ -683,15 +685,17 @@ async function Ht(e) {
       verbosity: {
         describe: "Output logs and progress messages.",
         type: "string",
-        choices: Object.values(j).map(
-          (i) => i.name
+        choices: Object.values(Z).map(
+          (a) => a.name
         ),
         default: "normal"
       },
       debug: {
         describe: "Print PHP error log content if an error occurs during Playground boot.",
         type: "boolean",
-        default: !1
+        default: !1,
+        // Hide this deprecated option. Use verbosity=debug instead.
+        hidden: !0
       },
       "auto-mount": {
         describe: "Automatically mount the specified directory. If no path is provided, mount the current working directory. You can mount a WordPress directory, a plugin directory, a theme directory, a wp-content directory, or any directory containing PHP and HTML files.",
@@ -732,7 +736,7 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
         // supported IDEs and, if needed, will create the relevant
         // config file for each.
         choices: ["", "vscode", "phpstorm"],
-        coerce: (i) => i === "" ? ["vscode", "phpstorm"] : [i]
+        coerce: (a) => a === "" ? ["vscode", "phpstorm"] : [a]
       },
       "experimental-blueprints-v2-runner": {
         describe: "Use the experimental Blueprint V2 runner.",
@@ -757,54 +761,139 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
       "experimental-multi-worker": {
         describe: "Enable experimental multi-worker support which requires a /wordpress directory backed by a real filesystem. Pass a positive number to specify the number of workers to use. Otherwise, default to the number of CPUs minus 1.",
         type: "number",
-        coerce: (i) => i ?? $e().length - 1
+        coerce: (a) => a ?? Me().length - 1
       },
       "experimental-devtools": {
         describe: "Enable experimental browser development tools.",
         type: "boolean"
       }
     }, n = {
+      path: {
+        describe: "Path to the project directory. Playground will auto-detect if this is a plugin, theme, wp-content, or WordPress directory.",
+        type: "string",
+        default: process.cwd()
+      },
+      php: {
+        describe: "PHP version to use.",
+        type: "string",
+        default: q,
+        choices: te
+      },
+      wp: {
+        describe: "WordPress version to use.",
+        type: "string",
+        default: "latest"
+      },
+      port: {
+        describe: "Port to listen on.",
+        type: "number",
+        default: 9400
+      },
+      blueprint: {
+        describe: "Path to a Blueprint JSON file to execute on startup.",
+        type: "string"
+      },
+      login: {
+        describe: "Auto-login as the admin user.",
+        type: "boolean",
+        default: !0
+      },
+      xdebug: {
+        describe: "Enable Xdebug for debugging.",
+        type: "boolean",
+        default: !1
+      },
+      "experimental-unsafe-ide-integration": t["experimental-unsafe-ide-integration"],
+      "skip-browser": {
+        describe: "Do not open the site in your default browser on startup.",
+        type: "boolean",
+        default: !1
+      },
+      quiet: {
+        describe: "Suppress non-essential output.",
+        type: "boolean",
+        default: !1
+      },
+      // Advanced options for power users who need more control
+      "site-url": {
+        describe: "Override the site URL. By default, derived from the port (http://127.0.0.1:<port>).",
+        type: "string"
+      },
+      mount: {
+        describe: "Mount a directory to the PHP runtime (can be used multiple times). Format: /host/path:/vfs/path. Use this for additional mounts beyond auto-detection.",
+        type: "array",
+        string: !0,
+        coerce: O
+      },
+      reset: {
+        describe: "Deletes the stored site directory and starts a new site from scratch.",
+        type: "boolean",
+        default: !1
+      },
+      "no-auto-mount": {
+        describe: "Disable automatic project type detection. Use --mount to manually specify mounts instead.",
+        type: "boolean",
+        default: !1
+      }
+    }, r = {
       outfile: {
         describe: "When building, write to this output file.",
         type: "string",
         default: "wordpress.zip"
       }
-    }, r = Ce(e).usage("Usage: wp-playground <command> [options]").command(
+    }, s = Re(e).usage("Usage: wp-playground <command> [options]").command(
+      "start",
+      "Start a local WordPress server with automatic project detection (recommended)",
+      (a) => a.usage(
+        `Usage: wp-playground start [options]
+
+The easiest way to run WordPress locally. Automatically detects
+if your directory contains a plugin, theme, wp-content, or
+WordPress installation and configures everything for you.
+
+Examples:
+  wp-playground start                    # Start in current directory
+  wp-playground start --path=./my-plugin # Start with a specific path
+  wp-playground start --wp=6.7 --php=8.3 # Use specific versions
+  wp-playground start --skip-browser     # Skip opening browser
+  wp-playground start --no-auto-mount    # Disable auto-detection`
+      ).options(n)
+    ).command(
       "server",
-      "Start a local WordPress server",
-      (i) => i.options({
+      "Start a local WordPress server (advanced, low-level)",
+      (a) => a.options({
         ...t,
         ...o
       })
     ).command(
       "run-blueprint",
       "Execute a Blueprint without starting a server",
-      (i) => i.options({ ...t })
+      (a) => a.options({ ...t })
     ).command(
       "build-snapshot",
       "Build a ZIP snapshot of a WordPress site based on a Blueprint",
-      (i) => i.options({
+      (a) => a.options({
         ...t,
-        ...n
+        ...r
       })
     ).demandCommand(1, "Please specify a command").strictCommands().conflicts(
       "experimental-unsafe-ide-integration",
       "experimental-devtools"
-    ).showHelpOnFail(!1).fail((i, y, g) => {
+    ).showHelpOnFail(!1).fail((a, y, p) => {
       if (y)
         throw y;
-      i && i.includes("Please specify a command") && (g.showHelp(), console.error(`
-` + i), process.exit(1)), console.error(i), process.exit(1);
-    }).strictOptions().check(async (i) => {
-      if (i["skip-wordpress-install"] === !0 && (i["wordpress-install-mode"] = "do-not-attempt-installing", i.wordpressInstallMode = "do-not-attempt-installing"), i.wp !== void 0 && typeof i.wp == "string" && !et(i.wp))
+      a && a.includes("Please specify a command") && (p.showHelp(), console.error(`
+` + a), process.exit(1)), console.error(a), process.exit(1);
+    }).strictOptions().check(async (a) => {
+      if (a["skip-wordpress-install"] === !0 && (a["wordpress-install-mode"] = "do-not-attempt-installing", a.wordpressInstallMode = "do-not-attempt-installing"), a.wp !== void 0 && typeof a.wp == "string" && !it(a.wp))
         try {
-          new URL(i.wp);
+          new URL(a.wp);
         } catch {
           throw new Error(
             'Unrecognized WordPress version. Please use "latest", a URL, or a numeric version such as "6.2", "6.0.1", "6.2-beta1", or "6.2-RC1"'
           );
         }
-      const y = i["site-url"];
+      const y = a["site-url"];
       if (typeof y == "string" && y.trim() !== "")
         try {
           new URL(y);
@@ -813,82 +902,84 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
             `Invalid site-url "${y}". Please provide a valid URL (e.g., http://localhost:8080 or https://example.com)`
           );
         }
-      if (i["auto-mount"]) {
-        let g = !1;
+      if (a["auto-mount"]) {
+        let p = !1;
         try {
-          g = p.statSync(
-            i["auto-mount"]
+          p = f.statSync(
+            a["auto-mount"]
           ).isDirectory();
         } catch {
-          g = !1;
+          p = !1;
         }
-        if (!g)
+        if (!p)
           throw new Error(
-            `The specified --auto-mount path is not a directory: '${i["auto-mount"]}'.`
+            `The specified --auto-mount path is not a directory: '${a["auto-mount"]}'.`
           );
       }
-      if (i["experimental-multi-worker"] !== void 0) {
-        if (i._[0] !== "server")
+      if (a["experimental-multi-worker"] !== void 0) {
+        if (a._[0] !== "server")
           throw new Error(
             "The --experimental-multi-worker flag is only supported when running the server command."
           );
-        if (i["experimental-multi-worker"] !== void 0 && typeof i["experimental-multi-worker"] == "number" && i["experimental-multi-worker"] <= 1)
+        if (a["experimental-multi-worker"] !== void 0 && typeof a["experimental-multi-worker"] == "number" && a["experimental-multi-worker"] <= 1)
           throw new Error(
             "The --experimental-multi-worker flag must be a positive integer greater than 1."
           );
       }
-      if (i["experimental-blueprints-v2-runner"] === !0) {
-        if (i.mode !== void 0) {
-          if (i["wordpress-install-mode"] !== void 0)
+      if (a["experimental-blueprints-v2-runner"] === !0) {
+        if (a.mode !== void 0) {
+          if (a["wordpress-install-mode"] !== void 0)
             throw new Error(
               "The --wordpress-install-mode option cannot be used with the --mode option. Use one or the other."
             );
-          if ("skip-sqlite-setup" in i)
+          if ("skip-sqlite-setup" in a)
             throw new Error(
               "The --skipSqliteSetup option is not supported in Blueprint V2 mode."
             );
-          if (i["auto-mount"] !== void 0)
+          if (a["auto-mount"] !== void 0)
             throw new Error(
               "The --mode option cannot be used with --auto-mount because --auto-mount automatically sets the mode."
             );
         } else
-          i["wordpress-install-mode"] === "do-not-attempt-installing" ? i.mode = "apply-to-existing-site" : i.mode = "create-new-site";
-        const g = i.allow || [];
-        i.followSymlinks === !0 && g.push("follow-symlinks"), i["blueprint-may-read-adjacent-files"] === !0 && g.push("read-local-fs"), i.allow = g;
-      } else if (i.mode !== void 0)
+          a["wordpress-install-mode"] === "do-not-attempt-installing" ? a.mode = "apply-to-existing-site" : a.mode = "create-new-site";
+        const p = a.allow || [];
+        a.followSymlinks === !0 && p.push("follow-symlinks"), a["blueprint-may-read-adjacent-files"] === !0 && p.push("read-local-fs"), a.allow = p;
+      } else if (a.mode !== void 0)
         throw new Error(
           "The --mode option requires the --experimentalBlueprintsV2Runner flag."
         );
       return !0;
     });
-    r.wrap(r.terminalWidth());
-    const s = await r.argv, a = s._[0];
-    ["run-blueprint", "server", "build-snapshot"].includes(a) || (r.showHelp(), process.exit(1));
-    const l = {
-      ...s,
-      command: a,
+    s.wrap(s.terminalWidth());
+    const i = await s.argv, l = i._[0];
+    ["start", "run-blueprint", "server", "build-snapshot"].includes(
+      l
+    ) || (s.showHelp(), process.exit(1));
+    const d = {
+      ...i,
+      command: l,
       mount: [
-        ...s.mount || [],
-        ...s["mount-dir"] || []
+        ...i.mount || [],
+        ...i["mount-dir"] || []
       ],
       "mount-before-install": [
-        ...s["mount-before-install"] || [],
-        ...s["mount-dir-before-install"] || []
+        ...i["mount-before-install"] || [],
+        ...i["mount-dir-before-install"] || []
       ]
-    }, d = await ft(l);
-    d === void 0 && process.exit(0);
-    const f = /* @__PURE__ */ (() => {
-      let i;
+    }, b = await Pt(d);
+    b === void 0 && process.exit(0);
+    const g = /* @__PURE__ */ (() => {
+      let a;
       return async () => {
-        i !== void 0 && (i = d[Symbol.asyncDispose]()), await i, process.exit(0);
+        a !== void 0 && (a = b[Symbol.asyncDispose]()), await a, process.exit(0);
       };
     })();
-    process.on("SIGINT", f), process.on("SIGTERM", f);
+    process.on("SIGINT", g), process.on("SIGTERM", g);
   } catch (t) {
-    if (!(t instanceof Error))
+    if (console.error(t), !(t instanceof Error))
       throw t;
     if (process.argv.includes("--debug"))
-      me(t);
+      ye(t);
     else {
       const n = [];
       let r = t;
@@ -902,53 +993,59 @@ Warning: Following symlinks will expose files outside mounted directories to Pla
     process.exit(1);
   }
 }
-const ct = Symbol("playground-cli-testing"), E = (e) => process.stdout.isTTY ? "\x1B[1m" + e + "\x1B[0m" : e, pt = (e) => process.stdout.isTTY ? `\x1B[2m${e}\x1B[0m` : e, N = (e) => process.stdout.isTTY ? `\x1B[3m${e}\x1B[0m` : e, te = (e) => process.stdout.isTTY ? `\x1B[33m${e}\x1B[0m` : e;
-async function ft(e) {
+function ie(e, t) {
+  return e.find(
+    (o) => o.vfsPath.replace(/\/$/, "") === t.replace(/\/$/, "")
+  );
+}
+const gt = Symbol("playground-cli-testing"), E = (e) => process.stdout.isTTY ? "\x1B[1m" + e + "\x1B[0m" : e, yt = (e) => process.stdout.isTTY ? "\x1B[31m" + e + "\x1B[0m" : e, bt = (e) => process.stdout.isTTY ? `\x1B[2m${e}\x1B[0m` : e, _ = (e) => process.stdout.isTTY ? `\x1B[3m${e}\x1B[0m` : e, ae = (e) => process.stdout.isTTY ? `\x1B[33m${e}\x1B[0m` : e;
+async function Pt(e) {
   let t, o;
   const n = /* @__PURE__ */ new Map();
-  if (e.autoMount !== void 0 && (e.autoMount === "" && (e = { ...e, autoMount: process.cwd() }), e = qe(e)), e.wordpressInstallMode === void 0 && (e.wordpressInstallMode = "download-and-install"), e.quiet && (e.verbosity = "quiet", delete e.quiet), e.debug ? e.verbosity = "debug" : e.verbosity === "debug" && (e.debug = !0), e.verbosity) {
-    const f = Object.values(j).find(
-      (i) => i.name === e.verbosity
+  if (e.command === "start" && (e = vt(e)), e.autoMount !== void 0 && (e.autoMount === "" && (e = { ...e, autoMount: process.cwd() }), e = ue(e)), e.wordpressInstallMode === void 0 && (e.wordpressInstallMode = "download-and-install"), e.quiet && (e.verbosity = "quiet", delete e.quiet), e.debug && (e.verbosity = "debug", delete e.debug), e.verbosity) {
+    const g = Object.values(Z).find(
+      (a) => a.name === e.verbosity
     ).severity;
-    u.setSeverityFilterLevel(f);
+    u.setSeverityFilterLevel(g);
   }
   e.intl || (e.intl = !0);
-  const r = e.command === "server" ? e.port ?? 9400 : 0, s = ie.platform() === "win32" ? (
+  const r = e.command === "server" ? e.port ?? 9400 : 0, s = U.platform() === "win32" ? (
     // @TODO: Enable fs-ext here when it works with Windows.
     void 0
-  ) : await import("fs-ext").then((f) => f.flockSync).catch(() => {
+  ) : await import("fs-ext").then((g) => g.flockSync).catch(() => {
     u.warn(
       "The fs-ext package is not installed. Internal file locking will not be integrated with host OS file locking."
     );
-  }), a = new Ie(s);
+  }), i = new We(s);
   let l = !1, d = !0;
-  return u.log("Starting a PHP server..."), Ge({
+  u.log("Starting a PHP server...");
+  const b = await ot({
     port: r,
-    onBind: async (f, i) => {
-      const y = "127.0.0.1", g = `http://${y}:${i}`, P = e["site-url"] || g, k = e.command === "server" ? e.experimentalMultiWorker ?? 1 : 1, I = e.command === "server" ? (
+    onBind: async (g, a) => {
+      const y = "127.0.0.1", p = `http://${y}:${a}`, I = e["site-url"] || p, v = e.command === "server" ? e.experimentalMultiWorker ?? 1 : 1, W = e.command === "server" ? (
         // Account for the initial worker which is discarded by the server after setup.
-        k + 1
-      ) : k, F = 2 ** 31 - 1, x = Math.floor(
-        F / I
-      ), W = "-playground-cli-site-", T = await it(W);
-      u.debug(`Native temp dir for VFS root: ${T.path}`);
-      const B = "WP Playground CLI - Listen for Xdebug", z = ".playground-xdebug-root", X = w.join(process.cwd(), z);
-      if (await Ne(X), e.xdebug && e.experimentalUnsafeIdeIntegration) {
-        await _e(
-          T.path,
-          X,
+        v + 1
+      ) : v, F = 2 ** 31 - 1, k = Math.floor(
+        F / W
+      ), J = "-playground-cli-site-", $ = await pt(J);
+      u.debug(`Native temp dir for VFS root: ${$.path}`);
+      const B = "WP Playground CLI - Listen for Xdebug", Q = ".playground-xdebug-root", K = h.join(process.cwd(), Q);
+      if (await Xe(K), e.xdebug && e.experimentalUnsafeIdeIntegration) {
+        await Ye(
+          $.path,
+          K,
           process.platform
         );
         const c = {
-          hostPath: w.join(".", w.sep, z),
+          hostPath: h.join(".", h.sep, Q),
           vfsPath: "/"
         };
         try {
-          await Oe(B, process.cwd());
-          const m = typeof e.xdebug == "object" ? e.xdebug : void 0, v = await je({
+          await Ze(B, process.cwd());
+          const w = typeof e.xdebug == "object" ? e.xdebug : void 0, x = await Ge({
             name: B,
             host: y,
-            port: i,
+            port: a,
             ides: e.experimentalUnsafeIdeIntegration,
             cwd: process.cwd(),
             mounts: [
@@ -956,19 +1053,19 @@ async function ft(e) {
               ...e["mount-before-install"] || [],
               ...e.mount || []
             ],
-            ideKey: m?.ideKey
-          }), h = e.experimentalUnsafeIdeIntegration, b = h.includes("vscode"), S = h.includes("phpstorm"), M = Object.values(v);
-          console.log(""), M.length > 0 ? (console.log(E("Xdebug configured successfully")), console.log(
-            te("Updated IDE config: ") + M.join(" ")
+            ideKey: w?.ideKey
+          }), m = e.experimentalUnsafeIdeIntegration, P = m.includes("vscode"), S = m.includes("phpstorm"), L = Object.values(x);
+          console.log(""), L.length > 0 ? (console.log(E("Xdebug configured successfully")), console.log(
+            ae("Updated IDE config: ") + L.join(" ")
           ), console.log(
-            te("Playground source root: ") + ".playground-xdebug-root" + N(
-              pt(
+            ae("Playground source root: ") + ".playground-xdebug-root" + _(
+              bt(
                 " – you can set breakpoints and preview Playground's VFS structure in there."
               )
             )
           )) : (console.log(E("Xdebug configuration failed.")), console.log(
             "No IDE-specific project settings directory was found in the current working directory."
-          )), console.log(""), b && v.vscode && (console.log(E("VS Code / Cursor instructions:")), console.log(
+          )), console.log(""), P && x.vscode && (console.log(E("VS Code / Cursor instructions:")), console.log(
             "  1. Ensure you have installed an IDE extension for PHP Debugging"
           ), console.log(
             `     (The ${E("PHP Debug")} extension by ${E(
@@ -977,15 +1074,15 @@ async function ft(e) {
           ), console.log(
             "  2. Open the Run and Debug panel on the left sidebar"
           ), console.log(
-            `  3. Select "${N(
+            `  3. Select "${_(
               B
             )}" from the dropdown`
           ), console.log('  3. Click "start debugging"'), console.log(
             "  5. Set a breakpoint. For example, in .playground-xdebug-root/wordpress/index.php"
           ), console.log(
             "  6. Visit Playground in your browser to hit the breakpoint"
-          ), S && console.log("")), S && v.phpstorm && (console.log(E("PhpStorm instructions:")), console.log(
-            `  1. Choose "${N(
+          ), S && console.log("")), S && x.phpstorm && (console.log(E("PhpStorm instructions:")), console.log(
+            `  1. Choose "${_(
               B
             )}" debug configuration in the toolbar`
           ), console.log("  2. Click the debug button (bug icon)`"), console.log(
@@ -993,21 +1090,21 @@ async function ft(e) {
           ), console.log(
             "  4. Visit Playground in your browser to hit the breakpoint"
           )), console.log("");
-        } catch (m) {
+        } catch (w) {
           throw new Error("Could not configure Xdebug", {
-            cause: m
+            cause: w
           });
         }
       }
-      const ue = w.dirname(T.path), ce = 2 * 24 * 60 * 60 * 1e3;
-      at(
-        W,
-        ce,
-        ue
+      const he = h.dirname($.path), me = 2 * 24 * 60 * 60 * 1e3;
+      ft(
+        J,
+        me,
+        he
       );
-      const U = w.join(T.path, "internal");
-      G(U);
-      const pe = [
+      const A = h.join($.path, "internal");
+      z(A);
+      const we = [
         "wordpress",
         // Note: These dirs are from Emscripten's "default dirs" list:
         // https://github.com/emscripten-core/emscripten/blob/f431ec220e472e1f8d3db6b52fe23fb377facf30/src/lib/libfs.js#L1400-L1402
@@ -1018,16 +1115,16 @@ async function ft(e) {
         "tmp",
         "home"
       ];
-      for (const c of pe) {
-        const m = (h) => h.vfsPath === `/${c}`;
-        if (!(e["mount-before-install"]?.some(m) || e.mount?.some(m))) {
-          const h = w.join(
-            T.path,
+      for (const c of we) {
+        const w = (m) => m.vfsPath === `/${c}`;
+        if (!(e["mount-before-install"]?.some(w) || e.mount?.some(w))) {
+          const m = h.join(
+            $.path,
             c
           );
-          G(h), e["mount-before-install"] === void 0 && (e["mount-before-install"] = []), e["mount-before-install"].unshift({
+          z(m), e["mount-before-install"] === void 0 && (e["mount-before-install"] = []), e["mount-before-install"].unshift({
             vfsPath: `/${c}`,
-            hostPath: h
+            hostPath: m
           });
         }
       }
@@ -1041,164 +1138,220 @@ async function ft(e) {
           u.debug(
             `Mount after WP install: ${c.vfsPath} -> ${c.hostPath}`
           );
-      let $;
-      e["experimental-blueprints-v2-runner"] ? $ = new ot(e, {
-        siteUrl: P,
-        processIdSpaceLength: x
-      }) : ($ = new nt(e, {
-        siteUrl: P,
-        processIdSpaceLength: x
-      }), typeof e.blueprint == "string" && (e.blueprint = await tt({
+      let T;
+      e["experimental-blueprints-v2-runner"] ? T = new lt(e, {
+        siteUrl: I,
+        processIdSpaceLength: k
+      }) : (T = new ct(e, {
+        siteUrl: I,
+        processIdSpaceLength: k
+      }), typeof e.blueprint == "string" && (e.blueprint = await at({
         sourceString: e.blueprint,
         blueprintMayReadAdjacentFiles: e["blueprint-may-read-adjacent-files"] === !0
       })));
-      let A = !1;
-      const L = async function() {
-        A || (A = !0, await Promise.all(
+      let H = !1;
+      const M = async function() {
+        H || (H = !0, await Promise.all(
           [...n].map(
-            async ([m, v]) => {
-              await v.dispose(), await m.terminate();
+            async ([w, x]) => {
+              await x.dispose(), await w.terminate();
             }
           )
-        ), f && await new Promise((m) => f.close(m)), await T.cleanup());
-      }, fe = ht(
-        I,
-        $.getWorkerType(),
-        ({ exitCode: c, workerIndex: m }) => {
-          A || c === 0 && u.error(
-            `Worker ${m} exited with code ${c}
+        ), g && await new Promise((w) => g.close(w)), await $.cleanup());
+      }, ge = kt(
+        W,
+        T.getWorkerType(),
+        ({ exitCode: c, workerIndex: w }) => {
+          H || c === 0 && u.error(
+            `Worker ${w} exited with code ${c}
 `
           );
         }
       );
       u.log("Starting up workers");
       try {
-        const c = await fe, m = await oe(a);
+        const c = await ge, w = await le(i);
         {
-          const h = c.shift(), b = await $.bootAndSetUpInitialPlayground(
-            h.phpPort,
-            m,
-            U
+          const m = c.shift(), P = await T.bootAndSetUpInitialPlayground(
+            m.phpPort,
+            w,
+            A
           );
           if (n.set(
-            h.worker,
-            b
-          ), await b.isReady(), l = !0, u.log("Booted!"), t = new Ke(b), !e["experimental-blueprints-v2-runner"]) {
-            const S = await $.compileInputBlueprint(
+            m.worker,
+            P
+          ), await P.isReady(), l = !0, u.log("Booted!"), t = new nt(P), !e["experimental-blueprints-v2-runner"]) {
+            const S = await T.compileInputBlueprint(
               e["additional-blueprint-steps"] || []
             );
-            S && (u.log("Running the Blueprint..."), await ve(
+            S && (u.log("Running the Blueprint..."), await Se(
               S,
-              b
+              P
             ), u.log("Finished running the blueprint"));
           }
           if (e.command === "build-snapshot") {
-            await wt(o, e.outfile), u.log(`WordPress exported to ${e.outfile}`), await L();
+            await It(o, e.outfile), u.log(`WordPress exported to ${e.outfile}`), await M();
             return;
           } else if (e.command === "run-blueprint") {
-            u.log("Blueprint executed"), await L();
+            u.log("Blueprint executed"), await M();
             return;
           }
-          await t.removeWorker(b), await b.dispose(), await h.worker.terminate(), n.delete(h.worker);
+          await t.removeWorker(P), await P.dispose(), await m.worker.terminate(), n.delete(m.worker);
         }
         u.log("Preparing workers...");
-        const v = x;
+        const x = k;
         return [o] = await Promise.all(
-          c.map(async (h, b) => {
-            const S = v + b * x, M = await oe(a), H = await $.bootPlayground({
-              worker: h,
-              fileLockManagerPort: M,
+          c.map(async (m, P) => {
+            const S = x + P * k, L = await le(i), V = await T.bootPlayground({
+              worker: m,
+              fileLockManagerPort: L,
               firstProcessId: S,
-              nativeInternalDirPath: U
+              nativeInternalDirPath: A
             });
             return n.set(
-              h.worker,
-              H
-            ), t.addWorker(H), H;
+              m.worker,
+              V
+            ), t.addWorker(V), V;
           })
         ), u.log(
-          `WordPress is running on ${g} with ${k} worker(s)`
-        ), e.xdebug && e.experimentalDevtools && (await Ue({
+          `WordPress is running on ${p} with ${v} worker(s)`
+        ), e.xdebug && e.experimentalDevtools && (await Oe({
           phpInstance: o,
           phpRoot: "/wordpress"
         })).start(), {
           playground: o,
-          server: f,
-          serverUrl: g,
-          [Symbol.asyncDispose]: L,
-          [ct]: {
-            workerThreadCount: k,
-            getWorkerNumberFromProcessId: (h) => Math.floor(h / x)
+          server: g,
+          serverUrl: p,
+          [Symbol.asyncDispose]: M,
+          [gt]: {
+            workerThreadCount: v,
+            getWorkerNumberFromProcessId: (m) => Math.floor(m / k)
           }
         };
       } catch (c) {
-        if (!e.debug)
+        if (e.verbosity !== "debug")
           throw c;
-        let m = "";
-        throw await o?.fileExists(Z) && (m = await o.readFileAsText(Z)), await L(), new Error(m, { cause: c });
+        let w = "";
+        throw await o?.fileExists(ee) && (w = await o.readFileAsText(ee)), await M(), new Error(w, { cause: c });
       }
     },
-    async handleRequest(f) {
+    async handleRequest(g) {
       if (!l)
-        return _.forHttpCode(
+        return j.forHttpCode(
           502,
           "WordPress is not ready yet"
         );
       if (d) {
         d = !1;
-        const i = {
+        const a = {
           "Content-Type": ["text/plain"],
           "Content-Length": ["0"],
-          Location: [f.url]
+          Location: [g.url]
         };
-        return f.headers?.cookie?.includes(
+        return g.headers?.cookie?.includes(
           "playground_auto_login_already_happened"
-        ) && (i["Set-Cookie"] = [
+        ) && (a["Set-Cookie"] = [
           "playground_auto_login_already_happened=1; Max-Age=0; Expires=Thu, 01 Jan 1970 00:00:00 GMT; Path=/"
-        ]), new _(302, i, new Uint8Array());
+        ]), new j(302, a, new Uint8Array());
       }
-      return await t.handleRequest(f);
+      return await t.handleRequest(g);
     }
   });
+  return b && e.command === "start" && !e.skipBrowser && St(b.serverUrl), b;
 }
-async function ht(e, t, o) {
+function vt(e) {
+  let t = { ...e, command: "server" };
+  e.noAutoMount || (t.autoMount = h.resolve(process.cwd(), t.path ?? ""), t = ue(t), delete t.autoMount);
+  const o = ie(
+    t["mount-before-install"] || [],
+    "/wordpress"
+  ) || ie(t.mount || [], "/wordpress");
+  if (o)
+    console.log("Site files stored at:", o?.hostPath), e.reset && (console.log(""), console.log(
+      yt(
+        "This site is not managed by Playground CLI and cannot be reset."
+      )
+    ), console.log(
+      "(It's not stored in the ~/.wordpress-playground/sites/<site-id> directory.)"
+    ), console.log(""), console.log(
+      "You may still remove the site's directory manually if you wish."
+    ), process.exit(1));
+  else {
+    const n = t.autoMount || process.cwd(), r = Je("sha256").update(n).digest("hex"), s = U.homedir(), i = h.join(
+      s,
+      ".wordpress-playground/sites",
+      r
+    );
+    console.log("Site files stored at:", i), Y(i) && e.reset && (console.log("Resetting site..."), $e(i, { recursive: !0 })), z(i, { recursive: !0 }), t["mount-before-install"] = [
+      ...t["mount-before-install"] || [],
+      { vfsPath: "/wordpress", hostPath: i }
+    ], t.wordpressInstallMode = Te(i).length === 0 ? (
+      // Only download WordPress on the first run when the site directory is still
+      // empty.
+      "download-and-install"
+    ) : (
+      // After that, reuse the WordPress installation from the initial run.
+      "install-from-existing-files-if-needed"
+    );
+  }
+  return t;
+}
+async function kt(e, t, o) {
   const n = [];
   for (let r = 0; r < e; r++) {
-    const a = mt(t, { onExit: (l) => {
+    const i = xt(t, { onExit: (l) => {
       o({
         exitCode: l,
         workerIndex: r
       });
     } });
-    n.push(a);
+    n.push(i);
   }
   return Promise.all(n);
 }
-function mt(e, { onExit: t } = {}) {
+function xt(e, { onExit: t } = {}) {
   let o;
-  return e === "v1" ? o = new Q(new URL("./worker-thread-v1.js", import.meta.url)) : o = new Q(new URL("./worker-thread-v2.js", import.meta.url)), new Promise((n, r) => {
-    o.once("message", function(a) {
-      a.command === "worker-script-initialized" && n({ worker: o, phpPort: a.phpPort });
-    }), o.once("error", function(a) {
-      console.error(a);
+  return e === "v1" ? o = new re(new URL("./worker-thread-v1.js", import.meta.url)) : o = new re(new URL("./worker-thread-v2.js", import.meta.url)), new Promise((n, r) => {
+    o.once("message", function(i) {
+      i.command === "worker-script-initialized" && n({ worker: o, phpPort: i.phpPort });
+    }), o.once("error", function(i) {
+      console.error(i);
       const l = new Error(
-        `Worker failed to load worker. ${a.message ? `Original error: ${a.message}` : ""}`
+        `Worker failed to load worker. ${i.message ? `Original error: ${i.message}` : ""}`
       );
       r(l);
     });
     let s = !1;
     o.once("spawn", () => {
       s = !0;
-    }), o.once("exit", (a) => {
-      s || r(new Error(`Worker exited before spawning: ${a}`)), t?.(a);
+    }), o.once("exit", (i) => {
+      s || r(new Error(`Worker exited before spawning: ${i}`)), t?.(i);
     });
   });
 }
-async function oe(e) {
-  const { port1: t, port2: o } = new xe();
-  return await Ee() ? we(e, null, t) : await ge(e, t), o;
+async function le(e) {
+  const { port1: t, port2: o } = new Ee();
+  return await Le() ? be(e, null, t) : await Pe(e, t), o;
 }
-async function wt(e, t) {
+function St(e) {
+  const t = U.platform();
+  let o;
+  switch (t) {
+    case "darwin":
+      o = `open "${e}"`;
+      break;
+    case "win32":
+      o = `start "" "${e}"`;
+      break;
+    default:
+      o = `xdg-open "${e}"`;
+      break;
+  }
+  _e(o, (n) => {
+    n && u.debug(`Could not open browser: ${n.message}`);
+  });
+}
+async function It(e, t) {
   await e.run({
     code: `<?php
 		$zip = new ZipArchive();
@@ -1220,15 +1373,15 @@ async function wt(e, t) {
 	`
   });
   const o = await e.readFileAsBuffer("/tmp/build.zip");
-  p.writeFileSync(t, o);
+  f.writeFileSync(t, o);
 }
 export {
-  j as L,
-  ae as a,
-  ct as i,
-  At as m,
-  Ht as p,
-  ft as r,
-  mt as s
+  Z as L,
+  ce as a,
+  gt as i,
+  Zt as m,
+  Gt as p,
+  Pt as r,
+  xt as s
 };
-//# sourceMappingURL=run-cli-pLJHMn5d.js.map
+//# sourceMappingURL=run-cli-vem_UKTF.js.map