canopycms 0.4.0 → 0.5.0

package/dist/api/schema.d.ts

@@ -363,14 +363,14 @@ export declare const updateEntryType: import("./route-builder.js").RouteDefiniti
     default?: boolean | undefined;
     format?: "mdx" | "md" | "json" | "yaml" | undefined;
     label?: string | undefined;
-    schema?: string | undefined;
     maxItems?: number | undefined;
+    schema?: string | undefined;
 }, {
     default?: boolean | undefined;
     format?: "mdx" | "md" | "json" | "yaml" | undefined;
     label?: string | undefined;
-    schema?: string | undefined;
     maxItems?: number | undefined;
+    schema?: string | undefined;
 }>, UpdateEntryTypeApiResponse>;
 /**
  * DELETE /:branch/schema/entry-types/:entryTypeName/...collectionPath - Remove entry type
@@ -640,14 +640,14 @@ export declare const SCHEMA_ROUTES: {
         default?: boolean | undefined;
         format?: "mdx" | "md" | "json" | "yaml" | undefined;
         label?: string | undefined;
-        schema?: string | undefined;
         maxItems?: number | undefined;
+        schema?: string | undefined;
     }, {
         default?: boolean | undefined;
         format?: "mdx" | "md" | "json" | "yaml" | undefined;
         label?: string | undefined;
-        schema?: string | undefined;
         maxItems?: number | undefined;
+        schema?: string | undefined;
     }>, UpdateEntryTypeApiResponse>;
     readonly removeEntryType: import("./route-builder.js").RouteDefinition<z.ZodObject<{
         branch: z.ZodType<import("../paths/index.js").BranchName, z.ZodTypeDef, import("../paths/index.js").BranchName>;

package/dist/build/generate-ai-content.js

@@ -200,6 +200,7 @@ export async function generateAIContentFiles(options) {
         contentRoot: contentRootName,
         config: aiConfig,
         entryLinkUrl: config.entryLinkUrl,
+        seo: config.seo,
         ...resolveBuildStamp(),
     });
     const absoluteOutputDir = path.resolve(outputDir) + path.sep;

package/dist/cli/cli.js

@@ -1223,7 +1223,7 @@ CanopyCMS worker run-once (mode: ${mode}, auth: ${authMode})
   }
   console.log("\nDone");
 }
-var __defProp2, __getOwnPropNames2, __esm2, __export2, active, init_logger, scalarFieldTypes, markdownFieldTypes, primitiveFieldTypes, fieldTypes, init_types, SAFE_HTML_TAGS, COMPONENT_NAME, MDX_BINDINGS, FORBIDDEN_ATTRIBUTES, init_mdx_allowlist, fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema, init_field, relativePathSchema, entryTypeSchema, collectionSchema, init_collection, SENTINEL_BASE, DOT_SEGMENT, init_sanitize_href, uploadTargetUrlSchema, previewPrefixSchema, init_url, mediaSchema, init_media, defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE, init_config, init_config2, init_error2, init_fs2, templates_exports, __dirname, TEMPLATES_DIR, SCAFFOLD_STACK_NAME, init_templates, project_detect_exports, COMMANDS, MAX_WORKSPACE_DEPTH, PLACEHOLDER_GITHUB_REPO, CDK_DEPENDENCIES, init_project_detect, task_queue_config_exports, init_task_queue_config, envFlag, LOG_LEVELS, DebugLogger, testLogger, init_debug, init_atomic_write, DEFAULT_MAX_RETRIES, nullLogger, init_task_queue, cms_task_queue_exports, debugLogger, cmsTaskQueueLogger, init_cms_task_queue, ProdClientSafeStrategy, DevClientSafeStrategy, warned, VALID_DEPLOYMENT_NAME, isValidDeploymentName, ProdStrategy, DevStrategy, strategyCache;
+var __defProp2, __getOwnPropNames2, __esm2, __export2, active, init_logger, scalarFieldTypes, markdownFieldTypes, primitiveFieldTypes, fieldTypes, init_types, SAFE_HTML_TAGS, COMPONENT_NAME, MDX_BINDINGS, FORBIDDEN_ATTRIBUTES, init_mdx_allowlist, fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceSortFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema, init_field, relativePathSchema, entryTypeSchema, collectionSchema, init_collection, SENTINEL_BASE, DOT_SEGMENT, init_sanitize_href, uploadTargetUrlSchema, previewPrefixSchema, init_url, mediaSchema, init_media, defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, seoFieldNameSchema, seoSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE, init_config, init_config2, init_error2, init_fs2, templates_exports, __dirname, TEMPLATES_DIR, SCAFFOLD_STACK_NAME, init_templates, project_detect_exports, COMMANDS, MAX_WORKSPACE_DEPTH, PLACEHOLDER_GITHUB_REPO, CDK_DEPENDENCIES, init_project_detect, task_queue_config_exports, init_task_queue_config, envFlag, LOG_LEVELS, DebugLogger, testLogger, init_debug, init_atomic_write, DEFAULT_MAX_RETRIES, nullLogger, init_task_queue, cms_task_queue_exports, debugLogger, cmsTaskQueueLogger, init_cms_task_queue, ProdClientSafeStrategy, DevClientSafeStrategy, warned, VALID_DEPLOYMENT_NAME, isValidDeploymentName, ProdStrategy, DevStrategy, strategyCache;
 var init_init = __esm({
   "dist/cli/init.js"() {
     "use strict";
@@ -1361,7 +1361,10 @@ var init_init = __esm({
           required: z.boolean().optional(),
           list: z.boolean().optional(),
           isTitle: z.boolean().optional(),
-          isBody: z.boolean().optional()
+          isBody: z.boolean().optional(),
+          // Listed so a parse keeps it (zod strips unknown keys); which fields may carry it is
+          // `ensureMaxItemsPlacement`'s call (config/validation.ts).
+          maxItems: z.number().int().positive().optional()
         });
         selectOptionSchema = z.union([
           z.string(),
@@ -1419,6 +1422,7 @@ var init_init = __esm({
           type: z.literal("select"),
           options: z.array(selectOptionSchema).min(1)
         });
+        referenceSortFieldSchema = z.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
         referenceFieldSchema = fieldBaseSchema.extend({
           type: z.literal("reference"),
           collections: z.array(z.string().min(1)).min(1).optional(),
@@ -1429,7 +1433,14 @@ var init_init = __esm({
           // default, so a consumer that adopts this schema's parse output would silently delete a
           // runtime-consumed flag and the feature would no-op with no error. (`resolvedSchema` is
           // absent on purpose — it is type-inference-only and stripping it changes no behavior.)
-          includeBody: z.boolean().optional()
+          includeBody: z.boolean().optional(),
+          optionSort: z.union([
+            z.enum(["label", "collection"]),
+            z.object({
+              field: referenceSortFieldSchema,
+              direction: z.enum(["asc", "desc"]).optional()
+            }).strict()
+          ]).optional()
         });
         fieldHolder = [z.never()];
         blockSchema = z.object({
@@ -1614,6 +1625,19 @@ var init_init = __esm({
           // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
           SignInComponent: z5.custom().optional()
         });
+        seoFieldNameSchema = z5.string().min(1).optional();
+        seoSchema = z5.object({
+          group: z5.string().min(1).optional(),
+          fields: z5.object({
+            title: seoFieldNameSchema,
+            description: seoFieldNameSchema,
+            ogImage: seoFieldNameSchema,
+            ogType: seoFieldNameSchema,
+            canonical: seoFieldNameSchema,
+            noindex: seoFieldNameSchema,
+            twitterCard: seoFieldNameSchema
+          }).strict().optional()
+        }).strict();
         CanopyConfigSchema = z5.object({
           media: mediaSchema.optional(),
           // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -1663,6 +1687,7 @@ var init_init = __esm({
           entryLinkUrl: z5.custom().optional(),
           validateEntry: z5.custom().optional(),
           mdxAllow: mdxAllowlistSchema.optional(),
+          seo: seoSchema.optional(),
           dev: devConfigSchema.optional()
         }).strict();
         DEFAULT_PROD_WORKSPACE = "/mnt/efs";
@@ -4569,7 +4594,11 @@ function linkOnlyReferenceData(data, format, fields) {
   return rest;
 }
 function extractSeoFields(entryData, opts = {}) {
-  const names = { ...DEFAULT_SEO_FIELD_NAMES, ...opts.fields };
+  const names = { ...DEFAULT_SEO_FIELD_NAMES };
+  for (const [key, name] of Object.entries(opts.fields ?? {})) {
+    if (typeof name === "string" && name !== "")
+      names[key] = name;
+  }
   const entry = asRecord2(entryData);
   const source = opts.group ? asRecord2(entry?.[opts.group]) : entry;
   return {
@@ -6254,7 +6283,7 @@ function createReferenceRendering(idIndex, flatSchema, entryLinkUrl, markdownCop
   };
 }
 async function generateAIContent(options) {
-  const { store, flatSchema, contentRoot, config, entryLinkUrl, generatedAt, buildId } = options;
+  const { store, flatSchema, contentRoot, config, entryLinkUrl, seo, generatedAt, buildId } = options;
   assertValidNoindexConfig(config);
   assertValidReferenceLink(config);
   const files = /* @__PURE__ */ new Map();
