@elytracms/studio 0.0.91 → 0.0.93

package/dist/lib/references/references-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"references-store.js","sourceRoot":"","sources":["../../../src/lib/references/references-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { documentKey } from '@elytracms/core/cms-core'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport type { CmsDocument, DocumentRef } from '@elytracms/core/cms-core'\nimport type {\n  ReferenceEntryRecord,\n  ReferenceSource,\n  ReferenceTarget,\n} from '@elytracms/core/persistence'\nimport { localizedLabel } from '../i18n'\nimport { getStudioLocaleConfig } from '../locale/locale-store'\nimport { resolveDeploymentLocaleConfig } from '../workspace'\nimport { getStudioOperations } from '../operations'\nimport type { OperationEvent, OperationsClient, StudioOperations } from '../operations'\nimport { getStudioRegistry } from '../registry'\nimport { buildReferenceEntryViews } from './reference-model'\nimport type { ReferenceEntryView, ReferenceLabelContext } from './reference-model'\n\n/**\n * Data layer for the EC-172 references panels. All reads go through\n * `@elytracms/core/operations` queries (`references.outbound` / `references.inbound`\n * plus the labeling queries) — UI code never touches persistence repositories\n * or index tables. The hook keeps panels live: any succeeded command in a\n * content-bearing domain re-queries after the EC-155 maintained-on-write\n * attachment has flushed.\n */\n\nexport interface ReferencePanelQuery {\n  projectId: string\n  /** Enables the outbound (\"references\") section. */\n  source?: ReferenceSource | undefined\n  /** Enables the inbound (\"used by\") section. */\n  target?: ReferenceTarget | undefined\n}\n\nexport interface ReferencePanelData {\n  outbound: ReferenceEntryView[]\n  inbound: ReferenceEntryView[]\n  /**\n   * Per-direction read error (EC-205): a direction whose query returns a\n   * structured non-ok degrades to an empty list plus this message, surfaced as a\n   * visible per-section error — instead of collapsing the whole panel into its\n   * hard-error state. `null` when the direction loaded (or was not requested).\n   */\n  outboundError: string | null\n  inboundError: string | null\n}\n\n// --- Index bootstrap -----------------------------------------------------------\n\n/**\n * The EC-155 index is maintained on write, but seeded/imported projects start\n * with an empty index. {@link ensureReferenceIndex} seeds it once per project per\n * operations client; failures (e.g. a viewer's command denial) degrade to\n * whatever the maintained-on-write index already holds.\n */\nconst backfillsByClient = new WeakMap<StudioOperations, Map<string, Promise<void>>>()\n\n/**\n * Seed the index once if it has never been backfilled, then never again — the\n * EC-269 mutation-free read path. The index is maintained on write, so the\n * (clear + rebuild) `backfill` is only needed to seed a never-built index. A\n * persisted marker (`references.buildMarker`, a read) records completion; when\n * present this returns after a single query with ZERO mutations — so opening the\n * References panel no longer rewrites the whole index every session (the normal\n * Convex case: the EC-233 import already backfilled). Only a genuinely empty/\n * never-built project still pays the one-time backfill (and a viewer who cannot\n * run it degrades to the maintained-on-write index, as before).\n */\nasync function seedReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  try {\n    const marker = await studio.operations.references.buildMarker({ projectId })\n    if (marker.ok && marker.value !== null) return\n  } catch {\n    // A marker-read failure falls through to the backfill (best-effort seed).\n  }\n  await studio.operations.references.backfill({ projectId }).then(\n    () => undefined,\n    () => undefined,\n  )\n}\n\nexport function ensureReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  let byProject = backfillsByClient.get(studio)\n  if (!byProject) {\n    byProject = new Map()\n    backfillsByClient.set(studio, byProject)\n  }\n  let pending = byProject.get(projectId)\n  if (!pending) {\n    pending = seedReferenceIndex(studio, projectId)\n    byProject.set(projectId, pending)\n  }\n  return pending\n}\n\n// --- Label context loading -------------------------------------------------------\n\nasync function loadLabelContext(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<ReferenceLabelContext> {\n  const [schemaResult, documentsResult, assetsResult] = await Promise.all([\n    operations.schema.get({ projectId }),\n    operations.documents.list({ projectId }),\n    operations.assets.list({ projectId }),\n  ])\n\n  const collections = schemaResult.ok ? schemaResult.value.collections : []\n  const documents = new Map<string, CmsDocument>()\n  if (documentsResult.ok) {\n    for (const record of documentsResult.value) {\n      documents.set(\n        documentKey({ collection: record.document.collection, id: record.document.id }),\n        record.document,\n      )\n    }\n  }\n  // EC-287: the project graph is retired; reference source labels resolve from\n  // CMS documents only. `page`/`layout` graph sources no longer exist.\n  const assets = new Map<string, { filename: string; title?: string | undefined }>()\n  if (assetsResult.ok) {\n    for (const asset of assetsResult.value) {\n      assets.set(asset.id, { filename: asset.filename, title: asset.title })\n    }\n  }\n  const registry = getStudioRegistry().registry\n  return {\n    collections,\n    documents,\n    assets,\n    // EC-580: titles read the default-locale view of the project's ONE locale\n    // config — the one the CMS session installed (`configureStudioLocales`), else\n    // (a rail opened before any CMS session, e.g. Assets) the active config\n    // project's, which is where the session's value comes from in the first place.\n    locales: getStudioLocaleConfig() ?? resolveDeploymentLocaleConfig() ?? null,\n    // EC-407: `title` is a LocalizedString — resolve it to the active UI locale\n    // (a plain string is unchanged), never leak a `{ en, de }` object to the label.\n    componentTitle: (componentId) => {\n      const title = registry.getManifest(componentId)?.title\n      return title === undefined ? undefined : localizedLabel(title) || undefined\n    },\n  }\n}\n\n// --- Panel data loading -----------------------------------------------------------\n\n/** Load both directions + labels for one panel (operations queries only). */\nexport async function loadReferencePanelData(\n  query: ReferencePanelQuery,\n): Promise<ReferencePanelData> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, query.projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-205: load each direction INDEPENDENTLY. A structured non-ok from one\n  // direction is a degradable operation result (it carries an OperationError —\n  // the documented contract), not an exception: degrade that direction to empty\n  // and surface its error per-section (references-panel) while the other still\n  // renders, instead of throwing the whole panel into its hard-error state. A\n  // genuinely broken backend still throws from getStudioOperations/flush above.\n  const [outbound, inbound] = await Promise.all([\n    query.source\n      ? operations.references.outbound({ projectId: query.projectId, source: query.source })\n      : null,\n    query.target\n      ? operations.references.inbound({ projectId: query.projectId, target: query.target })\n      : null,\n  ])\n\n  type DirectionResult = Awaited<ReturnType<typeof operations.references.outbound>>\n  const settle = (\n    result: DirectionResult | null,\n  ): { records: ReferenceEntryRecord[]; error: string | null } =>\n    result === null\n      ? { records: [], error: null }\n      : result.ok\n        ? { records: result.value, error: null }\n        : { records: [], error: result.error.message }\n  const out = settle(outbound)\n  const inb = settle(inbound)\n\n  // EC-302: nothing referenced in either direction → no sources/targets to label,\n  // so skip the label-context load entirely (schema + ALL documents + ALL assets).\n  // Common for leaf content; mirrors the asset short-circuit in\n  // `loadInboundAssetReferenceViews`.\n  if (out.records.length === 0 && inb.records.length === 0) {\n    return { outbound: [], inbound: [], outboundError: out.error, inboundError: inb.error }\n  }\n\n  const context = await loadLabelContext(operations, query.projectId)\n  return {\n    outbound: buildReferenceEntryViews(out.records, context),\n    inbound: buildReferenceEntryViews(inb.records, context),\n    outboundError: out.error,\n    inboundError: inb.error,\n  }\n}\n\n// --- Impact loading (EC-173 safe unpublish/delete) -------------------------------\n\n/**\n * Load the labelled inbound entry views for a set of target documents in ONE\n * pass (one index flush, one label-context load) — the pre-flight data of the\n * EC-173 confirmation dialogs, including the bulk flows. Returns entries in\n * `targets` order; pair with `buildReferenceImpact` for break/block semantics.\n *\n * `toTarget` maps each acted-on ref to its reference-index target shape\n * (EC-433): the default is the document shape every `cmsDocuments` collection\n * indexes under; a rail whose records live under a different target type (the\n * assets rail, `{ type: 'asset' }`) supplies its own via\n * `CollectionViewSource.referenceTarget` — otherwise its pre-flight would\n * query the wrong shape and report referenced records as \"not referenced\".\n */\nexport async function loadInboundReferenceViews(\n  projectId: string,\n  targets: readonly DocumentRef[],\n  toTarget: (ref: DocumentRef) => ReferenceTarget = (ref) => ({\n    type: 'document',\n    id: documentKey(ref),\n  }),\n): Promise<{ ref: DocumentRef; inbound: ReferenceEntryView[] }[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-308: one batched query for ALL targets (the operation loops the by_target\n  // index server-side) instead of a per-target `inbound` fan-out. Returns one\n  // record list per target, in `targets` order.\n  const recordsPerTarget = await operations.references\n    .inboundMany({\n      projectId,\n      targets: targets.map((ref) => toTarget(ref)),\n    })\n    .then((result) => {\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    })\n  // EC-302: no inbound refs for ANY target → no sources to label, so skip the\n  // label-context load (schema + ALL documents + ALL assets). The common case when\n  // deleting/unpublishing unreferenced documents (incl. bulk); mirrors the EC-301\n  // short-circuit already in `loadInboundAssetReferenceViews`.\n  if (recordsPerTarget.every((records) => records.length === 0)) {\n    return targets.map((ref) => ({ ref, inbound: [] }))\n  }\n  const context = await loadLabelContext(operations, projectId)\n  return targets.map((ref, index) => ({\n    ref,\n    inbound: buildReferenceEntryViews(recordsPerTarget[index] ?? [], context),\n  }))\n}\n\n/**\n * Inbound reference views for ONE asset (EC-202): the \"what uses this asset\"\n * pre-flight of the asset-delete dialog, index-accurate (the EC-155 reference\n * index, not the retired `find-asset-usages` string scan). Mirrors\n * {@link loadInboundReferenceViews} for a single `{ type: 'asset' }` target —\n * the source labels resolve the referencing documents/graph-nodes identically.\n */\nexport async function loadInboundAssetReferenceViews(\n  projectId: string,\n  assetId: string,\n): Promise<ReferenceEntryView[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n  const result = await operations.references.inbound({\n    projectId,\n    target: { type: 'asset', id: assetId },\n  })\n  if (!result.ok) throw new Error(result.error.message)\n  // No inbound references → no sources to label, so skip the label-context load\n  // entirely (schema + ALL documents + ALL assets). This is the common case for a\n  // deletable asset, making the delete dialog's pre-flight a single indexed query\n  // instead of three full-table lists (EC-301 perf).\n  if (result.value.length === 0) return []\n  const context = await loadLabelContext(operations, projectId)\n  return buildReferenceEntryViews(result.value, context)\n}\n\n// --- React hook ----------------------------------------------------------------\n\n/**\n * Domains whose successful commands can change the reference index or labels and\n * should refresh an open panel. `references` is deliberately ABSENT (EC-269):\n * reacting to reference-index command events (the `backfill`) would make the\n * panel re-trigger on its OWN index maintenance — a self-cascade that, compounded\n * with the per-keystroke `documents` events, produced hundreds of redundant\n * reloads per document. The index is maintained on write; the panel reacts to the\n * CONTENT domains that feed it, never to its own index writes.\n */\nconst REFERENCE_REFRESH_TRIGGERS = [\n  'documents',\n  'graph',\n  'publishing',\n  'assets',\n  'schema',\n] as const\n\nconst REFRESH_DOMAINS: ReadonlySet<string> = new Set(REFERENCE_REFRESH_TRIGGERS)\n\n/**\n * Whether one operation event should refresh an open reference panel. Exported\n * for tests — pins the EC-269 contract that reference-index commands (and any\n * non-succeeded / non-command event) never trigger a reload.\n */\nexport function isReferenceRefreshEvent(event: OperationEvent): boolean {\n  return (\n    event.kind === 'command' && event.status === 'succeeded' && REFRESH_DOMAINS.has(event.domain)\n  )\n}\n\nexport type ReferencePanelStatus = 'loading' | 'ready' | 'error'\n\nexport interface ReferencePanelState {\n  status: ReferencePanelStatus\n  data: ReferencePanelData | null\n  errorMessage: string | null\n  refresh: () => void\n}\n\n/**\n * Live panel state for one entity (EC-308/AD-17): loads + caches through the one\n * `useOperationQuery` seam, and re-queries whenever a content-bearing command\n * succeeds anywhere in the studio (the index is maintained on write). Per-direction\n * read errors degrade INSIDE `loadReferencePanelData` (carried on the data); a hard\n * failure (broken backend) surfaces as the query's error → `status: 'error'`.\n */\nexport function useReferencePanel(query: ReferencePanelQuery): ReferencePanelState {\n  const { projectId } = query\n  const sourceType = query.source?.type\n  const sourceId = query.source?.id\n  const targetType = query.target?.type\n  const targetId = query.target?.id\n\n  const stableQuery = useMemo<ReferencePanelQuery>(\n    () => ({\n      projectId,\n      ...(sourceType && sourceId ? { source: { type: sourceType, id: sourceId } } : {}),\n      ...(targetType && targetId ? { target: { type: targetType, id: targetId } } : {}),\n    }),\n    [projectId, sourceType, sourceId, targetType, targetId],\n  )\n\n  const result = useOperationQuery<ReferencePanelData>({\n    queryKey: [\n      'referencePanel',\n      projectId,\n      sourceType ?? '',\n      sourceId ?? '',\n      targetType ?? '',\n      targetId ?? '',\n    ],\n    loader: () => loadReferencePanelData(stableQuery),\n    invalidateOn: REFERENCE_REFRESH_TRIGGERS,\n  })\n\n  const status: ReferencePanelStatus = result.isPending\n    ? 'loading'\n    : result.isError\n      ? 'error'\n      : 'ready'\n  return {\n    status,\n    data: result.data ?? null,\n    errorMessage: result.error instanceof Error ? result.error.message : null,\n    refresh: () => void result.refetch(),\n  }\n}\n"]}
+{"version":3,"file":"references-store.js","sourceRoot":"","sources":["../../../src/lib/references/references-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { useMemo } from 'react'\nimport { documentKey } from '@elytracms/core/cms-core'\nimport { useOperationQuery } from '@elytracms/studio/lib/query'\nimport type { CmsDocument, DocumentRef } from '@elytracms/core/cms-core'\nimport type { ConflictReferrer } from '@elytracms/core/operations'\nimport type {\n  ReferenceEntryRecord,\n  ReferenceSource,\n  ReferenceTarget,\n} from '@elytracms/core/persistence'\nimport { localizedLabel } from '../i18n'\nimport { getStudioLocaleConfig } from '../locale/locale-store'\nimport { resolveDeploymentCollections, resolveDeploymentLocaleConfig } from '../workspace'\nimport { getStudioOperations } from '../operations'\nimport type { OperationEvent, OperationsClient, StudioOperations } from '../operations'\nimport { getStudioRegistry } from '../registry'\nimport { buildReferenceEntryViews } from './reference-model'\nimport type { ReferenceEntryView, ReferenceLabelContext } from './reference-model'\n\n/**\n * Data layer for the EC-172 references panels. All reads go through\n * `@elytracms/core/operations` queries (`references.outbound` / `references.inbound`\n * plus the labeling queries) — UI code never touches persistence repositories\n * or index tables. The hook keeps panels live: any succeeded command in a\n * content-bearing domain re-queries after the EC-155 maintained-on-write\n * attachment has flushed.\n */\n\nexport interface ReferencePanelQuery {\n  projectId: string\n  /** Enables the outbound (\"references\") section. */\n  source?: ReferenceSource | undefined\n  /** Enables the inbound (\"used by\") section. */\n  target?: ReferenceTarget | undefined\n}\n\nexport interface ReferencePanelData {\n  outbound: ReferenceEntryView[]\n  inbound: ReferenceEntryView[]\n  /**\n   * Per-direction read error (EC-205): a direction whose query returns a\n   * structured non-ok degrades to an empty list plus this message, surfaced as a\n   * visible per-section error — instead of collapsing the whole panel into its\n   * hard-error state. `null` when the direction loaded (or was not requested).\n   */\n  outboundError: string | null\n  inboundError: string | null\n}\n\n// --- Index bootstrap -----------------------------------------------------------\n\n/**\n * The EC-155 index is maintained on write, but seeded/imported projects start\n * with an empty index. {@link ensureReferenceIndex} seeds it once per project per\n * operations client; failures (e.g. a viewer's command denial) degrade to\n * whatever the maintained-on-write index already holds.\n */\nconst backfillsByClient = new WeakMap<StudioOperations, Map<string, Promise<void>>>()\n\n/**\n * Seed the index once if it has never been backfilled, then never again — the\n * EC-269 mutation-free read path. The index is maintained on write, so the\n * (clear + rebuild) `backfill` is only needed to seed a never-built index. A\n * persisted marker (`references.buildMarker`, a read) records completion; when\n * present this returns after a single query with ZERO mutations — so opening the\n * References panel no longer rewrites the whole index every session (the normal\n * Convex case: the EC-233 import already backfilled). Only a genuinely empty/\n * never-built project still pays the one-time backfill (and a viewer who cannot\n * run it degrades to the maintained-on-write index, as before).\n */\nasync function seedReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  try {\n    const marker = await studio.operations.references.buildMarker({ projectId })\n    if (marker.ok && marker.value !== null) return\n  } catch {\n    // A marker-read failure falls through to the backfill (best-effort seed).\n  }\n  await studio.operations.references.backfill({ projectId }).then(\n    () => undefined,\n    () => undefined,\n  )\n}\n\nexport function ensureReferenceIndex(studio: StudioOperations, projectId: string): Promise<void> {\n  let byProject = backfillsByClient.get(studio)\n  if (!byProject) {\n    byProject = new Map()\n    backfillsByClient.set(studio, byProject)\n  }\n  let pending = byProject.get(projectId)\n  if (!pending) {\n    pending = seedReferenceIndex(studio, projectId)\n    byProject.set(projectId, pending)\n  }\n  return pending\n}\n\n// --- Label context loading -------------------------------------------------------\n\nasync function loadLabelContext(\n  operations: OperationsClient,\n  projectId: string,\n): Promise<ReferenceLabelContext> {\n  const [documentsResult, assetsResult] = await Promise.all([\n    operations.documents.list({ projectId }),\n    operations.assets.list({ projectId }),\n  ])\n\n  // EC-583 / EC-559: the labels' schema is the config's (the store holds no schema).\n  const collections = resolveDeploymentCollections()\n  const documents = new Map<string, CmsDocument>()\n  if (documentsResult.ok) {\n    for (const record of documentsResult.value) {\n      documents.set(\n        documentKey({ collection: record.document.collection, id: record.document.id }),\n        record.document,\n      )\n    }\n  }\n  // EC-287: the project graph is retired; reference source labels resolve from\n  // CMS documents only. `page`/`layout` graph sources no longer exist.\n  const assets = new Map<string, { filename: string; title?: string | undefined }>()\n  if (assetsResult.ok) {\n    for (const asset of assetsResult.value) {\n      assets.set(asset.id, { filename: asset.filename, title: asset.title })\n    }\n  }\n  const registry = getStudioRegistry().registry\n  return {\n    collections,\n    documents,\n    assets,\n    // EC-580: titles read the default-locale view of the project's ONE locale\n    // config — the one the CMS session installed (`configureStudioLocales`), else\n    // (a rail opened before any CMS session, e.g. Assets) the active config\n    // project's, which is where the session's value comes from in the first place.\n    locales: getStudioLocaleConfig() ?? resolveDeploymentLocaleConfig() ?? null,\n    // EC-407: `title` is a LocalizedString — resolve it to the active UI locale\n    // (a plain string is unchanged), never leak a `{ en, de }` object to the label.\n    componentTitle: (componentId) => {\n      const title = registry.getManifest(componentId)?.title\n      return title === undefined ? undefined : localizedLabel(title) || undefined\n    },\n  }\n}\n\n// --- Panel data loading -----------------------------------------------------------\n\n/** Load both directions + labels for one panel (operations queries only). */\nexport async function loadReferencePanelData(\n  query: ReferencePanelQuery,\n): Promise<ReferencePanelData> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, query.projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-205: load each direction INDEPENDENTLY. A structured non-ok from one\n  // direction is a degradable operation result (it carries an OperationError —\n  // the documented contract), not an exception: degrade that direction to empty\n  // and surface its error per-section (references-panel) while the other still\n  // renders, instead of throwing the whole panel into its hard-error state. A\n  // genuinely broken backend still throws from getStudioOperations/flush above.\n  const [outbound, inbound] = await Promise.all([\n    query.source\n      ? operations.references.outbound({ projectId: query.projectId, source: query.source })\n      : null,\n    query.target\n      ? operations.references.inbound({ projectId: query.projectId, target: query.target })\n      : null,\n  ])\n\n  type DirectionResult = Awaited<ReturnType<typeof operations.references.outbound>>\n  const settle = (\n    result: DirectionResult | null,\n  ): { records: ReferenceEntryRecord[]; error: string | null } =>\n    result === null\n      ? { records: [], error: null }\n      : result.ok\n        ? { records: result.value, error: null }\n        : { records: [], error: result.error.message }\n  const out = settle(outbound)\n  const inb = settle(inbound)\n\n  // EC-302: nothing referenced in either direction → no sources/targets to label,\n  // so skip the label-context load entirely (schema + ALL documents + ALL assets).\n  // Common for leaf content; mirrors the asset short-circuit in\n  // `loadInboundAssetReferenceViews`.\n  if (out.records.length === 0 && inb.records.length === 0) {\n    return { outbound: [], inbound: [], outboundError: out.error, inboundError: inb.error }\n  }\n\n  const context = await loadLabelContext(operations, query.projectId)\n  return {\n    outbound: buildReferenceEntryViews(out.records, context),\n    inbound: buildReferenceEntryViews(inb.records, context),\n    outboundError: out.error,\n    inboundError: inb.error,\n  }\n}\n\n// --- Impact loading (EC-173 safe unpublish/delete) -------------------------------\n\n/**\n * Load the labelled inbound entry views for a set of target documents in ONE\n * pass (one index flush, one label-context load) — the pre-flight data of the\n * EC-173 confirmation dialogs, including the bulk flows. Returns entries in\n * `targets` order; pair with `buildReferenceImpact` for break/block semantics.\n *\n * `toTarget` maps each acted-on ref to its reference-index target shape\n * (EC-433): the default is the document shape every `cmsDocuments` collection\n * indexes under; a rail whose records live under a different target type (the\n * assets rail, `{ type: 'asset' }`) supplies its own via\n * `CollectionViewSource.referenceTarget` — otherwise its pre-flight would\n * query the wrong shape and report referenced records as \"not referenced\".\n */\nexport async function loadInboundReferenceViews(\n  projectId: string,\n  targets: readonly DocumentRef[],\n  toTarget: (ref: DocumentRef) => ReferenceTarget = (ref) => ({\n    type: 'document',\n    id: documentKey(ref),\n  }),\n): Promise<{ ref: DocumentRef; inbound: ReferenceEntryView[] }[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n\n  // EC-308: one batched query for ALL targets (the operation loops the by_target\n  // index server-side) instead of a per-target `inbound` fan-out. Returns one\n  // record list per target, in `targets` order.\n  const recordsPerTarget = await operations.references\n    .inboundMany({\n      projectId,\n      targets: targets.map((ref) => toTarget(ref)),\n    })\n    .then((result) => {\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    })\n  // EC-302: no inbound refs for ANY target → no sources to label, so skip the\n  // label-context load (schema + ALL documents + ALL assets). The common case when\n  // deleting/unpublishing unreferenced documents (incl. bulk); mirrors the EC-301\n  // short-circuit already in `loadInboundAssetReferenceViews`.\n  if (recordsPerTarget.every((records) => records.length === 0)) {\n    return targets.map((ref) => ({ ref, inbound: [] }))\n  }\n  const context = await loadLabelContext(operations, projectId)\n  return targets.map((ref, index) => ({\n    ref,\n    inbound: buildReferenceEntryViews(recordsPerTarget[index] ?? [], context),\n  }))\n}\n\n/**\n * The strict referrers of each acted-on document (EC-589) — the core guard's OWN\n * computation (`references.strictReferrers`: THE reference walk over live drafts and\n * pinned snapshots, every position, severity off the declaration), so the dialog blocks\n * exactly when `documents.delete` / `unpublish` would refuse. One list per target, in\n * `targets` order; pair with {@link loadInboundReferenceViews} in `buildReferenceImpact`.\n */\nexport async function loadStrictReferrers(\n  projectId: string,\n  targets: readonly DocumentRef[],\n  action: 'delete' | 'unpublish',\n): Promise<ConflictReferrer[][]> {\n  if (targets.length === 0) return []\n  const studio = await getStudioOperations()\n  const result = await studio.operations.references.strictReferrers({\n    projectId,\n    targets: [...targets],\n    mode: action,\n  })\n  if (!result.ok) throw new Error(result.error.message)\n  return result.value.map((referrers) => [...referrers])\n}\n\n/**\n * Inbound reference views for ONE asset (EC-202): the \"what uses this asset\"\n * pre-flight of the asset-delete dialog, index-accurate (the EC-155 reference\n * index, not the retired `find-asset-usages` string scan). Mirrors\n * {@link loadInboundReferenceViews} for a single `{ type: 'asset' }` target —\n * the source labels resolve the referencing documents/graph-nodes identically.\n */\nexport async function loadInboundAssetReferenceViews(\n  projectId: string,\n  assetId: string,\n): Promise<ReferenceEntryView[]> {\n  const studio = await getStudioOperations()\n  await ensureReferenceIndex(studio, projectId)\n  // Observe a settled index: maintained-on-write updates run async after events.\n  await studio.references.flush()\n  const operations = studio.operations\n  const result = await operations.references.inbound({\n    projectId,\n    target: { type: 'asset', id: assetId },\n  })\n  if (!result.ok) throw new Error(result.error.message)\n  // No inbound references → no sources to label, so skip the label-context load\n  // entirely (schema + ALL documents + ALL assets). This is the common case for a\n  // deletable asset, making the delete dialog's pre-flight a single indexed query\n  // instead of three full-table lists (EC-301 perf).\n  if (result.value.length === 0) return []\n  const context = await loadLabelContext(operations, projectId)\n  return buildReferenceEntryViews(result.value, context)\n}\n\n// --- React hook ----------------------------------------------------------------\n\n/**\n * Domains whose successful commands can change the reference index or labels and\n * should refresh an open panel. `references` is deliberately ABSENT (EC-269):\n * reacting to reference-index command events (the `backfill`) would make the\n * panel re-trigger on its OWN index maintenance — a self-cascade that, compounded\n * with the per-keystroke `documents` events, produced hundreds of redundant\n * reloads per document. The index is maintained on write; the panel reacts to the\n * CONTENT domains that feed it, never to its own index writes.\n */\nconst REFERENCE_REFRESH_TRIGGERS = [\n  'documents',\n  'graph',\n  'publishing',\n  'assets',\n  'schema',\n] as const\n\nconst REFRESH_DOMAINS: ReadonlySet<string> = new Set(REFERENCE_REFRESH_TRIGGERS)\n\n/**\n * Whether one operation event should refresh an open reference panel. Exported\n * for tests — pins the EC-269 contract that reference-index commands (and any\n * non-succeeded / non-command event) never trigger a reload.\n */\nexport function isReferenceRefreshEvent(event: OperationEvent): boolean {\n  return (\n    event.kind === 'command' && event.status === 'succeeded' && REFRESH_DOMAINS.has(event.domain)\n  )\n}\n\nexport type ReferencePanelStatus = 'loading' | 'ready' | 'error'\n\nexport interface ReferencePanelState {\n  status: ReferencePanelStatus\n  data: ReferencePanelData | null\n  errorMessage: string | null\n  refresh: () => void\n}\n\n/**\n * Live panel state for one entity (EC-308/AD-17): loads + caches through the one\n * `useOperationQuery` seam, and re-queries whenever a content-bearing command\n * succeeds anywhere in the studio (the index is maintained on write). Per-direction\n * read errors degrade INSIDE `loadReferencePanelData` (carried on the data); a hard\n * failure (broken backend) surfaces as the query's error → `status: 'error'`.\n */\nexport function useReferencePanel(query: ReferencePanelQuery): ReferencePanelState {\n  const { projectId } = query\n  const sourceType = query.source?.type\n  const sourceId = query.source?.id\n  const targetType = query.target?.type\n  const targetId = query.target?.id\n\n  const stableQuery = useMemo<ReferencePanelQuery>(\n    () => ({\n      projectId,\n      ...(sourceType && sourceId ? { source: { type: sourceType, id: sourceId } } : {}),\n      ...(targetType && targetId ? { target: { type: targetType, id: targetId } } : {}),\n    }),\n    [projectId, sourceType, sourceId, targetType, targetId],\n  )\n\n  const result = useOperationQuery<ReferencePanelData>({\n    queryKey: [\n      'referencePanel',\n      projectId,\n      sourceType ?? '',\n      sourceId ?? '',\n      targetType ?? '',\n      targetId ?? '',\n    ],\n    loader: () => loadReferencePanelData(stableQuery),\n    invalidateOn: REFERENCE_REFRESH_TRIGGERS,\n  })\n\n  const status: ReferencePanelStatus = result.isPending\n    ? 'loading'\n    : result.isError\n      ? 'error'\n      : 'ready'\n  return {\n    status,\n    data: result.data ?? null,\n    errorMessage: result.error instanceof Error ? result.error.message : null,\n    refresh: () => void result.refetch(),\n  }\n}\n"]}

