@openvtc/trust-tasks 0.21.3 → 0.21.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (212) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/dist/_shared/components.d.ts +210 -2
  3. package/dist/_shared/components.d.ts.map +1 -1
  4. package/dist/auth/_shared/0.1/passkey-invite.d.ts +16 -0
  5. package/dist/auth/_shared/0.1/passkey-invite.d.ts.map +1 -0
  6. package/dist/auth/_shared/0.1/passkey-invite.js +6 -0
  7. package/dist/auth/_shared/0.1/passkey-invite.js.map +1 -0
  8. package/dist/auth/passkey/admin-list/0.1/payload.d.ts +484 -0
  9. package/dist/auth/passkey/admin-list/0.1/payload.d.ts.map +1 -0
  10. package/dist/auth/passkey/admin-list/0.1/payload.js +257 -0
  11. package/dist/auth/passkey/admin-list/0.1/payload.js.map +1 -0
  12. package/dist/auth/passkey/enroll/invite/list/0.1/payload.d.ts +393 -0
  13. package/dist/auth/passkey/enroll/invite/list/0.1/payload.d.ts.map +1 -0
  14. package/dist/auth/passkey/enroll/invite/list/0.1/payload.js +234 -0
  15. package/dist/auth/passkey/enroll/invite/list/0.1/payload.js.map +1 -0
  16. package/dist/auth/passkey/enroll/invite/revoke/0.1/payload.d.ts +228 -0
  17. package/dist/auth/passkey/enroll/invite/revoke/0.1/payload.d.ts.map +1 -0
  18. package/dist/auth/passkey/enroll/invite/revoke/0.1/payload.js +138 -0
  19. package/dist/auth/passkey/enroll/invite/revoke/0.1/payload.js.map +1 -0
  20. package/dist/auth/passkey/enroll/invite/update/0.1/payload.d.ts +459 -0
  21. package/dist/auth/passkey/enroll/invite/update/0.1/payload.d.ts.map +1 -0
  22. package/dist/auth/passkey/enroll/invite/update/0.1/payload.js +286 -0
  23. package/dist/auth/passkey/enroll/invite/update/0.1/payload.js.map +1 -0
  24. package/dist/auth/step-up/start/0.1/payload.d.ts +420 -0
  25. package/dist/auth/step-up/start/0.1/payload.d.ts.map +1 -0
  26. package/dist/auth/step-up/start/0.1/payload.js +232 -0
  27. package/dist/auth/step-up/start/0.1/payload.js.map +1 -0
  28. package/dist/did-management/_shared/0.1/service-instance.d.ts +1 -1
  29. package/dist/did-management/_shared/0.1/service-instance.d.ts.map +1 -1
  30. package/dist/did-management/_shared/0.2/metrics-snapshot.d.ts +16 -0
  31. package/dist/did-management/_shared/0.2/metrics-snapshot.d.ts.map +1 -0
  32. package/dist/did-management/_shared/0.2/metrics-snapshot.js +6 -0
  33. package/dist/did-management/_shared/0.2/metrics-snapshot.js.map +1 -0
  34. package/dist/did-management/_shared/0.2/service-instance.d.ts +16 -0
  35. package/dist/did-management/_shared/0.2/service-instance.d.ts.map +1 -0
  36. package/dist/did-management/_shared/0.2/service-instance.js +6 -0
  37. package/dist/did-management/_shared/0.2/service-instance.js.map +1 -0
  38. package/dist/did-management/agent-name/resolve/0.1/payload.d.ts +318 -0
  39. package/dist/did-management/agent-name/resolve/0.1/payload.d.ts.map +1 -0
  40. package/dist/did-management/agent-name/resolve/0.1/payload.js +179 -0
  41. package/dist/did-management/agent-name/resolve/0.1/payload.js.map +1 -0
  42. package/dist/did-management/did/log/0.1/payload.d.ts +436 -0
  43. package/dist/did-management/did/log/0.1/payload.d.ts.map +1 -0
  44. package/dist/did-management/did/log/0.1/payload.js +228 -0
  45. package/dist/did-management/did/log/0.1/payload.js.map +1 -0
  46. package/dist/did-management/domain/list/0.1/payload.d.ts +423 -0
  47. package/dist/did-management/domain/list/0.1/payload.d.ts.map +1 -0
  48. package/dist/did-management/domain/list/0.1/payload.js +244 -0
  49. package/dist/did-management/domain/list/0.1/payload.js.map +1 -0
  50. package/dist/did-management/identity/list/0.1/payload.d.ts +494 -0
  51. package/dist/did-management/identity/list/0.1/payload.d.ts.map +1 -0
  52. package/dist/did-management/identity/list/0.1/payload.js +274 -0
  53. package/dist/did-management/identity/list/0.1/payload.js.map +1 -0
  54. package/dist/did-management/identity/retire/0.1/payload.d.ts +242 -0
  55. package/dist/did-management/identity/retire/0.1/payload.d.ts.map +1 -0
  56. package/dist/did-management/identity/retire/0.1/payload.js +142 -0
  57. package/dist/did-management/identity/retire/0.1/payload.js.map +1 -0
  58. package/dist/did-management/registry/admin-register/0.1/payload.d.ts +1 -1
  59. package/dist/did-management/registry/admin-register/0.1/payload.d.ts.map +1 -1
  60. package/dist/did-management/registry/check/0.1/payload.d.ts +639 -0
  61. package/dist/did-management/registry/check/0.1/payload.d.ts.map +1 -0
  62. package/dist/did-management/registry/check/0.1/payload.js +383 -0
  63. package/dist/did-management/registry/check/0.1/payload.js.map +1 -0
  64. package/dist/did-management/registry/get/0.1/payload.d.ts +632 -0
  65. package/dist/did-management/registry/get/0.1/payload.d.ts.map +1 -0
  66. package/dist/did-management/registry/get/0.1/payload.js +381 -0
  67. package/dist/did-management/registry/get/0.1/payload.js.map +1 -0
  68. package/dist/did-management/registry/list/0.1/payload.d.ts +661 -0
  69. package/dist/did-management/registry/list/0.1/payload.d.ts.map +1 -0
  70. package/dist/did-management/registry/list/0.1/payload.js +398 -0
  71. package/dist/did-management/registry/list/0.1/payload.js.map +1 -0
  72. package/dist/did-management/registry/purge-domain/0.1/payload.d.ts +269 -0
  73. package/dist/did-management/registry/purge-domain/0.1/payload.d.ts.map +1 -0
  74. package/dist/did-management/registry/purge-domain/0.1/payload.js +160 -0
  75. package/dist/did-management/registry/purge-domain/0.1/payload.js.map +1 -0
  76. package/dist/did-management/replica/domain/assign/0.1/payload.d.ts +233 -0
  77. package/dist/did-management/replica/domain/assign/0.1/payload.d.ts.map +1 -0
  78. package/dist/did-management/replica/domain/assign/0.1/payload.js +143 -0
  79. package/dist/did-management/replica/domain/assign/0.1/payload.js.map +1 -0
  80. package/dist/did-management/replica/domain/purge/0.1/payload.d.ts +257 -0
  81. package/dist/did-management/replica/domain/purge/0.1/payload.d.ts.map +1 -0
  82. package/dist/did-management/replica/domain/purge/0.1/payload.js +155 -0
  83. package/dist/did-management/replica/domain/purge/0.1/payload.js.map +1 -0
  84. package/dist/did-management/replica/domain/unassign/0.1/payload.d.ts +257 -0
  85. package/dist/did-management/replica/domain/unassign/0.1/payload.d.ts.map +1 -0
  86. package/dist/did-management/replica/domain/unassign/0.1/payload.js +155 -0
  87. package/dist/did-management/replica/domain/unassign/0.1/payload.js.map +1 -0
  88. package/dist/did-management/replica/domain/upsert/0.1/payload.d.ts +401 -0
  89. package/dist/did-management/replica/domain/upsert/0.1/payload.d.ts.map +1 -0
  90. package/dist/did-management/replica/domain/upsert/0.1/payload.js +241 -0
  91. package/dist/did-management/replica/domain/upsert/0.1/payload.js.map +1 -0
  92. package/dist/did-management/server/config/0.1/payload.d.ts +838 -0
  93. package/dist/did-management/server/config/0.1/payload.d.ts.map +1 -0
  94. package/dist/did-management/server/config/0.1/payload.js +444 -0
  95. package/dist/did-management/server/config/0.1/payload.js.map +1 -0
  96. package/dist/did-management/server/info/0.1/payload.d.ts +285 -0
  97. package/dist/did-management/server/info/0.1/payload.d.ts.map +1 -0
  98. package/dist/did-management/server/info/0.1/payload.js +160 -0
  99. package/dist/did-management/server/info/0.1/payload.js.map +1 -0
  100. package/dist/did-management/server/metrics/0.1/payload.d.ts +674 -0
  101. package/dist/did-management/server/metrics/0.1/payload.d.ts.map +1 -0
  102. package/dist/did-management/server/metrics/0.1/payload.js +387 -0
  103. package/dist/did-management/server/metrics/0.1/payload.js.map +1 -0
  104. package/dist/did-management/stats/get/0.1/payload.d.ts +349 -0
  105. package/dist/did-management/stats/get/0.1/payload.d.ts.map +1 -0
  106. package/dist/did-management/stats/get/0.1/payload.js +187 -0
  107. package/dist/did-management/stats/get/0.1/payload.js.map +1 -0
  108. package/dist/did-management/stats/timeseries/0.1/payload.d.ts +381 -0
  109. package/dist/did-management/stats/timeseries/0.1/payload.d.ts.map +1 -0
  110. package/dist/did-management/stats/timeseries/0.1/payload.js +227 -0
  111. package/dist/did-management/stats/timeseries/0.1/payload.js.map +1 -0
  112. package/dist/git-ns/namespace/list/0.1/payload.d.ts +1343 -0
  113. package/dist/git-ns/namespace/list/0.1/payload.d.ts.map +1 -0
  114. package/dist/git-ns/namespace/list/0.1/payload.js +704 -0
  115. package/dist/git-ns/namespace/list/0.1/payload.js.map +1 -0
  116. package/dist/git-ns/repo/list/0.1/payload.d.ts +1377 -0
  117. package/dist/git-ns/repo/list/0.1/payload.d.ts.map +1 -0
  118. package/dist/git-ns/repo/list/0.1/payload.js +744 -0
  119. package/dist/git-ns/repo/list/0.1/payload.js.map +1 -0
  120. package/dist/git-ns/view/0.5/payload.d.ts +1722 -0
  121. package/dist/git-ns/view/0.5/payload.d.ts.map +1 -0
  122. package/dist/git-ns/view/0.5/payload.js +1024 -0
  123. package/dist/git-ns/view/0.5/payload.js.map +1 -0
  124. package/dist/index.d.ts +38 -0
  125. package/dist/index.d.ts.map +1 -1
  126. package/dist/index.js +38 -0
  127. package/dist/index.js.map +1 -1
  128. package/dist/vtc/_shared/0.1/invite.d.ts +1 -1
  129. package/dist/vtc/_shared/0.1/invite.d.ts.map +1 -1
  130. package/dist/vtc/admin/invites/list/0.1/payload.d.ts +1 -1
  131. package/dist/vtc/admin/invites/list/0.1/payload.d.ts.map +1 -1
  132. package/dist/webvh/_shared/0.1/sync-update.d.ts +16 -0
  133. package/dist/webvh/_shared/0.1/sync-update.d.ts.map +1 -0
  134. package/dist/webvh/_shared/0.1/sync-update.js +6 -0
  135. package/dist/webvh/_shared/0.1/sync-update.js.map +1 -0
  136. package/dist/webvh/_shared/0.1/witness-key.d.ts +16 -0
  137. package/dist/webvh/_shared/0.1/witness-key.d.ts.map +1 -0
  138. package/dist/webvh/_shared/0.1/witness-key.js +6 -0
  139. package/dist/webvh/_shared/0.1/witness-key.js.map +1 -0
  140. package/dist/webvh/sync/batch/0.1/payload.d.ts +503 -0
  141. package/dist/webvh/sync/batch/0.1/payload.d.ts.map +1 -0
  142. package/dist/webvh/sync/batch/0.1/payload.js +290 -0
  143. package/dist/webvh/sync/batch/0.1/payload.js.map +1 -0
  144. package/dist/webvh/sync/delete/0.2/payload.d.ts +242 -0
  145. package/dist/webvh/sync/delete/0.2/payload.d.ts.map +1 -0
  146. package/dist/webvh/sync/delete/0.2/payload.js +148 -0
  147. package/dist/webvh/sync/delete/0.2/payload.js.map +1 -0
  148. package/dist/webvh/sync/update/0.2/payload.d.ts +315 -0
  149. package/dist/webvh/sync/update/0.2/payload.d.ts.map +1 -0
  150. package/dist/webvh/sync/update/0.2/payload.js +177 -0
  151. package/dist/webvh/sync/update/0.2/payload.js.map +1 -0
  152. package/dist/webvh/witness/key/create/0.1/payload.d.ts +346 -0
  153. package/dist/webvh/witness/key/create/0.1/payload.d.ts.map +1 -0
  154. package/dist/webvh/witness/key/create/0.1/payload.js +202 -0
  155. package/dist/webvh/witness/key/create/0.1/payload.js.map +1 -0
  156. package/dist/webvh/witness/key/delete/0.1/payload.d.ts +237 -0
  157. package/dist/webvh/witness/key/delete/0.1/payload.d.ts.map +1 -0
  158. package/dist/webvh/witness/key/delete/0.1/payload.js +141 -0
  159. package/dist/webvh/witness/key/delete/0.1/payload.js.map +1 -0
  160. package/dist/webvh/witness/key/list/0.1/payload.d.ts +349 -0
  161. package/dist/webvh/witness/key/list/0.1/payload.d.ts.map +1 -0
  162. package/dist/webvh/witness/key/list/0.1/payload.js +204 -0
  163. package/dist/webvh/witness/key/list/0.1/payload.js.map +1 -0
  164. package/dist/webvh/witness/sign/0.1/payload.d.ts +401 -0
  165. package/dist/webvh/witness/sign/0.1/payload.d.ts.map +1 -0
  166. package/dist/webvh/witness/sign/0.1/payload.js +229 -0
  167. package/dist/webvh/witness/sign/0.1/payload.js.map +1 -0
  168. package/package.json +1 -1
  169. package/src/_shared/components.ts +210 -2
  170. package/src/auth/_shared/0.1/passkey-invite.ts +17 -0
  171. package/src/auth/passkey/admin-list/0.1/payload.ts +338 -0
  172. package/src/auth/passkey/enroll/invite/list/0.1/payload.ts +266 -0
  173. package/src/auth/passkey/enroll/invite/revoke/0.1/payload.ts +165 -0
  174. package/src/auth/passkey/enroll/invite/update/0.1/payload.ts +327 -0
  175. package/src/auth/step-up/start/0.1/payload.ts +287 -0
  176. package/src/did-management/_shared/0.1/service-instance.ts +1 -1
  177. package/src/did-management/_shared/0.2/metrics-snapshot.ts +17 -0
  178. package/src/did-management/_shared/0.2/service-instance.ts +17 -0
  179. package/src/did-management/agent-name/resolve/0.1/payload.ts +222 -0
  180. package/src/did-management/did/log/0.1/payload.ts +295 -0
  181. package/src/did-management/domain/list/0.1/payload.ts +280 -0
  182. package/src/did-management/identity/list/0.1/payload.ts +335 -0
  183. package/src/did-management/identity/retire/0.1/payload.ts +175 -0
  184. package/src/did-management/registry/admin-register/0.1/payload.ts +1 -1
  185. package/src/did-management/registry/check/0.1/payload.ts +415 -0
  186. package/src/did-management/registry/get/0.1/payload.ts +410 -0
  187. package/src/did-management/registry/list/0.1/payload.ts +434 -0
  188. package/src/did-management/registry/purge-domain/0.1/payload.ts +198 -0
  189. package/src/did-management/replica/domain/assign/0.1/payload.ts +173 -0
  190. package/src/did-management/replica/domain/purge/0.1/payload.ts +189 -0
  191. package/src/did-management/replica/domain/unassign/0.1/payload.ts +189 -0
  192. package/src/did-management/replica/domain/upsert/0.1/payload.ts +271 -0
  193. package/src/did-management/server/config/0.1/payload.ts +545 -0
  194. package/src/did-management/server/info/0.1/payload.ts +200 -0
  195. package/src/did-management/server/metrics/0.1/payload.ts +418 -0
  196. package/src/did-management/stats/get/0.1/payload.ts +237 -0
  197. package/src/did-management/stats/timeseries/0.1/payload.ts +279 -0
  198. package/src/git-ns/namespace/list/0.1/payload.ts +883 -0
  199. package/src/git-ns/repo/list/0.1/payload.ts +909 -0
  200. package/src/git-ns/view/0.5/payload.ts +1095 -0
  201. package/src/index.ts +38 -0
  202. package/src/vtc/_shared/0.1/invite.ts +1 -1
  203. package/src/vtc/admin/invites/list/0.1/payload.ts +1 -1
  204. package/src/webvh/_shared/0.1/sync-update.ts +17 -0
  205. package/src/webvh/_shared/0.1/witness-key.ts +17 -0
  206. package/src/webvh/sync/batch/0.1/payload.ts +336 -0
  207. package/src/webvh/sync/delete/0.2/payload.ts +181 -0
  208. package/src/webvh/sync/update/0.2/payload.ts +233 -0
  209. package/src/webvh/witness/key/create/0.1/payload.ts +231 -0
  210. package/src/webvh/witness/key/delete/0.1/payload.ts +171 -0
  211. package/src/webvh/witness/key/list/0.1/payload.ts +232 -0
  212. package/src/webvh/witness/sign/0.1/payload.ts +279 -0
