From e29374dcfaf092438e93383d7ee77a26b21160f8 Mon Sep 17 00:00:00 2001 From: debont80 Date: Thu, 2 Jul 2026 23:16:32 -0400 Subject: [PATCH] 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 --- src/main/core/indexerCore.ts | 6 +++--- src/main/indexer.ts | 4 ++-- src/main/ipc.ts | 2 +- src/main/schedule.ts | 4 ++-- src/main/sources.ts | 9 ++++----- src/main/sync.ts | 2 +- src/preload/index.ts | 2 +- src/renderer/src/components/SourceRetention.tsx | 2 +- src/shared/ipc.ts | 8 ++++---- 9 files changed, 19 insertions(+), 20 deletions(-) diff --git a/src/main/core/indexerCore.ts b/src/main/core/indexerCore.ts index d82ba34..8864045 100644 --- a/src/main/core/indexerCore.ts +++ b/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 diff --git a/src/main/indexer.ts b/src/main/indexer.ts index ff18ff6..2295b60 100644 --- a/src/main/indexer.ts +++ b/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. diff --git a/src/main/ipc.ts b/src/main/ipc.ts index 8ff528d..2d69f2d 100644 --- a/src/main/ipc.ts +++ b/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)) diff --git a/src/main/schedule.ts b/src/main/schedule.ts index 645b69b..454fbd3 100644 --- a/src/main/schedule.ts +++ b/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 diff --git a/src/main/sources.ts b/src/main/sources.ts index 9477a77..183a2b8 100644 --- a/src/main/sources.ts +++ b/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) diff --git a/src/main/sync.ts b/src/main/sync.ts index 8744452..b8fc580 100644 --- a/src/main/sync.ts +++ b/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. diff --git a/src/preload/index.ts b/src/preload/index.ts index 882db28..b3fe665 100644 --- a/src/preload/index.ts +++ b/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 => ipcRenderer.invoke(IpcChannels.sourcesList), diff --git a/src/renderer/src/components/SourceRetention.tsx b/src/renderer/src/components/SourceRetention.tsx index a287641..ac0c670 100644 --- a/src/renderer/src/components/SourceRetention.tsx +++ b/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() diff --git a/src/shared/ipc.ts b/src/shared/ipc.ts index a7d87cf..f5f2678 100644 --- a/src/shared/ipc.ts +++ b/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 * `/// - .<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).