@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.
- package/.claude-plugin/plugin.json +29 -0
- package/LICENSE +21 -0
- package/README.md +850 -0
- package/bin/adr +1552 -0
- package/bin/adr-audit +454 -0
- package/bin/adr-context +584 -0
- package/bin/adr-discover +546 -0
- package/bin/adr-doctor +166 -0
- package/bin/adr-generate-scripts +421 -0
- package/bin/adr-grill-signal +131 -0
- package/bin/adr-guardian +1263 -0
- package/bin/adr-index +199 -0
- package/bin/adr-judge +2832 -0
- package/bin/adr-judge-precommit +87 -0
- package/bin/adr-lint +2087 -0
- package/bin/adr-mcp +1093 -0
- package/bin/adr-migrate +644 -0
- package/bin/adr-quality +275 -0
- package/bin/adr-readiness +211 -0
- package/bin/adr-readiness-ci +111 -0
- package/bin/adr-related +401 -0
- package/bin/adr-renumber +254 -0
- package/bin/adr-retire +467 -0
- package/bin/adr-settings +399 -0
- package/bin/adr-status +797 -0
- package/bin/adr-suggest +803 -0
- package/bin/adr-watch +674 -0
- package/bin/adr_catalog.py +536 -0
- package/bin/adr_config.py +280 -0
- package/bin/adr_doctor_checks.py +407 -0
- package/bin/adr_doctor_core.py +342 -0
- package/bin/adr_doctor_models.py +186 -0
- package/bin/adr_doctor_probes.py +216 -0
- package/bin/adr_format.py +786 -0
- package/bin/adr_grill_signal.py +123 -0
- package/bin/adr_guardian_queue.py +218 -0
- package/bin/adr_history_scan.py +278 -0
- package/bin/adr_index_core.py +443 -0
- package/bin/adr_llm.py +333 -0
- package/bin/adr_llm_judge_migration.py +314 -0
- package/bin/adr_quality_core.py +674 -0
- package/bin/adr_query.py +678 -0
- package/bin/adr_readiness.py +442 -0
- package/bin/adr_readiness_ci.py +123 -0
- package/bin/adr_regex.py +165 -0
- package/bin/adr_regex_worker.py +30 -0
- package/bin/adr_retrieval_health.py +385 -0
- package/bin/adr_schema.py +448 -0
- package/bin/adr_state.py +172 -0
- package/bin/bump-version +71 -0
- package/clients/workflows.json +229 -0
- package/hooks/__init__.py +1 -0
- package/hooks/adapters/__init__.py +13 -0
- package/hooks/adapters/claude.py +27 -0
- package/hooks/adapters/codex.py +26 -0
- package/hooks/adapters/copilot.py +11 -0
- package/hooks/adr-hook.py +128 -0
- package/hooks/adr_hook_core.py +843 -0
- package/hooks/adr_pr_guard.py +367 -0
- package/instructions/ADR-guide.md +48 -0
- package/instructions/adr.coding.md +82 -0
- package/instructions/adr.review.md +182 -0
- package/opencode/plugin.ts +451 -0
- package/package.json +41 -0
- package/schemas/adr-context-probes.schema.json +56 -0
- package/schemas/adr-enforcement.schema.json +57 -0
- package/schemas/adr-frontmatter.schema.json +144 -0
- package/schemas/adr-index.schema.json +276 -0
- package/schemas/adr-kit-config.schema.json +371 -0
- package/schemas/adr-readiness.schema.json +41 -0
- package/schemas/client-capabilities.schema.json +503 -0
- package/schemas/client-certification.schema.json +101 -0
- package/schemas/doctor-output.schema.json +92 -0
- package/schemas/marketplace.json.schema.json +70 -0
- package/schemas/plugin.json.schema.json +67 -0
- package/scripts/adr_settings.py +239 -0
- package/scripts/benchmark-adr-grilling.py +323 -0
- package/scripts/benchmark-client-generation.py +178 -0
- package/scripts/build-client-adapters.py +139 -0
- package/scripts/bump-version.py +304 -0
- package/scripts/check-branch-sync.py +243 -0
- package/scripts/check-release-version.py +81 -0
- package/scripts/client_certification.py +153 -0
- package/scripts/client_evidence.py +280 -0
- package/scripts/client_generation.py +288 -0
- package/scripts/client_generation_artifacts.py +351 -0
- package/scripts/client_generation_model.py +173 -0
- package/scripts/client_generation_state.py +260 -0
- package/scripts/client_support_matrix.py +360 -0
- package/scripts/install-agent-envs.py +300 -0
- package/scripts/probe-client-events.py +183 -0
- package/scripts/project_setup.py +379 -0
- package/scripts/refresh-otgw-corpus.py +219 -0
- package/scripts/settings.py +81 -0
- package/scripts/setup-project.py +205 -0
- package/scripts/sync-agent-plugins.py +17 -0
- package/scripts/version_sites.py +377 -0
- package/skills/adr/SKILL.md +780 -0
- package/skills/audit/SKILL.md +103 -0
- package/skills/context/SKILL.md +77 -0
- package/skills/grill/SKILL.md +84 -0
- package/skills/grill/agents/openai.yaml +4 -0
- package/skills/guardian/SKILL.md +316 -0
- package/skills/init/SKILL.md +499 -0
- package/skills/install-hooks/SKILL.md +154 -0
- package/skills/judge/SKILL.md +168 -0
- package/skills/lint/SKILL.md +321 -0
- package/skills/migrate/SKILL.md +313 -0
- package/skills/related/SKILL.md +62 -0
- package/skills/retire/SKILL.md +41 -0
- package/skills/review/SKILL.md +167 -0
- package/skills/settings/SKILL.md +73 -0
- package/skills/setup/SKILL.md +128 -0
- package/skills/supersede/SKILL.md +136 -0
- package/skills/upgrade/SKILL.md +273 -0
- package/templates/adr-kit-guide.md +354 -0
- package/templates/adr-template.canonical.md +115 -0
- package/templates/adr-template.madr.md +131 -0
- package/templates/adr-template.md +131 -0
- package/templates/adr-template.nygard.md +111 -0
- package/templates/cc-settings/guardian-hook-entry.json +9 -0
- package/templates/githooks/pre-commit +337 -0
- package/templates/github-workflows/adr-audit.yml +58 -0
- package/templates/github-workflows/adr-guardian-audit.yml +133 -0
- package/templates/github-workflows/adr-index-check.yml +30 -0
- package/templates/github-workflows/adr-judge.yml +31 -0
- package/templates/github-workflows/adr-readiness.yml +18 -0
- package/templates/validate_adr_template.py +38 -0
- 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
|
+
}
|