Skip to content

docs: spinner design spec + doc refresh#64

Merged
AThraen merged 2 commits into
mainfrom
docs/spinner-design
May 17, 2026
Merged

docs: spinner design spec + doc refresh#64
AThraen merged 2 commits into
mainfrom
docs/spinner-design

Conversation

@AThraen
Copy link
Copy Markdown
Contributor

@AThraen AThraen commented May 17, 2026

Summary

Two commits:

  1. 4e24ea1 — Adds the spinner design spec + implementation plan. These two markdown files live alongside the existing superpowers/specs and superpowers/plans for traceability. The matching implementation already shipped via PR feat(bundle): low-hanging fruit + tests, refactor, docs #63; this PR just records the design that drove it.

    • `docs/superpowers/specs/2026-05-16-session-spinners-design.md`
    • `docs/superpowers/plans/2026-05-16-session-spinners.md`
  2. `abfb23a` — Refreshes CLAUDE.md and README for the post-bundle state.

    • CLAUDE.md adds a "Session Spinners" section, a "Visual Studio: Hot Reload disabled" callout (workaround for the .NET 10.0.8 + VS 18 ExecutionEngineException crash), a note about the IPseudoTerminal seam in the architecture diagram, and additions to the Testing section covering the test-double pattern and SearchService temp-SQLite isolation.
    • README.md fills in user-visible features that weren't listed: sidebar groups, recently-closed (Ctrl+Shift+T), per-session run commands (F5), Windows Terminal profile import, and launch/shutdown spinners. Keyboard shortcuts table updated with the missing entries (Ctrl+Shift+T, Ctrl+Alt+T, Ctrl+Shift+Tab, F5, Shift+F5).

Why this is a separate PR

These are the only commits that were unique to PR #62 (feat/session-spinners). #62 was closed unmerged after PR #63 landed the spinner code itself; this PR is a clean follow-up so the design docs and the doc refresh aren't lost.

Test plan

  • No code touched — nothing to test functionally.
  • Markdown renders cleanly on GitHub.

🤖 Generated with Claude Code

AThraen added 2 commits May 17, 2026 13:52
CLAUDE.md:
- New "Session Spinners" section covering the launch + shutdown overlays,
  the 8s silent-session fallback, and the OnClosing yield pattern.
- New "Visual Studio: Hot Reload disabled" callout under Build & Run
  explaining the launchSettings.json + MetadataUpdaterSupport workaround
  for the .NET 10.0.8 + VS 18 ExecutionEngineException crash.
- Architecture > Key layers: PseudoTerminal entry now mentions the
  IPseudoTerminal seam so contributors see how RunInstance/SessionRunner
  get tested without spawning a real ConPTY.
- Testing section: documents IPseudoTerminal injection, SearchService's
  per-test temp-SQLite + ClearAllPools pattern, and the timestamp-seeding
  rule (don't rely on Task.Delay for ordering).

README.md:
- Adds bullets for the visible features that were missing: sidebar groups,
  recently-closed (Ctrl+Shift+T), per-session run commands (F5), Windows
  Terminal profile import, and the launching/shutdown spinners.
- Keyboard shortcuts table now lists Ctrl+Shift+T, Ctrl+Alt+T,
  Ctrl+Shift+Tab, F5, and Shift+F5.
@AThraen AThraen merged commit c027b7f into main May 17, 2026
1 check passed
@AThraen AThraen deleted the docs/spinner-design branch May 17, 2026 11:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant