@taprootio/site-authoring 0.27.0 → 0.28.0

package/README.md

@@ -140,7 +140,7 @@ with no credential, no network, and no write: every page source (metadata,
 Markdown conversion, media references, content vocabulary, section contexts),
 page paths and templates against the pages the pull recorded, navigation,
 redirects, forms, and the complete theme, appearance, header, brand, and
-footer. Navigation to a generated page (a section, tag or place page) resolves
+footer. Navigation to a generated page (a section or folder page) resolves
 against the pages the pull recorded. It reports every problem at once in
 `error.problems`, each with its file, code, and field, instead of one per run.
 Warnings never refuse: `linkWarnings` names a link whose address is only
@@ -506,12 +506,11 @@ listings only while that person can still be named: a former member's page, or
 a member who can no longer create pages, reports none, and a push that names
 someone else on it is refused as a conflict.
 
-Pages Taproot generates from the site's content — a tag, the tags index, a
-published year or month, a place archive, a folder — are update-only sources.
-`pull` writes each as `pages/<name>.pm.json` with `"template": "generated"`:
-`data` holds what the page is (`kind`, `tagId`, `year`, `month`, `countryCode`,
-`regionCode`, `citySlug`, `categorySlug`, which you leave as pulled) and the four
-things that are yours to author: `customTitle`, `breadcrumbTitle`,
+Pages Taproot generates from the site's content — the published archive, a
+folder — are update-only sources. `pull` writes each as
+`pages/<name>.pm.json` with `"template": "generated"`: `data` holds what the
+page is (`kind`, which you leave as pulled) and the four things
+that are yours to author: `customTitle`, `breadcrumbTitle`,
 `customDescription` and `introductionBody`. An empty string means "use the
 generated default"; the description then falls back to the introduction's first
 paragraph, else the system default. The manifest keeps the title and description
@@ -525,8 +524,8 @@ move one (`pages.generated_move`) or change its kind or identity
 (`pages.generated_identity`, also when the manifest has no record of what the
 file was pulled as: run `pull`); there is no Markdown form
 (`pages.generated_markdown`). A generated page you did not edit never blocks a
-push of the whole workspace, even when Taproot moved it since the pull (a tag was
-renamed). If the site no longer has the page (its tag, month or folder is gone),
+push of the whole workspace, even when Taproot changed it since the pull. If the
+site no longer has the page (its folder is gone, or Taproot retired its kind),
 a whole-workspace push reports the file under `pages.staleGeneratedSources` and
 sends nothing for it, and `pull` says so; delete the file. Naming that path in
 `pages push <page-path>` is refused with `pages.generated_create`. A description over 160 characters is warned about,
@@ -857,8 +856,8 @@ taproot-site places category clear <placeId>
 `list` prints the closed list `set` accepts; a name outside it is refused, and
 capitalization is ignored. The category is the site's alone and applies to every
 review of that place on the site: the place itself and other sites do not
-change. Place-review bylines and the `/places/<category>` pages use it from the
-site's next deployment, including reviews nobody has edited. `clear` removes it.
+change. Place-review bylines use it from the site's next deployment, including
+reviews nobody has edited. `clear` removes it.
 Both need the same page-editing permission as `places select`.
 
 ### Pages generated in 0.18.0
@@ -892,7 +891,7 @@ once).
   page's title, description or author; `pull` keeps the edit until `pages push`
   sends it. Descriptions are warned about over 160 characters and refused over
   1000, here and by Taproot.
-- Generated pages (tags, archives, places, folders) pull as update-only sources
+- Generated pages (the published archive, the map, folders) pull as update-only sources
   whose custom title, breadcrumb, description and introduction you can edit.
 - Pages are authorless by default. `authors list`, `authors add` and
   `authors.json` name a member who can create pages or a site author without a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taprootio/site-authoring",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "Taproot site authoring CLI: sign in once in the browser, then pull, validate, push, preview, approve, and deploy a site from the terminal",
   "type": "module",
   "license": "ISC",

package/src/changelog.json

@@ -1,5 +1,36 @@
 {
   "entries": [
+    {
+      "version": "0.28.0",
+      "note": "Taproot no longer generates /places, year and month, or tag pages, so a generated page's data drops those fields. One /published page lists every month, a folder page reaches search only with an introduction or three cards, and a review's location byline opens Google Maps.",
+      "behavior": [
+        "The /published/<year> and /published/<year>/<month> pages are no longer generated. One /published page carries a year and a month picker filled from JSON files the release writes (published/months.json and published/<year>/<month>.json), and a content byline links to /published?year=YYYY&month=M. Those file paths are refused as redirect sources with redirect.source_generated_file.",
+        "A generated page's data drops year and month beside the place fields: pull writes kind and the four authored fields, and a source that still carries year or month is refused by pages push with pages.document_shape as an unsupported field: delete the year and month lines from sources pulled before this release (every generated page pulled earlier carries year: 0 and month: 0).",
+        "The /places index, country, region, city and category pages are no longer generated, so a site has no generated page of those kinds to pull. On a published review, article or album with a place on a site with no map page, the location byline opens the place's Google Maps listing in a new tab; the review's category byline is plain text.",
+        "A generated page's data holds kind and the four authored fields. pull no longer writes countryCode, regionCode, citySlug or categorySlug, and a source that still carries one is refused by pages push with pages.document_shape as an unsupported field: delete the four lines from sources pulled before this release.",
+        "/places is no longer a reserved path, so a page may be authored there.",
+        "A workspace that pulled a /places page before this release keeps that file: pages push reports it as the source of a generated page Taproot no longer publishes and sends the rest, whether or not the site has synchronized the page away yet; naming its path is refused with pages.generated_create. Delete the file.",
+        "Taproot no longer generates tag pages (/tags and /tags/<slug>): tags stay page metadata with no public page, a workspace that pulled one keeps the file and pages push reports it as the source of a page Taproot no longer publishes, and /tags is no longer a reserved path. A generated page's data holds kind and the four authored fields; tagId leaves the identity, and a source that still carries it is refused by pages push with pages.document_shape as an unsupported field: delete the line from sources pulled before this release.",
+        "A folder index is a search destination when it has an introduction or renders at least three cards; otherwise it carries noindex and leaves the sitemap. Write the page's introductionBody in its pulled .pm.json source to make a small folder one.",
+        "Taproot generates a /map page for a site with a public post that has a location. It is a new generated kind in pulls, /map and every path under it are reserved, and /map/places.json cannot be a redirect source.",
+        "The help reference version is 47."
+      ],
+      "help": [
+        "pages",
+        "page"
+      ]
+    },
+    {
+      "version": "0.27.1",
+      "note": "The site checks refuse a page or redirect source named like a search-engine key file, which the platform now publishes at the site root.",
+      "behavior": [
+        "A redirect source whose first segment is 32 lowercase hexadecimal characters followed by .txt (any capitals, with or without a path beneath it) is refused with redirect.source_generated_file, like sitemap.xml and robots.txt. Taproot writes a file with that name at the root of a site that tells search engines about its releases, so nothing else can sit there. No command changed.",
+        "The help reference version is 45."
+      ],
+      "help": [
+        "redirects"
+      ]
+    },
     {
       "version": "0.27.0",
       "note": "Embedded forms inherit configurable background, border and shadow defaults from the site, with per-form overrides.",

package/src/cli.js

@@ -139,7 +139,7 @@ const VERBS = Object.freeze([
       + "appearance, header, brand, footer, navigation, redirects, and forms are checked with the validators the "
       + "pushes use, and every problem is reported at once in error.problems (each with its file, code, and field) "
       + "rather than one per run. A pulled workspace is checked offline against the pages (generated ones included, "
-      + "so navigation to a section or tag page resolves), images, and baselines its manifests recorded at the pull. "
+      + "so navigation to a folder index resolves), images, and baselines its manifests recorded at the pull. "
       + "A link whose address is only http(s):// plus its own text (left by older editor autolinking) is reported in "
       + "linkWarnings without refusing; pages push reports the same for the pages it sends. "
       + "The site checks that can run offline are reported in findings (a rule id, severity, file, and the value "
@@ -287,7 +287,7 @@ const VERBS = Object.freeze([
       + "and pull again. A locally edited '.pm.json' is kept rather than overwritten for the same reason. "
       + "First revisions adopted without a completed body comparison are counted in pages.revisionsRecordedWithoutBodyComparison "
       + "and announced on the human channel. New downloads and compared bodies are excluded. "
-      + "A page Taproot generates (a tag, an archive, a place, a folder) is pulled as an update-only '.pm.json' "
+      + "A page Taproot generates (the published archive, the map or a folder) is pulled as an update-only '.pm.json' "
       + "(template 'generated'): you edit its custom title, breadcrumb title, custom description and introduction, "
       + "and the manifest keeps the title and description the site reports. "
       + "A form a page places is written back by its key, the name 'forms/<key>.json' uses, though the site stores "
@@ -445,7 +445,7 @@ const VERBS = Object.freeze([
       + "'places category list', which prints the closed list; a name outside it is refused, and capitalization is "
       + "ignored. Use it when Google's own category for a place is not the one this site wants, such as a park filed "
       + "under Other. The category is this site's alone and applies to every review of that place here: the place "
-      + "itself and other sites do not change. Place-review bylines and the /places/<category> pages use it from the "
+      + "itself and other sites do not change. Place-review bylines use it from the "
       + "next deployment, which a changed category alone is enough to start. Undo it with 'places category clear'.",
   },
   {

package/src/reference-help.js

@@ -95,7 +95,7 @@ import {
 
 export { getAppearanceReference, getFooterReference, getSettingsReference, getThemeReference };
 
-export const REFERENCE_VERSION = 44;
+export const REFERENCE_VERSION = 47;
 
 // The date-limit examples `help forms` prints; tests run them through the form validator.
 export const FORM_DATE_WINDOW_FIELD = Object.freeze({
@@ -755,7 +755,7 @@ const WORKFLOW_REFERENCES = Object.freeze({
       + "those away, so '/x/../visit' would be checked as itself and served as '/visit' — past the occupancy, "
       + "chain, and loop rules that were asked about a different path. Write the resolved path instead.",
       "origin is reported by the site and ignored on push: 'authored' is what you declared, 'path_history' is "
-      + "what a page or tag rename recorded. Pull the map, edit it, push the whole thing back — an entry you "
+      + "what a page rename recorded. Pull the map, edit it, push the whole thing back — an entry you "
       + "did not change keeps its origin.",
       "Refused, offline and again at the site, each naming the entry index: a chain (a target that is itself a "
       + "source in the same map); a loop (an entry targeting itself); a duplicate path; a gone entry carrying a "
@@ -786,7 +786,10 @@ const WORKFLOW_REFERENCES = Object.freeze({
       + "check does not see may belong to a release the edge has not switched to yet; deploy --staging waits for "
       + "staging to serve the new release and reports stagingServed.",
       "A source cannot name a file the site generates: '/index.html' or any page's own 'index.html', '/404.html', "
-      + "'/sitemap.xml', '/robots.txt', '/favicon.ico', or a path under the sitemap or robots names. Nothing under "
+      + "'/sitemap.xml', '/robots.txt', '/favicon.ico', the published archive's data files ('/published/months.json' "
+      + "and '/published/<year>/<month>.json'), the map page's data file ('/map/places.json'), a path under any of those names, or the "
+      + "search-engine key file Taproot publishes when a site tells search engines about its releases (32 "
+      + "lowercase hexadecimal characters followed by '.txt', in any capitals). Nothing under "
       + "'/taproot/<version>/' (for example '/taproot/5.0.62/manifest.json') can be a source either: the platform "
       + "serves the published-site runtime there before any redirect. The platform "
       + "already redirects every '…/index.html' address to its directory, so no entry is needed for one. A source "
@@ -868,8 +871,8 @@ const WORKFLOW_REFERENCES = Object.freeze({
       + "refused as forms.page_not_found, so push the page first. It need not be published to save the form, but "
       + "a deploy whose release does not publish that page is refused, naming the form and the page. The path in "
       + "each release is the one the page has in that release, so the published form never asks the site where "
-      + "to go. The page must be one you created, the home page included: a generated page (folder, tag or "
-      + "archive index), the 404 page, a legal page (help page legal), a profile home and an integration-managed page are refused as forms.page_not_allowed. The button text and the confirmation belong to the form, not to the page that places it: "
+      + "to go. The page must be one you created, the home page included: a generated page (a folder index or "
+      + "the published archive), the 404 page, a legal page (help page legal), a profile home and an integration-managed page are refused as forms.page_not_allowed. The button text and the confirmation belong to the form, not to the page that places it: "
       + "the 'form' component takes only formKey.",
       "A form's contact address is the value of one email field, stored with each submission. That is what lets the "
       + "owner find and delete every row for a visitor who asks. With exactly one email field, that field is the "

package/src/site-checks.js

@@ -280,6 +280,15 @@ export function normalizeRedirectPath(value) {
     return trimmed === "" ? "/" : trimmed;
 }
 const GENERATED_ROOT_FILES = ["404.html", "sitemap.xml", "robots.txt", "favicon.ico"];
+// The IndexNow key file (TR01304) is named by a pattern, so it cannot join the list above.
+const INDEX_NOW_KEY_FILE = /^[a-f0-9]{32}\.txt$/u;
+// The /published archive's data files (TR01309): months.json and yyyy/mm.json, with anything beneath either;
+// a marker at one of those names fails every publish in the generator's occupancy check. The API mirror is
+// SiteRedirectMap.IsPublishedArchiveDataPath.
+const PUBLISHED_ARCHIVE_ROOT = "published";
+const ARCHIVE_MONTHS_FILE = "months.json";
+const ARCHIVE_YEAR_SEGMENT = /^\d{4}$/u;
+const ARCHIVE_MONTH_FILE = /^\d{2}\.json$/iu;
 const INTEGRATION_DATA_ROOT = "integrations";
 const MAX_MARKER_SEGMENT_BYTES = 200;
 const MAX_OUTPUT_PATH_LENGTH = 1_024;
@@ -288,6 +297,18 @@ function isWindowsDeviceSegment(segment) {
     const stem = segment.split(".", 1)[0].toLowerCase();
     return WINDOWS_DEVICE_STEMS.has(stem) || /^(?:com|lpt)[1-9]$/u.test(stem);
 }
+function isPublishedArchiveDataPath(segments) {
+    if (segments.length < 2 || segments[0].toLowerCase() !== PUBLISHED_ARCHIVE_ROOT)
+        return false;
+    if (segments[1].toLowerCase() === ARCHIVE_MONTHS_FILE)
+        return true;
+    return segments.length >= 3 && ARCHIVE_YEAR_SEGMENT.test(segments[1]) && ARCHIVE_MONTH_FILE.test(segments[2]);
+}
+// The /map page's data file (TR01321), with anything beneath it, for the same reason.
+// The API mirrors this in SiteRedirectMap.IsPlaceMapDataPath.
+function isPlaceMapDataPath(segments) {
+    return segments.length >= 2 && segments[0].toLowerCase() === "map" && segments[1].toLowerCase() === "places.json";
+}
 function isStorable(decoded) {
     const output = `${decoded}/index.html`;
     if (output !== output.normalize("NFC") || output.length > MAX_OUTPUT_PATH_LENGTH || output.startsWith("/")
@@ -317,8 +338,11 @@ export function redirectSourceRule(edgePath) {
         return refuse(RULE_REDIRECT_SOURCE_INTEGRATION_DATA);
     if (isRuntimeMirrorPath(decoded))
         return refuse(RULE_REDIRECT_SOURCE_RUNTIME_MIRROR);
-    if (GENERATED_ROOT_FILES.includes(first.toLowerCase()))
+    if (GENERATED_ROOT_FILES.includes(first.toLowerCase()) || INDEX_NOW_KEY_FILE.test(first.toLowerCase())
+        || isPublishedArchiveDataPath(segments)
+        || isPlaceMapDataPath(segments)) {
         return refuse(RULE_REDIRECT_SOURCE_GENERATED_FILE);
+    }
     if (!isStorable(decoded))
         return refuse(RULE_REDIRECT_SOURCE_NOT_STORABLE);
     return undefined;

package/src/typed-page-reference.js

@@ -77,7 +77,7 @@ const FIELD_HELP = Object.freeze({
     description:
       "The Taproot place being reviewed. The site fills in its name, address and coordinates from this record. Find "
       + "it with 'places search <name and city>' and 'places select <googlePlaceId> <sessionToken>'. The site publishes the "
-      + "place's category in the byline and files the review under /places/<category>; change it for this site with "
+      + "place's category in the byline; change it for this site with "
       + "'places category set <placeId> <category>'.",
   },
   place: {
@@ -263,7 +263,7 @@ const TYPE_DETAILS = Object.freeze({
   },
   [TEMPLATE_PLACE_REVIEW]: {
     displayName: "Place review",
-    summary: "A review of a place with a three-step rating, listed on the site's places archive.",
+    summary: "A review of a place with a three-step rating; its address card opens the place on Google Maps, and its location byline opens the site's map page when it has one.",
     body: "Everything after the front matter is the review body.",
     markdownExample: PLACE_REVIEW_EXAMPLE,
     documentExample: documentExample(
@@ -284,20 +284,14 @@ const TYPE_DETAILS = Object.freeze({
   [TEMPLATE_GENERATED]: {
     displayName: "Generated page",
     summary:
-      "A listing Taproot generates from the site's content: a tag, the tags index, a published year or month, a place "
-      + "archive, or a folder. You cannot create one; you customize its title, breadcrumb, description and introduction.",
+      "A listing Taproot generates from the site's content: the published archive, the map or a folder. You cannot create "
+      + "one; you customize its title, breadcrumb, description and introduction. A folder index is a search "
+      + "destination when it has an introduction or renders at least three cards; otherwise it carries noindex.",
     documentExample: documentExample(
       TEMPLATE_GENERATED,
       {},
       {
-        kind: "GENERATED_PAGE_KIND_TAG",
-        tagId: "0198a3f2-7c4e-4a10-9b2d-3f6e5d4c3b2a",
-        year: 0,
-        month: 0,
-        countryCode: "",
-        regionCode: "",
-        citySlug: "",
-        categorySlug: "",
+        kind: "GENERATED_PAGE_KIND_FOLDER_INDEX",
         customTitle: "Trail notes",
         breadcrumbTitle: "",
         customDescription: "Field notes from the trails I walk most often.",
@@ -305,8 +299,7 @@ const TYPE_DETAILS = Object.freeze({
       },
     ),
     dataFields: [
-      "kind and the identity fields (tagId, year, month, countryCode, regionCode, citySlug, categorySlug): what the "
-      + "page is, written by pull. Leave them as pulled; a push that changes them is refused (pages.generated_identity)",
+      "kind: what the page is, written by pull. Leave it as pulled; a push that changes it is refused (pages.generated_identity)",
       "customTitle: string; empty uses the generated title (the page's reader-facing title)",
       "breadcrumbTitle: string; empty uses the generated label (used on pages beneath this one)",
       "customDescription: string, at most 1000 characters, about 160 shown in search results; empty uses the "

package/src/typed-pages.js

@@ -32,7 +32,7 @@ export const TEMPLATE_ALBUM = "album";
 export const TEMPLATE_PLACE_REVIEW = "place-review";
 export const TEMPLATE_LEGAL = "legal";
 /**
- * A page Taproot generates (a tag, a month, a folder). It is update-only: the
+ * A page Taproot generates (the published archive, the map or a folder). It is update-only: the
  * owner's title, breadcrumb, description and introduction are authored, and
  * pages push refuses to create one or to change what it is (TR01195).
  */
@@ -111,9 +111,18 @@ const RECIPE_HEADINGS = Object.freeze(["ingredients", "instructions"]);
 
 /** The generated page kinds the site reports, as the API names them (never the unknown kind). */
 export const GENERATED_PAGE_KINDS = Object.freeze([
+  "GENERATED_PAGE_KIND_PUBLISHED_INDEX",
+  "GENERATED_PAGE_KIND_FOLDER_INDEX",
+  "GENERATED_PAGE_KIND_MAP_INDEX",
+]);
+/**
+ * The kinds Taproot no longer generates (TR01308, TR01309, TR01310), which an older
+ * pull may have written. Named, so a typo or the unknown kind is refused as a bad
+ * document and is never mistaken for a page Taproot retired.
+ */
+export const RETIRED_GENERATED_PAGE_KINDS = Object.freeze([
   "GENERATED_PAGE_KIND_TAG",
   "GENERATED_PAGE_KIND_TAGS_INDEX",
-  "GENERATED_PAGE_KIND_PUBLISHED_INDEX",
   "GENERATED_PAGE_KIND_PUBLISHED_YEAR",
   "GENERATED_PAGE_KIND_PUBLISHED_MONTH",
   "GENERATED_PAGE_KIND_PLACES_INDEX",
@@ -121,18 +130,10 @@ export const GENERATED_PAGE_KINDS = Object.freeze([
   "GENERATED_PAGE_KIND_PLACES_STATE",
   "GENERATED_PAGE_KIND_PLACES_CITY",
   "GENERATED_PAGE_KIND_PLACES_CATEGORY",
-  "GENERATED_PAGE_KIND_FOLDER_INDEX",
 ]);
 /** What a generated page is: system-managed, so a push must send it back unchanged. */
 export const GENERATED_IDENTITY_KEYS = Object.freeze([
   "kind",
-  "tagId",
-  "year",
-  "month",
-  "countryCode",
-  "regionCode",
-  "citySlug",
-  "categorySlug",
 ]);
 const GENERATED_KEYS = [
   ...GENERATED_IDENTITY_KEYS,
@@ -142,17 +143,10 @@ const GENERATED_KEYS = [
   "introductionBody",
 ];
 const GENERATED_TEXT_KEYS = [
-  "tagId",
-  "countryCode",
-  "regionCode",
-  "citySlug",
-  "categorySlug",
   "customTitle",
   "breadcrumbTitle",
   "customDescription",
 ];
-const GENERATED_MAXIMUM_YEAR = 9999;
-const GENERATED_MAXIMUM_MONTH = 12;
 const EMPTY_DOCUMENT = Object.freeze({ type: "doc", content: Object.freeze([]) });
 
 function fail(code, message, field) {
@@ -368,13 +362,6 @@ const DATA_BUILDERS = Object.freeze({
   [TEMPLATE_GENERATED]: (raw) =>
     definedEntries([
       ["kind", raw.kind],
-      ["tagId", raw.tagId ?? ""],
-      ["year", raw.year ?? 0],
-      ["month", raw.month ?? 0],
-      ["countryCode", raw.countryCode ?? ""],
-      ["regionCode", raw.regionCode ?? ""],
-      ["citySlug", raw.citySlug ?? ""],
-      ["categorySlug", raw.categorySlug ?? ""],
       ["customTitle", raw.customTitle ?? ""],
       ["breadcrumbTitle", raw.breadcrumbTitle ?? ""],
       ["customDescription", raw.customDescription ?? ""],
@@ -479,9 +466,6 @@ function canonicalSourceData(template, data, file) {
     for (const key of GENERATED_TEXT_KEYS) {
       if (data[key] !== undefined) requireString(data[key], file, `${path}.${key}`);
     }
-    if (data.tagId !== undefined && data.tagId !== "") requireIdentifier(data.tagId, file, `${path}.tagId`);
-    if (data.year !== undefined) requireCount(data.year, file, `${path}.year`, GENERATED_MAXIMUM_YEAR);
-    if (data.month !== undefined) requireCount(data.month, file, `${path}.month`, GENERATED_MAXIMUM_MONTH);
     // The API trims a description, so the length that counts is the trimmed one.
     const customDescription = data.customDescription?.trim();
     requireDescriptionLength(customDescription, `${file}:${path}.customDescription`);
@@ -658,8 +642,6 @@ const PAGE_PROJECTIONS = Object.freeze({
       ? DATA_BUILDERS[TEMPLATE_GENERATED]({
         kind: raw.kind,
         ...Object.fromEntries(GENERATED_TEXT_KEYS.map((key) => [key, typeof raw[key] === "string" ? raw[key] : ""])),
-        year: Number.isSafeInteger(raw.year) ? raw.year : 0,
-        month: Number.isSafeInteger(raw.month) ? raw.month : 0,
         introductionBody: presentIntroduction(raw.introductionBody),
       })
       : undefined,

package/src/verbs/pages-push.js

@@ -51,6 +51,7 @@ import {
   FRONT_MATTER_KEYS,
   PAGE_TEMPLATES,
   requireTemplateName,
+  RETIRED_GENERATED_PAGE_KINDS,
   sentDisplayDate,
   TEMPLATE_FREE_FORM,
   TEMPLATE_GENERATED,
@@ -486,6 +487,20 @@ function peekJsonTemplate(text) {
   }
 }
 
+/**
+ * Whether a generated-page source names a kind Taproot retired (TR01308). The
+ * site deletes such a page on its next synchronization, but until then it is still listed,
+ * so a pulled source of that kind is judged here, before its document is read.
+ */
+function isRetiredGeneratedSource(source) {
+  if (source.template !== TEMPLATE_GENERATED || typeof source.text !== "string") return false;
+  try {
+    return RETIRED_GENERATED_PAGE_KINDS.includes(JSON.parse(source.text)?.data?.kind);
+  } catch {
+    return false;
+  }
+}
+
 /**
  * Reads one editable page source and resolves the metadata that says *which
  * page it is* — no Markdown conversion, no media resolution, no document
@@ -1293,7 +1308,6 @@ export async function planPages({
       let observedRecord;
       let legalRevisionGuard;
       requireCompletePageMetadata(source);
-      const document_ = await convertWorkspacePageSource({ source, mediaManifest, content });
 
       const target = manifestEntry?.pageId !== undefined
         ? liveById.get(manifestEntry.pageId)
@@ -1307,21 +1321,26 @@ export async function planPages({
           file,
         );
       }
-      const generated = documentTemplate(document_) === TEMPLATE_GENERATED;
-      if (documentTemplate(document_) === TEMPLATE_LEGAL && target === undefined && manifestEntry?.pageId !== undefined) {
-        throw documentError("pages.legal_missing", `'${file}' tracks a legal page that the site no longer lists. Pull and reconcile it before creating another page.`, file);
-      }
-      if (generated && target === undefined) {
+      // A generated source the site no longer has, or whose kind Taproot retired
+      // (TR01308; the site deletes the page on its next synchronization), is
+      // judged before its document is read: it is reported stale like any
+      // other and never refused as an unknown kind that blocks the push.
+      const generated = source.template === TEMPLATE_GENERATED;
+      const retiredKind = generated && isRetiredGeneratedSource(source);
+      if (generated && (target === undefined || retiredKind)) {
         if (targeted) {
           throw documentError(
             "pages.generated_create",
-            `'${file}' is a generated-page source, but the site has no generated page for it. Taproot creates `
-              + "generated pages from the site's content; a push cannot create one. If the page no longer exists, "
-              + "delete this file and run 'taproot-site pull'.",
+            retiredKind
+              ? `'${file}' is the source of a generated page of a kind Taproot no longer publishes, and a push `
+                + "cannot send one. Delete the file."
+              : `'${file}' is a generated-page source, but the site has no generated page for it. Taproot creates `
+                + "generated pages from the site's content; a push cannot create one. If the page no longer exists, "
+                + "delete this file and run 'taproot-site pull'.",
             file,
           );
         }
-        // The site retired this page (its tag, month, place or folder is gone),
+        // The site retired this page (its folder or its kind is gone),
         // which is Taproot's doing, not a mistake in the workspace: it cannot
         // block the pages that do exist.
         staleGenerated.push({ file, path: displayPagePath(pagePath) });
@@ -1331,6 +1350,10 @@ export async function planPages({
         );
         return;
       }
+      const document_ = await convertWorkspacePageSource({ source, mediaManifest, content });
+      if (documentTemplate(document_) === TEMPLATE_LEGAL && target === undefined && manifestEntry?.pageId !== undefined) {
+        throw documentError("pages.legal_missing", `'${file}' tracks a legal page that the site no longer lists. Pull and reconcile it before creating another page.`, file);
+      }
       // The file-keyed entry is gone whenever the file was renamed or replaced —
       // which is exactly what the pull, delete the `.pm.json`, author a `.md`
       // flow does. Falling back through the page's own identity keeps the
@@ -1371,7 +1394,7 @@ export async function planPages({
         && targetEntry.file === file
         && targetEntry.sourceFormat === source.sourceFormat;
       // An untouched generated page is not this push's to judge. Taproot
-      // moves its revision and its path on its own (a tag rename, a month that
+      // moves its revision and its path on its own (a folder that
       // gained a post), and refusing the whole push for a page nothing here
       // sends would make one renamed page block every other edit.
       let untouchedGenerated = false;

package/src/verbs/places.js

@@ -83,8 +83,8 @@ export async function placesSelect(invocation) {
  *
  * A place's category is shared by every site, and Google's types do not always
  * give the one an owner wants. The override is the site's alone: its place
- * reviews and `/places/<category>` pages use it from the next deployment, and
- * the platform-wide place is never changed. The server owns the closed list, so
+ * reviews use it from the next deployment, and the platform-wide place is
+ * never changed. The server owns the closed list, so
  * the CLI sends the name as given and lets the server check it.
  */
 export async function placesCategorySet(invocation) {

package/src/verbs/pull.js

@@ -728,7 +728,7 @@ export async function pull(invocation) {
       registeredFiles.add(record.file);
     }
     const tracked = await resolveTrackedSources(config.workspaceDir, authorable, registry, onProgress);
-    // A generated page the site retired (its tag, month, place or folder is
+    // A generated page the site retired (its folder or its kind is
     // gone) leaves its pulled file behind: authored content, so pull will not
     // delete it, and settles it before naming any page's file so that a page
     // created since at the same path never writes over it. It is recorded