by adom
The one-stop-shop for publishing a hardware component (or molecule/board) to the Adom Wiki. The whole lifecycle: page anatomy, the clone→edit→preview→push loop and its hard rules, making a great hero image (Hero Component Studio — 16:10, overlay-safe, datasheet-backed), the animated 3D composite, the interactive 3D viewer, ct thumbnails, the datasheet-accuracy audit, and every wiki push/pull gotcha we've hit. Now includes the worked Path B (board) pipeline: STEP-to-GLB, refdes tagging, layer de-
Visibility default: match the board (public unless the board is private), not a hard --private #2
Default visibility for pages made with this skill becomes match the board: public unless the board is private, instead of a hard --private.
Why: the intro said "Private / Adom-only, visibility private" and the publish recipe hard-coded --private, so every part page built with it came out private regardless of its board. That is how 66 of Ray's connectors, resistors and caps (and 34 of Barrett's) are private on the org today, and why public pages now link to private components (Colby, Components channel, 2026-09-18). Rule 6 already said inherit the board's visibility — but only in the private direction.
Changes (three spots, nothing else touched):
- Intro note: published under the org, visibility matches the board; standalone parts public;
--privateonly for parts of a private board. - Publish recipe:
--publicis the shown default,--privateannotated as the private-board case. - Rule 6: stated both ways, plus "when a board is flipped public later, flip its library and parts with it" — a part used by any public board or molecule is public.
Built on top of #1 (the laser-etch section) so the file is a superset: merging #1 then #2, or #2 alone, both leave the page right. Merging #2 then #1 would revert this change, so please take #1 first or skip it.
🤖 Generated with Claude Code
Diff Skip to comments
@@ -1,1279 +1,1302 @@⋯ 27 unchanged lines ⋯ > section, bump the version, and open a PR against `adom/adom-hardware-component-publish`. Never > re-solve a problem that's already written here. -> **Private / Adom-only.** Published under the `adom` org, visibility private.+> **Published under the `adom` org. Visibility MATCHES THE BOARD: public unless the board the+> part hangs off is private.** A standalone component page (no board) is public. The old text+> here said "visibility private" for everything, and that is how 66 connectors, resistors and+> caps ended up private on the org with public pages depending on some of them (2026-09-18).+> `--private` is for parts of a private board, never a default. > **First decide which kind of page you're making** — a single **COMPONENT** (Path A) or a full > **BOARD / MOLECULE** (Path B). The required contents differ (see "Two kinds of page" below). On a⋯ 283 unchanged lines ⋯ # --- NEW page: scaffold + publish --- adom-wiki pkg init <slug> --type component-adom-wiki pkg publish --org adom --private -m "<changelog>" # from the pkg dir+adom-wiki pkg publish --org adom --public -m "<changelog>" # from the pkg dir; default+adom-wiki pkg publish --org adom --private -m "<changelog>" # ONLY for a part of a PRIVATE board (rule 6) ``` **Verify a pushed asset authenticated** (private pages 403 unauthenticated — see 8h):⋯ 150 unchanged lines ⋯ (~4e-5) — inverse-square blows the board white at 0.3. Parent the light to `<MPN>` so it rides the animation. Red light on a green FR4 board reads warm/orange (green absorbs red — physics). - **Emissive brightness:** boost with `KHR_materials_emissive_strength`.-- **Side embossing (part number/value):** cadquery boolean-cut the text into the STEP; auto-fit the- font to the measured width×height taper so the whole string fits off the terminations.+- **Part number on the die — use the service, not a local cadquery cut.** `service-occt`+ `/laser-etch?name=<MPN>&mode=flat` (Ray's container `occt-fbnsqrdkehdj.adom.cloud`, 1.3.8+; POST+ the STEP, 202 + job, poll `/jobs/<id>`, download `/result`) fits the text to the largest usable+ upper face, avoids the pin-1 keep-out, compares 0/90 degrees and keeps the marking in a toggleable+ `Adom.LaserEtch` group, so the etched STEP is a superset of the plain body. ~6 s, no model tokens.+ Every factory component page ships `<stem>-etched.step` / `<stem>-etched.glb` as `model_3d` /+ `model_3d_step` with the bare body kept as `*_plain` (the wiki's `/viewer/3d` renders whatever+ `parts.model_3d` names). Since 2026-09-17; the 14k older pages are being backfilled the same way.+- **Hero pose for an etched part:** render with `pose=iso-front` (+X,−Y,+Z, the wiki viewer's own+ camera). `iso` and `iso2` look from behind (+Y), so a 0-degree mark (every 2-terminal passive)+ reads upside-down in the hero while it is upright in the viewer. The `step2glb` CLI predates the+ pose; call `/thumbnail?pose=iso-front&width=&height=` on the service directly.+- **Side embossing (part number/value), when you need it on a side face:** cadquery boolean-cut the+ text into the STEP; auto-fit the font to the measured width×height taper so the whole string fits+ off the terminations. - **Colouring a re-tessellated (embossed) mesh:** transfer material per-triangle by **densified nearest-neighbour** from the original colour GLB (a plane split only works for a clean 2-material boundary; 3-material parts need densified NN or you get zigzag artifacts).⋯ 268 unchanged lines ⋯ depender publishes. Merge everything *before* the board's publish so the cycle produces exactly one registry version. MERGE deps, never overwrite (`component`, `hero`, `tags`, `model_3d_path` must survive).-6. **Inherit the board's visibility.** A private board's library and component pages are published- **`--private` to the same org** — a public part page hanging off a private board leaks the design.+6. **Match the board's visibility, both ways.** A private board's library and component pages are+ published **`--private` to the same org** — a public part page hanging off a private board leaks+ the design. A public board's parts are **public**, and a part used by any public board or molecule+ is public even if it also sits on a private one (the public page already names it). When a board+ is flipped public later, flip its library and parts with it: a public board linking to private+ parts is the failure this rule exists to prevent, seen from the other side. **Completion checklist (a Path B publish is NOT done until all pass):** ⋯ 518 unchanged lines ⋯ Hit a new wiki issue, a viewer quirk, or a better hero recipe? Add it to the right section (usually §8 gotchas, §3 hero, or §4 composite), bump the version, and open a PR against `adom/adom-hardware-component-publish`. Keep findings **specific and cited**.+
Comments
Log in to comment.
No comments yet.