yonlu/yellowjacket
1
1
Fork 0
Code Issues 53 Pull Requests Actions Packages Projects Releases 13 Wiki Activity

NOTES.md has entries the code has since contradicted (v2 seams, migrations, ALSA null) #257

New Issue
Open
opened 2026-09-25 13:25:07 +00:00 by yonlu · 0 comments
yonlu commented 2026-09-25 13:25:07 +00:00
Owner
Copy Link
Copy Source

.planning/NOTES.md is 5,080 lines and several of its dated entries now contradict the code. Found while cutting CLAUDE.md down (#256), not fixed there:

  • "Migrations came back (2026-08-08)" — plan 013 squashed the migration chain; sql/schemas/ is the single description and staleshape.go repairs at open.
  • "The event bridge hooks EventsNotify, not EventsOn" — that is the Wails v2 seam; v3 hooks window._wails.dispatchWailsEvent and fetch to /wails/runtime.
  • "The component tier fakes two globals, and that is all it fakes" — v2 again; v3's fake replaces the IPC transport via setTransport().
  • "An ALSA null PCM is enough for CI audio, and it clocks" — measured false later (3000 ms consumed in ~3 ms); CI uses a PulseAudio null sink.

Direction

Walk NOTES.md top to bottom: mark superseded entries as such (with the entry that superseded them) or delete them, and keep the dated measurements and rejected-ideas list that are still true.

`.planning/NOTES.md` is 5,080 lines and several of its dated entries now contradict the code. Found while cutting CLAUDE.md down (#256), not fixed there: - "Migrations came back (2026-08-08)" — plan 013 squashed the migration chain; `sql/schemas/` is the single description and `staleshape.go` repairs at open. - "The event bridge hooks EventsNotify, not EventsOn" — that is the Wails v2 seam; v3 hooks `window._wails.dispatchWailsEvent` and `fetch` to `/wails/runtime`. - "The component tier fakes two globals, and that is all it fakes" — v2 again; v3's fake replaces the IPC transport via `setTransport()`. - "An ALSA null PCM is enough for CI audio, and it clocks" — measured false later (3000 ms consumed in ~3 ms); CI uses a PulseAudio null sink. ## Direction Walk NOTES.md top to bottom: mark superseded entries as such (with the entry that superseded them) or delete them, and keep the dated measurements and rejected-ideas list that are still true.
yonlu added the
Priority
Low
4
Kind/Documentation labels 2026-09-25 13:25:07 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Area/Design
Area/Downloads
Area/Explore
Area/Library-UI
Area/Metadata
Area/Packaging
Area/Player
Area/Queue
Area/Settings
Area/Shell-Nav
Compat/Breaking
Breaking change that won't be backward compatible
 Kind/Bug
Something is not working
 Kind/Documentation
Documentation changes
 Kind/Enhancement
Improve existing functionality
 Kind/Feature
New functionality
 Kind/Security
This is security issue
 Kind/Testing
Issue or pull request related to testing
 Platform/Android
Platform/Desktop
Priority
Critical
1
The priority is critical
Priority
High
2
The priority is high
Priority
Medium
3
The priority is medium
Priority
Low
4
The priority is low
Reviewed
Confirmed
1
Issue has been confirmed
Reviewed
Duplicate
2
This issue or pull request already exists
Reviewed
Invalid
3
Invalid issue
Reviewed
Won't Fix
3
This issue won't be fixed
Status
Blocked
1
Something is blocking this issue or pull request
Status
Need More Info
2
Feedback is required to reproduce issue or to continue work
Status
Abandoned
3
Somebody has started to work on this but abandoned work
Status
In Progress
Somebody is actively working on this right now
No labels Kind/Documentation
Priority
Low
4
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
logan yonlu
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: yonlu/yellowjacket#257