Design: trip2g-preview (watch) + memcli instance isolation

Location & shape

• File: scripts/trip2g-preview.mjs, #!/usr/bin/env node, plain ESM, no build step, no third-party deps (uses built-in fetch, node:fs, node:crypto only).
• Run: node scripts/trip2g-preview.mjs … (or directly if executable).
• A sibling test file scripts/trip2g-preview.test.mjs run via node --test.

CLI surface (arg names kept 1:1 with renderlayout.py)

trip2g-preview [--watch]
  (--layout-file <path> | --layout-path <serverpath>) [--layout-src <inline>]
  [--note-path <p> | --note-file <p> | --note-src <text>]
  [--api-url <url>] [--api-key <key>] [--folder <vault>] [--open] [--fetch]

New vs renderlayout.py: --watch, --open. Everything else is identical so existing muscle memory and docs carry over.

Config resolution — resolveTarget()

Priority for apiUrl / apiKey:

1. --api-url / --api-key flags
2. env TRIP2G_API_URL / TRIP2G_API_KEY
3. .obsidian/plugins/trip2g/data.json (syncDirs[0].apiUrl / .apiKey), found by walking up from --folder (default cwd) — same logic as renderlayout.py's find_config.

apiUrl is the server base (e.g. http://localhost:24081); requests go to ${base}/_system/renderlayout. No API key resolvable → exit 1 with: no API key — run \memcli up` or pass --api-key`.

Payload builder — buildPayload()

Pure function producing the RenderLayoutInput body:

{ "layout": { "path": "<layout-path>", "src": "<optional inline/file contents>" },
  "note":   { "path": "<note-path>" } | { "src": "<note markdown>" } }

Rules (mirroring renderlayout.py): --layout-file implies layout.path = "/" + file (unless --layout-path given) and layout.src = <file contents>; note is path xor src xor a file; if no note flag, omit note (server uses a stub).

Behavior

One-shot (no --watch):

1. resolveTarget() → buildPayload() → POST ${base}/_system/renderlayout with X-API-Key.
2. Print warnings.layout entries to stderr; print the full ${base}${previewURL} to stdout.
3. --fetch → GET the preview and print HTML to stdout instead of the URL.
4. Exit 1 if warnings.layout non-empty or the response carries error (parity with renderlayout.py).

Watch (--watch):

1. Require --layout-file (need a local file to watch); else exit 1 with a clear message.
2. Initial render (POST). Print the live URL prominently: ${base}/_system/renderlayout?live. --open → xdg-open/open/start it.
3. fs.watch(layoutFile) (watch the parent dir too, since many editors replace-on-save); debounce ~200 ms; on change re-read the file, re-POST.
4. Each render prints one status line: HH:MM:SS ok or HH:MM:SS N warning(s) plus the warning text. The server's ?live long-poll reloads the browser on each new version — no extra wiring.
5. SIGINT (Ctrl-C) → clean exit.

Error handling

Doc / reference updates

• Rewrite the "CLI tool" and "Live preview with file watcher" sections of docs/en/user/renderlayout.md (+ docs/ru/user/renderlayout.md) to use trip2g-preview --watch instead of renderlayout.py + watchexec.
• Update docs/skills/check_templates.md reference.
• Update docs/dev/local_design_iteration.md Loop A to use trip2g-preview.
• Remove scripts/renderlayout.py.

Changes

• Flags gains name?: string; parseArgs parses --name <id>.
• New containerName(flags):
  • flags.name → trip2g-memory-${sanitize(flags.name)} (sanitize to docker-safe [a-zA-Z0-9_.-])
  • else → trip2g-memory (unchanged)
• Replace the CONTAINER_NAME const at every use site — cmdUp (docker run --name, the "already running" ps --filter, start/skip log), cmdDown (stop/rm), cmdStatus (ps --filter), cmdLogs (docker logs), cmdKey if it touches the container.
• Port: --port stays (default 24081). Before docker run, cmdUp checks whether the port is already bound; if so, exit with: port <p> busy — pass --port for this instance. (No auto-pick: keep the printed URL predictable.)
• Per-vault state (<vault>/.trip2g-memory/, data.json) is already isolated by --folder; no change.
• Help text + docs/en/user/memcli.md (+ ru) document: a second instance needs both --name and --port, and down/status/logs/key take the same --name.