@open-agent-toolkit/cli 0.2.73 → 0.2.75

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 (149) hide show
  1. package/assets/bundle-metadata.json +1 -1
  2. package/assets/docs/cli-utilities/configuration.md +3 -56
  3. package/assets/docs/cli-utilities/tool-packs.md +4 -4
  4. package/assets/docs/contributing/code.md +2 -2
  5. package/assets/docs/contributing/index.md +0 -1
  6. package/assets/docs/reference/cli-reference.md +1 -1
  7. package/assets/docs/reference/troubleshooting.md +17 -40
  8. package/assets/docs/workflows/projects/artifacts.md +16 -34
  9. package/assets/docs/workflows/projects/lifecycle.md +20 -19
  10. package/assets/docs/workflows/skills/explainer-kit.md +180 -440
  11. package/assets/docs/workflows/skills/index.md +1 -2
  12. package/assets/public-package-versions.json +4 -4
  13. package/assets/skills/explainer-kit/SKILL.md +96 -171
  14. package/assets/skills/explainer-kit/recipes/engineer-tour.json +1 -22
  15. package/assets/skills/explainer-kit/recipes/program-recap.json +1 -29
  16. package/assets/skills/explainer-kit/recipes/project-explainer.json +1 -22
  17. package/assets/skills/explainer-kit/recipes/project-recap.v2.json +1 -43
  18. package/assets/skills/explainer-kit/references/fact-base-contract.md +76 -101
  19. package/assets/skills/explainer-kit/references/recap-authoring.md +99 -0
  20. package/assets/skills/explainer-kit/schemas/manifest.schema.json +13 -135
  21. package/assets/skills/explainer-kit/scripts/bundle.mjs +712 -0
  22. package/assets/skills/explainer-kit/scripts/lib/claim-subject.mjs +40 -0
  23. package/assets/skills/explainer-kit/scripts/lib/contracts.mjs +113 -1504
  24. package/assets/skills/explainer-kit/scripts/lib/failure.mjs +13 -0
  25. package/assets/skills/explainer-kit/scripts/lib/package-coverage.mjs +57 -403
  26. package/assets/skills/explainer-kit/scripts/lib/qa-result.mjs +168 -0
  27. package/assets/skills/explainer-kit/scripts/lib/qa.mjs +90 -488
  28. package/assets/skills/explainer-kit/scripts/lib/recipes.mjs +28 -545
  29. package/assets/skills/explainer-kit/scripts/lib/run-package.mjs +120 -0
  30. package/assets/skills/explainer-kit/scripts/lib/sanitize.mjs +42 -0
  31. package/assets/skills/explainer-kit/scripts/record.mjs +335 -0
  32. package/assets/skills/explainer-kit/scripts/verify.mjs +648 -0
  33. package/assets/skills/oat-explainer-kit/SKILL.md +57 -117
  34. package/assets/skills/oat-explainer-kit/references/config-contract.md +20 -64
  35. package/assets/skills/oat-explainer-kit/references/lifecycle-contract.md +85 -237
  36. package/assets/skills/oat-explainer-kit/scripts/bind-project-sources.mjs +18 -10
  37. package/assets/skills/oat-explainer-kit/scripts/check-core.mjs +1 -0
  38. package/assets/skills/oat-explainer-kit/scripts/check-terminal-outcome.mjs +256 -21
  39. package/assets/skills/oat-explainer-kit/scripts/persist-intent.mjs +82 -3
  40. package/assets/skills/oat-explainer-kit/scripts/resolve-config.mjs +0 -162
  41. package/assets/skills/oat-explainer-kit/scripts/resolve-intent.mjs +57 -123
  42. package/assets/skills/oat-project-autonomous/SKILL.md +14 -13
  43. package/assets/skills/oat-project-autonomous/references/gate-inventory.md +165 -165
  44. package/assets/skills/oat-project-complete/SKILL.md +168 -349
  45. package/assets/skills/oat-project-complete/scripts/consume-persisted-recap-intent.mjs +125 -0
  46. package/assets/skills/oat-project-complete/scripts/execute-synced-archive-entry.mjs +0 -30
  47. package/assets/skills/oat-project-complete/scripts/parse-completion-retry-fields.mjs +4 -37
  48. package/assets/skills/oat-project-complete/scripts/parse-synced-archive-resume-fields.mjs +17 -16
  49. package/assets/skills/oat-project-complete/scripts/recover-completion-receipts.mjs +9 -174
  50. package/assets/skills/oat-project-complete/scripts/resolve-completion-retry.mjs +1 -2
  51. package/assets/skills/oat-project-document/SKILL.md +1 -1
  52. package/assets/skills/oat-project-document/references/docs/autonomy-contract.md +165 -165
  53. package/assets/skills/oat-project-implement/SKILL.md +1 -1
  54. package/assets/skills/oat-project-implement/references/completion-and-closeout.md +44 -56
  55. package/assets/skills/oat-project-implement/references/docs/autonomy-contract.md +165 -165
  56. package/assets/skills/oat-project-lite/SKILL.md +1 -1
  57. package/assets/skills/oat-project-lite/references/docs/autonomy-contract.md +165 -165
  58. package/assets/skills/oat-project-plan/SKILL.md +5 -6
  59. package/assets/skills/oat-project-pr-final/SKILL.md +1 -1
  60. package/assets/skills/oat-project-pr-final/references/docs/autonomy-contract.md +165 -165
  61. package/assets/skills/oat-project-quick-start/SKILL.md +1 -1
  62. package/assets/skills/oat-project-quick-start/references/docs/autonomy-contract.md +165 -165
  63. package/assets/skills/oat-project-summary/SKILL.md +35 -25
  64. package/assets/skills/oat-wave-execute/SKILL.md +11 -36
  65. package/assets/skills/oat-wave-program/SKILL.md +13 -37
  66. package/dist/commands/config/index.d.ts.map +1 -1
  67. package/dist/commands/config/index.js +9 -113
  68. package/dist/commands/project/archive/archive-utils.d.ts.map +1 -1
  69. package/dist/commands/project/archive/archive-utils.js +32 -184
  70. package/dist/commands/project/archive/explainer-package-coverage.d.ts +3 -8
  71. package/dist/commands/project/archive/explainer-package-coverage.d.ts.map +1 -1
  72. package/dist/commands/project/archive/explainer-package-coverage.js +1 -1
  73. package/dist/config/oat-config.d.ts +0 -11
  74. package/dist/config/oat-config.d.ts.map +1 -1
  75. package/dist/config/oat-config.js +0 -34
  76. package/dist/config/resolve.d.ts.map +1 -1
  77. package/dist/config/resolve.js +0 -8
  78. package/dist/release/public-package-contract.d.ts.map +1 -1
  79. package/dist/release/public-package-contract.js +2 -10
  80. package/dist/validation/project-state.d.ts.map +1 -1
  81. package/dist/validation/project-state.js +42 -3
  82. package/package.json +2 -2
  83. package/assets/docs/contributing/explainer-kit-verification.md +0 -133
  84. package/assets/docs/workflows/skills/explainer-kit-providers.md +0 -155
  85. package/assets/skills/explainer-kit/briefs/deep-dive.md +0 -35
  86. package/assets/skills/explainer-kit/briefs/project-page.md +0 -38
  87. package/assets/skills/explainer-kit/briefs/supporting-diagram.md +0 -28
  88. package/assets/skills/explainer-kit/briefs/walkthrough-deck.md +0 -35
  89. package/assets/skills/explainer-kit/examples/project-explainer/content.md +0 -31
  90. package/assets/skills/explainer-kit/examples/project-explainer/fact-base.md +0 -22
  91. package/assets/skills/explainer-kit/examples/project-recap/content.md +0 -77
  92. package/assets/skills/explainer-kit/examples/project-recap/fact-base.json +0 -104
  93. package/assets/skills/explainer-kit/examples/project-recap/fact-base.md +0 -44
  94. package/assets/skills/explainer-kit/examples/theme-bundle.json +0 -87
  95. package/assets/skills/explainer-kit/recipes/project-recap.v1.json +0 -93
  96. package/assets/skills/explainer-kit/references/contracts.md +0 -324
  97. package/assets/skills/explainer-kit/references/destination-contract.md +0 -210
  98. package/assets/skills/explainer-kit/references/extension-contract.md +0 -80
  99. package/assets/skills/explainer-kit/references/golden-conformance.md +0 -80
  100. package/assets/skills/explainer-kit/references/visual-review.md +0 -71
  101. package/assets/skills/explainer-kit/schemas/author-request.v2.schema.json +0 -212
  102. package/assets/skills/explainer-kit/schemas/author-request.v3.schema.json +0 -241
  103. package/assets/skills/explainer-kit/schemas/author-result.v2.schema.json +0 -52
  104. package/assets/skills/explainer-kit/schemas/build-record.schema.json +0 -98
  105. package/assets/skills/explainer-kit/schemas/durability-evidence.schema.json +0 -53
  106. package/assets/skills/explainer-kit/schemas/publish-receipt.v1.schema.json +0 -97
  107. package/assets/skills/explainer-kit/schemas/publish-receipt.v2.schema.json +0 -215
  108. package/assets/skills/explainer-kit/schemas/publish-request.v1.schema.json +0 -32
  109. package/assets/skills/explainer-kit/schemas/publish-request.v2.schema.json +0 -34
  110. package/assets/skills/explainer-kit/schemas/run-request.schema.json +0 -147
  111. package/assets/skills/explainer-kit/schemas/set-plan.v1.schema.json +0 -149
  112. package/assets/skills/explainer-kit/schemas/terminal-evidence.v1.schema.json +0 -81
  113. package/assets/skills/explainer-kit/schemas/visual-review-evidence.v1.schema.json +0 -66
  114. package/assets/skills/explainer-kit/schemas/visual-review-request.v1.schema.json +0 -117
  115. package/assets/skills/explainer-kit/schemas/visual-review-result.v1.schema.json +0 -80
  116. package/assets/skills/explainer-kit/scripts/lib/catalog.mjs +0 -349
  117. package/assets/skills/explainer-kit/scripts/lib/content-approval.mjs +0 -418
  118. package/assets/skills/explainer-kit/scripts/lib/diagram.mjs +0 -514
  119. package/assets/skills/explainer-kit/scripts/lib/durability.mjs +0 -643
  120. package/assets/skills/explainer-kit/scripts/lib/fact-base.mjs +0 -664
  121. package/assets/skills/explainer-kit/scripts/lib/internal-references.mjs +0 -538
  122. package/assets/skills/explainer-kit/scripts/lib/markdown.mjs +0 -414
  123. package/assets/skills/explainer-kit/scripts/lib/publication-policy.mjs +0 -54
  124. package/assets/skills/explainer-kit/scripts/lib/records.mjs +0 -954
  125. package/assets/skills/explainer-kit/scripts/lib/render.mjs +0 -703
  126. package/assets/skills/explainer-kit/scripts/lib/s3-roots.mjs +0 -353
  127. package/assets/skills/explainer-kit/scripts/lib/s3-static.mjs +0 -759
  128. package/assets/skills/explainer-kit/scripts/lib/set-plan.mjs +0 -209
  129. package/assets/skills/explainer-kit/scripts/lib/source-backlinks.mjs +0 -218
  130. package/assets/skills/explainer-kit/scripts/lib/terminal-evidence.mjs +0 -157
  131. package/assets/skills/explainer-kit/scripts/lib/visual-review.mjs +0 -400
  132. package/assets/skills/explainer-kit/scripts/publish.mjs +0 -76
  133. package/assets/skills/explainer-kit/scripts/record-durability.mjs +0 -64
  134. package/assets/skills/explainer-kit/scripts/render-qa.mjs +0 -461
  135. package/assets/skills/explainer-kit/scripts/run.mjs +0 -3038
  136. package/assets/skills/explainer-kit/scripts/validate.mjs +0 -59
  137. package/assets/skills/oat-explainer-kit/references/author-callback.md +0 -53
  138. package/assets/skills/oat-explainer-kit/references/migration.md +0 -144
  139. package/assets/skills/oat-explainer-kit/references/visual-review-callback.md +0 -83
  140. package/assets/skills/oat-explainer-kit/scripts/derive-destination.mjs +0 -91
  141. package/assets/skills/oat-explainer-kit/scripts/finalize-tracked-run.mjs +0 -531
  142. package/assets/skills/oat-explainer-kit/scripts/probe-recap-seams.mjs +0 -371
  143. package/assets/skills/oat-explainer-kit/scripts/run.mjs +0 -905
  144. package/dist/commands/project/archive/explainer-source-backlinks.d.ts +0 -18
  145. package/dist/commands/project/archive/explainer-source-backlinks.d.ts.map +0 -1
  146. package/dist/commands/project/archive/explainer-source-backlinks.js +0 -27
  147. package/dist/commands/project/archive/explainer-terminal-evidence.d.ts +0 -29
  148. package/dist/commands/project/archive/explainer-terminal-evidence.d.ts.map +0 -1
  149. package/dist/commands/project/archive/explainer-terminal-evidence.js +0 -37
