@rvdbreemen/adr-kit-opencode 0.52.0

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 (129) hide show
  1. package/.claude-plugin/plugin.json +29 -0
  2. package/LICENSE +21 -0
  3. package/README.md +850 -0
  4. package/bin/adr +1552 -0
  5. package/bin/adr-audit +454 -0
  6. package/bin/adr-context +584 -0
  7. package/bin/adr-discover +546 -0
  8. package/bin/adr-doctor +166 -0
  9. package/bin/adr-generate-scripts +421 -0
  10. package/bin/adr-grill-signal +131 -0
  11. package/bin/adr-guardian +1263 -0
  12. package/bin/adr-index +199 -0
  13. package/bin/adr-judge +2832 -0
  14. package/bin/adr-judge-precommit +87 -0
  15. package/bin/adr-lint +2087 -0
  16. package/bin/adr-mcp +1093 -0
  17. package/bin/adr-migrate +644 -0
  18. package/bin/adr-quality +275 -0
  19. package/bin/adr-readiness +211 -0
  20. package/bin/adr-readiness-ci +111 -0
  21. package/bin/adr-related +401 -0
  22. package/bin/adr-renumber +254 -0
  23. package/bin/adr-retire +467 -0
  24. package/bin/adr-settings +399 -0
  25. package/bin/adr-status +797 -0
  26. package/bin/adr-suggest +803 -0
  27. package/bin/adr-watch +674 -0
  28. package/bin/adr_catalog.py +536 -0
  29. package/bin/adr_config.py +280 -0
  30. package/bin/adr_doctor_checks.py +407 -0
  31. package/bin/adr_doctor_core.py +342 -0
  32. package/bin/adr_doctor_models.py +186 -0
  33. package/bin/adr_doctor_probes.py +216 -0
  34. package/bin/adr_format.py +786 -0
  35. package/bin/adr_grill_signal.py +123 -0
  36. package/bin/adr_guardian_queue.py +218 -0
  37. package/bin/adr_history_scan.py +278 -0
  38. package/bin/adr_index_core.py +443 -0
  39. package/bin/adr_llm.py +333 -0
  40. package/bin/adr_llm_judge_migration.py +314 -0
  41. package/bin/adr_quality_core.py +674 -0
  42. package/bin/adr_query.py +678 -0
  43. package/bin/adr_readiness.py +442 -0
  44. package/bin/adr_readiness_ci.py +123 -0
  45. package/bin/adr_regex.py +165 -0
  46. package/bin/adr_regex_worker.py +30 -0
  47. package/bin/adr_retrieval_health.py +385 -0
  48. package/bin/adr_schema.py +448 -0
  49. package/bin/adr_state.py +172 -0
  50. package/bin/bump-version +71 -0
  51. package/clients/workflows.json +229 -0
  52. package/hooks/__init__.py +1 -0
  53. package/hooks/adapters/__init__.py +13 -0
  54. package/hooks/adapters/claude.py +27 -0
  55. package/hooks/adapters/codex.py +26 -0
  56. package/hooks/adapters/copilot.py +11 -0
  57. package/hooks/adr-hook.py +128 -0
  58. package/hooks/adr_hook_core.py +843 -0
  59. package/hooks/adr_pr_guard.py +367 -0
  60. package/instructions/ADR-guide.md +48 -0
  61. package/instructions/adr.coding.md +82 -0
  62. package/instructions/adr.review.md +182 -0
  63. package/opencode/plugin.ts +451 -0
  64. package/package.json +41 -0
  65. package/schemas/adr-context-probes.schema.json +56 -0
  66. package/schemas/adr-enforcement.schema.json +57 -0
  67. package/schemas/adr-frontmatter.schema.json +144 -0
  68. package/schemas/adr-index.schema.json +276 -0
  69. package/schemas/adr-kit-config.schema.json +371 -0
  70. package/schemas/adr-readiness.schema.json +41 -0
  71. package/schemas/client-capabilities.schema.json +503 -0
  72. package/schemas/client-certification.schema.json +101 -0
  73. package/schemas/doctor-output.schema.json +92 -0
  74. package/schemas/marketplace.json.schema.json +70 -0
  75. package/schemas/plugin.json.schema.json +67 -0
  76. package/scripts/adr_settings.py +239 -0
  77. package/scripts/benchmark-adr-grilling.py +323 -0
  78. package/scripts/benchmark-client-generation.py +178 -0
  79. package/scripts/build-client-adapters.py +139 -0
  80. package/scripts/bump-version.py +304 -0
  81. package/scripts/check-branch-sync.py +243 -0
  82. package/scripts/check-release-version.py +81 -0
  83. package/scripts/client_certification.py +153 -0
  84. package/scripts/client_evidence.py +280 -0
  85. package/scripts/client_generation.py +288 -0
  86. package/scripts/client_generation_artifacts.py +351 -0
  87. package/scripts/client_generation_model.py +173 -0
  88. package/scripts/client_generation_state.py +260 -0
  89. package/scripts/client_support_matrix.py +360 -0
  90. package/scripts/install-agent-envs.py +300 -0
  91. package/scripts/probe-client-events.py +183 -0
  92. package/scripts/project_setup.py +379 -0
  93. package/scripts/refresh-otgw-corpus.py +219 -0
  94. package/scripts/settings.py +81 -0
  95. package/scripts/setup-project.py +205 -0
  96. package/scripts/sync-agent-plugins.py +17 -0
  97. package/scripts/version_sites.py +377 -0
  98. package/skills/adr/SKILL.md +780 -0
  99. package/skills/audit/SKILL.md +103 -0
  100. package/skills/context/SKILL.md +77 -0
  101. package/skills/grill/SKILL.md +84 -0
  102. package/skills/grill/agents/openai.yaml +4 -0
  103. package/skills/guardian/SKILL.md +316 -0
  104. package/skills/init/SKILL.md +499 -0
  105. package/skills/install-hooks/SKILL.md +154 -0
  106. package/skills/judge/SKILL.md +168 -0
  107. package/skills/lint/SKILL.md +321 -0
  108. package/skills/migrate/SKILL.md +313 -0
  109. package/skills/related/SKILL.md +62 -0
  110. package/skills/retire/SKILL.md +41 -0
  111. package/skills/review/SKILL.md +167 -0
  112. package/skills/settings/SKILL.md +73 -0
  113. package/skills/setup/SKILL.md +128 -0
  114. package/skills/supersede/SKILL.md +136 -0
  115. package/skills/upgrade/SKILL.md +273 -0
  116. package/templates/adr-kit-guide.md +354 -0
  117. package/templates/adr-template.canonical.md +115 -0
  118. package/templates/adr-template.madr.md +131 -0
  119. package/templates/adr-template.md +131 -0
  120. package/templates/adr-template.nygard.md +111 -0
  121. package/templates/cc-settings/guardian-hook-entry.json +9 -0
  122. package/templates/githooks/pre-commit +337 -0
  123. package/templates/github-workflows/adr-audit.yml +58 -0
  124. package/templates/github-workflows/adr-guardian-audit.yml +133 -0
  125. package/templates/github-workflows/adr-index-check.yml +30 -0
  126. package/templates/github-workflows/adr-judge.yml +31 -0
  127. package/templates/github-workflows/adr-readiness.yml +18 -0
  128. package/templates/validate_adr_template.py +38 -0
  129. package/templates/validate_adr_template.sh +74 -0
