Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
description: "Task list for device categories in the browser"
Tasks: Device categories in the browser
Input: Design documents from /specs/013-browser-categories/
Prerequisites: plan.md, spec.md, research.md, data-model.md, contracts/ui-contract.md, quickstart.md
Tests: The spec requires a guard (FR-009) and measurable checks (SC-001, SC-003, SC-004),
so the check tasks are part of the work. They extend the existing gate in
tests/Nota.SmokeTest; there is no new test project.
Organization: by user story. Path shorthands:
| Shorthand | Path |
|---|---|
App/ |
src/managed/Nota.App/ |
Application/ |
src/managed/Nota.Application/ |
VM |
src/managed/Nota.Presentation/ViewModels/BrowserViewModel.cs |
Smoke/ |
tests/Nota.SmokeTest/ |
The Xvfb harness and capture scripts from 012 live in /tmp/claude-0/, outside the repo.
Format: [ID] [P?] [Story] Description
- [P]: Can run in parallel (different files, no dependencies on incomplete tasks)
- [Story]: Which user story the task belongs to (US1–US4)
Phase 1: Setup
Purpose: a known-good build and a visual baseline of the three device tabs.
- T001 Build
013-browser-categorieswithscripts/build-linux.sh(Xvfb, PulseAudio null sink) and record the smoke-test result in/tmp, not committed. Only the known "Consort stress" failure is allowed; the palette keystroke budget may also fail under load and passes when re-run quietly. - T002 [P] Capture the baseline Instruments, Audio effects and MIDI effects tabs (browser at its default width, fresh
HOME) in all four themes into/tmp/claude-0/shots/browser-before/. Use a small/tmp/claude-0/scripts/browser-tabs.sh <theme> <outdir>that clicks the three rail tabs. Also capture the Audio effects tab with ⋮ open.
Phase 2: Foundational (blocking)
Purpose: category data, the guard, settings and row fields. Every story builds on these.
T003 Create
Application/Palette/DeviceCategories.cs:the two-line SPDX header and a why-comment;
a
public const string Other = "Other";per
BuiltinDeviceType, an ordered list of(string Name, string[] Builtins)written exactly as the spec's Assumptions list them:- Instruments: Synths, Keys & physical, Drums, Samplers, Racks;
- Audio effects: EQ & filter, Dynamics, Reverb & delay, Modulation, Distortion, Pitch & time, Utility, Racks;
- MIDI effects: Generate, Shape.
Use the full catalogue names (
"Nota Reverb").For(BuiltinDevice)returns the category, orOther;Order(BuiltinDeviceType)returns the names in tab order;Position(BuiltinDeviceType, string)returns the index, orint.MaxValueforOtheror an unknown name;ForPlugin(bool instrument, string reported)returnsOtherfor now (US4 fills it in).
See data-model.md § DeviceCategory.
T004 [P] Create
Smoke/DesignTokenCheck.Browser.cs, apartial class DesignTokenCheckwith the SPDX header andRunBrowser(). Per research R7 it yields:- every
BuiltinDeviceCatalog.Allentry is in exactly one category of its own type (noneOther); - every listed name exists in the catalogue with that type (a stale name fails, naming it);
- no category has an empty
Builtins; NotaText.Label(name) == namefor every category name;- the per-tab totals are 18 / 26 / 6.
Each failure names the device or category.
- every
T005 Wire
RunBrowser()intoSmoke/Program.csas a-- design: browser --section, next to the otherDesignTokenCheck.Run*calls (around line 63–81).T006 [P] In
Application/Settings.cs, add these next toBrowserGroupBySource, each with an XML doc line:public bool BrowserCategoryView { get; set; } = true;public List<string> BrowserFoldedCategories { get; set; } = new();
See data-model.md § Settings.
T007 In
VMBrowserItem, add:public string DeviceCategory { get; init; } = "";public bool IsFoldable { get; init; }public bool IsFolded { get; init; }
In
Rebuild(), setDeviceCategoryon each built-in (look up theBuiltinDeviceinBuiltinDeviceCatalog.AllbyTypeandKind, thenDeviceCategories.For). Set it toDeviceCategories.Otheron plug-ins for now.T008 Build and run the smoke test.
-- design: browser --must be green, and the rest unchanged from T001.Result: T001 baseline — only "Consort stress" fails. Design checks 152/152 (134 + 18 new browser checks).
ForPluginwas written in full with T003 and plug-in rows get it in T007, so T026–T027 land here.
Checkpoint: categories exist and are guarded. Nothing visible has changed yet.
Phase 3: User Story 1 — Browse devices by what they do (Priority: P1) 🎯 MVP
Goal: the device tabs show built-in devices grouped by category by default (contract C1, research R3).
Independent test: on a fresh profile, each device tab lists its categories in the fixed order, and every built-in appears exactly once, alphabetically within its category.
T009 [US1] In
VM, add theCategoryViewproperty: abool _categoryView = true, and a setter that rebuilds the device tabs, following theGroupBySourcepattern. Doc comment: "Group the device tabs under category headers."T010 [US1] In
VMRebuildVisible(tab), branch on_categoryView, leaving the existing flat path byte-for-byte unchanged. In the category branch:- Filter devices with today's library-filter and query rules.
- Order them by these keys:
DeviceCategories.Position(type, DeviceCategory);- then, if
_groupBySource,IsPlugin; - then, if
_favoritesFirst && _library != null, not-favourite; - then
ShortName(StringComparer.OrdinalIgnoreCase).
- For each run of the same category, emit a
Grouprow:Name= the category;GroupCount= the devices in that run;Path = $"cat:{TabKey(tab)}:{name}", whereTabKeyisinstr,fxormidi;IsFoldable = true.
- Emit the devices and their preset rows exactly as the flat path does.
T011 [P] [US1] Add
FakeBrowserLibrary : IBrowserLibrarytoSmoke/BrowserTestSupport.cs: in-memory favourites (aHashSet<string>), no tags (empty lists, no-op tag methods).T012 [US1] Update the existing browser search assertion in
Smoke/Program.cs(around line 14510): with the category view on by default, the expected sequence for "Glacier" isSynths, Nota Aurora, Pads, Glacier Pad.T013 [US1] Add category-view checks to the browser block of
Smoke/Program.cs, using a freshBrowserViewModeloverEmptyPluginCatalog:- (a) On each tab, the
Grouprow names equalDeviceCategories.Order(type). - (b) Each built-in appears exactly once, under its
DeviceCategories.Forheader. - (c) Within each category, devices are in
ShortNameorder. - (d) Header
GroupCountequals the rows beneath it. - (e) With a
FakeBrowserLibrarywhere Nota Delay is a favourite, Delay is first under Reverb & delay (FR-004). - (f) Expanding a device in the category view inserts its preset rows directly beneath it, inside its category (FR-007).
- (g) A search for "Compressor" shows Compressor under the Dynamics header; every header shown has at least one device row beneath it, and categories without matches are absent (FR-006).
- (a) On each tab, the
T014 [US1] Build, run the smoke test, then capture the three tabs in all four themes into
/tmp/claude-0/shots/browser-after/withbrowser-tabs.sh. Check:- the headers match the Built-in header style (FR-008, SC-005);
- "EQ & filter" keeps its casing;
- every device is visible under a header (SC-001).
Result: the category checks live in
Smoke/BrowserCategoryTests.cs(run in sequence fromProgram.cs, or alone with--browser) rather than inline, so they can be run in seconds. 18/18 pass. Studio Dark capture: headers in order with counts, devices alphabetical, "EQ & filter" keeps its casing. The four-theme run is in T025 and T034, once the caret is in.
Checkpoint: MVP. The browser is categorised by default; folding, the off switch and plug-in mapping follow.
Phase 4: User Story 2 — Turn the category view off (Priority: P2)
Goal: "Group by category" in ⋮, persisted; off restores today's list exactly (contract C4, research R5).
Independent test: untick "Group by category" and the flat list returns row for row; it stays off after a restart.
T015 [US2] In
App/BrowserView.csShowOptionsMenu, add aCheckItem("Group by category", _vm?.CategoryView ?? true, v => …)directly after "Show type tags" and before "Group by source". It sets_vm.CategoryView, saves_settings.Current.BrowserCategoryView, and callsRefreshCounts().T016 [US2] In
App/BrowserView.csSetSettingsandSetViewModel, applysettings.Current.BrowserCategoryViewtovm.CategoryView, alongsideGroupBySourceandFavoritesFirst.T017 [US2] Add checks to
Smoke/Program.cs:- (a) With
CategoryView = false, the Instruments sequence isBUILT-INfollowed by every built-in instrument inNameorder, which is today's flat list (SC-003). Same for the Audio effects tab. - (b) Turning it back on restores the category headers.
- (c)
JsonSerializer.Deserialize<Settings>("{}")hasBrowserCategoryView == trueand an emptyBrowserFoldedCategories(FR-003, existing users).
- (a) With
T018 [US2] Manual check under Xvfb (quickstart § 2 step 4): untick, relaunch with the same
HOME, and it's still off. Compare the flat-list screenshot with the T002 baseline: it must be identical.Result: the checks are in
Smoke/BrowserCategoryTests.cs; all pass. Under Xvfb, unticking wrote"BrowserCategoryView": false. After a relaunch the Instruments list matches the T002 baseline except a 40×36 patch on the rail button that had just been clicked (hover state); the list itself is pixel-identical.
Phase 5: User Story 3 — Fold the categories you don't need (Priority: P2)
Goal: headers fold on click; folds persist per tab; a search ignores folds without changing them; counts are unaffected (contract C2, C3, C5; research R4, R6).
Independent test: fold all but one category on Audio effects; only that category's devices show; switch tabs and restart, and the folds are kept; a search reveals hits inside folded categories, and clearing the search restores the folds.
T019 [US3] In
VM, add the fold state:HashSet<string> _folded(StringComparer.Ordinal) with keys"{TabKey}:{name}";SetFoldedCategories(IEnumerable<string>), which loads without raising the event;IReadOnlyCollection<string> FoldedCategories;public event Action? CategoryFoldsChanged;ToggleCategoryFold(BrowserItem header). It does nothing unlessheader.IsFoldable. Otherwise it parses the tab fromPath(cat:<tabKey>:<name>), flips the key,RebuildVisible(tab), and raises the event.
T020 [US3] In
VMRebuildVisible's category branch:- No query: a header in
_foldedgetsIsFolded = trueand its devices and presets are skipped; the header and itsGroupCountstay. - Query active: headers get
IsFoldable = falseandIsFolded = false, and folds are ignored.
- No query: a header in
T021 [US3] In
VM, record per-tab(builtin, plugins)counts of the filtered devices before folding, duringRebuildVisible(both branches), and haveVisibleDeviceCounts(tab)return them (R6). Check thatApp/BrowserView.csStatusForstill reads correctly.T022 [US3] In
App/BrowserView.csGroupRow, whenitem.IsFoldable:- Caret: put
RailIcon(item.IsFolded ? GlyphKind.CaretRight : GlyphKind.CaretDown, 12, "Brush.TextTertiary")before the label in a new leadingAutocolumn, with the label's left margin adjusted so the caret sits where a device row's disclosure sits. - Click:
Cursor = Hand;PointerPressedcalls_vm?.ToggleCategoryFold(item), thenRefreshCounts(), and setse.Handled = true. - Accessible name:
AutomationProperties.SetName(grid, $"{name}, {count} devices, {(folded ? "folded" : "open")}").
Non-foldable group rows (Built-in / Plug-ins, or any header during a search) render exactly as today. The new tooltip and automation strings must pass
RunLabels.- Caret: put
T023 [US3] In
App/BrowserView.cs:SetSettings/SetViewModelcallvm.SetFoldedCategories(settings.Current.BrowserFoldedCategories);- subscribe once to
vm.CategoryFoldsChanged, which writes_settings.Current.BrowserFoldedCategories = vm.FoldedCategories.ToList()and calls_settings.Save().
T024 [US3] Add checks to
Smoke/Program.cs:- (a) Folding Dynamics on Audio effects removes Compressor, Prism, Ceiling and Shutter. The Dynamics header stays with
IsFoldedandGroupCount == 4. - (b)
VisibleDeviceCounts(1)is unchanged by the fold. - (c) A search for "Prism" shows Dynamics (
IsFoldable == false) with Prism. Clearing the query brings back the folded Dynamics, andFoldedCategoriesis unchanged throughout (US3/AC2). - (d)
ToggleCategoryFoldduring a search is a no-op. - (e) Folding on Audio effects doesn't affect Instruments'
Racks(keys are per tab). - (f)
SetFoldedCategories(new[]{"fx:Dynamics","fx:Nonexistent"})folds Dynamics and ignores the unknown key.
- (a) Folding Dynamics on Audio effects removes Compressor, Prism, Ceiling and Shutter. The Dynamics header stays with
T025 [US3] Manual check under Xvfb (quickstart § 2 steps 2–3, 7):
- fold, switch tabs, relaunch: the folds are kept;
- a search shows hits in folded categories with no caret, and clearing it restores the folds;
- the minimum browser width truncates captions with the caret and count visible.
Screenshot folded and open headers in all four themes.
Result: all fold checks pass (
--browser). Under Xvfb:- Dynamics and Modulation fold with their counts kept, and the status line stays "26 built-in";
- "comp" shows Dynamics open with no caret, and clearing it restores both folds;
- a relaunch restores the folds from
settings.json; - at the 160 px minimum width the caption, caret and count stay visible, with no overlap.
Two fixes found here:
- a header click no longer opens the empty preview player (it cleared
_listPointerDown; the same flash existed on the old Built-in header); - the search-box count and the empty state include devices under folded headers, so a tab with every category folded doesn't say "No audio effects yet".
Four-theme captures are in T034.
Phase 6: User Story 4 — Plug-ins land in the same categories (Priority: P3)
Goal: plug-ins map from their reported category; unknown goes to Other, last; source order respected (contract C1, research R2, R3).
Independent test: with fake plug-ins reporting Fx/Reverb and Effect, the first appears under Reverb & delay and the second under Other, last.
T026 [US4] Implement
DeviceCategories.ForPlugin(bool instrument, string reported)inApplication/Palette/DeviceCategories.csper research R2:- split on
/and|, then trim and lower-case each token; - the first token found in the tab's table wins;
- skipped tokens are listed in a comment;
- empty or unrecognised maps to
Other.
Token tables:
- Instruments:
synth→ Synths;piano→ Keys & physical;drum→ Drums;sampler→ Samplers. - Effects:
eq,filter→ EQ & filter;dynamics,mastering→ Dynamics;reverb,delay→ Reverb & delay;modulation→ Modulation;distortion→ Distortion;pitch shift→ Pitch & time;analyzer,tools,spatial,surround,restoration,up-downmix→ Utility.
- split on
T027 [US4] In
VMRebuild(), set plug-in rows'DeviceCategory = DeviceCategories.ForPlugin(isInstrument, category), replacing the T007 placeholder.T028 [P] [US4] Add
FakePluginCatalog(params string[] descriptions) : IPluginCatalogtoSmoke/BrowserTestSupport.cs. Descriptions use theName | Format | inst|fx | Vendor | Categoryform thatRebuild()parses;Idis"fake:" + index.T029 [US4] Add checks to
Smoke/Program.cs:- (a)
ForPlugintable cases:Fx/Reverb→ Reverb & delay;Fx/Dynamics/EQ→ Dynamics (first recognised);Fx/Pitch Shift→ Pitch & time;Instrument/Synth/Sampler→ Synths;Instrument/Drum→ Drums;Effect→ Other;""→ Other;Fx→ Other.
- (b) A view model over a
FakePluginCatalogwith "Ambience | VST3 | fx | Smart | Fx/Reverb", "Mystery | AU | fx | Acme | Effect" and "Ana | VST3 | inst | Sonic | Instrument/Synth":- with Group by source on, Reverb & delay lists Chamber, Delay, Reverb, then Ambience;
- with it off, it lists Ambience, Chamber, Delay, Reverb (interleaved by short name);
- Other is the last header on Audio effects and holds Mystery;
- Ana is under Synths after the built-ins;
- the MIDI tab is unaffected.
- (c) No separate
BUILT-IN/PLUG-INSheader appears in the category view (FR-005).
Result: T026–T028 landed with Phase 2–3 (
ForPluginin T003, plug-in rows in T007,FakePluginCatalogwith T011). T029's checks pass: the mapping table; Reverb & delay with Group by source on (Chamber, Delay, Reverb, Ambience) and off (Ambience, Chamber, Delay, Reverb); Other last; a synth plug-in after the built-in synths; no source headers; the MIDI tab untouched; counts 26 + 2.- (a)
Phase 7: Polish & Cross-Cutting
T030 [P]
DESIGN.md:- Browser bullet (layout section, around line 651): device tabs group under foldable category headers in the group-header style, with a 12 px disclosure caret and the count; Other is last; a search ignores folds.
- "Enforced by tests" list: add
RunBrowser.
Regenerate
DESIGN.htmlwithpython3 scripts/design-html.py.T031 [P]
.claude/skills/nota-instrument/SKILL.md: add "add the device to its category inApplication/Palette/DeviceCategories.cs(theRunBrowsercheck fails otherwise)" to the registration checklist.T032 [P]
CHANGELOG.md[Unreleased]Added: the browser groups instruments, audio effects and MIDI effects into foldable categories by default (plug-ins included, by their reported category). "Group by category" in ⋮ turns it off.T033 [P] Run the nota-features skill for
FEATURES.md: the browser section (categories, folding, the view option). Note nota-docs (the sibling reponota-daw/nota-docs, unavailable here) as a follow-up in the PR. nota-shortcuts is N/A (no shortcut change). Result:- DESIGN.md has a "Browser categories" bullet and a
RunBrowserrow.DESIGN.htmlis regenerated from tokens only, so it is unchanged. - FEATURES.md gains a "Device categories" bullet and "group by category" in View options. The compact-index bullet's stale "tertiary Nota prefix" claim now describes the short names shipped in 008.
- The nota-docs follow-up goes in the PR.
- DESIGN.md has a "Browser categories" bullet and a
T034 Run quickstart.md § 2 in full under Xvfb in all four themes. Make before/after contact sheets of the three device tabs (T002 vs final) for the PR.
T035 Nota closing checks:
- the two-line SPDX header is on
Application/Palette/DeviceCategories.csandSmoke/DesignTokenCheck.Browser.cs; - no new dependency (
LICENSES/third-party.mdN/A); - no engine behaviour change (smoke engine coverage N/A). Result:
- T034: the three device tabs, captured in all four themes plus Studio Light with folds, read correctly. Headers match the Built-in header style, and the caret sits in the device caret column. Contact sheets were sent in the session.
- T035: SPDX headers are on the three new files. No dependency, native or project-format change.
- the two-line SPDX header is on
T036 (moved to T049, after the chips rework) Final gate: a full
scripts/build-linux.sh. Only the known "Consort stress" failure is allowed (it also fails on the base). Then run/speckit-converge.
Dependencies & Execution Order
- Setup (1) → Foundational (2) blocks every story: categories, guard, settings and row fields.
- US1 (3) is the MVP and comes before US2, US3 and US4, which all build on the category branch in
RebuildVisible(T010). - US2 (4) and US3 (5) are independent of each other once US1 is done. Both touch
App/BrowserView.cs, so run them one after the other (US2 first, it's smaller). - US4 (6) depends only on US1 (T010) and T007. It can run alongside US2 and US3 except where
Smoke/Program.csis shared, which is sequential. - Polish (7) comes last.
Within phases:
- T004 ∥ T006 (different files) after T003;
- T011 ∥ T009–T010;
- T028 ∥ T026–T027;
- T030 ∥ T031 ∥ T032 ∥ T033.
Parallel Example: Phase 2
T003 DeviceCategories.cs
→ T004 DesignTokenCheck.Browser.cs ∥ T006 Settings.cs
→ T005 wire RunBrowser → T007 BrowserItem fields + Rebuild → T008 build
Implementation Strategy
- MVP: Phases 1–3. Built-ins are categorised by default, guarded by
RunBrowser. This is shippable alone. - Then US2 (off switch), US3 (folding) and US4 (plug-ins), one commit each.
- Then docs, the screenshot run and converge.
Notes
- The flat path is frozen. T010 must not change today's branch of
RebuildVisible, and T017(a) proves it. - Device rows are shared objects between the two views. Never copy a
BrowserItemdevice to place it under a header, or drag, favourite and expand state would split. - Header names come from
DeviceCategoriesonly. Never retype a category string in the view or tests: useDeviceCategories.OrderandFor.
Phase 8: Rework — category chips instead of headers (research R9)
Why: after seeing the headers build (US1 and US3 above), the user chose Ableton-style
chips. Spec FR-002–FR-006, US1–US3, the plan summary, the data model and the contract are
revised. The category data, RunBrowser, the plug-in mapping and the test fakes stay.
The header branch, folding and their checks are removed.
Independent test: each device tab shows its chips. A chip lists exactly its category, and with no chip the list is today's.
T037 In
VM, remove the headers build:CategoryView, theRebuildCategoryViewbranch and its call;- the fold state (
_folded,SetFoldedCategories,FoldedCategories,CategoryFoldsChanged,ToggleCategoryFold,FoldedDeviceCount,_foldedDevices) and the folded counts inVisibleDeviceCounts, which goes back to as before; BrowserItem.IsFoldable/IsFolded.
Keep
DeviceCategory,TabKeyandTypeOf.T038 In
VM, add the category filter (data-model § Category filter):string[] _categoryFilter = { "", "", "" };CategoryFilter(int tab);SetCategoryFilter(int tab, string name), which rebuilds that tab;CategoriesOn(int tab):Order(TypeOf(tab)), plusOtherwhen any tree node's shelf isOther;- in
RebuildVisible's device loop,if (!PassesCategoryFilter(tab, node)) continue;besidePassesLibraryFilter. The shelf isDeviceCategory, normalised toOtherwhen the tab doesn't list it.
T039 [P] In
Application/Settings.cs, replaceBrowserCategoryViewandBrowserFoldedCategorieswithpublic bool BrowserCategoryChips { get; set; } = true;(doc: "Show the category chips above the device lists (Synths, Dynamics…)").T040 In
App/BrowserView.cs, remove the headers build:- restore
GroupRow(no caret, no click, the original margins and columns); - restore
VisibleCountwithout folded devices; - remove the fold load/save wiring,
CategoryViewapplication, and the "Group by category" ⋮ item.
- restore
T041 In
App/BrowserView.cs, add the chip row:- a
WrapPanel _categoryChipsin a hostBorder(same margins as_chipsHost), placed intopStackbetweenheaderRowand_chipsHost; RebuildCategoryChips()makes oneMakeChip(name, null, active, …)per_vm.CategoriesOn(_active); a click toggles_vm.SetCategoryFilter(_active, active ? "" : name), then rebuilds the chips and callsRefreshCounts();- shown only on tabs 0–2 while
BrowserCategoryChipsis on; rebuilt on tab change and onDevicesRebuilt; - a tooltip " devices" per chip if cheap, else none.
The chip spacing matches the Files tab's
_sampleChips.- a
T042 In
App/BrowserView.cs, addCheckItem("Category chips", …)in ⋮ after "Show type tags". It savesBrowserCategoryChips; turning it off callsSetCategoryFilter(t, "")for tabs 0–2, then updates the row's visibility andRefreshCounts(). Apply the setting inSetSettings/SetViewModel.EmptyMessage'sfilteringalso counts a picked category.T043 Rewrite
Smoke/BrowserCategoryTests.csfor chips:- (a) No pick: each tab equals today's list (
BUILT-INplus built-ins byName). - (b)
CategoriesOnequalsOrderon each tab (no plug-ins means no Other). - (c) For every category, picking it lists exactly its built-ins (
DeviceCategories.Of(type)), and the union over the chips covers every device once. - (d) Clearing the pick restores (a).
- (e) Picks are per tab.
- (f) Dynamics plus the search "Prism" gives only Prism; Dynamics plus Favorites with Compressor favourited gives only Compressor.
- (g) Expanding a device while picked shows its presets beneath it.
- (h) The
ForPlugintable. - (i) With
FakePluginCatalog: Reverb & delay givesBUILT-IN, Chamber, Delay, Reverb,PLUG-INS, Ambience;CategoriesOn(1)ends with Other, which lists Mystery; Synths includes Ana; the MIDI tab has no Other. - (j)
Deserialize<Settings>("{}").BrowserCategoryChips == true.
Restore the
Program.csGlacier assertion toBUILT-IN, Nota Aurora, Pads, Glacier Pad.- (a) No pick: each tab equals today's list (
T044 Build. Run
--browserand the design checks (check.sh): all pass,RunLabelsincluded (the new chip and ⋮ strings).T045 Under Xvfb, run quickstart § 2 steps 1–6:
- pick and clear a chip;
- switch chips;
- a chip plus search and Favorites;
- the pick is kept per tab;
- ⋮ off clears and hides it and survives a relaunch;
- the minimum width wraps.
Compare the no-pick list with the T002 baseline (it must be pixel-identical below the chip row).
T046 Capture the three tabs in all four themes, with and without a chip picked, and make before/after contact sheets for the PR (quickstart § 2 step 7). Result:
- Checks:
--browser29/29; design checks 152/152 (RunLabelsincluded).BrowserView.cswas restored to its pre-headers state and the chip row added fresh. - Under Xvfb:
- Audio effects shows 8 chips in three wrapped rows above Favorites;
- Reverb & delay narrows to Chamber, Delay and Reverb;
- Dynamics switches the list, and with "prism" it shows only Prism;
- Instruments is unfiltered while Audio effects keeps Dynamics.
- ⋮ off: clears the pick and hides the row. After a relaunch, the list matches the T002 baseline pixel for pixel (AE 0).
- Minimum width: one chip per line, no overlap.
- Captures: four themes, unpicked and picked. Contact sheets were sent in the session.
- Checks:
T047 [P] Docs:
DESIGN.md: replace the "Browser categories" bullet with the chip row (its own wrapping row above Favorites/tags,MakeChip, one pick per tab, Other last when used);FEATURES.md: replace the "Device categories" bullet and the View options wording ("category chips");CHANGELOG.md: rewrite the Added entry for chips.
T048 [P] Re-check
.claude/skills/nota-instrument/SKILL.md. The category step stays as written: it namesDeviceCategories.csand the browser check, not headers.T049 Final gate: a full
scripts/build-linux.sh. Only the known "Consort stress" failure is allowed. Then run/speckit-converge.Result: 3265 passed and 1 failed. The failure is "Consort stress" (2.23 ms against a 2.90 ms budget), which also fails on the base (T001). Results:
-- design: browser --all pass;-- browser: device categories --29/29;- the restored search assertion passes (
BUILT-IN / Nota Aurora / Pads / Glacier Pad).
Phase 9: Convergence
- T050 Reword
specs/013-browser-categories/plan.md§ "Nota: Read Before Planning" (line 44): the chips reuseMakeChip(the filter-chip style), notGroupLabeland the disclosure caret, per plan: R9 chips decision (contradicts) - T051 Update the
DESIGN.mdFilter chips row (line 466): the Favorites / tags strip overflows into+N, and the device tabs' category row wraps so every category stays in sight, per FR-008 (partial)