@wildo-ai/saas-technical-doc 1.1.3 → 1.1.5

package/dist/esm/companion/application-documentation/application-organization-unit-resource-documentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"application-organization-unit-resource-documentation.js","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/application-organization-unit-resource-documentation.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,gEAAgE,GAC3E,+DAAwE,CAAC;AAC3E,4GAA4G;AAC5G,MAAM,CAAC,MAAM,oEAAoE,GAAG,CAAC,CAAC;AAqBtF;;;;;;;;GAQG;AACH,MAAM,UAAU,uDAAuD,CACrE,yBAA4G,EAC5G,YAAoC;IAEpC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,6EAA6E,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5G,CAAC;QACD,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,yBAAyB,IAAI,EAAE,CAAC;SACjE,MAAM,CAAC,CAAC,KAAK,EAAyD,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;SAChG,GAAG,CAAC,CAAC,CAAC,kBAAkB,EAAE,WAAW,CAAC,EAAE,EAAE;QACzC,IAAI,WAAW,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,sDAAsD,kBAAkB,4CAA4C,CAAC,CAAC;QACxI,CAAC;QACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACrD,IAAI,GAAG,EAAE,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CACb,wEAAwE,kBAAkB,sCAAsC,CACjI,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,kBAAkB;YAClB,KAAK,EAAE,oBAAoB,CAAC,kBAAkB,CAAC;YAC/C,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;SAChC,CAAC,CAAC;IACL,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACxJ,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,2DAA2D,CACzE,SAAsE;IAEtE,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,kBAAkB,GAAG,CAAC,GAAG,SAAS,CAAC;SACtC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC;IACrJ,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,KAAK,CAAC;QAC9C,CAAC,CAAC,4MAA4M;QAC9M,CAAC,CAAC,sEAAsE,kBAAkB;aACvF,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;aAC9F,IAAI,CAAC,IAAI,CAAC,mJAAmJ,CAAC;IAEnK,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,gEAAgE;QAC3E,QAAQ;QACR,aAAa,EAAE,oEAAoE;KACpF,CAAC,CAAC;AACL,CAAC;AAED,kFAAkF;AAClF,SAAS,oBAAoB,CAAC,UAAkB;IAC9C,OAAO,UAAU;SACd,UAAU,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACzC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC;SACzB,IAAI,EAAE;SACN,KAAK,CAAC,MAAM,CAAC;SACb,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;SACnH,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAC7G,CAAC","sourcesContent":["import {\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\nimport type { ResourceTag } from '../operation-projection.schemas';\n\nexport const APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_REF =\n  'source:companion-projection:organization-unit-aware-resources' as const;\n/** Advances when this projection's shape changes; it is the fact's version wherever provenance cites it. */\nexport const APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_VERSION = 1;\n\n/** Exact Markdown fact composed into the organization-unit task pages. */\nexport interface ApplicationOrganizationUnitResourcesDocumentationFact {\n  readonly sourceRef: typeof APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_REF;\n  readonly markdown: string;\n  readonly sourceVersion: number;\n}\n\n/**\n * Consumer-safe view of one application resource that explicitly opts into\n * organization-unit narrowing. The internal field holding the unit identity is\n * deliberately absent: administrators need to know which business information\n * is narrowed, not how its persistence schema implements that decision.\n */\nexport interface ApplicationOrganizationUnitResourceDocumentation {\n  readonly resourceIdentifier: string;\n  readonly label: string;\n  readonly purpose: string;\n}\n\n/**\n * Project the exact startup declaration into a small consumer-safe fact list.\n *\n * The declaration is the only authority for inclusion. A unit-shaped URL, a\n * relationship to organization units, or a similarly named field is not\n * evidence that runtime authorization narrows the resource. Every included\n * resource must also have specification-owned purpose prose; publication fails\n * rather than exposing a raw identifier with no explanation.\n */\nexport function projectApplicationOrganizationUnitResourceDocumentation(\n  organizationUnitNarrowing: Readonly<Partial<Record<string, { readonly unitFieldName: string }>>> | undefined,\n  resourceTags: readonly ResourceTag[],\n): readonly ApplicationOrganizationUnitResourceDocumentation[] {\n  const tagsByIdentifier = new Map<string, ResourceTag>();\n  for (const tag of resourceTags) {\n    if (tagsByIdentifier.has(tag.name)) {\n      throw new Error(`application organization-unit resource projector: duplicate resource tag '${tag.name}'`);\n    }\n    tagsByIdentifier.set(tag.name, tag);\n  }\n\n  return Object.freeze(Object.entries(organizationUnitNarrowing ?? {})\n    .filter((entry): entry is [string, { readonly unitFieldName: string }] => entry[1] !== undefined)\n    .map(([resourceIdentifier, declaration]) => {\n      if (declaration.unitFieldName.trim().length === 0) {\n        throw new Error(`application organization-unit resource projector: '${resourceIdentifier}' has an empty narrowing field declaration`);\n      }\n      const tag = tagsByIdentifier.get(resourceIdentifier);\n      if (tag?.description === undefined || tag.description.trim().length === 0) {\n        throw new Error(\n          `application organization-unit resource projector: narrowed resource '${resourceIdentifier}' has no specification-owned purpose`,\n        );\n      }\n      return Object.freeze({\n        resourceIdentifier,\n        label: resourceDisplayLabel(resourceIdentifier),\n        purpose: tag.description.trim(),\n      });\n    })\n    .sort((left, right) => left.label.localeCompare(right.label, 'en-US') || left.resourceIdentifier.localeCompare(right.resourceIdentifier, 'en-US')));\n}\n\n/** Materialize the application-specific list inserted into unit-access guides. */\nexport function createApplicationOrganizationUnitResourcesDocumentationFact(\n  resources: readonly ApplicationOrganizationUnitResourceDocumentation[],\n): ApplicationOrganizationUnitResourcesDocumentationFact {\n  if (new Set(resources.map((resource) => resource.resourceIdentifier)).size !== resources.length) {\n    throw new Error('technical documentation received duplicate organization-unit-aware resources');\n  }\n  const canonicalResources = [...resources]\n    .sort((left, right) => left.label.localeCompare(right.label, 'en-US') || left.resourceIdentifier.localeCompare(right.resourceIdentifier, 'en-US'));\n  const markdown = canonicalResources.length === 0\n    ? '**This application does not currently declare any business resource as organization-unit-aware.** A unit assignment therefore grants no additional access until the application publishes such a resource.'\n    : `This application currently applies organization-unit access to:\\n\\n${canonicalResources\n      .map((resource) => `- **${markdownText(resource.label)}** — ${markdownText(resource.purpose)}`)\n      .join('\\n')}\\n\\nOnly the resources listed here use unit assignments. Other application information continues to follow its organization-wide operation rules.`;\n\n  return Object.freeze({\n    sourceRef: APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_REF,\n    markdown,\n    sourceVersion: APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_VERSION,\n  });\n}\n\n/** Match the native API-reference fallback without changing resource identity. */\nfunction resourceDisplayLabel(identifier: string): string {\n  return identifier\n    .replaceAll(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .replaceAll(/[-_]+/g, ' ')\n    .trim()\n    .split(/\\s+/u)\n    .filter(Boolean)\n    .map((word) => (/^[A-Z0-9]+$/u.test(word) ? word : `${word.charAt(0).toUpperCase()}${word.slice(1).toLowerCase()}`))\n    .join(' ');\n}\n\nfunction markdownText(value: string): string {\n  return value.replaceAll(/\\s+/g, ' ').trim().replaceAll('\\\\', '\\\\\\\\').replaceAll(/([`*_[\\]<>#|])/g, '\\\\$1');\n}\n"]}
+{"version":3,"file":"application-organization-unit-resource-documentation.js","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/application-organization-unit-resource-documentation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n} from '@wildo-ai/saas-specifications/technical-documentation';\n\nimport type { ResourceTag } from '../operation-projection.schemas';\n\nexport const APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_REF =\n  'source:companion-projection:organization-unit-aware-resources' as const;\n/** Advances when this projection's shape changes; it is the fact's version wherever provenance cites it. */\nexport const APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_VERSION = 1;\n\n/** Exact Markdown fact composed into the organization-unit task pages. */\nexport interface ApplicationOrganizationUnitResourcesDocumentationFact {\n  readonly sourceRef: typeof APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_REF;\n  readonly markdown: string;\n  readonly sourceVersion: number;\n}\n\n/**\n * Consumer-safe view of one application resource that explicitly opts into\n * organization-unit narrowing. The internal field holding the unit identity is\n * deliberately absent: administrators need to know which business information\n * is narrowed, not how its persistence schema implements that decision.\n */\nexport interface ApplicationOrganizationUnitResourceDocumentation {\n  readonly resourceIdentifier: string;\n  readonly label: string;\n  readonly purpose: string;\n}\n\n/**\n * Project the exact startup declaration into a small consumer-safe fact list.\n *\n * The declaration is the only authority for inclusion. A unit-shaped URL, a\n * relationship to organization units, or a similarly named field is not\n * evidence that runtime authorization narrows the resource. Every included\n * resource must also have specification-owned purpose prose; publication fails\n * rather than exposing a raw identifier with no explanation.\n */\nexport function projectApplicationOrganizationUnitResourceDocumentation(\n  organizationUnitNarrowing: Readonly<Partial<Record<string, { readonly unitFieldName: string }>>> | undefined,\n  resourceTags: readonly ResourceTag[],\n): readonly ApplicationOrganizationUnitResourceDocumentation[] {\n  const tagsByIdentifier = new Map<string, ResourceTag>();\n  for (const tag of resourceTags) {\n    if (tagsByIdentifier.has(tag.name)) {\n      throw new Error(`application organization-unit resource projector: duplicate resource tag '${tag.name}'`);\n    }\n    tagsByIdentifier.set(tag.name, tag);\n  }\n\n  return Object.freeze(Object.entries(organizationUnitNarrowing ?? {})\n    .filter((entry): entry is [string, { readonly unitFieldName: string }] => entry[1] !== undefined)\n    .map(([resourceIdentifier, declaration]) => {\n      if (declaration.unitFieldName.trim().length === 0) {\n        throw new Error(`application organization-unit resource projector: '${resourceIdentifier}' has an empty narrowing field declaration`);\n      }\n      const tag = tagsByIdentifier.get(resourceIdentifier);\n      if (tag?.description === undefined || tag.description.trim().length === 0) {\n        throw new Error(\n          `application organization-unit resource projector: narrowed resource '${resourceIdentifier}' has no specification-owned purpose`,\n        );\n      }\n      return Object.freeze({\n        resourceIdentifier,\n        label: resourceDisplayLabel(resourceIdentifier),\n        purpose: tag.description.trim(),\n      });\n    })\n    .sort((left, right) => left.label.localeCompare(right.label, 'en-US') || left.resourceIdentifier.localeCompare(right.resourceIdentifier, 'en-US')));\n}\n\n/** Materialize the application-specific list inserted into unit-access guides. */\nexport function createApplicationOrganizationUnitResourcesDocumentationFact(\n  resources: readonly ApplicationOrganizationUnitResourceDocumentation[],\n): ApplicationOrganizationUnitResourcesDocumentationFact {\n  if (new Set(resources.map((resource) => resource.resourceIdentifier)).size !== resources.length) {\n    throw new Error('technical documentation received duplicate organization-unit-aware resources');\n  }\n  const canonicalResources = [...resources]\n    .sort((left, right) => left.label.localeCompare(right.label, 'en-US') || left.resourceIdentifier.localeCompare(right.resourceIdentifier, 'en-US'));\n  const markdown = canonicalResources.length === 0\n    ? '**This application does not currently declare any business resource as organization-unit-aware.** A unit assignment therefore grants no additional access until the application publishes such a resource.'\n    : `This application currently applies organization-unit access to:\\n\\n${canonicalResources\n      .map((resource) => `- **${markdownText(resource.label)}** — ${markdownText(resource.purpose)}`)\n      .join('\\n')}\\n\\nOnly the resources listed here use unit assignments. Other application information continues to follow its organization-wide operation rules.`;\n\n  return Object.freeze({\n    sourceRef: APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_REF,\n    markdown,\n    sourceVersion: APPLICATION_ORGANIZATION_UNIT_RESOURCES_DOCUMENTATION_SOURCE_VERSION,\n  });\n}\n\n/** Match the native API-reference fallback without changing resource identity. */\n// Generated API-reference prose, as in `openapi-reference-model.ts`. The technical-doc lane has no\n// label tree and is not translated.\nfunction resourceDisplayLabel(identifier: string): string {\n  // invented-display-text: generated API-reference prose.\n  return identifier\n    .replaceAll(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .replaceAll(/[-_]+/g, ' ')\n    .trim()\n    .split(/\\s+/u)\n    .filter(Boolean)\n    .map((word) => (/^[A-Z0-9]+$/u.test(word) ? word : `${word.charAt(0).toUpperCase()}${word.slice(1).toLowerCase()}`))\n    .join(' ');\n}\n\nfunction markdownText(value: string): string {\n  return value.replaceAll(/\\s+/g, ' ').trim().replaceAll('\\\\', '\\\\\\\\').replaceAll(/([`*_[\\]<>#|])/g, '\\\\$1');\n}\n"]}

