create-ailk 0.20.0 → 0.22.0

package/README.md

@@ -250,6 +250,14 @@ hand-authored translations, so `sync-routes` reports a missing namespace
 rather than attempting to merge JSON keys into it. Adding it is a manual
 step, same as reading any other reported gap.
 
+The site's structured-data test (`apps/web/lib/__tests__/structured-data.test.tsx`)
+fails any route that neither renders through `renderPage` nor is listed in its
+`NO_STRUCTURED_DATA_ROUTES`. When `--apply` adds a route the template exempts
+there and the site has edited that test (its bytes differ from the hash in
+`.ailk-template-files.json`), the report prints the exact template entry to
+add for each added route, under `Also required`. The test itself is never
+written; an untouched copy is `create-ailk update`'s to bring forward.
+
 **The manifest.** `ROUTE_SINCE` in `src/surfaces.ts` maps every template route
 directory (relative to `apps/web/app/[locale]`) to the `@working-theory/*`
 fixed-group release line that first shipped it — the version a site pins, so
@@ -289,7 +297,7 @@ merge-file` against the recorded version's own copy as the base. A clean
   merge keeps your edit AND the fix, and is reported as **Merged**. A
   conflict leaves the file exactly as it was — never written with conflict
   markers — and is reported under **Needs review** with both versions
-  named; nothing else in the run is held back by it.
+  named.
 - A recordable file the running version adds that the site lacks is
   **Added**, unless it sits under a route or directory the site deliberately
   does not carry (a gated-off surface, a spoke exclusion, or a directory you
@@ -301,6 +309,18 @@ recorded (a module bundle's own file, say) when its bytes differ from the
 running copy. Nothing the base scaffold did not write is ever touched. No
 template change at all means `Already up to date` and zero files written.
 
+**Tests are held back with the file they test.** When a file is left under
+**Needs review** or **Skipped**, every template test file that imports it by a
+relative import (`relay.test.ts` importing `../relay`, say) stays exactly as
+the site has it, and its record entry keeps its old hash and version — so a
+run never leaves a test from the new version exercising code from the old
+one. Each is reported under a **Held back with `<file>`** heading. Reconcile
+the file, then run `update` again to bring its tests forward; every other
+file in the run still updates. A held test-support file (`__tests__/fixtures.ts`,
+say) holds the tests importing it in turn. A file skipped because you deleted
+it keeps its tests held on every run: delete those tests too, or restore the
+file.
+
 **A site scaffolded before this record existed** gets one built on its first
 `update` run, from the `patternVersion` `.ailk-site-manifest.json` already
 records — no separate command, no per-site setup. If that version predates

package/component-catalog.json

@@ -9,7 +9,7 @@
       "importPath": "@working-theory/ui/sections",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/sections",
-      "count": 55
+      "count": 56
     },
     {
       "name": "blocks",
@@ -17,7 +17,7 @@
       "importPath": "@working-theory/ui/blocks",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/blocks",
-      "count": 101
+      "count": 107
     },
     {
       "name": "chrome",
@@ -25,7 +25,7 @@
       "importPath": "@working-theory/ui/chrome",
       "rootBarrel": "@working-theory/ui",
       "sourceRoot": "packages/ui/src/chrome",
-      "count": 18
+      "count": 19
     },
     {
       "name": "primitives",
@@ -89,7 +89,7 @@
       "importPath": "@working-theory/ui-scheduling",
       "rootBarrel": "@working-theory/ui-scheduling",
       "sourceRoot": "packages-paid/ui-scheduling/src/blocks",
-      "count": 5
+      "count": 6
     },
     {
       "name": "signal-collectors-sections",
@@ -485,6 +485,17 @@
       "descriptionGrade": "strong",
       "sectionType": "items"
     },
+    {
+      "name": "ItemsTileLinkIsland",
+      "tier": "sections",
+      "sourcePath": "packages/ui/src/sections/ItemsTileLinkIsland.tsx",
+      "importPath": "@working-theory/ui/sections",
+      "exported": false,
+      "description": "Makes a whole linked tile card its link's click target.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "LogoCloud",
       "tier": "sections",
@@ -826,6 +837,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "AuthBackLink",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/AuthBackLink.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "The auth shell's top-start \"← Back to <site>\". A hub's sign-in page renders it when the visitor arrived from a registered spoke, so the cross-domain handoff names where they came from and gives them the way back.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "AuthCard",
       "tier": "blocks",
@@ -892,6 +914,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "BlogSidebarBox",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/BlogSidebarBox.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "Heading + text + one outlined button, authored on the blog index page's own content. Content is set on the blog index page's own frontmatter, never hard-coded.",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "BrandLogo",
       "tier": "blocks",
@@ -1453,6 +1486,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "PostArchiveRow",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/PostArchiveRow.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "One \"Previous posts\" row: title link + meta, host-placed `Separator` between rows. Draws no divider of its own (border convention — the host places `Separator` between rows, as BlogList already does for PostRow).",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "PostCard",
       "tier": "blocks",
@@ -1464,6 +1508,17 @@
       "descriptionGrade": "weak",
       "sectionType": null
     },
+    {
+      "name": "PostMetaLine",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/PostMetaLine.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "`<tag> · <date>` meta line, either half optional (C4). Shows the tag alone, the date alone, or both joined by a middot; renders nothing with neither.",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "PostRow",
       "tier": "blocks",
@@ -1475,6 +1530,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "PostTeaser",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/PostTeaser.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "The featured post (`size=\"lg\"`) and \"Latest posts\" grid card (`size=\"md\"`); no cover renders no placeholder. Composes MediaFigure + PostMetaLine + primitives. No author byline (C7). RSC: no hooks or browser APIs.",
+      "descriptionSource": "barrel",
+      "descriptionGrade": "weak",
+      "sectionType": null
+    },
     {
       "name": "PricingExtraTierRow",
       "tier": "blocks",
@@ -1750,6 +1816,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "TopicChips",
+      "tier": "blocks",
+      "sourcePath": "packages/ui/src/blocks/TopicChips.tsx",
+      "importPath": "@working-theory/ui/blocks",
+      "exported": true,
+      "description": "\"All\" plus one chip per tag, each a real server-rendered link — never a client-side filter — with the current page's chip marked `aria-current=\"page\"` / `data-current=\"true\"` in the served HTML. Composes Button (asChild) + Link; RSC, no client state.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "weak",
+      "sectionType": null
+    },
     {
       "name": "UpgradeDialog",
       "tier": "blocks",
@@ -1959,6 +2036,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "NavBackLink",
+      "tier": "chrome",
+      "sourcePath": "packages/ui/src/chrome/NavBackLink.tsx",
+      "importPath": "@working-theory/ui/chrome",
+      "exported": true,
+      "description": "The bare header's back arrow, deck-return-aware.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "weak",
+      "sectionType": null
+    },
     {
       "name": "NavMobileMenu",
       "tier": "chrome",
@@ -3235,6 +3323,17 @@
       "descriptionGrade": "strong",
       "sectionType": null
     },
+    {
+      "name": "BookingProfileHeader",
+      "tier": "scheduling-blocks",
+      "sourcePath": "packages-paid/ui-scheduling/src/blocks/BookingProfileHeader.tsx",
+      "importPath": "@working-theory/ui-scheduling",
+      "exported": true,
+      "description": "The /meet hub's opening header. The Cal.com / Calendly profile shape: whose calendar this is, then one line saying what to do here. A centered portrait over a single h1, and nothing beneath it — the booker cards below carry each event's own title, so a subtitle here would only repeat them.",
+      "descriptionSource": "doc-comment",
+      "descriptionGrade": "strong",
+      "sectionType": null
+    },
     {
       "name": "FlowStepper",
       "tier": "signal-collectors-sections",
@@ -5109,6 +5208,10 @@
           },
           "columns": {
             "anyOf": [
+              {
+                "type": "number",
+                "const": 1
+              },
               {
                 "type": "number",
                 "const": 2
@@ -5301,6 +5404,9 @@
           "headline": {
             "type": "string"
           },
+          "subtitle": {
+            "type": "string"
+          },
           "body": {
             "type": "string"
           },
@@ -6660,6 +6766,20 @@
                 },
                 "annualBadge": {
                   "type": "string"
+                },
+                "priceSubheadAccent": {
+                  "type": "string"
+                },
+                "priceSubheadAccentTone": {
+                  "type": "string",
+                  "enum": [
+                    "default",
+                    "muted",
+                    "brand",
+                    "success",
+                    "danger",
+                    "warning"
+                  ]
                 }
               },
               "required": [
@@ -6878,6 +6998,20 @@
               },
               "annualBadge": {
                 "type": "string"
+              },
+              "priceSubheadAccent": {
+                "type": "string"
+              },
+              "priceSubheadAccentTone": {
+                "type": "string",
+                "enum": [
+                  "default",
+                  "muted",
+                  "brand",
+                  "success",
+                  "danger",
+                  "warning"
+                ]
               }
             },
             "required": [
@@ -9045,7 +9179,8 @@
             "enum": [
               "with-testimonial",
               "split-with-pattern",
-              "card"
+              "card",
+              "column"
             ]
           },
           "pattern": {
@@ -9733,11 +9868,68 @@
               "baseUrl"
             ]
           },
+          "topics": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "label": {
+                  "type": "string"
+                },
+                "href": {
+                  "type": "string"
+                },
+                "current": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "label",
+                "href"
+              ]
+            }
+          },
+          "sidebar": {
+            "maxItems": 3,
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "heading": {
+                  "type": "string"
+                },
+                "text": {
+                  "type": "string"
+                },
+                "cta": {
+                  "type": "object",
+                  "properties": {
+                    "label": {
+                      "type": "string"
+                    },
+                    "href": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "label",
+                    "href"
+                  ]
+                }
+              },
+              "required": [
+                "heading",
+                "text",
+                "cta"
+              ]
+            }
+          },
           "variant": {
             "type": "string",
             "enum": [
               "list",
-              "grid"
+              "grid",
+              "index"
             ]
           }
         },
