@cat-factory/kernel 0.323.2 → 0.325.0

package/dist/domain/environment-readiness.logic.d.ts

@@ -37,6 +37,13 @@ export interface EnvironmentReadinessInput {
     status: EnvironmentStatus;
     /** The provider's own last error, when it recorded one; used verbatim in a `failed` verdict. */
     lastError?: string | null;
+    /**
+     * The provider's own account of a state it has not left yet, when it gave one. It is the only
+     * channel that survives a `provisioning` poll, because `lastError` is persisted on `failed`
+     * alone (see `ProvisionedEnvironment.statusNote`). It is what lets a `timed_out` verdict name
+     * the state the environment was stuck in rather than only how long it was stuck.
+     */
+    statusNote?: string | null;
 }
 /**
  * Human-readable elapsed time for a readiness verdict's message, in the coarsest unit that
@@ -44,6 +51,21 @@ export interface EnvironmentReadinessInput {
  * operator is quoted a duration rather than a millisecond count.
  */
 export declare function describeWaitedFor(ms: number): string;
+/**
+ * How an environment that has stopped at a status it will never leave for `ready` is explained to
+ * a person: `failed` / `expired` / `tearing_down` / `torn_down`. Shared, because every reader that
+ * has to give up on such an environment owes the same account, and the two that stated it
+ * separately disagreed about it.
+ *
+ * The provider's own error is the whole message where it recorded one, because on these statuses
+ * that error IS the verdict. With none, the state is NAMED and the last note is APPENDED rather
+ * than substituted, and both halves of that matter. Naming the state is what separates "the
+ * provider refused it" from "something tore it down under the run", which send an operator to
+ * different places. Appending rather than substituting is because a bare note reads as the reason
+ * the environment ended up here, which nothing here knows: a `torn_down` row's note describes the
+ * spin-up it was in the middle of, not who tore it down.
+ */
+export declare function describeTerminalEnvironment(env: EnvironmentReadinessInput): string;
 /**
  * Judge one readiness poll: the environment as the provider just reported it, against how long
  * the step has been waiting.

package/dist/domain/environment-readiness.logic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment-readiness.logic.d.ts","sourceRoot":"","sources":["../../src/domain/environment-readiness.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAkBnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,QAAiB,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,CAAA;IACzB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,yBAAyB,EAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAqC,GAC/C,oBAAoB,CAwBtB"}
+{"version":3,"file":"environment-readiness.logic.d.ts","sourceRoot":"","sources":["../../src/domain/environment-readiness.logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAkBnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,QAAiB,CAAA;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,CAAA;IACzB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,yBAAyB,GAAG,MAAM,CAQlF;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,yBAAyB,EAC9B,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,MAAqC,GAC/C,oBAAoB,CA0BtB"}

package/dist/domain/environment-readiness.logic.js

@@ -41,6 +41,28 @@ export function describeWaitedFor(ms) {
     const seconds = Math.max(1, Math.round(ms / 1000));
     return `${seconds} second${seconds === 1 ? '' : 's'}`;
 }
+/**
+ * How an environment that has stopped at a status it will never leave for `ready` is explained to
+ * a person: `failed` / `expired` / `tearing_down` / `torn_down`. Shared, because every reader that
+ * has to give up on such an environment owes the same account, and the two that stated it
+ * separately disagreed about it.
+ *
+ * The provider's own error is the whole message where it recorded one, because on these statuses
+ * that error IS the verdict. With none, the state is NAMED and the last note is APPENDED rather
+ * than substituted, and both halves of that matter. Naming the state is what separates "the
+ * provider refused it" from "something tore it down under the run", which send an operator to
+ * different places. Appending rather than substituting is because a bare note reads as the reason
+ * the environment ended up here, which nothing here knows: a `torn_down` row's note describes the
+ * spin-up it was in the middle of, not who tore it down.
+ */
+export function describeTerminalEnvironment(env) {
+    const failure = env.lastError?.trim();
+    if (failure)
+        return failure;
+    const note = env.statusNote?.trim();
+    return (`Environment provisioning did not complete (status: ${env.status}).` +
+        (note ? ` Last provider note: ${note}` : ''));
+}
 /**
  * Judge one readiness poll: the environment as the provider just reported it, against how long
  * the step has been waiting.
@@ -54,23 +76,26 @@ export function describeWaitedFor(ms) {
 export function judgeEnvironmentReadiness(env, waitedMs, timeoutMs = ENVIRONMENT_READY_TIMEOUT_MS) {
     if (env.status === 'ready')
         return { kind: 'ready' };
+    const failure = env.lastError?.trim();
+    const note = env.statusNote?.trim();
+    // `failed` / `expired` / `tearing_down` / `torn_down`: none of these becomes `ready` on its own,
+    // so waiting out the deadline would only delay the same answer.
     if (env.status !== 'provisioning') {
-        // `failed` / `expired` / `tearing_down` / `torn_down`: none of these becomes `ready` on its
-        // own, so waiting out the deadline would only delay the same answer. Name the state, because
-        // "the provider refused it" and "something tore it down under the run" send an operator to
-        // different places.
-        return {
-            kind: 'failed',
-            error: env.lastError?.trim() ||
-                `Environment provisioning did not complete (status: ${env.status}).`,
-        };
+        return { kind: 'failed', error: describeTerminalEnvironment(env) };
     }
     if (waitedMs >= timeoutMs) {
         return {
             kind: 'timed_out',
             error: `Environment was still provisioning after ${describeWaitedFor(waitedMs)}` +
                 ` (readiness ceiling ${describeWaitedFor(timeoutMs)}).` +
-                (env.lastError?.trim() ? ` Last provider error: ${env.lastError.trim()}` : ''),
+                // BOTH, where a caller carries both, each under its own label and the fault FIRST. A
+                // recorded fault outranks a note on every reader (it is the more specific claim, and the
+                // only one of the two that is a fault), and dropping either would be the misattribution
+                // this pair exists to avoid: the note is the one channel a `provisioning` provider had,
+                // since that is exactly the status `lastError` is nulled on, so a caller reaching here
+                // with a fault as well carries it from an earlier poll and it is not superseded.
+                (failure ? ` Last provider error: ${failure}` : '') +
+                (note ? ` Last provider note: ${note}` : ''),
         };
     }
     return { kind: 'waiting', elapsedMs: waitedMs };

package/dist/domain/environment-readiness.logic.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment-readiness.logic.js","sourceRoot":"","sources":["../../src/domain/environment-readiness.logic.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,2FAA2F;AAC3F,8EAA8E;AAC9E,EAAE;AACF,8FAA8F;AAC9F,6FAA6F;AAC7F,gGAAgG;AAChG,8FAA8F;AAC9F,+FAA+F;AAC/F,6BAA6B;AAC7B,EAAE;AACF,4FAA4F;AAC5F,+FAA+F;AAC/F,6DAA6D;AAC7D,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAqB1D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,CAAA;QACvC,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAClD,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;AACvD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAA8B,EAC9B,QAAgB,EAChB,SAAS,GAAW,4BAA4B;IAEhD,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACpD,IAAI,GAAG,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QAClC,4FAA4F;QAC5F,6FAA6F;QAC7F,2FAA2F;QAC3F,oBAAoB;QACpB,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EACH,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE;gBACrB,sDAAsD,GAAG,CAAC,MAAM,IAAI;SACvE,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,KAAK,EACH,4CAA4C,iBAAiB,CAAC,QAAQ,CAAC,EAAE;gBACzE,uBAAuB,iBAAiB,CAAC,SAAS,CAAC,IAAI;gBACvD,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,yBAAyB,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjF,CAAA;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AACjD,CAAC"}
+{"version":3,"file":"environment-readiness.logic.js","sourceRoot":"","sources":["../../src/domain/environment-readiness.logic.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,2FAA2F;AAC3F,8EAA8E;AAC9E,EAAE;AACF,8FAA8F;AAC9F,6FAA6F;AAC7F,gGAAgG;AAChG,8FAA8F;AAC9F,+FAA+F;AAC/F,6BAA6B;AAC7B,EAAE;AACF,4FAA4F;AAC5F,+FAA+F;AAC/F,6DAA6D;AAC7D,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AA4B1D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,CAAA;QACvC,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAClD,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;AACvD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAC,GAA8B;IACxE,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAA;IACrC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAA;IAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAA;IACnC,OAAO,CACL,sDAAsD,GAAG,CAAC,MAAM,IAAI;QACpE,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC7C,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAA8B,EAC9B,QAAgB,EAChB,SAAS,GAAW,4BAA4B;IAEhD,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IACpD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,CAAA;IACrC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAA;IACnC,iGAAiG;IACjG,gEAAgE;IAChE,IAAI,GAAG,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAA;IACpE,CAAC;IACD,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,KAAK,EACH,4CAA4C,iBAAiB,CAAC,QAAQ,CAAC,EAAE;gBACzE,uBAAuB,iBAAiB,CAAC,SAAS,CAAC,IAAI;gBACvD,qFAAqF;gBACrF,yFAAyF;gBACzF,wFAAwF;gBACxF,wFAAwF;gBACxF,uFAAuF;gBACvF,iFAAiF;gBACjF,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAA;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAA;AACjD,CAAC"}

package/dist/domain/foundational-services.d.ts

@@ -16,6 +16,29 @@ export declare const MAX_CATALOG_OPERATIONS = 40;
  * API that happens to stop at `/f`.
  */
 export declare const MAX_CONTRACT_BODY_CHARS = 120000;