package/dist/esm/companion/application-documentation/docs-api-origin-substitution.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Replace the build-time API-origin token in generated documentation (#1203).
+ *
+ * Generation writes {@link DOCS_API_ORIGIN_TOKEN} wherever the application's primary origin belongs,
+ * so the committed artifacts are environment-INDEPENDENT. This is the other half: the image build
+ * knows which environment it is for, and puts that origin in.
+ *
+ * ## Why a build step and not a runtime read
+ *
+ * The docs site already receives `WILDO_DOCS_API_BASE_URL` through Docusaurus `customFields`, and an
+ * MDX component could read it. The static OpenAPI documents cannot — they are served as files and
+ * have no runtime — and they carry the `servers` an API client is configured from, which is one of
+ * the surfaces that shipped a developer's `localhost`. One substitution over the generated tree
+ * covers both, which is why the issue's option (1) was the only one that covered every surface.
+ *
+ * ## The absent case is NOT the token
+ *
+ * With no origin supplied, the text falls back to the same stand-in an application that publishes no
+ * base URL already gets. A published page must never show a raw token: that is strictly worse than
+ * the `localhost` this replaces, because a reader can at least recognise an origin as wrong.
+ */
+export declare function substituteDocsApiOrigin(text: string, apiBaseUrl: string | undefined): string;
+/**
+ * The origin as it belongs in documentation: no trailing slash, and no `/api/v1` suffix.
+ *
+ * `WILDO_DOCS_API_BASE_URL` is authored for the docs RUNTIME's auth client, which accepts either
+ * form — `docs-auth-client.ts` strips the API root itself for exactly that reason. Documentation
+ * interpolates the ORIGIN and appends its own paths, so a value carrying the API root would produce
+ * `…/api/v1/api/v1/scim/v2`.
+ */
+export declare function normalizeDocsApiOrigin(apiBaseUrl: string | undefined): string;
+/** Whether a rendered tree still carries the token — what a build step asserts before publishing. */
+export declare function containsUnsubstitutedDocsApiOrigin(text: string): boolean;
+//# sourceMappingURL=docs-api-origin-substitution.d.ts.map

package/dist/esm/companion/application-documentation/docs-api-origin-substitution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-api-origin-substitution.d.ts","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/docs-api-origin-substitution.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG5F;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7E;AAED,qGAAqG;AACrG,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/dist/esm/companion/application-documentation/docs-api-origin-substitution.js

@@ -0,0 +1,45 @@
+import { DOCS_API_ORIGIN_TOKEN, UNPUBLISHED_BASE_URL_STAND_IN } from './application-connection-documentation.js';
+/**
+ * Replace the build-time API-origin token in generated documentation (#1203).
+ *
+ * Generation writes {@link DOCS_API_ORIGIN_TOKEN} wherever the application's primary origin belongs,
+ * so the committed artifacts are environment-INDEPENDENT. This is the other half: the image build
+ * knows which environment it is for, and puts that origin in.
+ *
+ * ## Why a build step and not a runtime read
+ *
+ * The docs site already receives `WILDO_DOCS_API_BASE_URL` through Docusaurus `customFields`, and an
+ * MDX component could read it. The static OpenAPI documents cannot — they are served as files and
+ * have no runtime — and they carry the `servers` an API client is configured from, which is one of
+ * the surfaces that shipped a developer's `localhost`. One substitution over the generated tree
+ * covers both, which is why the issue's option (1) was the only one that covered every surface.
+ *
+ * ## The absent case is NOT the token
+ *
+ * With no origin supplied, the text falls back to the same stand-in an application that publishes no
+ * base URL already gets. A published page must never show a raw token: that is strictly worse than
+ * the `localhost` this replaces, because a reader can at least recognise an origin as wrong.
+ */
+export function substituteDocsApiOrigin(text, apiBaseUrl) {
+    const origin = normalizeDocsApiOrigin(apiBaseUrl);
+    return text.split(DOCS_API_ORIGIN_TOKEN).join(origin);
+}
+/**
+ * The origin as it belongs in documentation: no trailing slash, and no `/api/v1` suffix.
+ *
+ * `WILDO_DOCS_API_BASE_URL` is authored for the docs RUNTIME's auth client, which accepts either
+ * form — `docs-auth-client.ts` strips the API root itself for exactly that reason. Documentation
+ * interpolates the ORIGIN and appends its own paths, so a value carrying the API root would produce
+ * `…/api/v1/api/v1/scim/v2`.
+ */
+export function normalizeDocsApiOrigin(apiBaseUrl) {
+    const trimmed = (apiBaseUrl ?? '').trim();
+    if (trimmed.length === 0)
+        return UNPUBLISHED_BASE_URL_STAND_IN;
+    return trimmed.replace(/\/+$/, '').replace(/\/api\/v1$/, '');
+}
+/** Whether a rendered tree still carries the token — what a build step asserts before publishing. */
+export function containsUnsubstitutedDocsApiOrigin(text) {
+    return text.includes(DOCS_API_ORIGIN_TOKEN);
+}
+//# sourceMappingURL=docs-api-origin-substitution.js.map

package/dist/esm/companion/application-documentation/docs-api-origin-substitution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-api-origin-substitution.js","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/docs-api-origin-substitution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAE9G;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,UAA8B;IAClF,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAA8B;IACnE,MAAM,OAAO,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,6BAA6B,CAAC;IAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,kCAAkC,CAAC,IAAY;IAC7D,OAAO,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["import { DOCS_API_ORIGIN_TOKEN, UNPUBLISHED_BASE_URL_STAND_IN } from './application-connection-documentation';\n\n/**\n * Replace the build-time API-origin token in generated documentation (#1203).\n *\n * Generation writes {@link DOCS_API_ORIGIN_TOKEN} wherever the application's primary origin belongs,\n * so the committed artifacts are environment-INDEPENDENT. This is the other half: the image build\n * knows which environment it is for, and puts that origin in.\n *\n * ## Why a build step and not a runtime read\n *\n * The docs site already receives `WILDO_DOCS_API_BASE_URL` through Docusaurus `customFields`, and an\n * MDX component could read it. The static OpenAPI documents cannot — they are served as files and\n * have no runtime — and they carry the `servers` an API client is configured from, which is one of\n * the surfaces that shipped a developer's `localhost`. One substitution over the generated tree\n * covers both, which is why the issue's option (1) was the only one that covered every surface.\n *\n * ## The absent case is NOT the token\n *\n * With no origin supplied, the text falls back to the same stand-in an application that publishes no\n * base URL already gets. A published page must never show a raw token: that is strictly worse than\n * the `localhost` this replaces, because a reader can at least recognise an origin as wrong.\n */\nexport function substituteDocsApiOrigin(text: string, apiBaseUrl: string | undefined): string {\n  const origin = normalizeDocsApiOrigin(apiBaseUrl);\n  return text.split(DOCS_API_ORIGIN_TOKEN).join(origin);\n}\n\n/**\n * The origin as it belongs in documentation: no trailing slash, and no `/api/v1` suffix.\n *\n * `WILDO_DOCS_API_BASE_URL` is authored for the docs RUNTIME's auth client, which accepts either\n * form — `docs-auth-client.ts` strips the API root itself for exactly that reason. Documentation\n * interpolates the ORIGIN and appends its own paths, so a value carrying the API root would produce\n * `…/api/v1/api/v1/scim/v2`.\n */\nexport function normalizeDocsApiOrigin(apiBaseUrl: string | undefined): string {\n  const trimmed = (apiBaseUrl ?? '').trim();\n  if (trimmed.length === 0) return UNPUBLISHED_BASE_URL_STAND_IN;\n  return trimmed.replace(/\\/+$/, '').replace(/\\/api\\/v1$/, '');\n}\n\n/** Whether a rendered tree still carries the token — what a build step asserts before publishing. */\nexport function containsUnsubstitutedDocsApiOrigin(text: string): boolean {\n  return text.includes(DOCS_API_ORIGIN_TOKEN);\n}\n"]}

