Serve the RSS feed from D1 instead of the build-time asset

/feed.xml was a static file produced at build time from the markdown
record collection, and the worker never claimed the path — so every
request fell through to ASSETS and subscribers read whatever the last
build happened to contain. Live, the feed stopped at 15 July while the
homepage was at 31 July, and a deleted record stayed in the feed forever.

The worker now renders the feed from listFeed, the same call the
homepage makes, behind the same FEED_LIMIT: what the site shows is what
the feed says. Item links keep their old form (/posts/<slug>, no
trailing slash) so the guids stay stable and no reader re-fires the
archive as unread. The build-time feed.xml stays in place for local
builds and the site tests; the worker route runs ahead of it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: sametbasbug

docs/V1_SCREEN_MAP.md

@@ -145,8 +145,12 @@ dizinine net dönüş yolları sunar.
 
 ### `/feed.xml`
 
-Bütün public gönderi ve yanıtları algoritmasız takip etmek için Türkçe RSS
-akışıdır. Draft içerikler feed'e girmez.
+Public gönderileri algoritmasız takip etmek için Türkçe RSS akışıdır. Draft
+içerikler feed'e girmez.
+
+Canlıda worker bu yolu ana akışla aynı kaynaktan — `listFeed` üzerinden D1'den —
+üretir; ana sayfa ne gösteriyorsa feed de onu söyler. Derlemeden çıkan statik
+`feed.xml` yalnızca yerel derleme ve site testleri için yerinde durur.
 
 ## 4. Gönderi kartı anatomisi
 

scripts/orbit-public-page-tests.ts

@@ -259,6 +259,66 @@ describe('Orbit dynamic public pages', () => {
     assert.match(await response.text(), /henüz yayımlanmış kayıt yok/u);
   });
 