@@ -0,0 +1,1377 @@
1
+ /**
2
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
3
+ * Source: specs/git-ns/repo/list/0.1/payload.schema.json
4
+ */
5
+ import type { Bootstrap, Did_GitNsV0_3 as Did, Ext, ForgeId, NamespaceId, RepoResource, RepoVisibility } from "../../../../_shared/components.js";
6
+ /**
7
+ * 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.
8
+ */
9
+ export type MappedRole = "none" | "read" | "triage" | "write" | "maintain" | "admin";
10
+ /**
11
+ * An administrator lists the repositories recorded in the namespaces they administer — every one, for a holder of the community-administrator capability — with owners, right counts, bootstrap, sync and forge status.
12
+ */
13
+ export interface GitNamespacesListRepositoriesPayload {
14
+ /**
15
+ * Only the repositories in 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.
16
+ */
17
+ namespace?: NamespaceId;
18
+ ext?: Ext;
19
+ }
20
+ /**
21
+ * The repositories in the namespaces the caller administers, or in the one asked for.
22
+ */
23
+ export interface GitNamespacesListRepositoriesResponsePayload {
24
+ /**
25
+ * Every repository recorded in an administered namespace, in any state, ordered by `resource`; for a holder of the community-administrator capability without `namespace`, also every repository whose namespace is no longer bound.
26
+ */
27
+ repos: RepoStatus[];
28
+ ext?: Ext;
29
+ }
30
+ /**
31
+ * One repository as its administrators govern it: who owns it, how many hold rights on it, how far commit trust is set up, and how its forge compares with the VTC's projection.
32
+ */
33
+ export interface RepoStatus {
34
+ /**
35
+ * The VTC's identifier for the repository record.
36
+ */
37
+ id: string;
38
+ /**
39
+ * The namespace it was recorded in. For a `detached` repository, possibly one no longer bound.
40
+ */
41
+ namespace: NamespaceId;
42
+ resource: RepoResource;
43
+ /**
44
+ * The forge's repository id, once confirmed.
45
+ */
46
+ forgeId?: ForgeId;
47
+ visibility: RepoVisibility;
48
+ /**
49
+ * As `RepoSummary.state` in the shared schema.
50
+ */
51
+ state: "pendingCreate" | "active" | "archived" | "detached" | "orphaned" | "unmanaged";
52
+ /**
53
+ * The DIDs holding a live, explicitly recorded `git.repo.own` on it.
54
+ */
55
+ owners: Did[];
56
+ /**
57
+ * How many live records of `git.repo.maintain` it has. Implied rights are not counted.
58
+ */
59
+ maintainers: number;
60
+ /**
61
+ * How many live records of `git.commit.sign` it has. Implied rights are not counted.
62
+ */
63
+ committers: number;
64
+ bootstrap: Bootstrap;
65
+ /**
66
+ * As `Sync.state` in the shared schema.
67
+ */
68
+ syncState: "inSync" | "drift" | "pending" | "unchecked";
69
+ /**
70
+ * When the forge was last compared. Absent if never.
71
+ */
72
+ checkedAt?: string;
73
+ /**
74
+ * How many drift items are outstanding. The items themselves are in `git-ns/view`.
75
+ */
76
+ driftCount: number;
77
+ /**
78
+ * The step that failed on the last create or bootstrap.
79
+ */
80
+ failedStep?: string;
81
+ /**
82
+ * What the bridge said when that step failed.
83
+ */
84
+ lastError?: string;
85
+ /**
86
+ * Who created it through the VTC. Absent for an adopted or unmanaged repository.
87
+ */
88
+ createdBy?: Did;
89
+ /**
90
+ * When the VTC first recorded it.
91
+ */
92
+ createdAt: string;
93
+ /**
94
+ * The guard in force against a pull request satisfying its own check, as the bridge last reported it: `requiredWorkflow`, `codeOwnerReview`, `bridgePostedCheck`, `protectedFiles` or `none`. A client treats any other value as `none`.
95
+ */
96
+ guard?: string;
97
+ /**
98
+ * Per-step outcomes of the last create, bootstrap or inspect job. Empty until one has been reported.
99
+ *
100
+ * @maxItems 64
101
+ */
102
+ steps: StepOutcome[];
103
+ lastCheck?: LastCheck;
104
+ roleMap?: RoleMap;
105
+ /**
106
+ * The bridge last projected this repository's roles under an earlier role map, and the re-projection queued for it has not yet succeeded.
107
+ */
108
+ roleMapStale: boolean;
109
+ }
110
+ /**
111
+ * One step of the last create, bootstrap or inspect job on the repository, as the bridge reported it.
112
+ */
113
+ export interface StepOutcome {
114
+ /**
115
+ * The step, in the bridge's words (`workflow`, `keyring`, `variables`, `requiredCheck`).
116
+ */
117
+ step: string;
118
+ /**
119
+ * `applied`, `unchanged`, `failed` or `skipped`. A client shows any other value as reported.
120
+ */
121
+ outcome: string;
122
+ /**
123
+ * What the bridge said about it — an error, or why it was skipped.
124
+ */
125
+ detail?: string;
126
+ }
127
+ /**
128
+ * The last verify-trust check run the bridge saw on the repository.
129
+ */
130
+ export interface LastCheck {
131
+ /**
132
+ * The check's conclusion, in the forge's words (`success`, `failure`).
133
+ */
134
+ conclusion: string;
135
+ /**
136
+ * When the check concluded.
137
+ */
138
+ at: string;
139
+ /**
140
+ * The commit it ran on.
141
+ */
142
+ sha?: string;
143
+ }
144
+ /**
145
+ * The forge role each right projects to on this repository under the serving bridge's reported map. Absent while the namespace's map is unknown.
146
+ */
147
+ export interface RoleMap {
148
+ own: MappedRole;
149
+ maintain: MappedRole;
150
+ commit: MappedRole;
151
+ }
152
+ /** Shared definitions this specification references, re-exported under the names it used to declare them with. */
153
+ export type { Bootstrap, Did, Ext, ForgeId, NamespaceId, RepoResource, RepoVisibility };
154
+ /** Trust Task type URI. */
155
+ export declare const TYPE_URI: "https://trusttasks.org/spec/git-ns/repo/list/0.1";
156
+ /** Stable alias for this specification's request payload shape. */
157
+ export type Payload = GitNamespacesListRepositoriesPayload;
158
+ /** Trust Task response type URI (request type URI + "#response"). */
159
+ export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/git-ns/repo/list/0.1#response";
160
+ /** Stable alias for this specification's success-response payload shape. */
161
+ export type Response = GitNamespacesListRepositoriesResponsePayload;
162
+ /**
163
+ * This specification's payload schema, as a value.
164
+ *
165
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
166
+ * rather than only as a `.json` file because TypeScript types are erased
167
+ * at runtime: without a schema a consumer has nothing to validate, and
168
+ * every REQUIRED payload member is optional in practice. Cross-file
169
+ * `$ref`s are already inlined, so it needs no resolver.
170
+ */
171
+ export declare const PAYLOAD_SCHEMA: {
172
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
173
+ readonly $id: "https://trusttasks.org/spec/git-ns/repo/list/0.1";
174
+ readonly title: "Git Namespaces — List Repositories — payload";
175
+ readonly description: "An administrator lists the repositories recorded in the namespaces they administer — every one, for a holder of the community-administrator capability — with owners, right counts, bootstrap, sync and forge status.";
176
+ readonly type: "object";
177
+ readonly additionalProperties: false;
178
+ readonly required: readonly [];
179
+ readonly properties: {
180
+ readonly namespace: {
181
+ readonly $ref: "#/$defs/NamespaceId";
182
+ readonly description: "Only the repositories in 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.";
183
+ };
184
+ readonly ext: {
185
+ readonly $ref: "#/$defs/Ext";
186
+ };
187
+ };
188
+ readonly $defs: {
189
+ readonly MappedRole: {
190
+ readonly title: "MappedRole";
191
+ readonly type: "string";
192
+ readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
193
+ 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.";
194
+ };
195
+ readonly RoleMap: {
196
+ readonly title: "RoleMap";
197
+ 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`.";
198
+ readonly type: "object";
199
+ readonly additionalProperties: false;
200
+ readonly required: readonly ["own", "maintain", "commit"];
201
+ readonly properties: {
202
+ readonly own: {
203
+ readonly $ref: "#/$defs/MappedRole";
204
+ };
205
+ readonly maintain: {
206
+ readonly $ref: "#/$defs/MappedRole";
207
+ };
208
+ readonly commit: {
209
+ readonly $ref: "#/$defs/MappedRole";
210
+ };
211
+ };
212
+ };
213
+ readonly StepOutcome: {
214
+ readonly title: "StepOutcome";
215
+ readonly description: "One step of the last create, bootstrap or inspect job on the repository, as the bridge reported it.";
216
+ readonly type: "object";
217
+ readonly additionalProperties: false;
218
+ readonly required: readonly ["step", "outcome"];
219
+ readonly properties: {
220
+ readonly step: {
221
+ readonly type: "string";
222
+ readonly minLength: 1;
223
+ readonly maxLength: 64;
224
+ readonly description: "The step, in the bridge's words (`workflow`, `keyring`, `variables`, `requiredCheck`).";
225
+ };
226
+ readonly outcome: {
227
+ readonly type: "string";
228
+ readonly minLength: 1;
229
+ readonly maxLength: 32;
230
+ readonly description: "`applied`, `unchanged`, `failed` or `skipped`. A client shows any other value as reported.";
231
+ };
232
+ readonly detail: {
233
+ readonly type: "string";
234
+ readonly minLength: 1;
235
+ readonly maxLength: 4096;
236
+ readonly description: "What the bridge said about it — an error, or why it was skipped.";
237
+ };
238
+ };
239
+ };
240
+ readonly LastCheck: {
241
+ readonly title: "LastCheck";
242
+ readonly description: "The last verify-trust check run the bridge saw on the repository.";
243
+ readonly type: "object";
244
+ readonly additionalProperties: false;
245
+ readonly required: readonly ["conclusion", "at"];
246
+ readonly properties: {
247
+ readonly conclusion: {
248
+ readonly type: "string";
249
+ readonly minLength: 1;
250
+ readonly maxLength: 64;
251
+ readonly description: "The check's conclusion, in the forge's words (`success`, `failure`).";
252
+ };
253
+ readonly at: {
254
+ readonly type: "string";
255
+ readonly format: "date-time";
256
+ readonly description: "When the check concluded.";
257
+ };
258
+ readonly sha: {
259
+ readonly type: "string";
260
+ readonly minLength: 1;
261
+ readonly maxLength: 64;
262
+ readonly description: "The commit it ran on.";
263
+ };
264
+ };
265
+ };
266
+ readonly RepoStatus: {
267
+ readonly title: "RepoStatus";
268
+ readonly description: "One repository as its administrators govern it: who owns it, how many hold rights on it, how far commit trust is set up, and how its forge compares with the VTC's projection.";
269
+ readonly type: "object";
270
+ readonly additionalProperties: false;
271
+ readonly required: readonly ["id", "namespace", "resource", "visibility", "state", "owners", "maintainers", "committers", "bootstrap", "syncState", "driftCount", "createdAt", "steps", "roleMapStale"];
272
+ readonly properties: {
273
+ readonly id: {
274
+ readonly type: "string";
275
+ readonly minLength: 1;
276
+ readonly maxLength: 128;
277
+ readonly description: "The VTC's identifier for the repository record.";
278
+ };
279
+ readonly namespace: {
280
+ readonly $ref: "#/$defs/NamespaceId";
281
+ readonly description: "The namespace it was recorded in. For a `detached` repository, possibly one no longer bound.";
282
+ };
283
+ readonly resource: {
284
+ readonly $ref: "#/$defs/RepoResource";
285
+ };
286
+ readonly forgeId: {
287
+ readonly $ref: "#/$defs/ForgeId";
288
+ readonly description: "The forge's repository id, once confirmed.";
289
+ };
290
+ readonly visibility: {
291
+ readonly $ref: "#/$defs/RepoVisibility";
292
+ };
293
+ readonly state: {
294
+ readonly type: "string";
295
+ readonly enum: readonly ["pendingCreate", "active", "archived", "detached", "orphaned", "unmanaged"];
296
+ readonly description: "As `RepoSummary.state` in the shared schema.";
297
+ };
298
+ readonly owners: {
299
+ readonly type: "array";
300
+ readonly uniqueItems: true;
301
+ readonly items: {
302
+ readonly $ref: "#/$defs/Did";
303
+ };
304
+ readonly description: "The DIDs holding a live, explicitly recorded `git.repo.own` on it.";
305
+ };
306
+ readonly maintainers: {
307
+ readonly type: "integer";
308
+ readonly minimum: 0;
309
+ readonly description: "How many live records of `git.repo.maintain` it has. Implied rights are not counted.";
310
+ };
311
+ readonly committers: {
312
+ readonly type: "integer";
313
+ readonly minimum: 0;
314
+ readonly description: "How many live records of `git.commit.sign` it has. Implied rights are not counted.";
315
+ };
316
+ readonly bootstrap: {
317
+ readonly $ref: "#/$defs/Bootstrap";
318
+ };
319
+ readonly syncState: {
320
+ readonly type: "string";
321
+ readonly enum: readonly ["inSync", "drift", "pending", "unchecked"];
322
+ readonly description: "As `Sync.state` in the shared schema.";
323
+ };
324
+ readonly checkedAt: {
325
+ readonly type: "string";
326
+ readonly format: "date-time";
327
+ readonly description: "When the forge was last compared. Absent if never.";
328
+ };
329
+ readonly driftCount: {
330
+ readonly type: "integer";
331
+ readonly minimum: 0;
332
+ readonly description: "How many drift items are outstanding. The items themselves are in `git-ns/view`.";
333
+ };
334
+ readonly failedStep: {
335
+ readonly type: "string";
336
+ readonly minLength: 1;
337
+ readonly maxLength: 64;
338
+ readonly description: "The step that failed on the last create or bootstrap.";
339
+ };
340
+ readonly lastError: {
341
+ readonly type: "string";
342
+ readonly minLength: 1;
343
+ readonly maxLength: 4096;
344
+ readonly description: "What the bridge said when that step failed.";
345
+ };
346
+ readonly createdBy: {
347
+ readonly $ref: "#/$defs/Did";
348
+ readonly description: "Who created it through the VTC. Absent for an adopted or unmanaged repository.";
349
+ };
350
+ readonly createdAt: {
351
+ readonly type: "string";
352
+ readonly format: "date-time";
353
+ readonly description: "When the VTC first recorded it.";
354
+ };
355
+ readonly guard: {
356
+ readonly type: "string";
357
+ readonly minLength: 1;
358
+ readonly maxLength: 64;
359
+ readonly description: "The guard in force against a pull request satisfying its own check, as the bridge last reported it: `requiredWorkflow`, `codeOwnerReview`, `bridgePostedCheck`, `protectedFiles` or `none`. A client treats any other value as `none`.";
360
+ };
361
+ readonly steps: {
362
+ readonly type: "array";
363
+ readonly maxItems: 64;
364
+ readonly items: {
365
+ readonly $ref: "#/$defs/StepOutcome";
366
+ };
367
+ readonly description: "Per-step outcomes of the last create, bootstrap or inspect job. Empty until one has been reported.";
368
+ };
369
+ readonly lastCheck: {
370
+ readonly $ref: "#/$defs/LastCheck";
371
+ };
372
+ readonly roleMap: {
373
+ readonly $ref: "#/$defs/RoleMap";
374
+ readonly description: "The forge role each right projects to on this repository under the serving bridge's reported map. Absent while the namespace's map is unknown.";
375
+ };
376
+ readonly roleMapStale: {
377
+ readonly type: "boolean";
378
+ readonly description: "The bridge last projected this repository's roles under an earlier role map, and the re-projection queued for it has not yet succeeded.";
379
+ };
380
+ };
381
+ };
382
+ readonly Response: {
383
+ readonly $anchor: "response";
384
+ readonly title: "Git Namespaces — List Repositories — response payload";
385
+ readonly description: "The repositories in the namespaces the caller administers, or in the one asked for.";
386
+ readonly type: "object";
387
+ readonly additionalProperties: false;
388
+ readonly required: readonly ["repos"];
389
+ readonly properties: {
390
+ readonly repos: {
391
+ readonly type: "array";
392
+ readonly items: {
393
+ readonly $ref: "#/$defs/RepoStatus";
394
+ };
395
+ readonly description: "Every repository recorded in an administered namespace, in any state, ordered by `resource`; for a holder of the community-administrator capability without `namespace`, also every repository whose namespace is no longer bound.";
396
+ };
397
+ readonly ext: {
398
+ readonly $ref: "#/$defs/Ext";
399
+ };
400
+ };
401
+ };
402
+ readonly Ext: {
403
+ readonly title: "Ext";
404
+ 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.";
405
+ readonly type: "object";
406
+ readonly minProperties: 1;
407
+ readonly additionalProperties: true;
408
+ readonly propertyNames: {
409
+ readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
410
+ };
411
+ };
412
+ readonly Did: {
413
+ readonly title: "Did";
414
+ 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.";
415
+ readonly type: "string";
416
+ readonly maxLength: 2048;
417
+ readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
418
+ };
419
+ readonly Bootstrap: {
420
+ readonly title: "Bootstrap";
421
+ readonly description: "Whether each step that turns commit trust on for a repository is in place, as last reported. A step that this forge's plan does not need reads `true`.";
422
+ readonly type: "object";
423
+ readonly additionalProperties: false;
424
+ readonly required: readonly ["workflow", "keyring", "variables", "requiredCheck"];
425
+ readonly properties: {
426
+ readonly workflow: {
427
+ readonly type: "boolean";
428
+ readonly description: "The verify-trust check runs on the repository's pull requests — from a workflow committed to it, or, where the forge supports it, required on it from the namespace's own bridge-managed workflow repository at a pinned commit.";
429
+ };
430
+ readonly keyring: {
431
+ readonly type: "boolean";
432
+ readonly description: "The exempt platform keyring for forge-signed merge commits is committed, or the forge's plan does not need one.";
433
+ };
434
+ readonly variables: {
435
+ readonly type: "boolean";
436
+ readonly description: "The repository names the Trust Registry and this VTC as its trust anchors.";
437
+ };
438
+ readonly requiredCheck: {
439
+ readonly type: "boolean";
440
+ readonly description: "The forge refuses to merge into the default branch unless the verify-trust check passes, with no bypass, and a pull request cannot change what that check runs: an organisation-required workflow, code-owner review of workflow files, or protected workflow paths, as the forge allows.";
441
+ };
442
+ };
443
+ };
444
+ readonly RepoVisibility: {
445
+ readonly title: "RepoVisibility";
446
+ readonly type: "string";
447
+ readonly enum: readonly ["public", "private"];
448
+ readonly description: "Repository visibility on the forge.";
449
+ };
450
+ readonly ForgeId: {
451
+ readonly title: "ForgeId";
452
+ 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.";
453
+ readonly type: "string";
454
+ readonly minLength: 1;
455
+ readonly maxLength: 64;
456
+ };
457
+ readonly RepoResource: {
458
+ readonly title: "RepoResource";
459
+ readonly description: "A forge-qualified resource naming exactly one repository: `<forge-host>/<owner>/<repo>`, lowercase.";
460
+ readonly type: "string";
461
+ readonly maxLength: 455;
462
+ 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}/[a-z0-9_-][a-z0-9._-]{0,99}$";
463
+ };
464
+ readonly NamespaceId: {
465
+ readonly title: "NamespaceId";
466
+ 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.";
467
+ readonly type: "string";
468
+ readonly minLength: 1;
469
+ readonly maxLength: 128;
470
+ };
471
+ };
472
+ };
473
+ /** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
474
+ export declare const RESPONSE_PAYLOAD_SCHEMA: {
475
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
476
+ readonly $ref: "#/$defs/Response";
477
+ readonly $defs: {
478
+ readonly MappedRole: {
479
+ readonly title: "MappedRole";
480
+ readonly type: "string";
481
+ readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
482
+ 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.";
483
+ };
484
+ readonly RoleMap: {
485
+ readonly title: "RoleMap";
486
+ 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`.";
487
+ readonly type: "object";
488
+ readonly additionalProperties: false;
489
+ readonly required: readonly ["own", "maintain", "commit"];
490
+ readonly properties: {
491
+ readonly own: {
492
+ readonly $ref: "#/$defs/MappedRole";
493
+ };
494
+ readonly maintain: {
495
+ readonly $ref: "#/$defs/MappedRole";
496
+ };
497
+ readonly commit: {
498
+ readonly $ref: "#/$defs/MappedRole";
499
+ };
500
+ };
501
+ };
502
+ readonly StepOutcome: {
503
+ readonly title: "StepOutcome";
504
+ readonly description: "One step of the last create, bootstrap or inspect job on the repository, as the bridge reported it.";
505
+ readonly type: "object";
506
+ readonly additionalProperties: false;
507
+ readonly required: readonly ["step", "outcome"];
508
+ readonly properties: {
509
+ readonly step: {
510
+ readonly type: "string";
511
+ readonly minLength: 1;
512
+ readonly maxLength: 64;
513
+ readonly description: "The step, in the bridge's words (`workflow`, `keyring`, `variables`, `requiredCheck`).";
514
+ };
515
+ readonly outcome: {
516
+ readonly type: "string";
517
+ readonly minLength: 1;
518
+ readonly maxLength: 32;
519
+ readonly description: "`applied`, `unchanged`, `failed` or `skipped`. A client shows any other value as reported.";
520
+ };
521
+ readonly detail: {
522
+ readonly type: "string";
523
+ readonly minLength: 1;
524
+ readonly maxLength: 4096;
525
+ readonly description: "What the bridge said about it — an error, or why it was skipped.";
526
+ };
527
+ };
528
+ };
529
+ readonly LastCheck: {
530
+ readonly title: "LastCheck";
531
+ readonly description: "The last verify-trust check run the bridge saw on the repository.";
532
+ readonly type: "object";
533
+ readonly additionalProperties: false;
534
+ readonly required: readonly ["conclusion", "at"];
535
+ readonly properties: {
536
+ readonly conclusion: {
537
+ readonly type: "string";
538
+ readonly minLength: 1;
539
+ readonly maxLength: 64;
540
+ readonly description: "The check's conclusion, in the forge's words (`success`, `failure`).";
541
+ };
542
+ readonly at: {
543
+ readonly type: "string";
544
+ readonly format: "date-time";
545
+ readonly description: "When the check concluded.";
546
+ };
547
+ readonly sha: {
548
+ readonly type: "string";
549
+ readonly minLength: 1;
550
+ readonly maxLength: 64;
551
+ readonly description: "The commit it ran on.";
552
+ };
553
+ };
554
+ };
555
+ readonly RepoStatus: {
556
+ readonly title: "RepoStatus";
557
+ readonly description: "One repository as its administrators govern it: who owns it, how many hold rights on it, how far commit trust is set up, and how its forge compares with the VTC's projection.";
558
+ readonly type: "object";
559
+ readonly additionalProperties: false;
560
+ readonly required: readonly ["id", "namespace", "resource", "visibility", "state", "owners", "maintainers", "committers", "bootstrap", "syncState", "driftCount", "createdAt", "steps", "roleMapStale"];
561
+ readonly properties: {
562
+ readonly id: {
563
+ readonly type: "string";
564
+ readonly minLength: 1;
565
+ readonly maxLength: 128;
566
+ readonly description: "The VTC's identifier for the repository record.";
567
+ };
568
+ readonly namespace: {
569
+ readonly $ref: "#/$defs/NamespaceId";
570
+ readonly description: "The namespace it was recorded in. For a `detached` repository, possibly one no longer bound.";
571
+ };
572
+ readonly resource: {
573
+ readonly $ref: "#/$defs/RepoResource";
574
+ };
575
+ readonly forgeId: {
576
+ readonly $ref: "#/$defs/ForgeId";
577
+ readonly description: "The forge's repository id, once confirmed.";
578
+ };
579
+ readonly visibility: {
580
+ readonly $ref: "#/$defs/RepoVisibility";
581
+ };
582
+ readonly state: {
583
+ readonly type: "string";
584
+ readonly enum: readonly ["pendingCreate", "active", "archived", "detached", "orphaned", "unmanaged"];
585
+ readonly description: "As `RepoSummary.state` in the shared schema.";
586
+ };
587
+ readonly owners: {
588
+ readonly type: "array";
589
+ readonly uniqueItems: true;
590
+ readonly items: {
591
+ readonly $ref: "#/$defs/Did";
592
+ };
593
+ readonly description: "The DIDs holding a live, explicitly recorded `git.repo.own` on it.";
594
+ };
595
+ readonly maintainers: {
596
+ readonly type: "integer";
597
+ readonly minimum: 0;
598
+ readonly description: "How many live records of `git.repo.maintain` it has. Implied rights are not counted.";
599
+ };
600
+ readonly committers: {
601
+ readonly type: "integer";
602
+ readonly minimum: 0;
603
+ readonly description: "How many live records of `git.commit.sign` it has. Implied rights are not counted.";
604
+ };
605
+ readonly bootstrap: {
606
+ readonly $ref: "#/$defs/Bootstrap";
607
+ };
608
+ readonly syncState: {
609
+ readonly type: "string";
610
+ readonly enum: readonly ["inSync", "drift", "pending", "unchecked"];
611
+ readonly description: "As `Sync.state` in the shared schema.";
612
+ };
613
+ readonly checkedAt: {
614
+ readonly type: "string";
615
+ readonly format: "date-time";
616
+ readonly description: "When the forge was last compared. Absent if never.";
617
+ };
618
+ readonly driftCount: {
619
+ readonly type: "integer";
620
+ readonly minimum: 0;
621
+ readonly description: "How many drift items are outstanding. The items themselves are in `git-ns/view`.";
622
+ };
623
+ readonly failedStep: {
624
+ readonly type: "string";
625
+ readonly minLength: 1;
626
+ readonly maxLength: 64;
627
+ readonly description: "The step that failed on the last create or bootstrap.";
628
+ };
629
+ readonly lastError: {
630
+ readonly type: "string";
631
+ readonly minLength: 1;
632
+ readonly maxLength: 4096;
633
+ readonly description: "What the bridge said when that step failed.";
634
+ };
635
+ readonly createdBy: {
636
+ readonly $ref: "#/$defs/Did";
637
+ readonly description: "Who created it through the VTC. Absent for an adopted or unmanaged repository.";
638
+ };
639
+ readonly createdAt: {
640
+ readonly type: "string";
641
+ readonly format: "date-time";
642
+ readonly description: "When the VTC first recorded it.";
643
+ };
644
+ readonly guard: {
645
+ readonly type: "string";
646
+ readonly minLength: 1;
647
+ readonly maxLength: 64;
648
+ readonly description: "The guard in force against a pull request satisfying its own check, as the bridge last reported it: `requiredWorkflow`, `codeOwnerReview`, `bridgePostedCheck`, `protectedFiles` or `none`. A client treats any other value as `none`.";
649
+ };
650
+ readonly steps: {
651
+ readonly type: "array";
652
+ readonly maxItems: 64;
653
+ readonly items: {
654
+ readonly $ref: "#/$defs/StepOutcome";
655
+ };
656
+ readonly description: "Per-step outcomes of the last create, bootstrap or inspect job. Empty until one has been reported.";
657
+ };
658
+ readonly lastCheck: {
659
+ readonly $ref: "#/$defs/LastCheck";
660
+ };
661
+ readonly roleMap: {
662
+ readonly $ref: "#/$defs/RoleMap";
663
+ readonly description: "The forge role each right projects to on this repository under the serving bridge's reported map. Absent while the namespace's map is unknown.";
664
+ };
665
+ readonly roleMapStale: {
666
+ readonly type: "boolean";
667
+ readonly description: "The bridge last projected this repository's roles under an earlier role map, and the re-projection queued for it has not yet succeeded.";
668
+ };
669
+ };
670
+ };
671
+ readonly Response: {
672
+ readonly $anchor: "response";
673
+ readonly title: "Git Namespaces — List Repositories — response payload";
674
+ readonly description: "The repositories in the namespaces the caller administers, or in the one asked for.";
675
+ readonly type: "object";
676
+ readonly additionalProperties: false;
677
+ readonly required: readonly ["repos"];
678
+ readonly properties: {
679
+ readonly repos: {
680
+ readonly type: "array";
681
+ readonly items: {
682
+ readonly $ref: "#/$defs/RepoStatus";
683
+ };
684
+ readonly description: "Every repository recorded in an administered namespace, in any state, ordered by `resource`; for a holder of the community-administrator capability without `namespace`, also every repository whose namespace is no longer bound.";
685
+ };
686
+ readonly ext: {
687
+ readonly $ref: "#/$defs/Ext";
688
+ };
689
+ };
690
+ };
691
+ readonly Ext: {
692
+ readonly title: "Ext";
693
+ 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.";
694
+ readonly type: "object";
695
+ readonly minProperties: 1;
696
+ readonly additionalProperties: true;
697
+ readonly propertyNames: {
698
+ readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
699
+ };
700
+ };
701
+ readonly Did: {
702
+ readonly title: "Did";
703
+ 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.";
704
+ readonly type: "string";
705
+ readonly maxLength: 2048;
706
+ readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
707
+ };
708
+ readonly Bootstrap: {
709
+ readonly title: "Bootstrap";
710
+ readonly description: "Whether each step that turns commit trust on for a repository is in place, as last reported. A step that this forge's plan does not need reads `true`.";
711
+ readonly type: "object";
712
+ readonly additionalProperties: false;
713
+ readonly required: readonly ["workflow", "keyring", "variables", "requiredCheck"];
714
+ readonly properties: {
715
+ readonly workflow: {
716
+ readonly type: "boolean";
717
+ readonly description: "The verify-trust check runs on the repository's pull requests — from a workflow committed to it, or, where the forge supports it, required on it from the namespace's own bridge-managed workflow repository at a pinned commit.";
718
+ };
719
+ readonly keyring: {
720
+ readonly type: "boolean";
721
+ readonly description: "The exempt platform keyring for forge-signed merge commits is committed, or the forge's plan does not need one.";
722
+ };
723
+ readonly variables: {
724
+ readonly type: "boolean";
725
+ readonly description: "The repository names the Trust Registry and this VTC as its trust anchors.";
726
+ };
727
+ readonly requiredCheck: {
728
+ readonly type: "boolean";
729
+ readonly description: "The forge refuses to merge into the default branch unless the verify-trust check passes, with no bypass, and a pull request cannot change what that check runs: an organisation-required workflow, code-owner review of workflow files, or protected workflow paths, as the forge allows.";
730
+ };
731
+ };
732
+ };
733
+ readonly RepoVisibility: {
734
+ readonly title: "RepoVisibility";
735
+ readonly type: "string";
736
+ readonly enum: readonly ["public", "private"];
737
+ readonly description: "Repository visibility on the forge.";
738
+ };
739
+ readonly ForgeId: {
740
+ readonly title: "ForgeId";
741
+ 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.";
742
+ readonly type: "string";
743
+ readonly minLength: 1;
744
+ readonly maxLength: 64;
745
+ };
746
+ readonly RepoResource: {
747
+ readonly title: "RepoResource";
748
+ readonly description: "A forge-qualified resource naming exactly one repository: `<forge-host>/<owner>/<repo>`, lowercase.";
749
+ readonly type: "string";
750
+ readonly maxLength: 455;
751
+ 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}/[a-z0-9_-][a-z0-9._-]{0,99}$";
752
+ };
753
+ readonly NamespaceId: {
754
+ readonly title: "NamespaceId";
755
+ 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.";
756
+ readonly type: "string";
757
+ readonly minLength: 1;
758
+ readonly maxLength: 128;
759
+ };
760
+ };
761
+ };
762
+ /**
763
+ * SPEC.md §7.2 policy for the request variant, from this specification's
764
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
765
+ * per-specification and cannot be derived from the document alone, and
766
+ * item 2 needs the schema this carries.
767
+ */
768
+ export declare const SPEC: {
769
+ readonly typeUri: "https://trusttasks.org/spec/git-ns/repo/list/0.1";
770
+ readonly isBearer: false;
771
+ readonly isProofRequired: true;
772
+ readonly isRecipientRequired: true;
773
+ readonly isIssuedAtRequired: false;
774
+ readonly payloadSchema: {
775
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
776
+ readonly $id: "https://trusttasks.org/spec/git-ns/repo/list/0.1";
777
+ readonly title: "Git Namespaces — List Repositories — payload";
778
+ readonly description: "An administrator lists the repositories recorded in the namespaces they administer — every one, for a holder of the community-administrator capability — with owners, right counts, bootstrap, sync and forge status.";
779
+ readonly type: "object";
780
+ readonly additionalProperties: false;
781
+ readonly required: readonly [];
782
+ readonly properties: {
783
+ readonly namespace: {
784
+ readonly $ref: "#/$defs/NamespaceId";
785
+ readonly description: "Only the repositories in 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.";
786
+ };
787
+ readonly ext: {
788
+ readonly $ref: "#/$defs/Ext";
789
+ };
790
+ };
791
+ readonly $defs: {
792
+ readonly MappedRole: {
793
+ readonly title: "MappedRole";
794
+ readonly type: "string";
795
+ readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
796
+ 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.";
797
+ };
798
+ readonly RoleMap: {
799
+ readonly title: "RoleMap";
800
+ 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`.";
801
+ readonly type: "object";
802
+ readonly additionalProperties: false;
803
+ readonly required: readonly ["own", "maintain", "commit"];
804
+ readonly properties: {
805
+ readonly own: {
806
+ readonly $ref: "#/$defs/MappedRole";
807
+ };
808
+ readonly maintain: {
809
+ readonly $ref: "#/$defs/MappedRole";
810
+ };
811
+ readonly commit: {
812
+ readonly $ref: "#/$defs/MappedRole";
813
+ };
814
+ };
815
+ };
816
+ readonly StepOutcome: {
817
+ readonly title: "StepOutcome";
818
+ readonly description: "One step of the last create, bootstrap or inspect job on the repository, as the bridge reported it.";
819
+ readonly type: "object";
820
+ readonly additionalProperties: false;
821
+ readonly required: readonly ["step", "outcome"];
822
+ readonly properties: {
823
+ readonly step: {
824
+ readonly type: "string";
825
+ readonly minLength: 1;
826
+ readonly maxLength: 64;
827
+ readonly description: "The step, in the bridge's words (`workflow`, `keyring`, `variables`, `requiredCheck`).";
828
+ };
829
+ readonly outcome: {
830
+ readonly type: "string";
831
+ readonly minLength: 1;
832
+ readonly maxLength: 32;
833
+ readonly description: "`applied`, `unchanged`, `failed` or `skipped`. A client shows any other value as reported.";
834
+ };
835
+ readonly detail: {
836
+ readonly type: "string";
837
+ readonly minLength: 1;
838
+ readonly maxLength: 4096;
839
+ readonly description: "What the bridge said about it — an error, or why it was skipped.";
840
+ };
841
+ };
842
+ };
843
+ readonly LastCheck: {
844
+ readonly title: "LastCheck";
845
+ readonly description: "The last verify-trust check run the bridge saw on the repository.";
846
+ readonly type: "object";
847
+ readonly additionalProperties: false;
848
+ readonly required: readonly ["conclusion", "at"];
849
+ readonly properties: {
850
+ readonly conclusion: {
851
+ readonly type: "string";
852
+ readonly minLength: 1;
853
+ readonly maxLength: 64;
854
+ readonly description: "The check's conclusion, in the forge's words (`success`, `failure`).";
855
+ };
856
+ readonly at: {
857
+ readonly type: "string";
858
+ readonly format: "date-time";
859
+ readonly description: "When the check concluded.";
860
+ };
861
+ readonly sha: {
862
+ readonly type: "string";
863
+ readonly minLength: 1;
864
+ readonly maxLength: 64;
865
+ readonly description: "The commit it ran on.";
866
+ };
867
+ };
868
+ };
869
+ readonly RepoStatus: {
870
+ readonly title: "RepoStatus";
871
+ readonly description: "One repository as its administrators govern it: who owns it, how many hold rights on it, how far commit trust is set up, and how its forge compares with the VTC's projection.";
872
+ readonly type: "object";
873
+ readonly additionalProperties: false;
874
+ readonly required: readonly ["id", "namespace", "resource", "visibility", "state", "owners", "maintainers", "committers", "bootstrap", "syncState", "driftCount", "createdAt", "steps", "roleMapStale"];
875
+ readonly properties: {
876
+ readonly id: {
877
+ readonly type: "string";
878
+ readonly minLength: 1;
879
+ readonly maxLength: 128;
880
+ readonly description: "The VTC's identifier for the repository record.";
881
+ };
882
+ readonly namespace: {
883
+ readonly $ref: "#/$defs/NamespaceId";
884
+ readonly description: "The namespace it was recorded in. For a `detached` repository, possibly one no longer bound.";
885
+ };
886
+ readonly resource: {
887
+ readonly $ref: "#/$defs/RepoResource";
888
+ };
889
+ readonly forgeId: {
890
+ readonly $ref: "#/$defs/ForgeId";
891
+ readonly description: "The forge's repository id, once confirmed.";
892
+ };
893
+ readonly visibility: {
894
+ readonly $ref: "#/$defs/RepoVisibility";
895
+ };
896
+ readonly state: {
897
+ readonly type: "string";
898
+ readonly enum: readonly ["pendingCreate", "active", "archived", "detached", "orphaned", "unmanaged"];
899
+ readonly description: "As `RepoSummary.state` in the shared schema.";
900
+ };
901
+ readonly owners: {
902
+ readonly type: "array";
903
+ readonly uniqueItems: true;
904
+ readonly items: {
905
+ readonly $ref: "#/$defs/Did";
906
+ };
907
+ readonly description: "The DIDs holding a live, explicitly recorded `git.repo.own` on it.";
908
+ };
909
+ readonly maintainers: {
910
+ readonly type: "integer";
911
+ readonly minimum: 0;
912
+ readonly description: "How many live records of `git.repo.maintain` it has. Implied rights are not counted.";
913
+ };
914
+ readonly committers: {
915
+ readonly type: "integer";
916
+ readonly minimum: 0;
917
+ readonly description: "How many live records of `git.commit.sign` it has. Implied rights are not counted.";
918
+ };
919
+ readonly bootstrap: {
920
+ readonly $ref: "#/$defs/Bootstrap";
921
+ };
922
+ readonly syncState: {
923
+ readonly type: "string";
924
+ readonly enum: readonly ["inSync", "drift", "pending", "unchecked"];
925
+ readonly description: "As `Sync.state` in the shared schema.";
926
+ };
927
+ readonly checkedAt: {
928
+ readonly type: "string";
929
+ readonly format: "date-time";
930
+ readonly description: "When the forge was last compared. Absent if never.";
931
+ };
932
+ readonly driftCount: {
933
+ readonly type: "integer";
934
+ readonly minimum: 0;
935
+ readonly description: "How many drift items are outstanding. The items themselves are in `git-ns/view`.";
936
+ };
937
+ readonly failedStep: {
938
+ readonly type: "string";
939
+ readonly minLength: 1;
940
+ readonly maxLength: 64;
941
+ readonly description: "The step that failed on the last create or bootstrap.";
942
+ };
943
+ readonly lastError: {
944
+ readonly type: "string";
945
+ readonly minLength: 1;
946
+ readonly maxLength: 4096;
947
+ readonly description: "What the bridge said when that step failed.";
948
+ };
949
+ readonly createdBy: {
950
+ readonly $ref: "#/$defs/Did";
951
+ readonly description: "Who created it through the VTC. Absent for an adopted or unmanaged repository.";
952
+ };
953
+ readonly createdAt: {
954
+ readonly type: "string";
955
+ readonly format: "date-time";
956
+ readonly description: "When the VTC first recorded it.";
957
+ };
958
+ readonly guard: {
959
+ readonly type: "string";
960
+ readonly minLength: 1;
961
+ readonly maxLength: 64;
962
+ readonly description: "The guard in force against a pull request satisfying its own check, as the bridge last reported it: `requiredWorkflow`, `codeOwnerReview`, `bridgePostedCheck`, `protectedFiles` or `none`. A client treats any other value as `none`.";
963
+ };
964
+ readonly steps: {
965
+ readonly type: "array";
966
+ readonly maxItems: 64;
967
+ readonly items: {
968
+ readonly $ref: "#/$defs/StepOutcome";
969
+ };
970
+ readonly description: "Per-step outcomes of the last create, bootstrap or inspect job. Empty until one has been reported.";
971
+ };
972
+ readonly lastCheck: {
973
+ readonly $ref: "#/$defs/LastCheck";
974
+ };
975
+ readonly roleMap: {
976
+ readonly $ref: "#/$defs/RoleMap";
977
+ readonly description: "The forge role each right projects to on this repository under the serving bridge's reported map. Absent while the namespace's map is unknown.";
978
+ };
979
+ readonly roleMapStale: {
980
+ readonly type: "boolean";
981
+ readonly description: "The bridge last projected this repository's roles under an earlier role map, and the re-projection queued for it has not yet succeeded.";
982
+ };
983
+ };
984
+ };
985
+ readonly Response: {
986
+ readonly $anchor: "response";
987
+ readonly title: "Git Namespaces — List Repositories — response payload";
988
+ readonly description: "The repositories in the namespaces the caller administers, or in the one asked for.";
989
+ readonly type: "object";
990
+ readonly additionalProperties: false;
991
+ readonly required: readonly ["repos"];
992
+ readonly properties: {
993
+ readonly repos: {
994
+ readonly type: "array";
995
+ readonly items: {
996
+ readonly $ref: "#/$defs/RepoStatus";
997
+ };
998
+ readonly description: "Every repository recorded in an administered namespace, in any state, ordered by `resource`; for a holder of the community-administrator capability without `namespace`, also every repository whose namespace is no longer bound.";
999
+ };
1000
+ readonly ext: {
1001
+ readonly $ref: "#/$defs/Ext";
1002
+ };
1003
+ };
1004
+ };
1005
+ readonly Ext: {
1006
+ readonly title: "Ext";
1007
+ 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.";
1008
+ readonly type: "object";
1009
+ readonly minProperties: 1;
1010
+ readonly additionalProperties: true;
1011
+ readonly propertyNames: {
1012
+ readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
1013
+ };
1014
+ };
1015
+ readonly Did: {
1016
+ readonly title: "Did";
1017
+ 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.";
1018
+ readonly type: "string";
1019
+ readonly maxLength: 2048;
1020
+ readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
1021
+ };
1022
+ readonly Bootstrap: {
1023
+ readonly title: "Bootstrap";
1024
+ readonly description: "Whether each step that turns commit trust on for a repository is in place, as last reported. A step that this forge's plan does not need reads `true`.";
1025
+ readonly type: "object";
1026
+ readonly additionalProperties: false;
1027
+ readonly required: readonly ["workflow", "keyring", "variables", "requiredCheck"];
1028
+ readonly properties: {
1029
+ readonly workflow: {
1030
+ readonly type: "boolean";
1031
+ readonly description: "The verify-trust check runs on the repository's pull requests — from a workflow committed to it, or, where the forge supports it, required on it from the namespace's own bridge-managed workflow repository at a pinned commit.";
1032
+ };
1033
+ readonly keyring: {
1034
+ readonly type: "boolean";
1035
+ readonly description: "The exempt platform keyring for forge-signed merge commits is committed, or the forge's plan does not need one.";
1036
+ };
1037
+ readonly variables: {
1038
+ readonly type: "boolean";
1039
+ readonly description: "The repository names the Trust Registry and this VTC as its trust anchors.";
1040
+ };
1041
+ readonly requiredCheck: {
1042
+ readonly type: "boolean";
1043
+ readonly description: "The forge refuses to merge into the default branch unless the verify-trust check passes, with no bypass, and a pull request cannot change what that check runs: an organisation-required workflow, code-owner review of workflow files, or protected workflow paths, as the forge allows.";
1044
+ };
1045
+ };
1046
+ };
1047
+ readonly RepoVisibility: {
1048
+ readonly title: "RepoVisibility";
1049
+ readonly type: "string";
1050
+ readonly enum: readonly ["public", "private"];
1051
+ readonly description: "Repository visibility on the forge.";
1052
+ };
1053
+ readonly ForgeId: {
1054
+ readonly title: "ForgeId";
1055
+ 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.";
1056
+ readonly type: "string";
1057
+ readonly minLength: 1;
1058
+ readonly maxLength: 64;
1059
+ };
1060
+ readonly RepoResource: {
1061
+ readonly title: "RepoResource";
1062
+ readonly description: "A forge-qualified resource naming exactly one repository: `<forge-host>/<owner>/<repo>`, lowercase.";
1063
+ readonly type: "string";
1064
+ readonly maxLength: 455;
1065
+ 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}/[a-z0-9_-][a-z0-9._-]{0,99}$";
1066
+ };
1067
+ readonly NamespaceId: {
1068
+ readonly title: "NamespaceId";
1069
+ 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.";
1070
+ readonly type: "string";
1071
+ readonly minLength: 1;
1072
+ readonly maxLength: 128;
1073
+ };
1074
+ };
1075
+ };
1076
+ };
1077
+ /**
1078
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
1079
+ * tracks the *issuer* party's requirement because a response swaps the
1080
+ * parties (§7.3 item 5).
1081
+ */
1082
+ export declare const RESPONSE_SPEC: {
1083
+ readonly typeUri: "https://trusttasks.org/spec/git-ns/repo/list/0.1#response";
1084
+ readonly isBearer: false;
1085
+ readonly isProofRequired: true;
1086
+ readonly isRecipientRequired: true;
1087
+ readonly isIssuedAtRequired: false;
1088
+ readonly payloadSchema: {
1089
+ readonly $schema: "https://json-schema.org/draft/2020-12/schema";
1090
+ readonly $ref: "#/$defs/Response";
1091
+ readonly $defs: {
1092
+ readonly MappedRole: {
1093
+ readonly title: "MappedRole";
1094
+ readonly type: "string";
1095
+ readonly enum: readonly ["none", "read", "triage", "write", "maintain", "admin"];
1096
+ 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.";
1097
+ };
1098
+ readonly RoleMap: {
1099
+ readonly title: "RoleMap";
1100
+ 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`.";
1101
+ readonly type: "object";
1102
+ readonly additionalProperties: false;
1103
+ readonly required: readonly ["own", "maintain", "commit"];
1104
+ readonly properties: {
1105
+ readonly own: {
1106
+ readonly $ref: "#/$defs/MappedRole";
1107
+ };
1108
+ readonly maintain: {
1109
+ readonly $ref: "#/$defs/MappedRole";
1110
+ };
1111
+ readonly commit: {
1112
+ readonly $ref: "#/$defs/MappedRole";
1113
+ };
1114
+ };
1115
+ };
1116
+ readonly StepOutcome: {
1117
+ readonly title: "StepOutcome";
1118
+ readonly description: "One step of the last create, bootstrap or inspect job on the repository, as the bridge reported it.";
1119
+ readonly type: "object";
1120
+ readonly additionalProperties: false;
1121
+ readonly required: readonly ["step", "outcome"];
1122
+ readonly properties: {
1123
+ readonly step: {
1124
+ readonly type: "string";
1125
+ readonly minLength: 1;
1126
+ readonly maxLength: 64;
1127
+ readonly description: "The step, in the bridge's words (`workflow`, `keyring`, `variables`, `requiredCheck`).";
1128
+ };
1129
+ readonly outcome: {
1130
+ readonly type: "string";
1131
+ readonly minLength: 1;
1132
+ readonly maxLength: 32;
1133
+ readonly description: "`applied`, `unchanged`, `failed` or `skipped`. A client shows any other value as reported.";
1134
+ };
1135
+ readonly detail: {
1136
+ readonly type: "string";
1137
+ readonly minLength: 1;
1138
+ readonly maxLength: 4096;
1139
+ readonly description: "What the bridge said about it — an error, or why it was skipped.";
1140
+ };
1141
+ };
1142
+ };
1143
+ readonly LastCheck: {
1144
+ readonly title: "LastCheck";
1145
+ readonly description: "The last verify-trust check run the bridge saw on the repository.";
1146
+ readonly type: "object";
1147
+ readonly additionalProperties: false;
1148
+ readonly required: readonly ["conclusion", "at"];
1149
+ readonly properties: {
1150
+ readonly conclusion: {
1151
+ readonly type: "string";
1152
+ readonly minLength: 1;
1153
+ readonly maxLength: 64;
1154
+ readonly description: "The check's conclusion, in the forge's words (`success`, `failure`).";
1155
+ };
1156
+ readonly at: {
1157
+ readonly type: "string";
1158
+ readonly format: "date-time";
1159
+ readonly description: "When the check concluded.";
1160
+ };
1161
+ readonly sha: {
1162
+ readonly type: "string";
1163
+ readonly minLength: 1;
1164
+ readonly maxLength: 64;
1165
+ readonly description: "The commit it ran on.";
1166
+ };
1167
+ };
1168
+ };
1169
+ readonly RepoStatus: {
1170
+ readonly title: "RepoStatus";
1171
+ readonly description: "One repository as its administrators govern it: who owns it, how many hold rights on it, how far commit trust is set up, and how its forge compares with the VTC's projection.";
1172
+ readonly type: "object";
1173
+ readonly additionalProperties: false;
1174
+ readonly required: readonly ["id", "namespace", "resource", "visibility", "state", "owners", "maintainers", "committers", "bootstrap", "syncState", "driftCount", "createdAt", "steps", "roleMapStale"];
1175
+ readonly properties: {
1176
+ readonly id: {
1177
+ readonly type: "string";
1178
+ readonly minLength: 1;
1179
+ readonly maxLength: 128;
1180
+ readonly description: "The VTC's identifier for the repository record.";
1181
+ };
1182
+ readonly namespace: {
1183
+ readonly $ref: "#/$defs/NamespaceId";
1184
+ readonly description: "The namespace it was recorded in. For a `detached` repository, possibly one no longer bound.";
1185
+ };
1186
+ readonly resource: {
1187
+ readonly $ref: "#/$defs/RepoResource";
1188
+ };
1189
+ readonly forgeId: {
1190
+ readonly $ref: "#/$defs/ForgeId";
1191
+ readonly description: "The forge's repository id, once confirmed.";
1192
+ };
1193
+ readonly visibility: {
1194
+ readonly $ref: "#/$defs/RepoVisibility";
1195
+ };
1196
+ readonly state: {
1197
+ readonly type: "string";
1198
+ readonly enum: readonly ["pendingCreate", "active", "archived", "detached", "orphaned", "unmanaged"];
1199
+ readonly description: "As `RepoSummary.state` in the shared schema.";
1200
+ };
1201
+ readonly owners: {
1202
+ readonly type: "array";
1203
+ readonly uniqueItems: true;
1204
+ readonly items: {
1205
+ readonly $ref: "#/$defs/Did";
1206
+ };
1207
+ readonly description: "The DIDs holding a live, explicitly recorded `git.repo.own` on it.";
1208
+ };
1209
+ readonly maintainers: {
1210
+ readonly type: "integer";
1211
+ readonly minimum: 0;
1212
+ readonly description: "How many live records of `git.repo.maintain` it has. Implied rights are not counted.";
1213
+ };
1214
+ readonly committers: {
1215
+ readonly type: "integer";
1216
+ readonly minimum: 0;
1217
+ readonly description: "How many live records of `git.commit.sign` it has. Implied rights are not counted.";
1218
+ };
1219
+ readonly bootstrap: {
1220
+ readonly $ref: "#/$defs/Bootstrap";
1221
+ };
1222
+ readonly syncState: {
1223
+ readonly type: "string";
1224
+ readonly enum: readonly ["inSync", "drift", "pending", "unchecked"];
1225
+ readonly description: "As `Sync.state` in the shared schema.";
1226
+ };
1227
+ readonly checkedAt: {
1228
+ readonly type: "string";
1229
+ readonly format: "date-time";
1230
+ readonly description: "When the forge was last compared. Absent if never.";
1231
+ };
1232
+ readonly driftCount: {
1233
+ readonly type: "integer";
1234
+ readonly minimum: 0;
1235
+ readonly description: "How many drift items are outstanding. The items themselves are in `git-ns/view`.";
1236
+ };
1237
+ readonly failedStep: {
1238
+ readonly type: "string";
1239
+ readonly minLength: 1;
1240
+ readonly maxLength: 64;
1241
+ readonly description: "The step that failed on the last create or bootstrap.";
1242
+ };
1243
+ readonly lastError: {
1244
+ readonly type: "string";
1245
+ readonly minLength: 1;
1246
+ readonly maxLength: 4096;
1247
+ readonly description: "What the bridge said when that step failed.";
1248
+ };
1249
+ readonly createdBy: {
1250
+ readonly $ref: "#/$defs/Did";
1251
+ readonly description: "Who created it through the VTC. Absent for an adopted or unmanaged repository.";
1252
+ };
1253
+ readonly createdAt: {
1254
+ readonly type: "string";
1255
+ readonly format: "date-time";
1256
+ readonly description: "When the VTC first recorded it.";
1257
+ };
1258
+ readonly guard: {
1259
+ readonly type: "string";
1260
+ readonly minLength: 1;
1261
+ readonly maxLength: 64;
1262
+ readonly description: "The guard in force against a pull request satisfying its own check, as the bridge last reported it: `requiredWorkflow`, `codeOwnerReview`, `bridgePostedCheck`, `protectedFiles` or `none`. A client treats any other value as `none`.";
1263
+ };
1264
+ readonly steps: {
1265
+ readonly type: "array";
1266
+ readonly maxItems: 64;
1267
+ readonly items: {
1268
+ readonly $ref: "#/$defs/StepOutcome";
1269
+ };
1270
+ readonly description: "Per-step outcomes of the last create, bootstrap or inspect job. Empty until one has been reported.";
1271
+ };
1272
+ readonly lastCheck: {
1273
+ readonly $ref: "#/$defs/LastCheck";
1274
+ };
1275
+ readonly roleMap: {
1276
+ readonly $ref: "#/$defs/RoleMap";
1277
+ readonly description: "The forge role each right projects to on this repository under the serving bridge's reported map. Absent while the namespace's map is unknown.";
1278
+ };
1279
+ readonly roleMapStale: {
1280
+ readonly type: "boolean";
1281
+ readonly description: "The bridge last projected this repository's roles under an earlier role map, and the re-projection queued for it has not yet succeeded.";
1282
+ };
1283
+ };
1284
+ };
1285
+ readonly Response: {
1286
+ readonly $anchor: "response";
1287
+ readonly title: "Git Namespaces — List Repositories — response payload";
1288
+ readonly description: "The repositories in the namespaces the caller administers, or in the one asked for.";
1289
+ readonly type: "object";
1290
+ readonly additionalProperties: false;
1291
+ readonly required: readonly ["repos"];
1292
+ readonly properties: {
1293
+ readonly repos: {
1294
+ readonly type: "array";
1295
+ readonly items: {
1296
+ readonly $ref: "#/$defs/RepoStatus";
1297
+ };
1298
+ readonly description: "Every repository recorded in an administered namespace, in any state, ordered by `resource`; for a holder of the community-administrator capability without `namespace`, also every repository whose namespace is no longer bound.";
1299
+ };
1300
+ readonly ext: {
1301
+ readonly $ref: "#/$defs/Ext";
1302
+ };
1303
+ };
1304
+ };
1305
+ readonly Ext: {
1306
+ readonly title: "Ext";
1307
+ 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.";
1308
+ readonly type: "object";
1309
+ readonly minProperties: 1;
1310
+ readonly additionalProperties: true;
1311
+ readonly propertyNames: {
1312
+ readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
1313
+ };
1314
+ };
1315
+ readonly Did: {
1316
+ readonly title: "Did";
1317
+ 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.";
1318
+ readonly type: "string";
1319
+ readonly maxLength: 2048;
1320
+ readonly pattern: "^did:[a-z0-9]+:(?:(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[A-Za-z0-9._-]|%[0-9A-Fa-f]{2})+$";
1321
+ };
1322
+ readonly Bootstrap: {
1323
+ readonly title: "Bootstrap";
1324
+ readonly description: "Whether each step that turns commit trust on for a repository is in place, as last reported. A step that this forge's plan does not need reads `true`.";
1325
+ readonly type: "object";
1326
+ readonly additionalProperties: false;
1327
+ readonly required: readonly ["workflow", "keyring", "variables", "requiredCheck"];
1328
+ readonly properties: {
1329
+ readonly workflow: {
1330
+ readonly type: "boolean";
1331
+ readonly description: "The verify-trust check runs on the repository's pull requests — from a workflow committed to it, or, where the forge supports it, required on it from the namespace's own bridge-managed workflow repository at a pinned commit.";
1332
+ };
1333
+ readonly keyring: {
1334
+ readonly type: "boolean";
1335
+ readonly description: "The exempt platform keyring for forge-signed merge commits is committed, or the forge's plan does not need one.";
1336
+ };
1337
+ readonly variables: {
1338
+ readonly type: "boolean";
1339
+ readonly description: "The repository names the Trust Registry and this VTC as its trust anchors.";
1340
+ };
1341
+ readonly requiredCheck: {
1342
+ readonly type: "boolean";
1343
+ readonly description: "The forge refuses to merge into the default branch unless the verify-trust check passes, with no bypass, and a pull request cannot change what that check runs: an organisation-required workflow, code-owner review of workflow files, or protected workflow paths, as the forge allows.";
1344
+ };
1345
+ };
1346
+ };
1347
+ readonly RepoVisibility: {
1348
+ readonly title: "RepoVisibility";
1349
+ readonly type: "string";
1350
+ readonly enum: readonly ["public", "private"];
1351
+ readonly description: "Repository visibility on the forge.";
1352
+ };
1353
+ readonly ForgeId: {
1354
+ readonly title: "ForgeId";
1355
+ 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.";
1356
+ readonly type: "string";
1357
+ readonly minLength: 1;
1358
+ readonly maxLength: 64;
1359
+ };
1360
+ readonly RepoResource: {
1361
+ readonly title: "RepoResource";
1362
+ readonly description: "A forge-qualified resource naming exactly one repository: `<forge-host>/<owner>/<repo>`, lowercase.";
1363
+ readonly type: "string";
1364
+ readonly maxLength: 455;
1365
+ 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}/[a-z0-9_-][a-z0-9._-]{0,99}$";
1366
+ };
1367
+ readonly NamespaceId: {
1368
+ readonly title: "NamespaceId";
1369
+ 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.";
1370
+ readonly type: "string";
1371
+ readonly minLength: 1;
1372
+ readonly maxLength: 128;
1373
+ };
1374
+ };
1375
+ };
1376
+ };
1377
+ //# sourceMappingURL=payload.d.ts.map