seanbetts--steam-hardware-watch/references/sources.md

# Source Map

Use primary sources first.

## Komodo

- `https://komodostation.com/wp-json/`
- `https://komodostation.com/wp-json/wp/v2/product`
- `https://komodostation.com/wp-json/wp/v2/sections`
- `https://komodostation.com/wp-json/wp/v2/media`

Known product IDs from the seeded baseline:

- `Steam Controller JPY`: `413763`
- `Steam Machine JPY`: `413772`
- `Steam Frame JPY`: `413776`

Known section IDs from `2026-04-24` controller rollout:

- `433306` banner
- `433326` people video
- `433356` features
- `433376` video
- `433416` buttons
- `433434` custom
- `433470` features
- `433484` spec image

## SteamKit / PICS

Treat SteamKit/PICS as the primary direct Steam metadata source for watched app/package movement.

References:

- SteamKit source: `https://github.com/SteamRE/SteamKit`
- SteamKit2 NuGet: `https://www.nuget.org/packages/SteamKit2`
- relevant SteamKit concept: `SteamApps.PICSGetProductInfo`

Primary targets:

- `Steam Controller app`: `4165870`
- `Steam Machine app`: `4165910`
- `Steam Frame app`: `4165890`
- `Steam Controller package`: `1558609`
- `Steam Machine packages`: `1629446`, `1629447`, `1629458`, `1629460`
- `Steam Frame packages`: `1629484`, `1629486`

For each normal run, a SteamKit/PICS helper should snapshot:

- app product-info payloads
- package product-info payloads
- changenumbers
- depot and branch metadata exposed in app product info, when present
- raw JSON or normalized structured output suitable for diffing against the previous run

Local helper:

- `scripts/check_steamkit_pics.sh`
- raw snapshot: `RUN_DIR/api/steamkit/pics-product-info.json`
- normalized package/app report: `RUN_DIR/reports/steamkit-pics-packages.tsv`
- summary lines: `RUN_DIR/reports/steamkit-pics-key-lines.txt`
- human-readable detail report: `RUN_DIR/reports/steamkit-pics-detail.md`

Operational constraints:

- use a separate Steam account, not the user's main account
- keep polling narrow and conservative
- do not download protected depot content
- treat SteamKit/PICS metadata movement as the earliest app/package update signal
- use Valve Store APIs below to confirm public price, package groups, purchase/reservation state, and exact timing

## SteamDB

- `Steam Controller app`: `https://steamdb.info/app/4165870/`
- `Steam Machine app`: `https://steamdb.info/app/4165910/`
- `Steam Frame app`: `https://steamdb.info/app/4165890/`
- `Steam Controller history`: `https://steamdb.info/app/4165870/history/`
- `Unboxing video app`: `https://steamdb.info/app/4653940/`
- `Unboxing video package`: `https://steamdb.info/sub/1620489/`

Reservation/package IDs seen in SteamTracking reservation-system code and SteamDB:

- `Steam Controller`: `1558609` (public purchase package baseline)
- `Steam Machine`: `1629446`, `1629447`, `1629458`, `1629460`
- `Steam Frame`: `1629484`, `1629486`

SteamDB page check: for each package ID, check the SteamDB package page and record:

- `Last Record Update`
- `Last Changenumber`
- possible app association or inferred app association
- whether SteamDB still has no package information beyond existence

Use SteamDB package pages as corroborating/human-readable views of package movement. Do not make SteamDB HTML scraping the primary source when SteamKit/PICS snapshots are available.

SteamDB package pages:

- `Steam Controller package`: `https://steamdb.info/sub/1558609/`
- `Steam Machine package`: `https://steamdb.info/sub/1629446/`
- `Steam Machine package`: `https://steamdb.info/sub/1629447/`
- `Steam Machine package`: `https://steamdb.info/sub/1629458/`
- `Steam Machine package`: `https://steamdb.info/sub/1629460/`
- `Steam Frame package`: `https://steamdb.info/sub/1629484/`
- `Steam Frame package`: `https://steamdb.info/sub/1629486/`

Corroborating Valve Store APIs:

- `https://store.steampowered.com/api/appdetails?appids=4165910,4165890,4165870&cc=us&l=english`
- `https://store.steampowered.com/api/packagedetails?packageids=<packageid>&cc=us&l=english`

Known baseline: the Machine and Frame package IDs may exist on SteamDB while `packagedetails` still returns `success:false`. Treat that as private-package existence, not public launch readiness.

SteamTracking origin baseline:

- package IDs first appear in SteamTracking bundle snapshots at commit `334bd31a28a0` (`2026-04-28T23:46:34Z`)
- parent commit `4a2195407fde` does not contain the IDs
- later commit `cb7ae45d7bb1` (`2026-05-07T20:10:35Z`) changes reservation behavior but is not first package-ID exposure

## SteamTracking / GameTracking

Primary local paths if already cloned:

- `/tmp/SteamTracking-master`
- `/tmp/GameTracking-*`

High-yield files from the seeded baseline:

- `ClientExtracted/steamui/localization/steamui_english.json`
- `Protobufs/webuimessages_steaminput.proto`
- `Protobufs/steammessages_clientsettings.proto`
- `steamcommunity.com/public/javascript/webui/friends.js`
- `Strings/steamclient.txt`

Useful search terms:

- `Triton`
- `Ibex`
- `Puck`
- `Steam Controller`
- `dock`
- `pair`
- `firmware`

## SteamVR Depots

SteamVR is Steam app `250820`.

- SteamDB depots page: `https://steamdb.info/app/250820/depots/`
- official news API: `https://api.steampowered.com/ISteamNews/GetNewsForApp/v2/?appid=250820&count=40&maxlength=12000&format=json`

High-yield depots:

- `250821`: Windows OpenVR Win32
- `250823`: Linux OpenVR Linux
- `250824`: Windows/Linux OpenVR Content
- `250827`: Windows/Linux OpenVR Content 2
- `250830`: SteamVR Environments Content
- `250831`: SteamVR Environments Windows
- `250832`: SteamVR Environments Linux

Useful search terms:

- `Steam Frame`
- `Frame`
- `Deckard`
- `Roy`
- `Triton`
- `Ibex`
- `Puck`
- `Steam Link VR`
- `dongle`
- `activeFrame`
- `summonOverlayKey`
- `XR`
- `VR`

## SteamOS Package Mirror

- root mirror: `https://steamdeck-packages.steamos.cloud/archlinux-mirror/`
- source mirror: `https://steamdeck-packages.steamos.cloud/archlinux-mirror/sources/`

High-yield repos:

- `holo-main`
- `holo-3.8`
- `jupiter-main`
- `jupiter-3.8`
- `core-main`
- `extra-main`
- `multilib-main`

Useful search terms:

- `Fremont`
- `Deckard`
- `Steam Frame`
- `Roy`
- `Ibex`
- `Triton`
- `Lilac`
- `XR`
- `VR`
- `dongle`
- `firmware`
- `aarch64`
- `arm64`
- `qcom`
- `snapdragon`

## Valve Endpoints

Check for newly exposed assets or support flows:

- Steam support
- Steam store app pages
- linked manuals, PDFs, videos, and images
- `https://store.steampowered.com/app/4165870/`
- `https://help.steampowered.com/en/wizard/HelpWithSteamDeck`
- `https://www.steamdeck.com/`
- `https://steampowered.com/hardware`

## Customs / Regulatory

Run ImportInfo customs checks every normal watch run because they are quick and high-signal. Use customs data as corroborating evidence, not as primary proof.

- customs and import records
- ImportInfo automated search for CEVA/Valve: `https://www.importinfo.com/search?s=CEVA%20C%2FO%20VALVE%20CORPORATION`
- ImportInfo automated search for Ingram/Valve: `https://www.importinfo.com/search?s=INGRAM%20MICRO%20C%2FO%20VALVE%20CORPORATION`
- ImportInfo automated search for Tech-Front game console Valve: `https://www.importinfo.com/search?s=TECH-FRONT%20GAME%20CONSOLE%20VALVE`
- ImportInfo automated search for Valve Corporation game console: `https://www.importinfo.com/search?s=VALVE%20CORPORATION%20GAME%20CONSOLE`
- ImportInfo manual/corroborating Tech-Front supplier page: `https://www.importinfo.com/tech-front-chongqing-computer-co`
- ImportInfo manual/corroborating Valve Corporation page: `https://www.importinfo.com/valve-corporation`
- NBD Valve Corporation public company page: `https://en.nbd.ltd/trader/info/NBDD3Y527621220`
- NBD buyer search for Valve Corporation: `https://en.nbd.ltd/customs-data?t=2&v=Valve%20Corporation`
- ImportGenius Ingram Micro C/O Valve Corporation page: `https://www.importgenius.cn/importers/ingram-micro-c-o-valve-corporation`
- HMRC UK Trade Info: rejected for this workflow because it is lagged monthly aggregate/trader data rather than shipment-level data.
- FCC
- Bluetooth SIG
- Wi-Fi Alliance

Do not elevate these above direct Komodo, SteamDB, or Valve evidence when those primary sources disagree.