@hutusi/amytis 1.12.0 → 1.14.0

package/content/flows/2026/03/05.md

@@ -0,0 +1,10 @@
+---
+title: 'JSDoc type comments'
+tags: ["typescript", "tooling"]
+---
+
+Finally moved a mid-sized project from JSDoc type comments to proper TypeScript. The migration took about half a day — less than expected.
+
+The biggest win is not autocompletion or error catching (though those matter). It is that the types act as documentation that stays in sync with the code. Prose comments lie; types don't compile if they do.
+
+One friction point: `strict: true` surfaces a lot of implicit `any` that was quietly hiding real assumptions. Fixing each one forced me to think about what the code actually expected — which is the point.

package/content/flows/2026/03/07.md

@@ -0,0 +1,11 @@
+---
+tags: ["ai", "workflow"]
+---
+
+# Using Claude Code
+
+Been using Claude Code for a week now as a daily coding assistant. A few observations so far.
+
+It is most useful for tasks where the shape of the solution is clear but the execution is tedious — refactoring, writing tests, tracking down why a CSS rule isn't applying. For genuinely novel design problems, talking through the approach matters more than generating code.
+
+The most important habit: read every diff before accepting it. Not because the code is wrong (it usually isn't), but because understanding what changed keeps you in the loop on your own codebase.

package/content/posts/welcome-to-amytis.mdx

@@ -5,12 +5,15 @@ excerpt: "The first seeds of our digital garden."
 category: "General"
 tags: ["introduction", "digital garden", "nextjs"]
 author: "Amytis Team"
+coverImage: "images/vibrant-waves.jpg"
 ---
 
 # Welcome to Amytis
 
 This is your new digital garden. Built with **Next.js**, **Tailwind CSS**, and **Bun**.
 
+![](images/vibrant-waves.jpg)
+
 ## Why Amytis?
 
 Amytis of Media was the wife of Nebuchadnezzar II, for whom the Hanging Gardens of Babylon were reportedly built. This digital garden is a space for thoughts to grow and flourish.

package/content/series/markdown-showcase/index.mdx

@@ -5,7 +5,8 @@ date: "2026-02-13"
 coverImage: "/images/lake.jpg"
 featured: true
 sort: "manual"
-posts: ["visuals-and-diagrams", "mathematical-notation", "syntax-highlighting"]
+redirectFrom:
+  - /series/markdown-showcase-old
 ---
 
 Amytis supports a wide range of MDX features. This series serves as both a reference and a demonstration.

package/content/series/markdown-showcase/mathematical-notation.mdx

@@ -1,9 +1,13 @@
 ---
-title: "Mathematical Notation"
-date: "2026-02-14"
-category: "Science"
-tags: ["math", "latex"]
+title: Mathematical Notation
+date: '2026-02-14'
+category: Science
+tags:
+  - math
+  - latex
 latex: true
+redirectFrom:
+  - /posts/mathematical-notation-demo
 ---
 
 Amytis uses `rehype-katex` to render beautiful mathematical formulas.

package/content/series/markdown-showcase/syntax-highlighting.mdx

@@ -1,10 +1,14 @@
 ---
-title: "Syntax Highlighting"
-date: "2026-02-15"
-category: "Engineering"
-tags: ["code", "typescript"]
+title: Syntax Highlighting
+date: '2026-02-15'
+category: Engineering
+tags:
+  - code
+  - typescript
 featured: true
-coverImage: "/images/vibrant-waves.jpg"
+coverImage: /images/vibrant-waves.jpg
+redirectFrom:
+  - /posts/syntax-highlighting
 ---
 
 Amytis provides beautiful syntax highlighting for dozens of programming languages. Here are a few examples within the series context.

package/content/series/markdown-showcase/visuals-and-diagrams.mdx

@@ -1,8 +1,12 @@
 ---
-title: "Visuals and Diagrams"
-date: "2026-02-13"
-category: "Design"
-tags: ["visuals", "mermaid"]
+title: Visuals and Diagrams
+date: '2026-02-13'
+category: Design
+tags:
+  - visuals
+  - mermaid
+redirectFrom:
+  - /posts/visuals-and-diagrams
 ---
 
 Visualizing information is key to understanding. Amytis integrates Mermaid.js for diagrams and handles images with ease.

package/content/{posts → series/markdown-showcase}//344/270/255/346/226/207/346/265/213/350/257/225/346/226/207/347/253/240.mdx

@@ -1,11 +1,16 @@
 ---
-title: "中文测试文章"
-date: "2026-02-09"
-excerpt: "这是一篇用于测试中文文件名和内容支持的文章。"
-category: "测试"
-tags: ["中文", "测试", "i18n"]
-author: "Amytis"
-coverImage: "text:中文测试"
+title: 中文测试文章
+date: '2026-02-09'
+excerpt: 这是一篇用于测试中文文件名和内容支持的文章。
+category: 测试
+tags:
+  - 中文
+  - 测试
+  - i18n
+author: Amytis
+coverImage: 'text:中文测试'
+redirectFrom:
+  - /posts/中文测试文章
 ---
 
 # 中文文件名支持测试

package/content/series/modern-web-dev/index.mdx

@@ -5,9 +5,11 @@ excerpt: "A curated path through modern web development: JavaScript fundamentals
 date: "2026-03-01"
 featured: true
 items:
-  - post: asynchronous-javascript
-  - post: understanding-react-hooks
+  - post: posts/asynchronous-javascript
+  - post: posts/understanding-react-hooks
   - series: nextjs-deep-dive
+  - post: markdown-showcase/中文测试文章
+  - post: digital-garden/02-architecture
 ---
 
 This collection assembles the essential reading for anyone building modern web applications. Start with the JavaScript fundamentals that underpin everything, move into React patterns, then go deep on Next.js.

package/docs/ARCHITECTURE.md

@@ -57,7 +57,14 @@ src/app/
   authors/[author]/page.tsx
   archive/page.tsx
   graph/page.tsx
-  feed.xml/route.ts
+  feed.xml/route.ts                 # Main curated RSS feed
+  feed.atom/route.ts                # Main curated Atom feed
+  all.xml/route.ts                  # Firehose RSS feed
+  all.atom/route.ts                 # Firehose Atom feed
+  posts/feed.xml/route.ts           # Posts-only RSS feed
+  posts/feed.atom/route.ts          # Posts-only Atom feed
+  flows/feed.xml/route.ts           # Flows-only RSS feed
+  flows/feed.atom/route.ts          # Flows-only Atom feed
   search.json/route.ts
   sitemap.ts
   [slug]/page.tsx                   # Static pages + custom series listing path

package/docs/DIGITAL_GARDEN.md

@@ -37,12 +37,33 @@ The `/graph` route visualizes your entire digital garden as an interactive netwo
 - **Edges**: Represent wiki-links connecting them.
 - **Interaction**: Click a node to navigate to that page.
 
-### 5. Flows (`/flows`)
+### 5. Collections (`/series`)
+While a "Series" is typically a linear progression of posts (e.g., Part 1, Part 2), a **Collection** allows you to manually curate an arbitrary list of posts and other series into a single grouped page.
+
+To create a collection, set `type: collection` in a series index file:
+
+- **Location:** `content/series/[collection-slug]/index.mdx`
+- **Frontmatter:**
+  ```yaml
+  ---
+  title: "Modern Web Development"
+  type: collection
+  items:
+    - post: posts/asynchronous-javascript  # Namespaced reference to a standalone post
+    - post: ai-nexus-weekly/week-11        # Namespaced reference to a post inside another series
+    - post: understanding-react-hooks      # Fallback reference (searches all posts by slug)
+    - series: nextjs-deep-dive             # Embeds all posts from another series
+  ---
+  ```
+Using a namespace (`folder/slug`) in the `post` definition prevents slug collisions and explicitly targets the exact file location.
+
+### 6. Flows (`/flows`)
 Flows are a stream-style collection of daily notes, micro-blogging, or imported chat logs. They are ideal for quick thoughts that don't necessarily warrant a full blog post.
 
 - **Location:** `content/flows/YYYY/MM/DD.mdx`
 - **Navigation:** Grouped by date in a timeline view.
 - **Importing:** Use `bun run new-flow-from-chat` to bring in external conversations.
+- **Optional Title:** Set `title` in frontmatter or use an `# Heading` in the content to display a title alongside the date.
 
 ## How to Use
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hutusi/amytis",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "A high-performance digital garden and blog engine with Next.js 16 and Tailwind CSS v4",
   "repository": {
     "type": "git",
@@ -48,16 +48,16 @@
     "github-slugger": "^2.0.0",
     "gray-matter": "^4.0.3",
     "image-size": "^2.0.2",
-    "katex": "^0.16.33",
-    "mermaid": "^11.12.3",
-    "next": "16.1.6",
+    "katex": "^0.16.42",
+    "mermaid": "^11.13.0",
+    "next": "16.2.1",
     "next-image-export-optimizer": "^1.20.1",
     "next-themes": "^0.4.6",
     "react": "19.2.4",
     "react-dom": "19.2.4",
-    "react-icons": "^5.5.0",
+    "react-icons": "^5.6.0",
     "react-markdown": "^10.1.0",
-    "react-syntax-highlighter": "^16.1.0",
+    "react-syntax-highlighter": "^16.1.1",
     "rehype-katex": "^7.0.1",
     "rehype-raw": "^7.0.0",
     "rehype-slug": "^6.0.0",
@@ -72,22 +72,22 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",
-    "@tailwindcss/postcss": "^4.1.18",
-    "@types/bun": "^1.3.9",
+    "@tailwindcss/postcss": "^4.2.2",
+    "@types/bun": "^1.3.11",
     "@types/d3": "^7.4.3",
     "@types/hast": "^3.0.4",
     "@types/image-size": "^0.8.0",
     "@types/mdast": "^4.0.4",
-    "@types/node": "^24.10.13",
+    "@types/node": "^24.12.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@types/react-syntax-highlighter": "^15.5.13",
     "babel-plugin-react-compiler": "1.0.0",
-    "eslint": "^9.0.0",
-    "eslint-config-next": "16.1.6",
+    "eslint": "^9.39.4",
+    "eslint-config-next": "16.2.1",
     "pagefind": "^1.4.0",
     "pdf-to-img": "^5.0.0",
-    "tailwindcss": "^4.1.18",
+    "tailwindcss": "^4.2.2",
     "typescript": "^5.9.3"
   },
   "ignoreScripts": [

package/public/next-image-export-optimizer-hashes.json

@@ -68,7 +68,8 @@
     "images/lake.jpg": "imAORQhxpmoU3jzKBMNFJuFSa0UgiSf2Dmea5Rj8-8M=",
     "images/mountains.jpg": "FsrkZws9EKMqHCk1Hc6i6nEIcTRcrMBa4ddgqR6oRaI=",
     "images/screenshot.png": "FAqbAgLRbWbYq9yJ4iggq2aKxRD8hdeDICc3DI14yhg=",
-    "images/vibrant-waves.avif": "pP6wNch0dvCr+HGjkA8zIT6ZuZCSSofiVkG922udk54=",
+    "images/vibrant-waves.jpg": "vdBm72ev5ETPM5H2CDK6tqph5t8N5nTCSApBJp2lW6U=",
     "images/wechat-qr.jpg": "DNIzz0Wcl8WP0h-jHHgZ9LEvf3ZKOXHgxlvpw3gK2ME=",
-    "posts/02-routing-mastery/assets/m-p-model.png": "fDmvlEkZnE-UCvPK4gmDkJD7SU8coOTl4iw5hpsmcWI="
+    "posts/02-routing-mastery/assets/m-p-model.png": "fDmvlEkZnE-UCvPK4gmDkJD7SU8coOTl4iw5hpsmcWI=",
+    "posts/images/vibrant-waves.jpg": "YogfFJOm4PQV1g3iMRpCL1pKtjPXpMeJDFf6NTILcBQ="
 }

package/scripts/new-flow.ts

@@ -33,6 +33,7 @@ if (!fs.existsSync(dirPath)) {
 }
 
 const content = `---
+# title: ""
 tags: []
 ---
 

package/site.config.example.ts

@@ -143,7 +143,7 @@ export const siteConfig = {
       { id: 'featured-posts',  enabled: true, weight: 2, maxItems: 4 },
       { id: 'latest-posts',    enabled: true, weight: 3, maxItems: 3 },
       { id: 'recent-flows',    enabled: false, weight: 4, maxItems: 8 },
-      { id: 'featured-series', enabled: true, weight: 5, maxItems: 6, scrollThreshold: 2 },
+      { id: 'featured-series', enabled: true, weight: 5, maxItems: 6 },
       { id: 'featured-books',  enabled: false, weight: 6, maxItems: 4 },
     ],
   },
@@ -177,10 +177,9 @@ export const siteConfig = {
   },
   series: {
     // When true, posts in a series are served at /[series-slug]/[post-slug]
-    // instead of the default posts basePath. Defaults to false to avoid breaking
-    // existing deployments — enable explicitly and run `add-series-redirects` first.
+    // instead of the default posts basePath. Defaults to true.
     // customPaths entries always take precedence over autoPaths.
-    autoPaths: false,
+    autoPaths: true,
     // Per-series custom URL prefix for posts within that series.
     // Overrides autoPaths for the specified series.
     // e.g., { 'weeklies': 'weeklies' } → posts served at /weeklies/[slug]

package/site.config.ts

@@ -33,7 +33,7 @@ export const siteConfig = {
     favicon: "/icon.svg",
   },
   description: { en: "Amytis — an elegant open-source framework for building your personal digital garden.", zh: "Amytis — 优雅的开源数字花园框架。" },
-  baseUrl: "https://example.com", // Replace with your actual domain
+  baseUrl: "https://amytis.vercel.app", // Replace with your actual domain
   ogImage: "/og-image.png", // Default OG/social preview image — place a 1200×630 PNG at public/og-image.png
   footerText: { en: `© ${new Date().getFullYear()} Amytis. All rights reserved.`, zh: `© ${new Date().getFullYear()} Amytis. 保留所有权利。` },
 
@@ -140,9 +140,9 @@ export const siteConfig = {
     sections: [
       { id: 'hero',            enabled: true, weight: 1 },
       { id: 'featured-posts',  enabled: true, weight: 2, maxItems: 4 },
-      { id: 'latest-posts',    enabled: true, weight: 3, maxItems: 3 },
-      { id: 'recent-flows',    enabled: true, weight: 4, maxItems: 8 },
-      { id: 'featured-series', enabled: true, weight: 5, maxItems: 6, scrollThreshold: 2 },
+      { id: 'latest-posts',    enabled: true, weight: 3, maxItems: 4 },
+      { id: 'recent-flows',    enabled: true, weight: 4, maxItems: 7 },
+      { id: 'featured-series', enabled: true, weight: 5, maxItems: 6 },
       { id: 'featured-books',  enabled: true, weight: 6, maxItems: 4 },
     ],
   },
@@ -176,10 +176,9 @@ export const siteConfig = {
   },
   series: {
     // When true, posts in a series are served at /[series-slug]/[post-slug]
-    // instead of the default posts basePath. Defaults to false to avoid breaking
-    // existing deployments — enable explicitly and run `add-series-redirects` first.
+    // instead of the default posts basePath. Defaults to true.
     // customPaths entries always take precedence over autoPaths.
-    autoPaths: false,
+    autoPaths: true,
     // Per-series custom URL prefix for posts within that series.
     // Overrides autoPaths for the specified series.
     // e.g., { 'weeklies': 'weeklies' } → posts served at /weeklies/[slug]

package/src/app/[slug]/[postSlug]/page.tsx

@@ -49,7 +49,7 @@ export async function generateStaticParams() {
     const pageSlugSet = getAllPages().map(p => p.slug);
     validateSeriesAutoPaths(allSeriesSlugs, [...pageSlugSet, ...Object.values(customPaths)]); // Throws if any slug collides with a reserved route, static page, or customPaths prefix
     for (const seriesSlug of allSeriesSlugs) {
-      if (seriesSlug in customPaths) continue; // Already handled by customPaths above
+      if (Object.hasOwn(customPaths, seriesSlug)) continue; // Already handled by customPaths above
       allSeriesMap[seriesSlug].forEach(post => { params.push({ slug: seriesSlug, postSlug: post.slug }); });
     }
   }
@@ -61,10 +61,27 @@ export async function generateStaticParams() {
       if (segments.length !== 2) continue;
       const [fromPrefix, fromPostSlug] = segments;
       if (from === getPostUrl(post)) continue;   // skip if this is already the canonical path
+      // Skip /posts/* entries when basePath is 'posts' — handled by posts/[slug]/page.tsx instead
+      if (fromPrefix === 'posts' && basePath === 'posts') continue;
       params.push({ slug: fromPrefix, postSlug: fromPostSlug });
     }
   }
 
+  // Work around Next dev static-param checks for percent-encoded Unicode postSlugs
+  // under `output: "export"` — dev server may receive percent-encoded forms of Unicode paths.
+  // Include encoded variants in development only; production export keeps raw segment values.
+  if (process.env.NODE_ENV !== 'production') {
+    const existing = new Set(params.map(p => `${p.slug}/${p.postSlug}`));
+    for (const p of [...params]) {
+      const encodedPostSlug = encodeURIComponent(p.postSlug);
+      const key = `${p.slug}/${encodedPostSlug}`;
+      if (!existing.has(key)) {
+        existing.add(key);
+        params.push({ slug: p.slug, postSlug: encodedPostSlug });
+      }
+    }
+  }
+
   // Placeholder keeps Next.js happy with output: export when no custom paths configured.
   // dynamicParams = false ensures any unrecognised slug/postSlug combo returns 404.
   return params.length > 0 ? params : [{ slug: '_', postSlug: '_' }];
@@ -153,7 +170,7 @@ export default async function PrefixPostPage({
   const customPaths = getSeriesCustomPaths();
   const isValidBasePath = prefix === basePath && basePath !== 'posts';
   const matchedSeriesSlug = Object.entries(customPaths).find(([, path]) => path === prefix)?.[0];
-  const isAutoSeriesPath = getSeriesAutoPaths() && !(prefix in customPaths) && getSeriesData(prefix) !== null;
+  const isAutoSeriesPath = getSeriesAutoPaths() && !Object.hasOwn(customPaths, prefix) && getSeriesData(prefix) !== null;
   const isLegacyRedirect = post.redirectFrom?.includes(currentPath) ?? false;
 
   if (!isValidBasePath && !matchedSeriesSlug && !isAutoSeriesPath && !isLegacyRedirect) {

package/src/app/[slug]/page/[page]/page.tsx

@@ -1,4 +1,4 @@
-import { getListingPosts, getSeriesData, getSeriesPosts, getSeriesAuthors, getAuthorSlug } from '@/lib/markdown';
+import { getListingPosts, getAllSeries, getSeriesData, getSeriesPosts, getSeriesAuthors, getAuthorSlug } from '@/lib/markdown';
 import PostList from '@/components/PostList';
 import SeriesCatalog from '@/components/SeriesCatalog';
 import Pagination from '@/components/Pagination';
@@ -9,11 +9,18 @@ import { t, resolveLocale } from '@/lib/i18n';
 import PageHeader from '@/components/PageHeader';
 import CoverImage from '@/components/CoverImage';
 import Link from 'next/link';
-import { getPostsBasePath, getSeriesCustomPaths } from '@/lib/urls';
+import { getPostsBasePath, getSeriesCustomPaths, getSeriesAutoPaths } from '@/lib/urls';
 
 const POST_PAGE_SIZE = siteConfig.pagination.posts;
 const SERIES_PAGE_SIZE = siteConfig.pagination.series;
 
+function resolveSeriesSlug(prefix: string, customPaths: Record<string, string>): string | undefined {
+  return (
+    Object.entries(customPaths).find(([, path]) => path === prefix)?.[0] ??
+    (getSeriesAutoPaths() && !Object.hasOwn(customPaths, prefix) && getSeriesData(prefix) ? prefix : undefined)
+  );
+}
+
 export async function generateStaticParams() {
   const params: { slug: string; page: string }[] = [];
 
@@ -28,7 +35,8 @@ export async function generateStaticParams() {
   }
 
   // Series custom paths — paginated series listing (page 2+)
-  for (const [seriesSlug, customPath] of Object.entries(getSeriesCustomPaths())) {
+  const customPaths = getSeriesCustomPaths();
+  for (const [seriesSlug, customPath] of Object.entries(customPaths)) {
     const posts = getSeriesPosts(seriesSlug);
     const totalPages = Math.ceil(posts.length / SERIES_PAGE_SIZE);
     for (let i = 2; i <= totalPages; i++) {
@@ -36,6 +44,19 @@ export async function generateStaticParams() {
     }
   }
 
+  // Series auto-paths — paginated series listing (page 2+)
+  const customPathValues = new Set(Object.values(customPaths));
+  if (getSeriesAutoPaths()) {
+    for (const [seriesSlug, posts] of Object.entries(getAllSeries())) {
+      if (Object.hasOwn(customPaths, seriesSlug)) continue; // series has its own customPaths key override — skip
+      if (customPathValues.has(seriesSlug)) continue; // slug collides with another series' custom path value — skip
+      const totalPages = Math.ceil(posts.length / SERIES_PAGE_SIZE);
+      for (let i = 2; i <= totalPages; i++) {
+        params.push({ slug: seriesSlug, page: i.toString() });
+      }
+    }
+  }
+
   // Placeholder keeps Next.js happy with output: export when no custom paths configured.
   // dynamicParams = false ensures any unrecognised slug/page combo returns 404.
   return params.length > 0 ? params : [{ slug: '_', page: '2' }];
@@ -51,7 +72,7 @@ export async function generateMetadata({
   const { slug: prefix, page } = await params;
   const basePath = getPostsBasePath();
   const customPaths = getSeriesCustomPaths();
-  const matchedSeriesSlug = Object.entries(customPaths).find(([, path]) => path === prefix)?.[0];
+  const matchedSeriesSlug = resolveSeriesSlug(prefix, customPaths);
 
   if (prefix === basePath && basePath !== 'posts') {
     return {
@@ -82,7 +103,7 @@ export default async function PrefixPageRoute({
 
   const basePath = getPostsBasePath();
   const customPaths = getSeriesCustomPaths();
-  const matchedSeriesSlug = Object.entries(customPaths).find(([, path]) => path === prefix)?.[0];
+  const matchedSeriesSlug = resolveSeriesSlug(prefix, customPaths);
 
   // Custom posts basePath listing
   if (prefix === basePath && basePath !== 'posts') {

package/src/app/[slug]/page.tsx

@@ -1,4 +1,4 @@
-import { getPageBySlug, getAllPages, getAllPosts, getListingPosts, getSeriesData, getSeriesPosts, getSeriesAuthors, getAuthorSlug } from '@/lib/markdown';
+import { getPageBySlug, getAllPages, getAllPosts, getAllSeries, getListingPosts, getSeriesData, getSeriesPosts, getSeriesAuthors, getAuthorSlug } from '@/lib/markdown';
 import { notFound } from 'next/navigation';
 import PostLayout from '@/layouts/PostLayout';
 import SimpleLayout from '@/layouts/SimpleLayout';
@@ -11,12 +11,19 @@ import { Metadata } from 'next';
 import { siteConfig } from '../../../site.config';
 import { resolveLocale, t } from '@/lib/i18n';
 import PageHeader from '@/components/PageHeader';
-import { getPostsBasePath, getSeriesCustomPaths, getPostUrl } from '@/lib/urls';
+import { getPostsBasePath, getSeriesCustomPaths, getSeriesAutoPaths, getPostUrl, RESERVED_ROUTE_SEGMENTS } from '@/lib/urls';
 import RedirectPage from '@/components/RedirectPage';
 
 const POST_PAGE_SIZE = siteConfig.pagination.posts;
 const SERIES_PAGE_SIZE = siteConfig.pagination.series;
 
+function resolveSeriesSlug(slug: string, customPaths: Record<string, string>): string | undefined {
+  return (
+    Object.entries(customPaths).find(([, path]) => path === slug)?.[0] ??
+    (getSeriesAutoPaths() && !Object.hasOwn(customPaths, slug) && getSeriesData(slug) ? slug : undefined)
+  );
+}
+
 /**
  * Generates the static paths for all top-level pages at build time,
  * plus any custom URL prefixes configured for posts or series.
@@ -32,19 +39,32 @@ export async function generateStaticParams() {
   }
 
   // Add series custom path listings (e.g. /weeklies)
-  for (const customPath of Object.values(getSeriesCustomPaths())) {
+  const customPaths = getSeriesCustomPaths();
+  for (const customPath of Object.values(customPaths)) {
     params.push({ slug: customPath });
   }
 
+  // Add series auto-path listings (e.g. /my-series) when autoPaths is enabled
+  const customPathValues = new Set(Object.values(customPaths));
+  const autoPathSlugs: string[] = [];
+  if (getSeriesAutoPaths()) {
+    for (const seriesSlug of Object.keys(getAllSeries())) {
+      if (Object.hasOwn(customPaths, seriesSlug)) continue; // series has its own customPaths key override — skip
+      if (customPathValues.has(seriesSlug)) continue; // slug collides with another series' custom path value — skip
+      autoPathSlugs.push(seriesSlug);
+      params.push({ slug: seriesSlug });
+    }
+  }
+
   // Add single-segment redirectFrom paths (e.g. /old-slug).
   // Throws on any alias that collides with a reserved top-level slug or a
   // duplicate alias across posts — strict build catches misconfiguration early.
   const reservedSlugs = new Set([
     ...pages.map(p => p.slug),
     basePath,
-    ...Object.values(getSeriesCustomPaths()),
-    // Hardcoded top-level routes that have their own app/ directories
-    'posts', 'series', 'tags', 'authors', 'archive', 'books', 'flows', 'notes', 'search', 'page',
+    ...Object.values(customPaths),
+    ...autoPathSlugs,
+    ...RESERVED_ROUTE_SEGMENTS,
   ]);
   for (const post of getAllPosts()) {
     for (const from of post.redirectFrom ?? []) {
@@ -82,7 +102,7 @@ export async function generateMetadata({ params }: { params: Promise<{ slug: str
 
   // Series custom paths
   const customPaths = getSeriesCustomPaths();
-  const matchedSeriesSlug = Object.entries(customPaths).find(([, path]) => path === slug)?.[0];
+  const matchedSeriesSlug = resolveSeriesSlug(slug, customPaths);
   if (matchedSeriesSlug) {
     const seriesData = getSeriesData(matchedSeriesSlug);
     if (seriesData) {
@@ -145,7 +165,7 @@ export default async function Page({
 
   // Check if slug matches a series custom path
   const customPaths = getSeriesCustomPaths();
-  const matchedSeriesSlug = Object.entries(customPaths).find(([, path]) => path === slug)?.[0];
+  const matchedSeriesSlug = resolveSeriesSlug(slug, customPaths);
   if (matchedSeriesSlug) {
     const seriesData = getSeriesData(matchedSeriesSlug);
     const allPosts = getSeriesPosts(matchedSeriesSlug);

package/src/app/all.atom/route.ts

@@ -0,0 +1,7 @@
+import { generateAtomFeed } from '@/lib/feed-utils';
+
+export const dynamic = 'force-static';
+
+export async function GET() {
+  return generateAtomFeed('all', '/all.atom');
+}

package/src/app/all.xml/route.ts

@@ -0,0 +1,7 @@
+import { generateRssFeed } from '@/lib/feed-utils';
+
+export const dynamic = 'force-static';
+
+export async function GET() {
+  return generateRssFeed('all', '/all.xml');
+}

package/src/app/archive/page.tsx

@@ -128,12 +128,12 @@ export default function ArchivePage() {
                               <li key={post.slug} className="group">
                                 <Link href={getPostUrl(post)} className="block no-underline">
                                   <div className="flex flex-col sm:flex-row sm:items-baseline justify-between gap-2 sm:gap-6">
-                                    <div className="flex items-baseline gap-6">
+                                    <div className="flex items-baseline gap-6 min-w-0 flex-1">
                                       <span className="font-mono text-base text-muted shrink-0 w-8">
                                         {day}
                                       </span>
-                                      <div className="flex items-baseline gap-2">
-                                        <h4 className="text-xl font-serif font-medium text-heading/80 group-hover:text-accent transition-colors duration-200">
+                                      <div className="flex items-baseline gap-2 min-w-0 flex-1">
+                                        <h4 className="text-xl font-serif font-medium text-heading/80 group-hover:text-accent transition-colors duration-200 truncate">
                                           {post.title}
                                         </h4>
                                         {post.series && (
@@ -147,7 +147,10 @@ export default function ArchivePage() {
                                       </div>
                                     </div>
                                     {showAuthors && post.authors.length > 0 && (
-                                      <span className="text-sm font-sans italic text-muted/60 shrink-0 hidden sm:block">
+                                      <span 
+                                        title={post.authors.join(', ')}
+                                        className="text-sm font-sans italic text-muted/60 hidden sm:block max-w-[12rem] md:max-w-[16rem] lg:max-w-[20rem] truncate text-right shrink-0"
+                                      >
                                         {post.authors.join(', ')}
                                       </span>
                                     )}