@openvtc/trust-tasks 0.21.3 → 0.21.5

package/dist/git-ns/namespace/list/0.1/payload.d.ts

@@ -0,0 +1,1343 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/git-ns/namespace/list/0.1/payload.schema.json
+ */
+import type { Did_GitNsV0_3 as Did, Ext, ForgeHost, ForgeId, NamespaceId, Resource, Segment } from "../../../../_shared/components.js";
+/**
+ * A level of the bridge's forge-neutral role ladder, lowest first: the vocabulary role drift's `observed` and `expected` are reported in. `none` is no direct role on the repository.
+ */
+export type MappedRole = "none" | "read" | "triage" | "write" | "maintain" | "admin";
+/**
+ * An administrator lists the namespaces they administer — every one, for a holder of the community-administrator capability — with each one's admins, repository count, bridge and forge status.
+ */
+export interface GitNamespacesListNamespacesPayload {
+    /**
+     * Only this namespace. It must be one the caller administers; a namespace they do not administer, or one this VTC does not have, is refused with `notAdministrator` alike.
+     */
+    namespace?: NamespaceId;
+    ext?: Ext;
+}
+/**
+ * The namespaces the caller administers, or the one asked for.
+ */
+export interface GitNamespacesListNamespacesResponsePayload {
+    /**
+     * Every administered namespace, `pending` ones included, ordered by `resource`. Empty only for a holder of the community-administrator capability on a VTC with no namespace.
+     */
+    namespaces: NamespaceStatus[];
+    ext?: Ext;
+}
+/**
+ * One namespace as its administrators govern it: the binding, who administers it, how many repositories it holds, and what its bridge last reported.
+ */
+export interface NamespaceStatus {
+    id: NamespaceId;
+    forge: ForgeHost;
+    /**
+     * The organisation or user on the forge, lowercased.
+     */
+    owner: Segment;
+    /**
+     * The namespace as a resource: `<forge>/<owner>`.
+     */
+    resource: Resource;
+    /**
+     * As `GitNamespace.mode` in the shared schema.
+     */
+    mode: "bridge" | "manual";
+    /**
+     * As `GitNamespace.state` in the shared schema.
+     */
+    state: "pending" | "bound";
+    /**
+     * Whether the owner is an organisation or a personal account, once the forge has said.
+     */
+    kind?: "organization" | "user";
+    /**
+     * The forge's id for the owner, once the forge has said. Unlike `owner`, it survives a rename.
+     */
+    ownerId?: ForgeId;
+    /**
+     * The bridge that serves the namespace. Absent in manual mode.
+     */
+    bridgeDid?: Did;
+    /**
+     * Who bound it.
+     */
+    boundBy: Did;
+    /**
+     * When binding was requested.
+     */
+    requestedAt: string;
+    /**
+     * When binding completed. Absent while `pending`.
+     */
+    boundAt?: string;
+    /**
+     * Everyone holding a live, explicitly recorded `git.ns.admin` on the namespace. Each of them can grant anything in it.
+     */
+    admins: Did[];
+    /**
+     * How many repositories the VTC records in the namespace, in any state.
+     */
+    repoCount: number;
+    /**
+     * Bound, with no live admin: its last admin left or lapsed. Nobody can grant in it until an administrator reseats one (`git-ns/namespace/reseat`).
+     */
+    headless: boolean;
+    /**
+     * The bridge reported losing its access to the forge owner, and has not reported access since.
+     */
+    installationRemoved: boolean;
+    forgeStatus?: ForgeStatus;
+    /**
+     * What the community's policy does with a forge role nobody granted: `report` it as drift for an administrator to resolve, or `enforce` the projection by reverting it. Community-wide; repeated on every namespace so that each row stands alone.
+     */
+    roleDrift: "report" | "enforce";
+    /**
+     * Whether the community's policy revokes the grants a member made when that member leaves. Community-wide, as `roleDrift`.
+     */
+    cascadeOnDeparture: boolean;
+    roleMap?: RoleMap;
+    /**
+     * `reported` — the bridge serving the namespace reported its role map. `unknown` — it has not, since the namespace was bound or came to be served by it.
+     */
+    roleMapSource: "reported" | "unknown";
+    /**
+     * The `issuedAt` of the role-map report held, on the bridge's clock.
+     */
+    roleMapReportedAt?: string;
+}
+/**
+ * What the bridge serving the namespace last reported about its standing on the forge owner — its app, its installation and what the owner's plan allows. Display only: it changes no decision the VTC takes. Every member but `missingPermissions` is absent until the bridge reports it.
+ */
+export interface ForgeStatus {
+    /**
+     * The forge's identifier for its installation of the community's app (GitHub).
+     */
+    installationId?: string;
+    /**
+     * The app's display name.
+     */
+    appName?: string;
+    /**
+     * The app's URL slug on the forge.
+     */
+    appSlug?: string;
+    /**
+     * Where the app's manifest registration stands, in the bridge's words (`registered`, `pending`).
+     */
+    appRegistration?: string;
+    /**
+     * Permissions the app needs and the installation has not granted, in the forge's vocabulary. Empty when none are missing, or none were reported.
+     *
+     * @maxItems 256
+     */
+    missingPermissions: string[];
+    /**
+     * A new version of the app asks for permissions the forge owner has not approved yet.
+     */
+    permissionUpgradePending?: boolean;
+    /**
+     * Organisation rulesets are available on the owner's plan.
+     */
+    orgRulesets?: boolean;
+    /**
+     * The organisation ruleset requiring the verify-trust workflow is in force.
+     */
+    requiredWorkflow?: boolean;
+    /**
+     * The bridge can post the verify-trust check itself, the fallback where no required workflow is available.
+     */
+    bridgePostedCheck?: boolean;
+    /**
+     * When the VTC received the report.
+     */
+    reportedAt?: string;
+}
+/**
+ * The forge role each right projects to on a repository without a map of its own, as the serving bridge last reported it. Absent while `roleMapSource` is `unknown`: no map, the default included, is assumed.
+ */
+export interface RoleMap {
+    own: MappedRole;
+    maintain: MappedRole;
+    commit: MappedRole;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Did, Ext, ForgeHost, ForgeId, NamespaceId, Resource, Segment };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/git-ns/namespace/list/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = GitNamespacesListNamespacesPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/git-ns/namespace/list/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = GitNamespacesListNamespacesResponsePayload;
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/git-ns/namespace/list/0.1";
+    readonly title: "Git Namespaces — List Namespaces — payload";
+    readonly description: "An administrator lists the namespaces they administer — every one, for a holder of the community-administrator capability — with each one's admins, repository count, bridge and forge status.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly [];
+    readonly properties: {
+        readonly namespace: {
+            readonly $ref: "#/$defs/NamespaceId";
+            readonly description: "Only this namespace. It must be one the caller administers; a namespace they do not administer, or one this VTC does not have, is refused with `notAdministrator` alike.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly MappedRole: {
+            readonly title: "MappedRole";
+            readonly type: "string";
+            readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
+            readonly description: "A level of the bridge's forge-neutral role ladder, lowest first: the vocabulary role drift's `observed` and `expected` are reported in. `none` is no direct role on the repository.";
+        };
+        readonly RoleMap: {
+            readonly title: "RoleMap";
+            readonly description: "The forge role each repository right is given, as the forge applies it: after the forge's own ladder has rounded it down. `own` is the role `git.repo.own` projects to, `maintain` that of `git.repo.maintain`, `commit` that of `git.commit.sign` (`none` is fork-based contribution). There is no member for `git.ns.admin` or `git.repo.create`, which project to no forge role whatever a bridge is configured with. Ordered: `own` is at least `maintain`, which is at least `commit`, and `commit` is at most `write`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["own", "maintain", "commit"];
+            readonly properties: {
+                readonly own: {
+                    readonly $ref: "#/$defs/MappedRole";
+                };
+                readonly maintain: {
+                    readonly $ref: "#/$defs/MappedRole";
+                };
+                readonly commit: {
+                    readonly $ref: "#/$defs/MappedRole";
+                };
+            };
+        };
+        readonly ForgeStatus: {
+            readonly title: "ForgeStatus";
+            readonly description: "What the bridge serving the namespace last reported about its standing on the forge owner — its app, its installation and what the owner's plan allows. Display only: it changes no decision the VTC takes. Every member but `missingPermissions` is absent until the bridge reports it.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["missingPermissions"];
+            readonly properties: {
+                readonly installationId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly description: "The forge's identifier for its installation of the community's app (GitHub).";
+                };
+                readonly appName: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "The app's display name.";
+                };
+                readonly appSlug: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "The app's URL slug on the forge.";
+                };
+                readonly appRegistration: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "Where the app's manifest registration stands, in the bridge's words (`registered`, `pending`).";
+                };
+                readonly missingPermissions: {
+                    readonly type: "array";
+                    readonly maxItems: 256;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly description: "Permissions the app needs and the installation has not granted, in the forge's vocabulary. Empty when none are missing, or none were reported.";
+                };
+                readonly permissionUpgradePending: {
+                    readonly type: "boolean";
+                    readonly description: "A new version of the app asks for permissions the forge owner has not approved yet.";
+                };
+                readonly orgRulesets: {
+                    readonly type: "boolean";
+                    readonly description: "Organisation rulesets are available on the owner's plan.";
+                };
+                readonly requiredWorkflow: {
+                    readonly type: "boolean";
+                    readonly description: "The organisation ruleset requiring the verify-trust workflow is in force.";
+                };
+                readonly bridgePostedCheck: {
+                    readonly type: "boolean";
+                    readonly description: "The bridge can post the verify-trust check itself, the fallback where no required workflow is available.";
+                };
+                readonly reportedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the VTC received the report.";
+                };
+            };
+        };
+        readonly NamespaceStatus: {
+            readonly title: "NamespaceStatus";
+            readonly description: "One namespace as its administrators govern it: the binding, who administers it, how many repositories it holds, and what its bridge last reported.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "forge", "owner", "resource", "mode", "state", "boundBy", "requestedAt", "admins", "repoCount", "headless", "installationRemoved", "roleDrift", "cascadeOnDeparture", "roleMapSource"];
+            readonly properties: {
+                readonly id: {
+                    readonly $ref: "#/$defs/NamespaceId";
+                };
+                readonly forge: {
+                    readonly $ref: "#/$defs/ForgeHost";
+                };
+                readonly owner: {
+                    readonly $ref: "#/$defs/Segment";
+                    readonly description: "The organisation or user on the forge, lowercased.";
+                };
+                readonly resource: {
+                    readonly $ref: "#/$defs/Resource";
+                    readonly description: "The namespace as a resource: `<forge>/<owner>`.";
+                };
+                readonly mode: {
+                    readonly type: "string";
+                    readonly enum: readonly ["bridge", "manual"];
+                    readonly description: "As `GitNamespace.mode` in the shared schema.";
+                };
+                readonly state: {
+                    readonly type: "string";
+                    readonly enum: readonly ["pending", "bound"];
+                    readonly description: "As `GitNamespace.state` in the shared schema.";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly enum: readonly ["organization", "user"];
+                    readonly description: "Whether the owner is an organisation or a personal account, once the forge has said.";
+                };
+                readonly ownerId: {
+                    readonly $ref: "#/$defs/ForgeId";
+                    readonly description: "The forge's id for the owner, once the forge has said. Unlike `owner`, it survives a rename.";
+                };
+                readonly bridgeDid: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The bridge that serves the namespace. Absent in manual mode.";
+                };
+                readonly boundBy: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "Who bound it.";
+                };
+                readonly requestedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When binding was requested.";
+                };
+                readonly boundAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When binding completed. Absent while `pending`.";
+                };
+                readonly admins: {
+                    readonly type: "array";
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly $ref: "#/$defs/Did";
+                    };
+                    readonly description: "Everyone holding a live, explicitly recorded `git.ns.admin` on the namespace. Each of them can grant anything in it.";
+                };
+                readonly repoCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "How many repositories the VTC records in the namespace, in any state.";
+                };
+                readonly headless: {
+                    readonly type: "boolean";
+                    readonly description: "Bound, with no live admin: its last admin left or lapsed. Nobody can grant in it until an administrator reseats one (`git-ns/namespace/reseat`).";
+                };
+                readonly installationRemoved: {
+                    readonly type: "boolean";
+                    readonly description: "The bridge reported losing its access to the forge owner, and has not reported access since.";
+                };
+                readonly forgeStatus: {
+                    readonly $ref: "#/$defs/ForgeStatus";
+                };
+                readonly roleDrift: {
+                    readonly type: "string";
+                    readonly enum: readonly ["report", "enforce"];
+                    readonly description: "What the community's policy does with a forge role nobody granted: `report` it as drift for an administrator to resolve, or `enforce` the projection by reverting it. Community-wide; repeated on every namespace so that each row stands alone.";
+                };
+                readonly cascadeOnDeparture: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the community's policy revokes the grants a member made when that member leaves. Community-wide, as `roleDrift`.";
+                };
+                readonly roleMap: {
+                    readonly $ref: "#/$defs/RoleMap";
+                    readonly description: "The forge role each right projects to on a repository without a map of its own, as the serving bridge last reported it. Absent while `roleMapSource` is `unknown`: no map, the default included, is assumed.";
+                };
+                readonly roleMapSource: {
+                    readonly type: "string";
+                    readonly enum: readonly ["reported", "unknown"];
+                    readonly description: "`reported` — the bridge serving the namespace reported its role map. `unknown` — it has not, since the namespace was bound or came to be served by it.";
+                };
+                readonly roleMapReportedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "The `issuedAt` of the role-map report held, on the bridge's clock.";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Git Namespaces — List Namespaces — response payload";
+            readonly description: "The namespaces the caller administers, or the one asked for.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["namespaces"];
+            readonly properties: {
+                readonly namespaces: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/NamespaceStatus";
+                    };
+                    readonly description: "Every administered namespace, `pending` ones included, ordered by `resource`. Empty only for a holder of the community-administrator capability on a VTC with no namespace.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly Did: {
+            readonly title: "Did";
+            readonly description: "A bare DID in the W3C DID Core syntax (§3.1): `did:`, a method name of lowercase letters and digits, `:`, and a method-specific id of colon-separated segments drawn from `A-Z a-z 0-9 . - _` and percent-encoded octets, the last segment non-empty. A DID URL is not a DID: no path, query or fragment (`/`, `?`, `#`), so a verification-method id such as `did:key:z6Mk…#z6Mk…` is refused. Compared by exact string equality — no case folding or percent-decoding. A consumer MUST still treat the value as data: the pattern keeps shell metacharacters, whitespace and quotes out of the wire form, but it does not make a DID safe to splice into a command or markup.";
+            readonly type: "string";
+            readonly maxLength: 2048;
+            readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
+        };
+        readonly ForgeId: {
+            readonly title: "ForgeId";
+            readonly description: "An identifier the forge itself assigns — a repository id, a user or organisation id — carried as a string so a forge whose ids are not numbers needs no new version. GitHub and Forgejo ids are decimal integers written as strings (`\"812736451\"`). Unlike a name, it survives renames and transfers, which is why rights and bindings are keyed by it.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+        };
+        readonly Resource: {
+            readonly title: "Resource";
+            readonly description: "A forge-qualified resource: `<forge-host>/<owner>` for a namespace, or `<forge-host>/<owner>/<repo>` for one repository, all lowercase — `github.com/acme`, `github.com/acme/widgets`, `codeberg.org/acme`. The forge is never implied: `acme/widgets` alone is not a resource. Containment is by whole segment: `github.com/acme` contains `github.com/acme/widgets` and does not contain `github.com/acme-labs/x` or `codeberg.org/acme/widgets`.";
+            readonly type: "string";
+            readonly maxLength: 455;
+            readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+(?:/[a-z0-9_-][a-z0-9._-]{0,99}){1,2}$";
+        };
+        readonly Segment: {
+            readonly title: "Segment";
+            readonly description: "One lowercased owner or repository name. Forges compare these case-insensitively, so the wire form is always lowercase and a producer lowercases before sending. A leading `.` is refused, which rules out `.` and `..`.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+            readonly pattern: "^[a-z0-9_-][a-z0-9._-]*$";
+        };
+        readonly ForgeHost: {
+            readonly title: "ForgeHost";
+            readonly description: "The lowercased DNS host of a forge: `github.com`, a GitHub Enterprise Server host, `codeberg.org`, or a self-hosted Forgejo instance such as `git.example.org`. No scheme, no port, no path. The host is a segment of every resource, so a right never crosses forges.";
+            readonly type: "string";
+            readonly minLength: 3;
+            readonly maxLength: 253;
+            readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$";
+        };
+        readonly NamespaceId: {
+            readonly title: "NamespaceId";
+            readonly description: "The VTC's opaque identifier for a namespace, assigned when it is bound. Stable for the life of the binding; never reused for another binding.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly MappedRole: {
+            readonly title: "MappedRole";
+            readonly type: "string";
+            readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
+            readonly description: "A level of the bridge's forge-neutral role ladder, lowest first: the vocabulary role drift's `observed` and `expected` are reported in. `none` is no direct role on the repository.";
+        };
+        readonly RoleMap: {
+            readonly title: "RoleMap";
+            readonly description: "The forge role each repository right is given, as the forge applies it: after the forge's own ladder has rounded it down. `own` is the role `git.repo.own` projects to, `maintain` that of `git.repo.maintain`, `commit` that of `git.commit.sign` (`none` is fork-based contribution). There is no member for `git.ns.admin` or `git.repo.create`, which project to no forge role whatever a bridge is configured with. Ordered: `own` is at least `maintain`, which is at least `commit`, and `commit` is at most `write`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["own", "maintain", "commit"];
+            readonly properties: {
+                readonly own: {
+                    readonly $ref: "#/$defs/MappedRole";
+                };
+                readonly maintain: {
+                    readonly $ref: "#/$defs/MappedRole";
+                };
+                readonly commit: {
+                    readonly $ref: "#/$defs/MappedRole";
+                };
+            };
+        };
+        readonly ForgeStatus: {
+            readonly title: "ForgeStatus";
+            readonly description: "What the bridge serving the namespace last reported about its standing on the forge owner — its app, its installation and what the owner's plan allows. Display only: it changes no decision the VTC takes. Every member but `missingPermissions` is absent until the bridge reports it.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["missingPermissions"];
+            readonly properties: {
+                readonly installationId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 64;
+                    readonly description: "The forge's identifier for its installation of the community's app (GitHub).";
+                };
+                readonly appName: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "The app's display name.";
+                };
+                readonly appSlug: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "The app's URL slug on the forge.";
+                };
+                readonly appRegistration: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "Where the app's manifest registration stands, in the bridge's words (`registered`, `pending`).";
+                };
+                readonly missingPermissions: {
+                    readonly type: "array";
+                    readonly maxItems: 256;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                    };
+                    readonly description: "Permissions the app needs and the installation has not granted, in the forge's vocabulary. Empty when none are missing, or none were reported.";
+                };
+                readonly permissionUpgradePending: {
+                    readonly type: "boolean";
+                    readonly description: "A new version of the app asks for permissions the forge owner has not approved yet.";
+                };
+                readonly orgRulesets: {
+                    readonly type: "boolean";
+                    readonly description: "Organisation rulesets are available on the owner's plan.";
+                };
+                readonly requiredWorkflow: {
+                    readonly type: "boolean";
+                    readonly description: "The organisation ruleset requiring the verify-trust workflow is in force.";
+                };
+                readonly bridgePostedCheck: {
+                    readonly type: "boolean";
+                    readonly description: "The bridge can post the verify-trust check itself, the fallback where no required workflow is available.";
+                };
+                readonly reportedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the VTC received the report.";
+                };
+            };
+        };
+        readonly NamespaceStatus: {
+            readonly title: "NamespaceStatus";
+            readonly description: "One namespace as its administrators govern it: the binding, who administers it, how many repositories it holds, and what its bridge last reported.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["id", "forge", "owner", "resource", "mode", "state", "boundBy", "requestedAt", "admins", "repoCount", "headless", "installationRemoved", "roleDrift", "cascadeOnDeparture", "roleMapSource"];
+            readonly properties: {
+                readonly id: {
+                    readonly $ref: "#/$defs/NamespaceId";
+                };
+                readonly forge: {
+                    readonly $ref: "#/$defs/ForgeHost";
+                };
+                readonly owner: {
+                    readonly $ref: "#/$defs/Segment";
+                    readonly description: "The organisation or user on the forge, lowercased.";
+                };
+                readonly resource: {
+                    readonly $ref: "#/$defs/Resource";
+                    readonly description: "The namespace as a resource: `<forge>/<owner>`.";
+                };
+                readonly mode: {
+                    readonly type: "string";
+                    readonly enum: readonly ["bridge", "manual"];
+                    readonly description: "As `GitNamespace.mode` in the shared schema.";
+                };
+                readonly state: {
+                    readonly type: "string";
+                    readonly enum: readonly ["pending", "bound"];
+                    readonly description: "As `GitNamespace.state` in the shared schema.";
+                };
+                readonly kind: {
+                    readonly type: "string";
+                    readonly enum: readonly ["organization", "user"];
+                    readonly description: "Whether the owner is an organisation or a personal account, once the forge has said.";
+                };
+                readonly ownerId: {
+                    readonly $ref: "#/$defs/ForgeId";
+                    readonly description: "The forge's id for the owner, once the forge has said. Unlike `owner`, it survives a rename.";
+                };
+                readonly bridgeDid: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The bridge that serves the namespace. Absent in manual mode.";
+                };
+                readonly boundBy: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "Who bound it.";
+                };
+                readonly requestedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When binding was requested.";
+                };
+                readonly boundAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When binding completed. Absent while `pending`.";
+                };
+                readonly admins: {
+                    readonly type: "array";
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly $ref: "#/$defs/Did";
+                    };
+                    readonly description: "Everyone holding a live, explicitly recorded `git.ns.admin` on the namespace. Each of them can grant anything in it.";
+                };
+                readonly repoCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "How many repositories the VTC records in the namespace, in any state.";
+                };
+                readonly headless: {
+                    readonly type: "boolean";
+                    readonly description: "Bound, with no live admin: its last admin left or lapsed. Nobody can grant in it until an administrator reseats one (`git-ns/namespace/reseat`).";
+                };
+                readonly installationRemoved: {
+                    readonly type: "boolean";
+                    readonly description: "The bridge reported losing its access to the forge owner, and has not reported access since.";
+                };
+                readonly forgeStatus: {
+                    readonly $ref: "#/$defs/ForgeStatus";
+                };
+                readonly roleDrift: {
+                    readonly type: "string";
+                    readonly enum: readonly ["report", "enforce"];
+                    readonly description: "What the community's policy does with a forge role nobody granted: `report` it as drift for an administrator to resolve, or `enforce` the projection by reverting it. Community-wide; repeated on every namespace so that each row stands alone.";
+                };
+                readonly cascadeOnDeparture: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the community's policy revokes the grants a member made when that member leaves. Community-wide, as `roleDrift`.";
+                };
+                readonly roleMap: {
+                    readonly $ref: "#/$defs/RoleMap";
+                    readonly description: "The forge role each right projects to on a repository without a map of its own, as the serving bridge last reported it. Absent while `roleMapSource` is `unknown`: no map, the default included, is assumed.";
+                };
+                readonly roleMapSource: {
+                    readonly type: "string";
+                    readonly enum: readonly ["reported", "unknown"];
+                    readonly description: "`reported` — the bridge serving the namespace reported its role map. `unknown` — it has not, since the namespace was bound or came to be served by it.";
+                };
+                readonly roleMapReportedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "The `issuedAt` of the role-map report held, on the bridge's clock.";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Git Namespaces — List Namespaces — response payload";
+            readonly description: "The namespaces the caller administers, or the one asked for.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["namespaces"];
+            readonly properties: {
+                readonly namespaces: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/NamespaceStatus";
+                    };
+                    readonly description: "Every administered namespace, `pending` ones included, ordered by `resource`. Empty only for a holder of the community-administrator capability on a VTC with no namespace.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly Did: {
+            readonly title: "Did";
+            readonly description: "A bare DID in the W3C DID Core syntax (§3.1): `did:`, a method name of lowercase letters and digits, `:`, and a method-specific id of colon-separated segments drawn from `A-Z a-z 0-9 . - _` and percent-encoded octets, the last segment non-empty. A DID URL is not a DID: no path, query or fragment (`/`, `?`, `#`), so a verification-method id such as `did:key:z6Mk…#z6Mk…` is refused. Compared by exact string equality — no case folding or percent-decoding. A consumer MUST still treat the value as data: the pattern keeps shell metacharacters, whitespace and quotes out of the wire form, but it does not make a DID safe to splice into a command or markup.";
+            readonly type: "string";
+            readonly maxLength: 2048;
+            readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
+        };
+        readonly ForgeId: {
+            readonly title: "ForgeId";
+            readonly description: "An identifier the forge itself assigns — a repository id, a user or organisation id — carried as a string so a forge whose ids are not numbers needs no new version. GitHub and Forgejo ids are decimal integers written as strings (`\"812736451\"`). Unlike a name, it survives renames and transfers, which is why rights and bindings are keyed by it.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+        };
+        readonly Resource: {
+            readonly title: "Resource";
+            readonly description: "A forge-qualified resource: `<forge-host>/<owner>` for a namespace, or `<forge-host>/<owner>/<repo>` for one repository, all lowercase — `github.com/acme`, `github.com/acme/widgets`, `codeberg.org/acme`. The forge is never implied: `acme/widgets` alone is not a resource. Containment is by whole segment: `github.com/acme` contains `github.com/acme/widgets` and does not contain `github.com/acme-labs/x` or `codeberg.org/acme/widgets`.";
+            readonly type: "string";
+            readonly maxLength: 455;
+            readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+(?:/[a-z0-9_-][a-z0-9._-]{0,99}){1,2}$";
+        };
+        readonly Segment: {
+            readonly title: "Segment";
+            readonly description: "One lowercased owner or repository name. Forges compare these case-insensitively, so the wire form is always lowercase and a producer lowercases before sending. A leading `.` is refused, which rules out `.` and `..`.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+            readonly pattern: "^[a-z0-9_-][a-z0-9._-]*$";
+        };
+        readonly ForgeHost: {
+            readonly title: "ForgeHost";
+            readonly description: "The lowercased DNS host of a forge: `github.com`, a GitHub Enterprise Server host, `codeberg.org`, or a self-hosted Forgejo instance such as `git.example.org`. No scheme, no port, no path. The host is a segment of every resource, so a right never crosses forges.";
+            readonly type: "string";
+            readonly minLength: 3;
+            readonly maxLength: 253;
+            readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$";
+        };
+        readonly NamespaceId: {
+            readonly title: "NamespaceId";
+            readonly description: "The VTC's opaque identifier for a namespace, assigned when it is bound. Stable for the life of the binding; never reused for another binding.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/git-ns/namespace/list/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/git-ns/namespace/list/0.1";
+        readonly title: "Git Namespaces — List Namespaces — payload";
+        readonly description: "An administrator lists the namespaces they administer — every one, for a holder of the community-administrator capability — with each one's admins, repository count, bridge and forge status.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly [];
+        readonly properties: {
+            readonly namespace: {
+                readonly $ref: "#/$defs/NamespaceId";
+                readonly description: "Only this namespace. It must be one the caller administers; a namespace they do not administer, or one this VTC does not have, is refused with `notAdministrator` alike.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly MappedRole: {
+                readonly title: "MappedRole";
+                readonly type: "string";
+                readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
+                readonly description: "A level of the bridge's forge-neutral role ladder, lowest first: the vocabulary role drift's `observed` and `expected` are reported in. `none` is no direct role on the repository.";
+            };
+            readonly RoleMap: {
+                readonly title: "RoleMap";
+                readonly description: "The forge role each repository right is given, as the forge applies it: after the forge's own ladder has rounded it down. `own` is the role `git.repo.own` projects to, `maintain` that of `git.repo.maintain`, `commit` that of `git.commit.sign` (`none` is fork-based contribution). There is no member for `git.ns.admin` or `git.repo.create`, which project to no forge role whatever a bridge is configured with. Ordered: `own` is at least `maintain`, which is at least `commit`, and `commit` is at most `write`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["own", "maintain", "commit"];
+                readonly properties: {
+                    readonly own: {
+                        readonly $ref: "#/$defs/MappedRole";
+                    };
+                    readonly maintain: {
+                        readonly $ref: "#/$defs/MappedRole";
+                    };
+                    readonly commit: {
+                        readonly $ref: "#/$defs/MappedRole";
+                    };
+                };
+            };
+            readonly ForgeStatus: {
+                readonly title: "ForgeStatus";
+                readonly description: "What the bridge serving the namespace last reported about its standing on the forge owner — its app, its installation and what the owner's plan allows. Display only: it changes no decision the VTC takes. Every member but `missingPermissions` is absent until the bridge reports it.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["missingPermissions"];
+                readonly properties: {
+                    readonly installationId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly description: "The forge's identifier for its installation of the community's app (GitHub).";
+                    };
+                    readonly appName: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "The app's display name.";
+                    };
+                    readonly appSlug: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "The app's URL slug on the forge.";
+                    };
+                    readonly appRegistration: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "Where the app's manifest registration stands, in the bridge's words (`registered`, `pending`).";
+                    };
+                    readonly missingPermissions: {
+                        readonly type: "array";
+                        readonly maxItems: 256;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 128;
+                        };
+                        readonly description: "Permissions the app needs and the installation has not granted, in the forge's vocabulary. Empty when none are missing, or none were reported.";
+                    };
+                    readonly permissionUpgradePending: {
+                        readonly type: "boolean";
+                        readonly description: "A new version of the app asks for permissions the forge owner has not approved yet.";
+                    };
+                    readonly orgRulesets: {
+                        readonly type: "boolean";
+                        readonly description: "Organisation rulesets are available on the owner's plan.";
+                    };
+                    readonly requiredWorkflow: {
+                        readonly type: "boolean";
+                        readonly description: "The organisation ruleset requiring the verify-trust workflow is in force.";
+                    };
+                    readonly bridgePostedCheck: {
+                        readonly type: "boolean";
+                        readonly description: "The bridge can post the verify-trust check itself, the fallback where no required workflow is available.";
+                    };
+                    readonly reportedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the VTC received the report.";
+                    };
+                };
+            };
+            readonly NamespaceStatus: {
+                readonly title: "NamespaceStatus";
+                readonly description: "One namespace as its administrators govern it: the binding, who administers it, how many repositories it holds, and what its bridge last reported.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "forge", "owner", "resource", "mode", "state", "boundBy", "requestedAt", "admins", "repoCount", "headless", "installationRemoved", "roleDrift", "cascadeOnDeparture", "roleMapSource"];
+                readonly properties: {
+                    readonly id: {
+                        readonly $ref: "#/$defs/NamespaceId";
+                    };
+                    readonly forge: {
+                        readonly $ref: "#/$defs/ForgeHost";
+                    };
+                    readonly owner: {
+                        readonly $ref: "#/$defs/Segment";
+                        readonly description: "The organisation or user on the forge, lowercased.";
+                    };
+                    readonly resource: {
+                        readonly $ref: "#/$defs/Resource";
+                        readonly description: "The namespace as a resource: `<forge>/<owner>`.";
+                    };
+                    readonly mode: {
+                        readonly type: "string";
+                        readonly enum: readonly ["bridge", "manual"];
+                        readonly description: "As `GitNamespace.mode` in the shared schema.";
+                    };
+                    readonly state: {
+                        readonly type: "string";
+                        readonly enum: readonly ["pending", "bound"];
+                        readonly description: "As `GitNamespace.state` in the shared schema.";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: readonly ["organization", "user"];
+                        readonly description: "Whether the owner is an organisation or a personal account, once the forge has said.";
+                    };
+                    readonly ownerId: {
+                        readonly $ref: "#/$defs/ForgeId";
+                        readonly description: "The forge's id for the owner, once the forge has said. Unlike `owner`, it survives a rename.";
+                    };
+                    readonly bridgeDid: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The bridge that serves the namespace. Absent in manual mode.";
+                    };
+                    readonly boundBy: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "Who bound it.";
+                    };
+                    readonly requestedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When binding was requested.";
+                    };
+                    readonly boundAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When binding completed. Absent while `pending`.";
+                    };
+                    readonly admins: {
+                        readonly type: "array";
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly $ref: "#/$defs/Did";
+                        };
+                        readonly description: "Everyone holding a live, explicitly recorded `git.ns.admin` on the namespace. Each of them can grant anything in it.";
+                    };
+                    readonly repoCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "How many repositories the VTC records in the namespace, in any state.";
+                    };
+                    readonly headless: {
+                        readonly type: "boolean";
+                        readonly description: "Bound, with no live admin: its last admin left or lapsed. Nobody can grant in it until an administrator reseats one (`git-ns/namespace/reseat`).";
+                    };
+                    readonly installationRemoved: {
+                        readonly type: "boolean";
+                        readonly description: "The bridge reported losing its access to the forge owner, and has not reported access since.";
+                    };
+                    readonly forgeStatus: {
+                        readonly $ref: "#/$defs/ForgeStatus";
+                    };
+                    readonly roleDrift: {
+                        readonly type: "string";
+                        readonly enum: readonly ["report", "enforce"];
+                        readonly description: "What the community's policy does with a forge role nobody granted: `report` it as drift for an administrator to resolve, or `enforce` the projection by reverting it. Community-wide; repeated on every namespace so that each row stands alone.";
+                    };
+                    readonly cascadeOnDeparture: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the community's policy revokes the grants a member made when that member leaves. Community-wide, as `roleDrift`.";
+                    };
+                    readonly roleMap: {
+                        readonly $ref: "#/$defs/RoleMap";
+                        readonly description: "The forge role each right projects to on a repository without a map of its own, as the serving bridge last reported it. Absent while `roleMapSource` is `unknown`: no map, the default included, is assumed.";
+                    };
+                    readonly roleMapSource: {
+                        readonly type: "string";
+                        readonly enum: readonly ["reported", "unknown"];
+                        readonly description: "`reported` — the bridge serving the namespace reported its role map. `unknown` — it has not, since the namespace was bound or came to be served by it.";
+                    };
+                    readonly roleMapReportedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "The `issuedAt` of the role-map report held, on the bridge's clock.";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Git Namespaces — List Namespaces — response payload";
+                readonly description: "The namespaces the caller administers, or the one asked for.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["namespaces"];
+                readonly properties: {
+                    readonly namespaces: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/NamespaceStatus";
+                        };
+                        readonly description: "Every administered namespace, `pending` ones included, ordered by `resource`. Empty only for a holder of the community-administrator capability on a VTC with no namespace.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly Did: {
+                readonly title: "Did";
+                readonly description: "A bare DID in the W3C DID Core syntax (§3.1): `did:`, a method name of lowercase letters and digits, `:`, and a method-specific id of colon-separated segments drawn from `A-Z a-z 0-9 . - _` and percent-encoded octets, the last segment non-empty. A DID URL is not a DID: no path, query or fragment (`/`, `?`, `#`), so a verification-method id such as `did:key:z6Mk…#z6Mk…` is refused. Compared by exact string equality — no case folding or percent-decoding. A consumer MUST still treat the value as data: the pattern keeps shell metacharacters, whitespace and quotes out of the wire form, but it does not make a DID safe to splice into a command or markup.";
+                readonly type: "string";
+                readonly maxLength: 2048;
+                readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
+            };
+            readonly ForgeId: {
+                readonly title: "ForgeId";
+                readonly description: "An identifier the forge itself assigns — a repository id, a user or organisation id — carried as a string so a forge whose ids are not numbers needs no new version. GitHub and Forgejo ids are decimal integers written as strings (`\"812736451\"`). Unlike a name, it survives renames and transfers, which is why rights and bindings are keyed by it.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+            };
+            readonly Resource: {
+                readonly title: "Resource";
+                readonly description: "A forge-qualified resource: `<forge-host>/<owner>` for a namespace, or `<forge-host>/<owner>/<repo>` for one repository, all lowercase — `github.com/acme`, `github.com/acme/widgets`, `codeberg.org/acme`. The forge is never implied: `acme/widgets` alone is not a resource. Containment is by whole segment: `github.com/acme` contains `github.com/acme/widgets` and does not contain `github.com/acme-labs/x` or `codeberg.org/acme/widgets`.";
+                readonly type: "string";
+                readonly maxLength: 455;
+                readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+(?:/[a-z0-9_-][a-z0-9._-]{0,99}){1,2}$";
+            };
+            readonly Segment: {
+                readonly title: "Segment";
+                readonly description: "One lowercased owner or repository name. Forges compare these case-insensitively, so the wire form is always lowercase and a producer lowercases before sending. A leading `.` is refused, which rules out `.` and `..`.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 100;
+                readonly pattern: "^[a-z0-9_-][a-z0-9._-]*$";
+            };
+            readonly ForgeHost: {
+                readonly title: "ForgeHost";
+                readonly description: "The lowercased DNS host of a forge: `github.com`, a GitHub Enterprise Server host, `codeberg.org`, or a self-hosted Forgejo instance such as `git.example.org`. No scheme, no port, no path. The host is a segment of every resource, so a right never crosses forges.";
+                readonly type: "string";
+                readonly minLength: 3;
+                readonly maxLength: 253;
+                readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$";
+            };
+            readonly NamespaceId: {
+                readonly title: "NamespaceId";
+                readonly description: "The VTC's opaque identifier for a namespace, assigned when it is bound. Stable for the life of the binding; never reused for another binding.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/git-ns/namespace/list/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly MappedRole: {
+                readonly title: "MappedRole";
+                readonly type: "string";
+                readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
+                readonly description: "A level of the bridge's forge-neutral role ladder, lowest first: the vocabulary role drift's `observed` and `expected` are reported in. `none` is no direct role on the repository.";
+            };
+            readonly RoleMap: {
+                readonly title: "RoleMap";
+                readonly description: "The forge role each repository right is given, as the forge applies it: after the forge's own ladder has rounded it down. `own` is the role `git.repo.own` projects to, `maintain` that of `git.repo.maintain`, `commit` that of `git.commit.sign` (`none` is fork-based contribution). There is no member for `git.ns.admin` or `git.repo.create`, which project to no forge role whatever a bridge is configured with. Ordered: `own` is at least `maintain`, which is at least `commit`, and `commit` is at most `write`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["own", "maintain", "commit"];
+                readonly properties: {
+                    readonly own: {
+                        readonly $ref: "#/$defs/MappedRole";
+                    };
+                    readonly maintain: {
+                        readonly $ref: "#/$defs/MappedRole";
+                    };
+                    readonly commit: {
+                        readonly $ref: "#/$defs/MappedRole";
+                    };
+                };
+            };
+            readonly ForgeStatus: {
+                readonly title: "ForgeStatus";
+                readonly description: "What the bridge serving the namespace last reported about its standing on the forge owner — its app, its installation and what the owner's plan allows. Display only: it changes no decision the VTC takes. Every member but `missingPermissions` is absent until the bridge reports it.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["missingPermissions"];
+                readonly properties: {
+                    readonly installationId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 64;
+                        readonly description: "The forge's identifier for its installation of the community's app (GitHub).";
+                    };
+                    readonly appName: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "The app's display name.";
+                    };
+                    readonly appSlug: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "The app's URL slug on the forge.";
+                    };
+                    readonly appRegistration: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "Where the app's manifest registration stands, in the bridge's words (`registered`, `pending`).";
+                    };
+                    readonly missingPermissions: {
+                        readonly type: "array";
+                        readonly maxItems: 256;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 128;
+                        };
+                        readonly description: "Permissions the app needs and the installation has not granted, in the forge's vocabulary. Empty when none are missing, or none were reported.";
+                    };
+                    readonly permissionUpgradePending: {
+                        readonly type: "boolean";
+                        readonly description: "A new version of the app asks for permissions the forge owner has not approved yet.";
+                    };
+                    readonly orgRulesets: {
+                        readonly type: "boolean";
+                        readonly description: "Organisation rulesets are available on the owner's plan.";
+                    };
+                    readonly requiredWorkflow: {
+                        readonly type: "boolean";
+                        readonly description: "The organisation ruleset requiring the verify-trust workflow is in force.";
+                    };
+                    readonly bridgePostedCheck: {
+                        readonly type: "boolean";
+                        readonly description: "The bridge can post the verify-trust check itself, the fallback where no required workflow is available.";
+                    };
+                    readonly reportedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the VTC received the report.";
+                    };
+                };
+            };
+            readonly NamespaceStatus: {
+                readonly title: "NamespaceStatus";
+                readonly description: "One namespace as its administrators govern it: the binding, who administers it, how many repositories it holds, and what its bridge last reported.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "forge", "owner", "resource", "mode", "state", "boundBy", "requestedAt", "admins", "repoCount", "headless", "installationRemoved", "roleDrift", "cascadeOnDeparture", "roleMapSource"];
+                readonly properties: {
+                    readonly id: {
+                        readonly $ref: "#/$defs/NamespaceId";
+                    };
+                    readonly forge: {
+                        readonly $ref: "#/$defs/ForgeHost";
+                    };
+                    readonly owner: {
+                        readonly $ref: "#/$defs/Segment";
+                        readonly description: "The organisation or user on the forge, lowercased.";
+                    };
+                    readonly resource: {
+                        readonly $ref: "#/$defs/Resource";
+                        readonly description: "The namespace as a resource: `<forge>/<owner>`.";
+                    };
+                    readonly mode: {
+                        readonly type: "string";
+                        readonly enum: readonly ["bridge", "manual"];
+                        readonly description: "As `GitNamespace.mode` in the shared schema.";
+                    };
+                    readonly state: {
+                        readonly type: "string";
+                        readonly enum: readonly ["pending", "bound"];
+                        readonly description: "As `GitNamespace.state` in the shared schema.";
+                    };
+                    readonly kind: {
+                        readonly type: "string";
+                        readonly enum: readonly ["organization", "user"];
+                        readonly description: "Whether the owner is an organisation or a personal account, once the forge has said.";
+                    };
+                    readonly ownerId: {
+                        readonly $ref: "#/$defs/ForgeId";
+                        readonly description: "The forge's id for the owner, once the forge has said. Unlike `owner`, it survives a rename.";
+                    };
+                    readonly bridgeDid: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The bridge that serves the namespace. Absent in manual mode.";
+                    };
+                    readonly boundBy: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "Who bound it.";
+                    };
+                    readonly requestedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When binding was requested.";
+                    };
+                    readonly boundAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When binding completed. Absent while `pending`.";
+                    };
+                    readonly admins: {
+                        readonly type: "array";
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly $ref: "#/$defs/Did";
+                        };
+                        readonly description: "Everyone holding a live, explicitly recorded `git.ns.admin` on the namespace. Each of them can grant anything in it.";
+                    };
+                    readonly repoCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "How many repositories the VTC records in the namespace, in any state.";
+                    };
+                    readonly headless: {
+                        readonly type: "boolean";
+                        readonly description: "Bound, with no live admin: its last admin left or lapsed. Nobody can grant in it until an administrator reseats one (`git-ns/namespace/reseat`).";
+                    };
+                    readonly installationRemoved: {
+                        readonly type: "boolean";
+                        readonly description: "The bridge reported losing its access to the forge owner, and has not reported access since.";
+                    };
+                    readonly forgeStatus: {
+                        readonly $ref: "#/$defs/ForgeStatus";
+                    };
+                    readonly roleDrift: {
+                        readonly type: "string";
+                        readonly enum: readonly ["report", "enforce"];
+                        readonly description: "What the community's policy does with a forge role nobody granted: `report` it as drift for an administrator to resolve, or `enforce` the projection by reverting it. Community-wide; repeated on every namespace so that each row stands alone.";
+                    };
+                    readonly cascadeOnDeparture: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the community's policy revokes the grants a member made when that member leaves. Community-wide, as `roleDrift`.";
+                    };
+                    readonly roleMap: {
+                        readonly $ref: "#/$defs/RoleMap";
+                        readonly description: "The forge role each right projects to on a repository without a map of its own, as the serving bridge last reported it. Absent while `roleMapSource` is `unknown`: no map, the default included, is assumed.";
+                    };
+                    readonly roleMapSource: {
+                        readonly type: "string";
+                        readonly enum: readonly ["reported", "unknown"];
+                        readonly description: "`reported` — the bridge serving the namespace reported its role map. `unknown` — it has not, since the namespace was bound or came to be served by it.";
+                    };
+                    readonly roleMapReportedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "The `issuedAt` of the role-map report held, on the bridge's clock.";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Git Namespaces — List Namespaces — response payload";
+                readonly description: "The namespaces the caller administers, or the one asked for.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["namespaces"];
+                readonly properties: {
+                    readonly namespaces: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/NamespaceStatus";
+                        };
+                        readonly description: "Every administered namespace, `pending` ones included, ordered by `resource`. Empty only for a holder of the community-administrator capability on a VTC with no namespace.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly Did: {
+                readonly title: "Did";
+                readonly description: "A bare DID in the W3C DID Core syntax (§3.1): `did:`, a method name of lowercase letters and digits, `:`, and a method-specific id of colon-separated segments drawn from `A-Z a-z 0-9 . - _` and percent-encoded octets, the last segment non-empty. A DID URL is not a DID: no path, query or fragment (`/`, `?`, `#`), so a verification-method id such as `did:key:z6Mk…#z6Mk…` is refused. Compared by exact string equality — no case folding or percent-decoding. A consumer MUST still treat the value as data: the pattern keeps shell metacharacters, whitespace and quotes out of the wire form, but it does not make a DID safe to splice into a command or markup.";
+                readonly type: "string";
+                readonly maxLength: 2048;
+                readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
+            };
+            readonly ForgeId: {
+                readonly title: "ForgeId";
+                readonly description: "An identifier the forge itself assigns — a repository id, a user or organisation id — carried as a string so a forge whose ids are not numbers needs no new version. GitHub and Forgejo ids are decimal integers written as strings (`\"812736451\"`). Unlike a name, it survives renames and transfers, which is why rights and bindings are keyed by it.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+            };
+            readonly Resource: {
+                readonly title: "Resource";
+                readonly description: "A forge-qualified resource: `<forge-host>/<owner>` for a namespace, or `<forge-host>/<owner>/<repo>` for one repository, all lowercase — `github.com/acme`, `github.com/acme/widgets`, `codeberg.org/acme`. The forge is never implied: `acme/widgets` alone is not a resource. Containment is by whole segment: `github.com/acme` contains `github.com/acme/widgets` and does not contain `github.com/acme-labs/x` or `codeberg.org/acme/widgets`.";
+                readonly type: "string";
+                readonly maxLength: 455;
+                readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+(?:/[a-z0-9_-][a-z0-9._-]{0,99}){1,2}$";
+            };
+            readonly Segment: {
+                readonly title: "Segment";
+                readonly description: "One lowercased owner or repository name. Forges compare these case-insensitively, so the wire form is always lowercase and a producer lowercases before sending. A leading `.` is refused, which rules out `.` and `..`.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 100;
+                readonly pattern: "^[a-z0-9_-][a-z0-9._-]*$";
+            };
+            readonly ForgeHost: {
+                readonly title: "ForgeHost";
+                readonly description: "The lowercased DNS host of a forge: `github.com`, a GitHub Enterprise Server host, `codeberg.org`, or a self-hosted Forgejo instance such as `git.example.org`. No scheme, no port, no path. The host is a segment of every resource, so a right never crosses forges.";
+                readonly type: "string";
+                readonly minLength: 3;
+                readonly maxLength: 253;
+                readonly pattern: "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$";
+            };
+            readonly NamespaceId: {
+                readonly title: "NamespaceId";
+                readonly description: "The VTC's opaque identifier for a namespace, assigned when it is bound. Stable for the life of the binding; never reused for another binding.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map