diff --git a/apps/site/src/pages/podcasts/llms.txt.ts b/apps/site/src/pages/podcasts/llms.txt.ts
new file mode 100644
index 000000000..d7175c1bb
--- /dev/null
+++ b/apps/site/src/pages/podcasts/llms.txt.ts
@@ -0,0 +1,64 @@
+import type { APIRoute } from "astro";
+import { defineQuery } from "groq";
+
+export const prerender = false;
+
+const podcastsLlmsQuery = defineQuery(`
+ *[_type == "podcast" && defined(slug.current)] | order(coalesce(date, _createdAt) desc) [0...100] {
+ "title": coalesce(title, "Untitled"),
+ "slug": slug.current,
+ excerpt,
+ season,
+ episode,
+ "date": coalesce(date, _createdAt),
+ "guests": guest[]->title
+ }
+`);
+
+export const GET: APIRoute = async ({ locals }) => {
+ const origin = locals.siteUrl.origin;
+
+ let episodes: Array<{
+ title: string;
+ slug: string;
+ excerpt?: string | null;
+ season?: number | null;
+ episode?: number | null;
+ date?: string | null;
+ guests?: Array
| null;
+ }> = [];
+
+ try {
+ episodes = (await locals.sanity.fetchPublished(podcastsLlmsQuery)) ?? [];
+ } catch (err) {
+ console.warn("Failed to fetch podcasts for /podcasts/llms.txt:", err);
+ }
+
+ let content = `# CodingCat.dev Podcasts — Episodes, Interviews & Transcripts
+
+> Scoped LLM directory of CodingCat.dev podcast episodes and engineering interviews. Each episode page includes full show notes and transcripts when requested as Markdown via \`/index.md\`, \`.md\`, or \`Accept: text/markdown\`. For the site-wide index see ${origin}/llms.txt.
+
+## Podcast Episodes
+`;
+
+ for (const ep of episodes) {
+ const url = `${origin}/podcast/${ep.slug}/index.md`;
+ const guestList = (ep.guests ?? []).filter(Boolean);
+ const guestSuffix =
+ guestList.length > 0 ? ` (with ${guestList.join(", ")})` : "";
+ const desc = ep.excerpt
+ ? `: ${ep.excerpt.replace(/\s+/g, " ").trim()}`
+ : "";
+ content += `- [${ep.title}${guestSuffix}](${url})${desc}\n`;
+ }
+
+ return new Response(content, {
+ headers: {
+ "content-type": "text/plain; charset=utf-8",
+ "cache-control": "public, max-age=3600, s-maxage=86400",
+ "access-control-allow-origin": "*",
+ Vary: "Accept",
+ Link: `<${origin}/llms.txt>; rel="up", <${origin}/podcasts/rss.xml>; rel="alternate"; type="application/rss+xml"`,
+ },
+ });
+};
diff --git a/apps/site/src/pages/post/[slug].astro b/apps/site/src/pages/post/[slug].astro
index 92c297c60..2a7dbcbae 100644
--- a/apps/site/src/pages/post/[slug].astro
+++ b/apps/site/src/pages/post/[slug].astro
@@ -37,6 +37,8 @@ const path = `/post/${slug}`;
const origin = Astro.locals.siteUrl.origin;
const ogImage = sanity.resolveOpenGraphImage(post.coverImage ?? undefined);
const authors = post.author ?? [];
+const transcriptText =
+ post.transcript?.fullText || post.transcript?.summary || undefined;
const videoSchema = post.youtube
? videoObjectSchema(
origin,
@@ -47,6 +49,7 @@ const videoSchema = post.youtube
thumbnailUrl: ogImage?.url,
youtubeUrl: post.youtube,
durationSeconds: post.transcript?.durationSeconds,
+ transcript: transcriptText,
},
path,
)
@@ -138,6 +141,17 @@ const faqNode = faqSchema(extractFaqsFromPortableText(post.content));
}
+
+ {
+ post.transcript?.summary && (
+
+ Video Summary
+
+ {post.transcript.summary}
+
+
+ )
+ }
{
diff --git a/apps/site/tests/tier1-features.test.mjs b/apps/site/tests/tier1-features.test.mjs
index 4815ed199..7c03d9e66 100644
--- a/apps/site/tests/tier1-features.test.mjs
+++ b/apps/site/tests/tier1-features.test.mjs
@@ -1098,7 +1098,7 @@ describe("Tier 1 - Feature Coverage", () => {
const res = await prmModule.GET({ locals });
assert.equal(res.status, 200);
const data = await res.json();
- assert.equal(data.resource, "https://codingcat.dev/mcp");
+ assert.equal(data.resource, "https://codingcat.dev");
assert.deepEqual(data.authorization_servers, ["https://codingcat.dev"]);
assert.ok(Array.isArray(data.scopes_supported));
assert.deepEqual(data.bearer_methods_supported, ["header"]);
@@ -1671,5 +1671,97 @@ describe("Tier 1 - Feature Coverage", () => {
assert.ok(tokenData.access_token, "Must return access_token");
assert.ok(tokenData.refresh_token, "Must return refresh_token");
});
+
+ it("7.19 Web Bot Auth JWKS directory, scoped /blog/llms.txt & /podcasts/llms.txt, and clean HTML-to-Markdown stripping", async () => {
+ // 1. Web Bot Auth JWKS directory
+ const webBotAuthModule = loadModule(
+ "src/pages/.well-known/http-message-signatures-directory.ts",
+ );
+ const wbaReq = new Request(
+ "https://codingcat.dev/.well-known/http-message-signatures-directory",
+ );
+ const wbaRes = await webBotAuthModule.GET({ request: wbaReq, locals });
+ assert.equal(wbaRes.status, 200);
+ assert.ok(
+ wbaRes.headers
+ .get("content-type")
+ ?.includes("application/http-message-signatures-directory+json"),
+ );
+ const wbaData = await wbaRes.json();
+ assert.ok(
+ Array.isArray(wbaData.keys) && wbaData.keys.length >= 1,
+ "Must contain at least one public verification key",
+ );
+ assert.equal(wbaData.keys[0].kty, "OKP");
+ assert.equal(wbaData.keys[0].crv, "Ed25519");
+
+ // 2. Scoped /blog/llms.txt and /podcasts/llms.txt
+ const blogLlmsModule = loadModule("src/pages/blog/llms.txt.ts");
+ const podcastsLlmsModule = loadModule("src/pages/podcasts/llms.txt.ts");
+ const mockSanityLocals = {
+ ...locals,
+ sanity: {
+ async fetchPublished() {
+ return [
+ {
+ title: "Test Entry",
+ slug: "test-entry",
+ excerpt: "High value description for AI context window",
+ guests: ["Alex Patterson"],
+ },
+ ];
+ },
+ },
+ };
+
+ const blogRes = await blogLlmsModule.GET({ locals: mockSanityLocals });
+ assert.equal(blogRes.status, 200);
+ const blogText = await blogRes.text();
+ assert.ok(blogText.includes("# CodingCat.dev Blog"));
+ assert.ok(
+ blogText.includes("https://codingcat.dev/post/test-entry/index.md"),
+ );
+
+ const podcastRes = await podcastsLlmsModule.GET({
+ locals: mockSanityLocals,
+ });
+ assert.equal(podcastRes.status, 200);
+ const podcastText = await podcastRes.text();
+ assert.ok(podcastText.includes("# CodingCat.dev Podcasts"));
+ assert.ok(
+ podcastText.includes(
+ "https://codingcat.dev/podcast/test-entry/index.md",
+ ),
+ );
+
+ // 3. htmlToMarkdown strips client-only interactive transcript modal chrome
+ const { htmlToMarkdown } = loadModule("src/lib/html-to-markdown.ts");
+ const sampleHtml = `
+
+
+ Sample Episode
+
+ Real episode content.
+
+
+ `;
+ const md = htmlToMarkdown(
+ sampleHtml,
+ "https://codingcat.dev/podcast/sample",
+ );
+ assert.ok(md.includes("Real episode content."));
+ assert.ok(
+ !md.includes("Fetching transcript from YouTube"),
+ "Must strip client-only modal loading skeleton from Markdown",
+ );
+ });
});
});