+/**
+ * How many characters the rendered CATALOG (or estate) block may run to.
+ *
+ * A total, where {@link MAX_CATALOG_OPERATIONS} is a per-contract cap, because the two bound
+ * different growth. The per-contract cap keeps one verbose spec from dominating; this one keeps
+ * the block proportional to nothing at all, which is what an imported estate demands: a portal
+ * import admits up to a thousand services, each carrying a description as long as the stored
+ * field allows, so an organisation's size would otherwise decide how much of every dispatch's
+ * context the catalog eats.
+ *
+ * What is dropped is STATED as a prefix (see {@link renderFoundationalCatalog}), because a
+ * silently shortened catalog reads as an organisation that runs fewer services than it does.
+ */
+export declare const MAX_CATALOG_RENDER_CHARS = 40000;
+/**
+ * How much of ONE service's description rides the rendered block.
+ *
+ * Its own cap beside the total, so a single service with a 20,000-character description cannot
+ * consume the whole budget and push every service after it out of the list. The description is
+ * the field an author writes for this purpose, so it keeps a generous share; the truncation is
+ * stated on the line itself.
+ */
+export declare const MAX_CATALOG_DESCRIPTION_CHARS = 1500;
 /** The `.cat-context/` directory the resolved contract documents are injected under. */
 export declare const FOUNDATIONAL_CONTEXT_DIR = "foundational-services";
 /** The index file listing what was injected (and what was asked for but could not be). */
