visual-remote 0.1.2 → 0.2.0

package/apps/cli/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { realpathSync } from "node:fs";
 import { resolve as resolve8 } from "node:path";
 import { pathToFileURL } from "node:url";
 import { Command, InvalidArgumentError } from "commander";
@@ -1438,8 +1439,8 @@ var CodexAdapter = class {
 };
 
 // ../../packages/bridge-core/src/config/loader.ts
-import { readFile, realpath } from "node:fs/promises";
-import { basename, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { readFile, realpath, stat as stat2 } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { parse as parseYaml } from "yaml";
 import { ZodError } from "zod";
 
@@ -1626,11 +1627,42 @@ function isWithinRoot(root, candidate) {
   const pathFromRoot = relative(root, candidate);
   return pathFromRoot === "" || !pathFromRoot.startsWith(`..${sep}`) && pathFromRoot !== "..";
 }
+async function configExists(root) {
+  try {
+    await stat2(join(root, CONFIG_PATH));
+    return true;
+  } catch (error) {
+    if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+async function discoverVisualDevConfigRoot(startDirectory, repositoryRoot) {
+  const repoRoot = await realpath(repositoryRoot);
+  let cursor = await realpath(startDirectory);
+  if (!isWithinRoot(repoRoot, cursor)) {
+    throw new VisualDevConfigError(`Project directory is outside Git worktree: ${cursor}`);
+  }
+  while (true) {
+    if (await configExists(cursor)) return cursor;
+    if (cursor === repoRoot) return repoRoot;
+    const parent = dirname(cursor);
+    if (parent === cursor || !isWithinRoot(repoRoot, parent)) return repoRoot;
+    cursor = parent;
+  }
+}
 async function loadVisualDevConfig(repositoryRoot, options = {}) {
   const repoRoot = await realpath(repositoryRoot);
-  const configPath = join(repoRoot, CONFIG_PATH);
-  const localConfigPath = join(repoRoot, LOCAL_CONFIG_PATH);
-  const projectId = basename(repoRoot);
+  const configRoot = await realpath(options.configRoot ?? repoRoot);
+  if (!isWithinRoot(repoRoot, configRoot)) {
+    throw new VisualDevConfigError(
+      `Config directory is outside Git worktree: ${configRoot}`
+    );
+  }
+  const configPath = join(configRoot, CONFIG_PATH);
+  const localConfigPath = join(configRoot, LOCAL_CONFIG_PATH);
+  const projectId = basename(configRoot);
   const baseDocument = await readYamlMapping(configPath, options.requireConfig ?? false);
   const localDocument = await readYamlMapping(localConfigPath, false);
   const loadedFiles = [];
@@ -1657,7 +1689,7 @@ async function loadVisualDevConfig(repositoryRoot, options = {}) {
       filePath: localDocument === void 0 ? configPath : localConfigPath
     });
   }
-  const unresolvedWorkspace = isAbsolute(config.project.workspace) ? config.project.workspace : resolve(repoRoot, config.project.workspace);
+  const unresolvedWorkspace = isAbsolute(config.project.workspace) ? config.project.workspace : resolve(configRoot, config.project.workspace);
   let workspaceRoot;
   try {
     workspaceRoot = await realpath(unresolvedWorkspace);
@@ -1676,6 +1708,7 @@ async function loadVisualDevConfig(repositoryRoot, options = {}) {
   return {
     config,
     repoRoot,
+    configRoot,
     workspaceRoot,
     configPath,
     localConfigPath,
@@ -1963,7 +1996,7 @@ import {
   rm
 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { dirname, relative as relative3, resolve as resolve4, sep as sep3 } from "node:path";
+import { dirname as dirname2, relative as relative3, resolve as resolve4, sep as sep3 } from "node:path";
 var SNAPSHOT_ENV = {
   GIT_AUTHOR_NAME: "Visual Bridge",
   GIT_AUTHOR_EMAIL: "visual-bridge@localhost",
@@ -2316,7 +2349,7 @@ var GitTransactionManager = class _GitTransactionManager {
     } catch (error) {
       if (error.code !== "ENOENT") throw error;
     }
-    await this.#removeEmptyParents(dirname(absolute));
+    await this.#removeEmptyParents(dirname2(absolute));
   }
   async #removeEmptyParents(start) {
     let cursor = start;
@@ -2326,13 +2359,13 @@ var GitTransactionManager = class _GitTransactionManager {
       } catch (error) {
         const code = error.code;
         if (code === "ENOENT") {
-          cursor = dirname(cursor);
+          cursor = dirname2(cursor);
           continue;
         }
         if (code === "ENOTEMPTY" || code === "EEXIST") return;
         throw error;
       }
-      cursor = dirname(cursor);
+      cursor = dirname2(cursor);
     }
   }
   async #assertSnapshotRef(ref) {
@@ -2352,7 +2385,7 @@ var GitTransactionManager = class _GitTransactionManager {
 // ../../packages/bridge-core/src/storage/sqlite-task-store.ts
 import { mkdirSync } from "node:fs";
 import { createRequire } from "node:module";
-import { dirname as dirname2 } from "node:path";
+import { dirname as dirname3 } from "node:path";
 var requireNodeBuiltin = createRequire(import.meta.url);
 var optional = (value) => value ?? void 0;
 function parseJson(value, fallback) {
@@ -2444,7 +2477,7 @@ function taskParams(task) {
 var SqliteTaskStore = class {
   #db;
   constructor(filename) {
-    if (filename !== ":memory:") mkdirSync(dirname2(filename), { recursive: true, mode: 448 });
+    if (filename !== ":memory:") mkdirSync(dirname3(filename), { recursive: true, mode: 448 });
     const { DatabaseSync } = requireNodeBuiltin("node:sqlite");
     this.#db = new DatabaseSync(filename);
     this.#db.exec(`
@@ -4588,7 +4621,9 @@ ${output2}` : ""}`
 
 // ../../packages/bridge-core/src/bridge/default-control-service.ts
 async function createDefaultControlService(context, environment = process.env) {
-  const loaded = await loadVisualDevConfig(context.repoRoot);
+  const loaded = await loadVisualDevConfig(context.repoRoot, {
+    ...context.configRoot === void 0 ? {} : { configRoot: context.configRoot }
+  });
   if (loaded.config.agent.adapter !== "codex") {
     throw new Error(
       `Agent adapter ${loaded.config.agent.adapter} is not implemented in this MVP build`
@@ -4881,6 +4916,7 @@ async function startBridgeCore(options, dependencies) {
       mode: options.mode,
       projectId: loadedConfig.config.project.id,
       repoRoot: loadedConfig.repoRoot,
+      configRoot: loadedConfig.configRoot,
       workspaceRoot: loadedConfig.workspaceRoot,
       upstreamUrl: options.upstreamUrl
     };
@@ -4950,8 +4986,10 @@ async function startBridgeCore(options, dependencies) {
   }
 }
 async function startAttachBridge(options, dependencies = {}) {
-  const repoRoot = await discoverGitWorktreeRoot(dependencies.cwd ?? process.cwd());
-  const loadedConfig = await loadVisualDevConfig(repoRoot);
+  const cwd = dependencies.cwd ?? process.cwd();
+  const repoRoot = await discoverGitWorktreeRoot(cwd);
+  const configRoot = await discoverVisualDevConfigRoot(cwd, repoRoot);
+  const loadedConfig = await loadVisualDevConfig(repoRoot, { configRoot });
   return await startBridgeCore(
     {
       mode: "attach",
@@ -4965,8 +5003,13 @@ async function startAttachBridge(options, dependencies = {}) {
   );
 }
 async function startManagedBridge(options = {}, dependencies = {}) {
-  const repoRoot = await discoverGitWorktreeRoot(dependencies.cwd ?? process.cwd());
-  const loadedConfig = await loadVisualDevConfig(repoRoot, { requireConfig: true });
+  const cwd = dependencies.cwd ?? process.cwd();
+  const repoRoot = await discoverGitWorktreeRoot(cwd);
+  const configRoot = await discoverVisualDevConfigRoot(cwd, repoRoot);
+  const loadedConfig = await loadVisualDevConfig(repoRoot, {
+    requireConfig: true,
+    configRoot
+  });
   const command = loadedConfig.config.upstream.command;
   if (command === void 0) {
     throw new Error("visual dev requires upstream.command in .visualdev/config.yaml");
@@ -5075,14 +5118,14 @@ function formatBridgeSummary(bridge) {
 
 // src/doctor.ts
 import { constants } from "node:fs";
-import { access as access2, stat as stat2 } from "node:fs/promises";
-import { delimiter, isAbsolute as isAbsolute5, join as join4, resolve as resolve7 } from "node:path";
+import { access as access2, stat as stat3 } from "node:fs/promises";
+import { delimiter, isAbsolute as isAbsolute5, join as join4, relative as relative6, resolve as resolve7 } from "node:path";
 import { execFile as execFile2 } from "node:child_process";
 import { promisify as promisify2 } from "node:util";
 var execFileAsync2 = promisify2(execFile2);
 async function fileExists(path) {
   try {
-    await stat2(path);
+    await stat3(path);
     return true;
   } catch (error) {
     if (typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") {
@@ -5130,14 +5173,19 @@ async function runDoctor(dependencies = {}) {
     return checks;
   }
   try {
-    const loaded = await loadVisualDevConfig(repoRoot);
+    const configRoot = await discoverVisualDevConfigRoot(
+      dependencies.cwd ?? process.cwd(),
+      repoRoot
+    );
+    const loaded = await loadVisualDevConfig(repoRoot, { configRoot });
     checks.push({
       name: "config",
       status: loaded.loadedFiles.length === 0 ? "warning" : "pass",
       message: loaded.loadedFiles.length === 0 ? "No .visualdev/config.yaml; attach defaults are available." : loaded.loadedFiles.join(", ")
     });
     if (await fileExists(loaded.localConfigPath)) {
-      const ignored = await isIgnored(repoRoot, ".visualdev/config.local.yaml");
+      const localConfigRelativePath = relative6(repoRoot, loaded.localConfigPath);
+      const ignored = await isIgnored(repoRoot, localConfigRelativePath);
       checks.push({
         name: "local-config-ignore",
         status: ignored ? "pass" : "warning",
@@ -5175,15 +5223,23 @@ function formatDoctorChecks(checks) {
 }
 
 // src/init.ts
-import { readFile as readFile5, mkdir as mkdir3, stat as stat3, writeFile as writeFile3 } from "node:fs/promises";
-import { basename as basename2, dirname as dirname3, join as join5 } from "node:path";
+import { spawn as spawn6 } from "node:child_process";
+import { readFile as readFile5, mkdir as mkdir3, realpath as realpath10, stat as stat4, writeFile as writeFile3 } from "node:fs/promises";
+import { basename as basename2, dirname as dirname4, join as join5, relative as relative7 } from "node:path";
 import { stringify as stringifyYaml } from "yaml";
+var VITE_CONFIG_FILES = [
+  "vite.config.ts",
+  "vite.config.mts",
+  "vite.config.js",
+  "vite.config.mjs"
+];
+var VITE_IMPORT = 'import { visualRemote } from "visual-remote/vite";';
 function isMissingFile(error) {
   return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
 }
 async function fileExists2(path) {
   try {
-    await stat3(path);
+    await stat4(path);
     return true;
   } catch (error) {
     if (isMissingFile(error)) return false;
@@ -5195,7 +5251,7 @@ function packageManagerFromField(value) {
   const name = value.split("@", 1)[0];
   return name === "bun" || name === "npm" || name === "pnpm" || name === "yarn" ? name : void 0;
 }
-async function detectPackageManager(repoRoot, manifest) {
+async function detectPackageManager(projectRoot, repoRoot, manifest) {
   const declared = packageManagerFromField(manifest.packageManager);
   if (declared !== void 0) return declared;
   const lockfiles = [
@@ -5205,8 +5261,10 @@ async function detectPackageManager(repoRoot, manifest) {
     ["bun", "bun.lockb"],
     ["npm", "package-lock.json"]
   ];
-  for (const [manager, filename] of lockfiles) {
-    if (await fileExists2(join5(repoRoot, filename))) return manager;
+  for (const root of projectRoot === repoRoot ? [projectRoot] : [projectRoot, repoRoot]) {
+    for (const [manager, filename] of lockfiles) {
+      if (await fileExists2(join5(root, filename))) return manager;
+    }
   }
   return "npm";
 }
@@ -5216,6 +5274,19 @@ function readDevScript(manifest) {
   }
   return manifest.scripts.dev.trim();
 }
+function packageRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function isViteProject(manifest, devScript) {
+  const packages = {
+    ...packageRecord(manifest.dependencies),
+    ...packageRecord(manifest.devDependencies)
+  };
+  return "vite" in packages || /(^|[\s;&|])vite(?:\s|$)/.test(devScript);
+}
+function hasVisualRemote(manifest) {
+  return "visual-remote" in packageRecord(manifest.dependencies) || "visual-remote" in packageRecord(manifest.devDependencies);
+}
 function devCommand(manager, script) {
   const command = manager === "pnpm" ? ["corepack", "pnpm", "run", "dev"] : manager === "yarn" ? ["corepack", "yarn", "run", "dev"] : manager === "bun" ? ["bun", "run", "dev"] : ["npm", "run", "dev"];
   const next = /(^|[\s;&|])next(?:\s|$)/.test(script);
@@ -5228,14 +5299,14 @@ function devCommand(manager, script) {
     "{upstreamPort}"
   ];
 }
-async function readManifest(repoRoot) {
-  const manifestPath = join5(repoRoot, "package.json");
+async function readManifest(projectRoot) {
+  const manifestPath = join5(projectRoot, "package.json");
   let source;
   try {
     source = await readFile5(manifestPath, "utf8");
   } catch (error) {
     if (isMissingFile(error)) {
-      throw new Error("visual init requires package.json at the Git worktree root");
+      throw new Error("visual init requires package.json in the current directory");
     }
     throw error;
   }
@@ -5250,55 +5321,163 @@ async function readManifest(repoRoot) {
   }
   return value;
 }
-async function initializeVisualDev(dependencies = {}) {
-  const repoRoot = await discoverGitWorktreeRoot(dependencies.cwd ?? process.cwd());
-  const configPath = join5(repoRoot, CONFIG_PATH);
-  if (await fileExists2(configPath)) {
-    return { created: false, configPath };
+async function findViteConfig(projectRoot) {
+  for (const filename of VITE_CONFIG_FILES) {
+    const candidate = join5(projectRoot, filename);
+    if (await fileExists2(candidate)) return candidate;
   }
-  const manifest = await readManifest(repoRoot);
-  const devScript = readDevScript(manifest);
-  const packageManager = await detectPackageManager(repoRoot, manifest);
-  const document = {
-    version: 1,
-    project: {
-      id: basename2(repoRoot),
-      workspace: "."
-    },
-    gateway: {
-      host: "0.0.0.0",
-      port: "auto"
-    },
-    upstream: {
-      port: "auto",
-      command: devCommand(packageManager, devScript)
-    }
+  throw new Error(
+    "visual init found Vite but could not find vite.config.ts, .mts, .js, or .mjs"
+  );
+}
+function insertViteImport(source) {
+  const lines = source.split("\n");
+  let index = 0;
+  while (lines[index]?.startsWith("///")) index += 1;
+  lines.splice(index, 0, VITE_IMPORT);
+  return lines.join("\n");
+}
+function transformViteConfig(source) {
+  if (source.includes("visual-remote/vite") && /\bvisualRemote\s*\(/.test(source)) {
+    return source;
+  }
+  let transformed = source.includes("visual-remote/vite") ? source : insertViteImport(source);
+  const pluginsPattern = /(\bplugins\s*:\s*\[)/;
+  if (pluginsPattern.test(transformed)) {
+    return transformed.replace(
+      pluginsPattern,
+      (match, _prefix, offset, fullSource) => `${match}visualRemote(),${fullSource[offset + match.length] === "\n" ? "" : " "}`
+    );
+  }
+  const objectConfigPattern = /(defineConfig\s*\(\s*\{)/;
+  if (objectConfigPattern.test(transformed)) {
+    return transformed.replace(
+      objectConfigPattern,
+      "$1\n  plugins: [visualRemote()],"
+    );
+  }
+  throw new Error(
+    "visual init could not add visualRemote() to the Vite plugins array"
+  );
+}
+async function configureVite(configPath) {
+  const source = await readFile5(configPath, "utf8");
+  const transformed = transformViteConfig(source);
+  if (transformed === source) return false;
+  await writeFile3(configPath, transformed, "utf8");
+  return true;
+}
+function installCommand(request) {
+  if (request.packageManager === "pnpm") {
+    return {
+      command: "corepack",
+      args: ["pnpm", "add", "--save-dev", request.packageSpec]
+    };
+  }
+  if (request.packageManager === "yarn") {
+    return {
+      command: "corepack",
+      args: ["yarn", "add", "--dev", request.packageSpec]
+    };
+  }
+  if (request.packageManager === "bun") {
+    return { command: "bun", args: ["add", "--dev", request.packageSpec] };
+  }
+  return {
+    command: "npm",
+    args: ["install", "--save-dev", request.packageSpec]
   };
-  await mkdir3(dirname3(configPath), { recursive: true });
-  try {
-    await writeFile3(configPath, stringifyYaml(document), {
-      encoding: "utf8",
-      flag: "wx"
+}
+async function installPackage(request) {
+  const { command, args } = installCommand(request);
+  await new Promise((resolvePromise, reject) => {
+    const child = spawn6(command, args, {
+      cwd: request.cwd,
+      env: process.env,
+      stdio: "inherit",
+      windowsHide: true
     });
-  } catch (error) {
-    if (typeof error === "object" && error !== null && "code" in error && error.code === "EEXIST") {
-      return { created: false, configPath };
+    child.once("error", reject);
+    child.once("exit", (code, signal) => {
+      if (code === 0) {
+        resolvePromise();
+        return;
+      }
+      reject(
+        new Error(
+          `${command} ${args.join(" ")} failed${signal === null ? ` with exit code ${code ?? "unknown"}` : ` with ${signal}`}`
+        )
+      );
+    });
+  });
+}
+async function initializeVisualDev(dependencies = {}) {
+  const projectRoot = await realpath10(dependencies.cwd ?? process.cwd());
+  const repoRoot = await discoverGitWorktreeRoot(projectRoot);
+  const manifest = await readManifest(projectRoot);
+  const devScript = readDevScript(manifest);
+  if (!isViteProject(manifest, devScript)) {
+    throw new Error("visual init currently supports Vite projects");
+  }
+  const packageManager = await detectPackageManager(projectRoot, repoRoot, manifest);
+  const integrationPath = await findViteConfig(projectRoot);
+  const packageInstalled = !hasVisualRemote(manifest);
+  if (packageInstalled) {
+    await (dependencies.installPackage ?? installPackage)({
+      cwd: projectRoot,
+      packageManager,
+      packageSpec: "visual-remote@latest"
+    });
+  }
+  const integrationChanged = await configureVite(integrationPath);
+  const configPath = join5(projectRoot, CONFIG_PATH);
+  const created = !await fileExists2(configPath);
+  if (created) {
+    const document = {
+      version: 1,
+      project: {
+        id: basename2(projectRoot),
+        workspace: "."
+      },
+      gateway: {
+        host: "0.0.0.0",
+        port: "auto"
+      },
+      upstream: {
+        port: "auto",
+        command: devCommand(packageManager, devScript)
+      }
+    };
+    await mkdir3(dirname4(configPath), { recursive: true });
+    try {
+      await writeFile3(configPath, stringifyYaml(document), {
+        encoding: "utf8",
+        flag: "wx"
+      });
+    } catch (error) {
+      if (!isMissingFile(error) && (typeof error !== "object" || error === null || !("code" in error) || error.code !== "EEXIST")) {
+        throw error;
+      }
     }
-    throw error;
   }
-  return { created: true, configPath, devScript, packageManager };
+  return {
+    created,
+    configPath,
+    devScript,
+    packageManager,
+    integrationPath,
+    integrationChanged,
+    packageInstalled
+  };
 }
 function formatInitResult(result) {
-  if (!result.created) {
-    return [
-      `Already initialized: ${CONFIG_PATH}`,
-      "Next: npx --yes visual-remote@latest dev"
-    ].join("\n");
-  }
+  const configLabel = result.created ? "Created" : "Existing";
+  const integrationLabel = result.integrationChanged ? "Configured" : "Existing";
   return [
-    `Created:  ${CONFIG_PATH}`,
-    `Detected: ${result.packageManager} dev (${result.devScript})`,
-    "Next:     npx --yes visual-remote@latest dev"
+    `${configLabel}:   ${relative7(process.cwd(), result.configPath) || CONFIG_PATH}`,
+    `${integrationLabel}: ${relative7(process.cwd(), result.integrationPath)}`,
+    result.packageInstalled ? "Installed: visual-remote@latest" : "Installed: visual-remote",
+    "Next:      Start the app normally and open its original URL."
   ].join("\n");
 }
 
@@ -5352,7 +5531,7 @@ function setExitCode(dependencies, code) {
   }
 }
 function createCli(dependencies = {}) {
-  const program = new Command().name("visual").description("Visual Remote Dev Bridge").version("0.1.2");
+  const program = new Command().name("visual").description("Visual Remote Dev Bridge").version("0.2.0");
   program.command("init").description("Create .visualdev/config.yaml for the current project").action(async () => {
     const result = await initializeVisualDev(dependencies);
     output(dependencies, formatInitResult(result));
@@ -5402,8 +5581,15 @@ function createCli(dependencies = {}) {
 async function main(argv = process.argv, dependencies = {}) {
   await createCli(dependencies).parseAsync(argv);
 }
+function isDirectEntry(entryPath2) {
+  try {
+    return pathToFileURL(realpathSync(resolve8(entryPath2))).href === import.meta.url;
+  } catch {
+    return false;
+  }
+}
 var entryPath = process.argv[1];
-if (entryPath !== void 0 && pathToFileURL(resolve8(entryPath)).href === import.meta.url) {
+if (entryPath !== void 0 && isDirectEntry(entryPath)) {
   void main().catch((error) => {
     process.stderr.write(
       `${error instanceof Error ? error.message : "Unknown Visual Bridge error"}
@@ -5424,5 +5610,6 @@ export {
   runBridgeUntilSignal,
   runDoctor,
   startAttachBridge,
-  startManagedBridge
+  startManagedBridge,
+  transformViteConfig
 };