canopycms 0.1.0-int.115 → 0.1.0

package/README.md

@@ -87,7 +87,6 @@ export default defineCanopyConfig({
   gitBotAuthorEmail: 'canopy@example.com',
   editor: {
     title: 'CanopyCMS Editor', // optional UI defaults
-    subtitle: 'Edit content',
     theme: {
       colors: { brand: '#4f46e5' },
     },

package/dist/ai/references.js

@@ -10,6 +10,7 @@ import { getDefaultEntryType } from '../content-store.js';
 import { extractEntryTypeFromFilename } from '../content-id-index.js';
 import { RESTRICTED_REFERENCE_MARKER } from '../entry-schema.js';
 import { extractEntryLinkIds } from '../entry-link-resolver.js';
+import { trimSlashes } from '../paths/normalize.js';
 import { getErrorMessage } from '../utils/error.js';
 import { flattenGroupFields } from '../utils/flatten-group-fields.js';
 import { resolveEntryTitle } from '../utils/title-field.js';
@@ -183,7 +184,8 @@ export async function decideReferenceLinks(referenceLink, entries, subjectOf, en
  * this export wrote for the target (`files`: content id to output path), under `mountPath`.
  */
 export function createReferenceRendering(idIndex, flatSchema, entryLinkUrl, markdownCopies, linkFor) {
-    const mount = `/${markdownCopies.mountPath.replace(/^\/+|\/+$/g, '')}`.replace(/^\/$/, '');
+    const mountSegment = trimSlashes(markdownCopies.mountPath);
+    const mount = mountSegment === '' ? '' : `/${mountSegment}`;
     const entryTypeOf = (id) => {
         const location = typeof id === 'string' ? idIndex.findById(id) : null;
         if (!location?.collection)

package/dist/api/assets.js

@@ -194,9 +194,9 @@ const listAssetsHandler = async (ctx, _req, params) => {
  * `uploadedBy` records the FIRST uploader only: finalizeAsset dedups on content hash, so a second
  * person uploading an identical file gains no delete rights over it — benign (a 403 where they
  * expected success, never the reverse; see
- * .claude/future-tasks/asset-listing-cross-branch-exposure.md).
+ * safeinsights/canopycms#572).
  *
- * Coupled to the blob-GC follow-up in asset-review-followups.md: this permission is safe because
+ * Coupled to the blob-GC follow-up in safeinsights/canopycms#575: this permission is safe because
  * delete is a de-list, not a destroy — nothing another branch references breaks. If GC ever makes
  * delete destroy the blob, this needs a reference check too.
  */

package/dist/api/branch-merge.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import type { ApiResponse } from './types.js';
-/** @internal No importer; deletion candidate in knip-no-importer-deletion-candidates.md. */
+/** @internal No importer; deletion candidate in safeinsights/canopycms#725. */
 export interface MarkAsMergedParams {
     branch: string;
 }

package/dist/api/branch.js

@@ -514,7 +514,7 @@ export const deleteBranchHandler = async (ctx, req, params) => {
     // writableBranch/submittableBranch guards elsewhere use 403 for the same
     // "protected" category (tracked as a deferred, deliberately out-of-scope
     // cleanup in
-    // .claude/future-tasks/protected-branch-followup-cleanups.md); extending
+    // safeinsights/canopycms#781); extending
     // this check to 'approved' keeps it consistent with its own immediate
     // neighbour rather than introducing a fresh 400/403 split between two
     // arms of the same guard.

package/dist/api/content.js

@@ -506,7 +506,7 @@ const writeContentHandler = async (gc, ctx, req, params, body) => {
                     ok: false,
                     status: 409,
                     error: err.message,
-                    ...(err.outcome === 'unknown' ? { code: 'WRITE_OUTCOME_UNKNOWN' } : {}),
+                    code: err.outcome === 'unknown' ? 'WRITE_OUTCOME_UNKNOWN' : 'BRANCH_SYNCING',
                 };
             }
             // [F1] Also not an editor collision: this content ID is quarantined on two files

package/dist/api/entries-constants.d.ts

@@ -14,7 +14,7 @@ export declare const DEFAULT_ENTRIES_LIMIT = 50;
  * The generic 409 for a conflicting change to an entry, usually its version moving on since the
  * caller read it. Shared with the editor, whose own pre-save staleness check reports the same.
  */
-export declare const ENTRY_CHANGED_MESSAGE = "This entry changed since you opened it. Reload to see the latest version (your unsaved edits will be lost).";
+export declare const ENTRY_CHANGED_MESSAGE = "This entry changed since you opened it. Choose \"Refresh from server\" to see the latest version (your unsaved edits will be lost).";
 /**
  * The 409 for an update whose entry is gone: deleted or moved since the caller read it (API code
  * `ENTRY_GONE`). The save is refused rather than re-creating the entry; re-creating it is a create

package/dist/api/entries-constants.js

@@ -14,7 +14,7 @@ export const DEFAULT_ENTRIES_LIMIT = 50;
  * The generic 409 for a conflicting change to an entry, usually its version moving on since the
  * caller read it. Shared with the editor, whose own pre-save staleness check reports the same.
  */
-export const ENTRY_CHANGED_MESSAGE = 'This entry changed since you opened it. Reload to see the latest version (your unsaved edits will be lost).';
+export const ENTRY_CHANGED_MESSAGE = 'This entry changed since you opened it. Choose "Refresh from server" to see the latest version (your unsaved edits will be lost).';
 /**
  * The 409 for an update whose entry is gone: deleted or moved since the caller read it (API code
  * `ENTRY_GONE`). The save is refused rather than re-creating the entry; re-creating it is a create

package/dist/api/entries.d.ts

@@ -5,7 +5,7 @@ import type { LogicalPath, PhysicalPath, Slug, ContentId } from '../paths/types.
 /**
  * Summary of an entry type for client display.
  * Simplified from EntryTypeConfig - doesn't include full field definitions.
- * @internal No importer; deletion candidate in knip-no-importer-deletion-candidates.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#725.
  */
 export interface EntryTypeSummary {
     name: string;
@@ -28,7 +28,7 @@ export interface CollectionItem {
     exists?: boolean;
     canEdit?: boolean;
 }
-/** @internal No importer; deletion candidate in knip-no-importer-deletion-candidates.md. */
+/** @internal No importer; deletion candidate in safeinsights/canopycms#725. */
 export interface ListEntriesParams {
     branch: string;
     collection?: LogicalPath;

package/dist/api/permissions.d.ts

@@ -154,10 +154,10 @@ declare const batchGetUserMetadataBodySchema: z.ZodObject<{
     userIds: string[];
 }>;
 export type UpdatePermissionsBody = z.infer<typeof updatePermissionsBodySchema>;
-/** @internal No importer; deletion candidate in knip-no-importer-deletion-candidates.md. */
+/** @internal No importer; deletion candidate in safeinsights/canopycms#725. */
 export type SearchUsersParams = z.infer<typeof searchUsersParamsSchema>;
 export type BatchGetUserMetadataBody = z.infer<typeof batchGetUserMetadataBodySchema>;
-/** @internal No importer; deletion candidate in knip-no-importer-deletion-candidates.md. */
+/** @internal No importer; deletion candidate in safeinsights/canopycms#725. */
 export type GetUserMetadataParams = z.infer<typeof getUserMetadataParamsSchema>;
 /**
  * Exported routes for router registration

package/dist/api/types.d.ts

@@ -63,6 +63,7 @@ export interface ApiResponse<TData = unknown> {
  * server runs (a 412, see operating-mode/editor-mode-check.ts); only a rebuild fixes it.
  * `SETTINGS_CHANGED`: a groups or permissions save named a version the file has moved on from (a
  * 409, see `SettingsVersionConflictError`); nothing was saved, and a reload shows the other edit.
- * The other settings 409, a busy file lock, carries no code.
+ * The other settings 409, a busy file lock, carries no code. `BRANCH_SYNCING`: an entry save was
+ * refused because the branch is mid-rebase (a 409); nothing was saved, and a retry soon can pass.
  */
-export type ApiErrorCode = 'SCHEMA_UNAVAILABLE' | 'WORKER_FAILED' | 'WRITE_OUTCOME_UNKNOWN' | 'ENTRY_GONE' | 'EDITOR_MODE_MISMATCH' | 'SETTINGS_CHANGED';
+export type ApiErrorCode = 'SCHEMA_UNAVAILABLE' | 'WORKER_FAILED' | 'WRITE_OUTCOME_UNKNOWN' | 'ENTRY_GONE' | 'EDITOR_MODE_MISMATCH' | 'SETTINGS_CHANGED' | 'BRANCH_SYNCING';

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, 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, 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 init_init = __esm({
   "dist/cli/init.js"() {
     "use strict";
@@ -1603,7 +1603,6 @@ var init_init = __esm({
         });
         editorConfigSchema = z5.object({
           title: z5.string().optional(),
-          subtitle: z5.string().optional(),
           theme: z5.unknown().optional(),
           previewBase: z5.record(z5.union([z5.string(), z5.literal(false)])).optional(),
           previewPrefix: previewPrefixSchema.optional(),
@@ -1793,6 +1792,7 @@ var init_init = __esm({
     init_debug = __esm2({
       "dist/utils/debug.js"() {
         "use strict";
+        envFlag = (name) => typeof process !== "undefined" && process.env[name] === "true";
         LOG_LEVELS = {
           DEBUG: 0,
           INFO: 1,
@@ -1805,7 +1805,7 @@ var init_init = __esm({
             this.options = options;
           }
           shouldLog(level) {
-            const enabled = this.options.enabled ?? process.env.CANOPYCMS_DEBUG === "true";
+            const enabled = this.options.enabled ?? envFlag("CANOPYCMS_DEBUG");
             if (!enabled)
               return false;
             const minLevel = this.options.minLevel ?? "DEBUG";
@@ -1881,7 +1881,7 @@ var init_init = __esm({
           }
         };
         testLogger = createDebugLogger({
-          enabled: process.env.E2E_DEBUG === "true",
+          enabled: envFlag("E2E_DEBUG"),
           prefix: "E2E",
           throwOnError: false
         });
@@ -6212,7 +6212,8 @@ async function decideReferenceLinks(referenceLink, entries, subjectOf, entryLink
   return (id) => decisions.get(id);
 }
 function createReferenceRendering(idIndex, flatSchema, entryLinkUrl, markdownCopies, linkFor) {
-  const mount = `/${markdownCopies.mountPath.replace(/^\/+|\/+$/g, "")}`.replace(/^\/$/, "");
+  const mountSegment = trimSlashes(markdownCopies.mountPath);
+  const mount = mountSegment === "" ? "" : `/${mountSegment}`;
   const entryTypeOf = (id) => {
     const location = typeof id === "string" ? idIndex.findById(id) : null;
     if (!location?.collection)
@@ -7775,7 +7776,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, 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, DEFAULT_SEO_FIELD_NAMES, asRecord, 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, getFormatExtension, isDataOnlyFormat, asRecord2, 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, 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, DEFAULT_SEO_FIELD_NAMES, asRecord, 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, getFormatExtension, isDataOnlyFormat, asRecord2, 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";
@@ -8293,7 +8294,6 @@ var init_generate_ai_content = __esm({
         });
         editorConfigSchema2 = z6.object({
           title: z6.string().optional(),
-          subtitle: z6.string().optional(),
           theme: z6.unknown().optional(),
           previewBase: z6.record(z6.union([z6.string(), z6.literal(false)])).optional(),
           previewPrefix: previewPrefixSchema2.optional(),
@@ -8626,6 +8626,7 @@ var init_generate_ai_content = __esm({
     BLOCK_DISCRIMINATOR_KEYS = ["template", "_type"];
     BLOCK_STRUCTURAL_KEYS = new Set(BLOCK_DISCRIMINATOR_KEYS);
     init_item_keys();
+    envFlag2 = (name) => typeof process !== "undefined" && process.env[name] === "true";
     LOG_LEVELS2 = {
       DEBUG: 0,
       INFO: 1,
@@ -8638,7 +8639,7 @@ var init_generate_ai_content = __esm({
         this.options = options;
       }
       shouldLog(level) {
-        const enabled = this.options.enabled ?? process.env.CANOPYCMS_DEBUG === "true";
+        const enabled = this.options.enabled ?? envFlag2("CANOPYCMS_DEBUG");
         if (!enabled)
           return false;
         const minLevel = this.options.minLevel ?? "DEBUG";
@@ -8714,7 +8715,7 @@ var init_generate_ai_content = __esm({
       }
     };
     testLogger2 = createDebugLogger2({
-      enabled: process.env.E2E_DEBUG === "true",
+      enabled: envFlag2("E2E_DEBUG"),
       prefix: "E2E",
       throwOnError: false
     });
@@ -11067,7 +11068,7 @@ var init_generate_ai_content = __esm({
        * `data` from a process-global content-keyed cache, so `resolveSingleReferenceOnce`'s
        * top-level spread severs exactly one level and NESTED frontmatter objects alias across
        * occurrences, calls and requests. Pre-existing `read()` behavior, deliberately out of scope
-       * here; see `.claude/future-tasks/graymatter-cache-shared-frontmatter.md`.
+       * here; see safeinsights/canopycms#708.
        *
        * Measured (2000 occurrences of one target, local disk, the friendliest case for NOT
        * caching): cloning a snippet-sized target is ~63x cheaper than re-reading and parsing it, a
@@ -11204,6 +11205,7 @@ var init_generate_ai_content = __esm({
     BASE58_CHAR = "[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]";
     ENTRY_LINK_PATTERN = new RegExp(`entry:(${BASE58_CHAR}{12})(#[^\\s)>"']*)?`, "g");
     INLINE_LINK_TARGET = new RegExp(`\\]\\(entry:(${BASE58_CHAR}{12})(?:#[^\\s)>"'\\]]*)?(?:[ \\t]+"[^"\\n]*")?\\)`, "g");
+    init_normalize();
     init_error3();
     init_field_traversal();
     init_error3();
@@ -15577,7 +15579,6 @@ var init_config4 = __esm({
     });
     editorConfigSchema3 = z14.object({
       title: z14.string().optional(),
-      subtitle: z14.string().optional(),
       theme: z14.unknown().optional(),
       previewBase: z14.record(z14.union([z14.string(), z14.literal(false)])).optional(),
       previewPrefix: previewPrefixSchema3.optional(),
@@ -16026,10 +16027,11 @@ var init_git = __esm({
 function createDebugLogger3(options) {
   return new DebugLogger3(options);
 }
-var LOG_LEVELS3, DebugLogger3, testLogger3;
+var envFlag3, LOG_LEVELS3, DebugLogger3, testLogger3;
 var init_debug2 = __esm({
   "dist/utils/debug.js"() {
     "use strict";
+    envFlag3 = (name) => typeof process !== "undefined" && process.env[name] === "true";
     LOG_LEVELS3 = {
       DEBUG: 0,
       INFO: 1,
@@ -16042,7 +16044,7 @@ var init_debug2 = __esm({
         this.options = options;
       }
       shouldLog(level) {
-        const enabled = this.options.enabled ?? process.env.CANOPYCMS_DEBUG === "true";
+        const enabled = this.options.enabled ?? envFlag3("CANOPYCMS_DEBUG");
         if (!enabled)
           return false;
         const minLevel = this.options.minLevel ?? "DEBUG";
@@ -16118,7 +16120,7 @@ var init_debug2 = __esm({
       }
     };
     testLogger3 = createDebugLogger3({
-      enabled: process.env.E2E_DEBUG === "true",
+      enabled: envFlag3("E2E_DEBUG"),
       prefix: "E2E",
       throwOnError: false
     });

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

@@ -864,7 +864,6 @@ var init_config = __esm({
     });
     editorConfigSchema = z6.object({
       title: z6.string().optional(),
-      subtitle: z6.string().optional(),
       theme: z6.unknown().optional(),
       previewBase: z6.record(z6.union([z6.string(), z6.literal(false)])).optional(),
       previewPrefix: previewPrefixSchema.optional(),
@@ -1407,6 +1406,7 @@ function isBlockStructuralKey(key) {
 init_item_keys();
 
 // dist/utils/debug.js
+var envFlag = (name) => typeof process !== "undefined" && process.env[name] === "true";
 var LOG_LEVELS = {
   DEBUG: 0,
   INFO: 1,
@@ -1419,7 +1419,7 @@ var DebugLogger = class {
     this.options = options;
   }
   shouldLog(level) {
-    const enabled = this.options.enabled ?? process.env.CANOPYCMS_DEBUG === "true";
+    const enabled = this.options.enabled ?? envFlag("CANOPYCMS_DEBUG");
     if (!enabled)
       return false;
     const minLevel = this.options.minLevel ?? "DEBUG";
@@ -1498,7 +1498,7 @@ function createDebugLogger(options) {
   return new DebugLogger(options);
 }
 var testLogger = createDebugLogger({
-  enabled: process.env.E2E_DEBUG === "true",
+  enabled: envFlag("E2E_DEBUG"),
   prefix: "E2E",
   throwOnError: false
 });
@@ -5699,7 +5699,7 @@ var ContentStore = class {
    * `data` from a process-global content-keyed cache, so `resolveSingleReferenceOnce`'s
    * top-level spread severs exactly one level and NESTED frontmatter objects alias across
    * occurrences, calls and requests. Pre-existing `read()` behavior, deliberately out of scope
-   * here; see `.claude/future-tasks/graymatter-cache-shared-frontmatter.md`.
+   * here; see safeinsights/canopycms#708.
    *
    * Measured (2000 occurrences of one target, local disk, the friendliest case for NOT
    * caching): cloning a snippet-sized target is ~63x cheaper than re-reading and parsing it, a
@@ -6571,6 +6571,7 @@ function splitByCodeRegions(text) {
 }
 
 // dist/ai/references.js
+init_normalize();
 init_error();
 init_field_traversal();
 function createReferenceTargetResolver(store) {
@@ -6676,7 +6677,8 @@ async function decideReferenceLinks(referenceLink, entries, subjectOf, entryLink
   return (id) => decisions.get(id);
 }
 function createReferenceRendering(idIndex, flatSchema, entryLinkUrl, markdownCopies, linkFor) {
-  const mount = `/${markdownCopies.mountPath.replace(/^\/+|\/+$/g, "")}`.replace(/^\/$/, "");
+  const mountSegment = trimSlashes(markdownCopies.mountPath);
+  const mount = mountSegment === "" ? "" : `/${mountSegment}`;
   const entryTypeOf = (id) => {
     const location = typeof id === "string" ? idIndex.findById(id) : null;
     if (!location?.collection)

package/dist/cli/init.js

@@ -475,7 +475,6 @@ var init_config = __esm({
     });
     editorConfigSchema = z5.object({
       title: z5.string().optional(),
-      subtitle: z5.string().optional(),
       theme: z5.unknown().optional(),
       previewBase: z5.record(z5.union([z5.string(), z5.literal(false)])).optional(),
       previewPrefix: previewPrefixSchema.optional(),
@@ -908,10 +907,11 @@ var init_task_queue_config = __esm({
 function createDebugLogger(options) {
   return new DebugLogger(options);
 }
-var LOG_LEVELS, DebugLogger, testLogger;
+var envFlag, LOG_LEVELS, DebugLogger, testLogger;
 var init_debug = __esm({
   "dist/utils/debug.js"() {
     "use strict";
+    envFlag = (name) => typeof process !== "undefined" && process.env[name] === "true";
     LOG_LEVELS = {
       DEBUG: 0,
       INFO: 1,
@@ -924,7 +924,7 @@ var init_debug = __esm({
         this.options = options;
       }
       shouldLog(level) {
-        const enabled = this.options.enabled ?? process.env.CANOPYCMS_DEBUG === "true";
+        const enabled = this.options.enabled ?? envFlag("CANOPYCMS_DEBUG");
         if (!enabled)
           return false;
         const minLevel = this.options.minLevel ?? "DEBUG";
@@ -1000,7 +1000,7 @@ var init_debug = __esm({
       }
     };
     testLogger = createDebugLogger({
-      enabled: process.env.E2E_DEBUG === "true",
+      enabled: envFlag("E2E_DEBUG"),
       prefix: "E2E",
       throwOnError: false
     });

package/dist/client.d.ts

@@ -1,6 +1,5 @@
 export type { CanopyClientConfig, EditorSignInProps } from './config/index.js';
 export type { CustomFieldRenderers, CustomFieldRenderProps } from './editor/FormRenderer.js';
-export * from './editor/EditorPanes.js';
 export * from './editor/EntryNavigator.js';
 export * from './editor/Editor.js';
 export { PreviewFrame } from './editor/PreviewFrame.js';

package/dist/client.js

@@ -1,5 +1,4 @@
 'use client';
-export * from './editor/EditorPanes.js';
 export * from './editor/EntryNavigator.js';
 export * from './editor/Editor.js';
 export { PreviewFrame } from './editor/PreviewFrame.js';

package/dist/config/schemas/config.d.ts

@@ -75,7 +75,6 @@ export declare const CanopyConfigSchema: z.ZodObject<{
     danglingReferences: z.ZodOptional<z.ZodEnum<["error", "warn"]>>;
     editor: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
-        subtitle: z.ZodOptional<z.ZodString>;
         theme: z.ZodOptional<z.ZodUnknown>;
         previewBase: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<false>]>>>;
         previewPrefix: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
@@ -85,7 +84,6 @@ export declare const CanopyConfigSchema: z.ZodObject<{
         SignInComponent: z.ZodOptional<z.ZodType<import("react").ComponentType<EditorSignInProps>, z.ZodTypeDef, import("react").ComponentType<EditorSignInProps>>>;
     }, "strip", z.ZodTypeAny, {
         title?: string | undefined;
-        subtitle?: string | undefined;
         theme?: unknown;
         previewBase?: Record<string, string | false> | undefined;
         previewPrefix?: string | undefined;
@@ -95,7 +93,6 @@ export declare const CanopyConfigSchema: z.ZodObject<{
         SignInComponent?: import("react").ComponentType<EditorSignInProps> | undefined;
     }, {
         title?: string | undefined;
-        subtitle?: string | undefined;
         theme?: unknown;
         previewBase?: Record<string, string | false> | undefined;
         previewPrefix?: string | undefined;
@@ -158,7 +155,6 @@ export declare const CanopyConfigSchema: z.ZodObject<{
     danglingReferences?: "error" | "warn" | undefined;
     editor?: {
         title?: string | undefined;
-        subtitle?: string | undefined;
         theme?: unknown;
         previewBase?: Record<string, string | false> | undefined;
         previewPrefix?: string | undefined;
@@ -214,7 +210,6 @@ export declare const CanopyConfigSchema: z.ZodObject<{
     danglingReferences?: "error" | "warn" | undefined;
     editor?: {
         title?: string | undefined;
-        subtitle?: string | undefined;
         theme?: unknown;
         previewBase?: Record<string, string | false> | undefined;
         previewPrefix?: string | undefined;

package/dist/config/schemas/config.js

@@ -50,7 +50,6 @@ const devConfigSchema = z.object({
 });
 const editorConfigSchema = z.object({
     title: z.string().optional(),
-    subtitle: z.string().optional(),
     theme: z.unknown().optional(),
     previewBase: z.record(z.union([z.string(), z.literal(false)])).optional(),
     previewPrefix: previewPrefixSchema.optional(),

package/dist/config/types.d.ts

@@ -322,7 +322,6 @@ export interface EditorSignInProps {
 }
 export interface CanopyEditorConfig {
     title?: string;
-    subtitle?: string;
     theme?: unknown;
     /**
      * Preview-pane routes for sites whose routes don't mirror their content tree; otherwise an entry

package/dist/content-index-generation.d.ts

@@ -1,6 +1,6 @@
 /**
  * Absolute path of the generation marker for a branch-clone root.
- * @internal No importer; deletion candidate in knip-no-importer-deletion-candidates.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#725.
  */
 export declare function contentIndexGenerationPath(root: string): string;
 /**

package/dist/content-index-generation.js

@@ -20,7 +20,7 @@ import { SCHEMA_GENERATION_RESOURCE } from './branch-schema-cache.js';
 const RESOURCE = 'content-index';
 /**
  * Absolute path of the generation marker for a branch-clone root.
- * @internal No importer; deletion candidate in knip-no-importer-deletion-candidates.md.
+ * @internal No importer; deletion candidate in safeinsights/canopycms#725.
  */
 export function contentIndexGenerationPath(root) {
     return resourceGenerationPath(root, RESOURCE);

package/dist/content-listing.js

@@ -193,7 +193,7 @@ export async function listEntries(branchRoot, flatSchema, contentRootName, optio
             // One deliberate copy of the rule remains: `content-tree.ts`'s `defaultBuildPath`,
             // exported for adopters to extend and also handling the collection case
             // `computeEntryUrl` does not model. Folding it in is tracked in
-            // `.claude/future-tasks/default-build-path-url-rule-copy.md`.
+            // safeinsights/canopycms#646.
             const urlPath = computeEntryUrl(entry.collectionPath, entry.slug, contentRootName);
             const raw = entry.data;
             const meta = {

package/dist/content-reader.js

@@ -115,7 +115,7 @@ export const createContentReader = (options) => {
         // deliberately does not resolve the former, so a caller linking `path` linked to a 404.
         // Same index decision as computeEntryUrl/listEntries/buildPreviewSrc, through the same
         // predicate. NOTE this builder still keeps its own content-root strip and its own encoding
-        // rather than delegating wholesale -- see .claude/future-tasks/default-build-path-url-rule-copy.md.
+        // rather than delegating wholesale -- see safeinsights/canopycms#646.
         const encodedSlug = isIndexSlug(opts.slug) ? '' : encodeSlug(opts.slug);
         const url = encodedSlug ? `${trimmed}/${encodedSlug}` : trimmed || '/';
         return appendBranch(url);

package/dist/content-store.d.ts

@@ -552,7 +552,7 @@ export declare class ContentStore {
      * `data` from a process-global content-keyed cache, so `resolveSingleReferenceOnce`'s
      * top-level spread severs exactly one level and NESTED frontmatter objects alias across
      * occurrences, calls and requests. Pre-existing `read()` behavior, deliberately out of scope
-     * here; see `.claude/future-tasks/graymatter-cache-shared-frontmatter.md`.
+     * here; see safeinsights/canopycms#708.
      *
      * Measured (2000 occurrences of one target, local disk, the friendliest case for NOT
      * caching): cloning a snippet-sized target is ~63x cheaper than re-reading and parsing it, a

package/dist/content-store.js

@@ -1606,7 +1606,7 @@ export class ContentStore {
      * `data` from a process-global content-keyed cache, so `resolveSingleReferenceOnce`'s
      * top-level spread severs exactly one level and NESTED frontmatter objects alias across
      * occurrences, calls and requests. Pre-existing `read()` behavior, deliberately out of scope
-     * here; see `.claude/future-tasks/graymatter-cache-shared-frontmatter.md`.
+     * here; see safeinsights/canopycms#708.
      *
      * Measured (2000 occurrences of one target, local disk, the friendliest case for NOT
      * caching): cloning a snippet-sized target is ~63x cheaper than re-reading and parsing it, a

package/dist/dev-content-watcher.d.ts

@@ -15,7 +15,7 @@
  * Divergence is a CONDITION, not an event: it holds until someone runs `sync push`, so the report
  * must not repeat into a scrolling request log (`reportOnce`) yet must be hard to scroll past (the
  * gutter block). A log cannot hold a condition; see
- * `.claude/future-tasks/dev-divergence-in-app-surface.md` for the in-app surface that would
+ * safeinsights/canopycms#654 for the in-app surface that would
  * replace the terminal as its primary home.
  *
  * All logic lives here; framework adapters call startDevContentWatcher() once at dev startup (see

package/dist/dev-content-watcher.js

@@ -15,7 +15,7 @@
  * Divergence is a CONDITION, not an event: it holds until someone runs `sync push`, so the report
  * must not repeat into a scrolling request log (`reportOnce`) yet must be hard to scroll past (the
  * gutter block). A log cannot hold a condition; see
- * `.claude/future-tasks/dev-divergence-in-app-surface.md` for the in-app surface that would
+ * safeinsights/canopycms#654 for the in-app surface that would
  * replace the terminal as its primary home.
  *
  * All logic lives here; framework adapters call startDevContentWatcher() once at dev startup (see

package/dist/editor/BranchManager.d.ts

@@ -68,6 +68,8 @@ export interface BranchManagerProps {
     user?: UserContext;
     /** The branch the editor has open: listed first, marked, and offered its workflow action rather than Open. */
     currentBranchName?: string;
+    /** Why the open branch's Submit or Withdraw must wait, such as a Save all still writing it. */
+    currentWorkflowBlockedReason?: string;
     onSelect?: (name: string) => void;
     /** Awaited before the spinner starts, so a confirmation it shows never reads as a hung create. `false` abandons the create. */
     onBeforeCreate?: () => Promise<boolean>;

package/dist/editor/BranchManager.js

@@ -129,10 +129,11 @@ const isReviewerOfOthersSubmission = (b, user) => !!user &&
  * shows its workflow action, or Request changes to a reviewer looking at someone else's
  * submission; the others show Open, which the current one never needs. No action is shown twice.
  */
-const BranchCard = ({ branch: b, isCurrent, user, onSelect, onSubmit, onWithdraw, onRequestChanges, onDelete, onGetUserMetadata, onGetOwnerMetadata = onGetUserMetadata, }) => {
+const BranchCard = ({ branch: b, isCurrent, workflowBlockedReason, user, onSelect, onSubmit, onWithdraw, onRequestChanges, onDelete, onGetUserMetadata, onGetOwnerMetadata = onGetUserMetadata, }) => {
     const statusBadge = branchStatusPresentation(b.status, b.isProtected);
     const perms = getBranchPermissions(b, user);
-    const workflow = workflowAction(b, perms, onSubmit, onWithdraw);
+    const action = workflowAction(b, perms, onSubmit, onWithdraw);
+    const workflow = action && workflowBlockedReason ? { ...action, blockedReason: workflowBlockedReason } : action;
     const userIsAdmin = isAdmin(user?.groups);
     const requestChanges = isReviewer(user?.groups) && b.status === 'submitted'
         ? {
@@ -167,7 +168,7 @@ const BranchCard = ({ branch: b, isCurrent, user, onSelect, onSubmit, onWithdraw
                                                         ? 'This branch is in review. Withdraw it from review before deleting it.'
                                                         : undefined, onClick: () => onDelete?.(b.name), children: "Delete branch" })] }))] })] }))] })] }) }));
 };
-export const BranchManager = ({ branches, mode, user, currentBranchName, onSelect, onBeforeCreate, onCreate, onDelete, onSubmit, onWithdraw, onRequestChanges, onClose: _, comments = [], currentUserId, canResolve = false, onAddComment, onResolveThread, highlightThreadId, onGetUserMetadata, onGetOwnerMetadata, onGetCommentUserMetadata, }) => {
+export const BranchManager = ({ branches, mode, user, currentBranchName, currentWorkflowBlockedReason, onSelect, onBeforeCreate, onCreate, onDelete, onSubmit, onWithdraw, onRequestChanges, onClose: _, comments = [], currentUserId, canResolve = false, onAddComment, onResolveThread, highlightThreadId, onGetUserMetadata, onGetOwnerMetadata, onGetCommentUserMetadata, }) => {
     const supportsBranching = clientOperatingStrategy(mode).supportsBranching();
     const [showCreateForm, setShowCreateForm] = useState(false);
     const [newBranchName, setNewBranchName] = useState('');
@@ -207,5 +208,5 @@ export const BranchManager = ({ branches, mode, user, currentBranchName, onSelec
             ...branches.filter((b) => b.name !== currentBranchName),
         ]
         : branches;
-    return (_jsxs(Stack, { h: "100%", style: { display: 'flex', flexDirection: 'column' }, gap: 0, "data-testid": "branch-manager", children: [currentUserId && onAddComment && onResolveThread && (_jsx(Stack, { pt: "sm", children: _jsx(BranchComments, { comments: comments, currentUserId: currentUserId, canResolve: canResolve, onAddComment: onAddComment, onResolveThread: onResolveThread, highlightThreadId: highlightThreadId, onGetUserMetadata: onGetCommentUserMetadata }) })), !!supportsBranching && (_jsxs(Stack, { gap: "sm", pt: "sm", children: [_jsx(Button, { variant: "light", size: "sm", fullWidth: true, onClick: () => setShowCreateForm(!showCreateForm), disabled: creating, "data-testid": "create-branch-button", children: showCreateForm ? 'Cancel' : `${EDITOR_ACTIONS.newBranch}…` }), _jsx(Collapse, { in: showCreateForm, children: _jsx(Paper, { withBorder: true, p: "md", children: _jsxs(Stack, { gap: "sm", children: [_jsx(TextInput, { label: "Branch name", placeholder: "feature/my-branch", value: newBranchName, onChange: (e) => setNewBranchName(e.target.value), required: true, disabled: creating, "data-testid": "branch-name-input" }), _jsx(TextInput, { label: "Title", placeholder: "Brief description", value: newBranchTitle, onChange: (e) => setNewBranchTitle(e.target.value), disabled: creating, "data-testid": "branch-title-input" }), _jsx(Textarea, { label: "Description", placeholder: "Detailed description of the changes", value: newBranchDescription, onChange: (e) => setNewBranchDescription(e.target.value), minRows: 2, disabled: creating, "data-testid": "branch-description-textarea" }), _jsx(Button, { size: "sm", onClick: handleCreate, disabled: !newBranchName.trim(), loading: creating, fullWidth: true, "data-testid": "create-branch-submit", children: "Create branch" })] }) }) })] })), _jsx(ScrollArea, { style: { flex: 1 }, pb: "md", children: branches.length === 0 ? (_jsx(Text, { size: "sm", c: "dimmed", py: "md", children: !supportsBranching ? 'Branch management is not available.' : 'No branches available.' })) : (_jsx(Stack, { gap: "sm", children: orderedBranches.map((b) => (_jsx(BranchCard, { branch: b, isCurrent: b.name === currentBranchName, user: user, onSelect: onSelect, onSubmit: onSubmit, onWithdraw: onWithdraw, onRequestChanges: onRequestChanges, onDelete: onDelete, onGetUserMetadata: onGetUserMetadata, onGetOwnerMetadata: onGetOwnerMetadata }, b.name))) })) })] }));
+    return (_jsxs(Stack, { h: "100%", style: { display: 'flex', flexDirection: 'column' }, gap: 0, "data-testid": "branch-manager", children: [currentUserId && onAddComment && onResolveThread && (_jsx(Stack, { pt: "sm", children: _jsx(BranchComments, { comments: comments, currentUserId: currentUserId, canResolve: canResolve, onAddComment: onAddComment, onResolveThread: onResolveThread, highlightThreadId: highlightThreadId, onGetUserMetadata: onGetCommentUserMetadata }) })), !!supportsBranching && (_jsxs(Stack, { gap: "sm", pt: "sm", children: [_jsx(Button, { variant: "light", size: "sm", fullWidth: true, onClick: () => setShowCreateForm(!showCreateForm), disabled: creating, "data-testid": "create-branch-button", children: showCreateForm ? 'Cancel' : `${EDITOR_ACTIONS.newBranch}…` }), _jsx(Collapse, { in: showCreateForm, children: _jsx(Paper, { withBorder: true, p: "md", children: _jsxs(Stack, { gap: "sm", children: [_jsx(TextInput, { label: "Branch name", placeholder: "feature/my-branch", value: newBranchName, onChange: (e) => setNewBranchName(e.target.value), required: true, disabled: creating, "data-testid": "branch-name-input" }), _jsx(TextInput, { label: "Title", placeholder: "Brief description", value: newBranchTitle, onChange: (e) => setNewBranchTitle(e.target.value), disabled: creating, "data-testid": "branch-title-input" }), _jsx(Textarea, { label: "Description", placeholder: "Detailed description of the changes", value: newBranchDescription, onChange: (e) => setNewBranchDescription(e.target.value), minRows: 2, disabled: creating, "data-testid": "branch-description-textarea" }), _jsx(Button, { size: "sm", onClick: handleCreate, disabled: !newBranchName.trim(), loading: creating, fullWidth: true, "data-testid": "create-branch-submit", children: "Create branch" })] }) }) })] })), _jsx(ScrollArea, { style: { flex: 1 }, pb: "md", children: branches.length === 0 ? (_jsx(Text, { size: "sm", c: "dimmed", py: "md", children: !supportsBranching ? 'Branch management is not available.' : 'No branches available.' })) : (_jsx(Stack, { gap: "sm", children: orderedBranches.map((b) => (_jsx(BranchCard, { branch: b, isCurrent: b.name === currentBranchName, workflowBlockedReason: b.name === currentBranchName ? currentWorkflowBlockedReason : undefined, user: user, onSelect: onSelect, onSubmit: onSubmit, onWithdraw: onWithdraw, onRequestChanges: onRequestChanges, onDelete: onDelete, onGetUserMetadata: onGetUserMetadata, onGetOwnerMetadata: onGetOwnerMetadata }, b.name))) })) })] }));
 };