@@ -28,6 +51,18 @@ export declare const FOUNDATIONAL_INDEX_FILE = "foundational-services/index.md";
  * to agree on a rendering.
  */
 export declare const FOUNDATIONAL_CATALOG_FILE = "foundational-services/catalog.md";
+/**
+ * The file an ORIENTATION-time kind reads: a triage or investigation agent that has to work out
+ * WHICH of the organisation's services a piece of work belongs to.
+ *
+ * A separate path from {@link FOUNDATIONAL_CATALOG_FILE} carrying a separate rendering of the
+ * same rows, because the two readers need opposite framings of them. The catalog file tells a
+ * designer "prefer consuming one of these over building your own", which is the wrong sentence
+ * to put in front of an agent whose job is to locate a fault: it invites a triage report that
+ * recommends adopting a shared service. The estate file states ownership and interface surface
+ * and asks for neither a preference nor a declaration.
+ */
+export declare const FOUNDATIONAL_ESTATE_FILE = "foundational-services/estate.md";
 /**
  * The fenced block the Architect writes its declaration in. Parsed back by
  * {@link parseFoundationalDeclaration}; named in the trait guidance so the two cannot drift.
@@ -51,10 +86,10 @@ export declare function detectContractFormat(path: string, content: string): Api
  * contract. This keeps a scan's file reads proportional to the CANDIDATES rather than to the
  * folder's size.
  *
- * The extension half is derived from the same two lists `detectContractFormat` branches on, so
- * the two cannot drift. The basename half ({@link NON_CONTRACT_BASENAMES}) is definitional
- * rather than derived: a candidate may still be rejected on its content, and a non-candidate is
- * never a contract we serve.
+ * The extension half is derived from the same lists `detectContractFormat` branches on, so the
+ * two cannot drift. The basename half ({@link NON_CONTRACT_BASENAMES}) is definitional rather
+ * than derived: a candidate may still be rejected on its content, and a non-candidate is never a
+ * contract we serve.
  */
 export declare function isContractCandidatePath(path: string): boolean;
 /**
@@ -69,6 +104,53 @@ export declare function isContractCandidatePath(path: string): boolean;
 export declare function isContractModulePath(path: string): boolean;
 /** Whether `content` parses as an OpenAPI **3.x** document (JSON or YAML). */
 export declare function isOpenApiDocument(content: string): boolean;
