Nota — a free DAW for macOS, Windows and Linux. No subscription, no account — just open it and make music.
description: "Tasks for spec 092 — browser sample folders, browse mode, Locate, Projects tab, rail icon"
Tasks: Browser — your own sample folders, a file-system browse mode, Locate, and a richer Projects tab
Input: Design documents from specs/092-browser-files-projects/
Prerequisites: plan.md, spec.md, research.md, data-model.md, contracts/, quickstart.md
Tests: Included — constitution IV requires the smoke test to cover new behaviour; plan R9
lists the checks. All tests live in tests/Nota.SmokeTest/ as Run() iterators of
(bool Ok, string Label) (pattern: SampleStoreTests.cs), wired into Program.cs both in
the full run and behind a standalone flag.
Organization: Tasks are grouped by user story (spec.md US1–US5).
Format: [ID] [P?] [Story] Description
- [P]: Can run in parallel (different files, no dependencies on incomplete tasks)
- [Story]: US1 sample folders (#346/#268) · US2 rail icon (#579) · US3 browse mode (#580) · US4 Locate (#581) · US5 Projects tab (#582)
Path Conventions
- Managed:
src/managed/<Project>/…· Strings:src/managed/Nota.Application/Localization/en.json(RU later in../nota-translations/languages/ru.json) · Tests:tests/Nota.SmokeTest/ - Every new source file starts with the two-line SPDX header
(
// SPDX-License-Identifier: AGPL-3.0-only/// Copyright (c) 2026 Egor Khindikaynen (Nota). See LICENSES/ for license terms.) followed by a short why this file exists comment.
Phase 1: Setup (Shared Infrastructure)
Purpose: Test scaffolding the stories add to.
- T001 Create empty test classes
SampleFoldersTests,FileBrowseTests,ClipSourceTests,ProjectSummaryTests(eachinternal static class … { public static IEnumerable<(bool Ok, string Label)> Run() { yield break; } }, SPDX header) intests/Nota.SmokeTest/SampleFoldersTests.cs,FileBrowseTests.cs,ClipSourceTests.cs,ProjectSummaryTests.cs - T002 Wire the four classes into
tests/Nota.SmokeTest/Program.cs: a standalone flag--browser-files(runs all four, printsBROWSER FILES PASSED/FAILED, next to the existing--browserblockline 198) and aline 15634)-- browser files (spec 092) --section in the full run right after theBrowserCategoryTestssection (
Phase 2: Foundational (Blocking Prerequisites)
Purpose: The settings shape every story reads.
- T003 Add settings fields in
src/managed/Nota.Application/Settings.cs:public List<SampleFolderEntry>? SampleFolders { get; set; }withSampleFolderEntry { string Path = ""; string? Name; bool IsDefault }(Path: "Absolute, normalised (no trailing separator).""only for the migrated default-location entry"; Name: "Display label; null/empty → folder name. Never renames on disk"; IsDefault: "Exactly onetruein the list");public bool FilesBrowseMode { get; set; }(default false = Tree);public string FilesBrowseFolder { get; set; } = "";public string ProjectsSort { get; set; } = "Date"("Date" | "Name"). KeepSamplesFolderand update its doc comment: "mirror of the default SampleFolders entry, kept for older versions and Mosaic refs" - T004 Add
ResolvedSampleFolderrecord(int Index, string Path, string Label, bool IsDefault, bool Available),SampleFolderResult(Added,AlreadyPresent,Overlaps,NotADirectory, with the conflicting index) and theISettingsServicemembers from contracts/persisted-formats.md (ResolvedSampleFolders(),AddSampleFolder,RemoveSampleFolder,RenameSampleFolder,SetDefaultSampleFolder,event Action? SampleFoldersChanged) insrc/managed/Nota.Application/Settings.cs - T005 Create pure rules
SampleFolderRulesin newsrc/managed/Nota.Application/Browser/SampleFolderRules.cs:Normalize(path),IsSameOrInside(a, b)(OS path comparer: case-insensitive on Windows/macOS, sensitive on Linux; separator-aware so/A/Drumis not inside/A/Drums),Check(existing, candidate) → SampleFolderResult,Repair(list, legacySamplesFolder)(migration: null/empty →[{Path = legacy, IsDefault = true}]; zero/several defaults → first is default; drop entries equal to/nested in/containing an earlier one, returning dropped for logging) - T006 Implement in
src/managed/Nota.Infrastructure/Settings/SettingsService.cs: runSampleFolderRules.Repairon load; on save writeSamplesFolder = default.Path;ResolvedSamplesFolder()returns the default entry resolved (""→~/Music/Nota Samples, created if missing — unchanged behaviour);ResolvedSampleFolders()(never creates non-default folders;Available = Directory.Exists); Add (normalise → rules → append → save → raise), Remove (false for the last entry; removing the default promotes the next), Rename (null/blank clears), SetDefault; all mutators save and raiseSampleFoldersChanged - T007 Update the test double in
tests/Nota.SmokeTest/SampleStoreTests.cs(~line 178, the class implementingResolvedSamplesFolder()) and any otherISettingsServiceimplementations (grep -rn ": ISettingsService" src tests) so the solution builds
Checkpoint: builds; old settings files load into a one-entry list; nothing visible changed.
Phase 3: User Story 1 — Several sample folders in the browser (P1) 🎯 MVP
Goal: Add/remove/rename/default folders in Settings → Library and from the Files tab; each is a root in the Files tab, indexed, searched, filtered.
Independent Test: quickstart.md steps 1–4.
Tests for User Story 1
- T008 [P] [US1] In
tests/Nota.SmokeTest/SampleFoldersTests.cscheckSampleFolderRules: legacySamplesFolder="/x/A"→ one default entry; empty legacy →Path=""default; two defaults repaired to first; duplicate (incl. trailing slash / case on macOS-Windows) →AlreadyPresent;/A/Drumsvs/A→Overlapsboth directions;/A/Drumvs/A/Drums→ not overlapping; nested entry in a loaded list is dropped - T009 [P] [US1] In
tests/Nota.SmokeTest/SampleFoldersTests.cscheckSettingsServiceagainst a tempNOTA_DATA_DIR: add/rename/set-default/remove round-trip through save+reload;SamplesFoldermirrors the default after each save; remove of the only entry returns false; removing the default promotes the next;ResolvedSampleFolders()marks a deleted folderAvailable=falseand keeps it - T010 [P] [US1] In
tests/Nota.SmokeTest/SampleFoldersTests.cscheckBrowserViewModel.RebuildSampleswith two temp roots (useBrowserTestSupport): two top-level folder nodes, default first, labels = Name ?? folder name, files under the right root, the default root'sDownloadedsubfolder first within it, an unavailable root present withUnavailable=trueand no children, search finds a file in the second root - T011 [P] [US1] In
tests/Nota.SmokeTest/SmartSampleTests.cs(index section) checkSampleLibraryIndex.Watch(new[]{rootA, rootB})analyses files from both roots, name hints use the containing root, and files under a root that disappears are not swept
Implementation for User Story 1
- T012 [US1] Change
ISampleIndex.Watch(string root)toWatch(IReadOnlyList<string> roots)insrc/managed/Nota.Application/Ports/ISampleIndex.csand implement insrc/managed/Nota.Infrastructure/SampleStore/SampleLibraryIndex.cs:_rootslist replaces_root(clearInfowhen the set changes),Scanenumerates roots in order honouring_priority,Classifypasses the containing root toSampleNameHints.Parse, the stale sweep runs per available root only,Prioritizere-watches_roots; update every caller (grep -rn "\.Watch(" src/managed) - T013 [US1] Rework
RebuildSamples()insrc/managed/Nota.Presentation/ViewModels/BrowserViewModel.cs: iterate_settings.ResolvedSampleFolders(); one top-levelBrowserItem(Kind Folder, Depth 0,PlaceIndex= entry index,Unavailable, Name = Label, Path = root) per entry;GetOrCreateFolderkeyed under each root;MaxSamplescap per root;AppendKitFolders()unchanged;_index?.Watch(available roots); enumeration moves to a backgroundTaskthat builds the tree then swaps it in on the UI thread (cancel a running build when a new one starts; show first-level folders before files fill in). Also fix the secondResolvedSamplesFolder()use (~line 704) to search all roots where it means "the library" - T014 [US1] Add
PlaceIndex(int, default −1),Unavailable(bool) andLocated(bool, used by US4) toBrowserItem(grep -rn "class BrowserItem" src/managed) - T015 [US1] Subscribe
BrowserViewModeltoISettingsService.SampleFoldersChanged→RebuildSamples()and refresh availability when the Files tab is shown, insrc/managed/Nota.Presentation/ViewModels/BrowserViewModel.csandsrc/managed/Nota.App/BrowserView.cs(tab activation ~line 715) - T016 [US1] New partial
src/managed/Nota.App/BrowserView.Places.cs: root-row context menu (Rename → inline prompt reusing the existing rename prompt helper; Remove from browser → confirm when it is the default, naming the next default; Show in Finder/Explorer/file manager viaMenuKit.RevealLabel+RevealRequested; Set as default); dimmed style + "Unavailable" sub-label forUnavailablerows (tokens only, nota-design) - T017 [US1] Files-tab header Add folder… button (
GlyphKind.Plus, tooltip) opening the OS folder picker (StorageProvider.OpenFolderPickerAsync, start at default folder) and folder drop: insrc/managed/Nota.App/BrowserView.csdrop handler (ExternalFiles, ~line 103–140) route directories toAddSampleFolder, files stay as today; show refusal notes from contracts/ui.md through the browser status line - T018 [US1] Replace the single Samples-folder picker (
src/managed/Nota.App/PreferencesWindow.cs~line 971) with a Sample folders list insrc/managed/Nota.App/PreferencesWindow.Samples.cs: rows (label, path, Default badge, Unavailable note, Show, ⋯ menu Rename / Set as default / Remove), Add folder…, drop target; rebuild onSampleFoldersChanged; Remove disabled for the only entry - T019 [US1] Make the default folder drive pack installs and Mosaic roots on change:
src/managed/Nota.Infrastructure/SampleStore/SampleStore.cskeepssettings.ResolvedSamplesFolder(verify it re-reads per install, not cached),src/managed/Nota.Infrastructure/Mosaic/MosaicLibrary.csre-callsNotaEngine.SetPathRoot(MosaicPaths.SamplesRoot, …)onSampleFoldersChanged - T020 [US1] Add EN strings to
src/managed/Nota.Application/Localization/en.json:browser.add_folder,browser.remove_from_browser,browser.set_as_default,browser.unavailable,browser.folder_already_added,browser.folder_inside("Inside {0} — already in the browser"),browser.folder_contains("Contains {0} — remove it first"),browser.remove_default_confirm("{0} becomes the default folder for downloaded packs."),preferences.sample_folders,preferences.default, plus any new labels used in T016–T018
Checkpoint: US1 works alone (quickstart 1–4); --browser-files and --smart-samples pass.
Phase 4: User Story 2 — Files rail icon size (P1)
Goal: The folder glyph matches the other rail icons.
Independent Test: quickstart step 5.
- T021 [P] [US2] In
src/managed/Nota.App/Controls/Glyph.csremove the proceduralcase GlyphKind.Folder(line 341) and add a 24-grid entry to the path table (line 468, next to[GlyphKind.Doc]): outline spanning x 3.5–20.5, y 5–19 with the tab at top-left, e.g."M3.5 6.5 a1.5 1.5 0 0 1 1.5 -1.5 h4.6 l2 2.2 h7.4 a1.5 1.5 0 0 1 1.5 1.5 v8.8 a1.5 1.5 0 0 1 -1.5 1.5 h-14 a1.5 1.5 0 0 1 -1.5 -1.5 z"; tune by screenshot so its extent matches Doc/Bookmark - T022 [US2] Screenshot the rail (headless harness, memory: nota-ui-verify) in Studio Dark/Light, Ember Graphite/Paper and the classic look; also check
GlyphKind.Folderusers:ArrangementView.Tracks.cs:210,ArrangementView.cs:2857,DeviceChainView.Clipboard.cs:558,PreferencesWindow.Skins.cs:71,DeviceCards/Instruments/RhythmInstrumentCard.cs:322(8 px)
Checkpoint: icon shots before/after saved for the PR.
Phase 5: User Story 3 — Browse mode (P2)
Goal: Tree / Browse toggle; Browse walks the file system with Back/Forward/Up, path bar, Copy path, typed/pasted paths.
Independent Test: quickstart step 6.
Tests for User Story 3
- T023 [P] [US3] In
tests/Nota.SmokeTest/FileBrowseTests.cscheckFileBrowseState: Go pushes Back and clears Forward; Back/Forward move between stacks; stacks capped at 100; Up from a folder → parent; Up from a volume root → Computer; Up at Computer disabled;Volumes()contains/(macOS/Linux) or a ready drive (Windows) - T024 [P] [US3] In
tests/Nota.SmokeTest/FileBrowseTests.cscheckPathInput.Parse:~and~/xexpand to home; a file path → (its folder, the file selected); a trailing separator is ignored; a missing path → error; quoted pasted paths ("…",'…') are unquoted;file://URLs are decoded - T025 [P] [US3] In
tests/Nota.SmokeTest/FileBrowseTests.cscheckBrowserViewModelbrowse listing of a temp folder: folders first then audio/MIDI files, each sorted by name; hidden entries (.x, Windows hidden attribute) and non-audio files skipped; search filters the current folder only
Implementation for User Story 3
- T026 [P] [US3] New
src/managed/Nota.Application/Browser/FileBrowseState.cs:Location(path orComputer),Back/Forwardstacks (cap 100),Go,GoBack,GoForward,Up,CanUp,Segments(for the path bar: volume root first), and staticVolumes()per OS (WindowsDriveInfo.GetDrives()ready; macOS/labelled with the system volume name +/Volumes/*except the symlink to/; Linux/,$HOME,/media/$USER/*,/run/media/$USER/*,/mnt/*) - T027 [P] [US3] New
src/managed/Nota.Application/Browser/PathInput.cs:Parse(string text) → (string Folder, string? SelectFile) | errorper T024 - T028 [US3] In
src/managed/Nota.Presentation/ViewModels/BrowserViewModel.csadd browse mode:BrowseMode(persisted toSettings.FilesBrowseMode),Browse(FileBrowseState, starting atSettings.FilesBrowseFolderif it exists else the default folder, or the folder of the row selected in the tree when switching),BrowseItemscollection built off the UI thread (Kind Folder / Sample / MidiFile,Sampletags from_index.Getwhen indexed),Unreadable/Emptystates, search over the current folder; persistFilesBrowseFolderon navigation (never the Computer level) - T029 [US3] New partial
src/managed/Nota.App/BrowserView.Browse.cs: Tree | Browse segmented toggle under the search box (Files tab only); nav bar with Back/Forward/Up buttons (GlyphKindarrows), path segments as buttons eliding from the left, empty-area click or ⌘L/Ctrl+L → editableTextBox(Enter go viaPathInput, Esc cancel, error → red edge token + status "Can't open {0}"), Copy path button (clipboard + status "Path copied"); Back ⌘[ / Alt+Left, Forward ⌘] / Alt+Right, Up ⌘↑ / Alt+Up when the Files tab has focus; bind the list toBrowseItemsin Browse mode so preview, double-click, drag, sample player reuse the existing paths; folder rows navigate on click/double-click/Enter; empty/unreadable placeholders - T030 [US3] Context menu additions in
src/managed/Nota.App/BrowserView.cs(~line 1667 folder/file menu): Copy path on folders and files (tree and browse), Show in … on browse rows, Add this folder to the browser on browse folders (and on the current folder from the path bar) viaAddSampleFolderwith the same refusal notes - T031 [US3] EN strings in
src/managed/Nota.Application/Localization/en.json:browser.tree,browser.browse,browser.back,browser.forward,browser.up,browser.computer,browser.copy_path,browser.path_copied,browser.cant_open("Can't open {0}"),browser.add_this_folder,browser.folder_empty("This folder has no audio or MIDI files"),browser.folder_unreadable("Nota can't read this folder")
Checkpoint: US3 works alone (quickstart 6); --browser-files passes.
Phase 6: User Story 4 — Locate a clip's file (P2)
Goal: Clips remember their source file across save/reopen; the selected clip's file is highlighted when visible; Locate → In browser / In Finder.
Independent Test: quickstart step 7.
Tests for User Story 4
- T032 [P] [US4] In
tests/Nota.SmokeTest/ClipSourceTests.cs(real engine, like other project tests in Program.cs): add an audio clip from a temp WAV →SampleSource(id)= full path; split the clip → both halves report it; save to a temp bundle, reopen →AudioClipDto.Sourcepresent inproject.jsonandSampleSourcerestored on the reloaded clip; a session audio slot round-trips the same way; loading from<bundle>.nota/samples/x.wavrecords no source; a project withoutSourceloads withSampleSource= ""
Implementation for User Story 4
- T033 [US4] Add
string SampleSource(long sampleId)andvoid SetSampleSource(long sampleId, string path)tosrc/managed/Nota.Application/Engine/IAudioEngine.cs(doc: "full path the sample was loaded from, or ""; managed-only, like SampleName") and implement insrc/managed/Nota.Infrastructure/Interop/NotaEngine.Tracks.cswith_sampleSourcesbeside_sampleNames(line 914); record inline 20),RememberSampleName's callers and inAddAudioClip(AddAudioClipEx(line 996) andline 131–135) by reading the new clip's sample id; skip paths containing asrc/managed/Nota.Infrastructure/Interop/NotaEngine.Session.csAddSessionAudioClip/AddSessionAudioFile(.notadirectory segment followed bysamples; implement in any otherIAudioEngine(grep -rn ": IAudioEngine" src tests) - T034 [US4] Add
public string? Source { get; set; }toAudioClipDtoandAudioTakeDtoinsrc/managed/Nota.Infrastructure/Persistence/ProjectModel.cs(comment: "original file the audio came from (spec 092); optional, absent = unknown"); insrc/managed/Nota.Infrastructure/Persistence/ProjectService.csset it fromengine.SampleSource(sampleId)(null when "") for arrangement clips (line 259), takes (line 272) and session audio slots (~line 303); on load, after each clip/take/slot sample is restored, callengine.SetSampleSource(newSampleId, dto.Source)when non-empty; noCurrentFormatVersionchange - T035 [US4] In
src/managed/Nota.Presentation/ViewModels/BrowserViewModel.csaddSetLocatedPath(string? path): clears the previousLocatedrow and sets it on the matching row in the visible Files list (treeSamplesorBrowseItems); never expands, scrolls or switches tabs; re-applied after rebuilds - T036 [US4] In
src/managed/Nota.App/BrowserView.csrenderLocatedrows with the orange line treatment (2 px left edge,Brush.Accent), distinct from selection; addRevealFile(string path): expand the browser if collapsed, open the Files tab, ifpathis under an available root → Tree mode, expand ancestors, scroll into view, select without auditioning; else → Browse mode at its folder with it selected - T037 [US4] Wire selection in
src/managed/Nota.App/MainWindow.Browser.cs: onTimeline.ClipSelectionChanged(hooked inMainWindow.axaml.cs:215) and on Session slot selection changes (src/managed/Nota.App/SessionView.Grid.cs— add aSlotSelectionChangedevent if none), resolve a single selected audio clip's sample id →engine.SampleSource→Browser.SetLocatedPath, else null - T038 [US4] Add the Locate ▸ submenu (single audio clip only, not in the multi-selection menu) in
src/managed/Nota.App/ArrangementView.LaneControl.cs(clip menu ~line 1030–1090) andsrc/managed/Nota.App/SessionView.Grid.cs(slot menu ~line 898): In browser (enabled when source known andFile.Exists) →LocateInBrowserRequested(path); In Finder / In Explorer / In file manager by OS → reveal source if it exists, else the bundle copy<open project>/samples/<hash>.wav(resolve viaBundleContentfor the clip's sample id) when the project is saved, else disabled; handle both events insrc/managed/Nota.App/MainWindow.Browser.cswithBrowser.RevealFile/RevealInFileManager - T039 [US4] EN strings in
src/managed/Nota.Application/Localization/en.json:clip.locate,clip.locate_in_browser,clip.locate_in_finder,clip.locate_in_explorer,clip.locate_in_file_manager
Checkpoint: US4 works (quickstart 7) incl. after save/reopen; --browser-files passes.
Phase 7: User Story 5 — Projects newest first with details (P2)
Goal: Date sort by default, date/tempo/key/length/tracks per row, open marker, remembered sort.
Independent Test: quickstart step 8.
Tests for User Story 5
- T040 [P] [US5] In
tests/Nota.SmokeTest/ProjectSummaryTests.cswrite temp bundles with hand-madeproject.jsonand checkProjectSummaryReader: bpm and key fromTransport; tracks =Trackscount; length = max end over MIDI clips (StartBeat + LengthBeats), warped audio (WarpPlayEnd - WarpPlayStart, elseWarpBeats), unwarped audio (LengthFramesor the WAV header frames ÷ WAV rate × bpm/60); session slots ignored; corrupt JSON → null summary; the cache returns the stored summary when stamp (manifest ticks + size) matches and re-reads when it changes - T041 [P] [US5] In
tests/Nota.SmokeTest/ProjectSummaryTests.cscheckBrowserViewModel.RebuildProjectsordering: Date (manifest write time, newest first; unreadable date last) and Name (A–Z);IsOpenfollowsOpenProjectPath
Implementation for User Story 5
- T042 [P] [US5] New
src/managed/Nota.Application/Browser/ProjectSummary.cs(record ProjectSummary(double Bpm, string? Key, int TrackCount, double LengthBeats),FormatLength(bpm, beats) → "m:ss") and a sharedProjectDates.Modified(string bundlePath) → DateTime?(manifestproject.jsonwrite time, else bundle dir time) +ProjectDates.Format(DateTime)="MM/dd/yyyy HH:mm"withNotaNum.Culture - T043 [US5] New
src/managed/Nota.Infrastructure/Persistence/ProjectSummaryReader.cs+ cache: readproject.jsonviaJsonDocument(noProjectDocumentbind, no engine) per T040; cache atNOTA_DATA_DIR/cache/project-summaries.jsonkeyed by bundle path with stamp"<manifest ticks>:<size>", prune vanished bundles on write, corrupt cache → rebuilt - T044 [US5] Rework
RebuildProjects()insrc/managed/Nota.Presentation/ViewModels/BrowserViewModel.cs(~line 902):ModifiedfromProjectDates, sort bySettings.ProjectsSort,Sub= formatted date; then a background pass fillsSummary(cache first) and updates rows in place; addOpenProjectPath(marksIsOpen) andProjectsSortsetter (persists, re-sorts); keep the view-side search filter working with the order - T045 [US5] In
src/managed/Nota.App/BrowserView.csProjects rows: name + open marker (accent dot) on line 1; muted second linedate · 124 BPM · Am · 3:42 · 12 tracks(parts absent until known; date only when unreadable);Date | Namesort toggle beside the search when the Projects tab is active; refresh the list when the tab is shown - T046 [US5] In
src/managed/Nota.App/MainWindow.Welcome.cs(~line 87) useProjectDates.Modified/Format; in MainWindow open/save/new paths setBrowserVMOpenProjectPathand callRebuildProjects()after save (grep -n "SaveProject\|OpenProject" src/managed/Nota.App/MainWindow*.cs) - T047 [US5] EN strings in
src/managed/Nota.Application/Localization/en.json:browser.sort_date,browser.sort_name,browser.project_open,browser.project_tracks(plural viaLoc.Plural),browser.bpm
Checkpoint: US5 works alone (quickstart 8).
Phase 8: Polish & Cross-Cutting Concerns
- T048 [P] Shortcuts pane: run the
nota-shortcutsskill for browse Back/Forward/Up and ⌘L/Ctrl+L (Files tab) - T049 [P]
CHANGELOG.md[Unreleased]entries (Added: sample folders, browse mode, Locate, Projects details; Fixed: Files icon size) referencing #268 #346 #579 #580 #581 #582 - T050 [P]
FEATURES.mdvia thenota-featuresskill - T051 User docs via the
nota-docsskill (EN + RU pages for the browser Files/Projects tabs, Settings → Library, clip context menu; re-shoot screenshots) - T052 RU strings for every key added in T020, T031, T039, T047 in
../nota-translations/languages/ru.json(validated once the app PR reaches develop) - T053 Run
/speckit-converge, thenscripts/build.sh(must pass incl. smoke test); walk quickstart.md 1–9 with the headless harness and collect before/after screenshots for the PR (rail, Files tree with two roots, Browse mode, Settings → Library, Locate highlight, Projects tab) in all four themes + classic look where the surface is themed - T054 Re-check the Nota Compliance Checklist in spec.md (SPDX headers on new files, no dependency, no audio-thread code, no ABI change, CHANGELOG/FEATURES/docs done, DESIGN.md followed) and tick it
Dependencies & Execution Order
Phase Dependencies
- Setup (T001–T002) → Foundational (T003–T007) → stories.
- US1 (T008–T020) needs Foundational.
- US2 (T021–T022) needs nothing — can be done first or in parallel with anything.
- US3 (T023–T031) needs Foundational (settings fields) and T014 (
BrowserItemfields) and T017'sAddSampleFolderUI path for T030. - US4 (T032–T039) needs T014 (
Located); T036's "outside every folder → Browse" branch needs US3 (T028/T029) — without it, that branch falls back to In Finder. - US5 (T040–T047) needs Foundational (
ProjectsSort) only. - Polish after all stories.
Within stories
Tests first (they fail until implemented) → Application-layer rules/state → Infrastructure → ViewModel → View → strings.
Parallel Opportunities
- T008–T011 in parallel; T021 any time; T023–T025 and T026–T027 in parallel; T032 alongside T033; T040–T042 in parallel; T048–T050 in parallel.
- US2 and US5 can proceed in parallel with US1 (different files except
BrowserView.cs/BrowserViewModel.cs— serialise edits to those two files).
Parallel Example: User Story 3
T023 FileBrowseState tests ─┐
T024 PathInput tests ─┼─ together
T026 FileBrowseState.cs ─┤
T027 PathInput.cs ─┘
then T028 (VM) → T029 (view) → T030 (menus) → T031 (strings)
Implementation Strategy
- MVP: Setup + Foundational + US1 + US2 (both P1) → shippable on their own (#268, #346, #579).
- Add US5 (independent) → Projects tab.
- Add US3 → browse mode.
- Add US4 last so "In browser" can use browse mode for files outside every folder.
- Polish, converge, build, screenshots → one PR closing all six issues.
Phase 9: Convergence
- T055 Show each sample folder's first-level subfolders as soon as they are listed and fill files in when the walk ends, in
src/managed/Nota.Presentation/ViewModels/BrowserViewModel.cs(RebuildSamplesAsync) per SC-005 (partial) - T056 Open the selected folder with Enter in the Files browse view (and keep Enter on a file a no-op beyond today's behaviour) in
src/managed/Nota.App/BrowserView.Files.csper contracts/ui.md browse rows (partial)
Phase 10: Browse view review (2026-11-12, spec § Clarifications)
- T057 [US3] Add a Home button (new
GlyphKind.Home, 24-grid path) after Up in the nav bar ofsrc/managed/Nota.App/BrowserView.Files.cs, opening the default sample folder throughFileBrowseState.Go(history kept); tooltip with no shortcut; EN stringbrowser.home_tipper FR-013 - T058 [US3] List every non-hidden file in
BrowserViewModel.ListBrowse(src/managed/Nota.Presentation/ViewModels/BrowserViewModel.cs): unsupported files as a newBrowserItemKind.OtherFile; setBrowserItem.Size(bytes) on file rows per FR-012 - T059 [US3] Browse rows in
src/managed/Nota.App/BrowserView.cs: kind icon (Folder / newGlyphKind.Drive/ newGlyphKind.AudioFile/Midi/Doc), extension and size as two right-hand columns (size column fixed width,Locunit strings),OtherFilerows at reduced opacity and excluded from drag, double-click and preview per FR-012a - T060 [US3] Verify the sample player auditions an audio file selected in the browse view (click and arrow keys) and fix whatever stops it, in
src/managed/Nota.App/BrowserView.cs/PreviewPlayer.csper US3 AC12 - T061 [US3] Extend
tests/Nota.SmokeTest/FileBrowseTests.cs: listing includes other files asOtherFilewith sizes, order folders → files by name; FileBrowseState Home; re-shoot browse view in the harness