lineadraw 0.4.0 → 0.6.0

package/README.md

@@ -1,13 +1,15 @@
 # lineadraw
 
-Type definitions and marketplace tooling for [Linea](https://lineadraw.com)
-blocks and commands — the one devDependency a block/command repository
-needs. Zero runtime: your modules import types from `"lineadraw"`, and the
-Linea editor provides the real implementation when it runs them.
+[Linea](https://lineadraw.com) for Node: the headless drawing SDK, the
+typings for blocks and commands, and the marketplace CLI — the one
+dependency a script, an agent, or a block/command repository needs.
 
 - **Typings** — `lineadraw.d.ts` makes `import { defineBlock } from
   "lineadraw"` and `import { … } from "lineadraw/helpers"` type-check in
   any editor/CI, with parameter types inferred into your `draw` function.
+- **SDK** — `import { openDrawing } from "lineadraw/sdk"`: open, edit,
+  render and export `.linea` documents headlessly
+  ([below](#headless-sdk-lineadrawsdk)).
 - **CLI** — `lineadraw manifest | check | init` turns any repository into
   a Linea **marketplace**: a git repo the editor can browse and install
   blocks/commands from.
@@ -65,10 +67,40 @@ pull them along); `paramVisibility({ params })` hides property rows;
 `previewInputs` curates the inputs used for thumbnails. Units are
 millimeters, Y-up, angles in radians CCW.
 
+Parameter types (the same rows serve a command's `params`):
+
+- `number` — `min`/`max`, `integer`, `step`, `prefix`/`suffix` ("1:",
+  "mm"), `presets` (standard values in the field's dropdown).
+- `string` — `placeholder`, `multiline`, `presets`.
+- `boolean` (`display: "toggle"` — a toggle button showing the label,
+  compact in a row), `enum` (`options`, each optionally with a `swatch:
+  "#rrggbb"` color square; `display: "buttons"` — a segmented toggle group
+  for short choices, falling back to a dropdown when it doesn't fit),
+  `color` (`"#rrggbb"`, `presets` = a palette).
+- `numberList` (`number[]`, typed Tekla-style: `"0 2*7200"` →
+  `[0, 7200, 7200]`) and `stringList` (`string[]`: `'A "B 2"'` →
+  `["A", "B 2"]`), both with `presets` and `placeholder` (shown while
+  empty).
+- Pickers over the document's resources, valued by id / name:
+  `textStyle`, `dimStyle`, `font`, `lineType`, `hatchPattern`.
+- `label` — a section heading (no value); `row` — 2–3 compact params on one
+  panel row (`items`, each label a short prefix like "W"); its items are
+  ordinary flat params (`params.w`).
+
+Every param may carry a `hint` (the label's tooltip). An instance that
+overrides a param shows "Reset" beside it in Properties, back to your
+default. `draw` also receives
+`styles`: `styles.text(id)` / `styles.dim(id)` give a document style (an
+empty or unknown id → the first), for blocks that lay out with real text
+sizes.
+
 ## Writing a command
 
 A command is a macro with a single `defineCommand` default export. Its
-whole run is one undo step; Esc during a pick reverts cleanly.
+whole run is one undo step; Esc during a pick reverts cleanly. A
+`params` table (the same rows a block's `params` uses) is asked for in a
+dialog before the run and arrives typed as `ctx.params`; headless callers
+pass it by name.
 
 ```ts
 // commands/circle-here.cmd.ts
@@ -95,13 +127,24 @@ helpers) — the editor resolves both when executing your module.
 lineadraw manifest   Validate all modules and write .lineadraw/marketplace.json
 lineadraw check      Validate without writing; fail if the committed manifest is stale
 lineadraw init       Add the marketplace structure to the current npm project
+
+lineadraw status     Is the Linea desktop app serving agents? port, open editors
+lineadraw editors    The open drawings: id, name, path, kind, dirty
+lineadraw open <file.linea>            Open a file in a new window
+lineadraw close [--editor <x>] [--discard]
+lineadraw call <operation> ['<json>'] [--editor <x>]   Run one linea_* tool
+lineadraw tools      The operations the bridge offers
 ```
 
+The bridge commands talk to the running Linea desktop app on
+`127.0.0.1:7431` (the app's `bridge.json` supplies the port and the agent
+token; `--port`, `--token` and `LINEA_BRIDGE_TOKEN` override) — see
+docs/desktop-bridge.md in the linea repo.
+
 The manifest is deterministic (repo-relative paths, no git metadata), so
 `check` is a byte-for-byte diff — the included CI workflow runs it on every
-push and PR. With `@lineadraw/sdk` installed as a devDependency,
-`manifest`/`check` additionally **dry-run every block** and render
-thumbnails; without it the CLI still fully works.
+push and PR. `manifest`/`check` also **dry-run every block** through
+`lineadraw/sdk` and render thumbnails.
 
 Collection name and owner come from your package.json:
 
@@ -111,14 +154,179 @@ Collection name and owner come from your package.json:
 
 ## Using a marketplace in the editor
 
-In [the editor](https://lineadraw.com): **Library → Marketplace tab → +**
-and enter `owner/repo` (or `owner/repo@branch`). For a private repository,
+In [the editor](https://lineadraw.com): **Library → Marketplace tab → the
+gear button (Manage marketplaces…) → Add a marketplace** and enter
+`owner/repo` (or `owner/repo@branch`). For a private repository,
 create a fine-grained personal access token with read-only Contents access
 to just that repository and paste it in the add dialog — it is stored only
 on that device. Installing embeds the module (and its declared dependency
 closure) in the document, so drawings keep working offline and travel with
 the file.
 
+## Headless SDK (`lineadraw/sdk`)
+
+A script-friendly API over the Linea CAD kernel: open, create, query, edit,
+render, and import/export `.linea` documents headlessly in Node — no browser,
+no server. Built for agents, CLIs, and batch tooling.
+
+```bash
+npm i lineadraw
+```
+
+```js
+import { newDrawing, openDrawing } from "lineadraw/sdk";
+
+const doc = newDrawing();
+const walls = doc.addLayer({ name: "walls", color: "#e8e8e8", lineWidth: 0.5 });
+doc.add([
+  { type: "polyline", layerId: walls, closed: true,
+    points: [[0, 0], [6000, 0], [6000, 3000], [0, 3000]] },
+  { type: "dimension", points: [[0, 0], [6000, 0]], offset: [0, -500],
+    scale: 50 },                                 // annotations × drawing scale
+]);
+doc.createLayout("Plan 1:50", { sheet: "A3", viewport: { scale: "1:50" } });
+await doc.exportPng("check.png", { width: 1600 });  // verify by LOOKING at it
+await doc.save("plan.linea");
+await doc.exportPdf("plan.pdf");
+```
+
+### Conventions (read once, avoid every common bug)
+
+- **Units are millimeters, Y-up. Angles are radians CCW** — everywhere in the
+  object model and in `rotate()`. Draw 1:1 (a 6 m wall is 6000 mm); paper
+  scale lives in layout viewports (`"1:50"` strings via `parseScale`).
+- **Never write `.linea` JSON by hand.** Every mutation goes through
+  kernel-validated ops (`add`/`update`/`remove`/transforms); invalid input
+  throws with the failing object and field named.
+- **Style by layer**: unset `color`/`lineWidth`/`lineType` on objects inherit
+  from the layer. Layer names are unique (`addLayer` throws on duplicates)
+  and can be used instead of ids (`layer: "walls"`, query filters). Note:
+  `locked` layers are an editor-UI concept — the SDK does not block edits.
+- **Layer `print: false`** (plot flag) keeps a layer visible on screen and in
+  SVG/PNG but excludes it from PDF output — construction/guide layers.
+- **Opacity is byLayer too**: `opacity` (0..1) on a layer is the default for
+  its objects; an object's own `opacity` overrides it. Paints across canvas,
+  SVG, and PDF; DXF/DWG export drops it (no direct mapping).
+- **Annotation scale is per-object**: for a 1:N drawing set the top-level
+  `scale: N` on text, dimensions, and hatches, keeping `textHeight` at
+  paper size (2.5 body / 3.5 / 5 titles). `scale` is NOT a `styleOverride`
+  key; `add`/`update` reject it there.
+- **Reads are detached snapshots**: `doc.document`, `doc.objects`,
+  `getObject`, `query()` return deep clones — mutating them does nothing.
+- **New documents are layout-less**; `exportPdf` of a layout-less document
+  falls back to one auto-fitted A3 page.
+- `transaction(fn)` groups edits into one undo step. `array(ids, count,
+  delta)`: `count` INCLUDES the originals; the returned ids are the copies.
+- An arc with `startAngle === endAngle` renders as a full circle.
+- There is no rectangle type — use a closed 4-point polyline.
+
+### API surface
+
+`newDrawing(name?)` / `drawingFromJson(text)` / `openDrawing(path)` → `Drawing`:
+
+- **Name**: `drawing.name` is the file name (set on `openDrawing`, updated
+  by `save(path)`); `newDrawing(name)` names it until it is saved. The
+  `.linea` JSON itself carries no name.
+
+- **Read**: `summary()`, `objects`, `layers`, `layouts`, `getObject`,
+  `query({ids, type, layer, color, lineType, content, bbox, inside, near, layout})`,
+  `measure(id)` (`bboxOf(ids)`, `length(id)`, `area(id)`), `listLayers()`,
+  `listLayouts()`, `listBlocks()`, `listCommands()`, `revision`
+- **Edit**: `add(objects, {layout?})`, `update(ids, patch)` or
+  `update([{id, ...patch}])`, `remove(ids)` (→ count), `reorder(ids,
+  "front" | "back" | {above} | {below})`, `transaction(fn)` (sync or async;
+  a throw rolls back), `undo()`, `redo()`, `setDimStyle`,
+  `setTextStyle`, `applyOps(ops)`, `ready()`
+- **Modules**: `await installBlocks(sources)` / `removeBlock(id)`,
+  `await installCommands(sources)` / `removeCommand(id)`,
+  `await setBlockDefinitions(sources)`, `await setCommands(sources)`
+- **Scripts**: `await runScript(source, inputs?, params?)` runs a
+  `defineCommand` module (the same one the editor palette runs) headlessly
+  as ONE undo step — its declared `inputs` (points) are supplied up front,
+  its declared `params` by name (`{ count: 3 }`; omitted ones take their
+  defaults, unknown names and wrong types throw); `runCommand(id, inputs?,
+  params?)` runs one of the document's own commands. Returns the script's
+  return value.
+- **Layers**: `addLayer`, `updateLayer(nameOrId, patch)`,
+  `removeLayer(nameOrId)` (must be empty and not current),
+  `reorderLayers(order)`, `setCurrentLayer(nameOrId)`
+- **Assets**: `addAsset(dataUrl) → assetId` (for `image` objects;
+  content-keyed), `removeAsset(id)` (refused while referenced)
+- **Transform**: `move`, `rotate` (radians), `scale`, `mirror`, `copy`, `array`
+- **Layouts**: `createLayout(name, {sheet, scale, viewport, index})`,
+  `updateLayout(nameOrId, {name, sheet, printPalette})`, `removeLayout`,
+  `reorderLayouts`, `parseScale("1:50")`. `sheet` is `"A3"` (landscape when
+  creating, the current orientation when patching), `{ name: "A3",
+  orientation: "portrait" }`, or `{ width, height }` in mm.
+- **Export**: `renderSvg`/`exportSvg`, `renderPng`/`exportPng`, `await toDxf()`/`exportDxf`,
+  `toDwg`/`exportDwg` (DWG R2000–2018, default AC1027), `renderPdf`/`exportPdf`,
+  `toJson`/`save`
+- **Import (merge)**: `importDxf(path)`/`importDxfText(text)` (with
+  `unitOverride`), `importDwg(path)`/`importDwgData(bytes)` (DWG R13–R2018),
+  `importPdfData(arrayBuffer)`
+
+Full parameter docs are in the bundled `dist/index.d.ts` JSDoc.
+
+### Object types
+
+`line` (a, b) · `polyline` (points with optional bulge, closed) · `circle` ·
+`arc` (CCW start→end) · `ellipse` (center, majorAxis vector, ratio) ·
+`hatch` (loops — outer + holes, even-odd; fill solid/pattern/lines) ·
+`text` (position, content; **default alignment center/center**; optional
+leaderLines with the arrowhead at index 0) · `dimension` (linear/angular/
+radial/diameter; `offset` is a vector from points[0] to the dimension line;
+linear with >2 points = chain) · `block` (instances of script definitions) ·
+`viewport` (layouts only) · `image` (placement of an asset).
+
+### Block scripts
+
+`document.blockDefinitions` is an array of ES-module **source strings**
+(`await doc.setBlockDefinitions([...sources])` — async so the script
+transpiler is loaded and block geometry is definitive when it resolves).
+A block is one `defineBlock` call:
+
+```ts
+import { defineBlock } from "lineadraw";
+import { polar, add } from "lineadraw/helpers";      // vector-math helpers
+
+export default defineBlock({
+  id: "chair",                                   // instances reference this
+  name: "Chair",
+  params: [{ name: "width", type: "number", default: 450 }],
+  draw: ({ params }) => [
+    // Plain object DTOs in block-local coordinates; params.width: number.
+    { type: "line", a: { x: 0, y: 0 }, b: { x: params.width, y: 0 } },
+  ],
+});
+```
+
+Optional members: `place` — an array of point labels (one pick per label)
+or an interactive `({ params, pickPoint, pickObject })` function run once
+at insertion (default is one insertion point) — and
+`paramVisibility({ params })` (hides property rows). `params` may be the
+table literal or a zero-arg function returning it. Imports are limited to
+`"lineadraw"` and `"lineadraw/helpers"`. The instance's first point input
+is its pivot: `draw` sees inputs localized to it, and instance
+`rotation`/`scale` apply about it. (Plain named exports — incl. the
+pre-rename `main`/`defineInput` names — remain evaluatable as the frozen
+wire form.)
+
+### Interchange notes
+
+- DXF/DWG export flattens semantics: block instances are exported as their
+  evaluated geometry (no `INSERT` reuse) and `image` objects are skipped
+  (DXF images reference external files). The export result reports both in
+  `skipped`.
+- PDF import extracts vector strokes and text runs (dimensions arrive as
+  exploded geometry). pdf.js loads lazily on first use, as do the PNG
+  rasterizer (native resvg) and the DWG transcoder (bundled WebAssembly).
+- `renderSvg({ bbox })` culls objects outside the box (they are absent from the
+  file, not merely outside the viewBox).
+- Opening a document written by a NEWER Linea version throws instead of
+  loading lossily.
+- Dimensions validate their point counts per kind (linear ≥ 2, angular ≥ 3,
+  radial/diameter ≥ 2).
+
 ## Ecosystem
 
 - [Linea editor](https://lineadraw.com) — the browser CAD app that runs
@@ -126,8 +334,5 @@ the file.
 - [`lineadraw/lineadraw`](https://github.com/lineadraw/lineadraw) — the
   public collection: real blocks/commands to learn from, agent skill, and
   guides.
-- [`@lineadraw/sdk`](https://www.npmjs.com/package/@lineadraw/sdk) —
-  headless Node API over the same kernel (open/edit/render/export
-  `.linea` documents; also powers the CLI's block dry-runs).
 - [`@lineadraw/mcp`](https://www.npmjs.com/package/@lineadraw/mcp) — MCP
   server with the full editor as an in-chat app.

package/bin/lineadraw.mjs

@@ -1,98 +1,278 @@
 #!/usr/bin/env node
-// The `lineadraw` CLI — marketplace tooling for Linea block/command repos.
-//   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
-// See docs/marketplace-devx.md in the linea repo for the design.
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import {
-  buildManifest,
-  manifestJson,
-  MANIFEST_PATH,
-  verifyWithSdk,
-} from "../lib/manifest.mjs";
-import { init } from "../lib/init.mjs";
-
-const USAGE = `Usage: lineadraw <manifest|check|init> [--dir <path>]
-
-  manifest  Validate all modules and write ${MANIFEST_PATH}
-  check     Validate without writing; fail if the committed manifest is stale
-  init      Add the marketplace structure to the current npm project
-
-With @lineadraw/sdk installed (devDependency), manifest and check also
-dry-run every block. The manifest content is identical either way.`;
-
-const args = process.argv.slice(2);
-const command = args[0];
-const dirFlag = args.indexOf("--dir");
-const dir = resolve(dirFlag === -1 ? "." : (args[dirFlag + 1] ?? "."));
-
-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 + optional sdk dry-run); exits on failure. */
-const validatedManifest = async () => {
-  const { manifest, sources, problems } = buildManifest(dir);
-  const sdkResult = await verifyWithSdk(dir, manifest, sources);
-  const all = [...problems, ...sdkResult.problems];
-  if (all.length > 0) {
-    reportProblems(all);
-    fail(`${all.length} problem(s) — nothing written.`);
-  }
-  if (!sdkResult.ran)
-    console.warn(
-      "The contents of blocks/commands were not dry-run because @lineadraw/sdk is not installed. Install it as a devDependency to enable this check.",
-    );
-  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.`,
-      );
-    console.log(
-      `OK: ${manifest.entries.length} entries, manifest is current.`,
-    );
-    break;
-  }
-  case "init": {
-    try {
-      const { created, skipped } = init(dir);
-      for (const f of created) console.log(`created  ${f}`);
-      for (const f of skipped) console.log(`kept     ${f}`);
-      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:
-    fail(USAGE);
-}
+// 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));
+    }
+  }
+}