by adom
How the Adom Wiki (wiki.adom.inc) works and how to drive it with the adom-wiki CLI: the two storage layers (git page repo vs package registry), hosting source by pushing files (not a tarball), making packages, cutting per-platform releases, and the three-tier skill layout (user skills ship, dev-skills/ and publish-skills/ stay source-only). adom-wiki is the current tool; adompkg is deprecated.
Adom parts: show the Adom part number and Adom's own stock from page data (component.adom)
What's wrong
On an Adom part's page, for example adom/machinepinlargeshort:
- Adom # shows the page's public id (
pg_pka18p6q12), not the part number. - Stock shows the "Check stock and price" button, which only asks DigiKey and Mouser. For our own parts, Adom's stock is the number that matters, and it shouldn't take a click.
What we want, for Adom-made parts (machine pins, machine contacts, molecules) and Adom basic parts (what we stock on the PnP line):
- The Adom part number shows in the sidebar and anywhere else the page names the part.
- Adom's stock shows already filled in from the page data, with its date. Distributor rows can keep the Check button.
Field contract (the data side is ours)
The factory and Component Ocean will write this block into page.json and package.json (component.adom) and keep it current without a click:
"component": {
"adom": {
"part_number": "MachinePinLargeShort",
"kind": "adom-made",
"stock": 1200,
"stock_as_of": "2026-11-02T20:00:00Z",
"source": "pnp-inventory",
"location": "Bin-C7"
}
}
| field | meaning |
|---|---|
part_number |
the number Adom uses for the part. For an Adom-made part that's its MPN (MachinePinLargeShort); for a basic part, the MPN the inventory stocks it under. Never the page id. |
kind |
adom-made or adom-basic |
stock |
units on hand, an integer; null when no count is recorded (show "not tracked", not 0) |
stock_as_of |
when that count was read, ISO 8601 UTC |
source |
where the count comes from; today always pnp-inventory (inventory-2w8z8d9ojzzl.adom.cloud) |
location |
shelf or bin when the inventory has one, optional |
The block is absent on every other part, so the current behaviour stays as it is there.
Asks for the wiki
- When
component.adomis present: showpart_numberas Adom #, in the sidebar and in the page's part-number spots, instead of the public id. - Show
stockandstock_as_ofin the stock area as Adom's own row, already filled in ("Adom: 1,200 in stock, as of Nov 2"). Shownullas "not tracked". - Keep the Check button for the DigiKey and Mouser rows.
Where Adom's stock lives today
- Basic parts: pnp-inventory (Drew's service) has a live count for 173 parts (
stock,location,updated_at). That's the source of truth. - Machine pins and contacts: no service has a count yet. They aren't in pnp-inventory as parts or molecules, Component Ocean has no record of them, and their pages carry only the MPN and specs. Until Drew's inventory records them, their pages will carry
stock: null.