diff --git a/docs/plans/release-0.3.12.md b/docs/plans/release-0.3.12.md
new file mode 100644
index 000000000..20d2283f3
--- /dev/null
+++ b/docs/plans/release-0.3.12.md
@@ -0,0 +1,46 @@
+# Igneum Miner 0.3.12: app only, prepared to the publish gate, 6 October 2026
+
+Release engineer, from 08:05 UTC, on the coordinator's instruction ("prepare 0.3.12, APP ONLY, up to the publish gate and STOP there; the project lead
+gives the go"). No node change, no override change, no consensus parameter: the node fork stays 89dfcb95 (`release-0.3.11-node`), the
+override the nine-field object of 0.3.11 (digest 0139ab9d...), the packaged line unchanged. Worktree `/Users/joshm/Projects/igneum-wt-ship0312`,
+branch `release-0.3.12` from master ddfcdac; `vendor/` symlinked to the main checkout's (46 entries) with `vendor/igneum-node-0312` pointing at
+the 0.3.11 fork worktree (89dfcb95). The 0.3.11 recipe (`release-0.3.11.md`) throughout; every Mac build under the main checkout's lock;
+igneum-labs commits. Times are UTC.
+
+## 1. What 0.3.12 carries
+
+| Change | Where | State |
+|---|---|---|
+| `/api/state` never answers `{}` again: `paid_wei` (u128) is a decimal string, the error reply is logged; test | `proving-v1` app 6714a45 (the first item) | merged 9bcf4cd (the `docs/bench-log.md` conflict: both sides kept, the log is append-only) |
+| An update published over an hour before the engine started skips the hourly rollout slot; `manifest::unix_from_rfc3339` + tests | `update-catchup` 2207cd7 | merged b984c17 |
+| The GPU list ordered by performance (usable, discrete before integrated, rate in 5 MH/s buckets, memory); 3 UI tests | `card-order` ffb2bfa | merged c6608c1 |
+| HiveOS local mode carries the override (`OVERRIDE=` in the Flight Sheet's extra config, written to `data/override-params.json` by `h-run.sh`, C41), rigs mine only until a Linux prover ships, `IDENTITIES=auto` by VRAM, the per-card README table | `hive-words` 98271ff (packaging/hive only) | merged b0a6231 |
+| Ember Tune: two-knob plans + priors + the UI line; every quit names its source (b671c8b); a second engine never runs the updater (e600e63, C35); no pipe into a second engine (8ab9068); `jobrun.rs` elevated `follow_file` (1e9550e); the BOM fix + CI check (8273494); Power control switch (49bbe14 = 3562f26); `igneum-gpu-telemetry.exe` (ADLX) built by `build-windows.sh` and carried in the Windows inputs | `ember-tune` 9a6469f | NOT MERGED: conflicts in seven files against the 0.3.10/0.3.11 app (its base ca8d9f3 predates both): `ci.yml`, `config.rs`, `engine.rs` (the detect path, the power-cap plan, the test module), `ui/app.js` (four hunks against miner-ui-2's View), `ui/index.html` (the settings panel 0.3.10 removed), `proto-opencl/README.md`, `bench-log.md`. Its agent is rebasing it onto release-0.3.12 (section 2) |
+| The hidden-console builder for every elevated launch, `windows-spawn-check.mjs`, the PC 1 console-watch scripts | `job-console` 13755b9 (+ 3562f26 Power control) | NOT MERGED: conflicts in six files (`ci.yml`, `config.rs`, `engine.rs`, `jobrun.rs`, `app.js`, `index.html`), base a93199a; carried by the ember-tune rebase (it already holds 3562f26) |
+| The miner's gRPC resubscribe after a node restart (C43, the 0.3.11 finding) | no commit exists (the ledger entries b19fe5f, 0751dde, c8c831c only) | OWED, listed in section 10 |
+| The six version files | 81e4ecb (`--check`: 0.3.12 in all 6) | |
+
+Left out on the coordinator's word: the node fork, prover-floor's server (its packaging row is 0.3.13), explorer d7e797c, pool-v0, rig-install,
+ota-k2, the ledger forks.
+
+Changelog line (draft, for the manifest notes at the go): "Igneum Miner 0.3.12: the GPU list in performance order; an old update no longer
+waits for the hour; Ember Tune (every card tuned for MH per watt, Power control off by default, the app never asks for administrator
+rights on its own); a second engine never installs over the app; /api/state always answers; HiveOS rigs carry the override. Node unchanged."
+
+## 2. The branch
+
+| Commit | What |
+|---|---|
+| 9bcf4cd, b984c17, c6608c1, b0a6231 | the four merges above, in the coordinator's order (proving-v1 first) |
+| 81e4ecb | `Igneum Miner 0.3.12: the six version files` |
+| (pending) | the ember-tune rebase tip (with job-console 13755b9 inside), merged as one branch |
+
+Checks on 81e4ecb before the rebase landed: the app `cargo test --release -p igneum-app` under the lock: ok 115 (lib) + 28 (ota-sign) + 8
+(prove-verify), 0 failed (08:19:22 to 08:19:28Z, warm target cloned from the 0.3.11 worktree); the UI tests `notices`, `update-card`, `view`:
+23 of 23.
+
+## 3. Builds and artefacts
+
+| What | Command | Result |
+|---|---|---|
+| The HiveOS package | `NODE_OUT=<the 0.3.11 zig node dir> WORKERS_OUT=<the 0.3.11 Linux workers> VERSION=0.3.12 OUT=<scratch> packaging/hive/make-hive-package.sh` (the node 63cf490d... and the workers 4aaff27f.../82d90890... unchanged; the h-* scripts from hive-words) | 08:19:45Z: `igneum-hive-0.3.12.tar.gz` b0a20917dd1f995e7ff7f456cd995fed0860563e6952a7fb4f64a7857a5d2afe (24,501,272); `h-run.sh` writes `data/override-params.json` from `OVERRIDE` and starts the node with `--override-params-file` (the 0.3.11 open item closed) |