lineadraw 0.6.0 → 0.8.0

package/bin/lineadraw.mjs

@@ -1,278 +1,292 @@
 #!/usr/bin/env node
-// The `lineadraw` CLI — two halves:
-//   * marketplace tooling for Linea block/command repos
-//     (docs/marketplace-devx.md in the linea repo):
-//       lineadraw manifest [--dir <path>]   generate .lineadraw/marketplace.json
-//       lineadraw check    [--dir <path>]   validate + fail if the manifest is stale
-//       lineadraw init     [--dir <path>]   add the marketplace structure here
-//   * the BRIDGE: what the running Linea desktop app serves on
-//     127.0.0.1:7431 (docs/desktop-bridge.md) — `status`, `editors`, `open`,
-//     `close`, `call`, `tools`. Reads the desktop's bridge.json for the port
-//     and the agent token; `--port` / `--token` / LINEA_BRIDGE_TOKEN override.
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
-import {
-  buildManifest,
-  manifestJson,
-  MANIFEST_PATH,
-  verifyWithSdk,
-  withThumbnails,
-} from "../lib/manifest.mjs";
-import { init, tsconfigLibWarning } from "../lib/init.mjs";
-
-const USAGE = `Usage: lineadraw <command> [options]
-
-Marketplace repos (block / command collections):
-  manifest  [--dir <path>]   Validate all modules and write ${MANIFEST_PATH}
-  check     [--dir <path>]   Validate without writing; fail if the committed manifest is stale
-  init      [--dir <path>]   Add the marketplace structure to the current npm project
-
-manifest and check also dry-run every block through lineadraw/sdk and bake
-preview thumbnails into the catalog.
-
-Running editors (the Linea desktop app on 127.0.0.1:7431):
-  status                                is anything serving? port, editors
-  editors                               the open drawings: id, name, path, kind, dirty
-  open <file.linea>                     open a file in a window of its own (returns its editor)
-  close [--editor <x>] [--discard]      close an editor like its window's x
-  call <operation> ['<json>'] [--editor <x>]
-                                        run one linea_* operation (see tools)
-  tools                                 the operations the bridge offers
-
-The desktop's bridge.json (port, agent token) is read automatically;
-LINEA_BRIDGE_TOKEN or --token override the token, --port the port.`;
-
-const args = process.argv.slice(2);
-const command = args[0];
-const dirFlag = args.indexOf("--dir");
-const dir = resolve(dirFlag === -1 ? "." : (args[dirFlag + 1] ?? "."));
-
-/** `--key value` / `--flag` after the command; the rest are positional. */
-const parseArgs = (argv) => {
-  const positional = [];
-  const flags = {};
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a.startsWith("--")) {
-      const key = a.slice(2);
-      const next = argv[i + 1];
-      if (next !== undefined && !next.startsWith("--")) {
-        flags[key] = next;
-        i++;
-      } else flags[key] = true;
-    } else positional.push(a);
-  }
-  return { positional, flags };
-};
-
-// --- bridge --------------------------------------------------------------
-
-const APP_ID = "com.lineadraw.desktop";
-const DEFAULT_PORT = 7431;
-
-const bridgeFilePath = () => {
-  const home = homedir();
-  if (process.platform === "win32")
-    return join(
-      process.env.APPDATA ?? join(home, "AppData", "Roaming"),
-      APP_ID,
-      "bridge.json",
-    );
-  if (process.platform === "darwin")
-    return join(home, "Library", "Application Support", APP_ID, "bridge.json");
-  return join(
-    process.env.XDG_DATA_HOME ?? join(home, ".local", "share"),
-    APP_ID,
-    "bridge.json",
-  );
-};
-
-const readBridgeFile = () => {
-  const path = bridgeFilePath();
-  if (!existsSync(path)) return {};
-  try {
-    return JSON.parse(readFileSync(path, "utf8"));
-  } catch {
-    return {};
-  }
-};
-
-const bridge = (flags) => {
-  const file = readBridgeFile();
-  const port =
-    typeof flags.port === "string"
-      ? Number(flags.port)
-      : file.port || DEFAULT_PORT;
-  const token =
-    (typeof flags.token === "string" ? flags.token : undefined) ??
-    process.env.LINEA_BRIDGE_TOKEN ??
-    file.token;
-  const headers = { "content-type": "application/json" };
-  if (token) headers.authorization = `Bearer ${token}`;
-  return { base: `http://127.0.0.1:${port}`, headers };
-};
-
-const request = async (b, method, path, body) => {
-  let response;
-  try {
-    response = await fetch(`${b.base}${path}`, {
-      method,
-      headers: b.headers,
-      body: body === undefined ? undefined : JSON.stringify(body),
-    });
-  } catch (e) {
-    const cause = e?.cause?.code ?? e?.cause?.message ?? e?.message ?? e;
-    throw new Error(
-      `Nothing answers on ${b.base} (${cause}). Is the Linea desktop app running?`,
-      { cause: e },
-    );
-  }
-  const text = await response.text();
-  let parsed = text;
-  try {
-    parsed = JSON.parse(text);
-  } catch {
-    // not JSON: keep the text
-  }
-  if (!response.ok) {
-    const error = parsed?.error;
-    throw new Error(
-      error?.message ?? `HTTP ${response.status}: ${text.slice(0, 200)}`,
-    );
-  }
-  return parsed;
-};
-
-const editorQuery = (flags) =>
-  typeof flags.editor === "string"
-    ? `?editor=${encodeURIComponent(flags.editor)}`
-    : "";
-
-const bridgeCommand = async (cmd, positional, flags) => {
-  const b = bridge(flags);
-  switch (cmd) {
-    case "status":
-      return request(b, "GET", "/status");
-    case "editors":
-      return request(b, "GET", "/api/editors");
-    case "open": {
-      const file = positional[0];
-      if (!file) throw new Error("open needs a .linea file path");
-      return request(b, "POST", "/api/openEditor", { path: resolve(file) });
-    }
-    case "close":
-      return request(
-        b,
-        "POST",
-        `/api/linea_close_editor${editorQuery(flags)}`,
-        { discard: flags.discard === true },
-      );
-    case "call": {
-      const [operation, json] = positional;
-      if (!operation)
-        throw new Error("call needs an operation name (see `lineadraw tools`)");
-      const payload = json === undefined ? {} : JSON.parse(json);
-      return request(
-        b,
-        "POST",
-        `/api/${encodeURIComponent(operation)}${editorQuery(flags)}`,
-        payload,
-      );
-    }
-    case "tools": {
-      const reply = await request(b, "POST", "/mcp", {
-        jsonrpc: "2.0",
-        id: 1,
-        method: "tools/list",
-      });
-      return (reply.result?.tools ?? []).map((t) => ({
-        name: t.name,
-        description: t.description,
-      }));
-    }
-    default:
-      throw new Error(`Unknown command: ${cmd}\n\n${USAGE}`);
-  }
-};
-
-const BRIDGE_COMMANDS = ["status", "editors", "open", "close", "call", "tools"];
-
-const fail = (message) => {
-  console.error(message);
-  process.exit(1);
-};
-
-const reportProblems = (problems) => {
-  for (const p of problems)
-    console.error(`REJECTED ${p.file}: ${p.problems.join("; ")}`);
-};
-
-/** Validate everything (light + sdk dry-run); exits on failure. */
-const validatedManifest = async () => {
-  const { manifest: base, sources, problems } = buildManifest(dir);
-  const sdkResult = await verifyWithSdk(base, sources);
-  const all = [...problems, ...sdkResult.problems];
-  if (all.length > 0) {
-    reportProblems(all);
-    fail(`${all.length} problem(s) — nothing written.`);
-  }
-  const manifest = withThumbnails(base, sdkResult.thumbnails);
-  if (!sdkResult.ran)
-    console.warn(
-      `Blocks were not dry-run: lineadraw/sdk failed to load (${sdkResult.detail}). Try reinstalling lineadraw.`,
-    );
-  return manifest;
-};
-
-switch (command) {
-  case "manifest": {
-    const manifest = await validatedManifest();
-    const outPath = join(dir, MANIFEST_PATH);
-    mkdirSync(dirname(outPath), { recursive: true });
-    writeFileSync(outPath, manifestJson(manifest));
-    console.log(`${MANIFEST_PATH}: ${manifest.entries.length} entries`);
-    for (const e of manifest.entries)
-      console.log(`  ${e.kind}  ${e.id}  v${e.version}`);
-    break;
-  }
-  case "check": {
-    const manifest = await validatedManifest();
-    const committedPath = join(dir, MANIFEST_PATH);
-    const committed = existsSync(committedPath)
-      ? readFileSync(committedPath, "utf8")
-      : null;
-    if (committed !== manifestJson(manifest))
-      fail(
-        `${MANIFEST_PATH} is ${committed === null ? "missing" : "stale"} — run \`npx lineadraw manifest\` and commit the result.`,
-      );
-    const libWarning = tsconfigLibWarning(dir);
-    if (libWarning !== null) console.warn(`warning: ${libWarning}`);
-    console.log(`OK: ${manifest.entries.length} entries, manifest is current.`);
-    break;
-  }
-  case "init": {
-    try {
-      const { created, skipped, warnings } = await init(dir);
-      for (const f of created) console.log(`created  ${f}`);
-      for (const f of skipped) console.log(`kept     ${f}`);
-      for (const w of warnings) console.warn(`warning  ${w}`);
-      console.log(
-        "\nDone. Commit, push, then add the repo in the editor: Library → Marketplace.",
-      );
-    } catch (e) {
-      fail(e instanceof Error ? e.message : String(e));
-    }
-    break;
-  }
-  default: {
-    if (!BRIDGE_COMMANDS.includes(command)) fail(USAGE);
-    const { positional, flags } = parseArgs(args.slice(1));
-    try {
-      const result = await bridgeCommand(command, positional, flags);
-      console.log(JSON.stringify(result, null, 2));
-    } catch (e) {
-      fail(e instanceof Error ? e.message : String(e));
-    }
-  }
-}
+// The `lineadraw` CLI — two halves:
+//   * marketplace tooling for Linea block/command repos
+//     (docs/marketplace-devx.md in the linea repo):
+//       lineadraw manifest [--dir <path>]   generate .lineadraw/marketplace.json
+//       lineadraw check    [--dir <path>]   validate + fail if the manifest is stale
+//       lineadraw init     [--dir <path>]   add the marketplace structure here
+//   * the BRIDGE: what the running Linea desktop app serves on
+//     127.0.0.1:7431 (docs/desktop-bridge.md) — `status`, `open`, `close`,
+//     `call`, `tools`. Reads the desktop's bridge.json for the port
+//     and the agent token; `--port` / `--token` / LINEA_BRIDGE_TOKEN override.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { isDeepStrictEqual } from "node:util";
+import { dirname, join, resolve } from "node:path";
+import {
+  buildManifest,
+  manifestJson,
+  MANIFEST_PATH,
+  verifyWithSdk,
+  withThumbnails,
+} from "../lib/manifest.mjs";
+import { init, tsconfigLibWarning } from "../lib/init.mjs";
+
+const USAGE = `Usage: lineadraw <command> [options]
+
+Marketplace repos (block / command collections):
+  manifest  [--dir <path>]   Validate all modules and write ${MANIFEST_PATH}
+  check     [--dir <path>]   Validate without writing; fail if the committed manifest is stale
+  init      [--dir <path>]   Add the marketplace structure to the current npm project
+
+manifest and check also dry-run every block through lineadraw/sdk and bake
+preview thumbnails into the catalog.
+
+Running editors (the Linea desktop app on 127.0.0.1:7431):
+  status                                app version, port, the open drawings (id, name, path, kind, dirty)
+  open <file.linea>                     open a file in a window of its own (returns its editor)
+  close [--editor <x>] [--discard]      close an editor like its window's x
+  call <operation> ['<json>'] [--editor <x>]
+                                        run one linea_* operation (see tools)
+  tools                                 the operations the bridge offers
+
+The desktop's bridge.json (port, agent token) is read automatically;
+LINEA_BRIDGE_TOKEN or --token override the token, --port the port.`;
+
+const args = process.argv.slice(2);
+const command = args[0];
+const dirFlag = args.indexOf("--dir");
+const dir = resolve(dirFlag === -1 ? "." : (args[dirFlag + 1] ?? "."));
+
+/** `--key value` / `--flag` after the command; the rest are positional. */
+const parseArgs = (argv) => {
+  const positional = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith("--")) {
+      const key = a.slice(2);
+      const next = argv[i + 1];
+      if (next !== undefined && !next.startsWith("--")) {
+        flags[key] = next;
+        i++;
+      } else flags[key] = true;
+    } else positional.push(a);
+  }
+  return { positional, flags };
+};
+
+// --- bridge --------------------------------------------------------------
+
+const APP_ID = "com.lineadraw.desktop";
+const DEFAULT_PORT = 7431;
+
+const bridgeFilePath = () => {
+  const home = homedir();
+  if (process.platform === "win32")
+    return join(
+      process.env.APPDATA ?? join(home, "AppData", "Roaming"),
+      APP_ID,
+      "bridge.json",
+    );
+  if (process.platform === "darwin")
+    return join(home, "Library", "Application Support", APP_ID, "bridge.json");
+  return join(
+    process.env.XDG_DATA_HOME ?? join(home, ".local", "share"),
+    APP_ID,
+    "bridge.json",
+  );
+};
+
+const readBridgeFile = () => {
+  const path = bridgeFilePath();
+  if (!existsSync(path)) return {};
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return {};
+  }
+};
+
+const bridge = (flags) => {
+  const file = readBridgeFile();
+  const port =
+    typeof flags.port === "string"
+      ? Number(flags.port)
+      : file.port || DEFAULT_PORT;
+  const token =
+    (typeof flags.token === "string" ? flags.token : undefined) ??
+    process.env.LINEA_BRIDGE_TOKEN ??
+    file.token;
+  const headers = { "content-type": "application/json" };
+  if (token) headers.authorization = `Bearer ${token}`;
+  return { base: `http://127.0.0.1:${port}`, headers };
+};
+
+const request = async (b, method, path, body) => {
+  let response;
+  try {
+    response = await fetch(`${b.base}${path}`, {
+      method,
+      headers: b.headers,
+      body: body === undefined ? undefined : JSON.stringify(body),
+    });
+  } catch (e) {
+    const cause = e?.cause?.code ?? e?.cause?.message ?? e?.message ?? e;
+    throw new Error(
+      `Nothing answers on ${b.base} (${cause}). Is the Linea desktop app running?`,
+      { cause: e },
+    );
+  }
+  const text = await response.text();
+  let parsed = text;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    // not JSON: keep the text
+  }
+  if (!response.ok) {
+    const error = parsed?.error;
+    throw new Error(
+      error?.message ?? `HTTP ${response.status}: ${text.slice(0, 200)}`,
+    );
+  }
+  return parsed;
+};
+
+const editorQuery = (flags) =>
+  typeof flags.editor === "string"
+    ? `?editor=${encodeURIComponent(flags.editor)}`
+    : "";
+
+const bridgeCommand = async (cmd, positional, flags) => {
+  const b = bridge(flags);
+  switch (cmd) {
+    case "status":
+      return request(b, "GET", "/status");
+    case "open": {
+      const file = positional[0];
+      if (!file) throw new Error("open needs a .linea file path");
+      return request(b, "POST", "/api/linea_open_editor", {
+        path: resolve(file),
+      });
+    }
+    case "close":
+      return request(
+        b,
+        "POST",
+        `/api/linea_close_document${editorQuery(flags)}`,
+        { discard: flags.discard === true },
+      );
+    case "call": {
+      const [operation, json] = positional;
+      if (!operation)
+        throw new Error("call needs an operation name (see `lineadraw tools`)");
+      const payload = json === undefined ? {} : JSON.parse(json);
+      return request(
+        b,
+        "POST",
+        `/api/${encodeURIComponent(operation)}${editorQuery(flags)}`,
+        payload,
+      );
+    }
+    case "tools": {
+      const reply = await request(b, "POST", "/mcp", {
+        jsonrpc: "2.0",
+        id: 1,
+        method: "tools/list",
+      });
+      return (reply.result?.tools ?? []).map((t) => ({
+        name: t.name,
+        description: t.description,
+      }));
+    }
+    default:
+      throw new Error(`Unknown command: ${cmd}\n\n${USAGE}`);
+  }
+};
+
+const BRIDGE_COMMANDS = ["status", "open", "close", "call", "tools"];
+
+const fail = (message) => {
+  console.error(message);
+  process.exit(1);
+};
+
+const reportProblems = (problems) => {
+  for (const p of problems)
+    console.error(`REJECTED ${p.file}: ${p.problems.join("; ")}`);
+};
+
+/** Validate everything (light + sdk dry-run); exits on failure. */
+const validatedManifest = async () => {
+  const { manifest: base, sources, problems } = buildManifest(dir);
+  const sdkResult = await verifyWithSdk(base, sources);
+  const all = [...problems, ...sdkResult.problems];
+  if (all.length > 0) {
+    reportProblems(all);
+    fail(`${all.length} problem(s) — nothing written.`);
+  }
+  const manifest = withThumbnails(base, sdkResult.thumbnails);
+  if (!sdkResult.ran)
+    console.warn(
+      `Blocks were not dry-run: lineadraw/sdk failed to load (${sdkResult.detail}). Try reinstalling lineadraw.`,
+    );
+  return manifest;
+};
+
+switch (command) {
+  case "manifest": {
+    const manifest = await validatedManifest();
+    const outPath = join(dir, MANIFEST_PATH);
+    mkdirSync(dirname(outPath), { recursive: true });
+    writeFileSync(outPath, manifestJson(manifest));
+    console.log(`${MANIFEST_PATH}: ${manifest.entries.length} entries`);
+    for (const e of manifest.entries)
+      console.log(`  ${e.kind}  ${e.id}  v${e.version}`);
+    break;
+  }
+  case "check": {
+    const manifest = await validatedManifest();
+    const committedPath = join(dir, MANIFEST_PATH);
+    // Compared as parsed JSON, not bytes: a formatter, a web edit or a CRLF
+    // checkout must not fail a manifest whose content is current.
+    let committed = null;
+    if (existsSync(committedPath)) {
+      try {
+        committed = JSON.parse(readFileSync(committedPath, "utf8"));
+      } catch {
+        committed = "unreadable";
+      }
+    }
+    if (!isDeepStrictEqual(committed, JSON.parse(manifestJson(manifest)))) {
+      const why =
+        committed === null
+          ? "missing"
+          : committed === "unreadable"
+            ? "not valid JSON"
+            : "stale";
+      fail(
+        `${MANIFEST_PATH} is ${why} — run \`npx lineadraw manifest\` and commit the result.`,
+      );
+    }
+    const libWarning = tsconfigLibWarning(dir);
+    if (libWarning !== null) console.warn(`warning: ${libWarning}`);
+    console.log(`OK: ${manifest.entries.length} entries, manifest is current.`);
+    break;
+  }
+  case "init": {
+    try {
+      const { created, skipped, warnings } = await init(dir);
+      for (const f of created) console.log(`created  ${f}`);
+      for (const f of skipped) console.log(`kept     ${f}`);
+      for (const w of warnings) console.warn(`warning  ${w}`);
+      console.log(
+        "\nDone. Commit, push, then add the repo in the editor: Library → Marketplace.",
+      );
+    } catch (e) {
+      fail(e instanceof Error ? e.message : String(e));
+    }
+    break;
+  }
+  default: {
+    if (!BRIDGE_COMMANDS.includes(command)) fail(USAGE);
+    const { positional, flags } = parseArgs(args.slice(1));
+    try {
+      const result = await bridgeCommand(command, positional, flags);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (e) {
+      fail(e instanceof Error ? e.message : String(e));
+    }
+  }
+}