[chhoumann]

Summary

Adds first-class notes for a whole podcast feed (not just individual episodes), so episodes can link up to a parent note for Obsidian Bases / Dataview rollups.

• New command "Create podcast feed note" — opens a fuzzy picker over your saved podcasts and creates (or opens) that podcast's note. No playback required (addresses FR: Make it easier to create podcast notes #161). The playing episode's feed is pre-selected when there is one.
• Episode right-click menu gains "Create/Open feed note".
• The existing "Create Podcast Note" command (which actually creates an episode note) was renamed to "Create episode note". The command id (create-podcast-note) is unchanged, so existing hotkeys/API keep working.
• Template variables — guiding rule: {{url}}/{{artwork}} always describe the note's own subject (the episode in an episode note, the feed in a feed note). No existing tag changes meaning.
  • Episode notes gain {{episodeurl}}, {{episodeartwork}}, {{feedurl}}, {{feedartwork}}, and {{podcastlink}} (a ready-made wikilink to the feed note).
  • New FeedNoteTemplateEngine exposes {{title}}, {{podcast}}, {{url}} (website), {{feedurl}}, {{artwork}}, {{author}}, {{description}}, {{date}}.
• Feed metadata — PodcastFeed + FeedParser.getFeed now capture the channel description, website link (atom-self/hub-safe), and author; getFeed no longer throws when a feed omits <link>.
• Settings — new feedNote { path, template } with Bases-friendly defaults (addresses FR: Add Obsidian Bases in default note template #160), included in settings import/export.

Closes #163. Relates to #161 and #160.

Implementation notes

• Feed-note creation is race-safe (re-checks existence after on-demand metadata enrichment and treats an "already exists" create as success) and never lets a re-fetched title shift the destination basename.
• The default feed template keeps only YAML-safe values in frontmatter (sanitized {{podcast}} + quoted URL scalars); raw {{title}}/{{author}} live in the note body so arbitrary titles/authors can't produce invalid YAML.
• TemplateEngine.ts changes are additive (new exported engines) to compose cleanly with fix(transcription): always transcribe the currently playing episode #182.

Testing

Ran the CI-equivalent gates locally (Node 22):

• npm run lint ✓
• npm run typecheck ✓
• npm run test ✓ (278 tests, 29 files — includes new unit tests for the feed engines, feed metadata parsing incl. atom hub/alternate, createFeedNote race-safety, settings round-trip, and picker ordering)
• npm run build ✓
• npm run check:a11y ✓ (0 errors, 0 warnings)
• npm run format:check ✓

docs:build requires mkdocs (not installed locally); docs changes are plain markdown additions to commands.md/templates.md.

Runtime verification: ✅ completed in a real Obsidian dev vault — command → fuzzy picker → live on-demand enrichment → Obsidian-parsed (valid Bases YAML) note, plus settings-migration backfill, the no-duplicate guard, and {{podcastlink}} resolution. See the "Runtime verification" comment on this PR for the captured evidence.

Release / migration impact

• Adds one nested setting feedNote { path, template } with shipped defaults; backfills automatically for existing users (no migration needed) and round-trips through settings import/export.
• No existing template tag changes meaning, so existing episode templates are unaffected.

[cloudflare-workers-and-pages]

Deploying podnotes with    Cloudflare Pages

Latest commit:	685ae93
Status:	✅  Deploy successful!
Preview URL:	https://109bcc8e.podnotes.pages.dev
Branch Preview URL:	https://chhoumann-163-podcast-level.podnotes.pages.dev

View logs

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d28628802d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[chhoumann]

Runtime verification ✅ (real Obsidian)

Verified end-to-end in a real Obsidian dev vault (plugin pointed at this branch's build), then restored the vault to its prior state. No console errors.

• Plugin loads cleanly; Create episode note (renamed) and Create podcast feed note (new) are both registered; the existing command id create-podcast-note is unchanged.
• Settings migration: starting from a data.json with no feedNote key, the default feedNote { path, template } backfilled correctly (PodNotes/Podcasts/{{podcast}}.md).
• End-to-end create (real command → fuzzy picker → on-demand enrichment from the live RSS feed → write). Obsidian parsed the resulting frontmatter as valid YAML (the FR: Add Obsidian Bases in default note template #160 Bases goal):

  type: podcast
  podcast: "QA163 Feed Verify"
  image: "https://example.com/qa163.png"
  url: "https://atp.fm/"            # website <link> — atom-self/hub-safe extraction
  feedUrl: "https://cdn.atp.fm/rss/public?wtvryzdm"
  tags:
    - podcast

  Body contained the raw title heading, the live <itunes:author> (Marco Arment, Casey Liss, John Siracusa), artwork, and the live <description>.
• No-duplicate guard: re-running the command on the same feed opened the existing note (still exactly one file, no error).
• {{podcastlink}}: the path-qualified target [[PodNotes/Podcasts/QA163 Feed Verify|QA163 Feed Verify]] resolves to the created file via metadataCache.getFirstLinkpathDest.

Setup: dev vault; commands podnotes:create-podcast-feed-note; feed URL = ATP RSS. Vault state restored afterward.

[github-actions]

🎉 This PR is included in version 2.17.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