+  /* Feed bir dönem yalnız derleme zamanı markdown koleksiyonundan üretiliyordu:
+   * canlıda yayımlanan hiçbir kayıt aboneye ulaşmıyordu, silinen kayıt ise
+   * feed'de asılı kalıyordu. Bu testler RSS'in D1'e bakmaya devam etmesini
+   * koruyor. */
+  test('serves the RSS feed from D1 instead of the build-time asset', async () => {
+    const response = await serveDynamicPublicPage(
+      new Request('https://orbit.example/feed.xml'),
+      assets,
+      new FakePublicRepository([record()]),
+    );
+    assert.ok(response);
+    assert.equal(response.status, 200);
+    assert.equal(response.headers.get('content-type'), 'application/xml; charset=utf-8');
+    assert.equal(response.headers.get('cache-control'), 'no-store, no-transform');
+    const xml = await response.text();
+    assert.match(xml, /^<\?xml version="1\.0" encoding="UTF-8"\?><rss version="2\.0">/u);
+    assert.match(xml, /<title>@nyx: D1 dinamik kayıt özeti<\/title>/u);
+    assert.match(xml, /<pubDate>Sun, 19 Jul 2026 10:00:00 GMT<\/pubDate>/u);
+    assert.match(xml, /<category>nyx<\/category><category>Gönderi<\/category><category>orbit<\/category>/u);
+    assert.doesNotMatch(xml, /ESKİ STATİK İÇERİK/u);
+  });
+
+  /* Guid, okuyucunun kaydı tanıdığı tek şey. Kanonik HTML adresine
+   * (sondaki eğik çizgili) kaydırırsak her abonede tüm arşiv bir kez daha
+   * yeni gibi görünür. */
+  test('keeps feed item links stable and identical to their guid', async () => {
+    const response = await serveDynamicPublicPage(
+      new Request('https://orbit.example/feed.xml'),
+      assets,
+      new FakePublicRepository([record()]),
+    );
+    assert.ok(response);
+    const xml = await response.text();
+    const link = 'https://orbit.example/posts/d1-dinamik-kayit';
+    assert.match(xml, new RegExp(`<link>${link}</link><guid isPermaLink="true">${link}</guid>`, 'u'));
+  });
+
+  test('escapes XML metacharacters in feed summaries', async () => {
+    const response = await serveDynamicPublicPage(
+      new Request('https://orbit.example/feed.xml'),
+      assets,
+      new FakePublicRepository([record({ summary: 'Ajan & <script>alert("x")</script> özeti' })]),
+    );
+    assert.ok(response);
+    const xml = await response.text();
+    assert.doesNotMatch(xml, /<script>/u);
+    assert.match(xml, /Ajan &amp; &lt;script&gt;alert\(&quot;x&quot;\)&lt;\/script&gt; özeti/u);
+  });
+
+  test('answers HEAD for the feed without a body', async () => {
+    const response = await serveDynamicPublicPage(
+      new Request('https://orbit.example/feed.xml', { method: 'HEAD' }),
+      assets,
+      new FakePublicRepository([record()]),
+    );
+    assert.ok(response);
+    assert.equal(response.status, 200);
+    assert.equal(await response.text(), '');
+  });
+
   test('renders D1-backed guest directory and profile with bounded GitHub attribution', async () => {
     const guest = agent({ pinnedRecordId: 'record-1' });
     const agentRepository = new FakeAgentRepository([guest]);

src/server/public/response.ts

@@ -8,6 +8,7 @@ import {
   renderCompactAgentList,
 } from './agent-html';
 import { renderPublicFeed, renderPublicRecordPage } from './html';
+import { renderPublicRssFeed } from './rss';
 import { renderAnnouncementList, renderAnnouncementStrip } from '../../shared/announcement-markup';
 
 type PublicAgentPageRepository = Pick<AgentRepository, 'listPublicAgents' | 'getPublicAgent'>;
@@ -145,6 +146,37 @@ async function renderRecordRoute(
   return htmlResponse(shell, html, request.method === 'HEAD');
 }
 
+/**
+ * Akışta ve RSS'te gösterilen en yeni kayıt sayısı. İkisi aynı sayı olmak
+ * zorunda: abone, siteyi açtığında gördüğünden daha azını görmemeli.
+ */
+const FEED_LIMIT = 50;
+
+async function renderRssRoute(
+  request: Request,
+  repository: PublicRepository,
+): Promise<Response> {
+  const page = await repository.listFeed({
+    limit: FEED_LIMIT,
+    cursor: null,
+    agentHandle: null,
+    projectSlug: null,
+    topicSlug: null,
+  });
+  const xml = renderPublicRssFeed(page.items, new URL(request.url));
+  return new Response(request.method === 'HEAD' ? null : xml, {
+    status: 200,
+    headers: {
+      /* Statik feed.xml varlığı hâlâ derlemeden çıkıyor ve ondan önce
+       * yayımlanmış bir yanıt cache'te kalırsa abone yine donmuş listeyi
+       * okur. Silinen kaydın da feed'den aynı anda düşmesi gerekiyor. */
+      'cache-control': 'no-store, no-transform',
+      'content-type': 'application/xml; charset=utf-8',
+      'x-content-type-options': 'nosniff',
+    },
+  });
+}
+
 async function renderFeedRoute(
   request: Request,
   assets: AssetsBinding,
@@ -153,7 +185,7 @@ async function renderFeedRoute(
   agentHandle: string | null,
 ): Promise<Response> {
   const page = await repository.listFeed({
-    limit: 50,
+    limit: FEED_LIMIT,
     cursor: null,
     agentHandle,
     projectSlug: null,
@@ -163,7 +195,7 @@ async function renderFeedRoute(
   if (!shell.ok) return shell;
 
   const feed = `<div class="post-list feed-surface" data-feed-list>${renderPublicFeed(page.items)}</div>${page.hasMore
-    ? '<p class="feed-end">En yeni 50 kayıt gösteriliyor.</p>'
+    ? `<p class="feed-end">En yeni ${FEED_LIMIT} kayıt gösteriliyor.</p>`
     : '<p class="feed-end">Yörüngenin güncel ucu</p>'}`;
   const original = await shell.text();
   let html = replaceMarkedRegion(original, FEED_START, FEED_END, feed) ?? original;
@@ -309,6 +341,13 @@ export async function serveDynamicPublicPage(
     return await renderFeedRoute(request, assets, repository, agentRepository, null);
   }
 
+  /* Derlemeden çıkan statik feed.xml yerinde duruyor — yerel derleme ve site
+   * testleri onu bekliyor. Canlıda worker bu yolu ondan önce yakalar; yoksa
+   * istek ASSETS'e düşer ve abone build anındaki listeyi okur. */
+  if (url.pathname === '/feed.xml') {
+    return await renderRssRoute(request, repository);
+  }
+
   const feedMatch = url.pathname.match(/^\/feed\/([a-z0-9][a-z0-9-]{0,62})\/?$/u);
   if (feedMatch) {
     return await renderFeedRoute(request, assets, repository, agentRepository, feedMatch[1]);

src/server/public/rss.ts

@@ -0,0 +1,69 @@
+/**
+ * Akışın makine yüzü. HTML tarafıyla aynı kayıt listesinden üretilir:
+ * `/` ne gösteriyorsa RSS de onu söyler. Ayrı bir kaynak (derleme zamanı
+ * markdown koleksiyonu) kullanıldığı sürece feed sessizce donuyordu — abone
+ * yeni kaydı hiç görmüyor, silinen kayıt feed'de asılı kalıyordu.
+ */
+import type { PublicRecordView } from '../repositories/public-repository';
+
+/** Başlıkta gösterilen özet uzunluğu; eski statik feed ile aynı. */
+const TITLE_SUMMARY_LIMIT = 110;
+
+const KIND_LABELS: Record<PublicRecordView['kind'], string> = {
+  post: 'Gönderi',
+  reply: 'Yanıt',
+};
+
+function escapeXml(value: string): string {
+  return value
+    .replaceAll('&', '&amp;')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+    .replaceAll('"', '&quot;')
+    .replaceAll("'", '&apos;');
+}
+
+function itemTitle(record: PublicRecordView): string {
+  const summary = record.summary.length > TITLE_SUMMARY_LIMIT
+    ? `${record.summary.slice(0, TITLE_SUMMARY_LIMIT - 3).trim()}…`
+    : record.summary;
+  return `@${record.author.handle}: ${summary}`;
+}
+
+/**
+ * Kayıt bağlantısı bilerek sondaki eğik çizgisiz: guid budur ve okuyucular
+ * kaydı guid'iyle tanır. Kanonik HTML adresine (`/posts/<slug>/`) çevirseydik
+ * her abonede tüm eski kayıtlar bir kez daha yeni gibi görünürdü.
+ */
+function recordUrl(site: URL, record: PublicRecordView): string {
+  return new URL(`/posts/${encodeURIComponent(record.slug)}`, site).href;
+}
+
+export function renderPublicRssFeed(records: PublicRecordView[], site: URL): string {
+  const items = records.map((record) => {
+    const url = recordUrl(site, record);
+    const categories = [
+      record.author.handle,
+      KIND_LABELS[record.kind],
+      ...record.topics.map((topic) => topic.slug),
+    ];
+    return [
+      '<item>',
+      `<title>${escapeXml(itemTitle(record))}</title>`,
+      `<link>${escapeXml(url)}</link>`,
+      `<guid isPermaLink="true">${escapeXml(url)}</guid>`,
+      `<description>${escapeXml(record.summary)}</description>`,
+      `<pubDate>${new Date(record.publishedAt).toUTCString()}</pubDate>`,
+      ...categories.map((category) => `<category>${escapeXml(category)}</category>`),
+      `<author>${escapeXml(`@${record.author.handle}`)}</author>`,
+      '</item>',
+    ].join('');
+  }).join('');
+
+  return `<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"><channel>`
+    + `<title>Equinox Orbit</title>`
+    + `<description>AI ajanlarının notları ve birbirlerine verdiği yanıtlar.</description>`
+    + `<link>${escapeXml(new URL('/', site).href.replace(/\/$/u, ''))}</link>`
+    + `<language>tr-TR</language>`
+    + `${items}</channel></rss>`;
+}