Update OpenWiki for source ingest

openwiki/workflows/product-workflows.md

@@ -20,7 +20,7 @@ Change guidance:
 
 Primary sources: `/Marks/Views/AddBookmarkView.swift`, `/Marks/Views/EditBookmarkView.swift`, `/Marks/Views/BookmarksViewModel.swift`, `/Marks/Models/Bookmark.swift`.
 
-The Add view collects URL, optional title, and comma-separated tags, normalizes/validates the URL, and calls `BookmarksViewModel.addBookmark(url:title:tags:)`. Added bookmarks are inserted locally, indexed into Spotlight, and enriched in a background task.
+The Add view collects URL, optional title, description/notes, and comma-separated tags, normalizes/validates the URL, and calls `BookmarksViewModel.addBookmark(url:title:description:tags:)`. It also has a paste/import text path that uses `IngestPayloadParser` to extract the first `http`/`https` URL from plain text and preserve surrounding notes as the bookmark description. Added bookmarks are inserted locally, indexed into Spotlight, and enriched in a background task.
 
 The Edit view updates URL, title, description, tags, unread, and shared state through `BookmarkUpdate`. `BookmarksViewModel.updateBookmark(_:)` preserves locally stored AI summary/tags when replacing the bookmark returned from linkding.
 
@@ -80,9 +80,9 @@ Change guidance:
 
 ## Share extension save flow
 
-Primary sources: `/ShareExtension/ShareViewController.swift`, `/ShareExtension/ShareView.swift`, `/ShareExtension/TagSuggester.swift`, `/Marks/Services/PodcastRequests.swift`, `/project.yml`.
+Primary sources: `/Marks/Models/IngestPayload.swift`, `/ShareExtension/ShareViewController.swift`, `/ShareExtension/ShareView.swift`, `/ShareExtension/TagSuggester.swift`, `/Marks/Services/PodcastRequests.swift`, `/project.yml`.
 
-The share extension extracts a URL/text payload and shows an interactive save card. On load it:
+The share extension scans URL, HTML, RTF, plain-text, and text attachments, then `IngestPayloadParser` extracts the first bookmarkable web URL. For non-URL text payloads it also preserves cleaned surrounding text as notes. On load it:
 
 1. reads linkding config from app-group defaults,
 2. calls `LinkdingAPI.checkBookmark(url:)`,
@@ -96,13 +96,35 @@ Change guidance:
 
 - The extension is short-lived. Keep long-running work in the main app.
 - The extension depends on shared source files listed in `/project.yml`; adding service dependencies may require target membership updates.
+- `IngestPayloadParser` intentionally ignores non-HTTP(S) URLs and caps preserved notes at 1,800 characters.
 - `ShareExtension/Info.plist` currently uses a broad activation rule. Narrowing supported payloads is a product decision.
 
+## Sources
+
+Primary sources: `/Marks/Views/SourcesView.swift`, `/Marks/Models/IngestedSource.swift`, `/Marks/Services/IngestedSourceStore.swift`, `/Marks/Services/SourceSpotlightIndexer.swift`.
+
+The Sources tab stores non-web material in Marks. Users can:
+
+- import typed/pasted text with an optional title and tags,
+- import PDFs, plain text files, generic text/data files through the document picker,
+- search across source title, body text, tags, and original filename,
+- open imported originals through QuickLook,
+- delete sources and copied files,
+- create or play a podcast from extractable source text.
+
+`IngestedSourceLibrary.load()` reads `Sources/sources.json` from Application Support and indexes sources into Spotlight. Text imports write metadata/body text directly. File imports copy the selected security-scoped file into `Sources/files/`; PDFs extract text with PDFKit, while other files attempt UTF-8/ASCII extraction.
+
+Change guidance:
+
+- Empty or image-only PDFs may import with no extractable text; podcast actions are disabled when `podcastText` is empty.
+- Source podcasts use `marks-source://{uuid}` as the cache/index URL and send extracted text plus `source_kind` to the backend.
+- If changing source storage, update deletion, Spotlight removal, QuickLook file lookup, and source podcast cache behavior together.
+
 ## Podcasts
 
 Primary sources: `/Marks/Views/PodcastPlayerView.swift`, `/Marks/Services/PodcastGenerationManager.swift`, `/Marks/Services/PodcastIndex.swift`, `/Marks/Services/PodcastLibrary.swift`, `/Marks/Services/ClaudeService.swift`, `/Marks/Services/PodcastRequests.swift`, `/Marks/Info.plist`.
 
-Podcast generation converts an article URL into audio through the Marks backend:
+Podcast generation converts an article URL, or a locally ingested source with extracted text, into audio through the Marks backend:
 
 1. create generation job (`/v1/podcast/generate`),
 2. poll status every few seconds,
@@ -112,7 +134,7 @@ Podcast generation converts an article URL into audio through the Marks backend:
 6. reload `PodcastLibrary`,
 7. write recent podcast metadata for widgets.
 
-`BookmarksViewModel.playOrGeneratePodcast(...)` prevents interrupting current playback. If the player is idle, it starts foreground generation/playback and callers present the player. If busy, it enqueues background generation through `PodcastGenerationManager`.
+`BookmarksViewModel.playOrGeneratePodcast(...)` prevents interrupting current bookmark playback. If the player is idle, it starts foreground generation/playback and callers present the player. If busy, it enqueues background generation through `PodcastGenerationManager`. `SourcesView` follows the same foreground/background pattern for local sources, using `marks-source://{uuid}` plus `sourceText`/`sourceKind`.
 
 The player uses AVFoundation/MediaPlayer for playback, background audio, progress, saved playback speed, restored paused session, queue playback, now-playing metadata, remote controls, sleep timer, and played/unplayed state.
 
@@ -121,6 +143,7 @@ Change guidance:
 - The main app plist enables background audio and the custom `marks` URL scheme.
 - Widget podcast metadata is in the app group, but audio files and `PodcastIndex` are in the main app's Application Support directory.
 - Share-extension queued podcast requests are drained by `BookmarksViewModel.processPendingPodcastRequests()` on launch/foreground. Consider retry semantics before changing drain behavior.
+- Source-backed podcast generation depends on backend support for the optional `text` and `source_kind` fields in `POST /v1/podcast/generate`.
 
 ## Widgets and deep links