feedkeeper 0.26.1 → 0.26.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feedkeeper",
-  "version": "0.26.1",
+  "version": "0.26.3",
   "description": "A lightweight, self-hosted RSS reader and remote MCP server for your news, blogs, and AI workflows.",
   "keywords": [
     "rss",

package/server/dist/api/items.js

@@ -46,7 +46,7 @@ itemsRouter.get("/", (req, res) => {
     const archived = withArchivedImages(listItemsForUser(req.user.id, parsed.data), origin);
     // Offline copies also get the images of articles that are not archived, through this server.
     const items = parsed.data.offline ? withProxiedImages(archived, origin) : archived;
-    res.json(items.map((item) => ({
+    res.json(items.map(({ content_lead: _lead, lead_version: _leadVersion, ...item }) => ({
         ...item,
         content_snippet: cleanSnippet(item.content_snippet, item.title),
         content_html: readerHtml(item.content_html, item.title),

package/server/dist/api/v1/index.js

@@ -34,7 +34,6 @@ const FEATURES = [
     "folder-icons",
     "notes",
     "edition",
-    "edition.automatic",
     "edition.revisions",
     "native-preferences",
     "native-preferences.edition-size",

package/server/dist/api/v1/resources.js

@@ -18,7 +18,7 @@ import { SsrfBlockedError, normalizeUrlCandidate } from "../../feeds/ssrfGuard.j
 import { buildOverview } from "../../mcp/digest.js";
 import { decodeCursor, encodeCursor } from "../../mcp/items.js";
 import { readingPositions, serializeItem, serializeSubscriptionDetail } from "./serialize.js";
-import { dismissEdition, editionCandidates, generateEdition, generateEditionSchema, getEdition, getEditionState } from "../../native/editions.js";
+import { dismissEdition, editionCandidates, ensureEditionSchema, getEdition, getEditionState } from "../../native/editions.js";
 import { getNativePreferences, patchNativePreferences } from "../../native/preferences.js";
 import { NativeError } from "../../native/requests.js";
 import { capabilityDenial, hasUserCapability, requireCapability } from "../../auth/capabilities.js";
@@ -520,7 +520,7 @@ function editionResponse(req, edition) {
         .filter((row) => Boolean(row));
     const progress = readingPositions(req.user.id, rows.map((r) => r.id));
     const hasNotes = itemsWithNotes(req.user.id, rows.map((r) => r.id));
-    const prepared = prepare(rows, req, "original");
+    const prepared = prepare(rows, req, req.query.images === "proxy" ? "proxy" : "original");
     return {
         ...edition,
         items: prepared.map((row) => serializeItem(row, progress, false, hasNotes.has(row.id))),
@@ -563,14 +563,19 @@ resourcesRouter.get("/edition/candidates", requireCapability("editions"), (req,
     res.setHeader("Cache-Control", "private, no-store");
     res.json({ preferences: getNativePreferences(req.user.id), current: getEditionState(req.user.id), candidates: editionCandidates(req.user.id, new Date(), parsed.data.limit) });
 });
+// Older clients may still ensure an edition before reading. Keep that request read-only.
 resourcesRouter.post("/edition/generate", requireCapability("editions"), (req, res) => {
-    const parsed = generateEditionSchema.safeParse(req.body);
+    const parsed = ensureEditionSchema.safeParse(req.body);
     if (!parsed.success)
         return invalid(res, parsed.error.flatten());
     nativeAction(res, () => {
-        const edition = generateEdition(req.user.id, parsed.data);
+        const current = getEditionState(req.user.id);
+        if (parsed.data.expectedRevision !== undefined && parsed.data.expectedRevision !== current.revision) {
+            throw new NativeError("revision_conflict", 409, current);
+        }
+        const edition = getEdition(req.user.id);
         if (!edition)
-            return void res.status(404).json({ error: "no_edition", current: getEditionState(req.user.id) });
+            return void res.status(404).json({ error: "no_edition", current });
         res.json(editionResponse(req, edition));
     });
 });

package/server/dist/db/migrations/0036_curated_only_editions.sql

@@ -0,0 +1,5 @@
+-- Retire legacy automatic slots without dismissing the current curation period.
+-- Keep the revision watermark so a late publication cannot silently overwrite newer state.
+UPDATE editions SET status = 'expired', revision = revision + 1,
+  updated_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+WHERE source = 'automatic' AND status = 'active';

package/server/dist/feeds/cleanup.js

@@ -92,7 +92,7 @@ export function runCleanup(custom) {
            AND i.id NOT IN (SELECT item_id FROM item_notes)
            AND i.feed_id NOT IN (SELECT id FROM feeds WHERE is_system_inbox = 1)
            AND NOT EXISTS (SELECT 1 FROM editions e, json_each(e.item_ids) selected
-             WHERE selected.value = i.id AND e.status = 'active' AND julianday(e.expires_at) > julianday('now'))
+             WHERE selected.value = i.id AND e.source = 'curated' AND e.status <> 'dismissed')
            AND i.id IN (SELECT item_id FROM item_reads)
            AND NOT EXISTS (
              SELECT 1 FROM subscriptions s
@@ -110,7 +110,7 @@ export function runCleanup(custom) {
          AND id NOT IN (SELECT item_id FROM item_notes)
          AND feed_id NOT IN (SELECT id FROM feeds WHERE is_system_inbox = 1)
          AND NOT EXISTS (SELECT 1 FROM editions e, json_each(e.item_ids) selected
-           WHERE selected.value = items.id AND e.status = 'active' AND julianday(e.expires_at) > julianday('now'))
+           WHERE selected.value = items.id AND e.source = 'curated' AND e.status <> 'dismissed')
          AND COALESCE(julianday(published_at), julianday(created_at)) <= julianday('now', '-' || ? || ' days')`).run(settings.retentionMaxDays);
         deletedOldItems = res.changes;
     }
@@ -121,7 +121,7 @@ export function runCleanup(custom) {
          AND id NOT IN (SELECT item_id FROM item_notes)
          AND feed_id NOT IN (SELECT id FROM feeds WHERE is_system_inbox = 1)
          AND NOT EXISTS (SELECT 1 FROM editions e, json_each(e.item_ids) selected
-           WHERE selected.value = items.id AND e.status = 'active' AND julianday(e.expires_at) > julianday('now'))
+           WHERE selected.value = items.id AND e.source = 'curated' AND e.status <> 'dismissed')
          AND id IN (
            SELECT id FROM (
              SELECT id, ROW_NUMBER() OVER (

package/server/dist/feeds/contentNoise.js

@@ -76,12 +76,28 @@ function removeReaderNoise(root, title, stats) {
     const headline = normalized(title ?? "");
     const seen = new Set();
     let leading = 0;
+    let reachedText = false;
     for (const block of leafBlocks(root)) {
         const text = flat(block.textContent);
         if (!text)
             continue;
         const position = leading++;
         const heading = /^H[1-3]$/.test(block.tagName);
+        // Before the first real paragraph: a standalone date and a section chip repeat what the page head says.
+        if (!reachedText && text.length >= 80)
+            reachedText = true;
+        if (!reachedText && position < 12) {
+            const anchorsInBlock = block.querySelectorAll("a");
+            const chip = anchorsInBlock.length === 1 && flat(anchorsInBlock[0].textContent) === text && text.length <= 30 && text.split(" ").length <= 3;
+            if (chip) {
+                drop(block, "section-chip");
+                continue;
+            }
+            if (/^(\d{1,2}\.\s?\d{1,2}\.\s?\d{2,4}|[A-Z][a-z]{2,8}\.? \d{1,2}, \d{4})([,\s•·|-]+\d{1,2}[:.]\d{2}( Uhr)?)?$/.test(text)) {
+                drop(block, "dateline");
+                continue;
+            }
+        }
         if (headline && normalized(text) === headline && (position < 4 || (heading && position < 14))) {
             drop(block, "title-repeat");
             continue;
@@ -147,6 +163,14 @@ const PRESENTATIONAL_TAGS = new Set(["FONT", "BIG", "SMALL", "CENTER", "TT", "U"
 const PRESENTATIONAL_ATTRIBUTES = ["style", "class", "color", "face", "size", "bgcolor", "align", "valign", "border", "cellpadding",
     "cellspacing", "background", "hspace", "vspace", "nowrap"];
 const SIZED_TAGS = new Set(["IMG", "VIDEO", "CANVAS", "IFRAME", "EMBED", "OBJECT"]);
+// Tracking and scripting hooks no client uses. Lazy-load sources stay: they may be an image's only address.
+const LAZY_SOURCES = new Set(["data-src", "data-srcset", "data-lazy-src", "data-original"]);
+const INERT_ATTRIBUTES = new Set(["role", "tabindex", "itemprop", "itemscope", "itemtype", "itemid", "draggable", "contenteditable"]);
+function isInertAttribute(name) {
+    if (LAZY_SOURCES.has(name))
+        return false;
+    return name.startsWith("data-") || name.startsWith("aria-") || name.startsWith("on") || INERT_ATTRIBUTES.has(name);
+}
 const EMPHASIS_EXEMPT = "h1, h2, h3, h4, h5, h6, th, strong, b";
 function wrapChildren(element, tag) {
     const wrapper = element.ownerDocument.createElement(tag);
@@ -174,6 +198,12 @@ function removeTypography(root, stats) {
                 changed = true;
             }
         }
+        for (const name of element.getAttributeNames()) {
+            if (isInertAttribute(name)) {
+                element.removeAttribute(name);
+                changed = true;
+            }
+        }
         if (!SIZED_TAGS.has(element.tagName)) {
             for (const name of ["width", "height"]) {
                 if (element.hasAttribute(name)) {
@@ -187,6 +217,14 @@ function removeTypography(root, stats) {
         if (plain && italic && !element.closest("em, i"))
             wrapChildren(element, "em");
         const anchorTarget = element.id && targets.has(element.id);
+        if (element.id && !anchorTarget) {
+            element.removeAttribute("id");
+            changed = true;
+        }
+        if (element.tagName === "A" && element.hasAttribute("name") && !targets.has(element.getAttribute("name") ?? "")) {
+            element.removeAttribute("name");
+            changed = true;
+        }
         if (PRESENTATIONAL_TAGS.has(element.tagName) && !anchorTarget) {
             element.replaceWith(...element.childNodes);
             changed = true;
@@ -384,7 +422,7 @@ const SNIPPET_INLINE_PATTERNS = [
 export function cleanSnippet(snippet, title) {
     if (snippet === null || snippet === undefined)
         return null;
-    let text = snippet.replace(/\r\n?/g, "\n").replace(/[ \t ]+/g, " ");
+    let text = snippet.replace(/\r\n?/g, "\n").replace(/[ \t\u00a0]+/g, " ");
     for (const pattern of SNIPPET_INLINE_PATTERNS)
         text = text.replace(pattern, "");
     const headline = normalized(title ?? "");

package/server/dist/feeds/repository.js

@@ -43,7 +43,7 @@ export function removeFeedIfUnused(feedId) {
         return;
     db.prepare(`DELETE FROM items WHERE feed_id = ? AND id NOT IN (SELECT item_id FROM item_bookmarks) AND id NOT IN (SELECT item_id FROM item_notes)
       AND NOT EXISTS (SELECT 1 FROM editions e, json_each(e.item_ids) selected
-        WHERE selected.value = items.id AND e.status = 'active' AND julianday(e.expires_at) > julianday('now'))`).run(feedId);
+        WHERE selected.value = items.id AND e.source = 'curated' AND e.status <> 'dismissed')`).run(feedId);
     db.prepare("DELETE FROM feeds WHERE id = ? AND is_system_inbox = 0 AND NOT EXISTS (SELECT 1 FROM items WHERE feed_id = ?)").run(feedId, feedId);
 }
 /** Feeds kept only for saved articles or annotated articles whose last bookmark and note are gone. */
@@ -54,7 +54,7 @@ export function removeUnusedFeeds() {
        AND NOT EXISTS (SELECT 1 FROM items i JOIN item_bookmarks b ON b.item_id = i.id WHERE i.feed_id = feeds.id)
        AND NOT EXISTS (SELECT 1 FROM items i JOIN item_notes n ON n.item_id = i.id WHERE i.feed_id = feeds.id)
        AND NOT EXISTS (SELECT 1 FROM items i, editions e, json_each(e.item_ids) selected
-         WHERE i.feed_id = feeds.id AND selected.value = i.id AND e.status = 'active' AND julianday(e.expires_at) > julianday('now'))`).run().changes;
+         WHERE i.feed_id = feeds.id AND selected.value = i.id AND e.source = 'curated' AND e.status <> 'dismissed')`).run().changes;
 }
 /** Subscribers can open every item of their feeds; anyone can open what they saved or added a note to. */
 export function canAccessItem(userId, itemId) {
@@ -64,7 +64,7 @@ export function canAccessItem(userId, itemId) {
            OR EXISTS (SELECT 1 FROM item_bookmarks b WHERE b.item_id = i.id AND b.user_id = ?)
            OR EXISTS (SELECT 1 FROM item_notes n WHERE n.item_id = i.id AND n.user_id = ?)
            OR EXISTS (SELECT 1 FROM editions e, json_each(e.item_ids) selected WHERE e.user_id = ?
-             AND selected.value = i.id AND e.status = 'active' AND julianday(e.expires_at) > julianday('now')))`).get(itemId, userId, userId, userId, userId));
+             AND selected.value = i.id AND e.source = 'curated' AND e.status <> 'dismissed'))`).get(itemId, userId, userId, userId, userId));
 }
 export function listSubscriptionsForUser(userId) {
     return db
@@ -292,7 +292,7 @@ export function findItemForUser(userId, itemId) {
      LEFT JOIN item_notes n ON n.item_id = i.id AND n.user_id = ?
      WHERE i.id = ? AND (s.id IS NOT NULL OR b.item_id IS NOT NULL OR n.item_id IS NOT NULL OR
        EXISTS (SELECT 1 FROM editions e, json_each(e.item_ids) selected WHERE e.user_id = ?
-         AND selected.value = i.id AND e.status = 'active' AND julianday(e.expires_at) > julianday('now')))`).get(userId, userId, userId, userId, itemId, userId);
+         AND selected.value = i.id AND e.source = 'curated' AND e.status <> 'dismissed'))`).get(userId, userId, userId, userId, itemId, userId);
 }
 export function updateSubscriptionLabel(userId, feedId, label) {
     db.prepare("UPDATE subscriptions SET label = ? WHERE user_id = ? AND feed_id = ?").run(label?.trim() || null, userId, feedId);

package/server/dist/mcp/items.js

@@ -37,7 +37,7 @@ export function listItemsPage(userId, options) {
     });
     const hasMore = rows.length > limit;
     const page = rows.slice(0, limit);
-    const items = page.map(({ content_html: _contentHtml, full_content_html: _fullContentHtml, ...item }) => item);
+    const items = page.map(({ content_html: _contentHtml, full_content_html: _fullContentHtml, content_lead: _lead, lead_version: _leadVersion, ...item }) => item);
     return {
         items,
         newestCursor: page[0] ? encodeCursor(page[0]) : null,
@@ -58,8 +58,9 @@ export function getItemForMcp(userId, itemId, maxChars = MAX_CONTENT_LENGTH, off
         end--;
     if (end === offset && offset < body.length)
         end = Math.min(offset + 2, body.length);
+    const { content_lead: _lead, lead_version: _leadVersion, ...visible } = item;
     return {
-        ...item,
+        ...visible,
         content_html: format === "html" ? body.slice(offset, end) : undefined,
         content_truncated: end < body.length,
         full_content_html: undefined,

package/server/dist/mcp/promptsAndResources.js

@@ -29,7 +29,7 @@ export function registerPromptsAndResources(server, userId, scope) {
     server.registerResource("feeds", "feedkeeper://feeds", { title: "Subscribed feeds", description: "All subscriptions with unread counts and health.", mimeType: "application/json" }, (uri) => ({ contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(listSubscriptionsForUser(userId), null, 2) }] }));
     server.registerResource("opml", "feedkeeper://opml", { title: "Subscriptions as OPML", description: "The subscription list in OPML 2.0, for backup or migration.", mimeType: "text/x-opml" }, (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/x-opml", text: generateOpml(userId) }] }));
     server.registerResource("saved", "feedkeeper://saved", { title: "Saved articles", description: "The newest 100 saved articles, without their content.", mimeType: "application/json" }, (uri) => {
-        const items = listItemsForUser(userId, { bookmarkedOnly: true, limit: 100 }).map(({ content_html: _html, full_content_html: _full, ...item }) => item);
+        const items = listItemsForUser(userId, { bookmarkedOnly: true, limit: 100 }).map(({ content_html: _html, full_content_html: _full, content_lead: _lead, lead_version: _leadVersion, ...item }) => item);
         return { contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(items, null, 2) }] };
     });
     server.registerResource("digest", "feedkeeper://digest", { title: "Unread digest", description: "Unread articles of the last 24 hours, grouped by feed.", mimeType: "application/json" }, (uri) => ({ contents: [{ uri: uri.href, mimeType: "application/json", text: JSON.stringify(buildDigest(userId, { hours: 24 }), null, 2) }] }));

package/server/dist/mcp/server.js

@@ -15,7 +15,7 @@ import { discoverFeeds } from "../feeds/discovery.js";
 import { findUserById } from "../auth/users.js";
 import { getDatabaseStats, runCleanup } from "../feeds/cleanup.js";
 import { APP_VERSION } from "../version.js";
-import { dismissEdition, editionCandidates, generateEdition, generateEditionSchema, getEditionState, publishCuratedEdition, publishEditionFields } from "../native/editions.js";
+import { dismissEdition, editionCandidates, ensureEditionSchema, getEdition, getEditionState, publishCuratedEdition, publishEditionFields } from "../native/editions.js";
 import { getNativePreferences, patchNativePreferences, preferencePatchSchema } from "../native/preferences.js";
 import { NativeError } from "../native/requests.js";
 import { capabilityDenial, hasUserCapability } from "../auth/capabilities.js";
@@ -254,7 +254,7 @@ export function createMcpServerForUser(userId, scope) {
         },
     }, async ({ feedId, folderId, search, bookmarkedOnly, since, until, limit, includeContent, snippetChars }) => textResult(listItemsForUser(userId, {
         feedId, folderId, search, bookmarkedOnly, limit, unreadOnly: true, publishedSince: since, publishedUntil: until,
-    }).map(({ content_html, full_content_html, ...item }) => ({
+    }).map(({ content_html, full_content_html, content_lead: _lead, lead_version: _leadVersion, ...item }) => ({
         ...item,
         ...(includeContent === false ? {} : { content_html, full_content_html }),
         content_snippet: snippetChars ? truncate(item.content_snippet, snippetChars) : item.content_snippet,
@@ -500,19 +500,23 @@ export function createMcpServerForUser(userId, scope) {
     if (scope === "write")
         server.registerTool("publish_edition", {
             title: "Publish curated edition",
-            description: "Publishes an ordered list of 1 to 24 accessible article IDs. Curated editions override automatic ones until expiry (default 24 hours, maximum seven days). App-only hidden sections and muted keywords are respected. Supply the revision from get_edition as expectedRevision and a UUID requestId for conflict detection and safe retries. Optional title and summary are editorial text; original articles stay unchanged. Optional layout (version 1) says how the issue is set: a character (dominant, calm or briefing) and blocks (lead, dossier, feature, standard, briefs, photo, quote) that reference the issue's article IDs at most once each; it never changes the articles.",
+            description: "Publishes an ordered list of 1 to 24 accessible article IDs. The latest curated edition stays readable until another is published; expiry (default 24 hours, maximum seven days) controls when a new publication is due. App-only hidden sections and muted keywords are respected. Supply the revision from get_edition as expectedRevision and a UUID requestId for conflict detection and safe retries. Optional title and summary are editorial text; original articles stay unchanged. Optional layout (version 1) says how the issue is set: a character (dominant, calm or briefing) and blocks (lead, dossier, feature, standard, briefs, photo, quote) that reference the issue's article IDs at most once each; it never changes the articles.",
             inputSchema: publishEditionFields,
         }, async (input) => capabilityAction("editions", () => publishCuratedEdition(userId, input)));
     if (scope === "write")
         server.registerTool("generate_edition", {
-            title: "Generate an automatic edition",
-            description: "Ensures an automatic edition exists without disturbing a valid current issue. force=true requests a new automatic selection and requires expectedRevision. A valid curated edition must be explicitly dismissed first. Use a stable UUID requestId for retries.",
-            inputSchema: generateEditionSchema.shape,
+            title: "Get the latest curated edition",
+            description: "Compatibility alias for reading the latest curated publication. It never selects articles or publishes an edition. force is accepted for older clients but does not create a replacement; use publish_edition to publish a new curated selection.",
+            inputSchema: ensureEditionSchema.shape,
         }, async (input) => capabilityAction("editions", () => {
-            const parsed = generateEditionSchema.safeParse(input);
+            const parsed = ensureEditionSchema.safeParse(input);
             if (!parsed.success)
                 throw new NativeError("invalid_input");
-            return { edition: generateEdition(userId, parsed.data), current: getEditionState(userId) };
+            const current = getEditionState(userId);
+            if (parsed.data.expectedRevision !== undefined && parsed.data.expectedRevision !== current.revision) {
+                throw new NativeError("revision_conflict", 409, current);
+            }
+            return { edition: getEdition(userId), current };
         }));
     if (scope === "write")
         server.registerTool("dismiss_edition", {

package/server/dist/native/editions.js

@@ -1,11 +1,9 @@
-import { hasUserCapability } from "../auth/capabilities.js";
 import { randomUUID } from "node:crypto";
-import cron from "node-cron";
 import { z } from "zod";
 import { db } from "../db/index.js";
 import { canAccessItem } from "../feeds/repository.js";
 import { decodeEntities } from "../feeds/text.js";
-import { editionPeriod, nextEditionBoundary, selectEdition } from "./editionSelection.js";
+import { editionPeriod, selectEdition } from "./editionSelection.js";
 import { getNativePreferences } from "./preferences.js";
 import { checkEditionLayout, editionLayoutSchema } from "./editionLayout.js";
 import { NativeError, nativeRequest } from "./requests.js";
@@ -22,9 +20,9 @@ function storedEdition(userId) {
 function serialize(row) {
     const prefs = getNativePreferences(row.user_id);
     return {
-        id: row.edition_id, revision: row.revision, source: row.source,
+        id: row.edition_id, revision: row.revision, source: "curated",
         createdAt: row.created_at, updatedAt: row.updated_at, expiresAt: row.expires_at,
-        period: row.period?.split(":")[1] ?? editionPeriod(new Date(row.created_at), prefs.timeZone).period,
+        period: row.period?.split(":").pop() ?? editionPeriod(new Date(row.created_at), prefs.timeZone).period,
         title: row.title, summary: row.summary, overview: row.overview ? JSON.parse(row.overview) : null, layout: row.layout ? JSON.parse(row.layout) : null,
         preferencesRevision: row.preferences_revision,
         itemIds: JSON.parse(row.item_ids),
@@ -34,11 +32,15 @@ export function getEditionState(userId, now = new Date()) {
     const row = storedEdition(userId);
     if (!row)
         return { revision: 0, status: "none", edition: null };
+    if (row.source !== "curated")
+        return { revision: row.revision, status: "expired", edition: null };
     const status = row.status === "active" && Date.parse(row.expires_at) <= now.getTime() ? "expired" : row.status;
     return { revision: row.revision, status, edition: status === "active" ? serialize(row) : null };
 }
-export function getEdition(userId, now = new Date()) {
-    return getEditionState(userId, now).edition;
+/** Expiry schedules the next publication; it does not take the last issue away from readers. */
+export function getEdition(userId, _now = new Date()) {
+    const row = storedEdition(userId);
+    return row?.source === "curated" && row.status !== "dismissed" ? serialize(row) : null;
 }
 function checkRevision(userId, expectedRevision, now) {
     const current = getEditionState(userId, now);
@@ -77,7 +79,13 @@ export const publishEditionFields = {
     layout: editionLayoutSchema.optional(),
 };
 const publishSchema = z.object(publishEditionFields).strict().refine((input) => !(input.expiresAt && input.durationHours), "Use expiresAt or durationHours, not both");
-/** Both automatic and MCP editions obey the app's hard exclusions. Read/saved articles
+/** Legacy ensure requests read the latest publication; they never select or publish articles. */
+export const ensureEditionSchema = z.object({
+    requestId: z.uuid(),
+    expectedRevision: z.number().int().min(0).optional(),
+    force: z.boolean().default(false),
+}).strict().refine((input) => !input.force || input.expectedRevision !== undefined, "force requires expectedRevision");
+/** Curated publications obey the app's hard exclusions. Read/saved articles
  * may be selected deliberately by an agent, but foreign and muted items cannot be published. */
 export function publishCuratedEdition(userId, input, now = new Date()) {
     if (input.layout !== undefined && !editionLayoutSchema.safeParse(input.layout).success)
@@ -135,7 +143,7 @@ export function deleteEdition(userId) {
     dismissEdition(userId);
     return existed;
 }
-/** The automatic edition looks at every candidate; smaller limits are shortlists for an agent or the curator. */
+/** Bound candidate gathering before building a shortlist for an agent or the curator. */
 const AUTOMATIC_EDITION_LIMIT = 4000;
 /** How often each feed appeared in the editions of the last 72 hours, so a feed that was shown a lot waits its turn. */
 function recentSourceUse(userId, itemIds) {
@@ -237,58 +245,4 @@ export function editionCandidates(userId, now = new Date(), limit = 200) {
     }
     return scored.sort((a, b) => b.score - a.score || b.id - a.id);
 }
-export const generateEditionSchema = z.object({
-    requestId: z.uuid(),
-    expectedRevision: z.number().int().min(0).optional(),
-    force: z.boolean().default(false),
-}).strict().refine((input) => !input.force || input.expectedRevision !== undefined, "force requires expectedRevision");
-export function generateEdition(userId, input = {}, now = new Date()) {
-    return nativeRequest(userId, input.requestId, "edition.generate", { expectedRevision: input.expectedRevision, force: input.force ?? false }, () => {
-        checkRevision(userId, input.expectedRevision, now);
-        const prefs = getNativePreferences(userId);
-        const period = editionPeriod(now, prefs.timeZone).key;
-        const state = getEditionState(userId, now);
-        if (state.edition) {
-            if (state.edition.source === "curated") {
-                if (input.force)
-                    throw new NativeError("curated_edition_active", 409, state);
-                return state.edition;
-            }
-            if (!input.force)
-                return state.edition;
-        }
-        const row = storedEdition(userId);
-        if (!input.force && row?.status === "dismissed" && row.period === period)
-            return null;
-        if (row?.status === "active" && !state.edition) {
-            db.prepare("UPDATE editions SET status = 'expired', revision = revision + 1, updated_at = ? WHERE user_id = ?").run(now.toISOString(), userId);
-        }
-        const chosen = selectEdition(editionCandidates(userId, now, AUTOMATIC_EDITION_LIMIT), prefs);
-        if (!chosen.length)
-            return state.edition;
-        if (state.edition && JSON.stringify(state.edition.itemIds) === JSON.stringify(chosen.map((item) => item.id)))
-            return state.edition;
-        return writeEdition(userId, chosen.map((item) => item.id), "automatic", nextEditionBoundary(now, prefs.timeZone), now);
-    }, now);
-}
-/** Only users who opted in by storing preferences or creating an edition are scheduled. */
-export function maintainEditions(now = new Date()) {
-    const users = db.prepare("SELECT user_id FROM native_preferences UNION SELECT user_id FROM editions").all();
-    for (const user of users) {
-        if (!hasUserCapability(user.user_id, "editions"))
-            continue;
-        try {
-            generateEdition(user.user_id, {}, now);
-        }
-        catch (error) {
-            console.error("[edition] could not refresh an edition", error instanceof Error ? error.message : "unknown error");
-        }
-    }
-    // Receipts remain valid for at least 35 days, beyond the native offline window.
-    db.prepare("DELETE FROM native_requests WHERE created_at < ?").run(new Date(now.getTime() - 35 * 86_400_000).toISOString());
-}
-export function startEditionScheduler() {
-    maintainEditions();
-    cron.schedule("* * * * *", () => maintainEditions());
-}
 //# sourceMappingURL=editions.js.map

package/server/dist/native/requests.js

@@ -1,3 +1,4 @@
+import cron from "node-cron";
 import { createHash } from "node:crypto";
 import { db } from "../db/index.js";
 export class NativeError extends Error {
@@ -32,4 +33,11 @@ export function nativeRequest(userId, requestId, operation, input, action, now =
         return result;
     })();
 }
+/** Receipts outlive the native offline window; publication metadata stays in the edition slot. */
+export function startNativeRequestCleanup() {
+    cron.schedule("0 * * * *", () => {
+        db.prepare("DELETE FROM native_requests WHERE created_at < ?")
+            .run(new Date(Date.now() - 35 * 86_400_000).toISOString());
+    });
+}
 //# sourceMappingURL=requests.js.map

package/server/dist/server.js

@@ -18,7 +18,7 @@ import { installPollingShutdown, startPollingScheduler } from "./feeds/poller.js
 import { startCleanupScheduler } from "./feeds/cleanup.js";
 import { repairEncodedText } from "./feeds/repository.js";
 import { pruneArchive, scheduleMissingArchives } from "./feeds/archive.js";
-import { startEditionScheduler } from "./native/editions.js";
+import { startNativeRequestCleanup } from "./native/requests.js";
 import { startLeadBackfill } from "./feeds/lead.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const WEB_DIST = join(__dirname, "../../web/dist");
@@ -34,7 +34,7 @@ if (pendingArchives > 0)
 startPollingScheduler();
 startFullTextScheduler();
 startCleanupScheduler();
-startEditionScheduler();
+startNativeRequestCleanup();
 const app = express();
 // Express validates the addresses here, so a mistyped TRUST_PROXY list stops the server at startup.
 if (config.trustProxy !== false) {

package/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feedkeeper/server",
-  "version": "0.26.1",
+  "version": "0.26.3",
   "private": true,
   "type": "module"
 }