@cat-factory/contracts 0.209.0 → 0.210.1

package/dist/foundational-services.d.ts

@@ -2,17 +2,77 @@ import * as v from 'valibot';
 /** Which scope owns a foundational service / source: an account, or a workspace. */
 export declare const foundationalServiceOwnerKindSchema: v.PicklistSchema<["account", "workspace"], undefined>;
 export type FoundationalServiceOwnerKind = v.InferOutput<typeof foundationalServiceOwnerKindSchema>;
-/** The tier a resolved catalog entry originated from, lowest-precedence first. */
-export declare const foundationalServiceTierSchema: v.PicklistSchema<["account", "workspace"], undefined>;
+/**
+ * The tier a resolved catalog entry originated from, lowest-precedence first.
+ *
+ * `builtin` is the DEPLOYMENT's own tier: services a deployment registers in code on the
+ * app-owned `FoundationalServiceRegistry`, exactly as it registers pipelines or task types.
+ * It carries no rows, so it is present from a workspace's first request and cannot drift from
+ * the definitions; an account or workspace row of the same id still wins over it, and a
+ * tombstone at either tier suppresses it.
+ */
+export declare const foundationalServiceTierSchema: v.PicklistSchema<["builtin", "account", "workspace"], undefined>;
 export type FoundationalServiceTier = v.InferOutput<typeof foundationalServiceTierSchema>;
 /**
- * The API-contract document formats the catalog accepts. Each is stored verbatim as text;
- * only OpenAPI is additionally PARSED (into an operation index the lazy read renders as a
- * compact summary) because the other two are TypeScript modules, which cannot be evaluated
- * in a Worker isolate and are handed to the agent as source.
+ * The API-contract document formats the catalog accepts. Each is stored verbatim as text and
+ * additionally INDEXED into operation names where the format allows it — see
+ * {@link operationsAreIndexable}, which is the one place that judgement lives.
  */
 export declare const apiContractFormatSchema: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
 export type ApiContractFormat = v.InferOutput<typeof apiContractFormatSchema>;
