diff --git a/README.md b/README.md index 3c94640..e5c28b4 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,9 @@ # Steam Hardware Watch -Agent-oriented monitoring workflow for rumored or upcoming Valve hardware, focused on: +Agent-oriented monitoring workflow for rumored or upcoming Valve hardware. The current default focus is Steam Frame launch readiness, with launched hardware retained as comparator context: -- `Steam Controller` -- `Steam Machine` -- `Steam Frame` +- active target: `Steam Frame` +- comparators: `Steam Controller`, `Steam Machine` It is designed to be run by a coding agent through the included `SKILL.md`, with scripts that: @@ -24,22 +23,24 @@ It is a repeatable evidence-gathering workflow for answering a narrow set of que - did anything change? - is there a price leak? - is there a release-date leak? -- does the controller look ahead of Machine/Frame? +- has Steam Frame gained package, price, release-date, site, client, or shipment evidence? - are there new media assets or support documents? -The normal entry point is the wrapper script: +The normal Frame-focused entry point is: ```sh -scripts/run_watch.sh YYYY-MM-DD +scripts/run_frame_watch.sh YYYY-MM-DD ``` By default this writes ignored artifacts under `runs/YYYY-MM-DD` in this repo and uses `/tmp/SteamTracking-master`. Pass explicit paths only when you want to override those defaults: ```sh -scripts/run_watch.sh YYYY-MM-DD /custom/run-base /path/to/SteamTracking +scripts/run_frame_watch.sh YYYY-MM-DD /custom/run-base /path/to/SteamTracking ``` +Use `scripts/run_watch.sh` when you explicitly want the broader all-hardware view or when debugging an individual source helper. + ## Repository Layout ```text @@ -99,13 +100,13 @@ chmod +x scripts/*.sh `scripts/check_steamtracking.sh` fast-forwards this checkout before scanning and records the before/after commit in each run. -4. Run a watch pass: +4. Run a Frame-focused watch pass: ```sh -scripts/run_watch.sh 2026-04-25 +scripts/run_frame_watch.sh 2026-07-28 ``` -This creates a dated run folder under `runs/2026-04-25`. +This creates a dated run folder under `runs/2026-07-28`. ### Common Path @@ -113,7 +114,7 @@ For the least disruptive Komodo flow, use the dedicated background browser boots ```sh scripts/bootstrap_komodo.sh -scripts/run_watch.sh 2026-04-25 +scripts/run_frame_watch.sh 2026-07-28 scripts/close_komodo.sh ``` @@ -123,7 +124,7 @@ SteamDB can require the same live-browser treatment: ```sh scripts/bootstrap_steamdb.sh -scripts/run_watch.sh 2026-04-25 +scripts/run_frame_watch.sh 2026-07-28 scripts/close_steamdb.sh ``` @@ -170,13 +171,13 @@ Then run either the source directly: scripts/check_steamkit_pics.sh runs/2026-05-11 ``` -or the normal watcher: +or the normal Frame watcher: ```sh -scripts/run_watch.sh 2026-05-11 +scripts/run_frame_watch.sh 2026-07-28 ``` -The normal watcher automatically uses `.local/steamkit-session.json`, so routine runs should not ask for a fresh Steam Guard code. If Steam invalidates the refresh token, rerun `scripts/steamkit_auth.sh` with a fresh guard approval to create a new session file. +The Frame watcher automatically uses `.local/steamkit-session.json`, so routine runs should not ask for a fresh Steam Guard code. If Steam invalidates the refresh token, rerun `scripts/steamkit_auth.sh` with a fresh guard approval to create a new session file. Outputs: @@ -186,7 +187,7 @@ Outputs: - `RUN_DIR/reports/steamkit-pics-detail.md` - `RUN_DIR/reports/steamkit-pics-errors.txt` -If the env file and session file are missing, the script writes a non-fatal `missing_credentials` report so the normal watcher still completes. Do not use your main Steam account, do not poll aggressively, and do not extend this helper to protected depot downloads. +If the env file and session file are missing, the script writes a non-fatal `missing_credentials` report so the Frame watcher still completes. Do not use your main Steam account, do not poll aggressively, and do not extend this helper to protected depot downloads. ## Output @@ -195,21 +196,27 @@ Each run writes: - raw API and HTML snapshots - per-source summary files - comparison report versus the previous run when available +- `frame-focus.md` - `run-summary.md` - `status-draft.md` - visual asset ledgers: -- `discovered-visual-assets.tsv` -- `retrieved-visual-assets.tsv` -- `blocked-visual-assets.tsv` -- `manual-asset-urls.txt` + - `discovered-visual-assets.tsv` + - `retrieved-visual-assets.tsv` + - `blocked-visual-assets.tsv` + - `manual-asset-urls.txt` - `steamkit-pics-packages.tsv` - `steamkit-pics-detail.md` - `steamvr-depots-key-lines.txt` - `steamos-mirror-key-lines.txt` -The main human-readable file is: +The first human-readable file to inspect is: + +- `RUN_DIR/reports/frame-focus.md` + +Then use: - `RUN_DIR/reports/run-summary.md` +- `RUN_DIR/reports/compare-vs-*.md` ## Agent Usage @@ -230,8 +237,9 @@ Then ask Codex to use the `steam-hardware-watch` skill. Point the agent at this repo and have it: 1. read `SKILL.md` -2. use `scripts/run_watch.sh` as the default entry point +2. use `scripts/run_frame_watch.sh` as the default Frame-focused entry point 3. summarize results from: + - `frame-focus.md` - `run-summary.md` - `status-draft.md` - any `compare-vs-*.md` @@ -287,11 +295,11 @@ If Komodo needs any manual interaction, switch to that dedicated window when con Then run: ```sh -scripts/run_watch.sh 2026-04-25 +scripts/run_frame_watch.sh 2026-07-28 ``` `check_komodo.sh` will automatically pick up `.local/komodo-env.sh` when present. -`run_watch.sh` will also auto-close the dedicated Komodo browser at the end unless you set: +`run_frame_watch.sh` will also auto-close the dedicated Komodo browser at the end unless you set: ```sh KOMODO_KEEP_BROWSER_OPEN=1 @@ -399,10 +407,10 @@ If SteamDB needs manual interaction, switch to that dedicated Chrome window, com Then run: ```sh -scripts/run_watch.sh 2026-04-25 +scripts/run_frame_watch.sh 2026-07-28 ``` -`check_steamdb.sh` automatically picks up `.local/steamdb-env.sh` when present. `run_watch.sh` auto-closes the dedicated SteamDB browser at the end unless you set: +`check_steamdb.sh` automatically picks up `.local/steamdb-env.sh` when present. `run_frame_watch.sh` auto-closes the dedicated SteamDB browser at the end unless you set: ```sh STEAMDB_KEEP_BROWSER_OPEN=1 @@ -448,6 +456,7 @@ SteamVR content is distributed through SteamPipe depots rather than the SteamOS - `SteamDB` can return a Cloudflare browser challenge to curl and fresh automated browser contexts. - `SteamVR` depot contents require a Steam install, Steam console, SteamCMD, or another depot downloader; the helper does not download large depots by default. - The SteamOS mirror is public, but package names are not proof of product launch state without corroborating evidence. +- `/tmp/SteamTracking-*` checkouts can become invalid even when source files still exist. If `git -C /tmp/SteamTracking-* status` fails, clone a fresh shallow checkout and rerun with that path. - We can currently discover and report blocked media URLs even when we cannot download them automatically. - Exported storage state may still be insufficient for Cloudflare-protected Komodo assets. - Live trusted browser attach is currently the strongest repeatable fallback for protected Komodo media. @@ -458,8 +467,8 @@ SteamVR content is distributed through SteamPipe depots rather than the SteamOS Normal use: -1. run `scripts/run_watch.sh` -2. read `run-summary.md` +1. run `scripts/run_frame_watch.sh` +2. read `frame-focus.md`, then `run-summary.md` 3. inspect the comparison report if something changed 4. update `status/current.md` and `status/evidence.jsonl` only for material changes