Add ATProto episode publishing with GitHub Actions by Copilot · Pull Request #46 · shipshapecode/starpod

Copilot · 2026-06-06T23:47:34Z

Adds full ATProto integration so podcasts using this template can publish their show and episodes to the federated web via standard.site. Each episode is an individual document record.

Changes

Publishing scripts (`scripts/`)

publish-episodes.ts — Publishes episodes as standard.site documents. Supports incremental (new only, default) and --backfill (all episodes) modes. Uses cursor-based pagination to fetch all existing documents before diffing, avoiding the 100-record ATProto API limit.
create-publication.ts — One-time setup script to create the publication record and output the STANDARD_SITE_PUBLICATION_RKEY.

GitHub Actions

publish-episodes.yml — Runs after the daily "Rebuild Astro Site" workflow completes, publishing any new episodes. Also supports workflow_dispatch.
backfill-episodes.yml — Manual-only workflow (workflow_dispatch with confirmation input) that publishes all existing episodes.

Schema resilience

itunes_episodeType is optional(string()) in the Valibot schema — a missing or unexpected field won't crash unattended CI runs.

npm scripts

"publish:episodes": "tsx scripts/publish-episodes.ts",
"publish:episodes:backfill": "tsx scripts/publish-episodes.ts --backfill"

Required GitHub Actions secrets

Secret	Description
`ATPROTO_HANDLE`	Bluesky handle
`ATPROTO_APP_PASSWORD`	App password
`STANDARD_SITE_URL`	Podcast site URL
`STANDARD_SITE_PUBLICATION_RKEY`	Publication record key
`STANDARD_SITE_DID`	ATProto DID (for verification endpoint)

Documentation

README expanded with full setup guide, env var table, and workflow instructions.
CLAUDE.md updated with new environment variables.

- Install @bryanguffey/astro-standard-site package - Add optional standardSite config to StarpodConfig type - Configure standardSite in starpod.config.ts with placeholder values - Create .well-known/site.standard.publication verification endpoint

vercel · 2026-06-06T23:47:40Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
starpod	Ready	Preview, Comment	Jun 8, 2026 7:08pm

argyleink

@copilot here's a couple comments, tend to them or defend why it's better as is

argyleink · 2026-06-07T00:18:56Z

+   * The publication record key from when you created your publication on ATProto.
+   */


may need better instructions?

Replaced with env vars and added setup instructions in CLAUDE.md under Environment Variables — includes where to find your DID and how to get the publication rkey. Fixed in 51f2d0b.

argyleink · 2026-06-07T00:19:51Z

+  standardSite: {
+    did: 'did:plc:your-did-here',
+    publicationRkey: 'your-publication-rkey-here'
+  }


cant this pull from config, or config pull from this? should only need written once

Moved to environment variables (STANDARD_SITE_DID and STANDARD_SITE_PUBLICATION_RKEY) — matching the existing DISCORD_WEBHOOK pattern. Values are set once in .env, endpoint reads directly from import.meta.env. No more placeholder config in starpod.config.ts. Fixed in 51f2d0b.

….config.ts Moves DID and publication rkey to STANDARD_SITE_DID and STANDARD_SITE_PUBLICATION_RKEY env vars, matching the existing pattern (DISCORD_WEBHOOK). Removes StandardSiteConfig type and placeholder values from starpod.config.ts — values are only written once in .env.

argyleink

@copilot The move to env was good but now there's a lack of documentation to guide someone to use the feature. Where other env vars are described and explained, explain the standard ones and include a link to the standard.site for additional information. In the readme also explain what being a standard publication means and why you'd want to enable it through the config.

Also, does the site work fine without the env vars? The plugin doesn't need put into the Astro config still?

Explains what standard.site federation is, why you'd want it, how to configure the env vars, and links to further resources. Clarifies the feature is optional and the site works fine without it.

Copilot · 2026-06-07T01:10:38Z

@copilot The move to env was good but now there's a lack of documentation to guide someone to use the feature. Where other env vars are described and explained, explain the standard ones and include ...

Added a full "standard.site (ATProto Federation)" section to the README (9291cb1) explaining what it is, why you'd want it, a table with env var descriptions and where to find the values, and a link to the plugin docs.

To your questions: Yes, the site works fine without the env vars — the .well-known endpoint returns a 404 when they're not set. And no, the plugin doesn't need to go into astro.config.mjs — it's only used as a library import in the endpoint file, not as an Astro integration.

…nd backfill

… pagination

…I resilience

RobbieTheWagner · 2026-06-08T18:51:28Z

@copilot This has some linting and type errors. Please fix those.

Copilot · 2026-06-08T18:55:39Z

@copilot This has some linting and type errors. Please fix those.

Fixed in the latest commit — resolved the two type errors (string | undefined not assignable to string in both scripts), removed the unused FeedEpisode interface, and replaced the deprecated agent.api with the direct agent call. Lint and astro check both pass cleanly now.

RobbieTheWagner · 2026-06-08T19:02:32Z

@copilot should we not put the types on these lines instead of casting everything to string later?

Moved the env var declarations inside main() so TypeScript properly narrows them after the guard check — no more as string casts needed. Fixed in the latest commit.

…ring casts

Copilot AI assigned Copilot and argyleink Jun 6, 2026

Copilot AI requested a review from argyleink June 6, 2026 23:47

Copilot finished work on behalf of argyleink June 6, 2026 23:47

