[Madraka]

RFC-0038 / ADR-0040, step 1 of 3. There is no behaviour change: with no collections set, every entry URL is exactly what it was. Refs #50.

Contract

• Site.collections.<key>.permalink: a template with a closed token set; v1 is fixed lower-case segments plus /{slug} (schema pattern).
• Fixtures: valid/site/collection-permalinks.json; invalid/site/permalink-{trailing-slash,unknown-token,without-slug}.json. TS and Rust regenerated.

One function each way (@cloudhal/core-ts, browser-safe ./permalinks subpath)

• entryPath(site, entry) and entryAt(site, path) (longest configured prefix first; a moved collection no longer answers at its old prefix), plus collectionPermalink and permalinkPrefix.

Every caller moved

About 35 inline /${collection}/${slug} copies and the renderer's one-argument entryPath(entry):

• renderer: routes and resolvePath (now through entryAt), SEO, feeds, previews, surfaces, navigation, comments;
• starter: routes and theme components;
• core-ts: automations, search rows, site search, and the store's automatic redirect;
• API: assets, menus, search, comments;
• MCP: analytics reports, comments, search, schedules (release-titles.ts split out for the size ratchet);
• CLI: analytics;
• Studio: EntryPath / useSitePermalinks and the slug field prefix.

Themes without a Site in hand get the templates through MediaContext.permalinks.

A few callers that had only a site id now read the site once (in parallel where possible): releaseView, commentEntries, CLI publishedNodes, and planSearch (it reads the site node once).

Checks (run per package, sequentially)

Package	Tests
core-ts	630/630 (incl. new permalinks.test.ts)
astro-renderer	255/255
api	371/371
mcp-server	140/140
Studio	1138/1138
core-contracts	444/444
cli (e2e, analytics)	15/15

Also passing: Rust tests, clippy, typecheck everywhere, design lint, and the size ratchet (the baseline only went down).

Next steps

• Step 2: prefix redirects on template change, overlap checks, and reindexing search hrefs when a template changes.
• Step 3: the Studio "Collections" settings and the MCP set_collection_permalink tool (with approval).

🤖 Generated with Claude Code