+/** Whether `content` parses as an AsyncAPI **2.x/3.x** document (JSON or YAML). */
+export declare function isAsyncApiDocument(content: string): boolean;
+/**
+ * Whether `content` is a GraphQL SDL **schema** rather than an operation document.
+ *
+ * The distinction is the whole reason this exists. A `.graphql` / `.gql` file in a repository is
+ * far more often a client's `query`/`mutation`/`fragment` text than the schema a service
+ * publishes, and a scan that registered one would tell an Architect the service exposes a surface
+ * it does not. What separates the two is a TYPE-SYSTEM definition, which an operation document by
+ * construction never carries.
+ *
+ * Recognition rather than validation, deliberately: the platform indexes no GraphQL operations
+ * ({@link operationsAreIndexable}), so the verdict this needs to reach is only "is this file the
+ * service's published interface", and a real parser would buy nothing for the extra dependency.
+ */
+export declare function isGraphqlSchemaDocument(content: string): boolean;
+/**
+ * Whether `content` declares a gRPC **service** rather than only message shapes.
+ *
+ * A `.proto` file is routinely vendored, generated, or purely structural (shared `message`
+ * definitions with no RPCs at all), and none of those is an interface the owning service
+ * publishes. What makes a protobuf file a gRPC contract is a `service` block, so that is what is
+ * required rather than the extension alone.
+ */
+export declare function isGrpcServiceDocument(content: string): boolean;
+/**
+ * The operations an AsyncAPI document declares, as `PUBLISH orders/created` strings, capped at
+ * {@link MAX_CATALOG_OPERATIONS}.
+ *
+ * Both major versions are read, because an org's portal will hold documents of each and the two
+ * state the same fact in different places:
+ *
+ * - **2.x** puts the verb under the channel (`channels['orders/created'].subscribe`), so the
+ *   operation is the channel name plus which side of it the document declares.
+ * - **3.x** hoists them into a top-level `operations` map whose entries carry an `action`
+ *   (`send`/`receive`) and a `$ref` to the channel, so the operation is the action plus the
+ *   channel the ref names, falling back to the operation's own key when the ref is not a local
+ *   `#/channels/<name>` pointer. That fallback is the honest half: following an external ref
+ *   would need a fetch this parser will not make, and the key is the document's own name for
+ *   the operation rather than an invented one.
+ *
+ * A document whose version is neither indexes to nothing rather than being guessed at.
+ */
+export declare function indexAsyncApiOperations(content: string): {
+    operations: string[];
+    omitted: number;
+};
 /**
  * The operations an OpenAPI document declares, as `GET /files/{id}` strings, capped at
  * {@link MAX_CATALOG_OPERATIONS}. Returns `omitted` so the caller can STATE that the list is
@@ -121,6 +203,9 @@ export type FoundationalDefinitionProblem = {
 } | {
     reason: 'invalid_openapi_document';
     contractId: string;
+} | {
+    reason: 'invalid_asyncapi_document';
+    contractId: string;
 } | {
     reason: 'contract_library_not_referenced';
     format: ApiContractFormat;
@@ -239,6 +324,24 @@ export type FoundationalCatalogRead = {
  * by building the capability itself, and an outage is not that fact.
  */
 export declare function renderFoundationalCatalog(read: FoundationalCatalogRead): string;
+/**
+ * Render the ESTATE block an orientation-time kind reads: which services the organisation runs,
+ * who owns each, and what interface each publishes.
+ *
+ * The same rows as {@link renderFoundationalCatalog} and a different document, because the reader
+ * is doing a different job. A triage agent is not choosing a shared capability to build against;
+ * it is trying to work out which service a report belongs to and who to route it to, and the
+ * design framing ("prefer consuming one of these") would push it towards recommending an
+ * adoption instead of naming a fault. So this states ownership first, asks for no declaration,
+ * and says plainly what it does NOT carry: the full interface documents, which stay behind a
+ * design's declaration because folding every one of them into every dispatch is the cost the
+ * catalog/contracts split exists to avoid.
+ *
+ * The three-state input is the same one the catalog renderer takes, and for the same reason: an
+ * estate that could not be READ must not render as an organisation that runs nothing, which is
+ * exactly the substitution that would have a triage agent conclude a service does not exist.
+ */
+export declare function renderServiceEstate(read: FoundationalCatalogRead): string;
 /** One contract document as the lazy read hands it downstream. */
 export interface FoundationalContractBundle {
     id: string;

package/dist/domain/foundational-services.d.ts.map

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