Skip to content

Docs: point handheld TDP notes at the landed writer and shim - #78

Merged
DanielJBurbridge merged 1 commit into
feat/ally-parity-integration-20261111from
docs/ally-docs-cleanup-20261117
Nov 17, 2026
Merged

DanielJBurbridge merged 1 commit into
feat/ally-parity-integration-20261111from
docs/ally-docs-cleanup-20261117

Conversation

@DanielJBurbridge

Copy link
Copy Markdown
Owner

Docs only. No bin/, packaging, install, migrations, units, udev or sudoers changes.

Integ base: 5534cf292e82bdd2ac96b37598371b0801cc5c3e (Merge #77).

Model: grok-4.7

What changes

  1. docs/rog-ally-gaming-session.md and docs/rog-ally-reliability.md no longer tell anyone to start steamos-manager.service or omarchy-ally-power.service. TDP is bin/omarchy-ally-tdp-apply and bin/omarchy-ally-tdp-shim: battery 20/20/25, AC SPL 30, stock-table 30/43/53, live firmware clamp, flock on /run/omarchy-ally-tdp.lock. P16 is writer readback, not a hard 25 W / 30 W cap. The leftover marker block in bin/omarchy-session-start is named and is not the path to use.

  2. docs/handheld/research/parity-gaps-ranked.md is the current ranked list at 5534cf292. TDP writer and shim are landed, with the slider check still open. The power-button recipe and InputPlumber profiles are in the tree. Speakers, paddles, undocked desktop and the on-device slider check stay open. docs/handheld/research/feature-parity-audit.md is a pointer. Still-true audit notes moved to the end of the gaps file.

  3. docs/handheld/HANDOVER.md is a short pointer to docs/handheld/HANDOFF-20261116.md and docs/handheld/ALPHA.md. docs/handheld/README.md leads with those two.

  4. Spec 04 §5.1 is the TDP contract and points at the writer and the shim. Missing-file citations (bin/omarchy-power-ally, default/handheld/power.py, shell/plugins/panels/power/Handheld.qml, feat/ally-power-20261111, docs/handheld/tdp-spike-findings.md) and the “read-only until the writer lands” / “no PR” lines are gone. docs/handheld/tdp-decision-review.md is marked historical. docs/handheld/03-first-boot-and-install.md no longer cites docs/rog-ally-power.md.

  5. docs/handheld/research/brief-tdp-limits.md and build-tdp-slider.md open with “Implemented; current contract is spec 04 §5.1”. Licence notes and the evlaV 85fbd8f citation stay. The slider brief’s file list matches the tree: Mains-only udev, generated polkit rule, and omarchy-rog-ally-tdp as the opt-in scriptlet around omarchy-ally-tdp-install. docs/handheld/research/parity-matrix.md leads with the landed writer and shim. The 12 Nov steamos-manager rejection stays as history.

  6. docs/handheld/alpha-followups.md: L25 corrected (backspace, space and enter exist; shift and symbols stay open). L29 and L30 superseded. L38 and L51 fixed in source, with device motion left on L45. The M3 flock note moved from L174 to L182. L179’s udev line is Mains only. Entries were not renumbered or deleted. L200–L209 was not used. PR Record L192 and L193 from the power-button review #76 is still open, so L192 and L193 were not added and were not marked.

  7. Relative links in the edited markdown resolve. ./test/all is the CI job and runs inside the Omarchy VM image. It was not run on this agent. No test file asserts these docs.

Verification

Relative-link check over the 14 edited markdown files: every relative target exists. git diff is markdown only.

No visible change: documentation only.

Open in Web Open in Cursor 

Rewrite the gaming-session and reliability TDP notes off steamos-manager, make spec 04 §5.1 the contract, and mark the older briefs and follow-ups against this tip.

Model: grok-4.7
Co-authored-by: Daniel Burbridge <DanielJBurbridge@users.noreply.github.com>

@DanielJBurbridge DanielJBurbridge left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

dev-red review: PASS at 0a8127d. Docs only, and GitHub Actions test passed on this head.

  • Integ 5534cf2 is an ancestor. All 14 changed files are .md. The commit has a Model trailer (grok-4.7), and the body states it.
  • I spot-checked the follow-up status changes against the tree:
    • L38 Fixed: install/hardware/asus/inputplumber.sh, the omarchy-ally-pointer.yaml profile and omarchy-ally-pointer.service (Before=display-manager.service) all exist.
    • L51 Fixed: migrations/1794902400.sh and 1794988800.sh exist. The second is gated on hw-rog-ally plus omarchy-gaming-session. The leaf prints a warning with the re-run command.
    • L29 and L30 Superseded: there's no 21-omarchy-ally-tdp-variant.hook and no write_recorded_spl in bin/default/install.
    • L25 stays Open, with the remaining gap (shift and symbols) stated.
  • Removing steamos-manager and omarchy-ally-power from the docs matches audit A6. The code block in bin/omarchy-session-start:364-370 is still there, and the A3–A6 fix PR should remove it.
  • I didn't line-check the large deletions in feature-parity-audit.md and HANDOVER.md. They're now pointers to parity-gaps-ranked.md, which is dev-research's area.

@DanielJBurbridge
DanielJBurbridge merged commit a478c5f into feat/ally-parity-integration-20261111 Nov 17, 2026
1 check passed
cursor Bot pushed a commit that referenced this pull request Nov 17, 2026
Keep the #78 TDP paragraph, and record that session-start no longer
names the missing ally-power units.

Model: grok-4.7
Co-authored-by: Daniel Burbridge <DanielJBurbridge@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants