@forumone/throughline 2.1.0 → 2.2.0-next-623d42c

package/dist/publishing/pipeline/steps/link-targets.js

@@ -0,0 +1,293 @@
+import { blockRegistry } from '../../../references/find.js';
+import { linkTargetsIn } from '../../../references/links.js';
+import { resolveCollection } from '../../options.js';
+/*
+Refuses a publish whose links go to pages readers cannot see (forumone-2026#756).
+
+An internal link stores a relationship and the renderer resolves it when the
+page is read. If the target is a draft, in the trash or deleted, the link
+renders as nothing or as a 404, and nothing told the editor who published the
+page. Moving a page to the trash is routine since the content trash, so this got
+likelier rather than rarer.
+
+## Its own step, not an accessibility check
+
+The accessibility checks are pure functions of the document. This one has to
+ask the database about other documents, so it is a step with `ctx.payload`, and
+it runs after the pure content checks and before the policy steps.
+
+## What it reads
+
+- **The document again, at `depth: 0`.** The pipeline's copy was read at
+  Payload's default depth, and population replaces a trashed target with
+  `null`: the very link this is looking for would have lost its id.
+- **Each linked collection once**, `where: { id: { in } }`, with `trash: true`
+  so a trashed target comes back with its `deletedAt` rather than looking
+  deleted, and `draft: false` so `_status` is the live row's.
+- **The latest draft of unpublished targets**, only in collections that can
+  carry a schedule, because a schedule lives on the latest version.
+
+All with `overrideAccess: true`: the question is what a reader will get, not
+what the person publishing may read.
+
+## The verdicts
+
+- not found: deleted, an error;
+- `deletedAt` set: in the trash, an error;
+- drafts enabled and not published: an error, unless the target is publishable
+  and has a scheduled publish time, which is a warning. A page scheduled to go
+  live with the page it links to is legitimate;
+- anything else, including a collection without drafts: published.
+
+A link back to the document being published is skipped: publishing it is what
+makes it live.
+*/
+const CODE = 'link-targets';
+function keyOf(relationTo, id) {
+    return `${relationTo}\u0000${String(id)}`;
+}
+function configOf(payload, slug) {
+    const collections = payload
+        .collections;
+    return collections?.[slug]?.config;
+}
+/** A label that may be a string, a record of translations, or a function. */
+function textOf(label) {
+    if (typeof label === 'string' && label.trim() !== '')
+        return label;
+    if (label && typeof label === 'object') {
+        const record = label;
+        const preferred = record['en'] ?? Object.values(record).find((v) => typeof v === 'string');
+        if (typeof preferred === 'string' && preferred.trim() !== '')
+            return preferred;
+    }
+    return undefined;
+}
+/** `CardGrid` → `Card Grid`, `heroImage` → `Hero image`, for a config with no label. */
+function humanize(name) {
+    const words = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/[_-]+/g, ' ')
+        .trim();
+    return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function article(noun) {
+    return /^[aeiou]/i.test(noun) ? 'an' : 'a';
+}
+function singularOf(config, slug) {
+    const labels = config?.labels;
+    return textOf(labels?.singular) ?? humanize(slug);
+}
+function blockLabel(block) {
+    const labels = block.labels;
+    return textOf(labels?.singular) ?? humanize(block.slug);
+}
+/** Where the link is, in the editor's terms: "block 3 (Card Grid)", "the Body field". */
+function placeOf(link) {
+    const { block, top } = link.at;
+    if (block)
+        return `block ${block.index + 1} (${blockLabel(block.block)})`;
+    if (top)
+        return `the ${textOf(top.label) ?? humanize(top.name)} field`;
+    return 'this page';
+}
+/**
+ * The same place as an issue's `where`, which the admin prints before the
+ * message: "Block 3 (Card Grid)", "Body". `undefined` when there is no place
+ * more particular than the page.
+ */
+function whereOf(link) {
+    const { block, top } = link.at;
+    if (block)
+        return `Block ${block.index + 1} (${blockLabel(block.block)})`;
+    if (top)
+        return textOf(top.label) ?? humanize(top.name);
+    return undefined;
+}
+function quoted(title) {
+    return title ? `"${title}"` : undefined;
+}
+/**
+ * An issue's message, which goes out beside its `where` and so starts "This
+ * link"; a warning is a line on its own, and says where the link is itself.
+ */
+function messageFor(link, verdict, singular, placed) {
+    const where = placed ? 'This link' : `A link in ${placeOf(link)}`;
+    switch (verdict.kind) {
+        case 'deleted':
+            return `${where} goes to ${article(singular)} ${singular} that has been deleted. Change the link.`;
+        case 'trash': {
+            const name = quoted(verdict.title) ?? `${article(singular)} ${singular}`;
+            return `${where} goes to ${name}, which is in the trash. Restore it, or change the link.`;
+        }
+        case 'draft': {
+            const name = quoted(verdict.title);
+            return name
+                ? `${where} goes to ${name}, which is a draft, so readers would get a page that doesn't exist. Publish ${name} first, or change the link.`
+                : `${where} goes to ${article(singular)} ${singular} that is a draft, so readers would get a page that doesn't exist. Publish it first, or change the link.`;
+        }
+        case 'scheduled': {
+            const name = quoted(verdict.title) ?? `${article(singular)} ${singular}`;
+            return `${where} goes to ${name}, which isn't published yet but is scheduled to be. Until it goes live, readers who follow the link will get a page that doesn't exist.`;
+        }
+        case 'published':
+            return '';
+    }
+}
+function hasDrafts(config) {
+    const { versions } = config;
+    return Boolean(versions && typeof versions === 'object' && versions.drafts);
+}
+function titleOf(doc, field) {
+    const value = doc?.[field];
+    return typeof value === 'string' && value.trim() !== '' ? value : undefined;
+}
+/** One collection's targets, classified. One query, plus one for unpublished targets that may be scheduled. */
+async function classify(ctx, slug, config, ids) {
+    const drafts = hasDrafts(config);
+    const titleField = config.admin?.useAsTitle ?? 'id';
+    const select = { [titleField]: true };
+    if (drafts)
+        select['_status'] = true;
+    if (config.trash)
+        select['deletedAt'] = true;
+    const found = await ctx.payload.find({
+        collection: slug,
+        where: { id: { in: ids } },
+        draft: false,
+        ...(config.trash ? { trash: true } : {}),
+        depth: 0,
+        overrideAccess: true,
+        limit: ids.length,
+        pagination: false,
+        select,
+    });
+    const rows = new Map();
+    for (const doc of found.docs)
+        rows.set(String(doc['id']), doc);
+    const verdicts = new Map();
+    const unpublished = [];
+    for (const id of ids) {
+        const row = rows.get(String(id));
+        if (!row)
+            verdicts.set(String(id), { kind: 'deleted' });
+        else if (row['deletedAt'])
+            verdicts.set(String(id), { kind: 'trash', title: titleOf(row, titleField) });
+        else if (drafts && row['_status'] !== 'published')
+            unpublished.push(id);
+        else
+            verdicts.set(String(id), { kind: 'published' });
+    }
+    const publishable = ctx.options.collections.some((c) => c.slug === slug);
+    const scheduledField = publishable
+        ? resolveCollection(ctx.options, slug).scheduledPublishField
+        : undefined;
+    let latest = new Map();
+    if (unpublished.length > 0) {
+        const drafted = await ctx.payload.find({
+            collection: slug,
+            where: { id: { in: unpublished } },
+            draft: true,
+            depth: 0,
+            overrideAccess: true,
+            limit: unpublished.length,
+            pagination: false,
+            select: { [titleField]: true, ...(scheduledField ? { [scheduledField]: true } : {}) },
+        });
+        latest = new Map(drafted.docs.map((d) => [String(d['id']), d]));
+    }
+    for (const id of unpublished) {
+        const draft = latest.get(String(id));
+        const title = titleOf(draft, titleField) ?? titleOf(rows.get(String(id)), titleField);
+        const scheduled = scheduledField ? draft?.[scheduledField] : undefined;
+        verdicts.set(String(id), scheduled !== undefined && scheduled !== null && scheduled !== ''
+            ? { kind: 'scheduled', title }
+            : { kind: 'draft', title });
+    }
+    return verdicts;
+}
+/** The document as stored, ids unpopulated; the pipeline's copy when it cannot be read. */
+async function storedDocument(ctx) {
+    const stored = await ctx.payload.findByID({
+        collection: ctx.collection.slug,
+        id: ctx.documentId,
+        draft: true,
+        depth: 0,
+        overrideAccess: true,
+        disableErrors: true,
+    });
+    return stored ?? ctx.document;
+}
+export const linkTargetsStep = async (ctx) => {
+    if (ctx.options.linkTargets?.enabled === false)
+        return { pass: true };
+    const own = configOf(ctx.payload, ctx.collection.slug);
+    if (!own)
+        return { pass: true };
+    let links;
+    const verdicts = new Map();
+    try {
+        const data = await storedDocument(ctx);
+        links = linkTargetsIn(own.fields, data, {
+            blocks: blockRegistry(ctx.payload),
+        }).filter((link) => !(link.relationTo === ctx.collection.slug && String(link.id) === ctx.documentId));
+        if (links.length === 0)
+            return { pass: true };
+        const byCollection = new Map();
+        for (const link of links) {
+            const ids = byCollection.get(link.relationTo) ?? new Map();
+            ids.set(String(link.id), link.id);
+            byCollection.set(link.relationTo, ids);
+        }
+        for (const [slug, ids] of byCollection) {
+            const config = configOf(ctx.payload, slug);
+            // A collection the config no longer has: nothing to ask, and nothing a reader can reach either way.
+            if (!config)
+                continue;
+            for (const [id, verdict] of await classify(ctx, slug, config, [...ids.values()])) {
+                verdicts.set(keyOf(slug, id), verdict);
+            }
+        }
+    }
+    catch (error) {
+        ctx.payload.logger?.error?.({ err: error }, '[publishing] link-targets: could not read link targets');
+        return {
+            pass: false,
+            code: CODE,
+            reason: "Couldn't check where this page's links go, so it hasn't been published. Try again, and if it keeps happening, tell a site administrator.",
+        };
+    }
+    const errors = [];
+    const warnings = [];
+    for (const link of links) {
+        const verdict = verdicts.get(keyOf(link.relationTo, link.id));
+        if (!verdict || verdict.kind === 'published')
+            continue;
+        const singular = singularOf(configOf(ctx.payload, link.relationTo), link.relationTo);
+        if (verdict.kind === 'scheduled') {
+            warnings.push(messageFor(link, verdict, singular, false));
+            continue;
+        }
+        const where = whereOf(link);
+        errors.push({
+            field: link.at.dataPath,
+            message: messageFor(link, verdict, singular, where !== undefined),
+            severity: 'error',
+            rule: verdict.kind,
+            ...(where ? { where } : {}),
+        });
+    }
+    const carried = warnings.length ? { warnings } : {};
+    if (errors.length === 0)
+        return { pass: true, ...carried };
+    return {
+        ...carried,
+        pass: false,
+        code: CODE,
+        reason: errors.length === 1
+            ? "1 link goes to a page readers can't see."
+            : `${errors.length} links go to pages readers can't see.`,
+        issues: errors,
+    };
+};
+//# sourceMappingURL=link-targets.js.map

package/dist/publishing/pipeline/steps/link-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-targets.js","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/link-targets.ts"],"names":[],"mappings":"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"}

package/dist/publishing/pipeline/steps/required-fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"required-fields.d.ts","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/required-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAA;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAiDhC,CAAA"}
+{"version":3,"file":"required-fields.d.ts","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/required-fields.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAA;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAkDhC,CAAA"}

package/dist/publishing/pipeline/steps/required-fields.js

@@ -1,3 +1,4 @@
+import { plural } from '../../messages.js';
 /**
  * Verifies SEO title/description, slug, and any per-collection required
  * fields are populated. SEO requirements are non-negotiable: a published
@@ -10,21 +11,21 @@ export const requiredFieldsStep = async (ctx) => {
     if (!nonEmptyString(seo?.['title'])) {
         issues.push({
             field: `${ctx.collection.seoField}.title`,
-            message: 'SEO title is required',
+            message: "Add an SEO title. It's the title shown in search results and on the browser tab.",
             severity: 'error',
         });
     }
     if (!nonEmptyString(seo?.['description'])) {
         issues.push({
             field: `${ctx.collection.seoField}.description`,
-            message: 'SEO description is required',
+            message: 'Add an SEO description. Search engines show it under the title.',
             severity: 'error',
         });
     }
     if (!nonEmptyString(ctx.document[ctx.collection.slugField])) {
         issues.push({
             field: ctx.collection.slugField,
-            message: 'Slug is required',
+            message: "Add a slug, the last part of this page's web address.",
             severity: 'error',
         });
     }
@@ -42,9 +43,10 @@ export const requiredFieldsStep = async (ctx) => {
         return {
             pass: false,
             code: 'required-fields-missing',
-            reason: `${issues.length} required field${issues.length === 1 ? '' : 's'} missing`,
+            reason: `${plural(issues.length, 'required field')} ${issues.length === 1 ? 'is' : 'are'} empty.`,
+            // No suggestion: each issue says what to add, and the admin marks the
+            // fields themselves and says so.
             issues,
-            suggestion: 'Fill in the missing fields and try again.',
         };
     }
     return { pass: true };

package/dist/publishing/pipeline/steps/required-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"required-fields.js","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/required-fields.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5D,MAAM,MAAM,GAAoB,EAAE,CAAA;IAClC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAwC,CAAA;IAExF,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,QAAQ;YACzC,OAAO,EAAE,uBAAuB;YAChC,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,cAAc;YAC/C,OAAO,EAAE,6BAA6B;YACtC,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,SAAS;YAC/B,OAAO,EAAE,kBAAkB;YAC3B,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,kBAAkB,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU;YAClF,MAAM;YACN,UAAU,EAAE,2CAA2C;SACxD,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,OAAO,CAAC,GAA4B,EAAE,IAAY;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACtD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAQ,GAA+B,CAAC,OAAO,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,EAAE,GAAG,CAAC,CAAA;AACT,CAAC"}
+{"version":3,"file":"required-fields.js","sourceRoot":"","sources":["../../../../src/publishing/pipeline/steps/required-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAG1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiB,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5D,MAAM,MAAM,GAAoB,EAAE,CAAA;IAClC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAwC,CAAA;IAExF,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,QAAQ;YACzC,OAAO,EAAE,kFAAkF;YAC3F,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,cAAc;YAC/C,OAAO,EAAE,iEAAiE;YAC1E,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,SAAS;YAC/B,OAAO,EAAE,uDAAuD;YAChE,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,QAAQ,CAAC,IAAI;gBACpB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YACjG,sEAAsE;YACtE,iCAAiC;YACjC,MAAM;SACP,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AACzD,CAAC;AAED,SAAS,OAAO,CAAC,GAA4B,EAAE,IAAY;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACtD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAQ,GAA+B,CAAC,OAAO,CAAC,CAAA;QAClD,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC,EAAE,GAAG,CAAC,CAAA;AACT,CAAC"}

package/dist/publishing/pipeline/types.d.ts

@@ -1,6 +1,7 @@
 import type { Inngest } from 'inngest';
 import type { Payload, TypedUser } from 'payload';
 import type { AuthenticatedUser } from '../../plugin-contract/mcp.js';
+import type { MessageDate } from '../messages.js';
 import type { AccessibilityIssue, PublishingPluginOptions, ResolvedCollection } from '../options.js';
 export interface PipelineActor {
     user: AuthenticatedUser | null;
@@ -44,13 +45,35 @@ export interface PipelineContext {
 }
 export type PipelineIssue = AccessibilityIssue & {
     rule?: string;
+    /**
+     * Where `field` is, as the editor sees it: `Block 3 (Image Hero) › Image`.
+     * Filled in by the pipeline from the collection's own labels, so a check
+     * reports a path and never has to know them. Absent when the path cannot be
+     * followed, in which case nothing better than the message itself is known.
+     * forumone-2026#805.
+     */
+    where?: string;
 };
