@openvtc/trust-tasks 0.28.12 → 0.28.13

package/src/vtc/boards/show/0.1/payload.ts

@@ -0,0 +1,2212 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/boards/show/0.1/payload.schema.json
+ */
+
+import type { Author, Board, BoardAudience, BoardDescription, BoardHead, BoardId, BoardStatus, BoardTitle, BoardVisibility, ChoiceQuestion, DigestMultibase, ElectionId, ElectionResult, ElectionState, ElectionTemplate, EntryId, Ext, GroupId, Idea, IdeaDecision, IdeaDescription, IdeaElection, IdeaFormat, IdeaId, IdeaOpening, IdeaState, IdeaTitle, Key_VotingV0_1 as Key, Question, QuestionOption, QuestionResult, RankingQuestion, Reason_VtcBoardsV0_1 as Reason, Revote, ScoreQuestion, SecrecyLevel, Slot_VtcBoardsV0_1 as Slot, TextQuestion, Topic_VtcBoardsV0_1 as Topic, Trustees, Window } from "../../../../_shared/components.js";
+
+
+/**
+ * Show one board and its ideas as the caller may see them, with each accepted idea's election stage, ballot count where its board is public, and result once tallied — never who took a ticket or voted. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export interface VTCBoardsShowPayload {
+  boardId: BoardId;
+  /**
+   * @minItems 1
+   */
+  state?: [IdeaState, ...IdeaState[]];
+  topic?: Topic;
+  /**
+   * An opaque continuation token from a previous response's `nextCursor`, bound to the caller and the filters; a responder MUST NOT accept a cursor it did not issue.
+   */
+  cursor?: string;
+  /**
+   * The most items to return, at most 200; the responder chooses a default (50) and MAY return fewer.
+   */
+  limit?: number;
+  ext?: Ext;
+}
+/**
+ * The success response to a vtc/boards/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/boards/show/0.1#response.
+ */
+export interface VTCBoardsShowResponsePayload {
+  board: Board;
+  ideas: Idea[];
+  /**
+   * Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`.
+   */
+  nextCursor?: string;
+  ext?: Ext;
+}
+
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Author, Board, BoardAudience, BoardDescription, BoardHead, BoardId, BoardStatus, BoardTitle, BoardVisibility, ChoiceQuestion, DigestMultibase, ElectionId, ElectionResult, ElectionState, ElectionTemplate, EntryId, Ext, GroupId, Idea, IdeaDecision, IdeaDescription, IdeaElection, IdeaFormat, IdeaId, IdeaOpening, IdeaState, IdeaTitle, Key, Question, QuestionOption, QuestionResult, RankingQuestion, Reason, Revote, ScoreQuestion, SecrecyLevel, Slot, TextQuestion, Topic, Trustees, Window };
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/vtc/boards/show/0.1" as const;
+
+/**
+ * The earlier version of this specification that this one declares it
+ * extends (front matter `extends`, SPEC §5.2 "Declared extension"), or
+ * `null`. Only the direct declaration — follow the chain with
+ * `extendsChain` / `readForSpec`.
+ */
+export const EXTENDS: string | null = null;
+
+/**
+ * Why this version is deprecated, or `null` while it is current. A
+ * superseded or retired version is still supported, and is withdrawn from
+ * this package in a later scheduled batch (SPEC "Superseded and Withdrawn
+ * Versions").
+ */
+export const DEPRECATION: string | null = null;
+
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCBoardsShowPayload;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/boards/show/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCBoardsShowResponsePayload;
+
+/**
+ * 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 const PAYLOAD_SCHEMA = {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trusttasks.org/spec/vtc/boards/show/0.1",
+  "title": "VTC Boards — Show — payload",
+  "description": "Show one board and its ideas as the caller may see them, with each accepted idea's election stage, ballot count where its board is public, and result once tallied — never who took a ticket or voted. The outer document members are owned by the framework — SPEC §6.3.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "boardId"
+  ],
+  "properties": {
+    "boardId": {
+      "$ref": "#/$defs/BoardId"
+    },
+    "state": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/$defs/IdeaState"
+      }
+    },
+    "topic": {
+      "$ref": "#/$defs/Topic"
+    },
+    "cursor": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "description": "An opaque continuation token from a previous response's `nextCursor`, bound to the caller and the filters; a responder MUST NOT accept a cursor it did not issue."
+    },
+    "limit": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 200,
+      "description": "The most items to return, at most 200; the responder chooses a default (50) and MAY return fewer."
+    },
+    "ext": {
+      "$ref": "#/$defs/Ext"
+    }
+  },
+  "$defs": {
+    "Response": {
+      "$anchor": "response",
+      "title": "VTC Boards — Show — response payload",
+      "description": "The success response to a vtc/boards/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/boards/show/0.1#response.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "board",
+        "ideas"
+      ],
+      "properties": {
+        "board": {
+          "$ref": "#/$defs/Board"
+        },
+        "ideas": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Idea"
+          }
+        },
+        "nextCursor": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`."
+        },
+        "ext": {
+          "$ref": "#/$defs/Ext"
+        }
+      }
+    },
+    "Ext": {
+      "title": "Ext",
+      "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.",
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+      }
+    },
+    "Idea": {
+      "title": "Idea",
+      "description": "An idea as one caller may see it.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ideaId",
+        "boardId",
+        "state",
+        "title",
+        "description",
+        "proposer",
+        "proposedAt",
+        "noteCount"
+      ],
+      "properties": {
+        "ideaId": {
+          "$ref": "#/$defs/IdeaId"
+        },
+        "boardId": {
+          "$ref": "#/$defs/BoardId"
+        },
+        "state": {
+          "$ref": "#/$defs/IdeaState"
+        },
+        "title": {
+          "$ref": "#/$defs/IdeaTitle"
+        },
+        "description": {
+          "$ref": "#/$defs/IdeaDescription"
+        },
+        "format": {
+          "$ref": "#/$defs/IdeaFormat"
+        },
+        "topic": {
+          "$ref": "#/$defs/Topic"
+        },
+        "proposer": {
+          "$ref": "#/$defs/Author"
+        },
+        "proposedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "noteCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Notes on the idea the caller may read."
+        },
+        "election": {
+          "$ref": "#/$defs/IdeaElection",
+          "description": "Present once an election was opened for the idea."
+        },
+        "opening": {
+          "$ref": "#/$defs/IdeaOpening"
+        },
+        "decision": {
+          "$ref": "#/$defs/IdeaDecision",
+          "description": "Present in `declined`, `merged`, `selected` and `notSelected`."
+        }
+      }
+    },
+    "IdeaDecision": {
+      "title": "IdeaDecision",
+      "description": "A facilitator's decision on an idea: declining or merging it (VTI-BRD-013), or selecting it or not (VTI-BRD-040). The deciding facilitator is not named to the audience.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "decidedAt"
+      ],
+      "properties": {
+        "decidedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "reason": {
+          "$ref": "#/$defs/Reason"
+        },
+        "mergedInto": {
+          "$ref": "#/$defs/IdeaId",
+          "description": "Present exactly when the idea is `merged`."
+        },
+        "slotId": {
+          "$ref": "#/$defs/Key",
+          "description": "A `selected` idea's place in the board's timetable, where it has one."
+        },
+        "departsFromRule": {
+          "type": "boolean",
+          "description": "`selected` or `notSelected` only: whether the facilitator said the decision departs from the board's `selectionRule` (VTI-BRD-041); `reason` then says why."
+        },
+        "ownIdea": {
+          "const": true,
+          "description": "Present when a facilitator decided their own idea because no other facilitator existed (VTI-BRD-013)."
+        }
+      }
+    },
+    "IdeaId": {
+      "title": "IdeaId",
+      "description": "Opaque identifier of an idea: `ida_` followed by 16 to 64 base64url characters. Random and unique within the community.",
+      "type": "string",
+      "pattern": "^ida_[A-Za-z0-9_-]{16,64}$"
+    },
+    "Reason": {
+      "title": "Reason",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500,
+      "description": "A facilitator's stated reason, shown to the board's audience with the decision it explains. Plain text."
+    },
+    "Key": {
+      "title": "Key",
+      "description": "A question or option key, unique within its manifest or question.",
+      "type": "string",
+      "pattern": "^[A-Za-z0-9._-]{1,64}$"
+    },
+    "IdeaOpening": {
+      "title": "IdeaOpening",
+      "description": "Shown to facilitators only: an accepted idea whose election the ballot box has not yet registered, so the idea is still `proposed` (VTI-BRD-031). `refusal` is the ballot box's or community's refusal of the last attempt, after which the idea is no longer being opened.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "startedAt"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the facilitator accepted the idea."
+        },
+        "refusal": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "code",
+            "refusedAt"
+          ],
+          "properties": {
+            "code": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "refusedAt": {
+              "type": "string",
+              "format": "date-time"
+            }
+          }
+        }
+      }
+    },
+    "ElectionId": {
+      "title": "ElectionId",
+      "description": "An election's identifier, unique within its community. A closed alphabet: it appears in the ticket class label `voter/<electionId>` and is framed into every hash a cast is bound to.",
+      "type": "string",
+      "pattern": "^[A-Za-z0-9._-]{1,128}$"
+    },
+    "IdeaElection": {
+      "title": "IdeaElection",
+      "description": "An idea's election as a board shows it (VTI-BRD-033): never who took a ticket or cast a ballot.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "state"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "state": {
+          "$ref": "#/$defs/ElectionState"
+        },
+        "ballotsOnBoard": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "The ballot box's latest board head's ballot count, where its board is public (VTI-VOT-052); absent otherwise. Counts ballots, not voters, where a later ballot replaces an earlier one."
+        },
+        "boardHeadIssuedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the head `ballotsOnBoard` was read from was issued."
+        },
+        "result": {
+          "$ref": "#/$defs/ElectionResult",
+          "description": "Present once the election is tallied."
+        },
+        "certified": {
+          "type": "boolean",
+          "description": "Present with `result`: whether the community certified it (VTI-VOT-071)."
+        }
+      }
+    },
+    "ElectionResult": {
+      "title": "ElectionResult",
+      "description": "An election's result, computable by anyone who can read its board from the board and the registration alone (VTI-VOT-070).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "manifestDigest",
+        "ballotsCounted",
+        "questions",
+        "head"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "manifestDigest": {
+          "$ref": "#/$defs/DigestMultibase"
+        },
+        "ballotsCounted": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "questions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/QuestionResult"
+          }
+        },
+        "head": {
+          "$ref": "#/$defs/BoardHead",
+          "description": "The head of the board as it stood at close: the result counts exactly its entries."
+        }
+      }
+    },
+    "BoardHead": {
+      "title": "BoardHead",
+      "description": "A board's tree head (RFC 9162 §2.1). A head is signed by being carried in a document the ballot box signs; whoever keeps a head keeps that whole document.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "treeSize",
+        "rootHash",
+        "issuedAt"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "treeSize": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "rootHash": {
+          "$ref": "#/$defs/DigestMultibase",
+          "description": "The RFC 9162 Merkle tree hash (SHA-256) of the first `treeSize` entries, as a multihash."
+        },
+        "issuedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "DigestMultibase": {
+      "title": "DigestMultibase",
+      "description": "A cryptographic digest as a multibase-encoded multihash — the encoding the W3C Verifiable Credentials Data Model 2.0 defines for `digestMultibase`, and the one `did:webvh` uses for its SCID and entry hashes.\n\nMultihash carries the hash algorithm in-band, so the value is self-describing and the wire format survives an algorithm change without a schema revision; multibase does the same for the base encoding, so a verifier never infers base58 from base64url by context. A bare hex string or a `sha-256:`-style prefix hard-codes one algorithm into the wire contract and is non-conforming here.\n\nThis definition constrains the *encoding only*. What the digest is computed over is stated by each referencing field, because it differs legitimately: a digest over a JSON document is taken over its RFC 8785 (JCS) canonicalization, while a digest over an opaque artifact is taken over its bytes. A field whose input is a JSON document and which does not name a canonicalization is not reproducible.\n\nRestricted to the two multibase headers W3C Controlled Identifiers 1.0 §2.4 normatively requires — `z` (base58btc) and `u` (base64url-no-pad). CID permits others but states that \"interoperability is not guaranteed between implementations using such values\", and a registry whose purpose is interoperability should not mint digests a conforming verifier may be unable to read. The alphabets are enforced rather than assumed: base58btc excludes 0, O, I and l, and an earlier permissive pattern let three published examples carry digests that were not valid base58 at all. base58btc is RECOMMENDED, for consistency with `did:key` and `did:webvh`.",
+      "type": "string",
+      "minLength": 16,
+      "pattern": "^(z[1-9A-HJ-NP-Za-km-z]+|u[A-Za-z0-9_-]+)$",
+      "examples": [
+        "zQmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR"
+      ]
+    },
+    "QuestionResult": {
+      "title": "QuestionResult",
+      "description": "One question's totals. `choice`: selections per option. `ranking`: per option, how many ballots placed it at each position (index 0 = first). `score`: per option, the sum and the number of ballots that scored it. `text`: the answers, in board order, withheld (`withheld: true`) below the manifest's `textReleaseThreshold`. `abstained` counts ballots that left the question unanswered.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "question",
+        "abstained"
+      ],
+      "properties": {
+        "question": {
+          "$ref": "#/$defs/Key"
+        },
+        "abstained": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "choice": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/Key"
+          },
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "ranking": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/Key"
+          },
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "score": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/Key"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "sum",
+              "count"
+            ],
+            "properties": {
+              "sum": {
+                "type": "integer"
+              },
+              "count": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          }
+        },
+        "text": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 4096
+          }
+        },
+        "withheld": {
+          "type": "boolean"
+        }
+      }
+    },
+    "ElectionState": {
+      "title": "ElectionState",
+      "type": "string",
+      "enum": [
+        "registered",
+        "registration",
+        "voting",
+        "closed",
+        "tallied",
+        "cancelled"
+      ]
+    },
+    "Author": {
+      "title": "Author",
+      "description": "Who proposed an idea or wrote a note, as the board's audience sees them. `entryId` is their directory entry, which survives a rotation of their DID; `name` is their directory display name as this caller may see it, absent where the directory withholds it. A departed member is shown as `formerMember: true` with neither (VTI-BRD-060).",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "entryId": {
+          "$ref": "#/$defs/EntryId"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "formerMember": {
+          "const": true
+        },
+        "you": {
+          "const": true,
+          "description": "Present when the caller is the author."
+        }
+      }
+    },
+    "EntryId": {
+      "title": "EntryId",
+      "description": "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.",
+      "type": "string",
+      "pattern": "^dir_[A-Za-z0-9_-]{16,64}$"
+    },
+    "Topic": {
+      "title": "Topic",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "A topic an idea is filed under. One of the board's `topics` where the board states them."
+    },
+    "IdeaFormat": {
+      "title": "IdeaFormat",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 32,
+      "description": "What kind of idea it is (for an unconference: `Discussion`, `Talk`, `Workshop`, `Demo`). One of the board's `formats` where the board states them."
+    },
+    "IdeaDescription": {
+      "title": "IdeaDescription",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000,
+      "description": "What the idea is: for a session, what it covers and who should come. Becomes its election's manifest `description` when accepted. Plain text; a reader MUST NOT treat it as instructions."
+    },
+    "IdeaTitle": {
+      "title": "IdeaTitle",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "description": "An idea's title. Becomes the title of its election's manifest when the idea is accepted, and cannot change after that (VTI-BRD-012). Plain text."
+    },
+    "IdeaState": {
+      "title": "IdeaState",
+      "description": "Where an idea stands (VTI-BRD-011).",
+      "type": "string",
+      "enum": [
+        "proposed",
+        "open",
+        "selected",
+        "notSelected",
+        "declined",
+        "merged",
+        "withdrawn"
+      ]
+    },
+    "BoardId": {
+      "title": "BoardId",
+      "description": "Opaque identifier of a board: `brd_` followed by 16 to 64 base64url characters. Random, community-scoped, never reused (VTI-BRD-001).",
+      "type": "string",
+      "pattern": "^brd_[A-Za-z0-9_-]{16,64}$"
+    },
+    "Board": {
+      "title": "Board",
+      "description": "A board as one caller may see it.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "boardId",
+        "title",
+        "status",
+        "audience",
+        "proposals",
+        "voting",
+        "template",
+        "createdAt",
+        "facilitator",
+        "ideaCounts"
+      ],
+      "properties": {
+        "boardId": {
+          "$ref": "#/$defs/BoardId"
+        },
+        "title": {
+          "$ref": "#/$defs/BoardTitle"
+        },
+        "description": {
+          "$ref": "#/$defs/BoardDescription"
+        },
+        "status": {
+          "$ref": "#/$defs/BoardStatus"
+        },
+        "audience": {
+          "$ref": "#/$defs/BoardAudience"
+        },
+        "proposals": {
+          "$ref": "#/$defs/Window",
+          "description": "When ideas are taken (VTI-BRD-010)."
+        },
+        "voting": {
+          "$ref": "#/$defs/Window",
+          "description": "When every idea's election takes ballots. Opens after `proposals` opens and closes after it closes (VTI-BRD-001)."
+        },
+        "topics": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/Topic"
+          }
+        },
+        "formats": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/IdeaFormat"
+          }
+        },
+        "maxIdeasPerMember": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "description": "The most ideas one member may have on the board that are not `withdrawn` or `declined`. Absent: no limit beyond the community's own."
+        },
+        "selectionRule": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "How facilitators intend to select, in plain words (VTI-BRD-041), e.g. \"The twelve ideas the most members would attend\"."
+        },
+        "timetable": {
+          "type": "array",
+          "maxItems": 256,
+          "items": {
+            "$ref": "#/$defs/Slot"
+          }
+        },
+        "template": {
+          "$ref": "#/$defs/ElectionTemplate"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "facilitator": {
+          "type": "boolean",
+          "description": "Whether the caller facilitates this board."
+        },
+        "ideaCounts": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "How many of the board's ideas are in each state the caller may see.",
+          "properties": {
+            "proposed": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "open": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "selected": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "notSelected": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "declined": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "merged": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "withdrawn": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        }
+      }
+    },
+    "ElectionTemplate": {
+      "title": "ElectionTemplate",
+      "description": "Every member of an idea's election manifest that the board fixes (VTI-BRD-030). When a facilitator accepts an idea the community completes it: `electionId` (naming the board and the idea), `community`, `title` and `description` from the idea, `registrationOpensAt` and `votingOpensAt` from the board's voting window's `opensAt` or the acceptance, whichever is later, `votingClosesAt` from its `closesAt`, `roll` from the board's audience (rule `members`, or a credential roll naming the group), and `binding: false`. A board's template is never binding, and so has no `binding` member.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "questions",
+        "secrecy",
+        "revote",
+        "board",
+        "ballotBox",
+        "allowEarlyClose",
+        "resultsBeforeClose",
+        "textReleaseThreshold"
+      ],
+      "properties": {
+        "questions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "items": {
+            "$ref": "#/$defs/Question"
+          }
+        },
+        "secrecy": {
+          "$ref": "#/$defs/SecrecyLevel"
+        },
+        "revote": {
+          "$ref": "#/$defs/Revote"
+        },
+        "board": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "visibility",
+            "auditors"
+          ],
+          "description": "The ballot box's board for each idea's election, as a manifest states it (VTI-VOT-052). `public` lets a board show each idea's ballot count while voting is open (VTI-BRD-033).",
+          "properties": {
+            "visibility": {
+              "$ref": "#/$defs/BoardVisibility"
+            },
+            "auditors": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 2048
+              }
+            }
+          }
+        },
+        "ballotBox": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2048,
+          "description": "The DID of the voting service every idea's election is registered with; one on the community's list (VTI-VOT-082)."
+        },
+        "trustees": {
+          "$ref": "#/$defs/Trustees"
+        },
+        "allowEarlyClose": {
+          "type": "boolean"
+        },
+        "resultsBeforeClose": {
+          "type": "boolean",
+          "description": "Open elections only: whether running totals may be read while voting is open (VTI-VOT-061). A board SHOULD set it false (VTI-BRD-033)."
+        },
+        "textReleaseThreshold": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Counted ballots required before any text answer is disclosed (VTI-VOT-065); SHOULD be at least 10."
+        }
+      }
+    },
+    "Trustees": {
+      "title": "Trustees",
+      "description": "The trustees of a sealed or tallied-encrypted election and the number of them decryption needs (VTI-VOT-062). Neither the community nor the ballot box may be one.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "dids",
+        "threshold"
+      ],
+      "properties": {
+        "dids": {
+          "type": "array",
+          "minItems": 2,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 2048
+          },
+          "uniqueItems": true
+        },
+        "threshold": {
+          "type": "integer",
+          "minimum": 2
+        }
+      }
+    },
+    "BoardVisibility": {
+      "title": "BoardVisibility",
+      "description": "`public`: anyone reads the board. `private`: the community, the auditors the manifest names and, for one cast's inclusion, the holder of its receipt (VTI-VOT-052).",
+      "type": "string",
+      "enum": [
+        "public",
+        "private"
+      ]
+    },
+    "Revote": {
+      "title": "Revote",
+      "description": "What a later, different ballot under one ticket does: `replace` the earlier one, or be refused (`refuse`) (VTI-VOT-041).",
+      "type": "string",
+      "enum": [
+        "replace",
+        "refuse"
+      ]
+    },
+    "SecrecyLevel": {
+      "title": "SecrecyLevel",
+      "description": "`open`: ballots are recorded on the board as cast. `sealed`: ballots are encrypted to a jointly generated election key and decrypted after voting closes. `talliedEncrypted`: ballots are encrypted and only the totals are ever decrypted (VTI-VOT-060). The encrypted levels are cast with `voting/ballot/cast-encrypted/0.1`, under an election key the trustees generate with `voting/trustees/*` (CONVENTIONS §9).",
+      "type": "string",
+      "enum": [
+        "open",
+        "sealed",
+        "talliedEncrypted"
+      ]
+    },
+    "Question": {
+      "title": "Question",
+      "description": "One question. Tagged union over `type`.",
+      "oneOf": [
+        {
+          "title": "ChoiceQuestion",
+          "description": "Select between `minSelections` and `maxSelections` of `options`. A yes/no/abstain motion is a choice of exactly one of three.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "options",
+            "minSelections",
+            "maxSelections",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "choice"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "options": {
+              "type": "array",
+              "minItems": 2,
+              "maxItems": 256,
+              "items": {
+                "$ref": "#/$defs/QuestionOption"
+              }
+            },
+            "minSelections": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "maxSelections": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "title": "RankingQuestion",
+          "description": "Order `options`; a ballot ranks every option or, when `partial` is true, a prefix of them.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "options",
+            "partial",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "ranking"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "options": {
+              "type": "array",
+              "minItems": 2,
+              "maxItems": 64,
+              "items": {
+                "$ref": "#/$defs/QuestionOption"
+              }
+            },
+            "partial": {
+              "type": "boolean"
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "title": "ScoreQuestion",
+          "description": "Give each option an integer score within [min, max].",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "options",
+            "min",
+            "max",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "score"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "options": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 256,
+              "items": {
+                "$ref": "#/$defs/QuestionOption"
+              }
+            },
+            "min": {
+              "type": "integer"
+            },
+            "max": {
+              "type": "integer"
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "title": "TextQuestion",
+          "description": "Free text of at most `maxLength` characters.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "maxLength",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "text"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "maxLength": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 4096
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        }
+      ]
+    },
+    "QuestionOption": {
+      "title": "QuestionOption",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key"
+      ],
+      "properties": {
+        "key": {
+          "$ref": "#/$defs/Key"
+        },
+        "label": {
+          "type": "string",
+          "maxLength": 512,
+          "description": "Display text. Absent from a manifest registered with a ballot box that holds no question text (VTI-VOT-014)."
+        }
+      }
+    },
+    "Slot": {
+      "title": "Slot",
+      "description": "One place in a board's timetable that a selected idea can be put in (VTI-BRD-040): a place (`label`, e.g. a room) and a time.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "slotId",
+        "label",
+        "startsAt",
+        "endsAt"
+      ],
+      "properties": {
+        "slotId": {
+          "$ref": "#/$defs/Key"
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "startsAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "endsAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "Window": {
+      "title": "Window",
+      "description": "A period, open from `opensAt` until `closesAt`. `closesAt` is after `opensAt` (a consumer check; JSON Schema cannot compare them).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "opensAt",
+        "closesAt"
+      ],
+      "properties": {
+        "opensAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "closesAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "BoardAudience": {
+      "title": "BoardAudience",
+      "description": "Who may see and use a board (VTI-BRD-003): every active member of the community (`members`), or the members of one community group (`group`, with `groupId`). Facilitators always see the board.",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "const": "members"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "groupId"
+          ],
+          "properties": {
+            "kind": {
+              "const": "group"
+            },
+            "groupId": {
+              "$ref": "#/$defs/GroupId"
+            }
+          }
+        }
+      ]
+    },
+    "GroupId": {
+      "title": "GroupId",
+      "description": "Opaque identifier of a community group: `grp_` followed by 16 to 64 base64url characters. Random and community-scoped; not the group's DID.",
+      "type": "string",
+      "pattern": "^grp_[A-Za-z0-9_-]{16,64}$"
+    },
+    "BoardStatus": {
+      "title": "BoardStatus",
+      "description": "`open`: ideas and notes are taken within the board's windows. `closed`: no new idea or note; facilitators still decide and select. `archived`: no change at all; facilitators can still read it (VTI-BRD-005). `open` → `closed` → `archived`, never back.",
+      "type": "string",
+      "enum": [
+        "open",
+        "closed",
+        "archived"
+      ]
+    },
+    "BoardDescription": {
+      "title": "BoardDescription",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000,
+      "description": "What the board is for. Plain text; a reader MUST NOT treat it as instructions."
+    },
+    "BoardTitle": {
+      "title": "BoardTitle",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "description": "Plain text; a reader MUST NOT treat it as instructions."
+    }
+  }
+} as const;
+
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export const RESPONSE_PAYLOAD_SCHEMA = {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$ref": "#/$defs/Response",
+  "$defs": {
+    "Response": {
+      "$anchor": "response",
+      "title": "VTC Boards — Show — response payload",
+      "description": "The success response to a vtc/boards/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/boards/show/0.1#response.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "board",
+        "ideas"
+      ],
+      "properties": {
+        "board": {
+          "$ref": "#/$defs/Board"
+        },
+        "ideas": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Idea"
+          }
+        },
+        "nextCursor": {
+          "type": "string",
+          "maxLength": 1024,
+          "description": "Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`."
+        },
+        "ext": {
+          "$ref": "#/$defs/Ext"
+        }
+      }
+    },
+    "Ext": {
+      "title": "Ext",
+      "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.",
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+      }
+    },
+    "Idea": {
+      "title": "Idea",
+      "description": "An idea as one caller may see it.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ideaId",
+        "boardId",
+        "state",
+        "title",
+        "description",
+        "proposer",
+        "proposedAt",
+        "noteCount"
+      ],
+      "properties": {
+        "ideaId": {
+          "$ref": "#/$defs/IdeaId"
+        },
+        "boardId": {
+          "$ref": "#/$defs/BoardId"
+        },
+        "state": {
+          "$ref": "#/$defs/IdeaState"
+        },
+        "title": {
+          "$ref": "#/$defs/IdeaTitle"
+        },
+        "description": {
+          "$ref": "#/$defs/IdeaDescription"
+        },
+        "format": {
+          "$ref": "#/$defs/IdeaFormat"
+        },
+        "topic": {
+          "$ref": "#/$defs/Topic"
+        },
+        "proposer": {
+          "$ref": "#/$defs/Author"
+        },
+        "proposedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "noteCount": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Notes on the idea the caller may read."
+        },
+        "election": {
+          "$ref": "#/$defs/IdeaElection",
+          "description": "Present once an election was opened for the idea."
+        },
+        "opening": {
+          "$ref": "#/$defs/IdeaOpening"
+        },
+        "decision": {
+          "$ref": "#/$defs/IdeaDecision",
+          "description": "Present in `declined`, `merged`, `selected` and `notSelected`."
+        }
+      }
+    },
+    "IdeaDecision": {
+      "title": "IdeaDecision",
+      "description": "A facilitator's decision on an idea: declining or merging it (VTI-BRD-013), or selecting it or not (VTI-BRD-040). The deciding facilitator is not named to the audience.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "decidedAt"
+      ],
+      "properties": {
+        "decidedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "reason": {
+          "$ref": "#/$defs/Reason"
+        },
+        "mergedInto": {
+          "$ref": "#/$defs/IdeaId",
+          "description": "Present exactly when the idea is `merged`."
+        },
+        "slotId": {
+          "$ref": "#/$defs/Key",
+          "description": "A `selected` idea's place in the board's timetable, where it has one."
+        },
+        "departsFromRule": {
+          "type": "boolean",
+          "description": "`selected` or `notSelected` only: whether the facilitator said the decision departs from the board's `selectionRule` (VTI-BRD-041); `reason` then says why."
+        },
+        "ownIdea": {
+          "const": true,
+          "description": "Present when a facilitator decided their own idea because no other facilitator existed (VTI-BRD-013)."
+        }
+      }
+    },
+    "IdeaId": {
+      "title": "IdeaId",
+      "description": "Opaque identifier of an idea: `ida_` followed by 16 to 64 base64url characters. Random and unique within the community.",
+      "type": "string",
+      "pattern": "^ida_[A-Za-z0-9_-]{16,64}$"
+    },
+    "Reason": {
+      "title": "Reason",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 500,
+      "description": "A facilitator's stated reason, shown to the board's audience with the decision it explains. Plain text."
+    },
+    "Key": {
+      "title": "Key",
+      "description": "A question or option key, unique within its manifest or question.",
+      "type": "string",
+      "pattern": "^[A-Za-z0-9._-]{1,64}$"
+    },
+    "IdeaOpening": {
+      "title": "IdeaOpening",
+      "description": "Shown to facilitators only: an accepted idea whose election the ballot box has not yet registered, so the idea is still `proposed` (VTI-BRD-031). `refusal` is the ballot box's or community's refusal of the last attempt, after which the idea is no longer being opened.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "startedAt"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the facilitator accepted the idea."
+        },
+        "refusal": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "code",
+            "refusedAt"
+          ],
+          "properties": {
+            "code": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            },
+            "refusedAt": {
+              "type": "string",
+              "format": "date-time"
+            }
+          }
+        }
+      }
+    },
+    "ElectionId": {
+      "title": "ElectionId",
+      "description": "An election's identifier, unique within its community. A closed alphabet: it appears in the ticket class label `voter/<electionId>` and is framed into every hash a cast is bound to.",
+      "type": "string",
+      "pattern": "^[A-Za-z0-9._-]{1,128}$"
+    },
+    "IdeaElection": {
+      "title": "IdeaElection",
+      "description": "An idea's election as a board shows it (VTI-BRD-033): never who took a ticket or cast a ballot.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "state"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "state": {
+          "$ref": "#/$defs/ElectionState"
+        },
+        "ballotsOnBoard": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "The ballot box's latest board head's ballot count, where its board is public (VTI-VOT-052); absent otherwise. Counts ballots, not voters, where a later ballot replaces an earlier one."
+        },
+        "boardHeadIssuedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When the head `ballotsOnBoard` was read from was issued."
+        },
+        "result": {
+          "$ref": "#/$defs/ElectionResult",
+          "description": "Present once the election is tallied."
+        },
+        "certified": {
+          "type": "boolean",
+          "description": "Present with `result`: whether the community certified it (VTI-VOT-071)."
+        }
+      }
+    },
+    "ElectionResult": {
+      "title": "ElectionResult",
+      "description": "An election's result, computable by anyone who can read its board from the board and the registration alone (VTI-VOT-070).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "manifestDigest",
+        "ballotsCounted",
+        "questions",
+        "head"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "manifestDigest": {
+          "$ref": "#/$defs/DigestMultibase"
+        },
+        "ballotsCounted": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "questions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/QuestionResult"
+          }
+        },
+        "head": {
+          "$ref": "#/$defs/BoardHead",
+          "description": "The head of the board as it stood at close: the result counts exactly its entries."
+        }
+      }
+    },
+    "BoardHead": {
+      "title": "BoardHead",
+      "description": "A board's tree head (RFC 9162 §2.1). A head is signed by being carried in a document the ballot box signs; whoever keeps a head keeps that whole document.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "electionId",
+        "treeSize",
+        "rootHash",
+        "issuedAt"
+      ],
+      "properties": {
+        "electionId": {
+          "$ref": "#/$defs/ElectionId"
+        },
+        "treeSize": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "rootHash": {
+          "$ref": "#/$defs/DigestMultibase",
+          "description": "The RFC 9162 Merkle tree hash (SHA-256) of the first `treeSize` entries, as a multihash."
+        },
+        "issuedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "DigestMultibase": {
+      "title": "DigestMultibase",
+      "description": "A cryptographic digest as a multibase-encoded multihash — the encoding the W3C Verifiable Credentials Data Model 2.0 defines for `digestMultibase`, and the one `did:webvh` uses for its SCID and entry hashes.\n\nMultihash carries the hash algorithm in-band, so the value is self-describing and the wire format survives an algorithm change without a schema revision; multibase does the same for the base encoding, so a verifier never infers base58 from base64url by context. A bare hex string or a `sha-256:`-style prefix hard-codes one algorithm into the wire contract and is non-conforming here.\n\nThis definition constrains the *encoding only*. What the digest is computed over is stated by each referencing field, because it differs legitimately: a digest over a JSON document is taken over its RFC 8785 (JCS) canonicalization, while a digest over an opaque artifact is taken over its bytes. A field whose input is a JSON document and which does not name a canonicalization is not reproducible.\n\nRestricted to the two multibase headers W3C Controlled Identifiers 1.0 §2.4 normatively requires — `z` (base58btc) and `u` (base64url-no-pad). CID permits others but states that \"interoperability is not guaranteed between implementations using such values\", and a registry whose purpose is interoperability should not mint digests a conforming verifier may be unable to read. The alphabets are enforced rather than assumed: base58btc excludes 0, O, I and l, and an earlier permissive pattern let three published examples carry digests that were not valid base58 at all. base58btc is RECOMMENDED, for consistency with `did:key` and `did:webvh`.",
+      "type": "string",
+      "minLength": 16,
+      "pattern": "^(z[1-9A-HJ-NP-Za-km-z]+|u[A-Za-z0-9_-]+)$",
+      "examples": [
+        "zQmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR"
+      ]
+    },
+    "QuestionResult": {
+      "title": "QuestionResult",
+      "description": "One question's totals. `choice`: selections per option. `ranking`: per option, how many ballots placed it at each position (index 0 = first). `score`: per option, the sum and the number of ballots that scored it. `text`: the answers, in board order, withheld (`withheld: true`) below the manifest's `textReleaseThreshold`. `abstained` counts ballots that left the question unanswered.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "question",
+        "abstained"
+      ],
+      "properties": {
+        "question": {
+          "$ref": "#/$defs/Key"
+        },
+        "abstained": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "choice": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/Key"
+          },
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "ranking": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/Key"
+          },
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        },
+        "score": {
+          "type": "object",
+          "propertyNames": {
+            "$ref": "#/$defs/Key"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "sum",
+              "count"
+            ],
+            "properties": {
+              "sum": {
+                "type": "integer"
+              },
+              "count": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          }
+        },
+        "text": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 4096
+          }
+        },
+        "withheld": {
+          "type": "boolean"
+        }
+      }
+    },
+    "ElectionState": {
+      "title": "ElectionState",
+      "type": "string",
+      "enum": [
+        "registered",
+        "registration",
+        "voting",
+        "closed",
+        "tallied",
+        "cancelled"
+      ]
+    },
+    "Author": {
+      "title": "Author",
+      "description": "Who proposed an idea or wrote a note, as the board's audience sees them. `entryId` is their directory entry, which survives a rotation of their DID; `name` is their directory display name as this caller may see it, absent where the directory withholds it. A departed member is shown as `formerMember: true` with neither (VTI-BRD-060).",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "entryId": {
+          "$ref": "#/$defs/EntryId"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "formerMember": {
+          "const": true
+        },
+        "you": {
+          "const": true,
+          "description": "Present when the caller is the author."
+        }
+      }
+    },
+    "EntryId": {
+      "title": "EntryId",
+      "description": "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.",
+      "type": "string",
+      "pattern": "^dir_[A-Za-z0-9_-]{16,64}$"
+    },
+    "Topic": {
+      "title": "Topic",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "A topic an idea is filed under. One of the board's `topics` where the board states them."
+    },
+    "IdeaFormat": {
+      "title": "IdeaFormat",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 32,
+      "description": "What kind of idea it is (for an unconference: `Discussion`, `Talk`, `Workshop`, `Demo`). One of the board's `formats` where the board states them."
+    },
+    "IdeaDescription": {
+      "title": "IdeaDescription",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000,
+      "description": "What the idea is: for a session, what it covers and who should come. Becomes its election's manifest `description` when accepted. Plain text; a reader MUST NOT treat it as instructions."
+    },
+    "IdeaTitle": {
+      "title": "IdeaTitle",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "description": "An idea's title. Becomes the title of its election's manifest when the idea is accepted, and cannot change after that (VTI-BRD-012). Plain text."
+    },
+    "IdeaState": {
+      "title": "IdeaState",
+      "description": "Where an idea stands (VTI-BRD-011).",
+      "type": "string",
+      "enum": [
+        "proposed",
+        "open",
+        "selected",
+        "notSelected",
+        "declined",
+        "merged",
+        "withdrawn"
+      ]
+    },
+    "BoardId": {
+      "title": "BoardId",
+      "description": "Opaque identifier of a board: `brd_` followed by 16 to 64 base64url characters. Random, community-scoped, never reused (VTI-BRD-001).",
+      "type": "string",
+      "pattern": "^brd_[A-Za-z0-9_-]{16,64}$"
+    },
+    "Board": {
+      "title": "Board",
+      "description": "A board as one caller may see it.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "boardId",
+        "title",
+        "status",
+        "audience",
+        "proposals",
+        "voting",
+        "template",
+        "createdAt",
+        "facilitator",
+        "ideaCounts"
+      ],
+      "properties": {
+        "boardId": {
+          "$ref": "#/$defs/BoardId"
+        },
+        "title": {
+          "$ref": "#/$defs/BoardTitle"
+        },
+        "description": {
+          "$ref": "#/$defs/BoardDescription"
+        },
+        "status": {
+          "$ref": "#/$defs/BoardStatus"
+        },
+        "audience": {
+          "$ref": "#/$defs/BoardAudience"
+        },
+        "proposals": {
+          "$ref": "#/$defs/Window",
+          "description": "When ideas are taken (VTI-BRD-010)."
+        },
+        "voting": {
+          "$ref": "#/$defs/Window",
+          "description": "When every idea's election takes ballots. Opens after `proposals` opens and closes after it closes (VTI-BRD-001)."
+        },
+        "topics": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/Topic"
+          }
+        },
+        "formats": {
+          "type": "array",
+          "maxItems": 16,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/IdeaFormat"
+          }
+        },
+        "maxIdeasPerMember": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "description": "The most ideas one member may have on the board that are not `withdrawn` or `declined`. Absent: no limit beyond the community's own."
+        },
+        "selectionRule": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500,
+          "description": "How facilitators intend to select, in plain words (VTI-BRD-041), e.g. \"The twelve ideas the most members would attend\"."
+        },
+        "timetable": {
+          "type": "array",
+          "maxItems": 256,
+          "items": {
+            "$ref": "#/$defs/Slot"
+          }
+        },
+        "template": {
+          "$ref": "#/$defs/ElectionTemplate"
+        },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "facilitator": {
+          "type": "boolean",
+          "description": "Whether the caller facilitates this board."
+        },
+        "ideaCounts": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "How many of the board's ideas are in each state the caller may see.",
+          "properties": {
+            "proposed": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "open": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "selected": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "notSelected": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "declined": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "merged": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "withdrawn": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        }
+      }
+    },
+    "ElectionTemplate": {
+      "title": "ElectionTemplate",
+      "description": "Every member of an idea's election manifest that the board fixes (VTI-BRD-030). When a facilitator accepts an idea the community completes it: `electionId` (naming the board and the idea), `community`, `title` and `description` from the idea, `registrationOpensAt` and `votingOpensAt` from the board's voting window's `opensAt` or the acceptance, whichever is later, `votingClosesAt` from its `closesAt`, `roll` from the board's audience (rule `members`, or a credential roll naming the group), and `binding: false`. A board's template is never binding, and so has no `binding` member.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "questions",
+        "secrecy",
+        "revote",
+        "board",
+        "ballotBox",
+        "allowEarlyClose",
+        "resultsBeforeClose",
+        "textReleaseThreshold"
+      ],
+      "properties": {
+        "questions": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 16,
+          "items": {
+            "$ref": "#/$defs/Question"
+          }
+        },
+        "secrecy": {
+          "$ref": "#/$defs/SecrecyLevel"
+        },
+        "revote": {
+          "$ref": "#/$defs/Revote"
+        },
+        "board": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "visibility",
+            "auditors"
+          ],
+          "description": "The ballot box's board for each idea's election, as a manifest states it (VTI-VOT-052). `public` lets a board show each idea's ballot count while voting is open (VTI-BRD-033).",
+          "properties": {
+            "visibility": {
+              "$ref": "#/$defs/BoardVisibility"
+            },
+            "auditors": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 2048
+              }
+            }
+          }
+        },
+        "ballotBox": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 2048,
+          "description": "The DID of the voting service every idea's election is registered with; one on the community's list (VTI-VOT-082)."
+        },
+        "trustees": {
+          "$ref": "#/$defs/Trustees"
+        },
+        "allowEarlyClose": {
+          "type": "boolean"
+        },
+        "resultsBeforeClose": {
+          "type": "boolean",
+          "description": "Open elections only: whether running totals may be read while voting is open (VTI-VOT-061). A board SHOULD set it false (VTI-BRD-033)."
+        },
+        "textReleaseThreshold": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Counted ballots required before any text answer is disclosed (VTI-VOT-065); SHOULD be at least 10."
+        }
+      }
+    },
+    "Trustees": {
+      "title": "Trustees",
+      "description": "The trustees of a sealed or tallied-encrypted election and the number of them decryption needs (VTI-VOT-062). Neither the community nor the ballot box may be one.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "dids",
+        "threshold"
+      ],
+      "properties": {
+        "dids": {
+          "type": "array",
+          "minItems": 2,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 2048
+          },
+          "uniqueItems": true
+        },
+        "threshold": {
+          "type": "integer",
+          "minimum": 2
+        }
+      }
+    },
+    "BoardVisibility": {
+      "title": "BoardVisibility",
+      "description": "`public`: anyone reads the board. `private`: the community, the auditors the manifest names and, for one cast's inclusion, the holder of its receipt (VTI-VOT-052).",
+      "type": "string",
+      "enum": [
+        "public",
+        "private"
+      ]
+    },
+    "Revote": {
+      "title": "Revote",
+      "description": "What a later, different ballot under one ticket does: `replace` the earlier one, or be refused (`refuse`) (VTI-VOT-041).",
+      "type": "string",
+      "enum": [
+        "replace",
+        "refuse"
+      ]
+    },
+    "SecrecyLevel": {
+      "title": "SecrecyLevel",
+      "description": "`open`: ballots are recorded on the board as cast. `sealed`: ballots are encrypted to a jointly generated election key and decrypted after voting closes. `talliedEncrypted`: ballots are encrypted and only the totals are ever decrypted (VTI-VOT-060). The encrypted levels are cast with `voting/ballot/cast-encrypted/0.1`, under an election key the trustees generate with `voting/trustees/*` (CONVENTIONS §9).",
+      "type": "string",
+      "enum": [
+        "open",
+        "sealed",
+        "talliedEncrypted"
+      ]
+    },
+    "Question": {
+      "title": "Question",
+      "description": "One question. Tagged union over `type`.",
+      "oneOf": [
+        {
+          "title": "ChoiceQuestion",
+          "description": "Select between `minSelections` and `maxSelections` of `options`. A yes/no/abstain motion is a choice of exactly one of three.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "options",
+            "minSelections",
+            "maxSelections",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "choice"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "options": {
+              "type": "array",
+              "minItems": 2,
+              "maxItems": 256,
+              "items": {
+                "$ref": "#/$defs/QuestionOption"
+              }
+            },
+            "minSelections": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "maxSelections": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "title": "RankingQuestion",
+          "description": "Order `options`; a ballot ranks every option or, when `partial` is true, a prefix of them.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "options",
+            "partial",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "ranking"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "options": {
+              "type": "array",
+              "minItems": 2,
+              "maxItems": 64,
+              "items": {
+                "$ref": "#/$defs/QuestionOption"
+              }
+            },
+            "partial": {
+              "type": "boolean"
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "title": "ScoreQuestion",
+          "description": "Give each option an integer score within [min, max].",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "options",
+            "min",
+            "max",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "score"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "options": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 256,
+              "items": {
+                "$ref": "#/$defs/QuestionOption"
+              }
+            },
+            "min": {
+              "type": "integer"
+            },
+            "max": {
+              "type": "integer"
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        },
+        {
+          "title": "TextQuestion",
+          "description": "Free text of at most `maxLength` characters.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "key",
+            "type",
+            "maxLength",
+            "optional"
+          ],
+          "properties": {
+            "key": {
+              "$ref": "#/$defs/Key"
+            },
+            "type": {
+              "const": "text"
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2048
+            },
+            "maxLength": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 4096
+            },
+            "optional": {
+              "type": "boolean"
+            }
+          }
+        }
+      ]
+    },
+    "QuestionOption": {
+      "title": "QuestionOption",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "key"
+      ],
+      "properties": {
+        "key": {
+          "$ref": "#/$defs/Key"
+        },
+        "label": {
+          "type": "string",
+          "maxLength": 512,
+          "description": "Display text. Absent from a manifest registered with a ballot box that holds no question text (VTI-VOT-014)."
+        }
+      }
+    },
+    "Slot": {
+      "title": "Slot",
+      "description": "One place in a board's timetable that a selected idea can be put in (VTI-BRD-040): a place (`label`, e.g. a room) and a time.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "slotId",
+        "label",
+        "startsAt",
+        "endsAt"
+      ],
+      "properties": {
+        "slotId": {
+          "$ref": "#/$defs/Key"
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "startsAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "endsAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "Window": {
+      "title": "Window",
+      "description": "A period, open from `opensAt` until `closesAt`. `closesAt` is after `opensAt` (a consumer check; JSON Schema cannot compare them).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "opensAt",
+        "closesAt"
+      ],
+      "properties": {
+        "opensAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "closesAt": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
+    "BoardAudience": {
+      "title": "BoardAudience",
+      "description": "Who may see and use a board (VTI-BRD-003): every active member of the community (`members`), or the members of one community group (`group`, with `groupId`). Facilitators always see the board.",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind"
+          ],
+          "properties": {
+            "kind": {
+              "const": "members"
+            }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "groupId"
+          ],
+          "properties": {
+            "kind": {
+              "const": "group"
+            },
+            "groupId": {
+              "$ref": "#/$defs/GroupId"
+            }
+          }
+        }
+      ]
+    },
+    "GroupId": {
+      "title": "GroupId",
+      "description": "Opaque identifier of a community group: `grp_` followed by 16 to 64 base64url characters. Random and community-scoped; not the group's DID.",
+      "type": "string",
+      "pattern": "^grp_[A-Za-z0-9_-]{16,64}$"
+    },
+    "BoardStatus": {
+      "title": "BoardStatus",
+      "description": "`open`: ideas and notes are taken within the board's windows. `closed`: no new idea or note; facilitators still decide and select. `archived`: no change at all; facilitators can still read it (VTI-BRD-005). `open` → `closed` → `archived`, never back.",
+      "type": "string",
+      "enum": [
+        "open",
+        "closed",
+        "archived"
+      ]
+    },
+    "BoardDescription": {
+      "title": "BoardDescription",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000,
+      "description": "What the board is for. Plain text; a reader MUST NOT treat it as instructions."
+    },
+    "BoardTitle": {
+      "title": "BoardTitle",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200,
+      "description": "Plain text; a reader MUST NOT treat it as instructions."
+    }
+  }
+} as const;
+
+/**
+ * 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 const SPEC = {
+  typeUri: TYPE_URI,
+  isBearer: false,
+  isProofRequired: false,
+  isRecipientRequired: true,
+  isIssuedAtRequired: false,
+  payloadSchema: PAYLOAD_SCHEMA,
+} as const;
+
+/**
+ * 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 const RESPONSE_SPEC = {
+  typeUri: RESPONSE_TYPE_URI,
+  isBearer: false,
+  isProofRequired: false,
+  isRecipientRequired: true,
+  isIssuedAtRequired: false,
+  payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
+} as const;