Adom TSCI - Tscircuit Board Viewer

@@ -35,20 +35,6 @@ npm registry, and a secondary **tsci live** tab (the raw tscircuit RunFrame, served through a slingshot proxy) for features the primary UI hasn't wrapped. --## Displaying this app (REQUIRED — read before showing anything)--To SHOW a board, use `adom-tsci open` (it attaches the proper Hydrogen webview panel itself); for a pup surface follow the `pup` skill.-- **NEVER open this app in VS Code's "Simple Browser"** — that is NOT what "webview" means-  in the Adom ecosystem. Simple Browser has no live channel, no console read-back, and no-  AI drivability; using it is a bug.-- The Adom surfaces for showing an app are: **wv** — a Hydrogen webview panel (load the-  `webview` skill from adom-workspace-control and follow it; inside HD this is HD's pane-  tab), **pup** — a pup window (`pup` skill), **nb** — the user's real signed-in browser (Adom browser-  extension), and **hdbw** — HD's standalone built-in Tauri browser window-  (picker: "HD Browser Window", destination id `webview-window`, only under Hydrogen-  Desktop). Pick per the situation; Simple Browser is NEVER one of them.- ## 🛡 INVARIANTS — audit BEFORE every change to nearby code  These are user-confirmed behaviours that have already regressed at least@@ -132,6 +118,7 @@ Quick-reference table — the subcommand you want is probably here: | Read the browser console | `adom-tsci console [--follow] [--tail N] [--level log,warn,error]` | | Health / status | `adom-tsci health [--port <N>]`, `adom-tsci status [--port <N>] [--json]` | | Upgrade tscircuit packages in the target project | `adom-tsci upgrade [<dir>]` |+| Export fab/EDA files (KiCad zip, .kicad_pcb, gerbers, STEP, netlist) | `adom-tsci export --format <kicad-zip\|kicad-pcb\|gerbers\|step\|readable-netlist> [--project DIR] [--output PATH]` |  Every write-mutation targeting the preview has `--port <N>` if you need to target a specific instance; defaults to 8850.@@ -697,17 +684,19 @@ command -v bun >/dev/null || curl -fsSL https://bun.sh/install | bash export PATH="$HOME/.bun/bin:$PATH"  # 2. adom-tsci binary + skill-sudo curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-tsci/adom-tsci \+sudo curl -fsSL https://wiki.adom.inc/api/pages/adom/adom-tsci/releases/latest/download/adom-tsci?platform=linux \   -o /usr/local/bin/adom-tsci && sudo chmod +x /usr/local/bin/adom-tsci && \   adom-tsci install -# 3. Get a project. If you don't have one yet, clone the example repo:-#    (skip if you already have a tscircuit project)-git clone https://github.com/adom-inc/adom-tsci.git-cd adom-tsci/examples/SN65HVD230-Molecule && bun install+# 3. Get a project. If you don't have one yet, pull the pre-built examples+#    bundle from the wiki release (no GitHub access needed; skip if you+#    already have a tscircuit project):+curl -fsSL "https://wiki.adom.inc/api/pages/adom/adom-tsci/releases/latest/download/adom-tsci-examples.tgz?platform=any" \+  | tar xz+cd examples/SN65HVD230-Molecule && bun install  # 4. CRITICAL: adom-tsci start refuses to create its webview tab unless an-#    existing webview pane is already present ("no existing webview pane+#    existing Web View pane is already present ("no existing Web View pane #    found" error). If the layout is a single VS Code pane, split one: VSCODE_PANEL_ID=$(adom-cli hydrogen workspace tabs \   | python3 -c 'import json,sys; [print(t["panelId"]) for t in json.load(sys.stdin)["tabs"] if t["name"]=="Visual Studio Code"]' \@@ -716,9 +705,9 @@ adom-cli hydrogen workspace split \   --panel-id "$VSCODE_PANEL_ID" \   --direction horizontal \   --panel-type adom/a1b2c3d4-0031-4000-a000-000000000031 \-  --display-name "Webview" --display-icon "mdi:web" --ratio 0.5+  --display-name "Web View" --display-icon "mdi:web" --ratio 0.5 -# 5. Start the preview — auto-opens a tab in the webview pane above.+# 5. Start the preview — auto-opens a tab in the Web View pane above. adom-tsci start .  # 6. If the pane ever gets closed (e.g. after an approval-dialog cancel@@ -735,7 +724,7 @@ adom-tsci start . adom-tsci stop ``` -**webview panel UUID (for reference):** `adom/a1b2c3d4-0031-4000-a000-000000000031`.+**Web View panel UUID (for reference):** `adom/a1b2c3d4-0031-4000-a000-000000000031`. Every split that lands the adom-tsci tab needs this `--panel-type`.  ### Moving or renaming a project directory — don't rebuild@@ -1047,6 +1036,7 @@ Every command follows the Adom CLI conventions (`OK:` / `ERROR:` / | `adom-tsci reload` | Force the 3D / PCB / Schematic tabs to re-poll the build outputs | | `adom-tsci rerun [--clean]` | Re-run the tscircuit autorouter (optionally deleting `manual-edits.json`) | | `adom-tsci upgrade [dir]` | `bun update --latest` in the target tscircuit project |+| `adom-tsci export --format <F>` | Fab/EDA export via tsci with the `--output` path quirk handled: `kicad-zip` (KiCad 7/8 project), `kicad-pcb`, `gerbers`, `step`, `readable-netlist`. Writes `<project>/<name>.<ext>` by default | | `adom-tsci health` | Probe `tsci_reachable` | | `adom-tsci install` | Drop `SKILL.md` into `~/.claude/skills/adom-tsci/` | | `adom-tsci --version` | Print version |@@ -1187,11 +1177,11 @@ curl -sS -X POST http://127.0.0.1:8850/shutdown  ## Troubleshooting -**`Error: no existing webview pane found`**+**`Error: no existing Web View pane found`** `adom-tsci start` will refuse to create its tab over a non-webview pane. See step 4 of the Zero-to-preview section above for the exact `workspace split` command — it needs `--panel-type-adom/a1b2c3d4-0031-4000-a000-000000000031`. Once a webview pane+adom/a1b2c3d4-0031-4000-a000-000000000031`. Once a Web View pane exists, re-run `adom-tsci start`, or `adom-tsci open` if the server is already running. @@ -1433,7 +1423,7 @@ guide at `~/.claude/skills/adom/guides/adom-tscircuit-skill.md`.   the page's `<link rel="icon">` overrides any `--display-icon` placeholder). - **Basic3dView:** `~/.claude/skills/adom/guides/basic-3d-viewer.md`   — the Adom Babylon viewer used in the 3D compare tab's left pane.-- **webview panel API:** `~/.claude/skills/adom/webview/SKILL.md`.+- **Web View panel API:** `~/.claude/skills/adom/webview/SKILL.md`. - **Adom brand guide:** `~/.claude/skills/adom/guides/brand/SKILL.md`   — all icons must be monochrome `#e6edf3`, the chip favicon follows   this rule.