docs: scrub dangling references to deleted roadmap docs

The ROADMAP/ROADMAP-PINCHFLAT docs were removed; this drops the now-dead
"see ROADMAP-PINCHFLAT.md" breadcrumbs (and one "the roadmap" mention)
from source comments, preserving the surrounding Pinchflat-style context.
Comment-only; typecheck (node+web) green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

src/main/core/indexerCore.ts

@@ -1,6 +1,6 @@
 /**
- * Pure, dependency-free core for Source indexing (Pinchflat-style media manager;
- * see ROADMAP-PINCHFLAT.md). Like buildArgs.ts / validation.ts this module imports
+ * Pure, dependency-free core for Source indexing (Pinchflat-style media
+ * manager). Like buildArgs.ts / validation.ts this module imports
  * nothing from electron or the node runtime, so its URL-classification and
  * item-merge logic can be unit-tested without spinning up Electron.
  *
@@ -222,7 +222,7 @@ export function buildMediaItems(
 
 /**
  * Merge a freshly-enumerated item list with the previously-persisted one for the
- * same source (incremental re-index; see ROADMAP-PINCHFLAT.md Phase I). The fresh
+ * same source (incremental re-index). The fresh
  * list defines the current membership/ordering, but any video already marked
  * downloaded keeps its `downloaded`/`downloadedAt`/`filePath` so a re-sync never
  * loses that state or re-downloads it. Videos that vanished from the source (now

src/main/indexer.ts

@@ -1,6 +1,6 @@
 /**
- * Source indexing orchestration (Pinchflat-style media manager; see
- * ROADMAP-PINCHFLAT.md). Walks a channel (its /playlists + /videos tabs) or a
+ * Source indexing orchestration (Pinchflat-style media manager). Walks a
+ * channel (its /playlists + /videos tabs) or a
  * single playlist with `yt-dlp --flat-playlist`, merges the result into a deduped
  * MediaItem list, and persists it as a Source. The download step (Phase G+) then
  * pulls from that persisted list rather than the live queue holding it all.

src/main/ipc.ts

@@ -251,7 +251,7 @@ export function registerIpcHandlers(getMainWindow: () => BrowserWindow | null):
     return result
   })
 
-  // --- Media-manager sources (Pinchflat-style index; see ROADMAP-PINCHFLAT.md) ---
+  // --- Media-manager sources (Pinchflat-style index) ---
   ipcMain.handle(IpcChannels.sourcesList, () => listSources())
   ipcMain.handle(IpcChannels.sourceItems, (_e, sourceId: string) => listMediaItems(sourceId))
   ipcMain.handle(IpcChannels.sourceRemove, (_e, id: string) => removeSource(id))

src/main/schedule.ts

@@ -1,6 +1,6 @@
 /**
- * Windows Task Scheduler integration for the daily watched-source sync
- * (ROADMAP-PINCHFLAT.md Phase J). Registers a task that launches AeroFetch with
+ * Windows Task Scheduler integration for the daily watched-source sync.
+ * Registers a task that launches AeroFetch with
  * `--sync` once a day; the app then runs its startup sync of watched sources.
  *
  * NOTE: this is OS-level wiring and cannot be exercised in the Vite UI preview or

src/main/sources.ts

@@ -1,9 +1,8 @@
 /**
- * Persistence for the media-manager index (Pinchflat-style; see
- * ROADMAP-PINCHFLAT.md). Two plain-JSON stores in userData, mirroring the
- * history.ts pattern (and the same deliberate choice to stay on JSON rather than
- * better-sqlite3 -- revisit if a user indexes many large channels, see the
- * Phase H risk note in the roadmap):
+ * Persistence for the media-manager index (Pinchflat-style). Two plain-JSON
+ * stores in userData, mirroring the history.ts pattern (and the same deliberate
+ * choice to stay on JSON rather than better-sqlite3 -- revisit if a user indexes
+ * many large channels):
  *
  *   sources.json      -- one Source record per added channel/playlist
  *   media-items.json  -- every MediaItem across all sources (queried by sourceId)

src/main/sync.ts

@@ -1,5 +1,5 @@
 /**
- * Watched-source sync (Pinchflat-style; ROADMAP-PINCHFLAT.md Phase J). Re-indexes
+ * Watched-source sync (Pinchflat-style). Re-indexes
  * every watched Source and reports the videos that are new since its last index.
  * A YouTube RSS feed is used as a cheap pre-check so a source with no new uploads
  * is skipped before the (more expensive) full `yt-dlp` re-index.

src/preload/index.ts

@@ -194,7 +194,7 @@ const api = {
     return () => ipcRenderer.removeListener(IpcChannels.externalUrl, listener)
   },
 
-  // --- Media-manager sources (Pinchflat-style; see ROADMAP-PINCHFLAT.md) ---
+  // --- Media-manager sources (Pinchflat-style) ---
 
   listSources: (): Promise<Source[]> => ipcRenderer.invoke(IpcChannels.sourcesList),
 

src/renderer/src/components/SourceRetention.tsx

@@ -42,7 +42,7 @@ const useStyles = makeStyles({
  *     target quality (from its profile or the global default).
  *
  * The policy inputs are ephemeral (per-open) — this is an on-demand tidy, not a
- * persisted schedule, matching the roadmap's "niche for a desktop app" scope.
+ * persisted schedule, keeping retention to a desktop-app-sized scope.
  */
 export function SourceRetention({ sourceId }: { sourceId: string }): React.JSX.Element {
   const styles = useStyles()

src/shared/ipc.ts

@@ -70,7 +70,7 @@ export const IpcChannels = {
   /** main → renderer push channel: a URL handed to AeroFetch from outside the app
    *  (the aerofetch:// protocol, or a .url file via Explorer's "Send to" menu) */
   externalUrl: 'app:external-url',
-  // --- Sources & media-manager indexing (Pinchflat-style, see ROADMAP-PINCHFLAT.md) ---
+  // --- Sources & media-manager indexing (Pinchflat-style) ---
   sourcesList: 'sources:list',
   sourceIndex: 'sources:index',
   sourceReindex: 'sources:reindex',
@@ -433,8 +433,8 @@ export interface ProbeResult {
 }
 
 /**
- * Media-manager folder context for a collection download (see ROADMAP-PINCHFLAT.md
- * Phase G). When present on a StartDownloadOptions, the file is filed into
+ * Media-manager folder context for a collection download. When present on a
+ * StartDownloadOptions, the file is filed into
  * `<outputDir>/<channel>/<playlist>/<NNN> - <title>.<ext>` instead of the flat
  * filenameTemplate. The directory segments are sanitized for Windows at argv-build
  * time, and `index` (the 1-based playlist position from the persisted MediaItem)
@@ -864,7 +864,7 @@ export interface BackupImportResult {
 }
 
 // --- Sources & media-manager indexing (Pinchflat-style) ---------------------
-// See ROADMAP-PINCHFLAT.md. A Source (channel/playlist) is indexed once into a
+// A Source (channel/playlist) is indexed once into a
 // persisted list of MediaItem records. When the user downloads pending items,
 // all selected entries are enqueued at once — add a batch cap here if large
 // channel queues (thousands of items) cause performance issues (M33).