package/dist/esm/companion/application-documentation/technical-documentation-engine-content-bundle.d.ts

@@ -78,20 +78,34 @@ export declare const APPLICATION_DOMAIN_RESOURCE_PAGE_UNIT_REF_PREFIX = "technic
  * silent gap, because a kind nobody authors looks exactly like a kind nobody needed (#474). RUNBOOK
  * now has one. CHANGE does not, and the reason is structural rather than editorial:
  *
- * A CHANGE unit is a record of what changed in ONE application, so only that application could
- * author it — and an application-authored unit cannot be routed. `pathForUnit` admits engine-
- * namespaced slugs and the reserved `unit/manages/` namespace, and refuses everything else with
- * "has no consumer navigation category". Application material reaches the site only as an ENGINE
- * unit carrying application-projected facts, never as an application-authored page. So the engine
- * cannot write a changelog it has no knowledge of, and the party that could has no door.
+ * A CHANGE unit is a record of what changed in ONE application, so only that application can
+ * author it. Until #874 that party had no door: an application-authored unit could not be routed.
+ * It now can — a chapter the application's documentation plan declares, authored in its
+ * specifications package and routed under `guides/` (`application-documentation-chapters.ts`) —
+ * so a CHANGE page has a producer, and it is the application.
  *
- * The member is therefore kept rather than retired: what is missing is a route for
- * application-authored units, not the concept. When that route exists, this entry is removed in the
- * same change — and `technical-documentation-engine-content-bundle.test.ts` fails until it is,
- * because the partition below is asserted total over the enum.
+ * The entry STAYS in this map, because this map describes the ENGINE catalogue and the partition
+ * test below is total over it: the engine still authors no CHANGE unit, and must not — it has no
+ * knowledge of what any one application changed. The reason text is what moved, from "no door" to
+ * "the door belongs to the application".
  */
 export declare const ENGINE_CONTENT_UNIT_KINDS_WITHOUT_PRODUCER: Readonly<Partial<Record<TechnicalDocumentationUnitKind, string>>>;
 export declare const ENGINE_CONTENT_UNIT_DEFINITIONS: Readonly<Record<string, EngineContentUnitDefinition>>;
+/**
+ * The one Markdown-to-unit parser, shared by every tier that turns authored prose into a unit: the
+ * engine's own pages, and the chapters an application authors (#874). One parser means one rule for
+ * what a title, a summary and a section ARE — a second copy would let an application's guide and an
+ * engine page split the same text differently, and the difference would surface as a portal whose
+ * two halves summarize themselves by two conventions.
+ */
+export declare function parseTechnicalDocumentationUnitMarkdown(markdown: string, unitRef: string): {
+    readonly title: string;
+    readonly summary: string;
+    readonly sections: readonly {
+        readonly heading: string;
+        readonly bodyMarkdown: string;
+    }[];
+};
 /**
  * The facts only the application knows, which the companion measures and passes in.
  *

package/dist/esm/companion/application-documentation/technical-documentation-engine-content-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"technical-documentation-engine-content-bundle.d.ts","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/technical-documentation-engine-content-bundle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"technical-documentation-engine-content-bundle.d.ts","sourceRoot":"","sources":["../../../../../src/companion/application-documentation/technical-documentation-engine-content-bundle.ts"],"names":[],"mappings":"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"}

package/dist/esm/companion/application-documentation/technical-documentation-engine-content-bundle.js

@@ -174,21 +174,20 @@ const GENERATED_RESOURCE_UNIT_DEFINITION = Object.freeze({
  * silent gap, because a kind nobody authors looks exactly like a kind nobody needed (#474). RUNBOOK
  * now has one. CHANGE does not, and the reason is structural rather than editorial:
  *
- * A CHANGE unit is a record of what changed in ONE application, so only that application could
- * author it — and an application-authored unit cannot be routed. `pathForUnit` admits engine-
- * namespaced slugs and the reserved `unit/manages/` namespace, and refuses everything else with
- * "has no consumer navigation category". Application material reaches the site only as an ENGINE
- * unit carrying application-projected facts, never as an application-authored page. So the engine
- * cannot write a changelog it has no knowledge of, and the party that could has no door.
+ * A CHANGE unit is a record of what changed in ONE application, so only that application can
+ * author it. Until #874 that party had no door: an application-authored unit could not be routed.
+ * It now can — a chapter the application's documentation plan declares, authored in its
+ * specifications package and routed under `guides/` (`application-documentation-chapters.ts`) —
+ * so a CHANGE page has a producer, and it is the application.
  *
- * The member is therefore kept rather than retired: what is missing is a route for
- * application-authored units, not the concept. When that route exists, this entry is removed in the
- * same change — and `technical-documentation-engine-content-bundle.test.ts` fails until it is,
- * because the partition below is asserted total over the enum.
+ * The entry STAYS in this map, because this map describes the ENGINE catalogue and the partition
+ * test below is total over it: the engine still authors no CHANGE unit, and must not — it has no
+ * knowledge of what any one application changed. The reason text is what moved, from "no door" to
+ * "the door belongs to the application".
  */
 export const ENGINE_CONTENT_UNIT_KINDS_WITHOUT_PRODUCER = {
-    [TechnicalDocumentationUnitKind.CHANGE]: 'A change record belongs to one application, and an application-authored unit has no route — `pathForUnit` '
-        + 'admits only engine-namespaced slugs and the reserved `unit/manages/` namespace. Blocked on routing, not on authoring.',
+    [TechnicalDocumentationUnitKind.CHANGE]: 'A change record belongs to one application, so the engine cannot author it. Its producer is the application: '
+        + 'a CHANGE chapter in the documentation plan, authored in the specifications package and routed under `guides/` (#874).',
 };
 export const ENGINE_CONTENT_UNIT_DEFINITIONS = Object.freeze({
     'technical-documentation:unit/application-orientation': {
@@ -1568,6 +1567,16 @@ export const ENGINE_CONTENT_UNIT_DEFINITIONS = Object.freeze({
         ],
     },
 });
+/**
+ * The one Markdown-to-unit parser, shared by every tier that turns authored prose into a unit: the
+ * engine's own pages, and the chapters an application authors (#874). One parser means one rule for
+ * what a title, a summary and a section ARE — a second copy would let an application's guide and an
+ * engine page split the same text differently, and the difference would surface as a portal whose
+ * two halves summarize themselves by two conventions.
+ */
+export function parseTechnicalDocumentationUnitMarkdown(markdown, unitRef) {
+    return parseEngineMarkdown(markdown, unitRef);
+}
 function parseEngineMarkdown(markdown, unitRef) {
     const lines = markdown.trim().split('\n');
     const titleLine = lines.shift();
@@ -1948,9 +1957,10 @@ export function projectEngineApplicationConsumerContentBundle(bundle, engineSpec
      *
      * So these units are projected whole, from the same domain fact the overview page uses. They are
      * still ENGINE units, and deliberately: the engine owns the page's shape, its sections and its
-     * words, while the application supplies only the subject. That is what keeps `pathForUnit`'s
-     * refusal of application-owned units intact — nothing here asks it to route a unit an
-     * application named.
+     * words, while the application supplies only the subject. The pages whose WORDS an application
+     * owns are its authored chapters, which enter through their own reserved namespace
+     * (`application-documentation-chapters.ts`, #874) — not through here — so `pathForUnit` still
+     * refuses any unit whose ref an application chose freely.
      */
     const generatedResourceUnits = (applicationFacts.domain?.resourcePages ?? []).map((page) => {
         const unitRef = applicationDomainResourcePageUnitRef(page.resourceIdentifier);