+/**
+ * Whether an operation index can be derived from a document of this format at all.
+ *
+ * This is what keeps "this interface declares no operations" apart from "this platform does not
+ * read this format": both render as an empty `operations` list, they need opposite reactions
+ * from whoever reads the catalog, and collapsing them tells an Architect that a fully-specified
+ * service offers nothing. Every surface that renders an operation list branches on it — the
+ * agent-facing catalog and the SPA's manifest row alike — so the two cannot disagree.
+ *
+ * `lokalise-api-contract` is false because its route builders' shapes are not pinned down here
+ * and a partial guess at them would be reported as fact. Adding an extractor for it means
+ * flipping this and nothing else.
+ */
+export declare function operationsAreIndexable(format: ApiContractFormat): boolean;
+/**
+ * The capability tag a foundational service must carry to be selectable as a binary-output
+ * step's STORAGE target (enforced at run admission — see `docs/initiatives/
+ * binary-output-foundational-storage.md`).
+ *
+ * It lives here, on the wire, rather than in the kernel alone because the people who need to
+ * spell it right are OUTSIDE the backend: a deployment registering its estate, and the SPA
+ * rendering the picker. A client that cannot import the vocabulary re-declares it, and the
+ * failure of a re-declaration is silent — `asset_storage` registers cleanly and surfaces much
+ * later as a refused run.
+ */
+export declare const ASSET_STORAGE_CAPABILITY = "asset-storage";
+/**
+ * The CONVENTIONAL tag for a service that can scope a generation — an inventory answering
+ * "what entities exist, which lack an asset, how is each described". Deliberately NOT enforced
+ * (any service with a readable contract can inform scope), but still reserved: a picker orders
+ * by it, so a typo silently loses the ordering rather than failing.
+ */
+export declare const GENERATION_CONTEXT_CAPABILITY = "generation-context";
+/**
+ * Capability tags the PLATFORM assigns meaning to. Everything else is free-form org taxonomy
+ * and stays that way — this list is not a closed vocabulary, it is the set of spellings a
+ * registrant must not miss by a character.
+ */
+export declare const RESERVED_CAPABILITY_TAGS: readonly string[];
+/**
+ * The reserved tag `tag` was plainly TRYING to be, when it is not that tag exactly — else null.
+ *
+ * Capability tags are free-form strings, which is right (an org's taxonomy is its own) and is
+ * also why `asset_storage` / `Asset-Storage` / `assetstorage` register without complaint and
+ * fail a run hours later as `not_storage_capable`. Comparing on a form with separators and case
+ * removed catches exactly the near-misses and nothing else: a genuinely different tag does not
+ * collide with a reserved one under it.
+ *
+ * The caller REFUSES on a hit rather than silently canonicalising, because a registrant who
+ * meant a tag of their own under a colliding spelling must learn that the platform reads it as
+ * reserved, and a quiet rewrite of someone's taxonomy is its own surprise.
+ */
+export declare function reservedCapabilityNearMiss(tag: string): string | null;
 /**
  * A contract as the CATALOG lists it — identity, format and SIZE, never the body. This is
  * what the Architect's catalog carries: enough to decide whether a service is relevant and
@@ -28,14 +88,19 @@ export declare const apiContractSummarySchema: v.ObjectSchema<{
     /** Repo provenance (`path`), or null when uploaded directly. */
     readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     /**
-     * The operations an OpenAPI document declares (`GET /files/{id}` …), capped. Empty for the
-     * TypeScript formats, which are not parsed. Cheap enough to ride the catalog and it is what
-     * makes the catalog actionable — an architect can name the endpoint it intends to call.
+     * The operations this document declares (`GET /files/{id}` …), capped. Cheap enough to ride
+     * the catalog and it is what makes the catalog actionable — an architect can name the
+     * endpoint it intends to call.
+     *
+     * EMPTY means one of two different things and {@link operationsAreIndexable} is what tells
+     * them apart: this format is not read at all, or it is and this document declares nothing.
      */
     readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
     /**
-     * How many operations were dropped from {@link operations} by the cap. Non-zero says the
-     * list is a PREFIX, so a reader never concludes the tail does not exist.
+     * How many operations the document declares that {@link operations} does NOT list — dropped
+     * by the cap, or (for a contract MODULE) declared in a shape the static extractor could not
+     * read. Non-zero says the list is incomplete, so a reader never concludes the rest does not
+     * exist.
      */
     readonly omittedOperations: v.NumberSchema<undefined>;
 }, undefined>;
