@moloodev/cli 0.7.0 → 0.9.0

package/README.md

@@ -1,6 +1,6 @@
 `moloo editor dev` does not support the local app host because the parent app origin is fixed to production (`https://app.moloo.dev`).
 
-The view server defaults to `http://127.0.0.1:4310` and opens `https://app.moloo.dev/w/<slug>/dev-editor`. Use `moloo editor dev --view-port 4451` to select another port. Click **로컬 뷰 연결** in the app and allow Chrome local network access when prompted. If a connection fails, the app displays the browser error or manifest HTTP status; check the CLI and the app's browser site permissions.
+The view server defaults to `http://127.0.0.1:4310` and opens `https://app.moloo.dev/w/<slug>/dev-editor`. Use `moloo editor dev --view-port 4451` to select another port. The first time, click **로컬 뷰 연결** in the app and allow Chrome local network access; once granted, the app connects automatically. If a connection fails, the app displays the browser error or manifest HTTP status; check the CLI and the app's browser site permissions.
 
 `moloo editor publish` always targets a workspace you administer. For `moloo.*` manifests it defaults to workspace `moloo`; `--workspace` overrides that default. Other publishers use the explicit flag, saved workspace or membership selection. Publisher ownership is verified on the server. Builtin means publisher `moloo`, managed by the admin-only `moloo` workspace; these submissions publish immediately after checks pass (422 with finding details on failure). Other publishers are claimed by the submitting workspace on first submission and receive 202 pending review in `https://admin.moloo.dev`. Run `moloo editor status` to inspect revision status, which tracks point at each revision, check findings, and rejection reasons.
 
@@ -9,3 +9,7 @@ Editors have two release tracks, `stable` (the default) and `beta`. Each track p
 Create a standalone editor with `moloo editor create <publisher>.<name>` (for example, `moloo editor create acme.notes`), or use `moloo editor create acme.notes --here` in an empty directory. The CLI downloads template tag `v1` from `moloodev/editor-template`, then rewrites its package, manifest, and README title. It never overwrites an existing destination. In the generated directory, run `pnpm install`, `moloo login`, `moloo workspace use <slug>`, then `moloo editor dev`. When ready, run `moloo editor build`, `moloo editor publish`, and `moloo editor status`.
 
 The `moloo` bin delegates to a project's installed `@moloodev/cli`, searching from the current directory upward. This keeps global invocations on the project's CLI version.
+
+`moloo --version` (or `-v`) prints the version of the CLI that runs the command. Inside a project with its own `@moloodev/cli`, commands are delegated to that CLI, so this shows the project's version.
+
+`moloo upgrade` upgrades the globally installed CLI to the npm `latest` version and is never delegated to a project's CLI. It detects npm, pnpm, yarn or bun from the install path and runs that manager's global install; if the version is already latest it only says so. When the running CLI is a project dependency, it prints how to upgrade it with the project's package manager and changes nothing.

package/bin/moloo.mjs