@@ -1,241 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "explainer-kit.author-request/v3",
4
- "title": "AuthorRequestV3",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": [
8
- "schemaVersion",
9
- "artifactId",
10
- "artifactType",
11
- "authoring",
12
- "brief",
13
- "visualAuthoringGuidance",
14
- "factBase",
15
- "theme",
16
- "setContext",
17
- "plannedArtifact",
18
- "artifactLinks"
19
- ],
20
- "properties": {
21
- "schemaVersion": { "const": "explainer-kit.author-request/v3" },
22
- "artifactId": { "type": "string", "minLength": 1 },
23
- "artifactType": {
24
- "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
25
- },
26
- "authoring": { "enum": ["markdown", "html"] },
27
- "brief": { "type": "string", "minLength": 1 },
28
- "visualAuthoringGuidance": { "type": "string", "minLength": 1 },
29
- "factBase": { "$ref": "explainer-kit.fact-base/v1" },
30
- "shell": { "type": "string", "minLength": 1 },
31
- "theme": { "$ref": "explainer-kit.theme/v1" },
32
- "setContext": { "$ref": "explainer-kit.set-plan/v1" },
33
- "plannedArtifact": { "$ref": "#/$defs/plannedArtifact" },
34
- "artifactLinks": {
35
- "type": "array",
36
- "items": { "$ref": "#/$defs/artifactLink" },
37
- "minItems": 1,
38
- "uniqueItems": true
39
- },
40
- "graphSemantics": {
41
- "type": "array",
42
- "items": { "$ref": "#/$defs/graphSemantics" },
43
- "minItems": 1
44
- },
45
- "floor": {
46
- "type": "object",
47
- "additionalProperties": false,
48
- "required": ["requiredNarrative"],
49
- "properties": {
50
- "requiredNarrative": {
51
- "type": "array",
52
- "items": { "type": "string", "minLength": 1 },
53
- "minItems": 1,
54
- "uniqueItems": true
55
- }
56
- }
57
- }
58
- },
59
- "$defs": {
60
- "artifactLink": {
61
- "type": "object",
62
- "additionalProperties": false,
63
- "required": ["artifactId", "artifactType", "sitePath", "href"],
64
- "properties": {
65
- "artifactId": {
66
- "type": "string",
67
- "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
68
- },
69
- "artifactType": {
70
- "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
71
- },
72
- "sitePath": {
73
- "type": "string",
74
- "pattern": "^site/[a-z0-9._-]+(?:/[a-z0-9._-]+)*/index\\.html$"
75
- },
76
- "href": {
77
- "type": "string",
78
- "pattern": "^(?:index\\.html|(?:\\.\\./)*[a-z0-9._-]+(?:/[a-z0-9._-]+)*/index\\.html)$"
79
- }
80
- }
81
- },
82
- "graphSemantics": {
83
- "type": "object",
84
- "additionalProperties": false,
85
- "required": ["direction", "nodes", "edges", "topology"],
86
- "properties": {
87
- "direction": { "enum": ["TD", "LR"] },
88
- "nodes": {
89
- "type": "array",
90
- "items": {
91
- "type": "object",
92
- "additionalProperties": false,
93
- "required": ["id", "label", "shape", "explicit"],
94
- "properties": {
95
- "id": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_-]*$" },
96
- "label": { "type": "string", "minLength": 1 },
97
- "shape": { "enum": ["rectangle", "rounded", "diamond"] },
98
- "explicit": { "type": "boolean" }
99
- }
100
- },
101
- "minItems": 1,
102
- "uniqueItems": true
103
- },
104
- "edges": {
105
- "type": "array",
106
- "items": {
107
- "type": "object",
108
- "additionalProperties": false,
109
- "required": ["from", "to", "kind", "label"],
110
- "properties": {
111
- "from": {
112
- "type": "string",
113
- "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
114
- },
115
- "to": { "type": "string", "pattern": "^[A-Za-z][A-Za-z0-9_-]*$" },
116
- "kind": { "enum": ["arrow", "line"] },
117
- "label": { "type": "string" }
118
- }
119
- },
120
- "minItems": 1
121
- },
122
- "topology": {
123
- "type": "object",
124
- "additionalProperties": false,
125
- "required": [
126
- "kind",
127
- "features",
128
- "branchNodes",
129
- "fanInNodes",
130
- "cycle",
131
- "order"
132
- ],
133
- "properties": {
134
- "kind": { "const": "non-linear" },
135
- "features": {
136
- "type": "array",
137
- "items": {
138
- "enum": [
139
- "branch",
140
- "fan-in",
141
- "cycle",
142
- "disconnected",
143
- "non-linear"
144
- ]
145
- },
146
- "minItems": 1,
147
- "uniqueItems": true
148
- },
149
- "branchNodes": {
150
- "type": "array",
151
- "items": {
152
- "type": "string",
153
- "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
154
- },
155
- "uniqueItems": true
156
- },
157
- "fanInNodes": {
158
- "type": "array",
159
- "items": {
160
- "type": "string",
161
- "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
162
- },
163
- "uniqueItems": true
164
- },
165
- "cycle": { "type": "boolean" },
166
- "order": {
167
- "type": "array",
168
- "items": {
169
- "type": "string",
170
- "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
171
- },
172
- "maxItems": 0
173
- }
174
- }
175
- }
176
- }
177
- },
178
- "plannedArtifact": {
179
- "type": "object",
180
- "additionalProperties": false,
181
- "required": [
182
- "artifactId",
183
- "artifactType",
184
- "profileId",
185
- "required",
186
- "sourceIds",
187
- "draft",
188
- "visualIntent"
189
- ],
190
- "properties": {
191
- "artifactId": {
192
- "type": "string",
193
- "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
194
- },
195
- "artifactType": {
196
- "enum": ["hub", "diagram", "explainer", "deck", "catalog"]
197
- },
198
- "profileId": {
199
- "type": "string",
200
- "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
201
- },
202
- "required": { "type": "boolean" },
203
- "sourceIds": {
204
- "type": "array",
205
- "items": {
206
- "type": "string",
207
- "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
208
- },
209
- "minItems": 1,
210
- "uniqueItems": true
211
- },
212
- "draft": { "type": "string", "minLength": 1 },
213
- "visualIntent": { "type": "string", "minLength": 1 },
214
- "justification": {
215
- "type": "object",
216
- "additionalProperties": false,
217
- "required": ["kind", "sourceIds", "rationale"],
218
- "properties": {
219
- "kind": {
220
- "enum": [
221
- "status-change",
222
- "rollout-complexity",
223
- "source-backed-detail"
224
- ]
225
- },
226
- "sourceIds": {
227
- "type": "array",
228
- "items": {
229
- "type": "string",
230
- "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$"
231
- },
232
- "minItems": 1,
233
- "uniqueItems": true
234
- },
235
- "rationale": { "type": "string", "minLength": 1 }
236
- }
237
- }
238
- }
239
- }
240
- }
241
- }
@@ -1,52 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "explainer-kit.author-result/v2",
4
- "title": "AuthorResultV2",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": ["schemaVersion", "artifactId", "content", "provenance"],
8
- "properties": {
9
- "schemaVersion": { "const": "explainer-kit.author-result/v2" },
10
- "artifactId": { "type": "string", "minLength": 1 },
11
- "content": {
12
- "type": "object",
13
- "additionalProperties": false,
14
- "oneOf": [{ "required": ["markdown"] }, { "required": ["html"] }],
15
- "properties": {
16
- "markdown": { "type": "string", "minLength": 1 },
17
- "html": { "type": "string", "minLength": 1 }
18
- }
19
- },
20
- "provenance": {
21
- "type": "object",
22
- "additionalProperties": false,
23
- "required": ["authorId", "generatedAt"],
24
- "properties": {
25
- "authorId": { "type": "string", "minLength": 1 },
26
- "generatedAt": { "type": "string", "format": "date-time" },
27
- "method": { "type": "string", "minLength": 1 },
28
- "trust": {
29
- "description": "Stamped by the core on the retained record only. An author callback that asserts it is rejected.",
30
- "enum": ["caller-bound", "self-asserted"]
31
- }
32
- }
33
- },
34
- "proposedArtifacts": {
35
- "type": "array",
36
- "items": {
37
- "type": "object",
38
- "additionalProperties": false,
39
- "required": ["id", "profileId", "rationale"],
40
- "properties": {
41
- "id": {
42
- "type": "string",
43
- "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
44
- },
45
- "profileId": { "type": "string", "minLength": 1 },
46
- "rationale": { "type": "string", "minLength": 1 }
47
- }
48
- },
49
- "uniqueItems": true
50
- }
51
- }
52
- }
@@ -1,98 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "explainer-kit.build-record/v1",
4
- "title": "BuildRecordV1",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": [
8
- "schemaVersion",
9
- "runId",
10
- "renderStrategy",
11
- "startedAt",
12
- "stages",
13
- "outcome"
14
- ],
15
- "properties": {
16
- "schemaVersion": { "const": "explainer-kit.build-record/v1" },
17
- "runId": { "type": "string", "minLength": 1 },
18
- "renderStrategy": { "enum": ["default-only", "user-switchable"] },
19
- "startedAt": { "type": "string", "format": "date-time" },
20
- "completedAt": { "type": "string", "format": "date-time" },
21
- "stages": {
22
- "type": "array",
23
- "items": { "$ref": "#/$defs/stage" },
24
- "minItems": 1
25
- },
26
- "outcome": {
27
- "enum": [
28
- "built-durable",
29
- "built-not-durable",
30
- "built-needs-review",
31
- "failed",
32
- "incomplete"
33
- ]
34
- }
35
- },
36
- "$defs": {
37
- "safeRelativePath": {
38
- "type": "string",
39
- "minLength": 1,
40
- "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
41
- },
42
- "error": {
43
- "type": "object",
44
- "additionalProperties": false,
45
- "required": ["code", "message", "recovery"],
46
- "properties": {
47
- "code": { "type": "string", "minLength": 1 },
48
- "message": { "type": "string", "minLength": 1 },
49
- "recovery": {
50
- "type": "array",
51
- "items": { "type": "string", "minLength": 1 },
52
- "minItems": 1
53
- }
54
- }
55
- },
56
- "stage": {
57
- "type": "object",
58
- "additionalProperties": false,
59
- "required": ["id", "status", "outputPaths", "warnings"],
60
- "properties": {
61
- "id": {
62
- "enum": [
63
- "validate",
64
- "fact-base",
65
- "content",
66
- "theme",
67
- "render",
68
- "qa",
69
- "durability",
70
- "publish"
71
- ]
72
- },
73
- "status": {
74
- "enum": [
75
- "pending",
76
- "running",
77
- "passed",
78
- "warned",
79
- "failed",
80
- "skipped"
81
- ]
82
- },
83
- "startedAt": { "type": "string", "format": "date-time" },
84
- "completedAt": { "type": "string", "format": "date-time" },
85
- "outputPaths": {
86
- "type": "array",
87
- "items": { "$ref": "#/$defs/safeRelativePath" },
88
- "uniqueItems": true
89
- },
90
- "warnings": {
91
- "type": "array",
92
- "items": { "type": "string", "minLength": 1 }
93
- },
94
- "error": { "$ref": "#/$defs/error" }
95
- }
96
- }
97
- }
98
- }
@@ -1,53 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "explainer-kit.durability-evidence/v1",
4
- "title": "DurabilityEvidenceRequestV1",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": ["schemaVersion", "manifestPath", "evidence"],
8
- "properties": {
9
- "schemaVersion": {
10
- "const": "explainer-kit.durability-evidence/v1"
11
- },
12
- "manifestPath": { "type": "string", "minLength": 1 },
13
- "evidence": {
14
- "oneOf": [
15
- {
16
- "type": "object",
17
- "additionalProperties": false,
18
- "required": ["kind", "repoRoot", "commit", "paths"],
19
- "properties": {
20
- "kind": { "const": "commit" },
21
- "repoRoot": { "type": "string", "minLength": 1 },
22
- "commit": {
23
- "type": "string",
24
- "pattern": "^[a-f0-9]{7,64}$"
25
- },
26
- "paths": {
27
- "type": "array",
28
- "items": { "$ref": "#/$defs/safeRelativePath" },
29
- "minItems": 1,
30
- "uniqueItems": true
31
- }
32
- }
33
- },
34
- {
35
- "type": "object",
36
- "additionalProperties": false,
37
- "required": ["kind", "receiptPath"],
38
- "properties": {
39
- "kind": { "const": "publish" },
40
- "receiptPath": { "type": "string", "minLength": 1 }
41
- }
42
- }
43
- ]
44
- }
45
- },
46
- "$defs": {
47
- "safeRelativePath": {
48
- "type": "string",
49
- "minLength": 1,
50
- "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
51
- }
52
- }
53
- }
@@ -1,97 +0,0 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "explainer-kit.publish-receipt/v1",
4
- "title": "PublishReceiptV1",
5
- "type": "object",
6
- "additionalProperties": false,
7
- "required": [
8
- "schemaVersion",
9
- "provider",
10
- "publishedAt",
11
- "roots",
12
- "sentinel",
13
- "artifacts"
14
- ],
15
- "properties": {
16
- "schemaVersion": { "const": "explainer-kit.publish-receipt/v1" },
17
- "provider": { "const": "s3-static" },
18
- "publishedAt": { "type": "string", "format": "date-time" },
19
- "roots": {
20
- "type": "object",
21
- "additionalProperties": false,
22
- "required": ["s3Uri", "publicBaseUrl"],
23
- "properties": {
24
- "s3Uri": {
25
- "type": "string",
26
- "pattern": "^s3://[^/\\s]+(?:/[^\\s]*)?$"
27
- },
28
- "publicBaseUrl": {
29
- "type": "string",
30
- "pattern": "^https://[^\\s]+$"
31
- }
32
- }
33
- },
34
- "sentinel": {
35
- "type": "object",
36
- "additionalProperties": false,
37
- "required": [
38
- "relativePath",
39
- "uploadVerified",
40
- "publicVerified",
41
- "deleted"
42
- ],
43
- "properties": {
44
- "relativePath": { "$ref": "#/$defs/safeRelativePath" },
45
- "uploadVerified": { "type": "boolean" },
46
- "publicVerified": { "type": "boolean" },
47
- "deleted": { "type": "boolean" }
48
- }
49
- },
50
- "artifacts": {
51
- "type": "array",
52
- "items": { "$ref": "#/$defs/artifact" },
53
- "uniqueItems": true
54
- }
55
- },
56
- "$defs": {
57
- "hash": {
58
- "type": "string",
59
- "pattern": "^sha256:[a-f0-9]{64}$"
60
- },
61
- "safeRelativePath": {
62
- "type": "string",
63
- "minLength": 1,
64
- "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
65
- },
66
- "artifact": {
67
- "type": "object",
68
- "additionalProperties": false,
69
- "required": [
70
- "relativePath",
71
- "hash",
72
- "s3Uri",
73
- "publicUrl",
74
- "httpStatus",
75
- "contentType"
76
- ],
77
- "properties": {
78
- "relativePath": { "$ref": "#/$defs/safeRelativePath" },
79
- "hash": { "$ref": "#/$defs/hash" },
80
- "s3Uri": {
81
- "type": "string",
82
- "pattern": "^s3://[^/\\s]+/.+$"
83
- },
84
- "publicUrl": {
85
- "type": "string",
86
- "pattern": "^https://[^\\s]+$"
87
- },
88
- "httpStatus": {
89
- "type": "integer",
90
- "minimum": 200,
91
- "maximum": 299
92
- },
93
- "contentType": { "type": "string", "minLength": 1 }
94
- }
95
- }
96
- }
97
- }