@@ -6265,6 +6294,7 @@ async function generateAIContent(options) {
     config,
     idIndex,
     entryLinkUrl,
+    seo,
     resolveTarget: createReferenceTargetResolver(store)
   };
   const collections = flatSchema.filter((item) => item.type === "collection");
@@ -6416,7 +6446,7 @@ async function collectCollection(read, collection, flatSchema) {
   return { collection, cleanPath, entries, subcollections };
 }
 async function collectEntries(read, collection, cleanPath) {
-  const { store, contentRoot, config, idIndex, entryLinkUrl, resolveTarget: resolveTarget2 } = read;
+  const { store, contentRoot, config, idIndex, entryLinkUrl, seo, resolveTarget: resolveTarget2 } = read;
   const skipNoindex = config?.exclude?.noindex !== false;
   const pending = [];
   const listed = await store.getCollectionEntryPaths(collection.logicalPath);
@@ -6434,7 +6464,7 @@ async function collectEntries(read, collection, cleanPath) {
       const doc = await store.read(listEntry.collection, listEntry.slug, {
         resolveReferences: false
       });
-      if (skipNoindex && isNoindexEntry(doc.data, config?.seo))
+      if (skipNoindex && isNoindexEntry(doc.data, seo))
         continue;
       const storedData = doc.data;
       doc.data = await resolveReferenceFields(doc.data, entryTypeConfig.schema, resolveTarget2);
@@ -6501,24 +6531,8 @@ function assertValidNoindexConfig(config) {
   if (noindex !== void 0 && typeof noindex !== "boolean") {
     throw new Error(`AI content config: exclude.noindex must be a boolean, got ${typeof noindex}`);
   }
-  const seo = config?.seo;
-  if (seo === void 0)
-    return;
-  if (typeof seo !== "object" || seo === null || Array.isArray(seo)) {
-    throw new Error("AI content config: seo must be an object of { group?, fields? }");
-  }
-  const { group, fields } = seo;
-  if (group !== void 0 && typeof group !== "string") {
-    throw new Error("AI content config: seo.group must be a string");
-  }
-  if (fields === void 0)
-    return;
-  if (typeof fields !== "object" || fields === null || Array.isArray(fields) || Object.values(fields).some((name) => typeof name !== "string")) {
-    throw new Error("AI content config: seo.fields must map SEO fields to field-name strings");
-  }
-  const unknown = Object.keys(fields).filter((key) => !(key in DEFAULT_SEO_FIELD_NAMES));
-  if (unknown.length > 0) {
-    throw new Error(`AI content config: unknown seo.fields key(s): ${unknown.join(", ")}`);
+  if (config && "seo" in config) {
+    throw new Error("AI content config: seo is not an AI content option. Set it once as seo in defineCanopyConfig, where the sitemap, page metadata and AI content all read it.");
   }
 }
 function stripContentRoot(logicalPath, contentRoot) {
@@ -7492,6 +7506,14 @@ function validateEntryData(fields, data, pathPrefix = "", options = {}) {
     }
     if (value === void 0 || value === null)
       continue;
+    if (Array.isArray(value) && "maxItems" in field && typeof field.maxItems === "number" && value.length > field.maxItems) {
+      const cap = field.maxItems;
+      errors.push({
+        fieldPath: path272,
+        message: `At most ${cap} ${cap === 1 ? "item" : "items"}; this list has ${value.length}`,
+        maxItems: { count: value.length, cap }
+      });
+    }
     if (field.type === "block") {
       const blockField = field;
       if (!Array.isArray(value)) {
@@ -7590,14 +7612,34 @@ function assertBuildEntriesValid(items, phaseLabel) {
   const invalid = findInvalidEntries(items);
   if (invalid.length === 0)
     return;
-  const lines = invalid.map(({ entryPath, errors }) => {
-    const [first, ...rest] = errors;
-    const summary = rest.length > 0 ? `${first.fieldPath}: ${first.message} (+${rest.length} more)` : `${first.fieldPath}: ${first.message}`;
-    return `  - ${entryPath} \u2014 ${summary}`;
-  });
+  const lines = [];
+  let hasOverCap = false;
+  let hasOrdinary = false;
+  for (const { entryPath, errors } of invalid) {
+    const ordinary = errors.filter((e) => e.maxItems === void 0);
+    if (ordinary.length > 0) {
+      hasOrdinary = true;
+      const [first, ...rest] = ordinary;
+      const summary = rest.length > 0 ? `${first.fieldPath}: ${first.message} (+${rest.length} more)` : `${first.fieldPath}: ${first.message}`;
+      lines.push(`  - ${entryPath} \u2014 ${summary}`);
+    }
+    for (const { fieldPath, maxItems } of errors) {
+      if (maxItems === void 0)
+        continue;
+      hasOverCap = true;
+      lines.push(`  - ${entryPath} \u2014 ${fieldPath}: ${maxItems.count} items, but maxItems is ${maxItems.cap}`);
+    }
+  }
+  const advice = [];
+  if (hasOverCap) {
+    advice.push(`A list over its maxItems: open the entry in the editor and remove a pick from that list (or remove items) until it holds at most maxItems, then rebuild. This usually happens when two branches each add one item to the same list and are merged one after the other.`);
+  }
+  if (hasOrdinary) {
+    advice.push(`${hasOverCap ? "The other errors are" : "These are"} likely abandoned create-scaffolds (empty entries left behind when a create was started but never finished). Finish editing the entry (fill in its required fields) or delete the abandoned draft, then rebuild.`);
+  }
   throw new Error(`CanopyCMS static build: found ${invalid.length} schema-invalid ${invalid.length === 1 ? "entry" : "entries"} during ${phaseLabel}:
 ${lines.join("\n")}
-These are likely abandoned create-scaffolds (empty entries left behind when a create was started but never finished). Finish editing the entry (fill in its required fields) or delete the abandoned draft, then rebuild.`);
+` + advice.join("\n"));
 }
 async function readGeneratedRecord(outputDir) {
   try {
@@ -7689,6 +7731,7 @@ ${cached.issues.map((issue) => `  - ${issue.message}`).join("\n")}`);
     contentRoot: contentRootName,
     config: aiConfig2,
     entryLinkUrl: config.entryLinkUrl,
+    seo: config.seo,
     ...resolveBuildStamp()
   });
   const absoluteOutputDir = path25.resolve(outputDir) + path25.sep;
@@ -7785,7 +7828,7 @@ async function generateAIContentCLI(options) {
   console.log(`  Output: ${result.outputDir}
 `);
 }
-var __defProp3, __getOwnPropNames3, __esm3, __export3, init_error3, init_atomic_write2, init_field_traversal, ITEM_KEY, ITEM_KEY_PATTERN, isItemKey, BASE58, isListField, init_item_keys, active2, init_logger2, SENTINEL_BASE2, DOT_SEGMENT2, init_sanitize_href2, init_normalize, ROOT_COLLECTION_ID, init_types2, normalizePathValue, flattenSchema, init_flatten, scalarFieldTypes2, markdownFieldTypes2, primitiveFieldTypes2, fieldTypes2, init_types22, SAFE_HTML_TAGS2, COMPONENT_NAME2, MDX_BINDINGS2, FORBIDDEN_ATTRIBUTES2, init_mdx_allowlist2, fieldBaseSchema2, selectOptionSchema2, referenceOptionSchema2, primitiveFieldSchema2, mdxPropAllowSchema2, mdxAllowlistSchema2, markdownFieldSchema2, ASPECT_RATIO_RE2, imageFieldSchema2, selectFieldSchema2, referenceFieldSchema2, fieldHolder2, blockSchema2, blockFieldSchema2, objectFieldSchema2, inlineGroupFieldSchema2, customFieldSchema2, knownFieldSchema2, fieldSchema2, init_field2, relativePathSchema2, entryTypeSchema2, collectionSchema2, init_collection2, uploadTargetUrlSchema2, previewPrefixSchema2, init_url2, mediaSchema2, init_media2, defaultBranchAccessSchema2, defaultPathAccessLevelSchema2, defaultPathAccessLevelsSchema2, defaultPathAccessSchema2, defaultBaseBranchSchema2, defaultRemoteNameSchema2, defaultRemoteUrlSchema2, gitBotAuthorNameSchema2, gitBotAuthorEmailSchema2, githubTokenEnvVarSchema2, operatingModeSchema2, deployedAsSchema2, contentRootSchema2, sourceRootSchema2, basePathSchema2, deploymentNameSchema2, devContentSyncSchema2, devConfigSchema2, editorConfigSchema2, CanopyConfigSchema2, DEFAULT_PROD_WORKSPACE2, init_config3, SERVER_MODE_ENV_VAR, BROWSER_MODE_ENV_VAR, warned2, init_mode_env, forEachReferenceField, init_validation, ProdClientSafeStrategy2, DevClientSafeStrategy2, clientStrategyCache, init_client_safe_strategy, warned3, VALID_DEPLOYMENT_NAME2, isValidDeploymentName2, init_deployment_name, init_config22, ProdStrategy2, DevStrategy2, strategyCache2, init_client_unsafe_strategy, operating_mode_exports, init_operating_mode, task_queue_config_exports2, init_task_queue_config2, worker_status_exports, WORKER_STATUS_FILE, init_worker_status, BLOCK_DISCRIMINATOR_KEYS, BLOCK_STRUCTURAL_KEYS, envFlag2, LOG_LEVELS2, DebugLogger2, testLogger2, END, FRESH, LINE_WIDTH, MIN_LINE_WIDTH, SourceSplicer, log2, MAX_LCS_CELLS, Splicer, log22, EVIDENCE_MAX_DEPTH, log3, locks, PROVISIONING_LOCK_STALE_MS, sleep, META_DIR, CONTENT_WRITE_LOCK_NAME, DEFAULT_CONTENT_WRITE_LOCK_WAIT_MS, ContentWriteLockBusyError, sleep2, CONTENT_WRITE_LOCK_STALE_MS, heldRoots, getFormatExtension, isDataOnlyFormat, asRecord, DEFAULT_SEO_FIELD_NAMES, asRecord2, asText, asFlag, asImageUrl, asOgType, asTwitterCard, RESTRICTED_REFERENCE_MARKER, SEO_GROUP_FIELDS, MAX_WARNED, warned4, SchemaUnavailableError, BASE58_PATTERN, CONTENT_ID_PATTERN, PHYSICAL_SEGMENT_PATTERN, isValidId, EMPTY_LOGICAL_PATH, ContentIdIndex, parseTypedFilename, CONTENT_EXTENSIONS, registry, finalization, log4, META_DIR2, entryTypeMetaSchema, collectionMetaSchema, rootCollectionMetaSchema, fingerprints, editDistance, closestName, forEachEntryType, collectEntryTypeNames, validateReferenceEntryTypes, isDeployedStatic, isBuildMode, readsFromCheckout, STATIC_DEPLOY_USER, storage, log5, BaseBranchUnresolvedError, NETWORK_SCHEME_PATTERN, TRANSPORT_HELPER_PATTERN, LEADING_OPTION_PATTERN, WINDOWS_DRIVE_PATTERN, COLON_BEFORE_SLASH_PATTERN, MISSING_REMOTE_REF_REASONS, CANOPY_META_DIR, SCHEMA_CACHE_VERSION, MTIME_CHECK_DEBOUNCE_MS, SCHEMA_CACHE_FILE, SCHEMA_GENERATION_RESOURCE, reportedIssues, BranchSchemaCache, RESOURCE, RESERVED_SETTINGS_BRANCH_PREFIX, BranchPathError, resolveContentBranchesRoot, ContentStoreError, ContentConflictError, EntryGoneError, BranchSyncingError, DuplicateContentIdError, UrlPathConflictError, isEmptyFieldValue, DEFAULT_INDEX_FRESHNESS_INTERVAL_MS, FORCED_REFRESH_MIN_INTERVAL_MS, STALE_LOOKUP, isMissingReference, createReferenceResolveCache, ContentStore, ATTR_CONTENT, BLOCK_PREFIX, BLOCK_SUFFIX, BLOCK_RESTORE_RE, INLINE_PREFIX, INLINE_SUFFIX, INLINE_RESTORE_RE, DEFAULT_REFERENCE_RENDERING, FLAT_CELL_TYPES, log6, BASE58_CHAR, ENTRY_LINK_PATTERN, INLINE_LINK_TARGET, BranchMetadataCorruptError, BRANCH_META_DIR, BRANCH_META_FILE, branchMetadataFilePath, UNKNOWN_TIME, enumOf, branchMetadataShape, branchMetadataSchema, branchMetadataFileSchema, log7, REGISTRY_FILE, REGISTRY_STALE_FILE, REGISTRY_TEMP_FILE, REGISTRY_VERSION, RESOURCE2, GET_MISS_REFRESH_MIN_INTERVAL_MS, snapshotSchema, reportedUnreadable, BranchRegistry, log8, OccWriteConflictError, CURRENT_SCHEMA_VERSION, BranchMetadataConflictError, BranchMetadataFileManager, loadBranchContext, log9, GIT_ENV_PASSTHROUGH, FORCE_C_LOCALE, GIT_NETWORK_ENV_PASSTHROUGH, NO_AUTO_GC_CONFIG, REMOTE_GIT_CONFIG, REMOTE_GIT_MAX_LOOSE_OBJECTS, REMOTE_GIT_MAX_PACKS, PARALLEL_CHECKOUT_ARGS, remoteInitLocks, GITHUB_TRACKING_REF_PREFIX, GitConflictError, GitRemoteRefMissingError, RemoteNotReadyError, SettingsRemoteUnreadableError, SettingsBranchDivergedError, SETTINGS_BRANCH_FILES, SettingsBranchHasContentHistoryError, GitManager, PUBLISH_LOCK_WAIT_MS, CREATE_RESIDUE_MIN_QUIET_MS, STAGING_MAX_AGE_MS, REPAIR_MAX_AGE_MS, DELETING_MAX_AGE_MS, SETTINGS_TRASH_MAX_AGE_MS, BranchProvisioningBusyError, BranchDirOccupiedError, STAGING_PREFIX, REPAIR_PREFIX, TRASH_PREFIX, stagingDirName, NO_GIT, RENAME_BLOCKED, SPARSE_CONE_RECORD, defaultSink, sink, ProvisionLog, testHooks, provisionsInFlight, BranchWorkspaceManager, log10, normalizePath, readEntryData, createReferenceResolver, withoutUnavailableEntries, resolveCollectionItemReferences, looksLikeMalformedEntry, listCollectionEntries, MAX_INPUT_PIXELS, CROP_PRECISION, KNOWN_FIELD_TYPES, STRING_FIELD_TYPES, selectOptionValues, GENERATED_RECORD_FILENAME, SAFE_BUILD_ID, BUILD_ID_RULE, jiti;
+var __defProp3, __getOwnPropNames3, __esm3, __export3, init_error3, init_atomic_write2, init_field_traversal, ITEM_KEY, ITEM_KEY_PATTERN, isItemKey, BASE58, isListField, init_item_keys, active2, init_logger2, SENTINEL_BASE2, DOT_SEGMENT2, init_sanitize_href2, init_normalize, ROOT_COLLECTION_ID, init_types2, normalizePathValue, flattenSchema, init_flatten, scalarFieldTypes2, markdownFieldTypes2, primitiveFieldTypes2, fieldTypes2, init_types22, SAFE_HTML_TAGS2, COMPONENT_NAME2, MDX_BINDINGS2, FORBIDDEN_ATTRIBUTES2, init_mdx_allowlist2, fieldBaseSchema2, selectOptionSchema2, referenceOptionSchema2, primitiveFieldSchema2, mdxPropAllowSchema2, mdxAllowlistSchema2, markdownFieldSchema2, ASPECT_RATIO_RE2, imageFieldSchema2, selectFieldSchema2, referenceSortFieldSchema2, referenceFieldSchema2, fieldHolder2, blockSchema2, blockFieldSchema2, objectFieldSchema2, inlineGroupFieldSchema2, customFieldSchema2, knownFieldSchema2, fieldSchema2, init_field2, relativePathSchema2, entryTypeSchema2, collectionSchema2, init_collection2, uploadTargetUrlSchema2, previewPrefixSchema2, init_url2, mediaSchema2, init_media2, defaultBranchAccessSchema2, defaultPathAccessLevelSchema2, defaultPathAccessLevelsSchema2, defaultPathAccessSchema2, defaultBaseBranchSchema2, defaultRemoteNameSchema2, defaultRemoteUrlSchema2, gitBotAuthorNameSchema2, gitBotAuthorEmailSchema2, githubTokenEnvVarSchema2, operatingModeSchema2, deployedAsSchema2, contentRootSchema2, sourceRootSchema2, basePathSchema2, deploymentNameSchema2, devContentSyncSchema2, devConfigSchema2, editorConfigSchema2, seoFieldNameSchema2, seoSchema2, CanopyConfigSchema2, DEFAULT_PROD_WORKSPACE2, init_config3, SERVER_MODE_ENV_VAR, BROWSER_MODE_ENV_VAR, warned2, init_mode_env, forEachReferenceField, init_validation, ProdClientSafeStrategy2, DevClientSafeStrategy2, clientStrategyCache, init_client_safe_strategy, warned3, VALID_DEPLOYMENT_NAME2, isValidDeploymentName2, init_deployment_name, init_config22, ProdStrategy2, DevStrategy2, strategyCache2, init_client_unsafe_strategy, operating_mode_exports, init_operating_mode, task_queue_config_exports2, init_task_queue_config2, worker_status_exports, WORKER_STATUS_FILE, init_worker_status, BLOCK_DISCRIMINATOR_KEYS, BLOCK_STRUCTURAL_KEYS, envFlag2, LOG_LEVELS2, DebugLogger2, testLogger2, END, FRESH, LINE_WIDTH, MIN_LINE_WIDTH, SourceSplicer, log2, MAX_LCS_CELLS, Splicer, log22, EVIDENCE_MAX_DEPTH, log3, locks, PROVISIONING_LOCK_STALE_MS, sleep, META_DIR, CONTENT_WRITE_LOCK_NAME, DEFAULT_CONTENT_WRITE_LOCK_WAIT_MS, ContentWriteLockBusyError, sleep2, CONTENT_WRITE_LOCK_STALE_MS, heldRoots, getFormatExtension, isDataOnlyFormat, asRecord, DEFAULT_SEO_FIELD_NAMES, asRecord2, asText, asFlag, asImageUrl, asOgType, asTwitterCard, RESTRICTED_REFERENCE_MARKER, SEO_GROUP_FIELDS, MAX_WARNED, warned4, SchemaUnavailableError, BASE58_PATTERN, CONTENT_ID_PATTERN, PHYSICAL_SEGMENT_PATTERN, isValidId, EMPTY_LOGICAL_PATH, ContentIdIndex, parseTypedFilename, CONTENT_EXTENSIONS, registry, finalization, log4, META_DIR2, entryTypeMetaSchema, collectionMetaSchema, rootCollectionMetaSchema, fingerprints, editDistance, closestName, forEachEntryType, collectEntryTypeNames, validateReferenceEntryTypes, isDeployedStatic, isBuildMode, readsFromCheckout, STATIC_DEPLOY_USER, storage, log5, BaseBranchUnresolvedError, NETWORK_SCHEME_PATTERN, TRANSPORT_HELPER_PATTERN, LEADING_OPTION_PATTERN, WINDOWS_DRIVE_PATTERN, COLON_BEFORE_SLASH_PATTERN, MISSING_REMOTE_REF_REASONS, CANOPY_META_DIR, SCHEMA_CACHE_VERSION, MTIME_CHECK_DEBOUNCE_MS, SCHEMA_CACHE_FILE, SCHEMA_GENERATION_RESOURCE, reportedIssues, BranchSchemaCache, RESOURCE, RESERVED_SETTINGS_BRANCH_PREFIX, BranchPathError, resolveContentBranchesRoot, ContentStoreError, ContentConflictError, EntryGoneError, BranchSyncingError, DuplicateContentIdError, UrlPathConflictError, isEmptyFieldValue, DEFAULT_INDEX_FRESHNESS_INTERVAL_MS, FORCED_REFRESH_MIN_INTERVAL_MS, STALE_LOOKUP, isMissingReference, createReferenceResolveCache, ContentStore, ATTR_CONTENT, BLOCK_PREFIX, BLOCK_SUFFIX, BLOCK_RESTORE_RE, INLINE_PREFIX, INLINE_SUFFIX, INLINE_RESTORE_RE, DEFAULT_REFERENCE_RENDERING, FLAT_CELL_TYPES, log6, BASE58_CHAR, ENTRY_LINK_PATTERN, INLINE_LINK_TARGET, BranchMetadataCorruptError, BRANCH_META_DIR, BRANCH_META_FILE, branchMetadataFilePath, UNKNOWN_TIME, enumOf, branchMetadataShape, branchMetadataSchema, branchMetadataFileSchema, log7, REGISTRY_FILE, REGISTRY_STALE_FILE, REGISTRY_TEMP_FILE, REGISTRY_VERSION, RESOURCE2, GET_MISS_REFRESH_MIN_INTERVAL_MS, snapshotSchema, reportedUnreadable, BranchRegistry, log8, OccWriteConflictError, CURRENT_SCHEMA_VERSION, BranchMetadataConflictError, BranchMetadataFileManager, loadBranchContext, log9, GIT_ENV_PASSTHROUGH, FORCE_C_LOCALE, GIT_NETWORK_ENV_PASSTHROUGH, NO_AUTO_GC_CONFIG, REMOTE_GIT_CONFIG, REMOTE_GIT_MAX_LOOSE_OBJECTS, REMOTE_GIT_MAX_PACKS, PARALLEL_CHECKOUT_ARGS, remoteInitLocks, GITHUB_TRACKING_REF_PREFIX, GitConflictError, GitRemoteRefMissingError, RemoteNotReadyError, SettingsRemoteUnreadableError, SettingsBranchDivergedError, SETTINGS_BRANCH_FILES, SettingsBranchHasContentHistoryError, GitManager, PUBLISH_LOCK_WAIT_MS, CREATE_RESIDUE_MIN_QUIET_MS, STAGING_MAX_AGE_MS, REPAIR_MAX_AGE_MS, DELETING_MAX_AGE_MS, SETTINGS_TRASH_MAX_AGE_MS, BranchProvisioningBusyError, BranchDirOccupiedError, STAGING_PREFIX, REPAIR_PREFIX, TRASH_PREFIX, stagingDirName, NO_GIT, RENAME_BLOCKED, SPARSE_CONE_RECORD, defaultSink, sink, ProvisionLog, testHooks, provisionsInFlight, BranchWorkspaceManager, log10, normalizePath, readEntryData, createReferenceResolver, withoutUnavailableEntries, resolveCollectionItemReferences, looksLikeMalformedEntry, listCollectionEntries, MAX_INPUT_PIXELS, CROP_PRECISION, KNOWN_FIELD_TYPES, STRING_FIELD_TYPES, selectOptionValues, GENERATED_RECORD_FILENAME, SAFE_BUILD_ID, BUILD_ID_RULE, jiti;
 var init_generate_ai_content = __esm({
   "dist/cli/generate-ai-content.js"() {
     "use strict";
@@ -8068,7 +8111,10 @@ var init_generate_ai_content = __esm({
           required: z22.boolean().optional(),
           list: z22.boolean().optional(),
           isTitle: z22.boolean().optional(),
-          isBody: z22.boolean().optional()
+          isBody: z22.boolean().optional(),
+          // Listed so a parse keeps it (zod strips unknown keys); which fields may carry it is
+          // `ensureMaxItemsPlacement`'s call (config/validation.ts).
+          maxItems: z22.number().int().positive().optional()
         });
         selectOptionSchema2 = z22.union([
           z22.string(),
@@ -8126,6 +8172,7 @@ var init_generate_ai_content = __esm({
           type: z22.literal("select"),
           options: z22.array(selectOptionSchema2).min(1)
         });
+        referenceSortFieldSchema2 = z22.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
         referenceFieldSchema2 = fieldBaseSchema2.extend({
           type: z22.literal("reference"),
           collections: z22.array(z22.string().min(1)).min(1).optional(),
@@ -8136,7 +8183,14 @@ var init_generate_ai_content = __esm({
           // default, so a consumer that adopts this schema's parse output would silently delete a
           // runtime-consumed flag and the feature would no-op with no error. (`resolvedSchema` is
           // absent on purpose — it is type-inference-only and stripping it changes no behavior.)
-          includeBody: z22.boolean().optional()
+          includeBody: z22.boolean().optional(),
+          optionSort: z22.union([
+            z22.enum(["label", "collection"]),
+            z22.object({
+              field: referenceSortFieldSchema2,
+              direction: z22.enum(["asc", "desc"]).optional()
+            }).strict()
+          ]).optional()
         });
         fieldHolder2 = [z22.never()];
         blockSchema2 = z22.object({
@@ -8314,6 +8368,19 @@ var init_generate_ai_content = __esm({
           // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
           SignInComponent: z6.custom().optional()
         });
+        seoFieldNameSchema2 = z6.string().min(1).optional();
+        seoSchema2 = z6.object({
+          group: z6.string().min(1).optional(),
+          fields: z6.object({
+            title: seoFieldNameSchema2,
+            description: seoFieldNameSchema2,
+            ogImage: seoFieldNameSchema2,
+            ogType: seoFieldNameSchema2,
+            canonical: seoFieldNameSchema2,
+            noindex: seoFieldNameSchema2,
+            twitterCard: seoFieldNameSchema2
+          }).strict().optional()
+        }).strict();
         CanopyConfigSchema2 = z6.object({
           media: mediaSchema2.optional(),
           // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -8363,6 +8430,7 @@ var init_generate_ai_content = __esm({
           entryLinkUrl: z6.custom().optional(),
           validateEntry: z6.custom().optional(),
           mdxAllow: mdxAllowlistSchema2.optional(),
+          seo: seoSchema2.optional(),
           dev: devConfigSchema2.optional()
         }).strict();
         DEFAULT_PROD_WORKSPACE2 = "/mnt/efs";
@@ -15322,7 +15390,7 @@ var init_mdx_allowlist3 = __esm({
 
 // dist/config/schemas/field.js
 import { z as z10 } from "zod";
-var fieldBaseSchema3, selectOptionSchema3, referenceOptionSchema3, primitiveFieldSchema3, mdxPropAllowSchema3, mdxAllowlistSchema3, markdownFieldSchema3, ASPECT_RATIO_RE3, imageFieldSchema3, selectFieldSchema3, referenceFieldSchema3, fieldHolder3, blockSchema3, blockFieldSchema3, objectFieldSchema3, inlineGroupFieldSchema3, customFieldSchema3, knownFieldSchema3, fieldSchema3;
+var fieldBaseSchema3, selectOptionSchema3, referenceOptionSchema3, primitiveFieldSchema3, mdxPropAllowSchema3, mdxAllowlistSchema3, markdownFieldSchema3, ASPECT_RATIO_RE3, imageFieldSchema3, selectFieldSchema3, referenceSortFieldSchema3, referenceFieldSchema3, fieldHolder3, blockSchema3, blockFieldSchema3, objectFieldSchema3, inlineGroupFieldSchema3, customFieldSchema3, knownFieldSchema3, fieldSchema3;
 var init_field3 = __esm({
   "dist/config/schemas/field.js"() {
     "use strict";
@@ -15335,7 +15403,10 @@ var init_field3 = __esm({
       required: z10.boolean().optional(),
       list: z10.boolean().optional(),
       isTitle: z10.boolean().optional(),
-      isBody: z10.boolean().optional()
+      isBody: z10.boolean().optional(),
+      // Listed so a parse keeps it (zod strips unknown keys); which fields may carry it is
+      // `ensureMaxItemsPlacement`'s call (config/validation.ts).
+      maxItems: z10.number().int().positive().optional()
     });
     selectOptionSchema3 = z10.union([
       z10.string(),
@@ -15393,6 +15464,7 @@ var init_field3 = __esm({
       type: z10.literal("select"),
       options: z10.array(selectOptionSchema3).min(1)
     });
+    referenceSortFieldSchema3 = z10.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
     referenceFieldSchema3 = fieldBaseSchema3.extend({
       type: z10.literal("reference"),
       collections: z10.array(z10.string().min(1)).min(1).optional(),
@@ -15403,7 +15475,14 @@ var init_field3 = __esm({
       // default, so a consumer that adopts this schema's parse output would silently delete a
       // runtime-consumed flag and the feature would no-op with no error. (`resolvedSchema` is
       // absent on purpose — it is type-inference-only and stripping it changes no behavior.)
-      includeBody: z10.boolean().optional()
+      includeBody: z10.boolean().optional(),
+      optionSort: z10.union([
+        z10.enum(["label", "collection"]),
+        z10.object({
+          field: referenceSortFieldSchema3,
+          direction: z10.enum(["asc", "desc"]).optional()
+        }).strict()
+      ]).optional()
     });
     fieldHolder3 = [z10.never()];
     blockSchema3 = z10.object({
@@ -15637,7 +15716,7 @@ var init_deployment_name2 = __esm({
 
 // dist/config/schemas/config.js
 import { z as z14 } from "zod";
-var defaultBranchAccessSchema3, defaultPathAccessLevelSchema3, defaultPathAccessLevelsSchema3, defaultPathAccessSchema3, defaultBaseBranchSchema3, defaultRemoteNameSchema3, defaultRemoteUrlSchema3, gitBotAuthorNameSchema3, gitBotAuthorEmailSchema3, githubTokenEnvVarSchema3, operatingModeSchema3, deployedAsSchema3, contentRootSchema3, sourceRootSchema3, basePathSchema3, deploymentNameSchema3, devContentSyncSchema3, devConfigSchema3, editorConfigSchema3, CanopyConfigSchema3, DEFAULT_PROD_WORKSPACE3;
+var defaultBranchAccessSchema3, defaultPathAccessLevelSchema3, defaultPathAccessLevelsSchema3, defaultPathAccessSchema3, defaultBaseBranchSchema3, defaultRemoteNameSchema3, defaultRemoteUrlSchema3, gitBotAuthorNameSchema3, gitBotAuthorEmailSchema3, githubTokenEnvVarSchema3, operatingModeSchema3, deployedAsSchema3, contentRootSchema3, sourceRootSchema3, basePathSchema3, deploymentNameSchema3, devContentSyncSchema3, devConfigSchema3, editorConfigSchema3, seoFieldNameSchema3, seoSchema3, CanopyConfigSchema3, DEFAULT_PROD_WORKSPACE3;
 var init_config4 = __esm({
   "dist/config/schemas/config.js"() {
     "use strict";
@@ -15684,6 +15763,19 @@ var init_config4 = __esm({
       // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
       SignInComponent: z14.custom().optional()
     });
+    seoFieldNameSchema3 = z14.string().min(1).optional();
+    seoSchema3 = z14.object({
+      group: z14.string().min(1).optional(),
+      fields: z14.object({
+        title: seoFieldNameSchema3,
+        description: seoFieldNameSchema3,
+        ogImage: seoFieldNameSchema3,
+        ogType: seoFieldNameSchema3,
+        canonical: seoFieldNameSchema3,
+        noindex: seoFieldNameSchema3,
+        twitterCard: seoFieldNameSchema3
+      }).strict().optional()
+    }).strict();
     CanopyConfigSchema3 = z14.object({
       media: mediaSchema3.optional(),
       // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -15733,6 +15825,7 @@ var init_config4 = __esm({
       entryLinkUrl: z14.custom().optional(),
       validateEntry: z14.custom().optional(),
       mdxAllow: mdxAllowlistSchema3.optional(),
+      seo: seoSchema3.optional(),
       dev: devConfigSchema3.optional()
     }).strict();
     DEFAULT_PROD_WORKSPACE3 = "/mnt/efs";

package/dist/cli/generate-ai-content.js

@@ -599,7 +599,7 @@ var init_mdx_allowlist = __esm({
 
 // dist/config/schemas/field.js
 import { z as z2 } from "zod";
-var fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema;
+var fieldBaseSchema, selectOptionSchema, referenceOptionSchema, primitiveFieldSchema, mdxPropAllowSchema, mdxAllowlistSchema, markdownFieldSchema, ASPECT_RATIO_RE, imageFieldSchema, selectFieldSchema, referenceSortFieldSchema, referenceFieldSchema, fieldHolder, blockSchema, blockFieldSchema, objectFieldSchema, inlineGroupFieldSchema, customFieldSchema, knownFieldSchema, fieldSchema;
 var init_field = __esm({
   "dist/config/schemas/field.js"() {
     "use strict";
@@ -612,7 +612,10 @@ var init_field = __esm({
       required: z2.boolean().optional(),
       list: z2.boolean().optional(),
       isTitle: z2.boolean().optional(),
-      isBody: z2.boolean().optional()
+      isBody: z2.boolean().optional(),
+      // Listed so a parse keeps it (zod strips unknown keys); which fields may carry it is
+      // `ensureMaxItemsPlacement`'s call (config/validation.ts).
+      maxItems: z2.number().int().positive().optional()
     });
     selectOptionSchema = z2.union([
       z2.string(),
@@ -670,6 +673,7 @@ var init_field = __esm({
       type: z2.literal("select"),
       options: z2.array(selectOptionSchema).min(1)
     });
+    referenceSortFieldSchema = z2.string().regex(/^[^.]+(\.[^.]+)*$/, 'must be a field name or a dotted path such as "meta.publishedAt"');
     referenceFieldSchema = fieldBaseSchema.extend({
       type: z2.literal("reference"),
       collections: z2.array(z2.string().min(1)).min(1).optional(),
@@ -680,7 +684,14 @@ var init_field = __esm({
       // default, so a consumer that adopts this schema's parse output would silently delete a
       // runtime-consumed flag and the feature would no-op with no error. (`resolvedSchema` is
       // absent on purpose — it is type-inference-only and stripping it changes no behavior.)
-      includeBody: z2.boolean().optional()
+      includeBody: z2.boolean().optional(),
+      optionSort: z2.union([
+        z2.enum(["label", "collection"]),
+        z2.object({
+          field: referenceSortFieldSchema,
+          direction: z2.enum(["asc", "desc"]).optional()
+        }).strict()
+      ]).optional()
     });
     fieldHolder = [z2.never()];
     blockSchema = z2.object({
@@ -828,7 +839,7 @@ var init_media = __esm({
 
 // dist/config/schemas/config.js
 import { z as z6 } from "zod";
-var defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE;
+var defaultBranchAccessSchema, defaultPathAccessLevelSchema, defaultPathAccessLevelsSchema, defaultPathAccessSchema, defaultBaseBranchSchema, defaultRemoteNameSchema, defaultRemoteUrlSchema, gitBotAuthorNameSchema, gitBotAuthorEmailSchema, githubTokenEnvVarSchema, operatingModeSchema, deployedAsSchema, contentRootSchema, sourceRootSchema, basePathSchema, deploymentNameSchema, devContentSyncSchema, devConfigSchema, editorConfigSchema, seoFieldNameSchema, seoSchema, CanopyConfigSchema, DEFAULT_PROD_WORKSPACE;
 var init_config = __esm({
   "dist/config/schemas/config.js"() {
     "use strict";
@@ -875,6 +886,19 @@ var init_config = __esm({
       // Optional: provider sign-in UI for signed-out users (see EditorSignInProps)
       SignInComponent: z6.custom().optional()
     });
+    seoFieldNameSchema = z6.string().min(1).optional();
+    seoSchema = z6.object({
+      group: z6.string().min(1).optional(),
+      fields: z6.object({
+        title: seoFieldNameSchema,
+        description: seoFieldNameSchema,
+        ogImage: seoFieldNameSchema,
+        ogType: seoFieldNameSchema,
+        canonical: seoFieldNameSchema,
+        noindex: seoFieldNameSchema,
+        twitterCard: seoFieldNameSchema
+      }).strict().optional()
+    }).strict();
     CanopyConfigSchema = z6.object({
       media: mediaSchema.optional(),
       // No outer .optional(): both schemas already .default('deny'), so the field is optional on
@@ -924,6 +948,7 @@ var init_config = __esm({
       entryLinkUrl: z6.custom().optional(),
       validateEntry: z6.custom().optional(),
       mdxAllow: mdxAllowlistSchema.optional(),
+      seo: seoSchema.optional(),
       dev: devConfigSchema.optional()
     }).strict();
     DEFAULT_PROD_WORKSPACE = "/mnt/efs";
@@ -2980,7 +3005,11 @@ var asTwitterCard = (value) => {
   return text === "summary" || text === "summary_large_image" ? text : void 0;
 };
 function extractSeoFields(entryData, opts = {}) {
-  const names = { ...DEFAULT_SEO_FIELD_NAMES, ...opts.fields };
+  const names = { ...DEFAULT_SEO_FIELD_NAMES };
+  for (const [key, name] of Object.entries(opts.fields ?? {})) {
+    if (typeof name === "string" && name !== "")
+      names[key] = name;
+  }
   const entry = asRecord2(entryData);
   const source = opts.group ? asRecord2(entry?.[opts.group]) : entry;
   return {
@@ -6723,7 +6752,7 @@ function createReferenceRendering(idIndex, flatSchema, entryLinkUrl, markdownCop
 
 // dist/ai/generate.js
 async function generateAIContent(options) {
-  const { store, flatSchema, contentRoot, config, entryLinkUrl, generatedAt, buildId } = options;
+  const { store, flatSchema, contentRoot, config, entryLinkUrl, seo, generatedAt, buildId } = options;
   assertValidNoindexConfig(config);
   assertValidReferenceLink(config);
   const files = /* @__PURE__ */ new Map();
@@ -6734,6 +6763,7 @@ async function generateAIContent(options) {
     config,
     idIndex,
     entryLinkUrl,
+    seo,
     resolveTarget: createReferenceTargetResolver(store)
   };
   const collections = flatSchema.filter((item) => item.type === "collection");
@@ -6885,7 +6915,7 @@ async function collectCollection(read, collection, flatSchema) {
   return { collection, cleanPath, entries, subcollections };
 }
 async function collectEntries(read, collection, cleanPath) {
-  const { store, contentRoot, config, idIndex, entryLinkUrl, resolveTarget } = read;
+  const { store, contentRoot, config, idIndex, entryLinkUrl, seo, resolveTarget } = read;
   const skipNoindex = config?.exclude?.noindex !== false;
   const pending = [];
   const listed = await store.getCollectionEntryPaths(collection.logicalPath);
@@ -6903,7 +6933,7 @@ async function collectEntries(read, collection, cleanPath) {
       const doc = await store.read(listEntry.collection, listEntry.slug, {
         resolveReferences: false
       });
-      if (skipNoindex && isNoindexEntry(doc.data, config?.seo))
+      if (skipNoindex && isNoindexEntry(doc.data, seo))
         continue;
       const storedData = doc.data;
       doc.data = await resolveReferenceFields(doc.data, entryTypeConfig.schema, resolveTarget);
@@ -6970,24 +7000,8 @@ function assertValidNoindexConfig(config) {
   if (noindex !== void 0 && typeof noindex !== "boolean") {
     throw new Error(`AI content config: exclude.noindex must be a boolean, got ${typeof noindex}`);
   }
-  const seo = config?.seo;
-  if (seo === void 0)
-    return;
-  if (typeof seo !== "object" || seo === null || Array.isArray(seo)) {
-    throw new Error("AI content config: seo must be an object of { group?, fields? }");
-  }
-  const { group, fields } = seo;
-  if (group !== void 0 && typeof group !== "string") {
-    throw new Error("AI content config: seo.group must be a string");
-  }
-  if (fields === void 0)
-    return;
-  if (typeof fields !== "object" || fields === null || Array.isArray(fields) || Object.values(fields).some((name) => typeof name !== "string")) {
-    throw new Error("AI content config: seo.fields must map SEO fields to field-name strings");
-  }
-  const unknown = Object.keys(fields).filter((key) => !(key in DEFAULT_SEO_FIELD_NAMES));
-  if (unknown.length > 0) {
-    throw new Error(`AI content config: unknown seo.fields key(s): ${unknown.join(", ")}`);
+  if (config && "seo" in config) {
+    throw new Error("AI content config: seo is not an AI content option. Set it once as seo in defineCanopyConfig, where the sitemap, page metadata and AI content all read it.");
   }
 }
 function stripContentRoot(logicalPath, contentRoot) {
@@ -10138,6 +10152,14 @@ function validateEntryData(fields, data, pathPrefix = "", options = {}) {
     }
     if (value === void 0 || value === null)
       continue;
+    if (Array.isArray(value) && "maxItems" in field && typeof field.maxItems === "number" && value.length > field.maxItems) {
+      const cap = field.maxItems;
+      errors.push({
+        fieldPath: path27,
+        message: `At most ${cap} ${cap === 1 ? "item" : "items"}; this list has ${value.length}`,
+        maxItems: { count: value.length, cap }
+      });
+    }
     if (field.type === "block") {
       const blockField = field;
       if (!Array.isArray(value)) {
@@ -10238,14 +10260,34 @@ function assertBuildEntriesValid(items, phaseLabel) {
   const invalid = findInvalidEntries(items);
   if (invalid.length === 0)
     return;
-  const lines = invalid.map(({ entryPath, errors }) => {
-    const [first, ...rest] = errors;
-    const summary = rest.length > 0 ? `${first.fieldPath}: ${first.message} (+${rest.length} more)` : `${first.fieldPath}: ${first.message}`;
-    return `  - ${entryPath} \u2014 ${summary}`;
-  });
+  const lines = [];
+  let hasOverCap = false;
+  let hasOrdinary = false;
+  for (const { entryPath, errors } of invalid) {
+    const ordinary = errors.filter((e) => e.maxItems === void 0);
+    if (ordinary.length > 0) {
+      hasOrdinary = true;
+      const [first, ...rest] = ordinary;
+      const summary = rest.length > 0 ? `${first.fieldPath}: ${first.message} (+${rest.length} more)` : `${first.fieldPath}: ${first.message}`;
+      lines.push(`  - ${entryPath} \u2014 ${summary}`);
+    }
+    for (const { fieldPath, maxItems } of errors) {
+      if (maxItems === void 0)
+        continue;
+      hasOverCap = true;
+      lines.push(`  - ${entryPath} \u2014 ${fieldPath}: ${maxItems.count} items, but maxItems is ${maxItems.cap}`);
+    }
+  }
+  const advice = [];
+  if (hasOverCap) {
+    advice.push(`A list over its maxItems: open the entry in the editor and remove a pick from that list (or remove items) until it holds at most maxItems, then rebuild. This usually happens when two branches each add one item to the same list and are merged one after the other.`);
+  }
+  if (hasOrdinary) {
+    advice.push(`${hasOverCap ? "The other errors are" : "These are"} likely abandoned create-scaffolds (empty entries left behind when a create was started but never finished). Finish editing the entry (fill in its required fields) or delete the abandoned draft, then rebuild.`);
+  }
   throw new Error(`CanopyCMS static build: found ${invalid.length} schema-invalid ${invalid.length === 1 ? "entry" : "entries"} during ${phaseLabel}:
 ${lines.join("\n")}
-These are likely abandoned create-scaffolds (empty entries left behind when a create was started but never finished). Finish editing the entry (fill in its required fields) or delete the abandoned draft, then rebuild.`);
+` + advice.join("\n"));
 }
 
 // dist/build/generate-ai-content.js
@@ -10342,6 +10384,7 @@ ${cached.issues.map((issue) => `  - ${issue.message}`).join("\n")}`);
     contentRoot: contentRootName,
     config: aiConfig,
     entryLinkUrl: config.entryLinkUrl,
+    seo: config.seo,
     ...resolveBuildStamp()
   });
   const absoluteOutputDir = path25.resolve(outputDir) + path25.sep;