@@ -3,7 +3,8 @@ import { spawnSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { findLocalCli, LOCAL_CLI_ENV } from "./local-cli.mjs";
 
-const local = findLocalCli(process.cwd(), fileURLToPath(import.meta.url));
+// `upgrade` targets the globally installed CLI itself, so it never hands off.
+const local = process.argv[2] === "upgrade" ? null : findLocalCli(process.cwd(), fileURLToPath(import.meta.url));
 if (local) {
   const child = spawnSync(process.execPath, [local, ...process.argv.slice(2)], {
     stdio: "inherit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moloodev/cli",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "type": "module",
   "bin": {
     "moloo": "./bin/moloo.mjs"
@@ -24,15 +24,15 @@
     "tw-animate-css": "^1.4.0",
     "vite": "^8.2.2",
     "zod": "^4.5.4",
-    "@moloodev/editor-sdk": "0.7.0",
-    "@moloodev/platform": "0.7.0",
-    "@moloodev/editor-store": "0.7.0",
-    "@moloodev/ui": "0.7.0"
+    "@moloodev/editor-sdk": "0.9.0",
+    "@moloodev/editor-store": "0.9.0",
+    "@moloodev/platform": "0.9.0",
+    "@moloodev/ui": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",
     "typescript": "^7.0.2",
-    "@moloodev/typescript-config": "0.7.0"
+    "@moloodev/typescript-config": "0.9.0"
   },
   "publishConfig": {
     "access": "public"

package/src/cli.ts

@@ -7,12 +7,13 @@ import { promoteEditorPackage, publishEditorPackage } from "./publish";
 import { printEditorStatus } from "./editor-status";
 import { createEditor, EDITOR_CREATE_USAGE } from "./editor-create";
 import { apiErrorMessage, readApiBody } from "./api-result";
+import { cliVersion, upgradeCli, UPGRADE_USAGE } from "./upgrade";
 import { listWorkspaces, useWorkspace, type WorkspaceOptions } from "./workspace";
 
 const EDITOR_USAGE =
   `${EDITOR_CREATE_USAGE}\nUsage: moloo editor <dev|build|publish|status> [--dir <path>] [--out-dir <path>] [--view-port <port>] [--workspace <slug>]\nUsage: moloo editor publish [--track stable|beta] [--dir <path>] [--workspace <slug>]\nUsage: moloo editor promote beta stable [--dir <path>] [--workspace <slug>]\nDev view port: 4310 (default)`;
 const WORKSPACE_USAGE = "Usage: moloo workspace list | use <slug>";
-const USAGE = `Usage: moloo <command>\n\nCommands:\n  login   [--device]\n  logout\n  whoami\n  workspace  list | use <slug>\n  editor  create | dev | build | publish | promote | status\n\n${WORKSPACE_USAGE}\n${EDITOR_USAGE}`;
+const USAGE = `Usage: moloo <command>\n       moloo --version | -v\n\nCommands:\n  login   [--device]\n  logout\n  whoami\n  upgrade\n  workspace  list | use <slug>\n  editor  create | dev | build | publish | promote | status\n\n${WORKSPACE_USAGE}\n${EDITOR_USAGE}`;
 
 type Command = (args: readonly string[], options: WorkspaceOptions) => Promise<number>;
 
@@ -123,6 +124,13 @@ const commands: Record<string, {
       return 0;
     },
   },
+  upgrade: {
+    usage: UPGRADE_USAGE,
+    async run(args) {
+      if (args.length) throw new Error(UPGRADE_USAGE);
+      return upgradeCli();
+    },
+  },
   workspace: {
     usage: WORKSPACE_USAGE,
     async run([name, ...args], options) {
@@ -154,6 +162,10 @@ export async function runCli(argv: readonly string[], options: WorkspaceOptions
   const [name, ...args] = argv;
   const command =
     name === undefined ? undefined : Object.hasOwn(commands, name) ? commands[name] : undefined;
+  if (argv.length === 1 && (name === "--version" || name === "-v")) {
+    console.log(cliVersion());
+    return 0;
+  }
   const wantsHelp = argv.includes("--help") || argv.includes("-h");
   if (wantsHelp) {
     console.log(command?.usage ?? USAGE);

package/src/editor-dev.ts

@@ -28,6 +28,7 @@ export async function runEditorDev(
   try {
     const destination = new URL(`/w/${encodeURIComponent(slug)}/dev-editor`, getWorkspaceHostUrl("production"));
     destination.searchParams.set("view", server.viewOrigin);
+    console.log(`${server.editorId} browser -> ${destination.href}`);
     console.log(`${server.editorId} view origin -> ${server.viewOrigin}`);
     await deps.open(destination.href);
     await deps.stopped();

package/src/upgrade.ts

@@ -0,0 +1,113 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync, realpathSync } from "node:fs";
+import { dirname, join, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const UPGRADE_USAGE = "Usage: moloo upgrade";
+
+const PACKAGE = "@moloodev/cli";
+const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE.replace("/", "%2F")}/latest`;
+
+export type GlobalManager = "npm" | "pnpm" | "yarn" | "bun";
+export type Install = { kind: "global"; manager: GlobalManager } | { kind: "local" };
+
+const INSTALL_COMMANDS: Record<GlobalManager, readonly [string, ...string[]]> = {
+  npm: ["npm", "install", "--global", `${PACKAGE}@latest`],
+  pnpm: ["pnpm", "add", "--global", `${PACKAGE}@latest`],
+  yarn: ["yarn", "global", "add", `${PACKAGE}@latest`],
+  bun: ["bun", "add", "--global", `${PACKAGE}@latest`],
+};
+
+/** Classify the installed package directory (realpath) by each manager's global store layout. */
+export function detectInstall(packageRoot: string): Install {
+  const path = packageRoot.split(sep).join("/");
+  if (/\/pnpm\/global\/|\/\.pnpm-global\//.test(path)) return { kind: "global", manager: "pnpm" };
+  if (/\/\.bun\/install\/global\//.test(path)) return { kind: "global", manager: "bun" };
+  if (/\/yarn\/global\/|\/\.yarn-global\//.test(path)) return { kind: "global", manager: "yarn" };
+  if (/\/lib\/node_modules\/@moloodev\/cli$|\/npm\/node_modules\/@moloodev\/cli$/.test(path)) {
+    return { kind: "global", manager: "npm" };
+  }
+  return { kind: "local" };
+}
+
+export type Runner = (command: string, args: readonly string[]) => number;
+
+export interface UpgradeDeps {
+  packageRoot?: string;
+  currentVersion?: string;
+  fetchLatest?: () => Promise<string>;
+  run?: Runner;
+  log?: (line: string) => void;
+}
+
+export async function upgradeCli(deps: UpgradeDeps = {}): Promise<number> {
+  const packageRoot = deps.packageRoot ?? cliPackageRoot();
+  const current = deps.currentVersion ?? readVersion(packageRoot);
+  const log = deps.log ?? console.log;
+  const install = detectInstall(packageRoot);
+  if (install.kind === "local") {
+    log(`${PACKAGE} ${current} is a project dependency (${packageRoot}).`);
+    log(`Upgrade it with the project's package manager, e.g. pnpm add -D ${PACKAGE}@latest`);
+    return 1;
+  }
+  const latest = await (deps.fetchLatest ?? fetchLatestVersion)();
+  if (latest === current) {
+    log(`${PACKAGE} ${current} is already the latest.`);
+    return 0;
+  }
+  if (compareVersions(current, latest) > 0) {
+    log(`${PACKAGE} ${current} is newer than latest ${latest}; not downgrading.`);
+    return 0;
+  }
+  const [command, ...args] = INSTALL_COMMANDS[install.manager];
+  log(`Upgrading ${PACKAGE} ${current} -> ${latest}: ${[command, ...args].join(" ")}`);
+  const status = (deps.run ?? spawnRunner)(command, args);
+  if (status !== 0) throw new Error(`${command} exited with ${String(status)}`);
+  log(`${PACKAGE} upgraded to ${latest}.`);
+  return 0;
+}
+
+/** Minimal semver order: numeric core, then a release outranks its prereleases. */
+export function compareVersions(a: string, b: string): number {
+  const [coreA = "", preA] = a.split("-", 2);
+  const [coreB = "", preB] = b.split("-", 2);
+  const numsA = coreA.split(".").map(Number);
+  const numsB = coreB.split(".").map(Number);
+  for (let index = 0; index < 3; index += 1) {
+    const diff = (numsA[index] ?? 0) - (numsB[index] ?? 0);
+    if (diff) return Math.sign(diff);
+  }
+  if (preA === preB) return 0;
+  if (preA === undefined) return 1;
+  if (preB === undefined) return -1;
+  return preA.localeCompare(preB, "en", { numeric: true });
+}
+
+function cliPackageRoot(): string {
+  return realpathSync(join(dirname(fileURLToPath(import.meta.url)), ".."));
+}
+
+/** Version of the CLI package that is running this code. */
+export function cliVersion(): string {
+  return readVersion(cliPackageRoot());
+}
+
+function readVersion(packageRoot: string): string {
+  const pkg = JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8")) as { version?: unknown };
+  if (typeof pkg.version !== "string") throw new Error(`No version in ${packageRoot}/package.json`);
+  return pkg.version;
+}
+
+async function fetchLatestVersion(): Promise<string> {
+  const response = await fetch(REGISTRY_URL);
+  if (!response.ok) throw new Error(`npm registry returned ${String(response.status)} for ${PACKAGE}`);
+  const body = (await response.json()) as { version?: unknown };
+  if (typeof body.version !== "string") throw new Error(`npm registry has no latest version for ${PACKAGE}`);
+  return body.version;
+}
+
+const spawnRunner: Runner = (command, args) => {
+  const child = spawnSync(command, args, { stdio: "inherit", shell: process.platform === "win32" });
+  if (child.error) throw child.error;
+  return child.status ?? 1;
+};