@glw907/cairn-cms 0.7.0 → 0.8.0

package/dist/sveltekit/public-routes.d.ts

@@ -1,7 +1,8 @@
-import type { ContentIndex, ContentSummary, ContentEntry } from '../delivery/content-index.js';
+import type { ContentSummary, ContentEntry } from '../delivery/content-index.js';
+import type { SiteIndex } from '../delivery/site-index.js';
 /** Injected dependencies for the public loaders. */
 export interface PublicRoutesDeps {
-    index: ContentIndex;
+    site: SiteIndex;
     render: (md: string, opts?: {
         stagger?: boolean;
     }) => string | Promise<string>;
@@ -30,22 +31,20 @@ export interface EntryData {
     newer?: ContentSummary;
     older?: ContentSummary;
 }
-/** Build the public loaders for one concept's index. */
+/** Build the public loaders for a site's unified index. */
 export declare function createPublicRoutes(deps: PublicRoutesDeps): {
-    archiveLoad: () => ListData;
-    tagIndexLoad: () => TagIndexData;
-    tagLoad: (event: {
+    entryLoad: (event: {
+        url: URL;
+    }) => Promise<EntryData>;
+    archiveLoad: (conceptId: string) => ListData;
+    tagIndexLoad: (conceptId: string) => TagIndexData;
+    tagLoad: (conceptId: string, event: {
         params: {
             tag: string;
         };
     }) => TagData;
-    entryLoad: (event: {
-        params: {
-            slug: string;
-        };
-    }) => Promise<EntryData>;
     entries: () => {
-        slug: string;
+        path: string;
     }[];
 };
 //# sourceMappingURL=public-routes.d.ts.map

package/dist/sveltekit/public-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/public-routes.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE/F,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,uDAAuD;AACvD,MAAM,WAAW,OAAQ,SAAQ,QAAQ;IACvC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxC;AAED,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;uBAI/B,QAAQ;wBAKP,YAAY;qBAKb;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO;uBAQ7B;QAAE,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO,CAAC,SAAS,CAAC;mBAc7D;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;EAKvC"}
+{"version":3,"file":"public-routes.d.ts","sourceRoot":"","sources":["../../src/lib/sveltekit/public-routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,uDAAuD;AACvD,MAAM,WAAW,OAAQ,SAAQ,QAAQ;IACvC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxC;AAED,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;uBAWvB;QAAE,GAAG,EAAE,GAAG,CAAA;KAAE,KAAG,OAAO,CAAC,SAAS,CAAC;6BAQjC,MAAM,KAAG,QAAQ;8BAKhB,MAAM,KAAG,YAAY;yBAK1B,MAAM,SAAS;QAAE,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO;mBAO5D;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;EAKvC"}

package/dist/sveltekit/public-routes.js

@@ -1,44 +1,45 @@
-// cairn-cms: public route loaders (public-delivery design, decision 6). A factory closes over
-// a concept's index, the runtime render, and the origin, and returns thin load functions plus
-// entries() for prerender. A site route file stays a one-line shim. The index is built in site
-// code from a glob, so it stays in the prerender graph and out of the runtime Worker.
+// cairn-cms: public route loaders (dated-slug design). The factory closes over the site-level
+// index, the runtime render, and the origin. entryLoad and entries are site-wide: one catch-all
+// `[...path]` route resolves any concept by request path through `byPermalink`. The archive, tag,
+// and tag-index loaders stay concept-scoped, keyed by concept id. The index is built in site code
+// from globs, so it stays in the prerender graph and out of the runtime Worker.
 import { error } from '@sveltejs/kit';
-/** Build the public loaders for one concept's index. */
+/** Build the public loaders for a site's unified index. */
 export function createPublicRoutes(deps) {
-    const { index, render, origin } = deps;
-    /** The chronological archive: every non-draft summary, newest-first. */
-    function archiveLoad() {
-        return { entries: index.all() };
+    const { site, render, origin } = deps;
+    /** Resolve one concept's index by id, or a 404 (the route names an unconfigured concept). */
+    function indexOf(conceptId) {
+        const index = site.concept(conceptId);
+        if (!index)
+            throw error(404, `Unknown content type: ${conceptId}`);
+        return index;
     }
-    /** All tags with counts, for a tag index page. */
-    function tagIndexLoad() {
-        return { tags: index.allTags() };
-    }
-    /** One tag's entries, or a 404 when the tag has none. */
-    function tagLoad(event) {
-        const tag = event.params.tag;
-        const entries = index.byTag(tag);
-        if (entries.length === 0)
-            throw error(404, `No entries tagged "${tag}"`);
-        return { tag, entries };
-    }
-    /** One entry by slug, rendered through the site renderer, or a 404. */
+    /** One entry by request path, rendered through the site renderer, or a 404. */
     async function entryLoad(event) {
-        const entry = index.byId(event.params.slug);
+        const entry = site.byPermalink(event.url.pathname);
         if (!entry)
-            throw error(404, `Not found: ${event.params.slug}`);
-        const { newer, older } = index.adjacent(entry.id);
-        return {
-            entry,
-            html: await render(entry.body, { stagger: true }),
-            canonicalUrl: origin + entry.permalink,
-            newer,
-            older,
-        };
+            throw error(404, `Not found: ${event.url.pathname}`);
+        const { newer, older } = site.adjacent(entry);
+        return { entry, html: await render(entry.body, { stagger: true }), canonicalUrl: origin + entry.permalink, newer, older };
+    }
+    /** The chronological archive for one concept: every non-draft summary, newest-first. */
+    function archiveLoad(conceptId) {
+        return { entries: indexOf(conceptId).all() };
+    }
+    /** All tags with counts for one concept, for a tag index page. */
+    function tagIndexLoad(conceptId) {
+        return { tags: indexOf(conceptId).allTags() };
+    }
+    /** One tag's entries for one concept, or a 404 when the tag has none. */
+    function tagLoad(conceptId, event) {
+        const entries = indexOf(conceptId).byTag(event.params.tag);
+        if (entries.length === 0)
+            throw error(404, `No entries tagged "${event.params.tag}"`);
+        return { tag: event.params.tag, entries };
     }
-    /** Prerender enumeration: one `{ slug }` per non-draft entry. */
+    /** Prerender enumeration: one `{ path }` per entry across every concept. */
     function entries() {
-        return index.all().map((entry) => ({ slug: entry.id }));
+        return site.entries();
     }
-    return { archiveLoad, tagIndexLoad, tagLoad, entryLoad, entries };
+    return { entryLoad, archiveLoad, tagIndexLoad, tagLoad, entries };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@glw907/cairn-cms",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Embedded, magic-link, GitHub-committing CMS for SvelteKit/Cloudflare sites.",
   "type": "module",
   "sideEffects": [

package/src/lib/components/ConceptList.svelte

@@ -17,9 +17,14 @@ plus a new-entry form. The slug auto-derives from the title until the author edi
   let title = $state('');
   let slug = $state('');
   let slugEdited = $state(false);
+  // Default the date client-side so the SSR pass and hydration agree across UTC midnight.
+  let dateDefault = $state('');
+  $effect(() => {
+    dateDefault = new Date().toISOString().slice(0, 10);
+  });
 
   const derivedSlug = $derived(slugEdited ? slug : slugify(title));
-  const slugPlaceholder = $derived(data.dated ? '2026-05-my-entry' : 'about-us');
+  const slugPlaceholder = $derived(data.dated ? 'my-entry' : 'about-us');
 </script>
 
 <header class="mb-4 flex items-center justify-between">
@@ -58,14 +63,13 @@ plus a new-entry form. The slug auto-derives from the title until the author edi
   <h2 class="text-sm font-semibold">New entry</h2>
   <label class="flex flex-col gap-1">
     <span class="text-sm font-medium">Title</span>
-    <input class="input" name="title" aria-label="Title" bind:value={title} required />
+    <input class="input" name="title" bind:value={title} required />
   </label>
   <label class="flex flex-col gap-1">
     <span class="text-sm font-medium">Slug</span>
     <input
       class="input"
       name="slug"
-      aria-label="Slug"
       placeholder={slugPlaceholder}
       value={derivedSlug}
       oninput={(e) => { slugEdited = true; slug = e.currentTarget.value; }}
@@ -74,7 +78,7 @@ plus a new-entry form. The slug auto-derives from the title until the author edi
   {#if data.dated}
     <label class="flex flex-col gap-1">
       <span class="text-sm font-medium">Date</span>
-      <input class="input" type="date" name="date" aria-label="Date" />
+      <input class="input" type="date" name="date" value={dateDefault} />
     </label>
   {/if}
   <button type="submit" class="btn btn-primary self-start">Create</button>

package/src/lib/content/compose.ts

@@ -3,7 +3,7 @@
 // the same way and contributes the same kinds of things: nav entries, route logic,
 // concepts, components, field types, and save hooks. Shaped now so the extension contract
 // is additive later.
-import type { AdminPanel, CairnAdapter, CairnExtension, CairnRuntime, ConceptConfig, FieldTypeDef } from './types.js';
+import type { AdminPanel, CairnAdapter, CairnExtension, CairnRuntime, ConceptConfig, ConceptUrlPolicy, FieldTypeDef } from './types.js';
 import { normalizeConcepts } from './concepts.js';
 
 /**
@@ -13,6 +13,7 @@ import { normalizeConcepts } from './concepts.js';
 export function composeRuntime(
   adapter: CairnAdapter,
   extensions: CairnExtension[] = [],
+  urlPolicy: Record<string, ConceptUrlPolicy | undefined> = {},
 ): CairnRuntime {
   const content: Record<string, ConceptConfig | undefined> = { ...adapter.content };
   const adminPanels: AdminPanel[] = [];
@@ -26,7 +27,7 @@ export function composeRuntime(
   }
   return {
     siteName: adapter.siteName,
-    concepts: normalizeConcepts(content),
+    concepts: normalizeConcepts(content, urlPolicy),
     backend: adapter.backend,
     sender: adapter.sender,
     render: adapter.render,

package/src/lib/content/concepts.ts

@@ -3,7 +3,7 @@
 // (id, label, directory, concept-fixed routing, fields, validator) the admin reads. A
 // future Fragments concept attaches by adding one key under `content` and one routing
 // entry, with no reshape here.
-import type { ConceptConfig, ConceptDescriptor, RoutingRule } from './types.js';
+import type { ConceptConfig, ConceptDescriptor, ConceptUrlPolicy, RoutingRule } from './types.js';
 
 /**
  * Concept-fixed routing, keyed by concept id (spec §7.2). Posts are dated feed entries;
@@ -29,24 +29,28 @@ function defaultPermalink(id: string): string {
 }
 
 /**
- * Normalize an adapter's declared concepts into uniform descriptors (seam 1). Each declared
- * key under `content` becomes one descriptor; an undeclared (`undefined`) concept is
- * skipped. `routing` is injectable so a contract test can prove a new concept attaches
- * additively; production passes the default `CONCEPT_ROUTING`.
+ * Normalize an adapter's declared concepts into uniform descriptors (seam 1). URL policy
+ * (`permalink`, `datePrefix`) comes from the YAML site-config, passed here as `urlPolicy` keyed by
+ * concept id; each value defaults when the YAML omits it (`/:slug` for Pages, `/<id>/:slug`
+ * otherwise; `datePrefix` defaults to `day`). `routing` is injectable so a contract test can prove
+ * a new concept attaches additively; production passes the default `CONCEPT_ROUTING`.
  */
 export function normalizeConcepts(
   content: Record<string, ConceptConfig | undefined>,
+  urlPolicy: Record<string, ConceptUrlPolicy | undefined> = {},
   routing: Readonly<Record<string, RoutingRule>> = CONCEPT_ROUTING,
 ): ConceptDescriptor[] {
   const descriptors: ConceptDescriptor[] = [];
   for (const [id, config] of Object.entries(content)) {
     if (!config) continue;
+    const policy = urlPolicy[id] ?? {};
     descriptors.push({
       id,
       label: config.label ?? defaultLabel(id),
       dir: config.dir,
       routing: routing[id] ?? DEFAULT_ROUTING,
-      permalink: config.permalink ?? defaultPermalink(id),
+      permalink: policy.permalink ?? defaultPermalink(id),
+      datePrefix: policy.datePrefix ?? 'day',
       fields: config.fields,
       validate: config.validate,
     });

package/src/lib/content/ids.ts

@@ -36,3 +36,47 @@ export function slugify(title: string): string {
     .replace(/[^a-z0-9]+/g, '-')
     .replace(/^-+|-+$/g, '');
 }
+
+/** Filename date-prefix granularity for a dated concept: the leading `YYYY[-MM[-DD]]-` on the stem. */
+export type DatePrefix = 'year' | 'month' | 'day';
+
+/** The leading date-prefix shape for each granularity. */
+const DATE_PREFIX_RE: Record<DatePrefix, RegExp> = {
+  year: /^\d{4}-/,
+  month: /^\d{4}-\d{2}-/,
+  day: /^\d{4}-\d{2}-\d{2}-/,
+};
+
+/**
+ * The URL slug for an id. A dated concept passes its `datePrefix` and the leading date prefix is
+ * stripped when present; a non-dated concept passes `null` and the id is returned verbatim. Only
+ * the leading prefix is removed, so a year-like tail (a post titled "2024 Recap") stays in the slug.
+ */
+export function slugFromId(id: string, datePrefix: DatePrefix | null): string {
+  if (!datePrefix) return id;
+  return id.replace(DATE_PREFIX_RE[datePrefix], '');
+}
+
+/**
+ * Compose a dated entry's id from a `YYYY-MM-DD` date, a date-free slug, and the concept's
+ * granularity: the date truncated to the granularity, a hyphen, then the slug. Throws on a
+ * malformed date so a bad create fails before touching git.
+ */
+export function composeDatedId(date: string, slug: string, datePrefix: DatePrefix): string {
+  const m = date.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+  if (!m) throw new Error(`composeDatedId: malformed date "${date}"`);
+  const [, year, month, day] = m;
+  let prefix: string;
+  switch (datePrefix) {
+    case 'year':
+      prefix = year;
+      break;
+    case 'month':
+      prefix = `${year}-${month}`;
+      break;
+    case 'day':
+      prefix = `${year}-${month}-${day}`;
+      break;
+  }
+  return `${prefix}-${slug}`;
+}

package/src/lib/content/permalink.ts

@@ -20,10 +20,10 @@ function dateParts(date?: string): { year: string; month: string; day: string }
  */
 export function permalink(
   descriptor: ConceptDescriptor,
-  entry: { id: string; date?: string },
+  entry: { id: string; slug: string; date?: string },
 ): string {
   return descriptor.permalink.replace(/:(\w+)/g, (_match, token: string) => {
-    if (token === 'slug') return entry.id;
+    if (token === 'slug') return entry.slug;
     if (token === 'year' || token === 'month' || token === 'day') {
       const parts = dateParts(entry.date);
       if (!parts) {

package/src/lib/content/types.ts

@@ -8,6 +8,7 @@
 // descriptors are plain data so a `load` function can hand them across the server-to-client
 // boundary to the editor form.
 import type { ComponentRegistry } from '../render/registry.js';
+import type { DatePrefix } from './ids.js';
 
 /** Common to every frontmatter field: the frontmatter key, the form label, and whether it is required. */
 interface FieldBase {
@@ -84,13 +85,17 @@ export interface ConceptConfig {
   fields: FrontmatterField[];
   /** Validate submitted frontmatter before any commit. */
   validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
-  /**
-   * Public URL pattern for this concept, a `/`-prefixed string of literal segments and the
-   * tokens `:slug`, `:year`, `:month`, `:day`. `normalizeConcepts` fills a per-concept
-   * default when omitted (`/:slug` for Pages, `/<conceptId>/:slug` otherwise). The pattern
-   * must agree with the site's filesystem route directory.
-   */
+}
+
+/**
+ * A concept's URL policy, set per concept in the YAML site-config (not the adapter). `permalink` is
+ * a `/`-prefixed pattern of literal segments and the tokens `:slug`, `:year`, `:month`, `:day`.
+ * `datePrefix` is the filename date-prefix granularity for a dated concept. Both default in
+ * `normalizeConcepts` when omitted.
+ */
+export interface ConceptUrlPolicy {
   permalink?: string;
+  datePrefix?: DatePrefix;
 }
 
 /** The GitHub App backend a site reads from and commits to (spec §8). Plain data the GitHub engine (Plan 03) consumes. */
@@ -175,6 +180,8 @@ export interface ConceptDescriptor {
   routing: RoutingRule;
   /** The resolved permalink pattern, defaulted by `normalizeConcepts`. */
   permalink: string;
+  /** Filename date-prefix granularity for a dated concept; resolved by `normalizeConcepts`. */
+  datePrefix: DatePrefix;
   fields: FrontmatterField[];
   validate(frontmatter: Record<string, unknown>, body: string): ValidationResult;
 }

package/src/lib/delivery/content-index.ts

@@ -3,7 +3,7 @@
 // returns cheap plain-data summaries plus an on-demand detail lookup. It is concept-generic:
 // every operation reads the descriptor and its routing rule, never a hardcoded concept id.
 import { parseMarkdown } from '../content/frontmatter.js';
-import { idFromFilename } from '../content/ids.js';
+import { idFromFilename, slugFromId } from '../content/ids.js';
 import { permalink } from '../content/permalink.js';
 import { deriveExcerpt, wordCount } from './excerpt.js';
 import type { ConceptDescriptor } from '../content/types.js';
@@ -17,6 +17,7 @@ export interface RawFile {
 /** The cheap, plain-data view of one entry, for lists, feeds, and the sitemap. */
 export interface ContentSummary {
   id: string;
+  slug: string;
   permalink: string;
   title: string;
   date?: string;
@@ -70,11 +71,13 @@ function asTags(value: unknown): string[] {
 export function createContentIndex(files: RawFile[], descriptor: ConceptDescriptor): ContentIndex {
   const entries: ContentEntry[] = files.map((file) => {
     const id = idFromFilename(basename(file.path));
+    const slug = slugFromId(id, descriptor.routing.dated ? descriptor.datePrefix : null);
     const { frontmatter, body } = parseMarkdown(file.raw);
     const date = asDate(frontmatter.date);
     return {
       id,
-      permalink: permalink(descriptor, { id, date }),
+      slug,
+      permalink: permalink(descriptor, { id, slug, date }),
       title: asString(frontmatter.title) ?? id,
       date,
       updated: asDate(frontmatter.updated),

package/src/lib/delivery/site-index.ts

@@ -0,0 +1,68 @@
+// cairn-cms: the site-level content index (dated-slug design). It unions every concept's
+// per-concept index into one cross-concept resolver: a single byPermalink map a catch-all route
+// matches a request path against, one entries() list the prerenderer walks, and the per-concept
+// indexes for concept-scoped archive, tag, and feed loaders. A duplicate permalink throws at build.
+import type { ConceptDescriptor } from '../content/types.js';
+import type { ContentEntry, ContentIndex, ContentSummary } from './content-index.js';
+
+/** One concept's descriptor paired with its built index. */
+export interface ConceptIndex {
+  descriptor: ConceptDescriptor;
+  index: ContentIndex;
+}
+
+/** The cross-concept query surface a catch-all route and the sitemap read. */
+export interface SiteIndex {
+  /** Resolve a request path (with or without a trailing slash) to its entry, or undefined. */
+  byPermalink(path: string): ContentEntry | undefined;
+  /** Newer/older neighbors within the entry's own concept, for prev/next links. */
+  adjacent(entry: ContentSummary): { newer?: ContentSummary; older?: ContentSummary };
+  /** Every entry's path across concepts, leading slash stripped, for SvelteKit `[...path]` prerender. */
+  entries(): { path: string }[];
+  /** One concept's index, for its archive, tag, and feed loaders. */
+  concept(id: string): ContentIndex | undefined;
+  /** Every non-draft summary across concepts, for the site-wide sitemap. */
+  all(): ContentSummary[];
+}
+
+/** Strip a trailing slash from a path, keeping the root "/" intact. */
+function normalizePath(path: string): string {
+  return path.length > 1 ? path.replace(/\/+$/, '') : path;
+}
+
+/** Union per-concept indexes into a site-level resolver; throw on a duplicate permalink. */
+export function createSiteIndex(concepts: ConceptIndex[]): SiteIndex {
+  const byPath = new Map<string, { index: ContentIndex; id: string }>();
+  const byId = new Map<string, ContentIndex>();
+  for (const { descriptor, index } of concepts) {
+    byId.set(descriptor.id, index);
+    for (const summary of index.all()) {
+      const existing = byPath.get(summary.permalink);
+      if (existing) {
+        throw new Error(
+          `site index: "${existing.id}" and "${summary.id}" both resolve to "${summary.permalink}"`,
+        );
+      }
+      byPath.set(summary.permalink, { index, id: summary.id });
+    }
+  }
+  return {
+    byPermalink(path) {
+      const hit = byPath.get(normalizePath(path));
+      return hit ? hit.index.byId(hit.id) : undefined;
+    },
+    adjacent(entry) {
+      const hit = byPath.get(entry.permalink);
+      return hit ? hit.index.adjacent(entry.id) : {};
+    },
+    entries() {
+      return [...byPath.keys()].map((p) => ({ path: p.replace(/^\//, '') }));
+    },
+    concept(id) {
+      return byId.get(id);
+    },
+    all() {
+      return concepts.flatMap(({ index }) => index.all());
+    },
+  };
+}

package/src/lib/index.ts

@@ -23,6 +23,7 @@ export type {
   AssetConfig,
   RoutingRule,
   ConceptDescriptor,
+  ConceptUrlPolicy,
   CairnExtension,
   CairnRuntime,
   AdminPanel,
@@ -37,7 +38,15 @@ export {
   parseMarkdown,
 } from './content/frontmatter.js';
 export { validateFields } from './content/validate.js';
-export { isValidId, idFromFilename, filenameFromId, slugify } from './content/ids.js';
+export {
+  isValidId,
+  idFromFilename,
+  filenameFromId,
+  slugify,
+  slugFromId,
+  composeDatedId,
+} from './content/ids.js';
+export type { DatePrefix } from './content/ids.js';
 // Render engine (Plan 04): generic directive pipeline; sites own the component registry.
 export { defineRegistry } from './render/registry.js';
 export type { ComponentDef, ComponentRegistry } from './render/registry.js';
@@ -76,6 +85,7 @@ export type { GithubKeyEnv } from './github/credentials.js';
 // Nav tree and site-config helpers (Plan 06).
 export {
   parseSiteConfig,
+  urlPolicyFrom,
   extractMenu,
   setMenu,
   validateNavTree,
@@ -96,6 +106,8 @@ export type {
   ContentEntry,
   ContentIndex,
 } from './delivery/content-index.js';
+export { createSiteIndex } from './delivery/site-index.js';
+export type { SiteIndex, ConceptIndex } from './delivery/site-index.js';
 export { deriveExcerpt, wordCount } from './delivery/excerpt.js';
 export { buildRssFeed, buildJsonFeed } from './delivery/feeds.js';
 export type { FeedChannel, FeedItem } from './delivery/feeds.js';

package/src/lib/nav/site-config.ts

@@ -3,6 +3,7 @@
 // commits the file back through the GitHub-App pipeline. This module is pure: parse, validate, and
 // rewrite only. The engine returns data; each site renders the tree with its own markup.
 import { parse as parseYaml, parseDocument } from 'yaml';
+import type { ConceptUrlPolicy } from '../content/types.js';
 
 /** One navigation node. An omitted or empty `url` is a label-only grouping header; no `children` is a leaf. */
 export interface NavNode {
@@ -78,6 +79,8 @@ export interface SiteConfig {
   locale?: string;
   /** Named navigation menus, each a NavNode[] (normalized by extractMenu). */
   menus?: Record<string, unknown>;
+  /** Per-concept URL policy: the permalink pattern and date-prefix granularity, keyed by concept id. */
+  content?: Record<string, ConceptUrlPolicy>;
   [key: string]: unknown;
 }
 
@@ -108,6 +111,11 @@ export function extractMenu(config: SiteConfig, name: string, maxDepth: number):
   return validateNavTree(menu, maxDepth);
 }
 
+/** The per-concept URL policy from a parsed config, or an empty policy when the `content` key is absent. */
+export function urlPolicyFrom(config: SiteConfig): Record<string, ConceptUrlPolicy> {
+  return config.content ?? {};
+}
+
 /**
  * Replace one named menu in the YAML site-config text and reserialize, preserving every other
  * top-level key (siteName, other menus, settings). Parses into a Document so the rest of the file

package/src/lib/sveltekit/content-routes.ts

@@ -5,7 +5,7 @@
 import { redirect, error } from '@sveltejs/kit';
 import { findConcept } from '../content/concepts.js';
 import { frontmatterFromForm, parseMarkdown, dateInputValue, serializeMarkdown } from '../content/frontmatter.js';
-import { isValidId, slugify, filenameFromId } from '../content/ids.js';
+import { isValidId, slugify, filenameFromId, composeDatedId } from '../content/ids.js';
 import { appCredentials, type GithubKeyEnv } from '../github/credentials.js';
 import { listMarkdown, readRaw, commitFile } from '../github/repo.js';
 import { installationToken } from '../github/signing.js';
@@ -153,22 +153,32 @@ export function createContentRoutes(runtime: CairnRuntime, deps: ContentRoutesDe
     }
   }
 
-  /** Create a new entry: validate the slug, refuse to clobber, and redirect to the editor. */
+  /** Create a new entry: validate the slug, compose a dated id when the concept is dated, refuse to clobber. */
   async function createAction(event: ContentEvent): Promise<never> {
     sessionOf(event);
     const concept = conceptOf(runtime, event.params);
     const form = await event.request.formData();
-    const raw = String(form.get('slug') ?? '').trim() || slugify(String(form.get('title') ?? ''));
+    const slug = String(form.get('slug') ?? '').trim() || slugify(String(form.get('title') ?? ''));
+    const date = String(form.get('date') ?? '').trim();
     const bounce = (msg: string): never => {
       throw redirect(303, `/admin/${concept.id}?error=${encodeURIComponent(msg)}`);
     };
-    if (!isValidId(raw)) bounce('Enter a valid slug: lowercase letters, numbers, and hyphens.');
+    if (!isValidId(slug)) return bounce('Enter a valid slug: lowercase letters, numbers, and hyphens.');
+
+    let id = slug;
+    if (concept.routing.dated) {
+      if (!/^\d{4}-\d{2}-\d{2}$/.test(date)) return bounce('Pick a date for this entry.');
+      if (/^\d{4}-/.test(slug)) {
+        return bounce('Leave the date out of the slug; set it in the date field.');
+      }
+      id = composeDatedId(date, slug, concept.datePrefix);
+    }
 
     const token = await mintToken(event.platform?.env ?? {});
-    const existing = await readRaw(runtime.backend, `${concept.dir}/${filenameFromId(raw)}`, token);
-    if (existing !== null) bounce('An entry with that slug already exists.');
+    const existing = await readRaw(runtime.backend, `${concept.dir}/${filenameFromId(id)}`, token);
+    if (existing !== null) return bounce('An entry with that slug already exists.');
 
-    throw redirect(303, `/admin/${concept.id}/${raw}?new=1`);
+    throw redirect(303, `/admin/${concept.id}/${id}?new=1`);
   }
 
   /** Coerce parsed frontmatter to the form-ready values the editor inputs expect. */