@@ -0,0 +1,144 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://rvdbreemen.github.io/adr-kit/schemas/adr-frontmatter.schema.json",
4
+ "title": "adr-kit canonical ADR frontmatter",
5
+ "type": "object",
6
+ "additionalProperties": true,
7
+ "required": [
8
+ "id",
9
+ "title",
10
+ "status",
11
+ "date",
12
+ "binding",
13
+ "gate",
14
+ "documents_shipped",
15
+ "verified_in",
16
+ "supersedes",
17
+ "superseded_by"
18
+ ],
19
+ "properties": {
20
+ "id": {
21
+ "type": "string",
22
+ "pattern": "^ADR-[0-9]{3,4}$",
23
+ "description": "Canonical ADR identifier."
24
+ },
25
+ "title": {
26
+ "type": "string",
27
+ "minLength": 1,
28
+ "description": "Human title without the ADR id prefix."
29
+ },
30
+ "status": {
31
+ "type": "string",
32
+ "enum": [
33
+ "Proposed",
34
+ "Accepted",
35
+ "Deprecated",
36
+ "Superseded",
37
+ "Amended",
38
+ "Rejected"
39
+ ],
40
+ "description": "Current lifecycle status."
41
+ },
42
+ "date": {
43
+ "type": [
44
+ "string",
45
+ "null"
46
+ ],
47
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
48
+ "description": "Date from the status line when known."
49
+ },
50
+ "binding": {
51
+ "type": "boolean",
52
+ "description": "True when the ADR constrains future implementation."
53
+ },
54
+ "gate": {
55
+ "type": [
56
+ "string",
57
+ "null"
58
+ ],
59
+ "minLength": 1,
60
+ "description": "Named consuming-repo verification gate, if any."
61
+ },
62
+ "documents_shipped": {
63
+ "type": "boolean",
64
+ "description": "True when this ADR documents behavior already shipped before authoring."
65
+ },
66
+ "verified_in": {
67
+ "type": "array",
68
+ "items": {
69
+ "type": "string",
70
+ "minLength": 1
71
+ },
72
+ "description": "Local evidence pointers such as file paths, symbols, tests, or commits."
73
+ },
74
+ "supersedes": {
75
+ "type": "array",
76
+ "items": {
77
+ "type": "string",
78
+ "pattern": "^ADR-[0-9]{3,4}$"
79
+ },
80
+ "description": "ADR ids this ADR supersedes."
81
+ },
82
+ "superseded_by": {
83
+ "type": [
84
+ "string",
85
+ "null"
86
+ ],
87
+ "pattern": "^ADR-[0-9]{3,4}$",
88
+ "description": "Successor ADR id when this ADR is superseded."
89
+ },
90
+ "related": {
91
+ "type": "array",
92
+ "items": {
93
+ "type": "string",
94
+ "pattern": "^ADR-[0-9]{3,4}$"
95
+ },
96
+ "description": "ADR ids this ADR is related to, written on both sides by `bin/adr relate`. Symmetric: if A lists B, B lists A."
97
+ },
98
+ "format": {
99
+ "type": "string",
100
+ "enum": [
101
+ "madr",
102
+ "nygard",
103
+ "canonical"
104
+ ],
105
+ "description": "Optional ADR body profile discriminator. Legacy records may omit it and are detected from headings."
106
+ },
107
+ "topics": {
108
+ "$ref": "#/$defs/retrievalStrings",
109
+ "description": "Optional deterministic topic terms for selective ADR retrieval."
110
+ },
111
+ "aliases": {
112
+ "$ref": "#/$defs/retrievalStrings",
113
+ "description": "Optional alternative names and phrases for selective ADR retrieval."
114
+ },
115
+ "components": {
116
+ "$ref": "#/$defs/retrievalStrings",
117
+ "description": "Optional architectural components named by this decision."
118
+ },
119
+ "symbols": {
120
+ "$ref": "#/$defs/retrievalStrings",
121
+ "description": "Optional code symbols named by this decision."
122
+ },
123
+ "context_scope": {
124
+ "type": "string",
125
+ "enum": [
126
+ "global",
127
+ "selective"
128
+ ],
129
+ "description": "Whether the ADR is baseline context or requires positive selective evidence."
130
+ }
131
+ },
132
+ "$defs": {
133
+ "retrievalStrings": {
134
+ "type": "array",
135
+ "maxItems": 32,
136
+ "uniqueItems": true,
137
+ "items": {
138
+ "type": "string",
139
+ "minLength": 1,
140
+ "maxLength": 120
141
+ }
142
+ }
143
+ }
144
+ }
@@ -0,0 +1,276 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/rvdbreemen/adr-kit/schemas/adr-index.schema.json",
4
+ "title": "ADR Kit generated graph index",
5
+ "description": "Versioned machine-readable projection of Markdown ADR metadata and declared relationships.",
6
+ "type": "object",
7
+ "additionalProperties": false,
8
+ "required": [
9
+ "$schema",
10
+ "schema_version",
11
+ "adrs",
12
+ "relationships"
13
+ ],
14
+ "properties": {
15
+ "$schema": {
16
+ "type": "string",
17
+ "minLength": 1
18
+ },
19
+ "schema_version": {
20
+ "const": 2
21
+ },
22
+ "adrs": {
23
+ "type": "array",
24
+ "items": {
25
+ "$ref": "#/$defs/adr"
26
+ }
27
+ },
28
+ "relationships": {
29
+ "type": "array",
30
+ "items": {
31
+ "$ref": "#/$defs/relationship"
32
+ }
33
+ }
34
+ },
35
+ "$defs": {
36
+ "adrId": {
37
+ "type": "string",
38
+ "pattern": "^ADR-[0-9]{3,4}$"
39
+ },
40
+ "nullableAdrId": {
41
+ "oneOf": [
42
+ {
43
+ "$ref": "#/$defs/adrId"
44
+ },
45
+ {
46
+ "type": "null"
47
+ }
48
+ ]
49
+ },
50
+ "adr": {
51
+ "type": "object",
52
+ "additionalProperties": false,
53
+ "required": [
54
+ "id",
55
+ "title",
56
+ "path",
57
+ "format",
58
+ "status",
59
+ "date",
60
+ "decision_summary",
61
+ "topics",
62
+ "aliases",
63
+ "components",
64
+ "symbols",
65
+ "context_scope",
66
+ "decision_contract",
67
+ "scope",
68
+ "metadata"
69
+ ],
70
+ "properties": {
71
+ "id": {
72
+ "$ref": "#/$defs/adrId"
73
+ },
74
+ "title": {
75
+ "type": "string",
76
+ "minLength": 1
77
+ },
78
+ "path": {
79
+ "type": "string",
80
+ "minLength": 1,
81
+ "description": "Source Markdown path relative to ADR-INDEX.json."
82
+ },
83
+ "format": {
84
+ "type": "string",
85
+ "enum": [
86
+ "madr",
87
+ "nygard",
88
+ "canonical",
89
+ "hybrid",
90
+ "unknown"
91
+ ]
92
+ },
93
+ "status": {
94
+ "type": "string",
95
+ "enum": [
96
+ "Proposed",
97
+ "Accepted",
98
+ "Deprecated",
99
+ "Superseded",
100
+ "Amended",
101
+ "Rejected",
102
+ "Unknown"
103
+ ]
104
+ },
105
+ "date": {
106
+ "type": [
107
+ "string",
108
+ "null"
109
+ ],
110
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
111
+ },
112
+ "decision_summary": {
113
+ "type": "string",
114
+ "maxLength": 120
115
+ },
116
+ "topics": {
117
+ "$ref": "#/$defs/retrievalStrings"
118
+ },
119
+ "aliases": {
120
+ "$ref": "#/$defs/retrievalStrings"
121
+ },
122
+ "components": {
123
+ "$ref": "#/$defs/retrievalStrings"
124
+ },
125
+ "symbols": {
126
+ "$ref": "#/$defs/retrievalStrings"
127
+ },
128
+ "context_scope": {
129
+ "type": "string",
130
+ "enum": [
131
+ "global",
132
+ "selective"
133
+ ]
134
+ },
135
+ "decision_contract": {
136
+ "$ref": "#/$defs/decisionContract"
137
+ },
138
+ "scope": {
139
+ "type": "object",
140
+ "additionalProperties": false,
141
+ "required": [
142
+ "path_globs"
143
+ ],
144
+ "properties": {
145
+ "path_globs": {
146
+ "type": "array",
147
+ "uniqueItems": true,
148
+ "items": {
149
+ "type": "string",
150
+ "minLength": 1
151
+ }
152
+ }
153
+ }
154
+ },
155
+ "metadata": {
156
+ "type": "object",
157
+ "additionalProperties": false,
158
+ "required": [
159
+ "binding",
160
+ "gate",
161
+ "documents_shipped",
162
+ "verified_in",
163
+ "supersedes",
164
+ "superseded_by"
165
+ ],
166
+ "properties": {
167
+ "binding": {
168
+ "type": "boolean"
169
+ },
170
+ "gate": {
171
+ "type": [
172
+ "string",
173
+ "null"
174
+ ],
175
+ "minLength": 1
176
+ },
177
+ "documents_shipped": {
178
+ "type": "boolean"
179
+ },
180
+ "verified_in": {
181
+ "type": "array",
182
+ "items": {
183
+ "type": "string",
184
+ "minLength": 1
185
+ }
186
+ },
187
+ "supersedes": {
188
+ "type": "array",
189
+ "uniqueItems": true,
190
+ "items": {
191
+ "$ref": "#/$defs/adrId"
192
+ }
193
+ },
194
+ "superseded_by": {
195
+ "$ref": "#/$defs/nullableAdrId"
196
+ }
197
+ }
198
+ }
199
+ }
200
+ },
201
+ "retrievalStrings": {
202
+ "type": "array",
203
+ "maxItems": 32,
204
+ "uniqueItems": true,
205
+ "items": {
206
+ "type": "string",
207
+ "minLength": 1,
208
+ "maxLength": 120
209
+ }
210
+ },
211
+ "contractStrings": {
212
+ "type": "array",
213
+ "maxItems": 20,
214
+ "uniqueItems": true,
215
+ "items": {
216
+ "type": "string",
217
+ "minLength": 1,
218
+ "maxLength": 240
219
+ }
220
+ },
221
+ "decisionContract": {
222
+ "type": "object",
223
+ "additionalProperties": false,
224
+ "required": [
225
+ "must",
226
+ "must_not",
227
+ "exceptions",
228
+ "verification"
229
+ ],
230
+ "properties": {
231
+ "must": {
232
+ "$ref": "#/$defs/contractStrings"
233
+ },
234
+ "must_not": {
235
+ "$ref": "#/$defs/contractStrings"
236
+ },
237
+ "exceptions": {
238
+ "$ref": "#/$defs/contractStrings"
239
+ },
240
+ "verification": {
241
+ "$ref": "#/$defs/contractStrings"
242
+ }
243
+ }
244
+ },
245
+ "relationship": {
246
+ "type": "object",
247
+ "additionalProperties": false,
248
+ "required": [
249
+ "source",
250
+ "target",
251
+ "type",
252
+ "resolved"
253
+ ],
254
+ "properties": {
255
+ "source": {
256
+ "$ref": "#/$defs/adrId"
257
+ },
258
+ "target": {
259
+ "$ref": "#/$defs/adrId"
260
+ },
261
+ "type": {
262
+ "type": "string",
263
+ "enum": [
264
+ "related",
265
+ "supersedes",
266
+ "superseded-by",
267
+ "amended-by"
268
+ ]
269
+ },
270
+ "resolved": {
271
+ "type": "boolean"
272
+ }
273
+ }
274
+ }
275
+ }
276
+ }