package/dist/lib/routes/route-issues.d.ts

@@ -1,9 +1,9 @@
-import type { CmsValidationIssue, RouteRecord } from '@elytracms/core/cms-core';
+import type { CmsValidationIssue, RouterProject } from '@elytracms/core/cms-core';
 import type { RedirectEntry } from '@elytracms/core/persistence';
 /**
- * The project's structural URL-map issues: route conflicts (from config routes),
- * redirect loops (from the enabled editorial redirects), and declarations that cannot
- * serve content at all (EC-484). Pure and total — it never throws, and an empty result
- * means "no structural problem", not "not checked".
+ * The project's structural URL-map issues — the one router's issue set over the resolved
+ * project's routes and collections and the enabled editorial redirects, with a redirect
+ * cycle's rotations collapsed into one finding. Pure and total: it never throws, and an
+ * empty result means "no structural problem", not "not checked".
  */
-export declare function routeValidationIssues(routes: readonly RouteRecord[], redirects?: readonly RedirectEntry[]): readonly CmsValidationIssue[];
+export declare function routeValidationIssues(project: RouterProject, redirects?: readonly RedirectEntry[]): readonly CmsValidationIssue[];

package/dist/lib/routes/route-issues.js

@@ -1,60 +1,24 @@
-import { createRouter, isHierarchyTemplate, routeReachabilityIssues } from '@elytracms/core/cms-core';
+import { createRouter, liveRedirectRecords } from '@elytracms/core/cms-core';
 /**
- * The studio's URL-map validation (EC-469) — the pure core.
- *
- * `createRouter` has always computed structural issues (**route conflicts** and
- * **redirect loops**) and, before this, no studio surface showed them. The delivery
- * content client exposes them as `routerIssues`, but that path never reaches the
- * studio: it serves the delivery host. So the studio computes them from the two
- * inputs it already holds, which is also the only way it can: routes come from
- * config (`resolveDeploymentRoutes`), redirects come from the editorial rail.
- *
- * This is NOT a revived Routes view (EC-303 retired that, correctly — routes are
- * code). It is validation of the code + data the studio already reads.
- *
- * **Fidelity is the whole point**, so both of delivery's input rules are applied
- * here, not approximated:
- *
- * - **Hierarchy mounts are filtered out** (`content/client.ts` does exactly this
- *   before constructing its router). A mount (`/:path*`, EC-218) is resolved
- *   per-request against the parent chain, not by the router. Counting it as a route
- *   makes `/:slug` + `/:path*` look like a conflict — measured — which the runtime
- *   does not consider one. A false alarm here would be worse than no alarm: it would
- *   teach developers to ignore the surface.
- * - **Only ENABLED redirects count** (`delivery:snapshot` filters `row.enabled`).
- *   `enabled` is the switch for *pausing* a redirect, so a paused chain is not live
- *   and must not be reported as a loop.
- *
- * `unknown-route-target` is deliberately NOT produced by the ROUTER here. Despite the
- * ticket's framing it is not a router issue: the *resolver* raises it per resolved URL
- * against the documents that exist (`content/client.ts`), so it needs a URL and a
- * document pool, neither of which a project-level check has.
- *
- * ## Unreachable declarations (EC-484)
- *
- * Beside the two router codes, this reports declarations that serve NOTHING —
- * measured, previously silent everywhere: an all-dynamic route (`/:slug`) matching
- * every URL at a depth a hierarchy mount serves; and a catch-all with a dynamic prefix
- * (`/:lang/:path*`), which every router drops and no mount is built from.
- *
- * **EC-488 narrowed the first one.** It used to mean the mount's root pages 404 though
- * they exist in the studio; the resolver now falls through to the mounts when a matched
- * route resolves no document, so those pages serve and the finding is a `warning` about
- * content-decided precedence (a page whose composed path collides with the route
- * collection's slug is still silently shadowed). The severity comes from the shared
- * `routeReachabilityIssues`, so this surface tracks it without a change here.
- *
- * This one belongs in the studio, unlike the mount-vs-mount conflicts EC-482 left to
- * `elytra doctor`, because of who meets the symptom: a 404 on a page the editor can
- * see in the studio is what an editor reports and a developer cannot reproduce from a
- * document. Naming it at the rail foot turns "the About page is broken" into a route
- * id. It is also not a new precedent — this function has surfaced the code-side
- * `route-conflict` since EC-469.
- *
- * The COLLECTION-dependent half of EC-484 (a mount whose collection has no `parent`
- * self-relation, so it can never compose a path) is not here: this core is given
- * routes and redirects, and `elytra doctor` — which loads the collections anyway —
- * reports it at build time, where a developer fixes it.
+ * The studio's URL-map validation (EC-469) — the pure core, READING the one router's
+ * issue set (EC-590; EC-565 Round 3, 3h).
+ *
+ * `createRouter` (cms-core `router.ts`) owns the project's ONE route issue set:
+ * `route-conflict` (an exact tie of the one precedence), `redirect-loop` and
+ * `invalid-redirect` (the one normalised redirect set — a duplicate `from` after
+ * trailing-slash normalisation), hierarchy-mount conflicts, and reachability. The same
+ * set is read by `elytra doctor` and surfaced by the delivery host at build/dev — before
+ * EC-590 this file was one of three that filtered mounts out and built a router of its
+ * own, and the collection-dependent reachability half ran only in the doctor.
+ *
+ * The inputs are the two the studio holds: the resolved project's routes + collections
+ * (config, AD-11) and the editorial redirects (data, EC-303). Only ENABLED redirects
+ * count (`liveRedirectRecords`, the one projection — a paused redirect is not live and
+ * is never reported as a loop).
+ *
+ * `unknown-route-target` is deliberately NOT here: the resolver raises it per resolved URL
+ * against the documents that exist (`content/client.ts`), which a project-level check
+ * does not have.
  */
 /**
  * Collapse the several reports of ONE redirect cycle into one finding.
@@ -86,31 +50,13 @@ function collapseLoops(issues) {
     }
     return out;
 }
-/** Project the stored editorial records onto the routing shape delivery resolves. */
-function liveRedirects(redirects) {
-    return redirects
-        .filter((entry) => entry.enabled)
-        .map((entry) => ({
-        id: entry.id,
-        from: entry.from,
-        to: entry.to,
-        permanent: entry.permanent,
-    }));
-}
 /**
- * The project's structural URL-map issues: route conflicts (from config routes),
- * redirect loops (from the enabled editorial redirects), and declarations that cannot
- * serve content at all (EC-484). Pure and total — it never throws, and an empty result
- * means "no structural problem", not "not checked".
+ * The project's structural URL-map issues — the one router's issue set over the resolved
+ * project's routes and collections and the enabled editorial redirects, with a redirect
+ * cycle's rotations collapsed into one finding. Pure and total: it never throws, and an
+ * empty result means "no structural problem", not "not checked".
  */