Copilot created this pull request from a session on behalf of argyleink June 6, 2026 23:47 View session

vercel Bot deployed to Preview June 6, 2026 23:48 View deployment

argyleink marked this pull request as ready for review June 7, 2026 00:18

argyleink requested changes Jun 7, 2026

View reviewed changes

Copilot started work on behalf of argyleink June 7, 2026 00:20 View session

Copilot finished work on behalf of argyleink June 7, 2026 00:23

Copilot AI requested a review from argyleink June 7, 2026 00:23

vercel Bot deployed to Preview June 7, 2026 00:25 View deployment

argyleink requested changes Jun 7, 2026

View reviewed changes

Copilot started work on behalf of argyleink June 7, 2026 01:08 View session

Add standard.site documentation to README

9291cb1

Explains what standard.site federation is, why you'd want it, how to configure the env vars, and links to further resources. Clarifies the feature is optional and the site works fine without it.

Copilot finished work on behalf of argyleink June 7, 2026 01:10

Copilot AI requested a review from argyleink June 7, 2026 01:10

vercel Bot deployed to Preview June 7, 2026 01:12 View deployment

Copilot started work on behalf of argyleink June 7, 2026 03:42 View session

Copilot finished work on behalf of argyleink June 7, 2026 03:43

Copilot started work on behalf of argyleink June 7, 2026 03:45 View session

Copilot finished work on behalf of argyleink June 7, 2026 03:46

Copilot started work on behalf of argyleink June 7, 2026 04:10 View session

Add ATProto episode publishing with GitHub Actions for auto-publish a…

99b21db

…nd backfill

vercel Bot had a problem deploying to Preview June 7, 2026 04:15 Failure

Add permissions blocks to ATProto publishing workflows

c87dd2a

vercel Bot had a problem deploying to Preview June 7, 2026 04:17 Failure

Copilot AI changed the title ~~Add standard.site support via @bryanguffey/astro-standard-site~~ Add ATProto episode publishing with GitHub Actions Jun 7, 2026

Copilot finished work on behalf of argyleink June 7, 2026 04:17

Copilot started work on behalf of argyleink June 7, 2026 04:20 View session

Fix pagination: fetch all existing ATProto documents via cursor-based…

7f3202b

… pagination

vercel Bot had a problem deploying to Preview June 7, 2026 04:22 Failure

Copilot finished work on behalf of argyleink June 7, 2026 04:22

Copilot started work on behalf of argyleink June 7, 2026 06:07 View session

Make itunes_episodeType optional in publish-episodes FeedSchema for C…

3c188fc

…I resilience

vercel Bot had a problem deploying to Preview June 7, 2026 06:09 Failure

Copilot finished work on behalf of argyleink June 7, 2026 06:09

Copilot started work on behalf of RobbieTheWagner June 8, 2026 18:51 View session

Fix type errors and remove unused interface in publishing scripts

d294735

Copilot AI requested a review from RobbieTheWagner June 8, 2026 18:56

Copilot finished work on behalf of RobbieTheWagner June 8, 2026 18:56

vercel Bot deployed to Preview June 8, 2026 18:57 View deployment

RobbieTheWagner reviewed Jun 8, 2026

View reviewed changes

Copilot started work on behalf of RobbieTheWagner June 8, 2026 19:02 View session

Move env var reads inside main() for proper type narrowing, remove st…

a133f59

…ring casts

Copilot finished work on behalf of RobbieTheWagner June 8, 2026 19:06

Copilot AI requested a review from RobbieTheWagner June 8, 2026 19:06

vercel Bot deployed to Preview June 8, 2026 19:08 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add ATProto episode publishing with GitHub Actions#46

Add ATProto episode publishing with GitHub Actions#46
Copilot wants to merge 9 commits into
mainfrom
copilot/add-standard-site-support

Copilot AI commented Jun 6, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Jun 6, 2026 •

edited

Loading

Uh oh!

argyleink left a comment

Uh oh!

argyleink Jun 7, 2026

Uh oh!

Copilot AI Jun 7, 2026

Uh oh!

argyleink Jun 7, 2026

Uh oh!

Copilot AI Jun 7, 2026

Uh oh!

argyleink left a comment

Uh oh!

Copilot AI commented Jun 7, 2026

Uh oh!

RobbieTheWagner commented Jun 8, 2026

Uh oh!

Copilot AI commented Jun 8, 2026

Uh oh!

RobbieTheWagner Jun 8, 2026

Uh oh!

Copilot AI Jun 8, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		* The publication record key from when you created your publication on ATProto.
		*/

Uh oh!

Conversation

Copilot AI commented Jun 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Publishing scripts (scripts/)

GitHub Actions

Schema resilience

npm scripts

Required GitHub Actions secrets

Documentation

Uh oh!

vercel Bot commented Jun 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

argyleink left a comment

Choose a reason for hiding this comment

Uh oh!

argyleink Jun 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 7, 2026

Choose a reason for hiding this comment

Uh oh!

argyleink Jun 7, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 7, 2026

Choose a reason for hiding this comment

Uh oh!

argyleink left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI commented Jun 7, 2026

Uh oh!

RobbieTheWagner commented Jun 8, 2026

Uh oh!

Copilot AI commented Jun 8, 2026

Uh oh!

RobbieTheWagner Jun 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jun 8, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Jun 6, 2026 •

edited

Loading

Publishing scripts (`scripts/`)

vercel Bot commented Jun 6, 2026 •

edited

Loading