@@ -11999,7 +12191,7 @@
       "groups": [
         {
           "name": "colors",
-          "leafCount": 62,
+          "leafCount": 64,
           "leaves": [
             {
               "path": "colors.light.bg",
@@ -12021,6 +12213,11 @@
               "type": "string",
               "value": "#475569"
             },
+            {
+              "path": "colors.light.link",
+              "type": "string",
+              "value": "#2563eb"
+            },
             {
               "path": "colors.light.textMuted",
               "type": "string",
@@ -12176,6 +12373,11 @@
               "type": "string",
               "value": "#94a3b8"
             },
+            {
+              "path": "colors.dark.link",
+              "type": "string",
+              "value": "#60a5fa"
+            },
             {
               "path": "colors.dark.textMuted",
               "type": "string",
@@ -13009,7 +13211,7 @@
         },
         {
           "name": "spacing",
-          "leafCount": 13,
+          "leafCount": 15,
           "leaves": [
             {
               "path": "spacing.controlX",
@@ -13056,6 +13258,16 @@
               "type": "string",
               "value": "1rem"
             },
+            {
+              "path": "spacing.deckLabelLine",
+              "type": "string",
+              "value": "var(--spacing-section-lg)"
+            },
+            {
+              "path": "spacing.deckActionLine",
+              "type": "string",
+              "value": "calc(2 * (var(--control-height-big) + var(--spacing-block-tight)))"
+            },
             {
               "path": "spacing.paragraph",
               "type": "string",

package/component-catalog.md

@@ -15,13 +15,13 @@ The component inventory of `@working-theory/ui` and the shells of `@working-theo
 3. Check the Primitives, Panels and Shells tables too — a low-level control, a collapsible layout container, or a route-level frame lives there, not under Sections or Blocks.
 4. Only then build. If you do build, you are declaring the capability is genuinely absent.
 
-Inventory: **311 component files** across 16 tiers — 55 sections, 101 blocks, 18 chrome, 79 primitives, 6 panels, 8 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 5 scheduling-blocks, 5 signal-collectors-sections, 9 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 308 distinct names: `SchedulerEmbed`, `Separator`, `Tabs` exist in more than one tier as genuinely different components, listed once per tier with its own source path.
+Inventory: **320 component files** across 16 tiers — 56 sections, 107 blocks, 19 chrome, 79 primitives, 6 panels, 8 shells, 5 docs-blog-blocks, 1 docs-blog-chrome, 2 docs-blog-shells, 2 scheduling-sections, 6 scheduling-blocks, 5 signal-collectors-sections, 9 signal-collectors-blocks, 2 commerce-sections, 12 commerce-blocks, 1 commerce-panels. 317 distinct names: `SchedulerEmbed`, `Separator`, `Tabs` exist in more than one tier as genuinely different components, listed once per tier with its own source path.
 
-Description coverage: **307/311** components carry a capability description derived from source — 44 from the section registry's hand-authored when-to-use text, 232 from the component's own doc-comment header, 31 from its tier barrel's roster line. **4** have none; they are listed under [Undescribed components](#undescribed-components) rather than given a sentence invented from their name.
+Description coverage: **316/320** components carry a capability description derived from source — 44 from the section registry's hand-authored when-to-use text, 237 from the component's own doc-comment header, 35 from its tier barrel's roster line. **4** have none; they are listed under [Undescribed components](#undescribed-components) rather than given a sentence invented from their name.
 
-Of those, **276** are *strong* — a capability sentence you could match a requirement against — and **31** are *weak*: either one short clause, or a long one that spends itself on wiring (client boundaries, class names, which primitives it composes) instead of on what the thing is for. Weak rows are marked `(weak)` and listed in full under [Weak descriptions](#weak-descriptions). Coverage is 99%, but **findable-without-luck coverage is 89%**.
+Of those, **282** are *strong* — a capability sentence you could match a requirement against — and **34** are *weak*: either one short clause, or a long one that spends itself on wiring (client boundaries, class names, which primitives it composes) instead of on what the thing is for. Weak rows are marked `(weak)` and listed in full under [Weak descriptions](#weak-descriptions). Coverage is 99%, but **findable-without-luck coverage is 88%**.
 
-Per tier, strong out of total: **Sections** 54/55 · **Blocks** 95/101 · **Chrome** 10/18 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 7/8 · **Docs + Blog Blocks** 5/5 · **Docs + Blog Chrome** 1/1 · **Docs + Blog Shells** 0/2 · **Scheduling Sections** 2/2 · **Scheduling Blocks** 5/5 · **Signal-Collectors Sections** 5/5 · **Signal-Collectors Blocks** 8/9 · **Commerce Sections** 2/2 · **Commerce Blocks** 12/12 · **Commerce Panels** 1/1. A tier low on this line is a tier where a capability search is most likely to come up empty on something that exists.
+Per tier, strong out of total: **Sections** 55/56 · **Blocks** 99/107 · **Chrome** 10/19 · **Primitives** 64/79 (4 undescribed) · **Panels** 5/6 · **Shells** 7/8 · **Docs + Blog Blocks** 5/5 · **Docs + Blog Chrome** 1/1 · **Docs + Blog Shells** 0/2 · **Scheduling Sections** 2/2 · **Scheduling Blocks** 6/6 · **Signal-Collectors Sections** 5/5 · **Signal-Collectors Blocks** 8/9 · **Commerce Sections** 2/2 · **Commerce Blocks** 12/12 · **Commerce Panels** 1/1. A tier low on this line is a tier where a capability search is most likely to come up empty on something that exists.
 
 That grade is **mechanical**. It counts what it can measure — how much a description adds beyond the component's own name, how much of it is spent on wiring, whether the extraction came out damaged — and it cannot tell a fluent paragraph about the wrong subject from a useful one. A person reading these tables will find more rows unusable than the weak count admits. Treat it as a floor on the problem, not a measurement of it, and read the source before concluding a capability is absent.
 
@@ -53,7 +53,7 @@ The left column is search vocabulary — how a person phrases the need. It is ha
 
 ---
 
-## Sections (55)
+## Sections (56)
 
 Page-level content bands. Most are MDX-driven (authored by `type` in page frontmatter and dispatched by `SectionRenderer`); a few are composed directly in a route.
 
@@ -93,6 +93,7 @@ Import: `import { X } from "@working-theory/ui/sections";` (or from the `@workin
 | `HeroPromptCapture` | The Hero `promptCapture` opt-in's wiring. Composes the two new blocks — `PromptCaptureCard` (the chat-style card) and `SuggestionChipCarousel` (the one-expanded-slot chip row) — and owns the ONE piece of state they share: the typed text. A chip click writes into it; the card renders and edits it; submit carries it onward. | `import { HeroPromptCapture } from "@working-theory/ui/sections"` |
 | `HeroQuickSearch` | Surfaces the existing ⌘K quick-search as an inline trigger inside the hero CTA cluster (Chassis 2). It does NOT re-roll a search input: it composes the SearchInputTrigger primitive (an input-style control at CTA height) plus the Command palette primitive, so there is ONE search mechanism. The nav's compact 24px ⌘K pill stays as-is — the hero reads as a search INPUT, matching the 44px "Get Started" CTA. | internal — compose from `packages/ui/src/sections/HeroQuickSearch.tsx` |
 | `Items` | A general-purpose card/items grid — use for services, use cases, or any homogeneous list of cards. | MDX `type: items` · `import { Items } from "@working-theory/ui/sections"` |
+| `ItemsTileLinkIsland` | Makes a whole linked tile card its link's click target. | internal — compose from `packages/ui/src/sections/ItemsTileLinkIsland.tsx` |
 | `LogoCloud` | A customer/partner logo wall — use for trust-by-association social proof. | MDX `type: logoCloud` · `import { LogoCloud } from "@working-theory/ui/sections"` |
 | `MDXContent` | The keystone the docs route and blog both render their compiled MDX through. | `import { MDXContent } from "@working-theory/ui/sections"` |
 | `MediaBand` | A single full-width image band — use for the 1-up visual moment Gallery's 2-column minimum can't express (e.g. between pricing plan columns); renders a labeled placeholder until a real image is supplied. | MDX `type: media-band` · `import { MediaBand } from "@working-theory/ui/sections"` |
@@ -119,7 +120,7 @@ Import: `import { X } from "@working-theory/ui/sections";` (or from the `@workin
 
 ---
 
-## Blocks (101)
+## Blocks (107)
 
 Intermediate composition tiles — the pieces sections are built from. Compose primitives and panels; never import a section.
 
@@ -135,12 +136,14 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `AskAiCommandGroup` | The ⌘K palette's composable "Ask AI" group; one CommandItem per provider seeding "About <entity>: <query>" (or the entity promptText when the query is empty); composed by the consumer's own CommandDialog. | `import { AskAiCommandGroup } from "@working-theory/ui/blocks"` |
 | `AskAiProviderRow` | The ONE shared provider-link row every ask-AI placement composes — the AskAi section (band + ticker variant) and the Hero `askAi` opt-in all render THIS block, never a per-placement fork. Renders a bounded set of five measured providers, each a deep link seeded with an AUTHORED `promptText` — the prompt is always consumer-supplied data, never derived from page context (headline, entity name, etc.). | `import { AskAiProviderRow } from "@working-theory/ui/blocks"` |
 | `AssetLightbox` | The asset detail lightbox: the image with zoom on the stage, a Details rail with in-place pencil-edit Title and Description, then Filename/Type/Size/Dimensions/Created, then Tags (from the seeded set the caller passes), then Copy link/Replace/Delete. Renders inside a ResponsiveSheet — the SAME field sequence in both layouts (: one field array, walked once, shared by both). | `import { AssetLightbox } from "@working-theory/ui/blocks"` |
+| `AuthBackLink` | The auth shell's top-start "← Back to <site>". A hub's sign-in page renders it when the visitor arrived from a registered spoke, so the cross-domain handoff names where they came from and gives them the way back. | `import { AuthBackLink } from "@working-theory/ui/blocks"` |
 | `AuthCard` | Multi-flow auth card: sign-in, sign-up, invitation, forgot, reset and sent, from one skeleton. One self-contained card renders every auth surface a site needs: signing in, signing up, a closed sign-up that requires an invitation, requesting a password reset, choosing a new password, and the check-your-email state that follows a magic link or a reset request. | `import { AuthCard } from "@working-theory/ui/blocks"` |
 | `AwardBadgePlaceholder` | The labeled placeholder an Awards badge slot renders when no image has been supplied — mirrors MediaPlaceholder's role but in an award-chevron/ laurel badge silhouette rather than a generic photo frame, since an unfilled award slot should read as "an award badge goes here," not "a photo goes here." The shape (a laurel-flanked medallion over a chevron ribbon) is a hand-drawn SVG outline — never a copied G2/Capterra/Apollo asset. | internal — compose from `packages/ui/src/blocks/AwardBadgePlaceholder.tsx` |
 | `BackgroundPattern` | Decorative SVG dot-grid / line pattern for ContactForm section. Decorative block (generalized beyond its original single consumer). Renders an absolutely-positioned decoration behind a section's content. Originally the pattern anchored behind ContactForm's form column; SpotlightPanel composes it as a full-bleed section backdrop (dimmed + blurred, behind a centered card) — same block, a second placement. | `import { BackgroundPattern } from "@working-theory/ui/blocks"` |
 | `BadgeRow` | Horizontal cluster of static badge labels used by Hero and Feature section families for `data.badge` and tag-list patterns. | `import { BadgeRow } from "@working-theory/ui/blocks"` |
 | `BillingToggle` | Monthly / Annual billing period toggle for the Pricing section. Purely presentational — click handlers come from the parent (Pricing section). No "use client" needed at the block level; the parent Pricing section is "use client" and passes the callbacks down. | `import { BillingToggle } from "@working-theory/ui/blocks"` |
 | `BlogPostHeader` | Layout: the better-auth sticky left rail — eyebrow ← back-link · decorative title · author byline · date/reading-time meta · tags. Per the title here is DECORATIVE (aria-hidden): the semantic `<h1>` is rendered atop the right content column by `BlogPost` (bodyOnly), so the page keeps exactly one heading. | `import { BlogPostHeader } from "@working-theory/ui/blocks"` |
+| `BlogSidebarBox` | Heading + text + one outlined button, authored on the blog index page's own content. Content is set on the blog index page's own frontmatter, never hard-coded. | `import { BlogSidebarBox } from "@working-theory/ui/blocks"` |
 | `BrandLogo` | Brand identity lockup (mark + wordmark + badge slot) as a home link. Brand identity lockup for Nav, Footer, and other surfaces. | `import { BrandLogo } from "@working-theory/ui/blocks"` |
 | `Card` | The base surface-chrome block the section tier composes instead of hand-rolling `rounded + hairline border + surface + p-card` (7× duplicated at time). A block owns its visual identity: it looks the same everywhere it is composed, and a higher tier SELECTS a look via `variant` — it never patches via className. | `import { Card } from "@working-theory/ui/blocks"` |
 | `ChoiceCard` | Onboarding "Is this you?" disambiguation card — reimplements the ploy.ai persona-disambiguation capture: a researched candidate option vs a "none of these are me" option, confirmed by the user ("a human-input seam the user answers to orient the agent"). Purely presentational and props-driven: renders options + an optional "none of these" option + a confirm action, disabled until a selection is made. | `import { ChoiceCard } from "@working-theory/ui/blocks"` |
@@ -193,8 +196,11 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `PageHeaderSwitcher` | Header-owned context-switcher island (DropdownMenu-backed). Header-owned segment switcher rendered inside PageHeader's `switcher` slot. Composes DropdownMenu (Radix-backed — positioning, click-outside, Escape, focus management, and roving keyboard nav all come for free). | `import { PageHeaderSwitcher } from "@working-theory/ui/blocks"` |
 | `PairingCard` | Quiet card naming a matched WaitlistRecommendation pairing: both resolved offer names + the resolved reason, joined against a caller-supplied offers[] by key. | `import { PairingCard } from "@working-theory/ui/blocks"` |
 | `PhoneNumberField` | Single-box combo phone input for the "tel" field kind (supersedes the two-segment country-Select + number-Input layout). | `import { PhoneNumberField } from "@working-theory/ui/blocks"` |
+| `PostArchiveRow` | One "Previous posts" row: title link + meta, host-placed `Separator` between rows. Draws no divider of its own (border convention — the host places `Separator` between rows, as BlogList already does for PostRow). | `import { PostArchiveRow } from "@working-theory/ui/blocks"` |
 | `PostCard` | Same props as PostRow, a vertical arrangement. A single linked blog-index card (cover · date · reading time · title · excerpt · "Read more"). Tier 3 block; composes MediaFigure + primitives. RSC default. *(weak)* | `import { PostCard } from "@working-theory/ui/blocks"` |
+| `PostMetaLine` | `<tag> · <date>` meta line, either half optional (C4). Shows the tag alone, the date alone, or both joined by a middot; renders nothing with neither. | `import { PostMetaLine } from "@working-theory/ui/blocks"` |
 | `PostRow` | A single horizontal row in the two-column blog index: a landscape cover thumbnail (left) followed by the post's title · excerpt · author+date meta · tag list. The WHOLE row is one link (aria-labelled by the title, so screen readers announce the post title rather than the concatenated row content). | `import { PostRow } from "@working-theory/ui/blocks"` |
+| `PostTeaser` | The featured post (`size="lg"`) and "Latest posts" grid card (`size="md"`); no cover renders no placeholder. Composes MediaFigure + PostMetaLine + primitives. No author byline (C7). RSC: no hooks or browser APIs. *(weak)* | `import { PostTeaser } from "@working-theory/ui/blocks"` |
 | `PricingExtraTierRow` | Compact horizontal extra-tier row for the Pricing 'two-tiers-with-extra-tier' variant. Renders plan name + description on the left and a CTA on the right. Structurally different from PricingTierCard (no price display in this variant). | `import { PricingExtraTierRow } from "@working-theory/ui/blocks"` |
 | `PricingTierCard` | Single pricing tier card (all 4 Pricing variants). Renders a single pricing tier: plan name + optional badge, description, price display, CTA button, and feature checklist. | `import { PricingTierCard } from "@working-theory/ui/blocks"` |
 | `PricingTierCardFeaturesDisclosure` | Phone-breakpoint (<md, 768px — the same phone/tablet step CardGrid's own mobile-stacking ramp uses) presentation of a tier card's feature list: collapsed behind a disclosure button so price + CTA (which render ABOVE this row, see PricingTierCard's row-slot ordering) fit the first card view on a phone — the wisprflow.ai/pricing pattern. `md` and up renders the SAME feature list, always expanded, in a second, non-interactive tree — desktop/tablet is unaffected by the collapse. | `import { PricingTierCardFeaturesDisclosure } from "@working-theory/ui/blocks"` |
@@ -220,6 +226,7 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 | `TableOfContents` | The shared "On this page" rail consumed by the docs shell and the blog post layout (do not couple it to docs-only context). Renders a flat list of heading anchors and scroll-spies the heading currently in view, highlighting the matching item. | `import { TableOfContents } from "@working-theory/ui/blocks"` |
 | `TeamMemberCard` | Renders one team member in either of two layout modes: 'inline' — small circular avatar left + name/role right (with-small-images variant) 'stacked' — large circular avatar top + name/role/social-links below (with-large-images variant). | `import { TeamMemberCard } from "@working-theory/ui/blocks"` |
 | `TestimonialAside` | For ContactForm 'with-testimonial' variant. Rating (optional 0–5): rendered via Rating primitive with accessible label. avatar (optional): composed via Avatar + AvatarFallback + AvatarImage (initials fallback). | `import { TestimonialAside } from "@working-theory/ui/blocks"` |
+| `TopicChips` | "All" plus one chip per tag, each a real server-rendered link — never a client-side filter — with the current page's chip marked `aria-current="page"` / `data-current="true"` in the served HTML. Composes Button (asChild) + Link; RSC, no client state. *(weak)* | `import { TopicChips } from "@working-theory/ui/blocks"` |
 | `UpgradeDialog` | A plan-comparison dialog a consumer opens when an entitlement gates an action — controlled by default (open/onOpenChange are the primary interface; `trigger` is optional, since both known consumers open it from a menu row rather than an inline trigger). | `import { UpgradeDialog } from "@working-theory/ui/blocks"` |
 | `UserBlock` | Position-agnostic identity/account trigger block: avatar + primary label + optional secondary line, with density/affordance/collapsed/truncation variants. A single focusable button-rooted element that forwardRef's + spreads props so DropdownMenuTrigger asChild (AccountMenu) can clone it as its trigger anchor. | `import { UserBlock } from "@working-theory/ui/blocks"` |
 | `VerifyCodeField` | Presentational code-entry unit for StepFlow's `verify` step type: a status line ("We sent a code to…"), a 6-digit numeric code Field, and a resend link. Composes existing Field/Input/Button/Text primitives — no bespoke markup, no new primitive. | `import { VerifyCodeField } from "@working-theory/ui/blocks"` |
@@ -231,7 +238,7 @@ Import: `import { X } from "@working-theory/ui/blocks";` (or from the `@working-
 
 ---
 
-## Chrome (18)
+## Chrome (19)
 
 Persistent framing UI that wraps page content — navigation, footers, sidebars, banners. Not MDX-driven.
 
@@ -249,6 +256,7 @@ Import: `import { X } from "@working-theory/ui/chrome";` (or from the `@working-
 | `FloatingCta` | Persistent fixed corner action pill. *(weak)* | `import { FloatingCta } from "@working-theory/ui/chrome"` |
 | `Footer` | Site footer server component with secondary nav links. Label resolution order for navItems labels. Resolved labels are passed into FooterNav as pre-resolved strings — no duplicated resolution logic across variants. | `import { Footer } from "@working-theory/ui/chrome"` |
 | `Nav` | Primary navigation server component with locale-aware links. Three layout variants supported via `navAlignment`. Flyout (mega-menu) items: the desktop link list is ALWAYS a single SectionNav render path — there is no Path A/B fork. | `import { Nav } from "@working-theory/ui/chrome"` |
+| `NavBackLink` | The bare header's back arrow, deck-return-aware. *(weak)* | `import { NavBackLink } from "@working-theory/ui/chrome"` |
 | `NavMobileMenu` | Client subcomponent for mobile hamburger state. Isolates "use client" to this narrow component so Nav (Server Component) stays clean. Renders a hamburger button + collapsible link list. Closes the menu automatically when the pathname changes (route navigation). *(weak)* | internal — compose from `packages/ui/src/chrome/NavMobileMenu.tsx` |
 | `NavOverflowMenu` | The Nav row's per-breakpoint link-overflow disclosure. The desktop link row never wraps: a fixed per-breakpoint inline-link budget (4 at md, 6 at lg+) is enforced by the caller (Nav), which splits `navItems` into an inline slice and an overflow slice. This component renders ONLY the overflow slice, behind a disclosure trigger, in source order — it never computes the budget itself. | internal — compose from `packages/ui/src/chrome/NavOverflowMenu.tsx` |
 | `NotificationsMenu` | Bell trigger + notifications popover chrome (ploy-capture app-frame). Presentational, props-driven. The unread count and row list arrive entirely via props — this component carries NO fetch/polling logic of its own. Rows are pre-formatted at the call site (relative time, heading, empty copy) per the AILK i18n/formatting convention (design-system-rules Rule 10). | `import { NotificationsMenu } from "@working-theory/ui/chrome"` |
@@ -440,7 +448,7 @@ Import: `import { X } from "@working-theory/ui-scheduling";` (or from the `@work
 
 ---
 
-## Scheduling Blocks (5)
+## Scheduling Blocks (6)
 
 Paid — delivered by the `scheduling` module bundle, not present in a Free scaffold. The pieces the booker section is built from — slot pickers, timezone and confirmation furniture.
 
@@ -453,6 +461,7 @@ Import: `import { X } from "@working-theory/ui-scheduling";` (or from the `@work
 | `BookerEventHeader` | TWO KINDS OF TEXT, AND THE DIFFERENCE MATTERS. `eyebrow` and `headline` are AUTHORED: the operator's words about why someone would book. Everything in the meta row — duration, meeting type, timezone — is DERIVED from the calendar on the availability read, which is why the section schema has no field for any of it. | internal — compose from `packages-paid/ui-scheduling/src/blocks/BookerEventHeader.tsx` |
 | `BookerPanel` | The booking card, fully controlled. One chassis, five views, ONE FOOTER. | internal — compose from `packages-paid/ui-scheduling/src/blocks/BookerPanel.tsx` |
 | `BookerSlotGrid` | The selected day's open times. Two columns at 48px on mobile — the measured pixel target — widening to three at `lg` so the desktop variant shows more of the day without scrolling. Two columns is not an arbitrary density: at 390px it is the widest grid where a time still reads at a glance, and it puts eight times (a full working day's openings) inside one thumb-reachable block. | internal — compose from `packages-paid/ui-scheduling/src/blocks/BookerSlotGrid.tsx` |
+| `BookingProfileHeader` | The /meet hub's opening header. The Cal.com / Calendly profile shape: whose calendar this is, then one line saying what to do here. A centered portrait over a single h1, and nothing beneath it — the booker cards below carry each event's own title, so a subtitle here would only repeat them. | `import { BookingProfileHeader } from "@working-theory/ui-scheduling"` |
 
 ---
 
@@ -542,7 +551,7 @@ Import: `import { X } from "@working-theory/ui-commerce";` (or from the `@workin
 
 ## Weak descriptions
 
-These 31 components have a description that is accurate but does not do the job well: too short to match against, or long but spent on implementation. A capability search reaches them only if the searcher's word happens to be in it, so they are the most likely place for this catalog to repeat the failure it was built to fix. Read the source before concluding the capability is absent — and if you own one of these components, its header is the fix.
+These 34 components have a description that is accurate but does not do the job well: too short to match against, or long but spent on implementation. A capability search reaches them only if the searcher's word happens to be in it, so they are the most likely place for this catalog to repeat the failure it was built to fix. Read the source before concluding the capability is absent — and if you own one of these components, its header is the fix.
 
 | Component | Tier | What the source gives us |
 | --- | --- | --- |
@@ -550,14 +559,17 @@ These 31 components have a description that is accurate but does not do the job
 | `AgentContextCard` | blocks | Capability-bearing block that renders agent provenance. RSC note: no hooks or browser APIs — server-renderable by default. |
 | `PageHeader` | blocks | RSC. Page-level header composing the Breadcrumb primitive for the left-side wayfinding trail, a generic right-side `actions` slot, and an optional `switcher` slot for header-owned segment switching. Fills AppShell's `header` slot (AdminShell and similar). No accent bar. No tab API. No named action props — the caller assembles whatever button/menu nodes it needs and passes them as `actions`. |
 | `PostCard` | blocks | Same props as PostRow, a vertical arrangement. A single linked blog-index card (cover · date · reading time · title · excerpt · "Read more"). Tier 3 block; composes MediaFigure + primitives. RSC default. |
+| `PostTeaser` | blocks | The featured post (`size="lg"`) and "Latest posts" grid card (`size="md"`); no cover renders no placeholder. Composes MediaFigure + PostMetaLine + primitives. No author byline (C7). RSC: no hooks or browser APIs. |
 | `PricingTierCardSeatControl` | blocks | Seat-count range picker for the Team tier card. Renders a Select primitive that lets the user choose an "Up to N seats" option from a caller-supplied list of numbers. The parent PricingTierCard stays a pure RSC; only this tiny island is hydrated. Pattern mirrors PageHeaderSwitcher.tsx: small "use client" island imported by an otherwise-server-rendered parent, keeping the client bundle minimal. |
 | `SinglePriceCard` | blocks | 2-column split card for the Pricing 'single-price-with-details' variant. |
 | `SocialIcons` | blocks | Horizontal row of social icon links. Renders brand icons (via Icon primitive + simple-icons paths) inside accessible Link primitives. Each platform link gets an aria-label. Shared by company-mission, simple-centered, and newsletter-below footer variants, and composed by TeamMemberCard for member social links. |
+| `TopicChips` | blocks | "All" plus one chip per tag, each a real server-rendered link — never a client-side filter — with the current page's chip marked `aria-current="page"` / `data-current="true"` in the served HTML. Composes Button (asChild) + Link; RSC, no client state. |
 | `Banner` | chrome | Site-wide announcement and consent banner chrome. |
 | `BannerConsentIsland` | chrome | Accept / Reject action cluster for the consent Banner. Isolated to "use client" so Banner stays RSC. The onAccept / onReject callbacks must be Server Actions when used inside an RSC tree; they may be regular functions in client contexts (Storybook, testing). |
 | `BannerDismissIsland` | chrome | Isolated to "use client" so Banner (Server Component) stays RSC. Mirrors the Nav / NavMobileMenu split: interactivity is contained here. Rendering: wraps its children in a relative-positioned div and absolutely places the × dismiss button at the end (RTL-safe: `end-4`) of the bar. |
 | `BottomTabBar` | chrome | Fixed, safe-area-aware phone bottom tab bar chrome. Server Component (RSC) — presentational, no interaction state of its own; the leading avatar/account trigger is supplied as a node by the consumer (AppFrame composes AccountMenu around it). |
 | `FloatingCta` | chrome | Persistent fixed corner action pill. |
+| `NavBackLink` | chrome | The bare header's back arrow, deck-return-aware. |
 | `NavMobileMenu` | chrome | Client subcomponent for mobile hamburger state. Isolates "use client" to this narrow component so Nav (Server Component) stays clean. Renders a hamburger button + collapsible link list. Closes the menu automatically when the pathname changes (route navigation). |
 | `SidebarNav` | chrome | Application sidebar rail (nav + teams + user) for dashboard shells. Server Component (RSC). Renders the vertical sidebar rail for application-shell layouts. Used as the `sidebar` prop of AdminShell. Wrap in a FixedPanel (panels tier) to get the expanded ↔ rail ↔ hidden state machinery. Independently reusable in future shells (settings, analytics, etc.). |
 | `SidebarNavRailItems` | chrome | Client boundary for the collapsed rail tooltip affordance. Isolated "use client" boundary so SidebarNav itself stays a Server Component. Renders icon-only nav links with Tooltip labels when the rail is collapsed. |

package/dist/add-module.js

@@ -168,16 +168,20 @@ export async function applyModuleToScaffold(opts) {
             }
             : {}),
     });
-    // #7838 D8 — commerce on a spoke brings the spoke's own checkout, stamped
-    // from the site directory's name (the `projectName` scaffold() defaults to).
-    // A file the site already has is left as it is. #8217 D8 — on a spoke that
-    // signs in through its hub, the billing action and its seam render too, so
-    // re-running add-module commerce gives an existing commerce spoke the action.
+    // #7838 D8 — commerce on a spoke brings the spoke's own checkout — the
+    // standard, copied from the template (#8748 D3) — stamped from the site
+    // directory's name (the `projectName` scaffold() defaults to). A file the
+    // site already has is left as it is. No record row: the record is written
+    // only at scaffold time. #8217 D8 — on a spoke that signs in through its
+    // hub, the billing action and its seam render too, so re-running
+    // add-module commerce gives an existing commerce spoke the action.
     const spokeCommerce = spoke !== undefined && opts.moduleName === "commerce";
     const checkoutRows = spokeCommerce
         ? writeSpokeCheckoutSlice(targetAbs, {
             site: spokeCheckoutSite(basename(targetAbs)),
+            projectName: basename(targetAbs),
             versions: opts.versions,
+            templatesDir: opts.templatesDir,
             signIn: spoke.signIn,
         })
         : [];