-export function routeValidationIssues(routes, redirects = []) {
-    const routable = routes.filter((route) => !isHierarchyTemplate(route));
-    return [
-        ...collapseLoops(createRouter(routable, liveRedirects(redirects)).issues),
-        // Routes only: the reachability checks that need the collection set stay with
-        // `elytra doctor`, which has it. Passing no collections is the documented way to
-        // ask for exactly the route-side half.
-        ...routeReachabilityIssues(routes),
-    ];
+export function routeValidationIssues(project, redirects = []) {
+    return collapseLoops(createRouter(project, { redirects: liveRedirectRecords(redirects) }).issues);
 }
 //# sourceMappingURL=route-issues.js.map

package/dist/lib/routes/route-issues.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-issues.js","sourceRoot":"","sources":["../../../src/lib/routes/route-issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAIrG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,MAAqC;IAC1D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAyB,EAAE,CAAA;IACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACf,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,CAAA;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC9B,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;YAClD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,qFAAqF;AACrF,SAAS,aAAa,CAAC,SAAmC;IACxD,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;SAChC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC,CAAA;AACP,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAA8B,EAC9B,YAAsC,EAAE;IAExC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAA;IACtE,OAAO;QACL,GAAG,aAAa,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QACzE,8EAA8E;QAC9E,iFAAiF;QACjF,uCAAuC;QACvC,GAAG,uBAAuB,CAAC,MAAM,CAAC;KACnC,CAAA;AACH,CAAC","sourcesContent":["import { createRouter, isHierarchyTemplate, routeReachabilityIssues } from '@elytracms/core/cms-core'\nimport type { CmsValidationIssue, RedirectRecord, RouteRecord } from '@elytracms/core/cms-core'\nimport type { RedirectEntry } from '@elytracms/core/persistence'\n\n/**\n * The studio's URL-map validation (EC-469) — the pure core.\n *\n * `createRouter` has always computed structural issues (**route conflicts** and\n * **redirect loops**) and, before this, no studio surface showed them. The delivery\n * content client exposes them as `routerIssues`, but that path never reaches the\n * studio: it serves the delivery host. So the studio computes them from the two\n * inputs it already holds, which is also the only way it can: routes come from\n * config (`resolveDeploymentRoutes`), redirects come from the editorial rail.\n *\n * This is NOT a revived Routes view (EC-303 retired that, correctly — routes are\n * code). It is validation of the code + data the studio already reads.\n *\n * **Fidelity is the whole point**, so both of delivery's input rules are applied\n * here, not approximated:\n *\n * - **Hierarchy mounts are filtered out** (`content/client.ts` does exactly this\n *   before constructing its router). A mount (`/:path*`, EC-218) is resolved\n *   per-request against the parent chain, not by the router. Counting it as a route\n *   makes `/:slug` + `/:path*` look like a conflict — measured — which the runtime\n *   does not consider one. A false alarm here would be worse than no alarm: it would\n *   teach developers to ignore the surface.\n * - **Only ENABLED redirects count** (`delivery:snapshot` filters `row.enabled`).\n *   `enabled` is the switch for *pausing* a redirect, so a paused chain is not live\n *   and must not be reported as a loop.\n *\n * `unknown-route-target` is deliberately NOT produced by the ROUTER here. Despite the\n * ticket's framing it is not a router issue: the *resolver* raises it per resolved URL\n * against the documents that exist (`content/client.ts`), so it needs a URL and a\n * document pool, neither of which a project-level check has.\n *\n * ## Unreachable declarations (EC-484)\n *\n * Beside the two router codes, this reports declarations that serve NOTHING —\n * measured, previously silent everywhere: an all-dynamic route (`/:slug`) matching\n * every URL at a depth a hierarchy mount serves; and a catch-all with a dynamic prefix\n * (`/:lang/:path*`), which every router drops and no mount is built from.\n *\n * **EC-488 narrowed the first one.** It used to mean the mount's root pages 404 though\n * they exist in the studio; the resolver now falls through to the mounts when a matched\n * route resolves no document, so those pages serve and the finding is a `warning` about\n * content-decided precedence (a page whose composed path collides with the route\n * collection's slug is still silently shadowed). The severity comes from the shared\n * `routeReachabilityIssues`, so this surface tracks it without a change here.\n *\n * This one belongs in the studio, unlike the mount-vs-mount conflicts EC-482 left to\n * `elytra doctor`, because of who meets the symptom: a 404 on a page the editor can\n * see in the studio is what an editor reports and a developer cannot reproduce from a\n * document. Naming it at the rail foot turns \"the About page is broken\" into a route\n * id. It is also not a new precedent — this function has surfaced the code-side\n * `route-conflict` since EC-469.\n *\n * The COLLECTION-dependent half of EC-484 (a mount whose collection has no `parent`\n * self-relation, so it can never compose a path) is not here: this core is given\n * routes and redirects, and `elytra doctor` — which loads the collections anyway —\n * reports it at build time, where a developer fixes it.\n */\n\n/**\n * Collapse the several reports of ONE redirect cycle into one finding.\n *\n * `createRouter` walks every redirect and reports a loop per distinct loop *entry\n * point* (`routes.ts`, EC-020) — correct for a machine, but a 2-hop cycle then reads\n * as two separate bugs at the rail foot, and fixing one makes both vanish. Every\n * rotation of a cycle visits the same set of paths, so the sorted member set is a\n * stable identity for the cycle: dedupe on it, keep the first, and two genuinely\n * different cycles still report separately. Presentation only — nothing is hidden, and\n * `createRouter`'s shared behaviour is untouched.\n */\nfunction collapseLoops(issues: readonly CmsValidationIssue[]): CmsValidationIssue[] {\n  const seen = new Set<string>()\n  const out: CmsValidationIssue[] = []\n  for (const issue of issues) {\n    if (issue.code !== 'redirect-loop') {\n      out.push(issue)\n      continue\n    }\n    const chain = issue.meta?.chain\n    const key = Array.isArray(chain)\n      ? [...new Set(chain.map(String))].sort().join('|')\n      : issue.path.join('/')\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(issue)\n  }\n  return out\n}\n\n/** Project the stored editorial records onto the routing shape delivery resolves. */\nfunction liveRedirects(redirects: readonly RedirectEntry[]): RedirectRecord[] {\n  return redirects\n    .filter((entry) => entry.enabled)\n    .map((entry) => ({\n      id: entry.id,\n      from: entry.from,\n      to: entry.to,\n      permanent: entry.permanent,\n    }))\n}\n\n/**\n * The project's structural URL-map issues: route conflicts (from config routes),\n * redirect loops (from the enabled editorial redirects), and declarations that cannot\n * serve content at all (EC-484). Pure and total — it never throws, and an empty result\n * means \"no structural problem\", not \"not checked\".\n */\nexport function routeValidationIssues(\n  routes: readonly RouteRecord[],\n  redirects: readonly RedirectEntry[] = [],\n): readonly CmsValidationIssue[] {\n  const routable = routes.filter((route) => !isHierarchyTemplate(route))\n  return [\n    ...collapseLoops(createRouter(routable, liveRedirects(redirects)).issues),\n    // Routes only: the reachability checks that need the collection set stay with\n    // `elytra doctor`, which has it. Passing no collections is the documented way to\n    // ask for exactly the route-side half.\n    ...routeReachabilityIssues(routes),\n  ]\n}\n"]}
+{"version":3,"file":"route-issues.js","sourceRoot":"","sources":["../../../src/lib/routes/route-issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAI5E;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;GAUG;AACH,SAAS,aAAa,CAAC,MAAqC;IAC1D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAyB,EAAE,CAAA;IACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACf,SAAQ;QACV,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,CAAA;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC9B,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;YAClD,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAsB,EACtB,YAAsC,EAAE;IAExC,OAAO,aAAa,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;AACnG,CAAC","sourcesContent":["import { createRouter, liveRedirectRecords } from '@elytracms/core/cms-core'\nimport type { CmsValidationIssue, RouterProject } from '@elytracms/core/cms-core'\nimport type { RedirectEntry } from '@elytracms/core/persistence'\n\n/**\n * The studio's URL-map validation (EC-469) — the pure core, READING the one router's\n * issue set (EC-590; EC-565 Round 3, 3h).\n *\n * `createRouter` (cms-core `router.ts`) owns the project's ONE route issue set:\n * `route-conflict` (an exact tie of the one precedence), `redirect-loop` and\n * `invalid-redirect` (the one normalised redirect set — a duplicate `from` after\n * trailing-slash normalisation), hierarchy-mount conflicts, and reachability. The same\n * set is read by `elytra doctor` and surfaced by the delivery host at build/dev — before\n * EC-590 this file was one of three that filtered mounts out and built a router of its\n * own, and the collection-dependent reachability half ran only in the doctor.\n *\n * The inputs are the two the studio holds: the resolved project's routes + collections\n * (config, AD-11) and the editorial redirects (data, EC-303). Only ENABLED redirects\n * count (`liveRedirectRecords`, the one projection — a paused redirect is not live and\n * is never reported as a loop).\n *\n * `unknown-route-target` is deliberately NOT here: the resolver raises it per resolved URL\n * against the documents that exist (`content/client.ts`), which a project-level check\n * does not have.\n */\n\n/**\n * Collapse the several reports of ONE redirect cycle into one finding.\n *\n * `createRouter` walks every redirect and reports a loop per distinct loop *entry\n * point* (`routes.ts`, EC-020) — correct for a machine, but a 2-hop cycle then reads\n * as two separate bugs at the rail foot, and fixing one makes both vanish. Every\n * rotation of a cycle visits the same set of paths, so the sorted member set is a\n * stable identity for the cycle: dedupe on it, keep the first, and two genuinely\n * different cycles still report separately. Presentation only — nothing is hidden, and\n * `createRouter`'s shared behaviour is untouched.\n */\nfunction collapseLoops(issues: readonly CmsValidationIssue[]): CmsValidationIssue[] {\n  const seen = new Set<string>()\n  const out: CmsValidationIssue[] = []\n  for (const issue of issues) {\n    if (issue.code !== 'redirect-loop') {\n      out.push(issue)\n      continue\n    }\n    const chain = issue.meta?.chain\n    const key = Array.isArray(chain)\n      ? [...new Set(chain.map(String))].sort().join('|')\n      : issue.path.join('/')\n    if (seen.has(key)) continue\n    seen.add(key)\n    out.push(issue)\n  }\n  return out\n}\n\n/**\n * The project's structural URL-map issues — the one router's issue set over the resolved\n * project's routes and collections and the enabled editorial redirects, with a redirect\n * cycle's rotations collapsed into one finding. Pure and total: it never throws, and an\n * empty result means \"no structural problem\", not \"not checked\".\n */\nexport function routeValidationIssues(\n  project: RouterProject,\n  redirects: readonly RedirectEntry[] = [],\n): readonly CmsValidationIssue[] {\n  return collapseLoops(createRouter(project, { redirects: liveRedirectRecords(redirects) }).issues)\n}\n"]}

package/dist/lib/workspace/config-issues.js

@@ -1,3 +1,4 @@
+import { WORKSPACE_CONFIG_FILE } from '@elytracms/core/config';
 /**
  * EC-479 — project-level configuration findings for the section-rail foot.
  *
@@ -30,7 +31,7 @@ export const PROJECT_CONFIG_POINT = 'project';
  * Exported for the rail foot's other config-remedy message (EC-606's orphaned
  * collections), so the file name is declared once.
  */
-export const PROJECT_CONFIG_FILE = 'elytra.config.ts';
+export const PROJECT_CONFIG_FILE = WORKSPACE_CONFIG_FILE;
 /**
  * Catalog keys for the issues below (EC-478). Named here, next to the producer, so
  * the studio's i18n parity test asserts coverage against the producer rather than a

package/dist/lib/workspace/config-issues.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-issues.js","sourceRoot":"","sources":["../../../src/lib/workspace/config-issues.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAA;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,aAAa,EAAE,mCAAmC;CAC1C,CAAA;AAEV;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAqC;IAErC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IACrC,OAAO;QACL;YACE,IAAI,EAAE,uBAAuB;YAC7B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,8DAA8D,mBAAmB,iEAAiE;YAC3J,UAAU,EAAE;gBACV,GAAG,EAAE,yBAAyB,CAAC,aAAa;gBAC5C,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;aACpC;YACD,KAAK,EAAE,oBAAoB;SAC5B;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { CollectionDef } from '@elytracms/core/cms-core'\nimport type { CustomizationIssue } from '@elytracms/core/studio-core'\n\n/**\n * EC-479 — project-level configuration findings for the section-rail foot.\n *\n * The engine used to fill a missing declaration with its own `cms-core` fixtures:\n * `?? sampleFilterableCollections` in the CMS store, `?? sampleDocuments` beside\n * it, `?? sampleLocaleConfig` in the locale store. A studio whose config never\n * arrived therefore looked *configured* — it showed six documents about Ada\n * Lovelace under a four-collection schema, in `en/de`, none of which the project\n * had declared. The owner's ruling (2026-07-30): \"fixtures should only show in the\n * playground, but not be hard-wired in the engine\".\n *\n * With the fallbacks retired the same state renders as an empty CMS, which on its\n * own is the OTHER silent failure — the house rule bans both (\"if you are writing\n * a fallback that hides a broken state, that *is* the bug\"). This module is the\n * third option: say so, at the rail foot, where EC-467's reuse issues and EC-469's\n * URL-map issues already report project-level problems, on every studio surface.\n *\n * Pure and deterministic — no config-holder reads, no React. The caller supplies\n * the resolved config (`resolveDeploymentCollections()`), which is also what makes\n * this testable against a synthetic project instead of the live one.\n */\n\n/**\n * The extension-point name stamped on these issues. Not a customization registry\n * like `'sidebar'`/`'fieldRenderers'` — the finding is about the project's own\n * declarations, so it locates the config, not an override list.\n */\nexport const PROJECT_CONFIG_POINT = 'project'\n\n/**\n * The file a developer fixes these findings in — interpolated, never localized.\n * Exported for the rail foot's other config-remedy message (EC-606's orphaned\n * collections), so the file name is declared once.\n */\nexport const PROJECT_CONFIG_FILE = 'elytra.config.ts'\n\n/**\n * Catalog keys for the issues below (EC-478). Named here, next to the producer, so\n * the studio's i18n parity test asserts coverage against the producer rather than a\n * hand-copied list — the same shape as `default-modules.tsx`'s `KEYSPACE_KEYS`.\n */\nexport const PROJECT_CONFIG_ISSUE_KEYS = {\n  noCollections: 'customization.issue.noCollections',\n} as const\n\n/**\n * Report what the project has NOT declared but the studio cannot work without.\n *\n * Today that is exactly one thing: collections. A studio with none has no content\n * model at all — the CMS rail expands to nothing, every list is empty, and before\n * EC-479 the store quietly substituted the engine's sample schema so none of that\n * was visible. The remedy is one line in `elytra.config.ts`, which is why the\n * message names the file.\n *\n * Deliberately NOT reported here: an absent locale config. A `Project` only exists\n * for a config-declared project and `resolveWorkspaceConfig` gives every one of\n * them a `locales` array, so \"no locales\" is unreachable from the rail's vantage\n * point; the CMS session guards it directly instead (`CmsProvider`), where it is\n * both reachable and actionable. Reporting an unreachable state would be copy\n * nobody can trigger. Since EC-490 (owner-ratified 2026-08-01) that unreachability\n * is STRUCTURAL rather than incidental: a config declaring no `locales` is rejected\n * outright, so there is no resolved project behind which the question could hide.\n */\nexport function projectConfigIssues(\n  collections: readonly CollectionDef[],\n): CustomizationIssue[] {\n  if (collections.length > 0) return []\n  return [\n    {\n      code: 'missing-configuration',\n      severity: 'error',\n      message: `This project declares no content collections. Add them to \"${PROJECT_CONFIG_FILE}\" — the studio shows your schema or none, never sample content.`,\n      messageRef: {\n        key: PROJECT_CONFIG_ISSUE_KEYS.noCollections,\n        vars: { file: PROJECT_CONFIG_FILE },\n      },\n      point: PROJECT_CONFIG_POINT,\n    },\n  ]\n}\n"]}
+{"version":3,"file":"config-issues.js","sourceRoot":"","sources":["../../../src/lib/workspace/config-issues.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAG9D;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAA;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,aAAa,EAAE,mCAAmC;CAC1C,CAAA;AAEV;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAqC;IAErC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IACrC,OAAO;QACL;YACE,IAAI,EAAE,uBAAuB;YAC7B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,8DAA8D,mBAAmB,iEAAiE;YAC3J,UAAU,EAAE;gBACV,GAAG,EAAE,yBAAyB,CAAC,aAAa;gBAC5C,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;aACpC;YACD,KAAK,EAAE,oBAAoB;SAC5B;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { CollectionDef } from '@elytracms/core/cms-core'\nimport { WORKSPACE_CONFIG_FILE } from '@elytracms/core/config'\nimport type { CustomizationIssue } from '@elytracms/core/studio-core'\n\n/**\n * EC-479 — project-level configuration findings for the section-rail foot.\n *\n * The engine used to fill a missing declaration with its own `cms-core` fixtures:\n * `?? sampleFilterableCollections` in the CMS store, `?? sampleDocuments` beside\n * it, `?? sampleLocaleConfig` in the locale store. A studio whose config never\n * arrived therefore looked *configured* — it showed six documents about Ada\n * Lovelace under a four-collection schema, in `en/de`, none of which the project\n * had declared. The owner's ruling (2026-07-30): \"fixtures should only show in the\n * playground, but not be hard-wired in the engine\".\n *\n * With the fallbacks retired the same state renders as an empty CMS, which on its\n * own is the OTHER silent failure — the house rule bans both (\"if you are writing\n * a fallback that hides a broken state, that *is* the bug\"). This module is the\n * third option: say so, at the rail foot, where EC-467's reuse issues and EC-469's\n * URL-map issues already report project-level problems, on every studio surface.\n *\n * Pure and deterministic — no config-holder reads, no React. The caller supplies\n * the resolved config (`resolveDeploymentCollections()`), which is also what makes\n * this testable against a synthetic project instead of the live one.\n */\n\n/**\n * The extension-point name stamped on these issues. Not a customization registry\n * like `'sidebar'`/`'fieldRenderers'` — the finding is about the project's own\n * declarations, so it locates the config, not an override list.\n */\nexport const PROJECT_CONFIG_POINT = 'project'\n\n/**\n * The file a developer fixes these findings in — interpolated, never localized.\n * Exported for the rail foot's other config-remedy message (EC-606's orphaned\n * collections), so the file name is declared once.\n */\nexport const PROJECT_CONFIG_FILE = WORKSPACE_CONFIG_FILE\n\n/**\n * Catalog keys for the issues below (EC-478). Named here, next to the producer, so\n * the studio's i18n parity test asserts coverage against the producer rather than a\n * hand-copied list — the same shape as `default-modules.tsx`'s `KEYSPACE_KEYS`.\n */\nexport const PROJECT_CONFIG_ISSUE_KEYS = {\n  noCollections: 'customization.issue.noCollections',\n} as const\n\n/**\n * Report what the project has NOT declared but the studio cannot work without.\n *\n * Today that is exactly one thing: collections. A studio with none has no content\n * model at all — the CMS rail expands to nothing, every list is empty, and before\n * EC-479 the store quietly substituted the engine's sample schema so none of that\n * was visible. The remedy is one line in `elytra.config.ts`, which is why the\n * message names the file.\n *\n * Deliberately NOT reported here: an absent locale config. A `Project` only exists\n * for a config-declared project and `resolveWorkspaceConfig` gives every one of\n * them a `locales` array, so \"no locales\" is unreachable from the rail's vantage\n * point; the CMS session guards it directly instead (`CmsProvider`), where it is\n * both reachable and actionable. Reporting an unreachable state would be copy\n * nobody can trigger. Since EC-490 (owner-ratified 2026-08-01) that unreachability\n * is STRUCTURAL rather than incidental: a config declaring no `locales` is rejected\n * outright, so there is no resolved project behind which the question could hide.\n */\nexport function projectConfigIssues(\n  collections: readonly CollectionDef[],\n): CustomizationIssue[] {\n  if (collections.length > 0) return []\n  return [\n    {\n      code: 'missing-configuration',\n      severity: 'error',\n      message: `This project declares no content collections. Add them to \"${PROJECT_CONFIG_FILE}\" — the studio shows your schema or none, never sample content.`,\n      messageRef: {\n        key: PROJECT_CONFIG_ISSUE_KEYS.noCollections,\n        vars: { file: PROJECT_CONFIG_FILE },\n      },\n      point: PROJECT_CONFIG_POINT,\n    },\n  ]\n}\n"]}

package/dist/lib/workspace/index.d.ts

@@ -1,4 +1,4 @@
-import type { BreakpointConfig, ElytraConfigInput } from '@elytracms/core/studio-core';
+import type { BreakpointConfig, ElytraConfigInput, ResolvedProject } from '@elytracms/core/studio-core';
 import type { CollectionDef, LocaleConfig, RouteRecord } from '@elytracms/core/cms-core';
 import type { SidebarNode } from '../../components/app-views/module.js';
 import type { CustomFieldRenderer, StudioConfig } from '../../components/app-views/studio-config.js';
@@ -54,6 +54,13 @@ export declare function projectSlugFromPath(pathname: string): string | null;
  * Anywhere else (the launcher) → `null`, i.e. the default/first project.
  */
 export declare function activeSlugForLocation(pathname: string, redirect?: string): string | null;
+/**
+ * THE reader of "the config project with this slug" (EC-595 A2 → EC-582: one reader —
+ * the operations runtime resolves an OPERATION's project through it, whether or not it
+ * is the active one; the deployment lookup and the active project read it too).
+ * `undefined` for a slug no config project declares (env-only wiring, fixtures).
+ */
+export declare function configProjectFor(slug: string): ResolvedProject | undefined;
 /**
  * The studio's resolved workspace state. Deterministic per boot: the config is
  * static input (bundled file or deployment env), so it is resolved once and
@@ -163,6 +170,14 @@ export declare function resolveDeploymentReuse(): StudioConfig['reuse'];
  * declares none, or when the studio is wired by env alone with no config.
  */
 export declare function resolveDeploymentRoutes(): RouteRecord[];
+/**
+ * The active project's PAGE collections (EC-590; EC-565 Round 3, 3g): the collections at
+ * least one route addresses, in declaration order. "A page collection" is derived from the
+ * routes — the engine dictates no collection named `page`.
+ */
+export declare function resolveDeploymentPageCollections(): string[];
+/** The collections a route set addresses, deduplicated in declaration order (pure). */
+export declare function pageCollectionsOf(routes: readonly RouteRecord[]): string[];
 /**
  * The active config project's `LocaleConfig` (EC-357 finding #3). Locales are
  * structure and structure is code: when `elytra.config.ts` declares them, they
@@ -198,5 +213,20 @@ export declare function resolveDeploymentComponents(): readonly import("@elytrac
  * back to the project-level `frontendUrl`. No active-environment selector exists
  * yet, so the bound environment is the active one. `undefined` when the active
  * project (or env-only wiring) configures no frontend URL.
+ *
+ * EC-583: the rule is core's `projectFrontendUrl` — the delivery host advertises the
+ * same answer. In a DEV studio the URL the CLI handed over wins (Q15, see
+ * {@link studioDevFrontendUrl}).
  */
 export declare function resolveDeploymentFrontendUrl(): string | undefined;
+/**
+ * Q15 RATIFIED (EC-565 Round 5, 5b; EC-583): the dev frontend URL comes from the process
+ * that knows the port. `elytra dev` starts the frontend on `3000 + offset` and hands the
+ * studio dev server `ELYTRA_DEV_FRONTEND_URL`; the studio reads it through the mount env
+ * ({@link studioEnv}) — and **only in a dev runtime**, so a deployed studio never links to
+ * a localhost the launcher once named. `elytra.config.ts` keeps reading no env (EC-532).
+ *
+ * A value that is not an http(s) URL is not used, and says so once in the console
+ * rather than silently linking nowhere.
+ */
+export declare function studioDevFrontendUrl(): string | undefined;

package/dist/lib/workspace/index.js

@@ -1,5 +1,6 @@
-import { frontendUrlForEnvironment } from '@elytracms/core/studio-core';
-import { provideStudioEnv } from '../persistence/backend-mode.js';
+import { DEV_FRONTEND_URL_ENV } from '@elytracms/core/export-sync/deployment-ready';
+import { projectFrontendUrl, RESERVED_STUDIO_ROOT_SEGMENTS } from '@elytracms/core/studio-core';
+import { isDevRuntime, provideStudioEnv, studioEnv } from '../persistence/backend-mode.js';
 import { resolveWorkspaceState } from './workspace-source.js';
 export { PROJECT_CONFIG_FILE, PROJECT_CONFIG_ISSUE_KEYS, PROJECT_CONFIG_POINT, projectConfigIssues, } from './config-issues.js';
 export { resolveWorkspaceState } from './workspace-source.js';
@@ -46,11 +47,13 @@ export function setActiveProjectSlugForTests(slug) {
  * Reserved first-path segments that are NOT project slugs: the studio's own
  * root routes (EC-220). Project surfaces now live at `/<slug>/...` (no `/p/`
  * prefix), so the studio's root namespace is shared between project slugs and
- * these fixed routes — they must be excluded from slug extraction. Keep in
- * sync with the non-`$projectId` files in `src/routes/`; the launcher (`/`) is
- * the empty segment, excluded by the regex requiring one path char.
+ * these fixed routes — they must be excluded from slug extraction. The launcher
+ * (`/`) is the empty segment, excluded by the regex requiring one path char.
+ *
+ * EC-583 (RESIDUE-8): declared ONCE, in core — the resolver refuses a project slug in
+ * this set, so a config can no longer name a project this reader would skip.
  */
-const RESERVED_ROOT_SEGMENTS = new Set(['sign-in', 'styleguide']);
+const RESERVED_ROOT_SEGMENTS = new Set(RESERVED_STUDIO_ROOT_SEGMENTS);
 /** Extract a project slug from a studio path (`/<slug>/...`), else `null`. */
 export function projectSlugFromPath(pathname) {
     const match = /^\/([^/?#]+)/.exec(pathname);
@@ -74,17 +77,22 @@ export function activeSlugForLocation(pathname, redirect) {
         return projectSlugFromPath(redirect);
     return null;
 }
+/**
+ * THE reader of "the config project with this slug" (EC-595 A2 → EC-582: one reader —
+ * the operations runtime resolves an OPERATION's project through it, whether or not it
+ * is the active one; the deployment lookup and the active project read it too).
+ * `undefined` for a slug no config project declares (env-only wiring, fixtures).
+ */
+export function configProjectFor(slug) {
+    const state = getWorkspaceState();
+    return state.kind === 'config' ? state.projects.find((p) => p.slug === slug) : undefined;
+}
 /** The active config project (by slug), or the first configured project. */
 function activeConfigProject() {
     const state = getWorkspaceState();
     if (state.kind !== 'config')
         return undefined;
-    if (activeProjectSlug) {
-        const match = state.projects.find((p) => p.slug === activeProjectSlug);
-        if (match)
-            return match;
-    }
-    return state.projects[0];
+    return (activeProjectSlug ? configProjectFor(activeProjectSlug) : undefined) ?? state.projects[0];
 }
 /**
  * The studio's resolved workspace state. Deterministic per boot: the config is
@@ -117,9 +125,7 @@ export function resolveDeploymentUrl(fallbackUrl) {
 }
 /** The deployment URL for a specific project slug (per-backend auth checks). */
 export function deploymentUrlForSlug(slug, fallbackUrl) {
-    const state = getWorkspaceState();
-    const project = state.kind === 'config' ? state.projects.find((p) => p.slug === slug) : undefined;
-    return projectDeploymentUrl(project, fallbackUrl);
+    return projectDeploymentUrl(configProjectFor(slug), fallbackUrl);
 }
 /** A project's wired deployment: per-environment ref → project ref → env fallback. */
 function projectDeploymentUrl(project, fallbackUrl) {
@@ -239,6 +245,18 @@ export function resolveDeploymentReuse() {
 export function resolveDeploymentRoutes() {
     return activeConfigProject()?.routes ?? [];
 }
+/**
+ * The active project's PAGE collections (EC-590; EC-565 Round 3, 3g): the collections at
+ * least one route addresses, in declaration order. "A page collection" is derived from the
+ * routes — the engine dictates no collection named `page`.
+ */
+export function resolveDeploymentPageCollections() {
+    return pageCollectionsOf(resolveDeploymentRoutes());
+}
+/** The collections a route set addresses, deduplicated in declaration order (pure). */
+export function pageCollectionsOf(routes) {
+    return [...new Set(routes.flatMap((route) => (route.document ? [route.document.collection] : [])))];
+}
 // Redirects are editorial DATA now (EC-303), managed in the studio Redirects rail
 // and served dynamically — no longer resolved from config. `resolveDeploymentRedirects`
 // is retired; static/infra redirects are the dev's job via native next.config/vercel.
@@ -281,12 +299,41 @@ export function resolveDeploymentComponents() {
  * back to the project-level `frontendUrl`. No active-environment selector exists
  * yet, so the bound environment is the active one. `undefined` when the active
  * project (or env-only wiring) configures no frontend URL.
+ *
+ * EC-583: the rule is core's `projectFrontendUrl` — the delivery host advertises the
+ * same answer. In a DEV studio the URL the CLI handed over wins (Q15, see
+ * {@link studioDevFrontendUrl}).
  */
 export function resolveDeploymentFrontendUrl() {
     const project = activeConfigProject();
     if (!project)
         return undefined;
-    const boundEnv = project.environments.find((e) => e.convex?.deployment);
-    return frontendUrlForEnvironment(project, boundEnv?.key);
+    const devFrontendUrl = studioDevFrontendUrl();
+    return projectFrontendUrl(project, devFrontendUrl !== undefined ? { devFrontendUrl } : {});
+}
+let warnedInvalidDevFrontendUrl = false;
+/**
+ * Q15 RATIFIED (EC-565 Round 5, 5b; EC-583): the dev frontend URL comes from the process
+ * that knows the port. `elytra dev` starts the frontend on `3000 + offset` and hands the
+ * studio dev server `ELYTRA_DEV_FRONTEND_URL`; the studio reads it through the mount env
+ * ({@link studioEnv}) — and **only in a dev runtime**, so a deployed studio never links to
+ * a localhost the launcher once named. `elytra.config.ts` keeps reading no env (EC-532).
+ *
+ * A value that is not an http(s) URL is not used, and says so once in the console
+ * rather than silently linking nowhere.
+ */
+export function studioDevFrontendUrl() {
+    if (!isDevRuntime())
+        return undefined;
+    const raw = studioEnv()[DEV_FRONTEND_URL_ENV]?.trim();
+    if (raw === undefined || raw === '')
+        return undefined;
+    if (/^https?:\/\//.test(raw) && URL.canParse(raw))
+        return raw;
+    if (!warnedInvalidDevFrontendUrl) {
+        warnedInvalidDevFrontendUrl = true;
+        console.error(`[elytra] ${DEV_FRONTEND_URL_ENV} is not an http(s) URL, so live links use the config's frontendUrl instead.`);
+    }
+    return undefined;
 }
 //# sourceMappingURL=index.js.map