@higgsfield/video-editor-mcp 1.1.0 → 2.0.0

package/dist/cli.mjs

@@ -9,8 +9,8 @@ var __export = (target, all) => {
 
 // src/video-editor-local/setup.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync4, mkdirSync as mkdirSync4, rmSync as rmSync3 } from "node:fs";
-import { dirname as dirname4, join as join5, sep } from "node:path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync5, rmSync as rmSync4 } from "node:fs";
+import { dirname as dirname4, join as join6 } from "node:path";
 import { pathToFileURL } from "node:url";
 
 // src/video-editor-local/higgsedit.ts
@@ -32,19 +32,10 @@ function findCli(env = process.env, from = import.meta.url) {
   return path && existsSync(path) ? path : void 0;
 }
 
-// src/video-editor-local/updates.ts
-import { execFileSync as execFileSync2 } from "node:child_process";
-import {
-  existsSync as existsSync3,
-  mkdirSync as mkdirSync3,
-  readFileSync as readFileSync3,
-  renameSync as renameSync2,
-  rmSync as rmSync2,
-  statSync as statSync2,
-  writeFileSync as writeFileSync2
-} from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { dirname as dirname3, join as join4 } from "node:path";
+// src/video-editor-local/install.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync4, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join5, sep } from "node:path";
 
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -1237,13 +1228,13 @@ function unwrapMessage(message) {
 }
 function finalizeIssue(iss, ctx, config2) {
   const message = iss.message ? iss.message : unwrapMessage(iss.inst?._zod.def?.error?.(iss)) ?? unwrapMessage(ctx?.error?.(iss)) ?? unwrapMessage(config2.customError?.(iss)) ?? unwrapMessage(config2.localeError?.(iss)) ?? "Invalid input";
-  const { inst: _inst, continue: _continue, input: _input, ...rest } = iss;
-  rest.path ?? (rest.path = []);
-  rest.message = message;
+  const { inst: _inst, continue: _continue, input: _input, ...rest2 } = iss;
+  rest2.path ?? (rest2.path = []);
+  rest2.message = message;
   if (ctx?.reportInput) {
-    rest.input = _input;
+    rest2.input = _input;
   }
-  return rest;
+  return rest2;
 }
 function getSizableOrigin(input) {
   if (input instanceof Set)
@@ -2630,11 +2621,11 @@ var $ZodCIDRv6 = /* @__PURE__ */ $constructor("$ZodCIDRv6", (inst, def) => {
     try {
       if (parts.length !== 2)
         throw new Error();
-      const [address, prefix] = parts;
-      if (!prefix)
+      const [address, prefix2] = parts;
+      if (!prefix2)
         throw new Error();
-      const prefixNum = Number(prefix);
-      if (`${prefixNum}` !== prefix)
+      const prefixNum = Number(prefix2);
+      if (`${prefixNum}` !== prefix2)
         throw new Error();
       if (prefixNum < 0 || prefixNum > 128)
         throw new Error();
@@ -3583,8 +3574,8 @@ var $ZodTuple = /* @__PURE__ */ $constructor("$ZodTuple", (inst, def) => {
     }
     if (def.rest) {
       let i = items.length - 1;
-      const rest = input.slice(items.length);
-      for (const el of rest) {
+      const rest2 = input.slice(items.length);
+      for (const el of rest2) {
         i++;
         const result = def.rest._zod.run({ value: el, issues: [] }, ctx);
         if (result instanceof Promise) {
@@ -11042,12 +11033,12 @@ function _includes(includes, params) {
   });
 }
 // @__NO_SIDE_EFFECTS__
-function _startsWith(prefix, params) {
+function _startsWith(prefix2, params) {
   return new $ZodCheckStartsWith({
     check: "string_format",
     format: "starts_with",
     ...normalizeParams(params),
-    prefix
+    prefix: prefix2
   });
 }
 // @__NO_SIDE_EFFECTS__
@@ -11151,11 +11142,11 @@ function _intersection(Class2, left, right) {
 function _tuple(Class2, items, _paramsOrRest, _params) {
   const hasRest = _paramsOrRest instanceof $ZodType;
   const params = hasRest ? _params : _paramsOrRest;
-  const rest = hasRest ? _paramsOrRest : null;
+  const rest2 = hasRest ? _paramsOrRest : null;
   return new Class2({
     type: "tuple",
     items,
-    rest,
+    rest: rest2,
     ...normalizeParams(params)
   });
 }
@@ -12136,30 +12127,30 @@ var tupleProcessor = (schema, ctx, _json, params) => {
     ...params,
     path: [...params.path, prefixPath, i]
   }));
-  const rest = def.rest ? process2(def.rest, ctx, {
+  const rest2 = def.rest ? process2(def.rest, ctx, {
     ...params,
     path: [...params.path, restPath, ...ctx.target === "openapi-3.0" ? [def.items.length] : []]
   }) : null;
   if (ctx.target === "draft-2020-12") {
     json2.prefixItems = prefixItems;
-    if (rest) {
-      json2.items = rest;
+    if (rest2) {
+      json2.items = rest2;
     }
   } else if (ctx.target === "openapi-3.0") {
     json2.items = {
       anyOf: prefixItems
     };
-    if (rest) {
-      json2.items.anyOf.push(rest);
+    if (rest2) {
+      json2.items.anyOf.push(rest2);
     }
     json2.minItems = prefixItems.length;
-    if (!rest) {
+    if (!rest2) {
       json2.maxItems = prefixItems.length;
     }
   } else {
     json2.items = prefixItems;
-    if (rest) {
-      json2.additionalItems = rest;
+    if (rest2) {
+      json2.additionalItems = rest2;
     }
   }
   const { minimum, maximum } = schema._zod.bag;
@@ -13524,19 +13515,19 @@ var ZodTuple = /* @__PURE__ */ $constructor("ZodTuple", (inst, def) => {
   $ZodTuple.init(inst, def);
   ZodType.init(inst, def);
   inst._zod.processJSONSchema = (ctx, json2, params) => tupleProcessor(inst, ctx, json2, params);
-  inst.rest = (rest) => inst.clone({
+  inst.rest = (rest2) => inst.clone({
     ...inst._zod.def,
-    rest
+    rest: rest2
   });
 });
 function tuple(items, _paramsOrRest, _params) {
   const hasRest = _paramsOrRest instanceof $ZodType;
   const params = hasRest ? _params : _paramsOrRest;
-  const rest = hasRest ? _paramsOrRest : null;
+  const rest2 = hasRest ? _paramsOrRest : null;
   return new ZodTuple({
     type: "tuple",
     items,
-    rest,
+    rest: rest2,
     ...util_exports.normalizeParams(params)
   });
 }
@@ -14400,9 +14391,9 @@ function convertBaseSchema(schema, ctx) {
       const items = schema.items;
       if (prefixItems && Array.isArray(prefixItems)) {
         const tupleItems = prefixItems.map((item) => convertSchema(item, ctx));
-        const rest = items && typeof items === "object" && !Array.isArray(items) ? convertSchema(items, ctx) : void 0;
-        if (rest) {
-          zodSchema = z.tuple(tupleItems).rest(rest);
+        const rest2 = items && typeof items === "object" && !Array.isArray(items) ? convertSchema(items, ctx) : void 0;
+        if (rest2) {
+          zodSchema = z.tuple(tupleItems).rest(rest2);
         } else {
           zodSchema = z.tuple(tupleItems);
         }
@@ -14414,9 +14405,9 @@ function convertBaseSchema(schema, ctx) {
         }
       } else if (Array.isArray(items)) {
         const tupleItems = items.map((item) => convertSchema(item, ctx));
-        const rest = schema.additionalItems && typeof schema.additionalItems === "object" ? convertSchema(schema.additionalItems, ctx) : void 0;
-        if (rest) {
-          zodSchema = z.tuple(tupleItems).rest(rest);
+        const rest2 = schema.additionalItems && typeof schema.additionalItems === "object" ? convertSchema(schema.additionalItems, ctx) : void 0;
+        if (rest2) {
+          zodSchema = z.tuple(tupleItems).rest(rest2);
         } else {
           zodSchema = z.tuple(tupleItems);
         }
@@ -14602,8 +14593,8 @@ var ensureCodexHome = () => mkdirSync(process.env.CODEX_HOME ?? join2(homedir(),
 function installCodex(name, entry2, ours) {
   ensureCodexHome();
   const codex = findCodex();
-  const run3 = (...args) => spawnSync(codex, args, { encoding: "utf8" });
-  const current = run3("mcp", "get", name, "--json");
+  const run2 = (...args) => spawnSync(codex, args, { encoding: "utf8" });
+  const current = run2("mcp", "get", name, "--json");
   if (current.status === 0) {
     const { transport } = JSON.parse(current.stdout);
     if (transport?.command === entry2.command && transport.args?.join("\0") === entry2.args.join("\0"))
@@ -14612,15 +14603,16 @@ function installCodex(name, entry2, ours) {
       throw new Error(
         `${name} already exists with a different configuration; review it with \`codex mcp get ${name}\`. Nothing changed.`
       );
-    const removed = run3("mcp", "remove", name);
+    const removed = run2("mcp", "remove", name);
     if (removed.status !== 0) throw new Error(removed.stderr || `Could not update ${name}.`);
   }
-  const added = run3("mcp", "add", name, "--", entry2.command, ...entry2.args);
+  const added = run2("mcp", "add", name, "--", entry2.command, ...entry2.args);
   if (added.status !== 0) throw new Error(added.stderr || "Codex registration failed.");
   return `Registered ${name}. Start a new chat to use it.`;
 }
 
 // src/adapters/codex-plugin.ts
+var marketplaceName = (channel) => `higgsfield-video-editor-updates-${channel}`;
 var PLUGIN_ROLLBACK_ERROR = "Plugin refresh failed and rollback requires attention.";
 var identity = external_exports.object({
   name: external_exports.string().regex(/^[a-z][a-z0-9-]{0,63}$/),
@@ -14649,7 +14641,7 @@ function validateTree(root) {
   }
 }
 function bindPackageRuntime(root, dist) {
-  for (const file2 of ["mcp.json", ".mcp.json"]) {
+  for (const file2 of [".mcp.json"]) {
     const path = join3(root, file2);
     if (!existsSync2(path)) continue;
     const config2 = external_exports.object({ mcpServers: external_exports.record(external_exports.string(), external_exports.unknown()) }).parse(JSON.parse(readFileSync2(path, "utf8")));
@@ -14672,14 +14664,34 @@ function bundledPlugin(options) {
   if (!existsSync2(root)) return null;
   if (!lstatSync(root).isDirectory()) throw new Error("Plugin bundle must be a directory");
   validateTree(root);
-  const manifest = identity.parse(JSON.parse(readFileSync2(join3(root, "plugin.json"), "utf8")));
-  const codex = identity.parse(
+  const manifest = identity.parse(
     JSON.parse(readFileSync2(join3(root, ".codex-plugin/plugin.json"), "utf8"))
   );
-  if (manifest.name !== codex.name || manifest.version !== options.version || codex.version !== options.version)
+  if (manifest.version !== options.version)
     throw new Error("Plugin identity/version must match its package and Codex manifest");
   return { root, name: manifest.name };
 }
+var marketplaceList = external_exports.object({
+  marketplaces: external_exports.array(external_exports.object({ name: external_exports.string(), root: external_exports.string() }))
+});
+function listMarketplaces(codex, runner, install) {
+  const list = () => marketplaceList.parse(JSON.parse(runner(codex, ["plugin", "marketplace", "list", "--json"]))).marketplaces;
+  try {
+    return list();
+  } catch (error51) {
+    const message = error51 instanceof Error ? error51.message : String(error51);
+    const broken = [...message.matchAll(/^- `([^`]+)` at /gm)].map((match) => match[1]);
+    if (!broken.length) throw error51;
+    const ours = broken.filter((name) => name.startsWith("higgsfield-video-editor-"));
+    if (install && ours.length === broken.length) {
+      for (const name of ours) runner(codex, ["plugin", "marketplace", "remove", name]);
+      return list();
+    }
+    throw new Error(
+      `The ChatGPT desktop app has plugin registrations whose folders are gone: ${broken.join(", ")}. Run \`codex plugin marketplace remove <name>\` for each, then try again.`
+    );
+  }
+}
 function refreshBundledPlugin(options, install = false, runner = run) {
   const marker = join3(options.root, "plugin-registration.json");
   if (!install && !existsSync2(marker)) return void 0;
@@ -14692,21 +14704,20 @@ function refreshBundledPlugin(options, install = false, runner = run) {
   if (previous && previous.name !== bundle.name)
     throw new Error("Plugin identity changed; refusing to replace it");
   const codex = previous?.codex ?? findCodex("plugin");
-  const marketplaceName = `higgsfield-video-editor-updates-${options.channel}`;
+  const marketplace = marketplaceName(options.channel);
   const root = join3(options.root, "marketplace");
   mkdirSync2(root, { recursive: true });
-  const marketplaces = external_exports.object({ marketplaces: external_exports.array(external_exports.object({ name: external_exports.string(), root: external_exports.string() })) }).parse(JSON.parse(runner(codex, ["plugin", "marketplace", "list", "--json"])));
-  const existing = marketplaces.marketplaces.find(
-    (marketplace) => marketplace.name === marketplaceName
+  const existing = listMarketplaces(codex, runner, install).find(
+    (entry2) => entry2.name === marketplace
   );
   if (existing && realpathSync(existing.root) !== realpathSync(root))
     throw new Error("Marketplace name belongs to another source; nothing changed");
   const installedSchema = external_exports.object({
     installed: external_exports.array(external_exports.object({ pluginId: external_exports.string(), enabled: external_exports.boolean() }))
   });
-  const selector = `${bundle.name}@${marketplaceName}`;
+  const selector = `${bundle.name}@${marketplace}`;
   const current = installedSchema.parse(
-    JSON.parse(runner(codex, ["plugin", "list", "--marketplace", marketplaceName, "--json"]))
+    JSON.parse(runner(codex, ["plugin", "list", "--marketplace", marketplace, "--json"]))
   ).installed.find((plugin) => plugin.pluginId === selector);
   if (!install && (!current || !current.enabled))
     throw new Error("Plugin was removed or disabled; refusing to reinstall or re-enable it");
@@ -14741,7 +14752,7 @@ function refreshBundledPlugin(options, install = false, runner = run) {
       if (current) runner(codex, ["plugin", "add", selector, "--json"]);
       else runner(codex, ["plugin", "remove", selector]);
     }
-    if (addedMarketplace) runner(codex, ["plugin", "marketplace", "remove", marketplaceName]);
+    if (addedMarketplace) runner(codex, ["plugin", "marketplace", "remove", marketplace]);
     if (oldCatalog === null) rmSync(catalog, { force: true });
     if (oldMarker !== null) writeAtomic(marker, oldMarker);
     else rmSync(marker, { force: true });
@@ -14750,7 +14761,7 @@ function refreshBundledPlugin(options, install = false, runner = run) {
     writeAtomic(
       catalog,
       JSON.stringify({
-        name: marketplaceName,
+        name: marketplace,
         interface: { displayName: "Higgsfield Video Editor Updates" },
         plugins: [
           {
@@ -14782,6 +14793,18 @@ function refreshBundledPlugin(options, install = false, runner = run) {
 }
 
 // src/video-editor-local/updates.ts
+import { execFileSync as execFileSync2 } from "node:child_process";
+import {
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync3,
+  renameSync as renameSync2,
+  rmSync as rmSync2,
+  statSync as statSync2,
+  writeFileSync as writeFileSync2
+} from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { dirname as dirname3, join as join4 } from "node:path";
 var UPDATE_PACKAGE = "@higgsfield/video-editor-mcp";
 var UPDATE_REGISTRY = "https://registry.npmjs.org/";
 var CHECK_INTERVAL = 60 * 60 * 1e3;
@@ -14843,8 +14866,8 @@ function newerVersion(candidate, current) {
   }
   return false;
 }
-function packageDist(prefix) {
-  return join4(prefix, "node_modules", UPDATE_PACKAGE, "dist");
+function packageDist(prefix2) {
+  return join4(prefix2, "node_modules", UPDATE_PACKAGE, "dist");
 }
 function validPackage(dist, version2) {
   try {
@@ -14871,7 +14894,7 @@ function saveState(root, state) {
   writeFileSync2(temp, JSON.stringify(state));
   renameSync2(temp, join4(root, "state.json"));
 }
-var run2 = (command2, args, timeout, cwd) => execFileSync2(command2, args, {
+var defaultRunner = (command2, args, timeout, cwd) => execFileSync2(command2, args, {
   cwd,
   env: Object.fromEntries(
     Object.entries(process.env).filter(([name]) => !name.toLowerCase().startsWith("npm_config_"))
@@ -14882,7 +14905,7 @@ var run2 = (command2, args, timeout, cwd) => execFileSync2(command2, args, {
   maxBuffer: 1024 * 1024,
   stdio: ["ignore", "pipe", "pipe"]
 });
-function updateEditor(options, force = false, runner = run2) {
+function updateEditor(options, force = false, runner = defaultRunner) {
   const { root, channel } = options;
   if (!force && !checkDue(root)) return "Already checked within the last hour.";
   mkdirSync3(root, { recursive: true });
@@ -14987,6 +15010,71 @@ function updateEditor(options, force = false, runner = run2) {
   }
 }
 
+// src/video-editor-local/install.ts
+var INSTALL_PREFIX = join5(homedir3(), ".higgsfield", "video-editor-mcp");
+var installedCli = (prefix2 = INSTALL_PREFIX) => join5(prefix2, "node_modules", UPDATE_PACKAGE, "dist", "cli.mjs");
+function installPrefixOf(dist) {
+  const parts = dist.split(sep);
+  if (parts.includes("_npx")) return void 0;
+  if (parts.slice(-4).join("/") !== `node_modules/${UPDATE_PACKAGE}/dist`) return void 0;
+  return parts.slice(0, -4).join(sep);
+}
+function installPackage(version2, prefix2 = INSTALL_PREFIX, runner = defaultRunner) {
+  mkdirSync4(prefix2, { recursive: true });
+  const userConfig = join5(prefix2, "npmrc");
+  const globalConfig2 = join5(prefix2, "npmrc-global");
+  writeFileSync3(userConfig, `registry=${UPDATE_REGISTRY}
+`);
+  writeFileSync3(globalConfig2, "");
+  runner(
+    "npm",
+    [
+      "install",
+      "--prefix",
+      prefix2,
+      "--ignore-scripts",
+      "--no-audit",
+      "--no-fund",
+      "--save-exact",
+      "--engine-strict",
+      `--registry=${UPDATE_REGISTRY}`,
+      `--userconfig=${userConfig}`,
+      `--globalconfig=${globalConfig2}`,
+      "--fetch-retries=2",
+      `${UPDATE_PACKAGE}@${version2}`
+    ],
+    3e5,
+    prefix2
+  );
+  const cli = installedCli(prefix2);
+  if (!existsSync4(cli))
+    throw new Error(`${UPDATE_PACKAGE}@${version2} did not install under ${prefix2}.`);
+  return cli;
+}
+var registration2 = external_exports.object({ name: external_exports.string().min(1), codex: external_exports.string().min(1) });
+function uninstallEditor(prefix2 = INSTALL_PREFIX, runner = defaultRunner) {
+  const lines = [];
+  for (const channel of ["latest", "next"]) {
+    const marker = join5(prefix2, "public-updates", channel, "plugin-registration.json");
+    if (!existsSync4(marker)) continue;
+    const { name, codex } = registration2.parse(JSON.parse(readFileSync4(marker, "utf8")));
+    const marketplace = marketplaceName(channel);
+    for (const args of [
+      ["plugin", "remove", `${name}@${marketplace}`],
+      ["plugin", "marketplace", "remove", marketplace]
+    ]) {
+      try {
+        runner(codex, args, 2e4, prefix2);
+      } catch {
+      }
+    }
+    lines.push(`Removed the ${name} plugin from the ChatGPT desktop app.`);
+  }
+  rmSync3(prefix2, { recursive: true, force: true });
+  lines.push(`Removed ${prefix2}. Your projects were not touched.`);
+  return lines.join("\n");
+}
+
 // src/adapters/claude.ts
 var claudeConfig = (name, entry2) => ({
   mcpServers: { [name]: entry2 }
@@ -14995,38 +15083,142 @@ var claudeConfig = (name, entry2) => ({
 // src/video-editor-local/setup.ts
 var NAME = "higgsfield-use-video-editor";
 var DIST = dirname4(import.meta.filename);
-var SERVER = join5(DIST, "server.mjs");
-var LAUNCHER = join5(DIST, "launcher.mjs");
-var PANEL = join5(DIST, "index.html");
+var SERVER = join6(DIST, "server.mjs");
+var LAUNCHER = join6(DIST, "launcher.mjs");
+var PANEL = join6(DIST, "index.html");
 var entry = { command: process.execPath, args: [LAUNCHER] };
+var INSTALL = `npx ${UPDATE_PACKAGE} install`;
+var prefix = installPrefixOf(DIST);
+var persistent = prefix !== void 0;
 function doctor() {
   const [major = 0, minor = 0] = process.versions.node.split(".").map(Number);
   const cli = findCli({}, pathToFileURL(SERVER).href);
-  const version2 = cli ? spawnSync2(process.execPath, [cli, "version"], { encoding: "utf8" }) : void 0;
+  const report = cli ? spawnSync2(process.execPath, [cli, "doctor", "--json"], { encoding: "utf8" }) : void 0;
+  let diagnosis;
+  try {
+    diagnosis = report ? JSON.parse(report.stdout) : void 0;
+  } catch {
+    diagnosis = void 0;
+  }
   return [
     { name: "node", ok: major > 22 || major === 22 && minor >= 12, detail: process.version },
     { name: "platform", ok: process.platform === "darwin", detail: process.platform },
-    { name: "server", ok: existsSync4(SERVER), detail: SERVER },
-    { name: "launcher", ok: existsSync4(LAUNCHER), detail: LAUNCHER },
-    { name: "panel", ok: existsSync4(PANEL), detail: PANEL },
+    { name: "server", ok: existsSync5(SERVER), detail: SERVER },
+    { name: "launcher", ok: existsSync5(LAUNCHER), detail: LAUNCHER },
+    { name: "panel", ok: existsSync5(PANEL), detail: PANEL },
     {
       name: "higgsedit",
-      ok: version2?.status === 0,
-      detail: version2 ? (version2.stdout || version2.stderr).trim() : "the bundled CLI is missing"
+      ok: diagnosis !== void 0,
+      detail: cli ? diagnosis ? cli : ((report?.stdout || report?.stderr) ?? "").trim().slice(-500) || "did not answer" : "the bundled CLI is missing"
+    },
+    {
+      name: "ffmpeg",
+      ok: typeof diagnosis?.ffmpeg?.path === "string",
+      detail: diagnosis?.ffmpeg?.path ?? diagnosis?.ffmpeg?.missing ?? "unknown until higgsedit answers"
     }
   ];
 }
-function assertPersistentInstall() {
-  if (DIST.split(sep).includes("_npx"))
-    throw new Error(
-      `Install a persistent copy first (npm install --prefix ~/.higgsfield/video-editor-mcp ${UPDATE_PACKAGE}); an npx cache path must not be registered.`
+function listing() {
+  try {
+    const manifest = JSON.parse(
+      readFileSync5(join6(dirname4(DIST), "plugin/.codex-plugin/plugin.json"), "utf8")
     );
-  if (!existsSync4(SERVER))
-    throw new Error(`The server is missing at ${SERVER}; reinstall the package.`);
+    return {
+      displayName: manifest.interface?.displayName ?? "Higgsfield Video Editor",
+      defaultPrompt: manifest.interface?.defaultPrompt ?? []
+    };
+  } catch {
+    return { displayName: "Higgsfield Video Editor", defaultPrompt: [] };
+  }
 }
-var command = process.argv[2] ?? "help";
+function requirePersistent() {
+  if (!persistent) throw new Error(`Run \`${INSTALL}\` first.`);
+  if (!existsSync5(SERVER)) throw new Error(`The server is missing at ${SERVER}; reinstall the package.`);
+}
+function installPlugin() {
+  ensureCodexHome();
+  const options = updateOptions(DIST);
+  const lock = join6(options.root, "update.lock");
+  mkdirSync5(options.root, { recursive: true });
+  try {
+    mkdirSync5(lock);
+  } catch {
+    throw new Error("Another update is running; retry after it finishes.");
+  }
+  try {
+    const dist = selectedDist(options);
+    const refreshed = refreshBundledPlugin(
+      dist === DIST ? options : { ...options, dist, version: readUpdateState(options.root).active },
+      true
+    );
+    return refreshed ? "Registered the plugin with the ChatGPT desktop app." : "This package has no plugin bundle.";
+  } finally {
+    rmSync4(lock, { recursive: true, force: true });
+  }
+}
+function handOver(args) {
+  const result = spawnSync2(process.execPath, [installedCli(), ...args], { stdio: "inherit" });
+  process.exitCode = result.status ?? 1;
+}
+var HELP = `Usage: npx ${UPDATE_PACKAGE} <install|uninstall|doctor|config|update>
+
+  install    install the editor under ${INSTALL_PREFIX} and register it with the ChatGPT desktop app
+  uninstall  remove that registration and the installed editor (projects are kept)
+  doctor     check Node, ffmpeg, the bundled higgsedit CLI, the server and the panel
+  config     print the MCP server entry for another client (Claude Code, Codex CLI)
+  update     check npm for a newer version now
+
+Lower level: install-plugin, install-codex (the MCP server alone; remove it with \`codex mcp remove ${NAME}\`).`;
+var [command = "help", ...rest] = process.argv.slice(2);
+var delegated = ["uninstall", "doctor", "config", "update", "install-codex", "install-plugin"];
 try {
-  if (command === "config") {
+  if (command === "install") {
+    const { version: version2 } = updateOptions(DIST);
+    if (!persistent) {
+      console.log(`Installing ${UPDATE_PACKAGE} ${version2} under ${INSTALL_PREFIX}...`);
+      installPackage(version2);
+      handOver(["install", ...rest]);
+    } else {
+      const checks = doctor();
+      const failed = checks.filter((check2) => !check2.ok);
+      let registered = false;
+      let plugin;
+      try {
+        plugin = installPlugin();
+        registered = true;
+      } catch (error51) {
+        plugin = `Not registered with the ChatGPT desktop app: ${error51 instanceof Error ? error51.message : String(error51)}`;
+      }
+      const { displayName, defaultPrompt } = listing();
+      const next = registered ? [
+        "",
+        `Start a new chat, type @ and pick ${displayName}, then try:`,
+        ...defaultPrompt.map((prompt) => `  @${displayName} ${prompt}`),
+        "",
+        `Other MCP clients (Claude Code, the Codex CLI): npx ${UPDATE_PACKAGE} config`
+      ] : [
+        "",
+        "For an MCP client (Claude Code, the Codex CLI), add this server:",
+        JSON.stringify(claudeConfig(NAME, entry), null, 2)
+      ];
+      console.log(
+        [
+          `Installed ${UPDATE_PACKAGE} ${version2}.`,
+          plugin,
+          ...failed.map((check2) => `Needs attention: ${check2.name} (${check2.detail})`),
+          ...next
+        ].join("\n")
+      );
+      if (failed.some((check2) => ["server", "launcher", "panel", "higgsedit"].includes(check2.name)))
+        process.exitCode = 1;
+    }
+  } else if (delegated.includes(command) && !persistent && existsSync5(installedCli())) {
+    handOver([command, ...rest]);
+  } else if (command === "uninstall") {
+    if (prefix === void 0) throw new Error(`Nothing is installed under ${INSTALL_PREFIX}.`);
+    console.log(uninstallEditor(prefix));
+  } else if (command === "config") {
+    requirePersistent();
     console.log(JSON.stringify(claudeConfig(NAME, entry), null, 2));
   } else if (command === "doctor") {
     const checks = doctor();
@@ -15036,41 +15228,21 @@ try {
     );
     process.exitCode = ok ? 0 : 1;
   } else if (command === "install-codex") {
-    assertPersistentInstall();
+    requirePersistent();
     console.log(installCodex(NAME, entry, [SERVER, LAUNCHER]));
   } else if (command === "install-plugin") {
-    ensureCodexHome();
-    const options = updateOptions(DIST);
-    const lock = join5(options.root, "update.lock");
-    mkdirSync4(options.root, { recursive: true });
-    try {
-      mkdirSync4(lock);
-    } catch {
-      throw new Error("Another update is running; retry install-plugin after it finishes.");
-    }
-    try {
-      const dist = selectedDist(options);
-      const refreshed = refreshBundledPlugin(
-        dist === DIST ? options : { ...options, dist, version: readUpdateState(options.root).active },
-        true
-      );
-      console.log(
-        refreshed ? "Installed the bundled plugin. Reload the desktop app to load its skills." : "This package has no plugin bundle yet."
-      );
-    } finally {
-      rmSync3(lock, { recursive: true, force: true });
-    }
+    requirePersistent();
+    console.log(`${installPlugin()} Reload the desktop app to load its skills.`);
   } else if (command === "update") {
+    requirePersistent();
     const result = updateEditor(updateOptions(DIST), true);
     console.log(result);
     if (result.startsWith("Update failed")) process.exitCode = 1;
   } else if (["help", "--help", "-h"].includes(command)) {
-    console.log(
-      `Usage: fnf-video-editor <doctor|config|install-codex|install-plugin|update>
-The MCP server is fnf-video-editor-mcp (stdio). Remove it with: codex mcp remove ${NAME}`
-    );
+    console.log(HELP);
   } else {
-    throw new Error(`Unknown command '${command}'. Use --help.`);
+    throw new Error(`Unknown command '${command}'.
+${HELP}`);
   }
 } catch (error51) {
   console.error(error51 instanceof Error ? error51.message : String(error51));

package/dist/guide.md

@@ -1,8 +1,7 @@
 # Local project guide
 
-The open folder is a video-editor-next project, where the TSX is the document. Its `higgsedit` is not
-the sandbox CLI of the video-editing skill: never use `project.json`, `higgsedit build`, `do`/`ops` or
-`sandbox_exec` on it.
+The open folder is a higgsedit project: the TSX is the document, and every edit below changes it on the
+user's disk. Nothing is uploaded.
 
 ## Project