+/**
+ * The date a block is about — an embargo's end, an expiry — as written into
+ * its `reason`. See `MessageDate` in `../messages.ts`.
+ */
+export type PipelineDate = MessageDate;
 export interface PipelineStepResult {
     pass: boolean;
     reason?: string;
     code?: string;
     issues?: PipelineIssue[];
     suggestion?: string;
+    /** The date in `reason`, so the admin can say it in the editor's own zone. */
+    when?: PipelineDate;
+    /**
+     * What a developer needs to fix a block no editor can: a plugin missing, a
+     * resolver not wired. Logged by the pipeline, kept in the result for an MCP
+     * caller, and never shown in the admin, whose `reason` says to tell a site
+     * administrator instead.
+     */
+    detail?: string;
     /**
      * Non-fatal problems. The step did what it was asked to; something
      * adjacent to it did not. Warnings never fail a step.
@@ -65,6 +88,8 @@ export interface PipelineResult {
     code?: string;
     issues?: PipelineIssue[];
     suggestion?: string;
+    when?: PipelineDate;
+    detail?: string;
     publishedAt?: string;
     /** Non-fatal problems collected across the steps that ran. */
     warnings?: string[];

package/dist/publishing/pipeline/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/publishing/pipeline/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,uBAAuB,CAAA;IAChC,UAAU,EAAE,kBAAkB,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEpF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/publishing/pipeline/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EACV,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,eAAe,CAAA;AAEtB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,uBAAuB,CAAA;IAChC,UAAU,EAAE,kBAAkB,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,aAAa,CAAA;IACpB,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAA;AAEtC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAA;AAEpF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB"}

package/dist/publishing/pipeline/where.d.ts

@@ -0,0 +1,13 @@
+import { type FieldConfig } from '../../utils/field-path.js';
+import type { PipelineContext, PipelineIssue } from './types.js';
+export { describeFieldPath, type FieldConfig } from '../../utils/field-path.js';
+/** The config for `ctx.collection`, or `undefined` when Payload has none to give. */
+export declare function fieldConfigFor(ctx: Pick<PipelineContext, 'payload' | 'collection'>): FieldConfig | undefined;
+/**
+ * The label a block of `type` has in the collection's layout field, or the
+ * component's display name when the config does not say.
+ */
+export declare function blockLabel(config: FieldConfig | undefined, type: string): string;
+/** Fills in `where` on every issue whose path can be described. */
+export declare function withWhere(issues: PipelineIssue[], config: FieldConfig | undefined, document: Record<string, unknown>): PipelineIssue[];
+//# sourceMappingURL=where.d.ts.map

package/dist/publishing/pipeline/where.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"where.d.ts","sourceRoot":"","sources":["../../../src/publishing/pipeline/where.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EAMjB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAWhE,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE/E,qFAAqF;AACrF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,YAAY,CAAC,GACnD,WAAW,GAAG,SAAS,CAYzB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKhF;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CACvB,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,aAAa,EAAE,CAOjB"}

package/dist/publishing/pipeline/where.js

@@ -0,0 +1,44 @@
+import { componentDisplayName } from '@forumone/throughline-design-system/contract';
+import { describeFieldPath, findBlock, findField, labelText, } from '../../utils/field-path.js';
+/*
+Where an issue is, in the editor's words. forumone-2026#805.
+
+Every issue a step returns gains a `where` — `Block 3 (Image Hero) › Image`,
+`SEO › Title` — from the collection's own field config, by
+`describeFieldPath`. So a site's own checks get it too, report a path, and
+never have to know a label.
+*/
+export { describeFieldPath } from '../../utils/field-path.js';
+/** The config for `ctx.collection`, or `undefined` when Payload has none to give. */
+export function fieldConfigFor(ctx) {
+    const payload = ctx.payload;
+    const fields = payload.collections?.[ctx.collection.slug]?.config?.fields;
+    if (!Array.isArray(fields))
+        return undefined;
+    return {
+        fields,
+        ...(Array.isArray(payload.config?.blocks) ? { blocks: payload.config.blocks } : {}),
+        layoutField: ctx.collection.layoutField,
+    };
+}
+/**
+ * The label a block of `type` has in the collection's layout field, or the
+ * component's display name when the config does not say.
+ */
+export function blockLabel(config, type) {
+    const layout = config?.layoutField !== undefined ? findField(config.fields, config.layoutField)?.field : undefined;
+    const block = layout?.type === 'blocks' && config ? findBlock(layout, type, config) : undefined;
+    return labelText(block?.labels?.singular) ?? componentDisplayName(type);
+}
+/** Fills in `where` on every issue whose path can be described. */
+export function withWhere(issues, config, document) {
+    if (!config)
+        return issues;
+    return issues.map((issue) => {
+        if (issue.where || !issue.field)
+            return issue;
+        const where = describeFieldPath(issue.field, config, document);
+        return where ? { ...issue, where } : issue;
+    });
+}
+//# sourceMappingURL=where.js.map

package/dist/publishing/pipeline/where.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"where.js","sourceRoot":"","sources":["../../../src/publishing/pipeline/where.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAA;AACnF,OAAO,EAIL,iBAAiB,EACjB,SAAS,EACT,SAAS,EACT,SAAS,GACV,MAAM,2BAA2B,CAAA;AAGlC;;;;;;;EAOE;AAEF,OAAO,EAAE,iBAAiB,EAAoB,MAAM,2BAA2B,CAAA;AAE/E,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAC5B,GAAoD;IAEpD,MAAM,OAAO,GAAG,GAAG,CAAC,OAGnB,CAAA;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAA;IACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IAC5C,OAAO;QACL,MAAM;QACN,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,WAAW;KACxC,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAA+B,EAAE,IAAY;IACtE,MAAM,MAAM,GACV,MAAM,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;IACrG,MAAM,KAAK,GAAG,MAAM,EAAE,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC/F,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAA;AACzE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,SAAS,CACvB,MAAuB,EACvB,MAA+B,EAC/B,QAAiC;IAEjC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAA;IAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QAC7C,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC9D,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IAC5C,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/publishing/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/publishing/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAI7D,OAAO,EAAE,KAAK,uBAAuB,EAAsC,MAAM,cAAc,CAAA;AAmB/F,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,uBAAuB,CA8H9D,CAAA"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/publishing/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAI7D,OAAO,EAAE,KAAK,uBAAuB,EAAsC,MAAM,cAAc,CAAA;AAmB/F,eAAO,MAAM,gBAAgB,EAAE,UAAU,CAAC,uBAAuB,CAiI9D,CAAA"}

package/dist/publishing/plugin.js

@@ -74,6 +74,9 @@ export const publishingPlugin = (rawOptions) => (incomingConfig) => {
     options.mcpTools?.declare(PUBLISHING_TOOL_DESCRIPTORS, { serverName: 'publishing' });
     return {
         ...incomingConfig,
+        ...(adminComponents && options.goToFirstError !== false
+            ? { admin: withFirstErrorProvider(incomingConfig.admin) }
+            : {}),
         collections: modifiedCollections,
         endpoints: [
             ...(incomingConfig.endpoints ?? []),
@@ -123,6 +126,25 @@ export const publishingPlugin = (rawOptions) => (incomingConfig) => {
         },
     };
 };
+/**
+ * Adds the provider that takes an editor to the first invalid field after a
+ * failed save, publish or schedule (forumone-2026#805). Admin-wide, because a
+ * save fails the same way on every collection, publishable or not. Added once,
+ * however the config was assembled.
+ */
+function withFirstErrorProvider(admin) {
+    const providers = admin?.components?.providers ?? [];
+    const already = providers.some((p) => typeof p === 'object' && p !== null && 'exportName' in p && p.exportName === 'FirstErrorProvider');
+    return {
+        ...(admin ?? {}),
+        components: {
+            ...(admin?.components ?? {}),
+            providers: already
+                ? providers
+                : [...providers, { path: CLIENT_ENTRY, exportName: 'FirstErrorProvider' }],
+        },
+    };
+}
 /**
  * Points the collection's Publish / Unpublish slots at the plugin's own
  * controls, so a stock admin can publish without any host-side code.

package/dist/publishing/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/publishing/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/publishing/plugin.ts"],"names":[],"mappings":"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"}