From 86cf02bbe7530d10bcf24b7874472599fbea7dbb Mon Sep 17 00:00:00 2001 From: Krzysztof kuhy Rudnicki Date: Sun, 22 Nov 2026 12:14:44 +0100 Subject: [PATCH] Resolve phone_vd state dir without TMPDIR Mirror phone_vd_dir.sh: PHONE_VD_STATE_DIR, else XDG runtime dir, else /tmp. Prunes 39 oldest evidence files per check_repo_size.sh --prune. Co-Authored-By: Claude Fable 5.2 --- ...y-redeploy-parallel-checks-2026-10-22.json | 39 -------------- .../agent-ready-static-sites-2026-10-22.json | 45 ---------------- .../android-ui-scroll-to-2026-11-02.json | 25 --------- ...icons-launcher-unification-2026-10-23.json | 45 ---------------- ...-icons-tunedeck-headphones-2026-10-16.json | 36 ------------- .../app-icons-tutor-lightbulb-2026-10-12.json | 38 -------------- ...i-green-pin-only-exemption-2026-11-01.json | 32 ------------ ...i-tool-pins-shfmt-prettier-2026-10-22.json | 43 ---------------- .../deps-bump-pillow13-2026-10-17.json | 35 ------------- .../drop-pacman-policy-lists-2026-10-17.json | 34 ------------- .../hypothesis-pin-bump-2026-10-22.json | 19 ------- .../i3-focus-block-milestones-2026-11-10.json | 31 ----------- .../i3-focus-suitcase-emoji-2026-11-11.json | 30 ----------- .../i3blocks-focus-project-2026-11-02.json | 36 ------------- .../i3blocks-leisure-live-2026-10-19.json | 37 -------------- .../i3blocks-leisure-shadow-2026-10-19.json | 37 -------------- ...eisure-shadow-generated-at-2026-10-19.json | 36 ------------- .../i3blocks-tutor-minutes-2026-10-12.json | 29 ----------- .../lan-gateway-warp-window-2026-10-25.json | 51 ------------------- .../librewolf-local-gio-2026-11-01.json | 32 ------------ .../mcp-servers-path-repoint-2026-11-10.json | 34 ------------- .../monitor-autoconfig-2026-11-11.json | 37 -------------- .../monitor-autoconfig-boot-2026-11-12.json | 38 -------------- ...-session-autopsy-mutations-2026-11-10.json | 31 ----------- .../phone-focus-todo-narrow-2026-11-02.json | 16 ------ .../phone-vd-state-dir-2026-11-22.json | 28 ++++++++++ ...i-rustscan-instead-of-nmap-2026-11-10.json | 35 ------------- .../publish-caddy-site-2026-11-02.json | 28 ---------- .../evidence/pypi-pins-bump-2026-10-22.json | 27 ---------- .../evidence/pypi-pins-bump-2026-10-25.json | 26 ---------- .../evidence/remove-syncyomi-2026-11-01.json | 28 ---------- .../sql-drills-harness-2026-11-01.json | 41 --------------- .../sql-drills-thin-wrapper-2026-11-02.json | 33 ------------ ...estsandmisc-deploy-command-2026-11-12.json | 30 ----------- .../token-audit-usd-per-note-2026-11-01.json | 38 -------------- .../token-dashboard-core-2026-10-18.json | 40 --------------- ...utor-i3block-weekday-quota-2026-10-12.json | 30 ----------- .../wallpaper-rotator-2026-11-11.json | 39 -------------- .../warp-window-0700-1700-2026-11-09.json | 37 -------------- .../warp-window-thu-0800-1600-2026-11-05.json | 37 -------------- python_pkg/phone_guard/tests/test_vd_state.py | 48 ++++++++++++++++- python_pkg/phone_guard/vd_state.py | 17 +++++-- 42 files changed, 86 insertions(+), 1342 deletions(-) delete mode 100644 docs/superpowers/evidence/agent-ready-redeploy-parallel-checks-2026-10-22.json delete mode 100644 docs/superpowers/evidence/agent-ready-static-sites-2026-10-22.json delete mode 100644 docs/superpowers/evidence/android-ui-scroll-to-2026-11-02.json delete mode 100644 docs/superpowers/evidence/app-icons-launcher-unification-2026-10-23.json delete mode 100644 docs/superpowers/evidence/app-icons-tunedeck-headphones-2026-10-16.json delete mode 100644 docs/superpowers/evidence/app-icons-tutor-lightbulb-2026-10-12.json delete mode 100644 docs/superpowers/evidence/ci-green-pin-only-exemption-2026-11-01.json delete mode 100644 docs/superpowers/evidence/ci-tool-pins-shfmt-prettier-2026-10-22.json delete mode 100644 docs/superpowers/evidence/deps-bump-pillow13-2026-10-17.json delete mode 100644 docs/superpowers/evidence/drop-pacman-policy-lists-2026-10-17.json delete mode 100644 docs/superpowers/evidence/hypothesis-pin-bump-2026-10-22.json delete mode 100644 docs/superpowers/evidence/i3-focus-block-milestones-2026-11-10.json delete mode 100644 docs/superpowers/evidence/i3-focus-suitcase-emoji-2026-11-11.json delete mode 100644 docs/superpowers/evidence/i3blocks-focus-project-2026-11-02.json delete mode 100644 docs/superpowers/evidence/i3blocks-leisure-live-2026-10-19.json delete mode 100644 docs/superpowers/evidence/i3blocks-leisure-shadow-2026-10-19.json delete mode 100644 docs/superpowers/evidence/i3blocks-leisure-shadow-generated-at-2026-10-19.json delete mode 100644 docs/superpowers/evidence/i3blocks-tutor-minutes-2026-10-12.json delete mode 100644 docs/superpowers/evidence/lan-gateway-warp-window-2026-10-25.json delete mode 100644 docs/superpowers/evidence/librewolf-local-gio-2026-11-01.json delete mode 100644 docs/superpowers/evidence/mcp-servers-path-repoint-2026-11-10.json delete mode 100644 docs/superpowers/evidence/monitor-autoconfig-2026-11-11.json delete mode 100644 docs/superpowers/evidence/monitor-autoconfig-boot-2026-11-12.json delete mode 100644 docs/superpowers/evidence/parallel-session-autopsy-mutations-2026-11-10.json delete mode 100644 docs/superpowers/evidence/phone-focus-todo-narrow-2026-11-02.json create mode 100644 docs/superpowers/evidence/phone-vd-state-dir-2026-11-22.json delete mode 100644 docs/superpowers/evidence/pi-rustscan-instead-of-nmap-2026-11-10.json delete mode 100644 docs/superpowers/evidence/publish-caddy-site-2026-11-02.json delete mode 100644 docs/superpowers/evidence/pypi-pins-bump-2026-10-22.json delete mode 100644 docs/superpowers/evidence/pypi-pins-bump-2026-10-25.json delete mode 100644 docs/superpowers/evidence/remove-syncyomi-2026-11-01.json delete mode 100644 docs/superpowers/evidence/sql-drills-harness-2026-11-01.json delete mode 100644 docs/superpowers/evidence/sql-drills-thin-wrapper-2026-11-02.json delete mode 100644 docs/superpowers/evidence/testsandmisc-deploy-command-2026-11-12.json delete mode 100644 docs/superpowers/evidence/token-audit-usd-per-note-2026-11-01.json delete mode 100644 docs/superpowers/evidence/token-dashboard-core-2026-10-18.json delete mode 100644 docs/superpowers/evidence/tutor-i3block-weekday-quota-2026-10-12.json delete mode 100644 docs/superpowers/evidence/wallpaper-rotator-2026-11-11.json delete mode 100644 docs/superpowers/evidence/warp-window-0700-1700-2026-11-09.json delete mode 100644 docs/superpowers/evidence/warp-window-thu-0800-1600-2026-11-05.json diff --git a/docs/superpowers/evidence/agent-ready-redeploy-parallel-checks-2026-10-22.json b/docs/superpowers/evidence/agent-ready-redeploy-parallel-checks-2026-10-22.json deleted file mode 100644 index 3aeb5c1b..00000000 --- a/docs/superpowers/evidence/agent-ready-redeploy-parallel-checks-2026-10-22.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "intent": "redeploy_agent_ready_sites.sh --verify-only stops flaking FAIL on all three sites: the checks run concurrently, each with the checker's own 45 s network budget, and the whole script still ends inside 60 s.", - "scope": [ - "linux_configuration/features/redeploy_agent_ready_sites.sh", - "linux_configuration/features/lib/tests/test_redeploy_agent_ready_sites.sh", - "Non-goal: changing the AgentReady checker in ~/src/utils; no live container restarts" - ], - "changes": [ - "The three url checks run in parallel (in_parallel helper: per-job output files, exit status collected via wait, verdicts printed in fixed site order)", - "Each check passes --budget to the checker: min(45, RUN_DEADLINE(55) - elapsed - 5 s grace); the outer timeout is budget + 5 s and only a hang backstop. Below 3 s left, every site reports UNDETERMINED (no time left) and nothing starts", - "The three redeploy steps also run in parallel and the systemctl restart is now under the 20 s timeout too, so a full run fits 60 s worst case (20 s redeploy + <=35 s checks)", - "--help prints only the header block instead of every comment in the file" - ], - "verification": [ - { - "command": "bash linux_configuration/features/lib/tests/test_redeploy_agent_ready_sites.sh", - "result": "pass", - "evidence": "RED before the change: 18 passed, 6 failed (concurrency barriers, --budget 45, deadline budget, no-time-left). GREEN after: 25 passed, 0 failed" - }, - { - "command": "bash linux_configuration/features/redeploy_agent_ready_sites.sh --verify-only (3 consecutive live runs)", - "result": "pass", - "evidence": "3/3 runs: PASS kuhy.duckdns.org, dice.kuhy.duckdns.org, popes.kuhy.duckdns.org, rc=0, 0.68-0.89 s wall each" - }, - { - "command": "shellcheck -x + shfmt -d on both files", - "result": "pass", - "evidence": "no findings, no diff" - } - ], - "risks": [ - "Parallel docker recreates of the two static sites contend for the docker daemon; they use separate compose dirs, and the 20 s per-step timeout still applies", - "AGENT_READY_RUN_DEADLINE env override exists for the tests; setting it high in production could exceed 60 s" - ], - "rollback": [ - "git revert this commit", - "Re-run bash linux_configuration/features/redeploy_agent_ready_sites.sh --verify-only and confirm three verdict lines" - ] -} diff --git a/docs/superpowers/evidence/agent-ready-static-sites-2026-10-22.json b/docs/superpowers/evidence/agent-ready-static-sites-2026-10-22.json deleted file mode 100644 index 7f096806..00000000 --- a/docs/superpowers/evidence/agent-ready-static-sites-2026-10-22.json +++ /dev/null @@ -1,45 +0,0 @@ -{ - "intent": "The personal website and kcd2 dice solver static Caddies serve their prerendered dist/ so both sites pass the AgentReady v2.0 checker (real 404s, discovery files, ai-catalog Link header), and a narrow sudo-free redeploy + verify exists for the three public static sites.", - "scope": [ - "linux_configuration/features/lib/static_site_caddy.sh (new shared site-block body), website_build.sh, kcd2_serve.sh, kcd2_expose.sh", - "linux_configuration/features/setup_personal_website.sh and setup_kcd2_dice_solver.sh (new `serve` subcommand), redeploy_agent_ready_sites.sh (new)", - "linux_configuration/features/lib/tests: test_static_site_serve.sh, test_redeploy_agent_ready_sites.sh, e2e_agent_ready_caddy.sh", - "Non-goal: no edge Caddy, sudo, pacman or rebuild changes; site content lives in each site's own repo" - ], - "changes": [ - "static_site_caddy.sh: one Caddy site-block body for both static sites (prerendered paths, real 404 via handle_errors, ai-catalog Link header) plus a dist/ presence guard; website_build.sh and kcd2_serve.sh render it instead of two drifting SPA catch-alls", - "kcd2_serve.sh readiness wait requires HTTP 200 with a body, so the non-empty 404 page no longer counts as ready", - "setup_* `serve`: re-render the inner compose + Caddyfile and recreate only that site's container", - "redeploy_agent_ready_sites.sh: serve both sites, restart the popes-site user unit, then run agent_ready url against each public URL (--verify-only skips the redeploy)" - ], - "verification": [ - { - "command": "bash linux_configuration/features/lib/tests/test_static_site_serve.sh && bash linux_configuration/features/lib/tests/test_redeploy_agent_ready_sites.sh", - "result": "pass", - "evidence": "static-site serve: 26 passed, 0 failed; redeploy agent-ready sites: 15 passed, 0 failed" - }, - { - "command": "bash linux_configuration/features/lib/tests/e2e_agent_ready_caddy.sh website && bash linux_configuration/features/lib/tests/e2e_agent_ready_caddy.sh dice", - "result": "pass", - "evidence": "e2e agent-ready website: 16 passed, 0 failed; e2e agent-ready dice: 16 passed, 0 failed (real caddy:2.8 container serving a copy of each dist/)" - }, - { - "command": "bash linux_configuration/features/redeploy_agent_ready_sites.sh --verify-only", - "result": "pass", - "evidence": "PASS kuhy.duckdns.org, dice.kuhy.duckdns.org, popes.kuhy.duckdns.org (rc=0); an earlier run hit the 10 s per-site CHECK_TIMEOUT on all three while the checker alone took 2-22 s" - }, - { - "command": "shellcheck -x on all 10 changed/new scripts; pre-commit run on the staged files", - "result": "pass", - "evidence": "shellcheck clean; pre-commit hooks pass" - } - ], - "risks": [ - "CHECK_TIMEOUT=10 in redeploy_agent_ready_sites.sh is tight: live checks took up to 22 s, which reports FAIL (timed out) on a healthy site", - "A `serve` with no dist/ is refused before docker runs; a stale dist/ is still served as-is" - ], - "rollback": [ - "git revert the commit, then run setup_personal_website.sh / setup_kcd2_dice_solver.sh to re-render the old Caddyfiles", - "curl both sites and check the landing page returns 200" - ] -} diff --git a/docs/superpowers/evidence/android-ui-scroll-to-2026-11-02.json b/docs/superpowers/evidence/android-ui-scroll-to-2026-11-02.json deleted file mode 100644 index d5677e4a..00000000 --- a/docs/superpowers/evidence/android-ui-scroll-to-2026-11-02.json +++ /dev/null @@ -1,25 +0,0 @@ -{ - "intent": "android-ui can bring a widget below the fold on screen with scroll-to.", - "scope": [ - "python_pkg/android_ui: _scroll.py, driver.py, cli.py, README, tests", - "Non-goal: MCP wrapper and rollout to other repos" - ], - "changes": [ - "Added ScrollMixin.scroll_to (swipe up until the query matches once)", - "Added the scroll-to CLI subcommand and narrowed the TODO" - ], - "verification": [ - { - "command": "pytest python_pkg/android_ui --cov=python_pkg.android_ui", - "result": "pass", - "evidence": "95 passed, every android_ui module 100% covered" - }, - { - "command": "pre-commit run --files ", - "result": "pass", - "evidence": "all hooks pass" - } - ], - "risks": ["Swipe distance is tuned for a 1080x2400 screen only by fraction"], - "rollback": ["git revert the commit", "Re-run pytest python_pkg/android_ui"] -} diff --git a/docs/superpowers/evidence/app-icons-launcher-unification-2026-10-23.json b/docs/superpowers/evidence/app-icons-launcher-unification-2026-10-23.json deleted file mode 100644 index 4a4c0072..00000000 --- a/docs/superpowers/evidence/app-icons-launcher-unification-2026-10-23.json +++ /dev/null @@ -1,45 +0,0 @@ -{ - "intent": "Every launcher icon in the shared family occupies the same circle (glyph auto-centred, furthest ink at INK_RADIUS = 340px, stroke width compensated) and every registered app carries a launcher name that the Pixel launcher never truncates.", - "scope": [ - "python_pkg/app_icons only: fit.py, labels.py, _label_widths.py (new); render.py, style.py, cli.py, generate.py, preview.py, _app_icon.py, _apps_more.py, glyphs.py, _glyph_art_extra.py, README.md; their tests", - "Non-goal: regenerating assets inside the app repos (each app repo commits its own icons); repo_contract label gate in kuhyx/utils is committed separately" - ], - "changes": [ - "fit.py: render, measure ink, derive a Placement that centres the ink box and scales it so the furthest inked pixel sits at style.INK_RADIUS, iterating because stroke width does not scale", - "style.py: INK_RADIUS = 340px plus ADAPTIVE_CANVAS_DP / INK_RADIUS_DP for vector-drawable consumers (phone-focus-mode)", - "labels.py + _label_widths.py: LABELS registry and rules (capital first letter, ASCII letters only, <= 10 chars, <= 522 wide in the Pixel launcher font); AppIcon.label reads it", - "render.py/cli.py: centre_offset, safe_box_overflow and the CLI safe-box warning removed (superseded by the fit)", - "glyphs/_glyph_art_extra/_apps_more: prompt-bubble (sufler) and camera (macro_cam) glyphs and registry entries", - "_app_icon.py: labels import moved to module top level (no cycle: labels imports only _label_widths) to satisfy PLC0415/C0415" - ], - "verification": [ - { - "command": "python3 -m pytest -q -p no:cacheprovider python_pkg/app_icons --cov=python_pkg.app_icons --cov-branch --cov-report=term-missing --cov-fail-under=0", - "result": "pass", - "evidence": "126 passed in 7.24s; every python_pkg/app_icons/*.py file at 100% line+branch (fit.py 37 stmts/8 branches, labels.py 21/10, cli.py 66/20, render.py 36/2)" - }, - { - "command": "scripts/test_changed.sh", - "result": "pass", - "evidence": "198 passed in 6.07s" - }, - { - "command": "pre-commit run --files ", - "result": "pass", - "evidence": "first run: no-noqa, ruff PLC0415 and pylint C0415 failed on the lazy import in _app_icon.py; after moving it top-level, 38 hooks Passed, 0 failed" - }, - { - "command": "python3 -m python_pkg.app_icons list && python3 -m python_pkg.app_icons preview -o /dev/shm/appicons_prev/sheet.png", - "result": "pass", - "evidence": "list shows sufler -> prompt-bubble +linux and macro_cam -> camera; preview wrote sheet.png with all 25 glyphs at visually equal size on the charcoal field" - } - ], - "risks": [ - "Glyph sizes change for every app, so each app repo shows an icon diff the next time it regenerates", - "Label width table is measured for the Pixel launcher font; other launchers may truncate differently" - ], - "rollback": [ - "git revert this commit", - "Rerun the app_icons pytest command above and the preview to confirm the old sizes return" - ] -} diff --git a/docs/superpowers/evidence/app-icons-tunedeck-headphones-2026-10-16.json b/docs/superpowers/evidence/app-icons-tunedeck-headphones-2026-10-16.json deleted file mode 100644 index b5b06399..00000000 --- a/docs/superpowers/evidence/app-icons-tunedeck-headphones-2026-10-16.json +++ /dev/null @@ -1,36 +0,0 @@ -{ - "intent": "Give the new tunedeck Flutter app (music / podcast player) an on-style launcher icon: headphones in the shared accent on the family charcoal.", - "scope": [ - "python_pkg/app_icons/_glyph_art_extra.py, glyphs.py: the `headphones` glyph", - "python_pkg/app_icons/_apps_more.py, apps.py: tutor moves to MORE_APPS (apps.py was at 249 lines) and tunedeck joins it", - "python_pkg/app_icons/tests/test_registry.py: headphones registry tests" - ], - "changes": [ - "New `headphones` glyph: stroked r=216 headband over two filled 112x216 ear cups, 288px gap between cups, ink 512x428 inside SAFE_BOX", - "tunedeck registered with accent #B8862E, linux=True (desktop is a web build in a Chrome --app window)", - "APPS merges MORE_APPS unchanged, so lookups and ordering of existing apps are the same" - ], - "verification": [ - { - "command": "PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons generate --app tunedeck --android --web", - "result": "pass", - "evidence": "tunedeck: wrote 6 asset files; wrote 5 web icons; regenerated Android mipmaps; icon.png viewed: headphones on #211D1B" - }, - { - "command": "PYTHONPATH=~/src/testsAndMisc python3 -m python_pkg.app_icons preview -o ~/data/claude-scratch/tunedeck-icon-sheet.png", - "result": "pass", - "evidence": "Sheet viewed: headphones read at full size, circle-masked and 48dp next to the other glyphs; no safe-box warning" - }, - { - "command": "python3 -m pytest -q python_pkg/app_icons/tests --cov=python_pkg.app_icons --cov-branch", - "result": "pass", - "evidence": "55 passed; every python_pkg/app_icons module 100% line and branch" - } - ], - "risks": [ - "The band's round caps show as small shoulders above the cups; intended as the headphone yoke" - ], - "rollback": [ - "git revert this commit; tunedeck and the headphones glyph leave the registry; tutor's entry is byte-identical either way" - ] -} diff --git a/docs/superpowers/evidence/app-icons-tutor-lightbulb-2026-10-12.json b/docs/superpowers/evidence/app-icons-tutor-lightbulb-2026-10-12.json deleted file mode 100644 index 3dce3236..00000000 --- a/docs/superpowers/evidence/app-icons-tutor-lightbulb-2026-10-12.json +++ /dev/null @@ -1,38 +0,0 @@ -{ - "intent": "Give the new Tutor Flutter app an on-style launcher icon (filled lightbulb in the shared accent on the family charcoal) and let the shared generator also replace the stock Flutter web favicon and PWA icons.", - "scope": [ - "python_pkg/app_icons/_glyph_art_extra.py, glyphs.py: the `lightbulb` glyph in a new glyph module (_glyph_art_more.py is at the line cap)", - "python_pkg/app_icons/apps.py: the `tutor` registry entry; four comments condensed to stay under 250 lines", - "python_pkg/app_icons/_app_icon.py, generate.py, cli.py: `generate --web` writes web/favicon.png and web/icons/Icon-*.png", - "python_pkg/app_icons/tests/: registry, web-icon and CLI tests; README usage line" - ], - "changes": [ - "New `lightbulb` glyph: filled bulb over two stroked screw-base bars, 40px gaps (> MIN_NEGATIVE_SPACE), ink 372x560 inside SAFE_BOX", - "tutor registered with accent #B8862E, linux=True like todo/home_inventory (desktop = web build in a Chrome --app window)", - "write_web_icons renders the full icon at 32/192/512 into the Flutter web template paths; maskable variants reuse it because SAFE_BOX's half-diagonal (396px) is inside the 40% maskable radius (410px)", - "--web skips apps without a web/ directory" - ], - "verification": [ - { - "command": "PATH=~/sdk/fvm/versions/3.47.7/bin:$PATH PYTHONPATH=. python3 -m python_pkg.app_icons generate --app tutor --android --web", - "result": "pass", - "evidence": "tutor: wrote 6 asset files; wrote 5 web icons; regenerated Android mipmaps; mipmap-xxxhdpi and web Icon-192 viewed: lightbulb on #211D1B, no Flutter logo" - }, - { - "command": "PYTHONPATH=. python3 -m python_pkg.app_icons preview -o ~/data/claude-scratch/tutor-icons-sheet.png", - "result": "pass", - "evidence": "Sheet viewed: lightbulb reads at full size, circle-masked and 48dp next to the other 21 glyphs; safe_box_overflow (0, 0)" - }, - { - "command": ".venv/bin/python -m pytest -q python_pkg/app_icons --cov=python_pkg/app_icons --cov-branch", - "result": "pass", - "evidence": "53 passed; every python_pkg/app_icons module 100% line and branch" - } - ], - "risks": [ - "`generate --android` runs `dart run`, which needs the fvm 3.47.7 SDK first on PATH (system dart 3.13.3 is below the app's ^3.13.5)" - ], - "rollback": [ - "git revert this commit; tutor and the lightbulb glyph leave the registry and --web disappears; other apps' icons are byte-identical either way" - ] -} diff --git a/docs/superpowers/evidence/ci-green-pin-only-exemption-2026-11-01.json b/docs/superpowers/evidence/ci-green-pin-only-exemption-2026-11-01.json deleted file mode 100644 index aef2f030..00000000 --- a/docs/superpowers/evidence/ci-green-pin-only-exemption-2026-11-01.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "intent": "A red CI baseline no longer blocks a commit or push that touches only dependency-pin files, so a pin bump can fix a red freshness gate.", - "scope": [ - "meta/scripts/check_ci_green.sh: PIN_FILE_RE, changed_files, only_pin_files and the exemption branch", - "linux_configuration/tests/test_check_ci_green.bats (new)", - "Non-goal: any other bypass; everything else stays fail-closed on a red baseline" - ], - "changes": [ - "On a red baseline the hook exits 0 when every changed file is .fvmrc, pubspec.yaml/.lock, package.json, pnpm-lock.yaml, requirements*.txt or pyproject.toml, and prints an EXEMPTION FIRED line listing them", - "Scope is the push range (PRE_COMMIT_FROM_REF..TO_REF) when set, else the staged files; empty or unusable scope is not exempt" - ], - "verification": [ - { - "command": "bats linux_configuration/tests/test_check_ci_green.bats", - "result": "pass", - "evidence": "8/8 ok: green passes, red blocks code, empty scope, pin-only exempt, mixed blocked, lookalikes blocked, push range, bad range fails closed" - }, - { - "command": "pre-commit run --files meta/scripts/check_ci_green.sh linux_configuration/tests/test_check_ci_green.bats", - "result": "pass", - "evidence": "no hook output beyond Passed/Skipped" - } - ], - "risks": [ - "A pin-only change can still break the build; the pre-push CI mirror and CI itself remain the guard", - "A poisoned pin file is exempt from the red-baseline check only, not from other hooks" - ], - "rollback": [ - "git revert the commit; the hook returns to blocking every commit on a red baseline", - "Validate by running bats linux_configuration/tests/test_check_ci_green.bats is gone and the hook still passes on green" - ] -} diff --git a/docs/superpowers/evidence/ci-tool-pins-shfmt-prettier-2026-10-22.json b/docs/superpowers/evidence/ci-tool-pins-shfmt-prettier-2026-10-22.json deleted file mode 100644 index 1b703865..00000000 --- a/docs/superpowers/evidence/ci-tool-pins-shfmt-prettier-2026-10-22.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "intent": "CI's pinned formatter versions match the newest stable releases and the versions the local hooks run, so local and CI never disagree on formatting.", - "scope": [ - ".github/workflows/pre-commit.yml (SHFMT_VERSION, SHFMT_SHA256, PRETTIER_VERSION)", - "linux_configuration/.githooks/lib/common.sh (PINNED_TOOL_VERSIONS)", - "Non-goal: the dead nested linux_configuration/.github/workflows/shell-check.yml (GitHub never runs it); the shared dep_freshness gate" - ], - "changes": [ - "shfmt v3.13.1 -> v3.14.1 (newest stable, GitHub releases/latest), SHA256 76e77641... taken from a real download and matching the release asset digest", - "prettier 3.9.5 -> 3.9.10 (npm dist-tag latest); local nvm-global prettier upgraded to 3.9.10 to match", - "shellcheck stays v0.11.0: already the newest stable release and what pacman ships locally" - ], - "verification": [ - { - "command": "curl shfmt_v3.14.1_linux_amd64 && sha256sum && shfmt --version", - "result": "pass", - "evidence": "76e77641faa025814b77f153b29796b8e6fa2fca03e0c76a691608b86c7ea7bf, v3.14.1" - }, - { - "command": "source linux_configuration/.githooks/lib/common.sh; check_pinned_tool_versions", - "result": "pass", - "evidence": "no drift warning, rc=0 (local shfmt 3.14.1, prettier 3.9.10, shellcheck 0.11.0)" - }, - { - "command": "pre-commit run prettier --hook-stage pre-push --all-files (prettier 3.9.10)", - "result": "pass", - "evidence": "Passed: the patch bump reformats nothing in the repo" - }, - { - "command": "scripts/check_dependency_freshness.sh .github/workflows/pre-commit.yml", - "result": "pass", - "evidence": "rc=0; note its workflow parser only reads flutter/node/python-version, so it does not see these env pins" - } - ], - "risks": [ - "A wrong SHA would only fail in CI's pylint group; mitigated by hashing a real download", - "Other developer machines still on shfmt 3.13.1 or prettier 3.9.5 now get the common.sh drift warning" - ], - "rollback": [ - "git revert this commit", - "Check that the pre-commit workflow's 'Install prettier and shfmt (pinned)' step goes green" - ] -} diff --git a/docs/superpowers/evidence/deps-bump-pillow13-2026-10-17.json b/docs/superpowers/evidence/deps-bump-pillow13-2026-10-17.json deleted file mode 100644 index b118b389..00000000 --- a/docs/superpowers/evidence/deps-bump-pillow13-2026-10-17.json +++ /dev/null @@ -1,35 +0,0 @@ -{ - "intent": "Turn main's red Pre-commit CI (dependency-freshness, 6+ findings since 6383bd74) green by moving every flagged pin to latest stable.", - "scope": [ - "meta/requirements.txt, meta/requirements-test.txt, python_pkg/random_jpg/requirements.txt", - "Non-goal: .pre-commit-config.yaml hook revs (not flagged)" - ], - "changes": [ - "anthropic 1.15.0, hypothesis 6.170.1, pipdeptree 4.2.8, pre-commit 4.7.0, reorder-python-imports 3.19.0, ruff 0.17.1", - "pillow 12.3.0 -> 13.0.0 (major) in all three manifests" - ], - "verification": [ - { - "command": "pre-commit run dependency-freshness --all-files", - "result": "pass", - "evidence": "dependencies on newest stable....Passed (was FAILED: 6 findings in CI run 38918522094)" - }, - { - "command": "python3 -m pytest -q python_pkg/artgate python_pkg/random_jpg (pillow 13.0.0 installed)", - "result": "pass", - "evidence": "128 passed in 0.21s; artgate and random_jpg are the only PIL importers" - }, - { - "command": "uv pip compile -q meta/requirements.txt / meta/requirements-test.txt", - "result": "pass", - "evidence": "both resolve, rc=0" - } - ], - "risks": [ - "pillow 13 major: API removals could hit untested PIL paths in artgate/random_jpg" - ], - "rollback": [ - "git revert this commit", - "re-run pre-commit run dependency-freshness --all-files" - ] -} diff --git a/docs/superpowers/evidence/drop-pacman-policy-lists-2026-10-17.json b/docs/superpowers/evidence/drop-pacman-policy-lists-2026-10-17.json deleted file mode 100644 index fdb7eb5d..00000000 --- a/docs/superpowers/evidence/drop-pacman-policy-lists-2026-10-17.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "intent": "The pacman wrapper no longer has blocked-keyword, white or grey lists (removed in digital-wellbeing e2a7176); stop the services checker and docs from expecting them.", - "scope": [ - "linux_configuration/periodic_background/lib/services_wrappers.sh and its test", - "linux_configuration/periodic_background/lib/services_browser.sh comment + note", - "linux_configuration/.github/copilot-instructions.md and linux_configuration/docs pacman docs", - "Non-goal: the wrapper itself lives in ~/src/digital-wellbeing" - ], - "changes": [ - "check_pacman_wrapper only checks words.txt as a supporting file, no longer pacman_blocked_keywords.txt / pacman_whitelist.txt", - "test_services_wrappers.sh stages and removes only words.txt", - "VirtualBox n/a note no longer claims it is blocked by pacman policy", - "Docs drop the list files, greylist challenge and comparisons; integrity/immutability text now names the lock lib and pw_*.sh" - ], - "verification": [ - { - "command": "bash linux_configuration/periodic_background/lib/tests/run_all.sh", - "result": "pass", - "evidence": "test_services_wrappers.sh: 29 passed, 0 failed; All check_and_enable_services test files passed." - }, - { - "command": "bash linux_configuration/periodic_background/check_and_enable_services.sh --status", - "result": "pass", - "evidence": "Supporting file exists: /usr/local/bin/words.txt; no list-file lines; 'VirtualBox not installed โ€” not applicable'. Drift flagged as expected until the hourly reinstall deploys digital-wellbeing e2a7176." - } - ], - "risks": [ - "VirtualBox is now installable without friction; only post-transaction VM removal remains" - ], - "rollback": [ - "git revert this commit together with digital-wellbeing e2a7176", - "Re-run install_pacman_wrapper.sh and check_and_enable_services.sh --status" - ] -} diff --git a/docs/superpowers/evidence/hypothesis-pin-bump-2026-10-22.json b/docs/superpowers/evidence/hypothesis-pin-bump-2026-10-22.json deleted file mode 100644 index 537cfc14..00000000 --- a/docs/superpowers/evidence/hypothesis-pin-bump-2026-10-22.json +++ /dev/null @@ -1,19 +0,0 @@ -{ - "intent": "hypothesis pin in meta/requirements.txt is the newest stable release again, so the dependency-freshness CI job goes green.", - "scope": [ - "meta/requirements.txt (hypothesis only)", - "Non-goal: typescript 6.0.3 allowlist entry (unchanged, predicate still blocking)" - ], - "changes": [ - "hypothesis 6.170.5 -> 6.170.6 (released after the previous bump landed)" - ], - "verification": [ - { - "command": "scripts/check_dependency_freshness.sh --all --strict", - "result": "pass", - "evidence": "CI run for e4ca3717 reported exactly one finding: pypi:hypothesis 6.170.5 -> 6.170.6" - } - ], - "risks": ["patch release of a test-only dependency"], - "rollback": ["git revert this commit"] -} diff --git a/docs/superpowers/evidence/i3-focus-block-milestones-2026-11-10.json b/docs/superpowers/evidence/i3-focus-block-milestones-2026-11-10.json deleted file mode 100644 index b09da486..00000000 --- a/docs/superpowers/evidence/i3-focus-block-milestones-2026-11-10.json +++ /dev/null @@ -1,31 +0,0 @@ -{ - "intent": "The i3 focus block turns red when an interview milestone is missed and shows a suitcase while a trip question is open; no new text.", - "scope": [ - "linux_configuration/i3blocks/focus_project.sh", - "linux_configuration/tests/test_i3blocks_focus_project.sh", - "Non-goal: the block still renders only daily-limits' cached focus field" - ], - "changes": [ - "jq render picks #FF5555 when focus.missed is true, over green and yellow", - "jq render appends the FontAwesome suitcase (U+F0F2) when a trip_ask:* milestone is pending or missed; malformed milestones are ignored" - ], - "verification": [ - { - "command": "bash linux_configuration/tests/test_i3blocks_focus_project.sh", - "result": "pass", - "evidence": "red first (missed block stayed yellow), then all checks passed incl. red, suitcase, no-suitcase and malformed milestone cases" - }, - { - "command": "shellcheck linux_configuration/i3blocks/focus_project.sh linux_configuration/tests/test_i3blocks_focus_project.sh", - "result": "pass", - "evidence": "no findings" - } - ], - "risks": [ - "Suitcase glyph needs the bar's FontAwesome font (installed: Font Awesome 7 Free Solid)" - ], - "rollback": [ - "git revert the commit; the live ~/.config/i3blocks/focus_project.sh is a symlink to the repo file", - "Check the block renders yellow/green again" - ] -} diff --git a/docs/superpowers/evidence/i3-focus-suitcase-emoji-2026-11-11.json b/docs/superpowers/evidence/i3-focus-suitcase-emoji-2026-11-11.json deleted file mode 100644 index 8c65f1ce..00000000 --- a/docs/superpowers/evidence/i3-focus-suitcase-emoji-2026-11-11.json +++ /dev/null @@ -1,30 +0,0 @@ -{ - "intent": "Turn main's Shell tests CI green again: the focus_project i3blocks block used a Font Awesome private-use codepoint (U+F0F2) for the interview-trip suitcase, which the i3blocks config checks forbid.", - "scope": [ - "linux_configuration/i3blocks/focus_project.sh", - "linux_configuration/tests/test_i3blocks_focus_project.sh", - "Non-goal: any other change to the focus block" - ], - "changes": [ - "SUITCASE is now the luggage emoji U+1F9F3 (rendered by Noto Color Emoji, like the block's existing target emoji) in the block and its test" - ], - "verification": [ - { - "command": "bash linux_configuration/tests/test_i3blocks_efficiency.sh", - "result": "pass", - "evidence": "exit 0; was the failing check on CI run 43017516672" - }, - { - "command": "bash linux_configuration/tests/test_i3blocks_focus_project.sh", - "result": "pass", - "evidence": "exit 0, suitcase assertions use the emoji" - } - ], - "risks": [ - "The suitcase now renders as a colour emoji instead of a monochrome Font Awesome glyph" - ], - "rollback": [ - "git revert this commit", - "Shell tests CI goes red again on the private-use check" - ] -} diff --git a/docs/superpowers/evidence/i3blocks-focus-project-2026-11-02.json b/docs/superpowers/evidence/i3blocks-focus-project-2026-11-02.json deleted file mode 100644 index 8f505333..00000000 --- a/docs/superpowers/evidence/i3blocks-focus-project-2026-11-02.json +++ /dev/null @@ -1,36 +0,0 @@ -{ - "intent": "kuhy sees the active focus project in i3bar: a focus_project block renders the focus field daily-limits now writes to its cache. A click takes him to the work: left opens the tutor focus screen plus the work URL (focus_project.open), middle only the tutor, right daily-limits --gui.", - "scope": [ - "linux_configuration/i3blocks/focus_project.sh, the [focus_project] stanza in linux_configuration/i3blocks/config, linux_configuration/tests/test_i3blocks_focus_project.sh", - "Non-goal: no focus logic here (focus_project.status() decides); daily-limits owns the cache" - ], - "changes": [ - "New block: `๐ŸŽฏ /`, green at the daily target, hidden with no project or a missing/stale/garbage cache; jq re-parse only on cache mtime change", - "Stanza has signal=11 so daily-limits can refresh it with pkill -RTMIN+11 -x i3blocks", - "Clicks: left `python3 -m focus_project.open`, middle `--no-site`, right `daily-limits --gui`" - ], - "verification": [ - { - "command": "bash linux_configuration/tests/test_i3blocks_focus_project.sh", - "result": "pass", - "evidence": "focus_project block: all checks passed" - }, - { - "command": "bash ~/.config/i3blocks/focus_project.sh (live cache after daily-limits.service)", - "result": "pass", - "evidence": "๐ŸŽฏ HackerRank prep 0/120, #F1FA8C" - }, - { - "command": "bash linux_configuration/tests/test_i3blocks_focus_project.sh", - "result": "pass", - "evidence": "clicks section: all checks passed (red first: left click ran '--gui')" - } - ], - "risks": [ - "The running i3bar loads the stanza only after its next restart; until then the poke is harmless (i3blocks 1.5 survived an unconfigured RTMIN+11)", - "A click needs focus_project >= 0.5.0 in the system python user site" - ], - "rollback": [ - "git revert the commit and remove the symlink ~/.config/i3blocks/focus_project.sh" - ] -} diff --git a/docs/superpowers/evidence/i3blocks-leisure-live-2026-10-19.json b/docs/superpowers/evidence/i3blocks-leisure-live-2026-10-19.json deleted file mode 100644 index 834cdc7b..00000000 --- a/docs/superpowers/evidence/i3blocks-leisure-live-2026-10-19.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "intent": "Phase 2 of the leisure rollout, dormant until go-live: once daily-limits' cache says leisure_active, the gaming block reads '๐Ÿ›‹ Leisure ...' (same colours) and the SHADOW block hides itself.", - "scope": [ - "linux_configuration/i3blocks/gaming_budget.sh, leisure_shadow.sh and their two test scripts", - "Non-goal: no accounting, no new keys written; a missing/false key keeps today's output" - ], - "changes": [ - "gaming_budget.sh: jq picks the label (๐ŸŽฎ or '๐Ÿ›‹ Leisure') from .leisure_active == true; a 5th render line carries it to the stale state; an old 4-line render still reads as ๐ŸŽฎ", - "gaming_budget.sh: generated_at is floored and a non-numeric one says 'no data' (it used to exit 1 on a fractional timestamp)", - "leisure_shadow.sh: when live the render is empty text + 'hidden' colour sentinel and the block prints nothing, exit 0, whatever the cache age" - ], - "verification": [ - { - "command": "bash linux_configuration/tests/test_i3blocks_gaming_budget.sh && bash linux_configuration/tests/test_i3blocks_leisure_shadow.sh && bash linux_configuration/tests/test_i3blocks_efficiency.sh", - "result": "pass", - "evidence": "All gaming_budget checks passed. All leisure_shadow checks passed. All i3blocks efficiency regression tests passed. (both new suites RED before the change)" - }, - { - "command": "shellcheck linux_configuration/i3blocks/*.sh linux_configuration/tests/test_i3blocks_{gaming_budget,leisure_shadow}.sh", - "result": "pass", - "evidence": "no findings" - }, - { - "command": "fixture caches (daily-limits sample report, leisure_active false/true) through both blocks", - "result": "pass", - "evidence": "off: '๐ŸŽฎ 1h26 left ยท 1h34/3h00 ...' + '๐Ÿ›‹ SHADOW 3h12 left ยท 1h48 used'; on: '๐Ÿ›‹ Leisure 1h26 left ยท 1h34/3h00 ...' + (nothing), all exit 0" - } - ], - "risks": [ - "One tick after deploy the old 4-line render is read: shown as ๐ŸŽฎ, never an error", - "Hidden shadow block depends on daily-limits >= ed274f2 writing leisure_active" - ], - "rollback": [ - "git revert the commit; the symlinks in ~/.config/i3blocks pick it up on the next tick", - "Check both blocks render from the live cache again" - ] -} diff --git a/docs/superpowers/evidence/i3blocks-leisure-shadow-2026-10-19.json b/docs/superpowers/evidence/i3blocks-leisure-shadow-2026-10-19.json deleted file mode 100644 index 52500283..00000000 --- a/docs/superpowers/evidence/i3blocks-leisure-shadow-2026-10-19.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "intent": "Show the shadow week's would-be leisure budget on i3bar: `๐Ÿ›‹ SHADOW 3h12 left ยท 1h48 used`, yellow under 30 min, red `WOULD BLOCK` at 0, never urgent/blinking, honest `โฑ? no data` while the enforcer's C4 fields are absent.", - "scope": [ - "linux_configuration/i3blocks/leisure_shadow.sh (new block), its [leisure_shadow] config entry right after [gaming_budget]", - "linux_configuration/tests/test_i3blocks_leisure_shadow.sh + shell-tests.yml list", - "Non-goal: renaming the gaming block (Phase 2); the accounting (steam-backlog-enforcer) and the cache (daily-limits) live elsewhere" - ], - "changes": [ - "leisure_shadow.sh renders daily-limits' cache `leisure_shadow` (contract C5) with gaming_budget.sh's render-cache + single jq pass; always exits 0 so i3blocks never marks it urgent", - "config: [leisure_shadow] block, interval=30, next to [gaming_budget]" - ], - "verification": [ - { - "command": "bash linux_configuration/tests/test_i3blocks_leisure_shadow.sh", - "result": "pass", - "evidence": "All leisure_shadow checks passed (text, 30/29/1/0 boundaries, no data x3, stale, garbage, exit 0 + 3 lines, jq once per mtime, config placement)" - }, - { - "command": "DAILY_LIMITS_CACHE= bash linux_configuration/i3blocks/leisure_shadow.sh", - "result": "pass", - "evidence": "๐Ÿ›‹ SHADOW 0h30 left ยท 9h30 used / ๐Ÿ›‹ 0h30 / #F8F8F2; live cache (no C4 yet): ๐Ÿ›‹ SHADOW โฑ? no data" - }, - { - "command": "shellcheck linux_configuration/i3blocks/leisure_shadow.sh linux_configuration/tests/test_i3blocks_leisure_shadow.sh; bash linux_configuration/tests/test_i3blocks_efficiency.sh", - "result": "pass", - "evidence": "shellcheck clean; All i3blocks efficiency regression tests passed" - } - ], - "risks": [ - "Until steam-backlog-enforcer writes the C4 fields the block reads `โฑ? no data` (by design)", - "One more 30 s block: a steady tick forks nothing (render cache), jq only when the cache changes" - ], - "rollback": [ - "git revert the commit and rm ~/.config/i3blocks/leisure_shadow.sh, then pkill -x i3blocks; i3-msg reload", - "Check the bar shows the gaming block again with no gap" - ] -} diff --git a/docs/superpowers/evidence/i3blocks-leisure-shadow-generated-at-2026-10-19.json b/docs/superpowers/evidence/i3blocks-leisure-shadow-generated-at-2026-10-19.json deleted file mode 100644 index 354d5629..00000000 --- a/docs/superpowers/evidence/i3blocks-leisure-shadow-generated-at-2026-10-19.json +++ /dev/null @@ -1,36 +0,0 @@ -{ - "intent": "leisure_shadow.sh always exits 0 and prints the honest '๐Ÿ›‹ SHADOW โฑ? no data' fallback when the daily-limits cache has no usable generated_at, instead of dying with 'null: unbound variable' and an empty i3blocks block.", - "scope": [ - "linux_configuration/i3blocks/leisure_shadow.sh", - "linux_configuration/tests/test_i3blocks_leisure_shadow.sh", - "Non-goal: no change to the cache producer (daily-limits) or the stale threshold" - ], - "changes": [ - "jq renders generated_at floored when numeric, 'none' otherwise; the script emits the orange no-data fallback for any non-integer value before the age arithmetic", - "Test covers generated_at absent, null and a string (exit 0, no-data text, orange) and a fractional timestamp still rendering normally" - ], - "verification": [ - { - "command": "bash linux_configuration/tests/test_i3blocks_leisure_shadow.sh", - "result": "pass", - "evidence": "RED before the fix: 'FAIL: generated_at 'absent' still exits 0 (expected '0', actual '1')'; after: 'All leisure_shadow checks passed.'" - }, - { - "command": "shellcheck linux_configuration/i3blocks/leisure_shadow.sh linux_configuration/tests/test_i3blocks_leisure_shadow.sh", - "result": "pass", - "evidence": "no findings" - }, - { - "command": "DAILY_LIMITS_CACHE= bash linux_configuration/i3blocks/leisure_shadow.sh", - "result": "pass", - "evidence": "printed '๐Ÿ›‹ SHADOW โฑ? no data' / '๐Ÿ›‹ โฑ?' / '#FFB86C', rc=0; against the live cache: '๐Ÿ›‹ SHADOW 6h34 left ยท 0h26 used', rc=0" - } - ], - "risks": [ - "A producer that writes generated_at as a numeric string would now show 'no data' rather than a time; daily-limits writes a JSON number" - ], - "rollback": [ - "git revert the commit", - "Re-run test_i3blocks_leisure_shadow.sh and check the bar block renders" - ] -} diff --git a/docs/superpowers/evidence/i3blocks-tutor-minutes-2026-10-12.json b/docs/superpowers/evidence/i3blocks-tutor-minutes-2026-10-12.json deleted file mode 100644 index 3f0ce9ba..00000000 --- a/docs/superpowers/evidence/i3blocks-tutor-minutes-2026-10-12.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "intent": "The i3 tutor block shows today's credited tutor minutes against the 60-minute daily cap; it used to count ledger rows against 4 and hid after 4 credited minutes since earned_time 0.8.0 made each row a minute count.", - "scope": [ - "linux_configuration/i3blocks/tutor.sh, linux_configuration/tests/test_i3blocks_tutor.sh", - "Non-goal: no HMAC check (earned_time stays the authority)" - ], - "changes": [ - "Sum detail.minutes of today's credit rows (legacy rows without it count 15, as earned_time does); TARGET 4 -> 60", - "Test fixture takes day:kind[:minutes]; new cases for summing, legacy rows and the 60/60 hidden state" - ], - "verification": [ - { - "command": "bash linux_configuration/tests/test_i3blocks_tutor.sh", - "result": "pass", - "evidence": "tutor block: all checks passed" - }, - { - "command": "bash linux_configuration/i3blocks/tutor.sh", - "result": "pass", - "evidence": "โš™ tutor 0/60 on the live ledger; same jq on 2026-10-11 gives 60, matching earned_time's 60 units that day" - } - ], - "risks": [ - "A ledger row with non-numeric minutes would make jq fail and show the orange 'ledger unreadable' state" - ], - "rollback": [ - "git revert the commit; the block goes back to counting rows / 4" - ] -} diff --git a/docs/superpowers/evidence/lan-gateway-warp-window-2026-10-25.json b/docs/superpowers/evidence/lan-gateway-warp-window-2026-10-25.json deleted file mode 100644 index e19a01d4..00000000 --- a/docs/superpowers/evidence/lan-gateway-warp-window-2026-10-25.json +++ /dev/null @@ -1,51 +0,0 @@ -{ - "intent": "LAN devices cannot bypass the PC's DNS blocklist: gateway mode routes them through the PC (forced DNS, DoH/DoT dropped), the Cloudflare WARP tunnel is dropped, and kuhy can open WARP for the LAN only Mon/Fri 09:00-15:30 via `warp-home on` on the work laptop, which otherwise keeps WARP off at home so the laptop stays online with the blocklist.", - "scope": [ - "linux_configuration/features: setup_dns_blocker.sh (gateway/gateway-off), setup_wireguard_ssh.sh, lib/{dns_gateway,dns_units,wg_gateway,wg_firewall,wg_sshd}.sh, warp_window.sh (PC), warp_home.sh (laptop, no root)", - "linux_configuration/lib/extracted_repos.sh: resolve ~/src/ first (nightly dns-blocklist-refresh had failed since 2026-09-11)", - "Non-goal: a blocklist inside WARP itself (laptop is enrolled in the employer's Zero Trust org 'aiclearing'); IPv6 (no native v6 route on the LAN)" - ], - "changes": [ - "Gateway mode: DHCP router=PC, nft lan_gateway table DNATs LAN :53 to dnsmasq and masquerades; forward drops DoH resolvers and :853", - "WARP drop in the gateway forward chain: 162.159.192.0/24, 162.159.193.0/24 (WireGuard), 162.159.197.0/24 (MASQUE incl. TCP 443 fallback) fully; UDP only to shared consumer ranges 162.159.192.0/22, 162.159.204.0/22, 188.114.96.0/22; no LAN-wide IPsec port drops", - "nft set warp_open (interval,timeout): warp_window.sh open fills it with 0.0.0.0/0 timing out at 15:30, only Mon/Fri 09:00-15:30 by the PC clock; reachable from the laptop via a restrict,from=LAN forced-command key (open|status only; sudoers env_keep SSH_ORIGINAL_COMMAND)", - "warp_home.sh: user systemd timer every 30 s disconnects WARP at home outside a window, or when the PC reports the window closed early; leaves WARP alone on other networks; 15:25 warning", - "dnsmasq: upstreams 1.1.1.1 + 9.9.9.9, filter-AAAA, Firefox DoH canary, DoH hostnames to 0.0.0.0; DHCP lease 2h" - ], - "verification": [ - { - "command": "meta/scripts/shell_coverage_jail.sh --subject linux_configuration/features/lib/tests/run_all.sh --min 0 --fail-on-case-error", - "result": "pass", - "evidence": "rc=0; test_warp_window 33/0, test_warp_home 35/0, test_wg_firewall 37/0, test_dns_gateway 15/0, test_dns_units 12/0 (unit runs). test_extracted_repos.sh and test_setup_dns_blocker.sh PASS" - }, - { - "command": "vmbox: sudo e2e_warp_forward_drop.sh (netns, real nft) red without the WARP drops, then green", - "result": "pass", - "evidence": "passed in vmbox: red 4 FAIL (WARP probes reached the far side); green 9 OK incl. tcp 188.114.96.3:443 and udp 4500 elsewhere passing, open window lets WARP through, 3 s timeout closes it" - }, - { - "command": "vmbox (clock Mon 2026-10-26 10:00): warp_window.sh install + ssh forced command", - "result": "pass", - "evidence": "passed in vmbox: open -> seconds_left=19800, status open (expires 5h29m59s); close/id/'open; id' refused over ssh; Tuesday refused; Mon 15:29:58 -> 2 s then closed; 15:30:01 refused" - }, - { - "command": "host: setup_wireguard_ssh.sh allow-lan-gateway with auto-revert armed, cancelled after checks; setup_wireguard_ssh.sh verify", - "result": "pass", - "evidence": "host: PC example.com 200, docker egress OK, revert timer cancelled, verify reports nftables.conf matches; warp_open set live" - }, - { - "command": "laptop 192.168.1.21 over ssh: warp-home on / status / warp-cli connect then wait", - "result": "pass", - "evidence": "host+laptop: Sunday on refused by the PC; with WARP blocked the tick disconnected a reconnected WARP after 27 s; example.com 200, www.ubereats.com resolves 0.0.0.0 even via 8.8.8.8; kuhy confirmed. Real Mon/Fri open on the host not yet exercised" - } - ], - "risks": [ - "Any re-apply of the PC nftables ruleset empties warp_open mid-window; the laptop tick detects 'closed' and turns WARP off, kuhy reruns warp-home on", - "WARP fails closed: if the laptop agent stops running, the laptop is offline at home whenever WARP is on", - "Shared consumer-WARP ranges are UDP-only drops; QUIC to sites in 188.114.96.0/22 falls back to TCP" - ], - "rollback": [ - "sudo linux_configuration/features/setup_dns_blocker.sh gateway-off (removes gateway mode incl. WARP drops); git revert this commit", - "Laptop: systemctl --user disable --now warp-home.timer; PC: remove /usr/local/sbin/warp-window, /etc/sudoers.d/warp-window and the warp-home authorized_keys line; confirm LAN devices browse via the Funbox" - ] -} diff --git a/docs/superpowers/evidence/librewolf-local-gio-2026-11-01.json b/docs/superpowers/evidence/librewolf-local-gio-2026-11-01.json deleted file mode 100644 index d666d421..00000000 --- a/docs/superpowers/evidence/librewolf-local-gio-2026-11-01.json +++ /dev/null @@ -1,32 +0,0 @@ -{ - "intent": "LibreWolf opens in seconds instead of ~4 min after login: it no longer waits on gvfs D-Bus calls that hit the 25 s timeout.", - "scope": [ - "linux_configuration/scripts/librewolf-local-gio.sh (symlinked as ~/.local/bin/librewolf)", - "meta/requirements.txt, meta/requirements-test.txt: stale pins that kept the Pre-commit CI baseline red", - "Non-goal: the .desktop entry (calls /usr/lib/librewolf/librewolf directly); launcher is PATH-based" - ], - "changes": [ - "PATH wrapper exec's /usr/bin/librewolf with GIO_USE_VFS=local, same pattern as krita-scaled.sh", - "anthropic 2.1.0->2.3.0 (CI finding) plus 17 other patch/minor pins bumped to newest stable" - ], - "verification": [ - { - "command": "check_librewolf_gio.sh (Xvfb, throwaway profile, reads /proc//environ)", - "result": "pass", - "evidence": "wrapper on PATH: PASS; /usr/bin/librewolf only: FAIL: GIO_USE_VFS not set; user confirmed real launch is fast" - }, - { - "command": "scripts/check_dependency_freshness.sh meta/requirements.txt meta/requirements-test.txt && uv pip compile -p 3.14 both", - "result": "pass", - "evidence": "exit=0, no findings; RESOLVES" - } - ], - "risks": [ - "GTK dialogs inside LibreWolf lose gvfs URIs (smb://, sftp://)", - "Minor bumps (flake8 7.5, pyflakes 4.1, prospector 1.20, python-kasa 0.12) may surface new lint findings" - ], - "rollback": [ - "rm ~/.local/bin/librewolf restores /usr/bin/librewolf; git revert for the pins", - "After rollback: `command -v librewolf` prints /usr/bin/librewolf" - ] -} diff --git a/docs/superpowers/evidence/mcp-servers-path-repoint-2026-11-10.json b/docs/superpowers/evidence/mcp-servers-path-repoint-2026-11-10.json deleted file mode 100644 index 0aecde24..00000000 --- a/docs/superpowers/evidence/mcp-servers-path-repoint-2026-11-10.json +++ /dev/null @@ -1,34 +0,0 @@ -{ - "intent": "blender-mcp-host/serve and the session_autopsy hook test point at the relocated MCP server checkouts (~/.local/share/mcp-servers, ~/.claude/mcp-servers) instead of the removed ~/src/mcp-servers.", - "scope": [ - "linux_configuration/scripts/blender-mcp-host", - "linux_configuration/scripts/blender-mcp-serve", - "linux_configuration/tests/test_session_autopsy_hooks.py", - "Non-goal: moving or re-cloning the MCP servers themselves" - ], - "changes": [ - "blender-mcp-host: ADDON_PATH and the embedded start_addon spec path now /home/kuhy/.local/share/mcp-servers/blender-mcp/addon.py", - "blender-mcp-serve: SERVER_DIR now /home/kuhy/.local/share/mcp-servers/blender-mcp", - "test_session_autopsy_hooks.py: expected PYTHONPATH is {home}/.claude/mcp-servers/session-autopsy; comment names kuhyx/claude-config" - ], - "verification": [ - { - "command": "python -m pytest linux_configuration/tests/test_session_autopsy_hooks.py -q -p no:randomly --no-cov", - "result": "pass", - "evidence": "12 passed in 4.12s" - }, - { - "command": "grep -c src/mcp-servers linux_configuration/scripts/blender-mcp-host linux_configuration/scripts/blender-mcp-serve linux_configuration/tests/test_session_autopsy_hooks.py", - "result": "pass", - "evidence": "0 matches in each of the three files" - } - ], - "risks": [ - "Hardcoded absolute /home/kuhy paths still break on another account or machine", - "If the checkout under ~/.local/share/mcp-servers is missing, blender-mcp-serve fails at start" - ], - "rollback": [ - "git revert the commit; paths return to ~/src/mcp-servers", - "Re-run test_session_autopsy_hooks.py and start blender-mcp-serve once to confirm" - ] -} diff --git a/docs/superpowers/evidence/monitor-autoconfig-2026-11-11.json b/docs/superpowers/evidence/monitor-autoconfig-2026-11-11.json deleted file mode 100644 index ee8cdb87..00000000 --- a/docs/superpowers/evidence/monitor-autoconfig-2026-11-11.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "intent": "Every monitor kuhy connects runs at its native resolution and highest refresh rate automatically, with DP-0 primary on the left, without running xrandr by hand.", - "scope": [ - "linux_configuration/features/monitor_layout.py, monitor_autoconfig.py, setup_monitor_autoconfig.sh, systemd/monitor-autoconfig.service", - "linux_configuration/tests/test_monitor_layout.py, test_monitor_autoconfig.py, conftest.py; meta/pyproject.toml pylint init-hook path", - "Non-goal: reverting deliberate mode changes (games, manual xrandr); only connect/disconnect triggers a re-layout" - ], - "changes": [ - "monitor_layout.py: parses xrandr --query and plans one row: native size at max refresh, preferred primary leftmost, disconnected outputs holding a CRTC switched off; returns [] when already there", - "monitor_autoconfig.py: systemd user service; RandR version handshake, listens for RROutputChangeNotify, settles 1 s, retries while a connected monitor lists no modes, logs and survives a failed xrandr", - "setup_monitor_autoconfig.sh installs deps, the user unit (WantedBy graphical-session.target) and starts it" - ], - "verification": [ - { - "command": "python3 -m pytest linux_configuration/tests/test_monitor_layout.py linux_configuration/tests/test_monitor_autoconfig.py --cov=monitor_layout --cov=monitor_autoconfig --cov-branch", - "result": "pass", - "evidence": "23 passed, 100% line+branch coverage on both modules" - }, - { - "command": "linux_configuration/features/setup_monitor_autoconfig.sh", - "result": "pass", - "evidence": "unit enabled and active; layout DP-0 3840x2160@144 + HDMI-0 2560x1440@143.98 left unchanged (dry-run plan empty)" - }, - { - "command": "RandR probe with/without xrandr_query_version", - "result": "pass", - "evidence": "no events before the handshake, CrtcChange/ScreenChange events after it" - } - ], - "risks": [ - "Physical hotplug not exercised on the real machine (kuhy declined the replug check); relies on the NVIDIA driver emitting RROutputChangeNotify on connect" - ], - "rollback": [ - "systemctl --user disable --now monitor-autoconfig.service; git revert", - "xrandr layout stays as last applied" - ] -} diff --git a/docs/superpowers/evidence/monitor-autoconfig-boot-2026-11-12.json b/docs/superpowers/evidence/monitor-autoconfig-boot-2026-11-12.json deleted file mode 100644 index c251c1f7..00000000 --- a/docs/superpowers/evidence/monitor-autoconfig-boot-2026-11-12.json +++ /dev/null @@ -1,38 +0,0 @@ -{ - "intent": "DP-2 connects automatically at every boot; the biggest monitor is primary and leftmost.", - "scope": [ - "linux_configuration/features/monitor_{layout,autoconfig}.py, unit, setup script", - "linux_configuration/i3/config", - "Non-goal: per-monitor custom layouts" - ], - "changes": [ - "monitor_autoconfig._open_display waits (2 s steps) while X refuses the connection; the unit no longer burns its restart limit at the greeter", - "Unit sets XAUTHORITY=%h/.Xauthority; i3 exec_always restarts the unit at login and reload", - "Default primary is now the connected output with the largest best mode (was hardcoded DP-0, absent on this machine)" - ], - "verification": [ - { - "command": "python3 -m pytest -q linux_configuration/tests/test_monitor_layout.py linux_configuration/tests/test_monitor_autoconfig.py", - "result": "pass", - "evidence": "4 new tests red before the change; 26 passed after" - }, - { - "command": "setup_monitor_autoconfig.sh && xrandr --listmonitors", - "result": "pass", - "evidence": "applied: DP-2 3840x2160@144 --pos 0x0 --primary, HDMI-0 2560x1440@143.98 --pos 3840x0; kuhy confirmed layout" - }, - { - "command": "XAUTHORITY=/dev/null timeout 7 monitor_autoconfig.py", - "result": "pass", - "evidence": "exit 124: still waiting for X, no crash" - } - ], - "risks": [ - "Watcher waits forever if X never accepts it (cheap: one connect attempt per 2 s)", - "exec_always restart re-applies the layout on i3 reload, overriding a manual xrandr change" - ], - "rollback": [ - "git revert this commit, rerun setup_monitor_autoconfig.sh, copy i3/config to ~/.config/i3/config", - "Check systemctl --user status monitor-autoconfig" - ] -} diff --git a/docs/superpowers/evidence/parallel-session-autopsy-mutations-2026-11-10.json b/docs/superpowers/evidence/parallel-session-autopsy-mutations-2026-11-10.json deleted file mode 100644 index fbfa4677..00000000 --- a/docs/superpowers/evidence/parallel-session-autopsy-mutations-2026-11-10.json +++ /dev/null @@ -1,31 +0,0 @@ -{ - "intent": "The session_autopsy mutation gate finishes in about 19 s instead of about 51 s so a commit touching it fits the 60 s per-action cap.", - "scope": [ - "meta/scripts/mutate_session_autopsy_hooks.py", - "Non-goal: changing the mutation definitions or the pass/fail rule" - ], - "changes": [ - "Mutants run in a ThreadPoolExecutor (4 workers) via _run_mutant; each uses its own hook copy and its own coverage file", - "Per-mutant report lines are still printed in MUTATIONS order after all finish" - ], - "verification": [ - { - "command": "python3 meta/scripts/mutate_session_autopsy_hooks.py (before)", - "result": "pass", - "evidence": "PASS: all 12 tests killed, 51.4 s wall" - }, - { - "command": "python3 meta/scripts/mutate_session_autopsy_hooks.py (after)", - "result": "pass", - "evidence": "PASS: all 12 tests killed, same per-mutant kill lists, 19.1 s wall" - } - ], - "risks": [ - "Four concurrent pytest runs use more CPU and RAM for a few seconds", - "A test that shares global state across processes could become flaky under concurrency" - ], - "rollback": [ - "git revert the commit; mutants run sequentially again", - "Re-run the script and expect PASS in about 51 s" - ] -} diff --git a/docs/superpowers/evidence/phone-focus-todo-narrow-2026-11-02.json b/docs/superpowers/evidence/phone-focus-todo-narrow-2026-11-02.json deleted file mode 100644 index 017a77ed..00000000 --- a/docs/superpowers/evidence/phone-focus-todo-narrow-2026-11-02.json +++ /dev/null @@ -1,16 +0,0 @@ -{ - "intent": "Replace the stale 2000-line phone recovery plan with its remaining live-verification steps.", - "scope": ["docs/superpowers/plans/TODO-phone-focus-recovery.md"], - "changes": [ - "Plan chunks 1-7 are built in phone-focus-mode; TODO keeps Chunk 8 only" - ], - "verification": [ - { - "command": "bash lib/tests/test_adb_common.sh; bash lib/tests/test_monitor.sh (in ~/src/phone-focus-mode)", - "result": "pass", - "evidence": "10 passed, 82 passed; run_phone.sh --help exits 0" - } - ], - "risks": ["Live phone steps stay unverified until a phone is attached"], - "rollback": ["git revert the commit"] -} diff --git a/docs/superpowers/evidence/phone-vd-state-dir-2026-11-22.json b/docs/superpowers/evidence/phone-vd-state-dir-2026-11-22.json new file mode 100644 index 00000000..aef22890 --- /dev/null +++ b/docs/superpowers/evidence/phone-vd-state-dir-2026-11-22.json @@ -0,0 +1,28 @@ +{ + "intent": "phone_guard.vd_state resolves the virtual-display state directory exactly as phone_vd_dir.sh does, so TMPDIR no longer splits the two sides.", + "scope": [ + "python_pkg/phone_guard/vd_state.py (state_root)", + "python_pkg/phone_guard/tests/test_vd_state.py" + ], + "changes": [ + "state_root: PHONE_VD_STATE_DIR if non-empty, else XDG_RUNTIME_DIR (or /run/user/) + phone_vd when that dir exists, else /tmp/phone_vd", + "tempfile.gettempdir() and TMPDIR are no longer read for this path", + "Tests: runtime-dir default, TMPDIR independence, override wins, missing runtime dir fallback, unset XDG uses /run/user/" + ], + "verification": [ + { + "command": "pytest python_pkg/phone_guard/tests/test_vd_state.py --no-cov", + "result": "pass", + "evidence": "red first: 4 failed, 5 passed against the old TMPDIR rule; green after the change" + }, + { + "command": "pytest python_pkg/phone_guard python_pkg/android_ui --no-cov", + "result": "pass", + "evidence": "215 passed; vd_state.py 100% line and branch coverage" + } + ], + "risks": [ + "A direct caller that relied on TMPDIR for the state directory now reads the runtime dir; the shell side already did" + ], + "rollback": ["git revert this commit", "Rerun pytest python_pkg/phone_guard"] +} diff --git a/docs/superpowers/evidence/pi-rustscan-instead-of-nmap-2026-11-10.json b/docs/superpowers/evidence/pi-rustscan-instead-of-nmap-2026-11-10.json deleted file mode 100644 index 6aef8e28..00000000 --- a/docs/superpowers/evidence/pi-rustscan-instead-of-nmap-2026-11-10.json +++ /dev/null @@ -1,35 +0,0 @@ -{ - "intent": "Pi flashing scripts discover SSH hosts with rustscan instead of nmap; rustscan runs with scripts = \"None\" so it never calls nmap.", - "scope": [ - "linux_configuration/features/lib/{nc_discover,nc_flash,nc_image,nc_remote,pi_flash_remote,rpi_nc_deps}.sh", - "linux_configuration/features/raspberry_pi_flash_sd.sh", - "linux_configuration/fresh-install/main.sh, rustscan.toml", - "linux_configuration/tests/test_pi_discovery_rustscan.sh", - "Not touched: pacman wrapper (digital-wellbeing), live LAN scanning" - ], - "changes": [ - "nmap ping sweep + port scan replaced by `rustscan -a -p 22 -g | awk '{print $1}'` (greppable output, one IP per line)", - "Dependency checks and hint messages name rustscan instead of nmap", - "fresh-install/rustscan.toml (scripts = \"None\") copied to ~/.rustscan.toml by main.sh" - ], - "verification": [ - { - "command": "linux_configuration/tests/test_pi_discovery_rustscan.sh", - "result": "pass", - "evidence": "ok per discovery script, ok rpi_nc_deps dependencies, ok no nmap references" - }, - { - "command": "pre-commit run --files ", - "result": "pass", - "evidence": "shellcheck, codespell and secrets hooks passed on the shell files" - } - ], - "risks": [ - "rustscan -g output format change would break the awk IP extraction", - "Hosts that drop rustscan's fast SYN probing may be missed versus nmap" - ], - "rollback": [ - "git revert the commit", - "Re-run a Pi discovery and confirm hosts are listed" - ] -} diff --git a/docs/superpowers/evidence/publish-caddy-site-2026-11-02.json b/docs/superpowers/evidence/publish-caddy-site-2026-11-02.json deleted file mode 100644 index 35079b6d..00000000 --- a/docs/superpowers/evidence/publish-caddy-site-2026-11-02.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "intent": "Publish a loopback service at .kuhy.duckdns.org through the existing gitea-caddy edge with one validated command.", - "scope": [ - "linux_configuration/features/publish_caddy_site.sh (new)", - "Non-goal: no change to the live Caddy config, setup_gitea.sh or DNS" - ], - "changes": [ - "Writes sites/.kuhy.duckdns.org.caddy (reverse_proxy to 127.0.0.1:, optional bearer gate), validates on a tmp copy in a throwaway caddy:2.8 container, then reloads gitea-caddy" - ], - "verification": [ - { - "command": "shellcheck linux_configuration/features/publish_caddy_site.sh", - "result": "pass", - "evidence": "exit 0" - }, - { - "command": "publish_caddy_site.sh todo 8799 --dry-run (with and without a token file)", - "result": "pass", - "evidence": "caddy validate: Valid configuration, exit 0; live edge not modified" - } - ], - "risks": [ - "A real run reloads the shared edge; a bad snippet is caught by the pre-validation, but a reload still briefly touches all sites" - ], - "rollback": [ - "Delete ~/services/gitea/sites/.kuhy.duckdns.org.caddy and run docker exec gitea-caddy caddy reload --config /etc/caddy/Caddyfile" - ] -} diff --git a/docs/superpowers/evidence/pypi-pins-bump-2026-10-22.json b/docs/superpowers/evidence/pypi-pins-bump-2026-10-22.json deleted file mode 100644 index 362e3a25..00000000 --- a/docs/superpowers/evidence/pypi-pins-bump-2026-10-22.json +++ /dev/null @@ -1,27 +0,0 @@ -{ - "intent": "Python pins in meta/requirements*.txt are the newest stable releases again, so the dependency-freshness gate and Pre-commit checks go green in CI.", - "scope": [ - "meta/requirements.txt, meta/requirements-test.txt (anthropic, coverage, hypothesis, ruff, types-python-dateutil, websockets)", - "Non-goal: typescript 6.0.3 allowlist entry (unchanged, predicate still blocking)" - ], - "changes": [ - "anthropic 1.15.0 -> 2.1.0, coverage 7.16.2 -> 7.17.0, hypothesis 6.170.2 -> 6.170.5", - "ruff 0.17.1 -> 0.17.2, types-python-dateutil 2.9.0.20260807 -> 2.9.0.20261021, websockets 17.2 -> 17.3" - ], - "verification": [ - { - "command": "scripts/check_dependency_freshness.sh --all --strict", - "result": "pass", - "evidence": "see commit run; CI run 39843132891 listed exactly these 8 findings before the bump" - }, - { - "command": "PYTHONPATH= pytest python_pkg/code_tutor/tests/test_claude_backend.py python_pkg/code_tutor/tests/test_llm_fallback.py", - "result": "pass", - "evidence": "16 passed with anthropic 2.1.0 (only importer: python_pkg/code_tutor)" - } - ], - "risks": [ - "anthropic is a major bump; only code_tutor uses anthropic.Anthropic/APIError/messages.create/stream, covered by the 16 tests above" - ], - "rollback": ["git revert this commit"] -} diff --git a/docs/superpowers/evidence/pypi-pins-bump-2026-10-25.json b/docs/superpowers/evidence/pypi-pins-bump-2026-10-25.json deleted file mode 100644 index c2212b2d..00000000 --- a/docs/superpowers/evidence/pypi-pins-bump-2026-10-25.json +++ /dev/null @@ -1,26 +0,0 @@ -{ - "intent": "meta/requirements.txt pins are the newest stable releases again, so the dependency-freshness CI job and the ci-baseline-green hook go green.", - "scope": [ - "meta/requirements.txt (anthropic, hypothesis, importlib-metadata only)", - "Non-goal: any code change; existing allowlist entries unchanged" - ], - "changes": [ - "anthropic 2.1.0 -> 2.3.0, hypothesis 6.170.6 -> 6.170.9, importlib-metadata 9.0.1 -> 10.1.0 (released after the previous bumps)" - ], - "verification": [ - { - "command": "uv pip compile --python-version 3.14 meta/requirements.txt", - "result": "pass", - "evidence": "resolves with exactly the new pins (rc=0)" - }, - { - "command": "pre-commit run dependency-freshness --files meta/requirements.txt", - "result": "pass", - "evidence": "Passed; CI run 39954483117 had listed hypothesis and importlib-metadata as behind, the local gate then also listed anthropic" - } - ], - "risks": [ - "importlib-metadata major bump 9 -> 10 is transitive-only here; caught by python-tests CI if an importer breaks" - ], - "rollback": ["git revert this commit"] -} diff --git a/docs/superpowers/evidence/remove-syncyomi-2026-11-01.json b/docs/superpowers/evidence/remove-syncyomi-2026-11-01.json deleted file mode 100644 index 97d92464..00000000 --- a/docs/superpowers/evidence/remove-syncyomi-2026-11-01.json +++ /dev/null @@ -1,28 +0,0 @@ -{ - "intent": "Remove every SyncYomi and TachiyomiSY trace; kuhy replaced the app with kartka.", - "scope": [ - "python_pkg/syncyomi_guard, setup_syncyomi*.sh, lib/syncyomi_*.sh, syncyomi docs", - "Non-goal: Suwayomi and eu.kanade.tachiyomi.extension mentions stay" - ], - "changes": [ - "Deleted the syncyomi_guard package, its setup scripts, libs and runbook", - "Dropped syncyomi lines from shared docs, comments and the coverage allowlist" - ], - "verification": [ - { - "command": "grep -rIliE 'syncyomi|tachiyomisy|tachiyomi\\.sy' . (excluding .git, caches)", - "result": "pass", - "evidence": "no matches in tracked files" - }, - { - "command": "shellcheck setup_gitea.sh setup_personal_website.sh", - "result": "pass", - "evidence": "no findings" - } - ], - "risks": ["Stale references in untracked local settings"], - "rollback": [ - "git revert the commit", - "Restore services from the 2026-11-01 backup tarball" - ] -} diff --git a/docs/superpowers/evidence/sql-drills-harness-2026-11-01.json b/docs/superpowers/evidence/sql-drills-harness-2026-11-01.json deleted file mode 100644 index 1d851611..00000000 --- a/docs/superpowers/evidence/sql-drills-harness-2026-11-01.json +++ /dev/null @@ -1,41 +0,0 @@ -{ - "intent": "Add a Docker-backed MySQL 8.0.33 practice harness that grades SQL by exact output match, with 12 original drills.", - "scope": [ - "python_pkg/sql_drills (new package, fixtures, tests, README)", - "meta/pyproject.toml: register the docker pytest marker", - "Non-goal: bumping the pinned mysql image; copying third-party problems", - "2026-11-02: show/check send an optional focus-tracker heartbeat (__main__.py, tests/conftest.py, tests/test_focus_hook.py)" - ], - "changes": [ - "CLI start/stop/list/show/check over one long-lived tmpfs container", - "Judge-style normaliser and line diff, unit-tested without Docker", - "12 original drills with live-verified reference solutions kept in tests only", - "_heartbeat(): soft import of focus_project; absent -> no-op, tracker error -> logged, result and exit code unchanged" - ], - "verification": [ - { - "command": "python3 -m pytest -q python_pkg/sql_drills (container running)", - "result": "pass", - "evidence": "71 passed, 16 of them live against mysql:8.0.33; package coverage 100% branch" - }, - { - "command": "python3 -m python_pkg.sql_drills check for all 12 drills", - "result": "pass", - "evidence": "every drill prints PASS; wrong query prints a line diff, syntax error exits 2" - }, - { - "command": "python3 -m pytest -q python_pkg/sql_drills/tests --cov=python_pkg.sql_drills --cov-branch", - "result": "pass", - "evidence": "61 passed, 15 live tests skipped (no container), 100% branch coverage; show 01 wrote one sql_drills heartbeat row to a scratch FOCUS_PROJECT_DATA" - } - ], - "risks": [ - "Local MySQL image must be pulled once; start fails with a clear error otherwise", - "A runaway query is cut off client-side after 30 s but may keep running in the container until stop", - "A hanging tracker would delay show/check; the real one is a local file append" - ], - "rollback": [ - "git revert the commit; run python3 -m python_pkg.sql_drills stop first", - "Check that pytest still collects with the marker line removed" - ] -} diff --git a/docs/superpowers/evidence/sql-drills-thin-wrapper-2026-11-02.json b/docs/superpowers/evidence/sql-drills-thin-wrapper-2026-11-02.json deleted file mode 100644 index abe52d36..00000000 --- a/docs/superpowers/evidence/sql-drills-thin-wrapper-2026-11-02.json +++ /dev/null @@ -1,33 +0,0 @@ -{ - "intent": "python_pkg.sql_drills CLI keeps its commands but imports the shared sql_drills package from kuhyx/utils.", - "scope": [ - "python_pkg/sql_drills (engine, fixtures, solutions, engine tests removed)", - "meta/requirements.txt pin sql-drills-v0.1.0", - "Non-goal: changing CLI commands or exit codes" - ], - "changes": [ - "__main__.py calls sql_drills.ensure_running/stop/list_drills/get_drill/run", - "Fixtures, normaliser, docker engine and live tests moved to utils/sql_drills", - "check prints per-cell diffs instead of per-line diffs" - ], - "verification": [ - { - "command": "python3 -m pytest -q python_pkg/sql_drills --cov=python_pkg/sql_drills --cov-branch", - "result": "pass", - "evidence": "18 passed, 100% branch coverage" - }, - { - "command": "python3 -m python_pkg.sql_drills check 06 (live container)", - "result": "pass", - "evidence": "PASS 06 (3 rows), exit 0; wrong query: FAIL with cell diffs, exit 1" - } - ], - "risks": [ - "CI needs the utils git pin to resolve", - "The shared package must be installed in any python running the CLI" - ], - "rollback": [ - "git revert this commit to restore the in-repo engine", - "Re-run python3 -m python_pkg.sql_drills list and check 01 on a reference" - ] -} diff --git a/docs/superpowers/evidence/testsandmisc-deploy-command-2026-11-12.json b/docs/superpowers/evidence/testsandmisc-deploy-command-2026-11-12.json deleted file mode 100644 index cb78993e..00000000 --- a/docs/superpowers/evidence/testsandmisc-deploy-command-2026-11-12.json +++ /dev/null @@ -1,30 +0,0 @@ -{ - "intent": "testsAndMisc declares a deploy command, so Ship can deploy a pushed change instead of reporting 'pushed, not deployed'.", - "scope": [ - "scripts/deploy.sh (new), CLAUDE.md Commands, linux_configuration/tests/test_deploy.bats (new)", - "Non-goal: refreshing copies the sudo installers put under /usr/local or /etc" - ], - "changes": [ - "scripts/deploy.sh fast-forwards ~/src/testsAndMisc to origin/main (pull --ff-only), keeps unrelated local edits, refuses on collision", - "Health check: on main, HEAD = origin/main, core.hooksPath = linux_configuration/.githooks; exits non-zero otherwise", - "CLAUDE.md Commands gains '- deploy: `scripts/deploy.sh`'" - ], - "verification": [ - { - "command": "bats linux_configuration/tests/test_deploy.bats", - "result": "pass", - "evidence": "red first (deploy.sh missing, exit 127); then 7/7 ok: ff, idempotent, keeps WIP, refuses collision, hooks unwired fails, off-main fails, CLAUDE.md line" - }, - { - "command": "shellcheck scripts/deploy.sh", - "result": "pass", - "evidence": "no findings" - } - ], - "risks": [ - "Live checkout carries kuhy's uncommitted edits; an incoming commit touching them makes deploy fail rather than overwrite" - ], - "rollback": [ - "git revert this commit; the live checkout stays where the last deploy left it" - ] -} diff --git a/docs/superpowers/evidence/token-audit-usd-per-note-2026-11-01.json b/docs/superpowers/evidence/token-audit-usd-per-note-2026-11-01.json deleted file mode 100644 index d9ac33c8..00000000 --- a/docs/superpowers/evidence/token-audit-usd-per-note-2026-11-01.json +++ /dev/null @@ -1,38 +0,0 @@ -{ - "intent": "Add a USD-per-completed-todo-note efficiency metric to the Claude Code token audit, plus notes.json for the control-panel dashboard. Also summarise the new build-class A/B log (agent-ab-build.jsonl) into its own meta row for the dashboard.", - "scope": [ - "python_pkg/token_audit/notes*.py (new), __main__.py and review.py (wiring), tests/test_notes_*.py + tests/notes_fixtures.py; python_pkg/token_dashboard/ab.py + tests/test_ab_build.py + tests/conftest.py", - "Non-goal: changing existing metrics or pricing; app_icons working-tree changes belong to another session" - ], - "changes": [ - "notes_backlog: BACKLOG.md parse plus done dates from the status-field HLC in the first Firebase dump showing the terminal status, BACKLOG updated as fallback", - "notes_scan/notes_link: per-session facts from typed prompts and tool_use blocks only; rules a (note_claim.sh), b (todo-images// in a prompt, <=2 notes), c (first prompt, max of body Dice and first-line/title Dice >= 0.5), d (handoff readers inherit the earliest creator's notes)", - "notes_cost/notes_collect/notes: lifetime spend of linked sessions (main + subagents, reusing audit-loaded files), usd_per_note, note_linked_usd_share, notes_done, notes_done_linked, WEEKLY section and notes.json; standalone python -m python_pkg.token_audit.notes", - "token_dashboard.ab: rebuild() also joins ~/.claude/logs/agent-ab-build.jsonl and stores meta 'ab_build' with a 'A/B build agents' banner; ab_rows stays judgment-only" - ], - "verification": [ - { - "command": "python3 -m pytest -q -o addopts='' python_pkg/token_audit/tests --cov=python_pkg.token_audit --cov-branch", - "result": "pass", - "evidence": "253 passed; token_audit TOTAL 100% line and branch" - }, - { - "command": "capped.sh env PYTHONPATH=$HOME/src/testsAndMisc python3 -m python_pkg.token_audit --since <30 days ago> --no-write", - "result": "pass", - "evidence": "48.2 s total; notes: 135 sessions linked (b=14 c=102 d=19); usd_per_note $55.77, note_linked_usd_share 64.6%, notes_done 98 (44 linked)" - }, - { - "command": "python3 -m pytest -q -o addopts='' python_pkg/token_dashboard/tests", - "result": "pass", - "evidence": "147 passed; ab.py 100% branch; live ingest stored ab_build and /api/tokens/panel/ab returns build banner 'A/B build agents: collecting (n=0)'" - } - ], - "risks": [ - "Fuzzy rule c can mislink a prompt that paraphrases another note; threshold calibrated by hand-labelling the 0.25-0.8 band (10/10 correct at >= 0.5, 15/16 image ground truths matched)", - "Done dates before the first dump (2026-09-26) are upper bounds" - ], - "rollback": [ - "git revert the commit; the audit falls back to its previous metrics", - "Run python3 -m python_pkg.token_audit --no-write and check it exits 0" - ] -} diff --git a/docs/superpowers/evidence/token-dashboard-core-2026-10-18.json b/docs/superpowers/evidence/token-dashboard-core-2026-10-18.json deleted file mode 100644 index a60979aa..00000000 --- a/docs/superpowers/evidence/token-dashboard-core-2026-10-18.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "intent": "A durable SQLite token store (~/data/token-dashboard/tokens.sqlite) that outlives Claude Code's transcript cleanup and feeds the control-panel /tokens cost dashboard, with 0 LLM tokens spent.", - "scope": [ - "python_pkg/token_dashboard/ (new): walk, rows, store, schema v3 with ordered additive migrations, finalize, carry, efficiency, ab, levers, context_files, aux, commits, survival, blocks, ingest; detail layer: classify, detail, detail_rows, detail_store, marks, hook_join (per-call, per-mark and per-turn rows with creation + carry cost); ab_rows (per-assignment A/B outcomes)", - "python_pkg/token_audit: persist structured lever candidates (Lever.metric join key) and expose the record primitives the walker shares", - "Non-goal: the remaining dashboard panel groups A-Q (tracked in ~/src/control-panel/TODO-token-dashboard-panels.md)" - ], - "changes": [ - "Resumable incremental ingest: walks changed transcripts until its --budget is spent, commits, exits pending if any remain", - "Schema migrations never drop the store; rows of vanished transcripts are kept", - "token_audit --recommend stores the lever candidates as data in the snapshot (snap['levers'])", - "New raw tables calls / marks / turn_detail (no schema version bump: CREATE IF NOT EXISTS) with key, cwd, model, ts, day, is_sub so the dashboard's filter clause applies; carry.Tracker settles creation (next call's cache-write multiplier x input price) and carry_calls too", - "ab.rebuild also stores per-assignment rows in ab_rows so the A/B panel can recount arms per cwd/model/scope" - ], - "verification": [ - { - "command": "python3 -m pytest -q python_pkg/token_dashboard python_pkg/token_audit --cov=python_pkg/token_dashboard --cov=python_pkg/token_audit --cov-branch", - "result": "pass", - "evidence": "token_dashboard + token_audit: 100.00% line+branch coverage (pytest --cov, --cov-branch)" - }, - { - "command": "python3 -m python_pkg.token_dashboard.ingest --budget 40", - "result": "pass", - "evidence": "token_dashboard: parsed 7 files, refreshed 2 sessions in 0.7s; exit 0" - }, - { - "command": "sqlite3 tokens.sqlite 'DELETE FROM files' && python3 -m python_pkg.token_dashboard.ingest --budget 40", - "result": "pass", - "evidence": "full re-walk of 1616 transcripts in one 32.5 s pass; 114,599 calls, 103,713 turn_detail rows; store kept (backup tokens.v3-2026-10-18.sqlite)" - } - ], - "risks": [ - "A schema change without a MIGRATIONS entry would leave old stores without the new column", - "Transcript format drift in Claude Code could make the walker skip new record types" - ], - "rollback": [ - "git revert this commit; the store file is left untouched and stays readable by the previous code", - "Validate: control-panel /api/tokens/overview still answers from the existing store" - ] -} diff --git a/docs/superpowers/evidence/tutor-i3block-weekday-quota-2026-10-12.json b/docs/superpowers/evidence/tutor-i3block-weekday-quota-2026-10-12.json deleted file mode 100644 index 7c0bb4f3..00000000 --- a/docs/superpowers/evidence/tutor-i3block-weekday-quota-2026-10-12.json +++ /dev/null @@ -1,30 +0,0 @@ -{ - "intent": "The i3blocks tutor block shows progress against today's per-weekday tutor quota (15/30/50 minutes) instead of a fixed 60, matching earned_time 0.10.0.", - "scope": [ - "linux_configuration/i3blocks/tutor.sh (TARGET derived from the weekday)", - "Non-goals: no change to earned_time, the tutor ledger format, or any service; the table is a literal copy of earned_time's _quota.py" - ], - "changes": [ - "TARGET is now chosen per weekday via the printf %(%u)T builtin (fork-free): Tue-Thu 15, Mon/Fri 30, Sat/Sun 50 minutes, replacing the constant 60" - ], - "verification": [ - { - "command": "bash linux_configuration/i3blocks/tutor.sh (run on Monday 2026-10-12)", - "result": "pass", - "evidence": "Block printed 'โš™ tutor 9/30' (Monday target 30)" - }, - { - "command": "shellcheck linux_configuration/i3blocks/tutor.sh", - "result": "pass", - "evidence": "Clean, no findings" - } - ], - "risks": [ - "The weekday table is duplicated from earned_time; a future quota change there must be mirrored here", - "Not run on every weekday; only Monday was observed live" - ], - "rollback": [ - "git revert the commit (restores readonly TARGET=60)", - "Confirm the i3bar tutor block renders N/60 again" - ] -} diff --git a/docs/superpowers/evidence/wallpaper-rotator-2026-11-11.json b/docs/superpowers/evidence/wallpaper-rotator-2026-11-11.json deleted file mode 100644 index 12881e5f..00000000 --- a/docs/superpowers/evidence/wallpaper-rotator-2026-11-11.json +++ /dev/null @@ -1,39 +0,0 @@ -{ - "intent": "The empty i3 desktop shows a dark, text-free background instead of blinding white, changing every 3 hours to a different random style per monitor.", - "scope": [ - "python_pkg/wallpaper_rotator (new package, tests)", - "linux_configuration/i3: config exec line, wallpaper-rotator.service/.timer, install_wallpaper_rotator.sh", - "linux_configuration/i3/config synced from the live ~/.config/i3/config (adds the guard exec lines the repo lacked)", - "Non-goal: animation, text, per-reveal rotation (dropped at the user's request)" - ], - "changes": [ - "Six numpy/PIL styles in the Dracula palette: gradient+grain, flow field/Voronoi, habit heatmap from guard ledgers, shutdown clock from /etc/shutdown-schedule.conf, Earth day/night from NASA Blue/Black Marble, plasma still", - "_rotation.plan() decides rotate/refresh/repaint from a JSON state; _tick composes per-output images into one root image and sets it with feh", - "systemd user oneshot service + 15-minute timer; i3 exec paints at login" - ], - "verification": [ - { - "command": "python3 -m pytest python_pkg/wallpaper_rotator/tests --cov=python_pkg.wallpaper_rotator --cov-branch --cov-fail-under=100", - "result": "pass", - "evidence": "53 passed, TOTAL 434 stmts 44 branches, 100.00% branch coverage" - }, - { - "command": "~/data/claude-scratch/wallpaper/e2e_timer.sh (private Xvfb :77 + nested i3, run 3x)", - "result": "pass", - "evidence": "tick1 painted; tick2 unchanged (static) or painted (live style); tick3 after 3 h painted a different style; PASS x3" - }, - { - "command": "install_wallpaper_rotator.sh on the live session", - "result": "pass", - "evidence": "timer active, next 16:15; state DP-0 gradient, HDMI-0 clock; user confirmed ok on screen" - } - ], - "risks": [ - "NASA asset URLs move again: the earth style is then skipped (available() false), others unaffected", - "Render CPU every 15 min while a live style is shown (~1-3 s at Nice 19)" - ], - "rollback": [ - "systemctl --user disable --now wallpaper-rotator.timer; git revert the commit", - "Check that the root reverts to its plain colour after the next login" - ] -} diff --git a/docs/superpowers/evidence/warp-window-0700-1700-2026-11-09.json b/docs/superpowers/evidence/warp-window-0700-1700-2026-11-09.json deleted file mode 100644 index a04147a9..00000000 --- a/docs/superpowers/evidence/warp-window-0700-1700-2026-11-09.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "intent": "The home WARP window for the work laptop opens Mon/Thu/Fri 07:00-17:00 instead of 08:00-16:00. Away from home WARP stays always available, any day or time.", - "scope": [ - "linux_configuration/features/warp_window.sh (PC, enforces the window)", - "linux_configuration/features/warp_home.sh (laptop, messages only)", - "DOCS-lan-blocker-contingency.md, test_warp_window.sh, test_warp_home.sh", - "No change to days, install, sudoers, the ssh forced command or the away-from-home path" - ], - "changes": [ - "OPEN_SEC 08:00 -> 07:00; CLOSE_SEC 16:00 -> 17:00; refusal/open/warning messages updated", - "test_warp_window.sh asserts the 06:59:59/07:00/16:59:59/17:00 edges and a 25200 s timeout at Mon 10:00" - ], - "verification": [ - { - "command": "linux_configuration/features/lib/tests/test_warp_window.sh (before the change)", - "result": "fail", - "evidence": "red first: 27 passed, 8 failed (07:00 closed, 14400 instead of 18000 at Friday noon)" - }, - { - "command": "linux_configuration/features/lib/tests/test_warp_window.sh; test_warp_home.sh", - "result": "pass", - "evidence": "35 passed, 0 failed; 35 passed, 0 failed (incl. away-from-home tick never touches WARP, on away connects without the PC)" - }, - { - "command": "sudo install -m 0755 warp_window.sh /usr/local/sbin/warp-window; scp warp_home.sh to laptop ~/.local/bin/warp-home; . /usr/local/sbin/warp-window; window_seconds_left", - "result": "pass", - "evidence": "Mon 2026-11-09 07:56:42 -> 32598 s left (open until 17:00; closed under the old window); kuhy ran warp-home on and confirmed it works" - } - ], - "risks": [ - "Laptop copy is installed by hand; a later warp_home.sh install overwrites it with the repo version (same content now)" - ], - "rollback": [ - "git revert this commit, then sudo install -m 0755 warp_window.sh /usr/local/sbin/warp-window and copy warp_home.sh to the laptop again", - "Then: window_seconds_left is closed at Mon 07:30 and 16:30" - ] -} diff --git a/docs/superpowers/evidence/warp-window-thu-0800-1600-2026-11-05.json b/docs/superpowers/evidence/warp-window-thu-0800-1600-2026-11-05.json deleted file mode 100644 index c49668df..00000000 --- a/docs/superpowers/evidence/warp-window-thu-0800-1600-2026-11-05.json +++ /dev/null @@ -1,37 +0,0 @@ -{ - "intent": "The home WARP window for the work laptop opens Mon/Thu/Fri 08:00-16:00 instead of Mon/Fri 09:00-15:30.", - "scope": [ - "linux_configuration/features/warp_window.sh (PC, enforces the window)", - "linux_configuration/features/warp_home.sh (laptop, messages only)", - "lib/wg_gateway.sh comment, DOCS-lan-blocker-contingency.md, both test files", - "No change to install, sudoers or the ssh forced command" - ], - "changes": [ - "WINDOW_DAYS ' 1 5 ' -> ' 1 4 5 '; OPEN_SEC 09:00 -> 08:00; CLOSE_SEC 15:30 -> 16:00; refusal/open messages updated", - "test_warp_window.sh asserts the 07:59:59/08:00/15:59:59/16:00 edges, Thursday open, Tue/Wed/Sat/Sun closed, 21600 s timeout at Mon 10:00" - ], - "verification": [ - { - "command": "linux_configuration/features/lib/tests/test_warp_window.sh (before the change)", - "result": "fail", - "evidence": "red first: 27 passed, 8 failed (Thursday closed, 08:00 closed, 12600 instead of 14400)" - }, - { - "command": "linux_configuration/features/lib/tests/test_warp_window.sh; test_warp_home.sh", - "result": "pass", - "evidence": "35 passed, 0 failed; 35 passed, 0 failed" - }, - { - "command": "sudo install -m 0755 warp_window.sh /usr/local/sbin/warp-window; laptop 192.168.1.21: ~/.local/bin/warp-home replaced (sha256 bf242be5...), then warp-home on; warp-home status", - "result": "pass", - "evidence": "Thu 2026-11-05 09:11: 'Home window ends at 16:00', pc: open (expires 6h48m), warp Connected, example.com 200; kuhy confirmed" - } - ], - "risks": [ - "Laptop copy is installed by hand; a later warp_home.sh install overwrites it with the repo version (same content now)" - ], - "rollback": [ - "PC: sudo cp -a /usr/local/sbin/warp-window.bak-2026-11-05 /usr/local/sbin/warp-window; laptop: restore ~/.local/bin/warp-home.bak-2026-11-05", - "Then: sudo warp-window status shows closed outside Mon/Fri 09:00-15:30" - ] -} diff --git a/python_pkg/phone_guard/tests/test_vd_state.py b/python_pkg/phone_guard/tests/test_vd_state.py index 62d22064..4798b298 100644 --- a/python_pkg/phone_guard/tests/test_vd_state.py +++ b/python_pkg/phone_guard/tests/test_vd_state.py @@ -2,7 +2,9 @@ from __future__ import annotations +import os from pathlib import Path +import tempfile import pytest @@ -10,9 +12,51 @@ from python_pkg.phone_guard import vd_state from python_pkg.phone_guard.tests.conftest import make_display -def test_default_root_is_under_the_temp_dir(monkeypatch: pytest.MonkeyPatch) -> None: +def test_default_root_is_under_the_runtime_dir( + monkeypatch: pytest.MonkeyPatch, tmp_path: Path +) -> None: monkeypatch.delenv("PHONE_VD_STATE_DIR") - assert vd_state.state_root().name == "phone_vd" + monkeypatch.setenv("XDG_RUNTIME_DIR", str(tmp_path)) + assert vd_state.state_root() == tmp_path / "phone_vd" + + +def test_tmpdir_never_moves_the_root( + monkeypatch: pytest.MonkeyPatch, tmp_path: Path +) -> None: + monkeypatch.delenv("PHONE_VD_STATE_DIR") + monkeypatch.setenv("XDG_RUNTIME_DIR", str(tmp_path)) + roots = set() + for tmpdir in ("/var/disktmp", str(tmp_path / "other")): + monkeypatch.setenv("TMPDIR", tmpdir) + monkeypatch.setattr(tempfile, "tempdir", None) + roots.add(vd_state.state_root()) + assert roots == {tmp_path / "phone_vd"} + + +def test_state_dir_env_wins_over_runtime_dir( + monkeypatch: pytest.MonkeyPatch, tmp_path: Path +) -> None: + monkeypatch.setenv("XDG_RUNTIME_DIR", str(tmp_path)) + monkeypatch.setenv("PHONE_VD_STATE_DIR", str(tmp_path / "override")) + assert vd_state.state_root() == tmp_path / "override" + + +def test_missing_runtime_dir_falls_back_to_tmp( + monkeypatch: pytest.MonkeyPatch, tmp_path: Path +) -> None: + monkeypatch.delenv("PHONE_VD_STATE_DIR") + monkeypatch.setenv("XDG_RUNTIME_DIR", str(tmp_path / "absent")) + assert vd_state.state_root() == Path("/", "tmp", "phone_vd") + + +def test_unset_runtime_dir_uses_run_user_uid( + monkeypatch: pytest.MonkeyPatch, +) -> None: + monkeypatch.delenv("PHONE_VD_STATE_DIR") + monkeypatch.delenv("XDG_RUNTIME_DIR", raising=False) + monkeypatch.setattr(Path, "is_dir", lambda self: str(self) == "/run/user/4242") + monkeypatch.setattr(os, "getuid", lambda: 4242) + assert vd_state.state_root() == Path("/run/user/4242/phone_vd") def test_owner_dir_name_matches_the_script() -> None: diff --git a/python_pkg/phone_guard/vd_state.py b/python_pkg/phone_guard/vd_state.py index 90885dd6..5f4038b9 100644 --- a/python_pkg/phone_guard/vd_state.py +++ b/python_pkg/phone_guard/vd_state.py @@ -14,7 +14,6 @@ from dataclasses import dataclass import os from pathlib import Path import re -import tempfile _UNSAFE = re.compile(r"[^A-Za-z0-9_.-]") @@ -22,11 +21,19 @@ _UNSAFE = re.compile(r"[^A-Za-z0-9_.-]") def state_root() -> Path: """The directory ``phone_vd.sh`` keeps its per-phone state in. - ``$PHONE_VD_STATE_DIR``, else ``phone_vd`` under the temp dir -- the same - ``${TMPDIR:-/tmp}`` rule the script applies, so both sides agree. + Mirrors ``phone_vd_state_root`` in ``~/.claude/scripts/lib/phone_vd_dir.sh``: + ``$PHONE_VD_STATE_DIR`` (the test seam) if non-empty, else + ``${XDG_RUNTIME_DIR:-/run/user/}/phone_vd`` when that runtime dir + exists, else ``/tmp/phone_vd``. ``TMPDIR`` is never read, so a session + with a private ``TMPDIR`` sees the same directory as the shell side. """ - default = Path(tempfile.gettempdir()) / "phone_vd" - return Path(os.environ.get("PHONE_VD_STATE_DIR", str(default))) + override = os.environ.get("PHONE_VD_STATE_DIR") + if override: + return Path(override) + runtime = Path(os.environ.get("XDG_RUNTIME_DIR") or f"/run/user/{os.getuid()}") + if runtime.is_dir(): + return runtime / "phone_vd" + return Path("/", "tmp", "phone_vd") def owner_dir_name(owner: str) -> str: