npm - @cparkerwebm/webmonterey - Versions diffs - 1.3.0 → 1.4.0 - Mend

@cparkerwebm/webmonterey 1.3.0 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/CHANGELOG.md +47 -0
package/README.md +10 -0
package/package.json +1 -1
package/skills/launch/SKILL.md +5 -0
package/skills/new-component/SKILL.md +6 -0
package/skills/start/SKILL.md +2 -1
package/skills/webmaster/SKILL.md +118 -0
package/src/cli/checks.test.ts +21 -0
package/src/cli/sync.test.ts +1 -0
package/src/includes/webmonterey/copy-defaults.ts +9 -5
package/src/includes/webmonterey/webmaster/webmaster.test.ts +61 -1
package/src/includes/webmonterey/webmaster/webmaster.ts +57 -1
package/src/integration/index.ts +9 -0
package/src/integration/virtual.d.ts +11 -0
package/src/pages/webmaster.astro +50 -28
package/template/site/CLAUDE.md +5 -1

package/CHANGELOG.md CHANGED Viewed

@@ -11,6 +11,53 @@ build. See `/webm:upgrade`.
 ---
+## 1.4.0 — 2026-09-04
+### Added
+- **A site can lay out the `/webmaster` page itself.** Export `webmasterPage` from
+  `src/components/registry.ts` - an Astro component receiving
+  `{ title, description, intro, body }` - and the page renders it in place of the built-in
+  `<h1>` and stack of paragraphs. `intro` and each `body` entry are HTML, rendered with
+  `set:html` - the agency link is already in `intro`; `title` and `description` are text. The route, the copy, the document title, the meta
+  description, the share image and the agency JSON-LD stay the package's, so the page says the
+  same thing on every site and looks like the site it is on. Until now a site whose legal pages
+  used a richer document layout got a `/webmaster` that looked like a different site, and adding
+  its own `src/pages/webmaster.astro` collided with the injected route. The component carries no
+  copy of its own: the words are still `copy.webmaster` in `webmonterey.json`.
+  **`/webm:webmaster` is the skill**, materialized on the next `webm sync` - it carries a
+  complete reference component, the registry line and the checks to run on the built page, so a
+  site session has something to copy rather than a description. `/webm:new-component` sends a
+  session there the moment a site gains its document block, and `/webm:start` and
+  `/webm:launch` both point at it, so on a new site it happens in sequence; on an existing site
+  the upgrade lists it as a new skill.
+  The props are exported as `WebmasterPageProps` from
+  `@cparkerwebm/webmonterey/webmonterey/webmaster`.
+  **Nothing changes on a site that does not export it.** The built-in layout, `pageHeader`
+  seam included, renders as before, and examples/minimal asserts the whole `<main>` as a literal
+  so it cannot drift.
+### Changed
+- **The `/webmaster` copy.** "This custom website was designed, built and managed by
+  WebMonterey, a webmaster service in Monterey, California. WebMonterey handles the hosting,
+  security, strategy and ongoing care of the site…" - _custom_ added, _maintenance_ dropped,
+  _updates_ is now _strategy_ - and the contact paragraph is bold. `copy.webmaster.intro` and
+  `copy.webmaster.body` now take the same inline subset as page prose (`**bold**`, `_italic_`,
+  `[text](/url)`), which is how the bold is expressed. A site overriding `copy.webmaster` in
+  `webmonterey.json` keeps its own words; one that does not gets these. The agency's
+  description in the page's JSON-LD drops _maintenance_ too.
+### Fixed
+- **"managed byWebMonterey".** The built-in `/webmaster` intro had no space before the agency
+  link - Astro drops the whitespace between an expression and an element on separate lines. It
+  reads "managed by WebMonterey" now.
+---
 ## 1.3.0 — 2026-09-02
 ### Changed

package/README.md CHANGED Viewed

@@ -20,6 +20,16 @@ the reset, the Cloudflare includes, the consent system, the form pipeline, the r
 It ships **zero visible components**. Every block a visitor sees is built per client, in that
 client's repo. Every default has a documented way to opt out of it.
+A site hands the package its components through `src/components/registry.ts`: `blocks` for the
+block router, `header`, `footer` and `panels` for the chrome, `pageHeader` in place of the
+router's plain `<h1>`, `structuredData` for the site's JSON-LD, and `webmasterPage` for the body
+of the `/webmaster` page. That last one is the seam for a site whose document pages have a richer
+layout than a heading and a stack of paragraphs: the component receives the merged copy
+(`{ title, description, intro, body }`; `intro` and `body` are HTML, the agency link already in
+`intro`) and lays it out; the route, the words, the `<head>`, the share image and the agency graph
+stay the package's. It carries no copy of its own - the words are overridden through
+`copy.webmaster` in `webmonterey.json`, not in the component.
 **The package is edited in this repo, and only here.** A session in a client site that finds a
 package bug does not reach into `node_modules` or into this checkout; its deliverable is a
 description of the fix, run later in a session opened here, and the site takes the result with

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cparkerwebm/webmonterey",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "description": "The WebMonterey Astro framework: plumbing, design system, and Claude Code skills for client sites on Cloudflare Workers",
   "license": "MIT",

package/skills/launch/SKILL.md CHANGED Viewed

@@ -99,6 +99,11 @@ to say, and this is where it gets decided - once, with the client's real details
 4. **Validate** the built home page and one inner page with Google's Rich Results Test before
    moving on.
+5. **Look at `/webmaster`.** The package injects it on every site, with its own share image and
+   JSON-LD. If this site's document pages - privacy, terms - use a richer layout than an `<h1>`
+   and a stack of paragraphs, run `/webm:webmaster`: it exports a layout component from the
+   registry so the page looks like the site it is on, with the package's copy intact.
 ## 3. Turnstile
 If the site has a form: create the widget in the Cloudflare dashboard (**Turnstile → Add

package/skills/new-component/SKILL.md CHANGED Viewed

@@ -83,3 +83,9 @@ npm run preview   # NOT dev - preview is a real build on real workerd
 `dev` cannot detect CSS bundling, cascade order, or the asset router. Every trap worth catching is
 invisible in `dev` and visible in `preview`. See `/webm:traps`.
+## If this is the site's document block
+A long-form block - the one the privacy and terms pages use - is also the layout the package's
+`/webmaster` page should have. The moment that block exists, run `/webm:webmaster`: it exports a
+layout component built on this block, so `/webmaster` stops looking like a different site.

package/skills/start/SKILL.md CHANGED Viewed

@@ -173,5 +173,6 @@ client can click anything. **Every build of this site is a preview while `enviro
 flips it, and that flip is what makes the site indexable. On a launched site the production
 branch is `main`; anything else previews.
-Next: `/webm:new-component` for each block, then `/webm:launch` when the site is
+Next: `/webm:new-component` for each block, `/webm:webmaster` once the site has its document
+block so the package's `/webmaster` page shares its layout, then `/webm:launch` when the site is
 content-complete and approved on a preview.

package/skills/webmaster/SKILL.md ADDED Viewed

@@ -0,0 +1,118 @@
+---
+name: webmaster
+description: Make the package's /webmaster page look like this site's other document pages by exporting a `webmasterPage` layout component from the registry. Use for "the webmaster page looks different", "style /webmaster like /privacy", "webmaster page layout", "webmasterPage".
+---
+# The `/webmaster` page
+**The package owns the page; this site may own its shape.** `/webmaster` is injected on every
+site: who built it, who to call. The route, the words, the document title, the meta description,
+the share image and the agency JSON-LD are the package's, so the page says the same thing on
+every site. Without help it renders as an `<h1>` (or this site's `pageHeader`) and a stack of
+paragraphs - which looks like a different site the moment the site's own document pages have a
+richer layout.
+**Do not add `src/pages/webmaster.astro`.** It collides with the injected route, and the injected
+route wins. The seam is a registry export.
+## What the component receives
+```ts
+interface WebmasterPageProps {
+  title: string; // text - also the document title
+  description: string; // text - also the meta description
+  intro: string; // HTML - the first paragraph, agency link already in it
+  body: string[]; // HTML - one entry per remaining paragraph
+}
+```
+`intro` and `body` are already HTML: the agency link with its UTM parameters, and the copy's own
+inline formatting (`**bold**`, `_italic_`, `[text](/url)`) rendered and escaped. Render them with
+`set:html`. `title` and `description` are text.
+**The component carries no copy of its own.** Not a heading, not a caption, not a sentence. The
+words are the same on every site; when a client wants them changed, that is `copy.webmaster` in
+`webmonterey.json` (`title`, `description`, `intro.before`, `intro.after`, `body[]`), never the
+component.
+## 1. Find this site's document layout
+Look at how the privacy or terms page is rendered - usually one long-form block under
+`src/components/content/`. The webmaster page should reuse **that block's markup and classes**,
+so a change to the document style reaches both.
+## 2. Write the component
+`src/components/general/webmaster-page.astro`. The reference below is complete and works on any
+site; replace the element names and classes with the document block's own.
+```astro
+---
+/*
+ * The /webmaster page body. The package hands in the copy; this lays it out like the site's
+ * other document pages. See /webm:webmaster.
+ */
+import type { WebmasterPageProps } from '@cparkerwebm/webmonterey/webmonterey/webmaster';
+type Props = WebmasterPageProps;
+const { title, intro, body } = Astro.props;
+---
+<section class="webm-section" data-space="lg">
+  <div class="webm-container" data-width="text">
+    <article class="doc">
+      <header class="doc__head">
+        <h1 class="doc__title">{title}</h1>
+      </header>
+      <div class="doc__panel">
+        <p set:html={intro} />
+        {body.map((paragraph) => <p set:html={paragraph} />)}
+      </div>
+    </article>
+  </div>
+</section>
+```
+If the document block is itself a component that takes `title` and a slot or `html` prop, render
+it directly rather than copying its markup:
+```astro
+---
+import Doc from '../content/content-000001/content-000001.astro';
+const { title, intro, body } = Astro.props;
+---
+<Doc title={title}>
+  <p set:html={intro} />
+  {body.map((paragraph) => <p set:html={paragraph} />)}
+</Doc>
+```
+## 3. Export it
+```ts
+// src/components/registry.ts
+export { default as webmasterPage } from './general/webmaster-page.astro';
+```
+Not an entry in `blocks` - it is not addressable from page JSON. A named export beside
+`pageHeader` and `structuredData`.
+## 4. Verify
+```sh
+npm run build
+```
+Then read `dist/client/webmaster/index.html`:
+- the body is the new markup, and there is no `webm-stack` div left from the built-in layout
+- the `<h1>` is the package's title (`Our Webmaster` unless `copy.webmaster.title` is set)
+- the first paragraph has one `<a href="https://webmonterey.com/?utm_source=client…"
+target="_blank" rel="noopener">` and nothing else links off-site
+- `<title>`, `meta name="description"`, `og:image` (`/webmaster/og.png`) and the
+  `application/ld+json` block are present and unchanged from before the export
+Then push and compare `/webmaster` against `/privacy` on the preview URL: same heading style,
+same panel, the package's words.

package/src/cli/checks.test.ts CHANGED Viewed

@@ -435,6 +435,27 @@ test('a registry keyed by name rather than by number is understood', () => {
   assert.equal(runCheck('block-types-registered', ctx).status, 'pass');
 });
+test('the chrome exports in a registry are not read as block types', () => {
+  /*
+   * `header`, `footer`, `pageHeader`, `structuredData` and `webmasterPage` sit in the same file
+   * as `blocks`, in either export form. None is a block type, and none may make the check trip
+   * over a registry that is otherwise complete.
+   */
+  const ctx = base({
+    registry: [
+      `import WebmasterPage from './general/webmaster-page.astro';`,
+      `export const blocks = { 'content-000001': C };`,
+      `export const registeredTypes = () => Object.keys(blocks);`,
+      `export { default as pageHeader } from './general/page-header.astro';`,
+      `export const webmasterPage = WebmasterPage;`,
+    ].join('\n'),
+    content: new Map([
+      ['src/content/pages/home.json', JSON.stringify({ blocks: [{ type: 'content-000001' }] })],
+    ]),
+  });
+  assert.equal(runCheck('block-types-registered', ctx).status, 'pass');
+});
 test('a site that has not launched only gets a warning about placeholders', () => {
   /*
    * `webm new` seeds every one of these, so a freshly scaffolded site has the full set. The

package/src/cli/sync.test.ts CHANGED Viewed

@@ -44,6 +44,7 @@ test('the package ships exactly the skills the release claims', () => {
     'start',
     'traps',
     'upgrade',
+    'webmaster',
   ]);
 });

package/src/includes/webmonterey/copy-defaults.ts CHANGED Viewed

@@ -67,7 +67,10 @@ export interface Copy {
     /** `{domain}` is replaced with the site's domain. */
     footerNotice: string;
   };
-  /** The /webmaster page. `intro` wraps the agency link: `before` <a>WebMonterey</a> `after`. */
+  /**
+   * The /webmaster page. `intro` wraps the agency link: `before` <a>WebMonterey</a> `after`.
+   * `intro` and `body` take the inline prose subset - `**bold**`, `_italic_`, `[text](/url)`.
+   */
   webmaster: {
     title: string;
     description: string;
@@ -135,14 +138,15 @@ export const DEFAULT_COPY: Copy = {
   webmaster: {
     title: 'Our Webmaster',
     description:
-      'This website was designed, built and managed by WebMonterey, a webmaster maintenance service in Monterey, California.',
+      'This custom website was designed, built and managed by WebMonterey, a webmaster service in Monterey, California.',
     intro: {
-      before: 'This website was designed, built and managed by',
+      before: 'This custom website was designed, built and managed by',
       after:
-        ', a webmaster maintenance service in Monterey, California. WebMonterey handles the hosting, security, updates and ongoing care of the site so that we can focus on what we do.',
+        ', a webmaster service in Monterey, California. WebMonterey handles the hosting, security, strategy and ongoing care of the site so that we can focus on what we do.',
     },
+    /* Bold on purpose: the contact instruction is the paragraph a visitor with a problem needs. */
     body: [
-      "If you have a question about this website, notice something that isn't working, or have trouble using a page, please let WebMonterey know and they will take care of it.",
+      "**If you have a question about this website, notice something that isn't working, or have trouble using a page, please let WebMonterey know and they will take care of it.**",
     ],
   },
 };

package/src/includes/webmonterey/webmaster/webmaster.test.ts CHANGED Viewed

@@ -2,7 +2,15 @@ import { test } from 'node:test';
 import assert from 'node:assert/strict';
 import { readFileSync } from 'node:fs';
-import { AGENCY, contentTag, CREDIT_TEXT, creditUrl, WEBMASTER_PATH } from './webmaster.ts';
+import {
+  AGENCY,
+  contentTag,
+  CREDIT_TEXT,
+  creditUrl,
+  introHtml,
+  webmasterPageProps,
+  WEBMASTER_PATH,
+} from './webmaster.ts';
 /*
  * Webmaster.astro read as SOURCE, because it cannot be imported here: an .astro file only
@@ -72,3 +80,55 @@ test('an internal link does not open a new tab and carries no rel', () => {
   assert.doesNotMatch(anchor(), /rel=/);
   assert.doesNotMatch(template, /opens in a new tab/);
 });
+/* ── the intro paragraph, as one HTML string for a site that owns the layout ─────────────── */
+test('introHtml is before, a space, the agency link, then after', () => {
+  const html = introHtml({ before: 'Built by', after: ', a service.' }, 'https://x.test/?a=1&b=2');
+  assert.equal(
+    html,
+    'Built by <a href="https://x.test/?a=1&amp;b=2" target="_blank" rel="noopener">WebMonterey</a>, a service.',
+  );
+});
+test('introHtml escapes the copy and the href', () => {
+  const html = introHtml({ before: '<b>a & b</b>', after: '"q"' }, 'https://x.test/?"');
+  assert.ok(!html.includes('<b>'), 'copy markup must not pass through');
+  assert.ok(html.includes('&lt;b&gt;a &amp; b&lt;/b&gt;'));
+  assert.ok(html.includes('href="https://x.test/?&quot;"'));
+  assert.ok(html.endsWith('&quot;q&quot;'));
+});
+test('the copy carries the inline prose subset, in the intro and the body', () => {
+  const props = webmasterPageProps(
+    {
+      title: 'T',
+      description: 'D',
+      intro: { before: 'Built by', after: ', **really**.' },
+      body: ["**If it isn't working, say so.**", 'See [the policy](/privacy).'],
+    },
+    'https://x.test/',
+  );
+  assert.equal(props.title, 'T');
+  assert.equal(props.description, 'D');
+  assert.ok(props.intro.endsWith('</a>, <strong>really</strong>.'));
+  assert.deepEqual(props.body, [
+    '<strong>If it isn&#39;t working, say so.</strong>',
+    'See <a href="/privacy">the policy</a>.',
+  ]);
+});
+test('the built-in page renders the same intro string a site layout receives', () => {
+  /*
+   * One source for the agency link. The page used to build its own <a> in the template, which
+   * is how a second copy of the attributes would drift; now both layouts render introHtml.
+   */
+  const page = readFileSync(new URL('../../../pages/webmaster.astro', import.meta.url), 'utf8');
+  const template = page.slice(page.lastIndexOf('---'));
+  assert.match(template, /<p set:html=\{props\.intro\} \/>/);
+  assert.doesNotMatch(template, /<a\s/, 'the page must not assemble the agency link itself');
+  const html = introHtml({ before: '', after: '' }, 'https://x.test/');
+  assert.match(html, /target="_blank"/);
+  assert.match(html, /rel="noopener"/);
+  assert.doesNotMatch(html, /noreferrer/);
+});

package/src/includes/webmonterey/webmaster/webmaster.ts CHANGED Viewed

@@ -25,6 +25,8 @@
  * means a change to the name, the address or a profile is one edit.
  */
+import { escapeHtml, renderInline } from '../prose/inline.ts';
 /** The credit wording. Rendered verbatim on the site and in email. */
 export const CREDIT_TEXT = 'Powered by WebMonterey';
@@ -44,7 +46,7 @@ export const AGENCY = {
   name: 'WebMonterey',
   url: 'https://webmonterey.com/',
   description:
-    'A webmaster maintenance service in Monterey, California: design, build, hosting, security and ongoing care for small-business websites.',
+    'A webmaster service in Monterey, California: design, build, hosting, security and ongoing care for small-business websites.',
   address: { addressLocality: 'Monterey', addressRegion: 'CA', addressCountry: 'US' },
   sameAs: [
     /* The Google Business Profile, by its Knowledge Graph id - the stable form of the share link. */
@@ -87,3 +89,57 @@ export function creditUrl(domain: string, medium: CreditMedium = 'website'): str
   return `${AGENCY.url}?${params}`;
 }
+/**
+ * What the site's `webmasterPage` component receives, when a site exports one from its
+ * registry: the merged copy, already resolved. The component lays it out and carries no copy of
+ * its own - the words are the package's on every site, the shape of the page is the client's.
+ *
+ * `intro` and `body` are HTML, rendered with `set:html`. They are the output of `renderInline`,
+ * so a paragraph in `copy.webmaster` may carry the same inline subset page prose does -
+ * `**bold**`, `_italic_`, `[text](/url)` - and everything else is escaped.
+ */
+export interface WebmasterPageProps {
+  /** `copy.webmaster.title`, also the document title. Text. */
+  title: string;
+  /** `copy.webmaster.description`, also the meta description. Text. */
+  description: string;
+  /** The first paragraph's inner HTML, with the agency link already resolved. */
+  intro: string;
+  /** The remaining paragraphs' inner HTML, one entry per `<p>`. */
+  body: string[];
+}
+/**
+ * The intro paragraph's inner HTML: `before` <a>WebMonterey</a> `after`.
+ *
+ * ONE STRING, because it is the only part of the copy that is not plain text. A site taking
+ * over the page layout still gets the agency link exactly as the built-in page renders it - a
+ * followed link, opening in a new tab, `noopener` without `noreferrer` because the referrer is
+ * the attribution - rather than reassembling three fragments and forgetting one of the
+ * attributes. The built-in page renders this same string, so the two cannot drift. The space
+ * between `before` and the link is deliberate: Astro drops the whitespace between an expression
+ * and an element on separate lines, and "managed byWebMonterey" shipped.
+ */
+export function introHtml(intro: { before: string; after: string }, href: string): string {
+  const link = `<a href="${escapeHtml(href)}" target="_blank" rel="noopener">${escapeHtml(AGENCY.name)}</a>`;
+  return `${renderInline(intro.before)} ${link}${renderInline(intro.after)}`;
+}
+/** The whole prop set, from the merged copy and the attributed agency link. */
+export function webmasterPageProps(
+  text: {
+    title: string;
+    description: string;
+    intro: { before: string; after: string };
+    body: string[];
+  },
+  href: string,
+): WebmasterPageProps {
+  return {
+    title: text.title,
+    description: text.description,
+    intro: introHtml(text.intro, href),
+    body: text.body.map(renderInline),
+  };
+}

package/src/integration/index.ts CHANGED Viewed

@@ -387,6 +387,15 @@ export default function webmonterey(options: WebmontereyOptions = {}): AstroInte
                          * router's plain <h1>; a site that does not keeps the <h1>.
                          */
                         `export const pageHeader = mod.pageHeader ?? null;`,
+                        /*
+                         * THE /webmaster PAGE'S BODY. The route, the copy, the share image and
+                         * the agency graph stay the package's; a site whose document pages use
+                         * a richer layout than an <h1> and a stack of paragraphs hands over the
+                         * layout only. Without this a site's own src/pages/webmaster.astro
+                         * collides with the injected route, and on one site the injected route
+                         * won.
+                         */
+                        `export const webmasterPage = mod.webmasterPage ?? null;`,
                         /*
                          * THE SITE'S JSON-LD, rendered into <head> on every route. The package
                          * emits none of its own: what a business claims about itself is the

package/src/integration/virtual.d.ts CHANGED Viewed

@@ -86,6 +86,17 @@ declare module 'virtual:webm/registry' {
    * every later fix to block lookup, unknown-type reporting and FAQ extraction.
    */
   export const pageHeader: AstroComponentFactory | null;
+  /**
+   * The body of the `/webmaster` page, when the site wants it laid out like its own document
+   * pages rather than as the package's `<h1>` and stack of paragraphs.
+   *
+   * Receives `WebmasterPageProps` from `includes/webmonterey/webmaster/webmaster.ts`:
+   * `{ title, description, intro, body }`, the merged `copy.webmaster` - `intro` and `body` as
+   * HTML through the inline prose renderer, the agency link already in `intro`. The component
+   * lays the words out and carries no copy of its own. The route, the `<head>`, the share image and the JSON-LD stay the package's.
+   * Null means the built-in layout, `pageHeader` seam included.
+   */
+  export const webmasterPage: AstroComponentFactory | null;
   /**
    * The site's JSON-LD, rendered into <head> on every indexable route. The package emits none of
    * its own; this component composes a graph from the builders in

package/src/pages/webmaster.astro CHANGED Viewed

@@ -27,17 +27,25 @@ import { copy } from '../includes/webmonterey/copy.ts';
 import {
   AGENCY,
   creditUrl,
+  webmasterPageProps,
   WEBMASTER_OG_PATH,
 } from '../includes/webmonterey/webmaster/webmaster.ts';
 import { domain, hasDomain } from '../includes/webmonterey/site.ts';
 import { compact, renderJsonLd } from '../includes/webmonterey/structured-data/nodes.ts';
-import { pageHeader } from 'virtual:webm/registry';
+import { pageHeader, webmasterPage } from 'virtual:webm/registry';
 import ogImage from 'virtual:webm/webmaster-og';
 import build from 'virtual:webm/build';
 const PageHeader = pageHeader;
+const WebmasterPage = webmasterPage;
 const text = copy.webmaster;
 const agencyHref = hasDomain ? creditUrl(domain, 'website') : AGENCY.url;
+/*
+ * The words, resolved once for both layouts: the intro with the agency link in it, every
+ * paragraph through the inline prose renderer, so `**bold**` in copy.webmaster works here
+ * exactly as it does in page JSON.
+ */
+const props = webmasterPageProps(text, agencyHref);
 /*
  * The graph needs a real origin for stable @id values, which is the same gate the canonical tag
@@ -85,37 +93,51 @@ if (Astro.site && !build.preview) {
   {
     /*
-     * The site's page header if it declares one, so this page looks like every other page on the
-     * site; the router's plain <h1> otherwise. Same fallback the block router uses.
+     * THE BODY IS THE SITE'S IF IT WANTS IT. A site whose document pages - privacy, terms - use a
+     * richer layout than an <h1> and a stack of paragraphs exports `webmasterPage` from its
+     * registry and gets the merged copy handed to it: the same title, description and paragraphs
+     * as below, with the agency link already resolved into `intro`. Everything above this
+     * expression - the route, the <head>, the share image, the agency graph - stays the
+     * package's, so the page reads the same on every site and looks like the one it is on.
      */
-    PageHeader ? (
-      <PageHeader title={text.title} description={text.description} />
+    WebmasterPage ? (
+      <WebmasterPage {...props} />
     ) : (
-      <section class="webm-section" data-space="sm">
-        <div class="webm-container" data-width="text">
-          <h1>{text.title}</h1>
-        </div>
-      </section>
-    )
-  }
-  <section class="webm-section" data-space="lg">
-    <div class="webm-container" data-width="text">
-      <div class="webm-stack">
+      <Fragment>
         {
           /*
-           * The agency is named as a link in the first paragraph - the one outbound link on the
-           * site, followed, with the UTM parameters. Opens in a new tab because it leaves the
-           * site; noopener without noreferrer, because the referrer is the attribution.
+           * The site's page header if it declares one, so this page looks like every other page
+           * on the site; the router's plain <h1> otherwise. Same fallback the block router uses.
            */
+          PageHeader ? (
+            <PageHeader title={text.title} description={text.description} />
+          ) : (
+            <section class="webm-section" data-space="sm">
+              <div class="webm-container" data-width="text">
+                <h1>{text.title}</h1>
+              </div>
+            </section>
+          )
         }
-        <p>
-          {text.intro.before}
-          <a href={agencyHref} target="_blank" rel="noopener">{AGENCY.name}</a>
-          {text.intro.after}
-        </p>
-        {text.body.map((paragraph) => <p>{paragraph}</p>)}
-      </div>
-    </div>
-  </section>
+        <section class="webm-section" data-space="lg">
+          <div class="webm-container" data-width="text">
+            <div class="webm-stack">
+              {/*
+               * The agency is named as a link in the first paragraph - the one outbound link
+               * on the site, followed, with the UTM parameters. Opens in a new tab because it
+               * leaves the site; noopener without noreferrer, because the referrer is the
+               * attribution. See introHtml in webmaster.ts - the same string a site's own
+               * layout receives, so the two cannot disagree about the link.
+               */}
+              <p set:html={props.intro} />
+              {props.body.map((paragraph) => (
+                <p set:html={paragraph} />
+              ))}
+            </div>
+          </div>
+        </section>
+      </Fragment>
+    )
+  }
 </Base>

package/template/site/CLAUDE.md CHANGED Viewed

@@ -231,7 +231,10 @@ webmonterey.json            domain, client name, environment, features.
 src/
   components/               EVERY visible component. The package ships none.
     registry.ts             maps a block `type` to its component. A block whose type is
-                            not here renders as nothing, silently.
+                            not here renders as nothing, silently. Also exports the chrome:
+                            `header`, `footer`, `panels`, `pageHeader`, `structuredData`, and
+                            `webmasterPage` - the body of /webmaster, laid out like this
+                            site's document pages, with the package's copy handed in.
   content/pages/*.json      the words. One file per route; home.json is `/`.
   forms/*.json              form definitions. Filename is the form id.
   actions/index.ts          re-exports the package pipeline. Wrap to customize.
@@ -264,6 +267,7 @@ replaced wholesale. This client's own skills go beside it at `.claude/skills/<na
 | `/webm:start`         | standing a new site up: repo, Cloudflare resources, first deploy          |
 | `/webm:launch`        | launch checklist: structured data, sending domain, secrets, DNS, cutover  |
 | `/webm:upgrade`       | taking a new package version                                              |
+| `/webm:webmaster`     | laying out the package's `/webmaster` page like this site's own pages     |
 Content edits: branch, edit `src/content/pages/*.json`, `npm run check`, push — the branch
 preview is the client's review link. Merge when approved. Never change a block's `type`.