Skip to content

MANUAL-CHECKLIST.md

Latest commit

 

History

History
111 lines (99 loc) · 6 KB

MANUAL-CHECKLIST.md

File metadata and controls

111 lines (99 loc) · 6 KB
Raw

Manual checklist

Things a machine could not establish. Each item has exact steps and a falsifiable expected result. Do not tick these on the agent's behalf.

Created by task 16. Add an item the moment a task produces an unverifiable claim. If an item turns out to be automatable, automate it and delete the entry.

  • Keyboard-driven pane flows

    • Commit: (standing)
    • Steps: with a PaneFlow window focused, press Cmd+Shift+D (split horizontal), Cmd+Shift+E (split vertical), Cmd+Shift+W (close pane), Cmd+Shift+T (undo close).
    • Expected: a new pane appears below / beside; the focused pane closes; undo restores it.
    • Failure implicates: keybindings + layout mutations.
    • Agent observed (2026-08-27, issue #14): synthetic chords on a debug instance moved paneflow ls pane counts 3→4 (D) →5 (E) →4 (W) →5 (T), each with a matching Terminal backend selected log line. Only the visual placement (below vs beside) is still unobserved.

  • PATH-shim agent turn

    • Commit: (standing)
    • Steps: launch a real agent CLI in a pane through the PATH shim. Watch the sidebar through one full turn.
    • Expected: the sidebar tracks the agent from start through tool use to idle/waiting.
    • Failure implicates: paneflow-shim + ai-hook + sidebar.
    • Agent observed (2026-08-27, issue #15): which claude in a pane resolved to the paneflow-dev shim dir; a real claude -p turn was tracked by status/ps/watch as idle → thinking (Bash/Read) → finished → idle, hooked:false at the end. The sidebar pixels themselves were not viewed.

  • Task 12 — bundle-id permission re-grant

    • Commit: 4afb5a42 (v0.1.1)
    • Steps: on a Mac or user account that has never run com.theaamgroup.paneflow, install v0.1.1 from the release dmg, launch it, and trigger one agent notification.
    • Expected: a Notifications allow/deny prompt may appear on the first agent alert, and notifications post after Allow. Nothing else prompts: assets/Info.plist has no relevant *UsageDescription keys and the app has no Accessibility, Apple Events, or Full Disk Access request path.
    • Failure implicates: the new CFBundleIdentifier / usernoted mapping.
    • Completed (2026-08-28, issue #13): the user confirmed the clean v0.1.1 build is installed and running. The installed app reports bundle id com.theaamgroup.paneflow and version 0.1.1; codesign --verify passes, spctl accepts it as Notarized Developer ID, and stapler validate succeeds. Live IPC returned three surfaces. With notifications configured for PrimaryScreen, the shipped v0.1.1 hook delivered a synthetic permission notification to the app: paneflow ps showed its isolated session as waiting_for_input, and the matching SessionEnd removed it without changing the real agent sessions.

  • Task 11 — no in-app updater (deleted 2026-08-26)

    • Commit: updater removal on issue-63 (bucket 3). The feed, minisign client, title-bar update pill, and spawn_check are gone. There is no src-app/src/update/ left to poll GitHub.
    • Why a machine cannot fully do this: the agent can grep the binary and logs; it cannot watch outbound HTTPS (Little Snitch / a proxy).
    • Steps: launch the app. Confirm there is no title-bar "Update available" / "vX available" pill, and the log has no spawn_check line and no self-update feed disabled line. Optionally watch outbound HTTPS.
    • Expected: no request to api.github.com/repos/arthjean/paneflow or any other GitHub releases endpoint in normal use. Help → What’s New is a browser link (RELEASES_URL), not a feed poll.
    • Failure implicates: leftover updater wiring that should have been deleted with bucket 3.

  • Task 20 — notarized .dmg first open

    • Commit: local artifact at dist/paneflow-0.1.0-aarch64-apple-darwin.dmg (30M)
    • Agent observed: scripts/bundle-macos.sh --version 0.1.0 --arch aarch64 produced dist/PaneFlow.app with CFBundleIdentifier=com.theaamgroup.paneflow and --version paneflow 0.1.0. create-dmg.sh wrote the .dmg then exited 1 at codesign --verify --deep --strict because the enclosed binary is adhoc/linker-signed. That check is for a signed+notarized release; skip it for an unsigned smoke. Gatekeeper will still quarantine a copied .dmg.
    • Agent observed (2026-08-27, issue #11, closed): the release dmg (sha256 501ad651…6198) encloses a Developer ID signed, notarized, stapled app; spctl -a -t exec on a quarantined copy → accepted, source=Notarized Developer ID. The local dist/ dmg above is a different, adhoc build and is not the artifact to open.
    • Steps: download the release dmg in a browser, open it, drag the app to /Applications, launch.
    • Expected: only the standard "downloaded from the Internet" dialog with an Open button (no right-click→Open, no Open Anyway, no xattr -d); PaneFlow.app/Contents/MacOS/paneflow --version prints 0.1.0; glyphs render (not empty boxes).
    • Failure implicates: bundle script, embed staging, or font-kit feature.

Automated visual smoke (not a checkbox)

Done at the start of this run, 2026-08-25, against HEAD 35af5bb:

  • Debug binary ./target/debug/paneflow (paneflow 0.8.2) launched with PANEFLOW_ALLOW_MULTIPLE=1 and PANEFLOW_SOCKET_PATH=/tmp/paneflow-head-smoke.sock.
  • Screenshot: /tmp/pf-screenshots/head-debug-window.png.
  • Observed: window opens; sidebar lists workspace paneflow on main; tab strip shows paneflow; terminal prompt dayers@Davids-MacBook-Pro paneflow % renders as real glyphs, not empty boxes.
  • Log: font: resolved family='JetBrainsMono Nerd Font' (was JetBrainsMono Nerd Font Mono before #420); Terminal backend selected: … effective=alacritty; Assets::load_fonts: registered 36 embedded font file(s).
  • Historical (HEAD 35af5bb, before leftover-removal deleted the updater): update::checker up to date (v0.8.2). That feed is gone; Task 11 above is the current check.