@@ -50,14 +115,19 @@ export declare const apiContractDocumentSchema: v.ObjectSchema<{
     /** Repo provenance (`path`), or null when uploaded directly. */
     readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
     /**
-     * The operations an OpenAPI document declares (`GET /files/{id}` …), capped. Empty for the
-     * TypeScript formats, which are not parsed. Cheap enough to ride the catalog and it is what
-     * makes the catalog actionable — an architect can name the endpoint it intends to call.
+     * The operations this document declares (`GET /files/{id}` …), capped. Cheap enough to ride
+     * the catalog and it is what makes the catalog actionable — an architect can name the
+     * endpoint it intends to call.
+     *
+     * EMPTY means one of two different things and {@link operationsAreIndexable} is what tells
+     * them apart: this format is not read at all, or it is and this document declares nothing.
      */
     readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
     /**
-     * How many operations were dropped from {@link operations} by the cap. Non-zero says the
-     * list is a PREFIX, so a reader never concludes the tail does not exist.
+     * How many operations the document declares that {@link operations} does NOT list — dropped
+     * by the cap, or (for a contract MODULE) declared in a shape the static extractor could not
+     * read. Non-zero says the list is incomplete, so a reader never concludes the rest does not
+     * exist.
      */
     readonly omittedOperations: v.NumberSchema<undefined>;
     /** The document verbatim (OpenAPI JSON/YAML, or the contract module's TypeScript source). */
@@ -86,14 +156,19 @@ export declare const foundationalServiceSchema: v.ObjectSchema<{
         /** Repo provenance (`path`), or null when uploaded directly. */
         readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         /**
-         * The operations an OpenAPI document declares (`GET /files/{id}` …), capped. Empty for the
-         * TypeScript formats, which are not parsed. Cheap enough to ride the catalog and it is what
-         * makes the catalog actionable — an architect can name the endpoint it intends to call.
+         * The operations this document declares (`GET /files/{id}` …), capped. Cheap enough to ride
+         * the catalog and it is what makes the catalog actionable — an architect can name the
+         * endpoint it intends to call.
+         *
+         * EMPTY means one of two different things and {@link operationsAreIndexable} is what tells
+         * them apart: this format is not read at all, or it is and this document declares nothing.
          */
         readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
         /**
-         * How many operations were dropped from {@link operations} by the cap. Non-zero says the
-         * list is a PREFIX, so a reader never concludes the tail does not exist.
+         * How many operations the document declares that {@link operations} does NOT list — dropped
+         * by the cap, or (for a contract MODULE) declared in a shape the static extractor could not
+         * read. Non-zero says the list is incomplete, so a reader never concludes the rest does not
+         * exist.
          */
         readonly omittedOperations: v.NumberSchema<undefined>;
     }, undefined>, undefined>;
@@ -106,19 +181,21 @@ export declare const foundationalServiceSchema: v.ObjectSchema<{
     readonly updatedAt: v.NumberSchema<undefined>;
 }, undefined>;
 export type FoundationalService = v.InferOutput<typeof foundationalServiceSchema>;
-/** A resolved (account ⊕ workspace merged) catalog entry, carrying its winning tier. */
+/**
+ * A resolved (builtin ⊕ account ⊕ workspace merged) catalog entry, carrying its winning tier.
+ *
+ * Deliberately NARROWER than {@link foundationalServiceSchema}: the merged read carries only
+ * what every tier can honestly fill. A `builtin` entry is registered in code, so it has no
+ * owning scope, no repo provenance and no row timestamps — and the alternative to dropping
+ * those fields is filling them with placeholders that read as facts. They remain on the
+ * per-tier management read, which is where a stored row's provenance belongs.
+ */
 export declare const resolvedFoundationalServiceSchema: v.ObjectSchema<{
-    /** Stable slug the Architect names in its design (e.g. `file-storage`). */
     readonly id: v.StringSchema<undefined>;
-    readonly ownerKind: v.PicklistSchema<["account", "workspace"], undefined>;
     readonly name: v.StringSchema<undefined>;
-    /** One line; the catalog's relevance signal. */
     readonly summary: v.StringSchema<undefined>;
-    /** The general description — what it does, when to use it, what it does NOT cover. */
     readonly description: v.StringSchema<undefined>;
-    /** Free-form capability tags (`file-storage`, `notifications`, `audit`). */
     readonly capabilities: v.ArraySchema<v.StringSchema<undefined>, undefined>;
-    /** Contract manifest — never bodies (see {@link apiContractSummarySchema}). */
     readonly contracts: v.ArraySchema<v.ObjectSchema<{
         readonly contractId: v.StringSchema<undefined>;
         readonly format: v.PicklistSchema<["openapi", "toad-contract", "lokalise-api-contract"], undefined>;
@@ -128,38 +205,37 @@ export declare const resolvedFoundationalServiceSchema: v.ObjectSchema<{
         /** Repo provenance (`path`), or null when uploaded directly. */
         readonly path: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         /**
-         * The operations an OpenAPI document declares (`GET /files/{id}` …), capped. Empty for the
-         * TypeScript formats, which are not parsed. Cheap enough to ride the catalog and it is what
-         * makes the catalog actionable — an architect can name the endpoint it intends to call.
+         * The operations this document declares (`GET /files/{id}` …), capped. Cheap enough to ride
+         * the catalog and it is what makes the catalog actionable — an architect can name the
+         * endpoint it intends to call.
+         *
+         * EMPTY means one of two different things and {@link operationsAreIndexable} is what tells
+         * them apart: this format is not read at all, or it is and this document declares nothing.
          */
         readonly operations: v.ArraySchema<v.StringSchema<undefined>, undefined>;
         /**
-         * How many operations were dropped from {@link operations} by the cap. Non-zero says the
-         * list is a PREFIX, so a reader never concludes the tail does not exist.
+         * How many operations the document declares that {@link operations} does NOT list — dropped
+         * by the cap, or (for a contract MODULE) declared in a shape the static extractor could not
+         * read. Non-zero says the list is incomplete, so a reader never concludes the rest does not
+         * exist.
          */
         readonly omittedOperations: v.NumberSchema<undefined>;
     }, undefined>, undefined>;
-    /** Provenance when repo-sourced: the source that produced this row. */
-    readonly sourceId: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly sourcePath: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    /** Head commit the service's directory was pinned to at the last sync. */
-    readonly pinnedCommit: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly createdAt: v.NumberSchema<undefined>;
-    readonly updatedAt: v.NumberSchema<undefined>;
-    readonly tier: v.PicklistSchema<["account", "workspace"], undefined>;
+    readonly tier: v.PicklistSchema<["builtin", "account", "workspace"], undefined>;
 }, undefined>;
 export type ResolvedFoundationalService = v.InferOutput<typeof resolvedFoundationalServiceSchema>;
 /**
- * One SUPPRESSION a board is asserting: an id its workspace tier tombstones, so the account
- * service of that id loses the merge.
+ * One SUPPRESSION a tier is asserting: an id it tombstones, so the service it inherits under
+ * that id — a `builtin` the deployment registered, or (for a board) an account service — loses
+ * the merge.
  *
  * A suppressed id is by construction absent from the merged catalog, which is what makes this a
  * separate read rather than a flag on it — without it the management surface could offer no way
  * back, and suppression would be a one-way door.
  *
  * `inherited` is the honest half: `false` says the tombstone currently shadows NOTHING (the
- * account withdrew the service, or the board deleted its own registration), so a reader does not
- * conclude a capability is being withheld when there is none to withhold. The name is the
+ * tier below withdrew the service, or this tier deleted its own registration), so a reader does
+ * not conclude a capability is being withheld when there is none to withhold. The name is the
  * inherited service's when there is one and the tombstone's own otherwise, which is empty for a
  * suppression written against an id this tier never registered.
  */
@@ -195,6 +271,16 @@ export declare const createFoundationalServiceSchema: v.ObjectSchema<{
     }, undefined>, undefined>, undefined>;
 }, undefined>;
 export type CreateFoundationalServiceInput = v.InferOutput<typeof createFoundationalServiceSchema>;
+/**
+ * The ways `definition` fails {@link createFoundationalServiceSchema}, as readable lines — empty
+ * when it would be accepted.
+ *
+ * Exists so a caller that cannot depend on valibot (the backend's kernel and orchestration
+ * layers) can still hold a deployment's CODE-registered service to the very schema the REST
+ * write boundary applies. Re-stating those rules in a second place is how a code-registered
+ * definition ends up accepted where an uploaded one is refused.
+ */
+export declare function foundationalServiceDefinitionIssues(definition: unknown): string[];
 /**
  * Patch a registered service. `contracts`, when present, REPLACES the whole uploaded set —
  * a contract document has no meaningful partial edit, and a merge would leave a removed

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

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

package/dist/foundational-services.js

@@ -11,21 +11,28 @@ import { fragmentOwnerKindSchema } from './fragment-library.js';
 // contract module, or a `@lokalise/api-contract` module), supplied either by direct
 // upload or by pointing at files/folders in a git repo (cached + autorefreshed).
 //
-// Registration is TIERED exactly like the prompt-fragment library: an `account` row is
-// shared by every workspace in the account, a `workspace` row wins over it by id. The
-// resolved catalog is what the Architect sees; the contract BODIES are read lazily,
-// only for the services the Architect declared, and only by the downstream kinds that
-// need them.
+// Registration is TIERED exactly like the prompt-fragment library: a `builtin` definition
+// registered in code by the deployment is shared by every account, an `account` row wins
+// over it, and a `workspace` row wins over both. The resolved catalog is what the Architect
+// sees; the contract BODIES are read lazily, only for the services the Architect declared,
+// and only by the downstream kinds that need them.
 // ---------------------------------------------------------------------------
 /** Which scope owns a foundational service / source: an account, or a workspace. */
 export const foundationalServiceOwnerKindSchema = fragmentOwnerKindSchema;
-/** The tier a resolved catalog entry originated from, lowest-precedence first. */
-export const foundationalServiceTierSchema = v.picklist(['account', 'workspace']);
 /**
- * The API-contract document formats the catalog accepts. Each is stored verbatim as text;
- * only OpenAPI is additionally PARSED (into an operation index the lazy read renders as a
- * compact summary) because the other two are TypeScript modules, which cannot be evaluated
- * in a Worker isolate and are handed to the agent as source.
+ * The tier a resolved catalog entry originated from, lowest-precedence first.
+ *
+ * `builtin` is the DEPLOYMENT's own tier: services a deployment registers in code on the
+ * app-owned `FoundationalServiceRegistry`, exactly as it registers pipelines or task types.
+ * It carries no rows, so it is present from a workspace's first request and cannot drift from
+ * the definitions; an account or workspace row of the same id still wins over it, and a
+ * tombstone at either tier suppresses it.
+ */
+export const foundationalServiceTierSchema = v.picklist(['builtin', 'account', 'workspace']);
+/**
+ * The API-contract document formats the catalog accepts. Each is stored verbatim as text and
+ * additionally INDEXED into operation names where the format allows it — see
+ * {@link operationsAreIndexable}, which is the one place that judgement lives.
  */
 export const apiContractFormatSchema = v.picklist([
     /** An OpenAPI 3.x document, JSON or YAML. */
@@ -35,6 +42,73 @@ export const apiContractFormatSchema = v.picklist([
     /** A module built on `@lokalise/api-contract` (`buildPayloadRoute` / `buildGetRoute` …). */
     'lokalise-api-contract',
 ]);
+/**
+ * Whether an operation index can be derived from a document of this format at all.
+ *
+ * This is what keeps "this interface declares no operations" apart from "this platform does not
+ * read this format": both render as an empty `operations` list, they need opposite reactions
+ * from whoever reads the catalog, and collapsing them tells an Architect that a fully-specified
+ * service offers nothing. Every surface that renders an operation list branches on it — the
+ * agent-facing catalog and the SPA's manifest row alike — so the two cannot disagree.
+ *
+ * `lokalise-api-contract` is false because its route builders' shapes are not pinned down here
+ * and a partial guess at them would be reported as fact. Adding an extractor for it means
+ * flipping this and nothing else.
+ */
+export function operationsAreIndexable(format) {
+    return format === 'openapi' || format === 'toad-contract';
+}
+/**
+ * The capability tag a foundational service must carry to be selectable as a binary-output
+ * step's STORAGE target (enforced at run admission — see `docs/initiatives/
+ * binary-output-foundational-storage.md`).
+ *
+ * It lives here, on the wire, rather than in the kernel alone because the people who need to
+ * spell it right are OUTSIDE the backend: a deployment registering its estate, and the SPA
+ * rendering the picker. A client that cannot import the vocabulary re-declares it, and the
+ * failure of a re-declaration is silent — `asset_storage` registers cleanly and surfaces much
+ * later as a refused run.
+ */
+export const ASSET_STORAGE_CAPABILITY = 'asset-storage';
+/**
+ * The CONVENTIONAL tag for a service that can scope a generation — an inventory answering
+ * "what entities exist, which lack an asset, how is each described". Deliberately NOT enforced
+ * (any service with a readable contract can inform scope), but still reserved: a picker orders
+ * by it, so a typo silently loses the ordering rather than failing.
+ */
+export const GENERATION_CONTEXT_CAPABILITY = 'generation-context';
+/**
+ * Capability tags the PLATFORM assigns meaning to. Everything else is free-form org taxonomy
+ * and stays that way — this list is not a closed vocabulary, it is the set of spellings a
+ * registrant must not miss by a character.
+ */
+export const RESERVED_CAPABILITY_TAGS = [
+    ASSET_STORAGE_CAPABILITY,
+    GENERATION_CONTEXT_CAPABILITY,
+];
+/**
+ * The reserved tag `tag` was plainly TRYING to be, when it is not that tag exactly — else null.
+ *
+ * Capability tags are free-form strings, which is right (an org's taxonomy is its own) and is
+ * also why `asset_storage` / `Asset-Storage` / `assetstorage` register without complaint and
+ * fail a run hours later as `not_storage_capable`. Comparing on a form with separators and case
+ * removed catches exactly the near-misses and nothing else: a genuinely different tag does not
+ * collide with a reserved one under it.
+ *
+ * The caller REFUSES on a hit rather than silently canonicalising, because a registrant who
+ * meant a tag of their own under a colliding spelling must learn that the platform reads it as
+ * reserved, and a quiet rewrite of someone's taxonomy is its own surprise.
+ */
+export function reservedCapabilityNearMiss(tag) {
+    if (RESERVED_CAPABILITY_TAGS.includes(tag))
+        return null;
+    const normalized = normalizeCapabilityTag(tag);
+    return (RESERVED_CAPABILITY_TAGS.find((reserved) => normalizeCapabilityTag(reserved) === normalized) ??
+        null);
+}
+function normalizeCapabilityTag(tag) {
+    return tag.toLowerCase().replace(/[\s_-]+/g, '');
+}
 /**
  * A contract as the CATALOG lists it — identity, format and SIZE, never the body. This is
  * what the Architect's catalog carries: enough to decide whether a service is relevant and
@@ -50,14 +124,19 @@ export const apiContractSummarySchema = v.object({
     /** Repo provenance (`path`), or null when uploaded directly. */
     path: v.nullable(v.string()),
     /**
-     * The operations an OpenAPI document declares (`GET /files/{id}` …), capped. Empty for the
-     * TypeScript formats, which are not parsed. Cheap enough to ride the catalog and it is what
-     * makes the catalog actionable — an architect can name the endpoint it intends to call.
+     * The operations this document declares (`GET /files/{id}` …), capped. Cheap enough to ride
+     * the catalog and it is what makes the catalog actionable — an architect can name the
+     * endpoint it intends to call.
+     *
+     * EMPTY means one of two different things and {@link operationsAreIndexable} is what tells
+     * them apart: this format is not read at all, or it is and this document declares nothing.
      */
     operations: v.array(v.string()),
     /**
-     * How many operations were dropped from {@link operations} by the cap. Non-zero says the
-     * list is a PREFIX, so a reader never concludes the tail does not exist.
+     * How many operations the document declares that {@link operations} does NOT list — dropped
+     * by the cap, or (for a contract MODULE) declared in a shape the static extractor could not
+     * read. Non-zero says the list is incomplete, so a reader never concludes the rest does not
+     * exist.
      */
     omittedOperations: v.number(),
 });
@@ -89,22 +168,36 @@ export const foundationalServiceSchema = v.object({
     createdAt: v.number(),
     updatedAt: v.number(),
 });
-/** A resolved (account ⊕ workspace merged) catalog entry, carrying its winning tier. */
+/**
+ * A resolved (builtin ⊕ account ⊕ workspace merged) catalog entry, carrying its winning tier.
+ *
+ * Deliberately NARROWER than {@link foundationalServiceSchema}: the merged read carries only
+ * what every tier can honestly fill. A `builtin` entry is registered in code, so it has no
+ * owning scope, no repo provenance and no row timestamps — and the alternative to dropping
+ * those fields is filling them with placeholders that read as facts. They remain on the
+ * per-tier management read, which is where a stored row's provenance belongs.
+ */
 export const resolvedFoundationalServiceSchema = v.object({
-    ...foundationalServiceSchema.entries,
+    id: v.string(),
+    name: v.string(),
+    summary: v.string(),
+    description: v.string(),
+    capabilities: v.array(v.string()),
+    contracts: v.array(apiContractSummarySchema),
     tier: foundationalServiceTierSchema,
 });
 /**
- * One SUPPRESSION a board is asserting: an id its workspace tier tombstones, so the account
- * service of that id loses the merge.
+ * One SUPPRESSION a tier is asserting: an id it tombstones, so the service it inherits under
+ * that id — a `builtin` the deployment registered, or (for a board) an account service — loses
+ * the merge.
  *
  * A suppressed id is by construction absent from the merged catalog, which is what makes this a
  * separate read rather than a flag on it — without it the management surface could offer no way
  * back, and suppression would be a one-way door.
  *
  * `inherited` is the honest half: `false` says the tombstone currently shadows NOTHING (the
- * account withdrew the service, or the board deleted its own registration), so a reader does not
- * conclude a capability is being withheld when there is none to withhold. The name is the
+ * tier below withdrew the service, or this tier deleted its own registration), so a reader does
+ * not conclude a capability is being withheld when there is none to withhold. The name is the
  * inherited service's when there is one and the tombstone's own otherwise, which is empty for a
  * suppression written against an id this tier never registered.
  */
@@ -132,6 +225,24 @@ export const createFoundationalServiceSchema = v.object({
     capabilities: v.optional(v.array(v.pipe(v.string(), v.trim(), v.minLength(1), v.maxLength(64)))),
     contracts: v.optional(v.array(uploadApiContractSchema)),
 });
+/**
+ * The ways `definition` fails {@link createFoundationalServiceSchema}, as readable lines — empty
+ * when it would be accepted.
+ *
+ * Exists so a caller that cannot depend on valibot (the backend's kernel and orchestration
+ * layers) can still hold a deployment's CODE-registered service to the very schema the REST
+ * write boundary applies. Re-stating those rules in a second place is how a code-registered
+ * definition ends up accepted where an uploaded one is refused.
+ */
+export function foundationalServiceDefinitionIssues(definition) {
+    const parsed = v.safeParse(createFoundationalServiceSchema, definition);
+    if (parsed.success)
+        return [];
+    return parsed.issues.map((issue) => {
+        const path = issue.path?.map((segment) => String(segment.key)).join('.');
+        return path ? `${path}: ${issue.message}` : issue.message;
+    });
+}
 /**
  * Patch a registered service. `contracts`, when present, REPLACES the whole uploaded set —
  * a contract document has no meaningful partial edit, and a merge would leave a removed

package/dist/foundational-services.js.map

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

package/dist/github.d.ts

@@ -284,4 +284,83 @@ export declare const commentSchema: v.ObjectSchema<{
     readonly body: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
 }, undefined>;
 export type CommentInput = v.InferOutput<typeof commentSchema>;
+/**
+ * Three states, never two. `unknown` is a real answer: a probe that could not reach the host
+ * must not render as either "protected" or "unprotected", or the report manufactures an
+ * all-clear (or a false alarm) out of an outage.
+ */
+export declare const branchProtectionStateSchema: v.PicklistSchema<["protected", "unprotected", "unknown"], undefined>;
+export type BranchProtectionStateValue = v.InferOutput<typeof branchProtectionStateSchema>;
+/** Why a state is `unknown`. Kept apart because each needs a different fix. */
+export declare const branchProtectionUnknownReasonSchema: v.PicklistSchema<["branch_not_found", "forbidden", "error"], undefined>;
+/**
+ * The protection rule's contents. Present only when the run credential could READ the rule,
+ * which needs admin access a minimally-scoped App installation deliberately lacks — so the
+ * state above is always answerable and this is not.
+ */
+export declare const branchProtectionDetailSchema: v.ObjectSchema<{
+    readonly requiresPullRequest: v.BooleanSchema<undefined>;
+    readonly requiredApprovingReviewCount: v.NumberSchema<undefined>;
+    readonly requiredStatusChecks: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    readonly allowsForcePush: v.BooleanSchema<undefined>;
+}, undefined>;
+export declare const branchProtectionSummarySchema: v.ObjectSchema<{
+    readonly state: v.PicklistSchema<["protected", "unprotected", "unknown"], undefined>;
+    readonly reason: v.OptionalSchema<v.PicklistSchema<["branch_not_found", "forbidden", "error"], undefined>, undefined>;
+    readonly detail: v.OptionalSchema<v.ObjectSchema<{
+        readonly requiresPullRequest: v.BooleanSchema<undefined>;
+        readonly requiredApprovingReviewCount: v.NumberSchema<undefined>;
+        readonly requiredStatusChecks: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        readonly allowsForcePush: v.BooleanSchema<undefined>;
+    }, undefined>, undefined>;
+    /** Set on a PROTECTED branch whose rule could not be read — a distinct operator situation. */
+    readonly detailUnavailable: v.OptionalSchema<v.PicklistSchema<["forbidden", "error"], undefined>, undefined>;
+}, undefined>;
+export type BranchProtectionSummaryView = v.InferOutput<typeof branchProtectionSummarySchema>;
+export declare const repoBranchProtectionSchema: v.ObjectSchema<{
+    readonly repoGithubId: v.NumberSchema<undefined>;
+    readonly owner: v.StringSchema<undefined>;
+    readonly name: v.StringSchema<undefined>;
+    readonly defaultBranch: v.StringSchema<undefined>;
+    readonly protection: v.ObjectSchema<{
+        readonly state: v.PicklistSchema<["protected", "unprotected", "unknown"], undefined>;
+        readonly reason: v.OptionalSchema<v.PicklistSchema<["branch_not_found", "forbidden", "error"], undefined>, undefined>;
+        readonly detail: v.OptionalSchema<v.ObjectSchema<{
+            readonly requiresPullRequest: v.BooleanSchema<undefined>;
+            readonly requiredApprovingReviewCount: v.NumberSchema<undefined>;
+            readonly requiredStatusChecks: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            readonly allowsForcePush: v.BooleanSchema<undefined>;
+        }, undefined>, undefined>;
+        /** Set on a PROTECTED branch whose rule could not be read — a distinct operator situation. */
+        readonly detailUnavailable: v.OptionalSchema<v.PicklistSchema<["forbidden", "error"], undefined>, undefined>;
+    }, undefined>;
+}, undefined>;
+export declare const branchProtectionReportSchema: v.ObjectSchema<{
+    /**
+     * `unavailable` ⇒ the wired VCS provider cannot answer this at all. Reported as its own
+     * state so an empty report never impersonates a clean one.
+     */
+    readonly capability: v.PicklistSchema<["ok", "unavailable"], undefined>;
+    readonly repos: v.ArraySchema<v.ObjectSchema<{
+        readonly repoGithubId: v.NumberSchema<undefined>;
+        readonly owner: v.StringSchema<undefined>;
+        readonly name: v.StringSchema<undefined>;
+        readonly defaultBranch: v.StringSchema<undefined>;
+        readonly protection: v.ObjectSchema<{
+            readonly state: v.PicklistSchema<["protected", "unprotected", "unknown"], undefined>;
+            readonly reason: v.OptionalSchema<v.PicklistSchema<["branch_not_found", "forbidden", "error"], undefined>, undefined>;
+            readonly detail: v.OptionalSchema<v.ObjectSchema<{
+                readonly requiresPullRequest: v.BooleanSchema<undefined>;
+                readonly requiredApprovingReviewCount: v.NumberSchema<undefined>;
+                readonly requiredStatusChecks: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                readonly allowsForcePush: v.BooleanSchema<undefined>;
+            }, undefined>, undefined>;
+            /** Set on a PROTECTED branch whose rule could not be read — a distinct operator situation. */
+            readonly detailUnavailable: v.OptionalSchema<v.PicklistSchema<["forbidden", "error"], undefined>, undefined>;
+        }, undefined>;
+    }, undefined>, undefined>;
+    /** Linked repositories left unprobed by the fan-out cap — stated, never silently dropped. */
+    readonly omittedRepos: v.NumberSchema<undefined>;
+}, undefined>;
+export type BranchProtectionReportView = v.InferOutput<typeof branchProtectionReportSchema>;
 //# sourceMappingURL=github.d.ts.map