@rvdbreemen/adr-kit-opencode 0.52.0 → 0.52.2
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 -29
- package/README.md +861 -850
- package/bin/adr +0 -0
- package/bin/adr-audit +0 -0
- package/bin/adr-context +0 -0
- package/bin/adr-discover +0 -0
- package/bin/adr-doctor +0 -0
- package/bin/adr-generate-scripts +0 -0
- package/bin/adr-grill-signal +0 -0
- package/bin/adr-guardian +0 -0
- package/bin/adr-index +0 -0
- package/bin/adr-judge +0 -0
- package/bin/adr-judge-precommit +0 -0
- package/bin/adr-lint +0 -0
- package/bin/adr-mcp +0 -0
- package/bin/adr-migrate +0 -0
- package/bin/adr-quality +0 -0
- package/bin/adr-readiness +0 -0
- package/bin/adr-readiness-ci +0 -0
- package/bin/adr-related +0 -0
- package/bin/adr-renumber +254 -254
- package/bin/adr-retire +0 -0
- package/bin/adr-settings +0 -0
- package/bin/adr-status +0 -0
- package/bin/adr-suggest +0 -0
- package/bin/adr-watch +0 -0
- package/bin/bump-version +0 -0
- package/clients/workflows.json +229 -229
- package/hooks/__init__.py +1 -1
- package/hooks/adapters/__init__.py +13 -13
- package/hooks/adapters/claude.py +27 -27
- package/hooks/adapters/codex.py +26 -26
- package/hooks/adapters/copilot.py +11 -11
- package/hooks/adr-hook.py +128 -128
- package/hooks/adr_hook_core.py +843 -843
- package/hooks/adr_pr_guard.py +367 -367
- package/instructions/ADR-guide.md +48 -48
- package/instructions/adr.coding.md +82 -82
- package/instructions/adr.review.md +182 -182
- package/opencode/plugin.ts +1 -4
- package/package.json +5 -2
- package/schemas/adr-context-probes.schema.json +56 -56
- package/schemas/adr-enforcement.schema.json +57 -57
- package/schemas/adr-frontmatter.schema.json +144 -144
- package/schemas/adr-index.schema.json +276 -276
- package/schemas/adr-kit-config.schema.json +371 -371
- package/schemas/adr-readiness.schema.json +41 -41
- package/schemas/client-capabilities.schema.json +503 -503
- package/schemas/client-certification.schema.json +101 -101
- package/schemas/doctor-output.schema.json +92 -92
- package/skills/adr/SKILL.md +780 -780
- package/skills/audit/SKILL.md +103 -103
- package/skills/context/SKILL.md +77 -77
- package/skills/grill/SKILL.md +84 -84
- package/skills/grill/agents/openai.yaml +4 -4
- package/skills/guardian/SKILL.md +316 -316
- package/skills/init/SKILL.md +499 -499
- package/skills/install-hooks/SKILL.md +154 -154
- package/skills/judge/SKILL.md +168 -168
- package/skills/lint/SKILL.md +321 -321
- package/skills/migrate/SKILL.md +313 -313
- package/skills/related/SKILL.md +62 -62
- package/skills/retire/SKILL.md +41 -41
- package/skills/review/SKILL.md +167 -167
- package/skills/settings/SKILL.md +73 -73
- package/skills/setup/SKILL.md +128 -128
- package/skills/supersede/SKILL.md +136 -136
- package/skills/upgrade/SKILL.md +273 -273
- package/templates/adr-kit-guide.md +354 -354
- package/templates/adr-template.canonical.md +115 -115
- package/templates/adr-template.madr.md +131 -131
- package/templates/adr-template.md +131 -131
- package/templates/adr-template.nygard.md +111 -111
- package/templates/cc-settings/guardian-hook-entry.json +9 -9
- package/templates/githooks/pre-commit +1 -1
- package/templates/github-workflows/adr-audit.yml +58 -58
- package/templates/github-workflows/adr-guardian-audit.yml +133 -133
- package/templates/github-workflows/adr-index-check.yml +30 -30
- package/templates/github-workflows/adr-judge.yml +31 -31
- package/templates/github-workflows/adr-readiness.yml +18 -18
- package/templates/validate_adr_template.py +38 -38
- package/templates/validate_adr_template.sh +74 -74
|
@@ -1,371 +1,371 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
-
"$id": "https://github.com/rvdbreemen/adr-kit/schemas/adr-kit-config.schema.json",
|
|
4
|
-
"title": "adr-kit project policy (.adr-kit.json)",
|
|
5
|
-
"description": "Schema for the project-level policy file at docs/adr/.adr-kit.json (introduced in adr-kit v0.9.0). Field semantics are documented in the README Configuration section and the lint skill body. Top-level keys starting with '_' (e.g. '_comment', '_note') are silently allowed for embedding annotations and are not subject to validation.",
|
|
6
|
-
"type": "object",
|
|
7
|
-
"additionalProperties": false,
|
|
8
|
-
"patternProperties": {
|
|
9
|
-
"^_": {}
|
|
10
|
-
},
|
|
11
|
-
"properties": {
|
|
12
|
-
"strict_from": {
|
|
13
|
-
"type": "string",
|
|
14
|
-
"description": "First ADR identifier (inclusive) on which all gates are enforced strictly. ADRs with a numerically lower number are linted in advisory mode for the gates that opt in via 'severity'. Format must match the canonical ADR-NNN pattern with three-digit zero-padded number.",
|
|
15
|
-
"pattern": "^ADR-\\d{3}$"
|
|
16
|
-
},
|
|
17
|
-
"ignore": {
|
|
18
|
-
"type": "array",
|
|
19
|
-
"description": "List of ADR identifiers (ADR-NNN) or full filenames to skip entirely. Skipped ADRs appear in the aggregate as SKIPPED but produce no per-gate output.",
|
|
20
|
-
"items": {
|
|
21
|
-
"type": "string",
|
|
22
|
-
"minLength": 1
|
|
23
|
-
}
|
|
24
|
-
},
|
|
25
|
-
"severity": {
|
|
26
|
-
"type": "object",
|
|
27
|
-
"description": "Per-gate severity. Default for completeness, evidence, clarity is 'advisory_before_strict_from' when strict_from is set, 'always_strict' otherwise. Defaults for audit and consistency are 'always_strict' regardless: invalid status chains, filename / heading mismatches, and duplicate numbers are real bugs at any age.",
|
|
28
|
-
"additionalProperties": false,
|
|
29
|
-
"properties": {
|
|
30
|
-
"completeness": {
|
|
31
|
-
"type": "string",
|
|
32
|
-
"enum": [
|
|
33
|
-
"always_strict",
|
|
34
|
-
"always_advisory",
|
|
35
|
-
"advisory_before_strict_from"
|
|
36
|
-
]
|
|
37
|
-
},
|
|
38
|
-
"audit": {
|
|
39
|
-
"type": "string",
|
|
40
|
-
"enum": [
|
|
41
|
-
"always_strict",
|
|
42
|
-
"always_advisory",
|
|
43
|
-
"advisory_before_strict_from"
|
|
44
|
-
]
|
|
45
|
-
},
|
|
46
|
-
"evidence": {
|
|
47
|
-
"type": "string",
|
|
48
|
-
"enum": [
|
|
49
|
-
"always_strict",
|
|
50
|
-
"always_advisory",
|
|
51
|
-
"advisory_before_strict_from"
|
|
52
|
-
]
|
|
53
|
-
},
|
|
54
|
-
"clarity": {
|
|
55
|
-
"type": "string",
|
|
56
|
-
"enum": [
|
|
57
|
-
"always_strict",
|
|
58
|
-
"always_advisory",
|
|
59
|
-
"advisory_before_strict_from"
|
|
60
|
-
]
|
|
61
|
-
},
|
|
62
|
-
"consistency": {
|
|
63
|
-
"type": "string",
|
|
64
|
-
"enum": [
|
|
65
|
-
"always_strict",
|
|
66
|
-
"always_advisory",
|
|
67
|
-
"advisory_before_strict_from"
|
|
68
|
-
]
|
|
69
|
-
},
|
|
70
|
-
"policy": {
|
|
71
|
-
"type": "string",
|
|
72
|
-
"enum": [
|
|
73
|
-
"always_strict",
|
|
74
|
-
"always_advisory",
|
|
75
|
-
"advisory_before_strict_from"
|
|
76
|
-
]
|
|
77
|
-
},
|
|
78
|
-
"quality": {
|
|
79
|
-
"type": "string",
|
|
80
|
-
"enum": [
|
|
81
|
-
"always_strict",
|
|
82
|
-
"always_advisory",
|
|
83
|
-
"advisory_before_strict_from"
|
|
84
|
-
]
|
|
85
|
-
}
|
|
86
|
-
}
|
|
87
|
-
},
|
|
88
|
-
"policy": {
|
|
89
|
-
"type": "object",
|
|
90
|
-
"description": "Configuration for the policy gate (Enforcement block validation), introduced in adr-kit v0.14.0.",
|
|
91
|
-
"additionalProperties": false,
|
|
92
|
-
"properties": {
|
|
93
|
-
"strict_mode": {
|
|
94
|
-
"type": "boolean",
|
|
95
|
-
"description": "When true, schema validation failures are treated as FAIL regardless of severity config. Default true.",
|
|
96
|
-
"default": true
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
},
|
|
100
|
-
"template": {
|
|
101
|
-
"type": "object",
|
|
102
|
-
"description": "Select one shipped ADR body profile for new records, or override lint-required headings. A required_sections override does not register a custom selectable profile. Existing files are parsed by their format frontmatter or deterministic heading detection.",
|
|
103
|
-
"additionalProperties": false,
|
|
104
|
-
"properties": {
|
|
105
|
-
"required_sections": {
|
|
106
|
-
"type": "array",
|
|
107
|
-
"description": "Lint-only required top-level headings, in the order they must appear. Each entry is the exact heading text including the '## ' prefix. This does not create a selectable profile or template.",
|
|
108
|
-
"items": {
|
|
109
|
-
"type": "string",
|
|
110
|
-
"pattern": "^##\\s+\\S"
|
|
111
|
-
},
|
|
112
|
-
"minItems": 1
|
|
113
|
-
},
|
|
114
|
-
"profile": {
|
|
115
|
-
"type": "string",
|
|
116
|
-
"enum": [
|
|
117
|
-
"canonical",
|
|
118
|
-
"madr",
|
|
119
|
-
"nygard"
|
|
120
|
-
],
|
|
121
|
-
"default": "madr",
|
|
122
|
-
"description": "Operational body profile for newly created ADRs. Values are restricted to the shipped profile catalog: MADR is the agent-friendly default; Nygard is concise; canonical preserves the pre-v0.34 adr-kit format. Per-file format frontmatter remains authoritative."
|
|
123
|
-
}
|
|
124
|
-
}
|
|
125
|
-
},
|
|
126
|
-
"judge": {
|
|
127
|
-
"type": "object",
|
|
128
|
-
"description": "Per-project policy for bin/adr-judge. Controls how Enforcement blocks are evaluated against a staged git diff at commit time. The LLM pass runs on the host client's own model - the only backend (ADR-036) - so this COMMITTED file carries no backend choice beyond judge.backend='host', no model name, no command, no endpoint and no credential; additionalProperties:false refuses them, and the removed keys are refused by name with the replacement named (adr_config.REMOVED_KEYS). The one per-machine fact -- which client CLI the host backend calls -- lives in the gitignored docs/adr/.adr-kit.local.json, written by /adr-kit:init or `adr-judge --set-backend host --host-client <id>`.",
|
|
129
|
-
"additionalProperties": false,
|
|
130
|
-
"properties": {
|
|
131
|
-
"backend": {
|
|
132
|
-
"type": "string",
|
|
133
|
-
"enum": [
|
|
134
|
-
"host"
|
|
135
|
-
],
|
|
136
|
-
"default": "host",
|
|
137
|
-
"description": "Which backend answers the LLM pass. 'host' (the only value, ADR-036): the coding client's own CLI, recorded at install time, no model flag. Operators may override per run with ADR_KIT_LLM_CMD / --llm-cmd."
|
|
138
|
-
},
|
|
139
|
-
"skip_files": {
|
|
140
|
-
"type": "array",
|
|
141
|
-
"description": "Glob patterns for files to exclude from judging. Matches relative to the repo root. Common entries: 'tests/**', 'docs/**', 'vendor/**'. ADR-level path_globs still take precedence; this is a project-wide pre-filter.",
|
|
142
|
-
"items": {
|
|
143
|
-
"type": "string",
|
|
144
|
-
"minLength": 1
|
|
145
|
-
}
|
|
146
|
-
},
|
|
147
|
-
"advisory_only": {
|
|
148
|
-
"type": "boolean",
|
|
149
|
-
"description": "When true, all violations from declarative rules are downgraded to advisory (the hook prints them but exits 0). Intended for early adoption phases where teams want visibility without blocking commits. Default false.",
|
|
150
|
-
"default": false
|
|
151
|
-
},
|
|
152
|
-
"max_diff_bytes": {
|
|
153
|
-
"type": "integer",
|
|
154
|
-
"description": "Diffs larger than this size (in UTF-8 bytes) fail closed with an actionable configuration error because deterministic enforcement did not run. Protects against pathological commits without creating a success bypass. Default 1048576 (1 MiB). Set 0 to disable the cap explicitly. This number governs the PRE-COMMIT path, which judges a single commit and is bound by ADR-015's latency budget. A CI gate judging origin/<base>...HEAD sees a whole-branch diff that is routinely larger, and must pass its own budget with the --max-diff-bytes flag rather than raising this one -- otherwise the local commit budget rises with it (TASK-73).",
|
|
155
|
-
"minimum": 0,
|
|
156
|
-
"default": 1048576
|
|
157
|
-
},
|
|
158
|
-
"llm_enabled": {
|
|
159
|
-
"type": "boolean",
|
|
160
|
-
"description": "User-facing master switch for the per-commit LLM pass. When true, bin/adr-judge asks judge.backend for a verdict on every llm_judge:true ADR at commit time, one isolated call each. Default TRUE as of ADR-017, which superseded the opt-in default of v0.17.0. What bounds the cost is the other flag: llm_judge is per-ADR and defaults to false, so a default-on judge over an empty population costs nothing until an author deliberately opts an ADR in. Once one is opted in, expect one model call per commit that touches its scope, every time -- cost is linear in the number of llm_judge ADRs, not amortised across them. Set false here to switch the pass off project-wide, or ADR_KIT_NO_LLM=1 for a single commit.",
|
|
161
|
-
"default": true
|
|
162
|
-
},
|
|
163
|
-
"llm_timeout_seconds": {
|
|
164
|
-
"type": "integer",
|
|
165
|
-
"description": "Hard timeout in seconds for each individual LLM judge call. Default 120. Per-ADR isolation means one call runs per ADR marked llm_judge, so this bounds each call in a loop, not the pass as a whole: a project with N such ADRs has a worst case of N x this value on a single commit. At the default, 10 ADRs is a 20-minute worst case and 20 ADRs is 40 minutes. Lower it, or reduce how many ADRs carry llm_judge, if that is more than a commit can spend.",
|
|
166
|
-
"minimum": 1,
|
|
167
|
-
"default": 120
|
|
168
|
-
},
|
|
169
|
-
"pre_commit_timeout_ms": {
|
|
170
|
-
"type": "integer",
|
|
171
|
-
"description": "Performance budget in milliseconds for the non-blocking pre-commit perf WARN (TASK-712 performance-bounded hooks; surfaced in bin/adr-judge --profile). When the pre-commit pass runs longer than this and warn_on_exceed is true, a non-blocking WARN is printed; the commit is never blocked by this budget. Distinct from llm_timeout_seconds, which is the hard per-call LLM call timeout. Default 5000.",
|
|
172
|
-
"minimum": 0,
|
|
173
|
-
"default": 5000
|
|
174
|
-
},
|
|
175
|
-
"warn_on_exceed": {
|
|
176
|
-
"type": "boolean",
|
|
177
|
-
"description": "When true, emit a non-blocking WARN whenever a phase exceeds its *_timeout_ms performance budget (TASK-712). Advisory only; never blocks the commit or push. Default true.",
|
|
178
|
-
"default": true
|
|
179
|
-
}
|
|
180
|
-
}
|
|
181
|
-
},
|
|
182
|
-
"suggest": {
|
|
183
|
-
"type": "object",
|
|
184
|
-
"description": "Per-project policy for bin/adr-suggest, the advisory counterpart to adr-judge: it runs an LLM pass over the staged diff to detect whether the change introduces a NEW architectural decision not yet covered by an ADR, and prints a non-blocking suggestion. It NEVER blocks a commit. All keys are optional; an absent block means defaults. Which model is asked is not configured here: adr-suggest resolves the same host backend as the judge (ADR-036).",
|
|
185
|
-
"additionalProperties": false,
|
|
186
|
-
"properties": {
|
|
187
|
-
"enabled": {
|
|
188
|
-
"type": "boolean",
|
|
189
|
-
"description": "When true, the pre-commit hook and the pull-request guard run the adr-suggest pass. Default true (ADR-035), on the same terms ADR-017 set for the judge: one shared backend registry and the host CLI's own model, so no separate metered spend against a pin. The opt-in this replaced came from ADR-001, which ADR-017 superseded without carrying its reasoning to this second entry point. Set false here to switch it off per project, or export ADR_KIT_SUGGEST_DISABLE=1 to switch it off for one run; ADR_KIT_SUGGEST=1 still re-enables it per commit for a project that has set false. Honored by bin/adr-suggest directly.",
|
|
190
|
-
"default": true
|
|
191
|
-
},
|
|
192
|
-
"llm_timeout_seconds": {
|
|
193
|
-
"type": "integer",
|
|
194
|
-
"description": "Per-call timeout for the suggestion LLM pass in seconds. Defaults to judge.llm_timeout_seconds, then 120.",
|
|
195
|
-
"minimum": 1,
|
|
196
|
-
"default": 120
|
|
197
|
-
}
|
|
198
|
-
}
|
|
199
|
-
},
|
|
200
|
-
"context": {
|
|
201
|
-
"type": "object",
|
|
202
|
-
"description": "Configuration for bin/adr-context semantic ranking",
|
|
203
|
-
"properties": {
|
|
204
|
-
"default_limit": {
|
|
205
|
-
"type": "integer",
|
|
206
|
-
"minimum": 1,
|
|
207
|
-
"maximum": 100,
|
|
208
|
-
"default": 5
|
|
209
|
-
},
|
|
210
|
-
"min_score": {
|
|
211
|
-
"type": "number",
|
|
212
|
-
"minimum": 0,
|
|
213
|
-
"maximum": 1,
|
|
214
|
-
"default": 0.1
|
|
215
|
-
},
|
|
216
|
-
"strict_index": {
|
|
217
|
-
"type": "boolean",
|
|
218
|
-
"default": false,
|
|
219
|
-
"description": "Fail queries instead of using the visible Markdown compatibility fallback when the generated index is unavailable, stale, invalid, or unsupported."
|
|
220
|
-
},
|
|
221
|
-
"probes_file": {
|
|
222
|
-
"type": "string",
|
|
223
|
-
"minLength": 1,
|
|
224
|
-
"default": "adr-context-probes.json",
|
|
225
|
-
"description": "Project-relative retrieval probe file, resolved from the ADR directory."
|
|
226
|
-
},
|
|
227
|
-
"retrieval_completeness": {
|
|
228
|
-
"enum": [
|
|
229
|
-
"off",
|
|
230
|
-
"advisory",
|
|
231
|
-
"strict"
|
|
232
|
-
],
|
|
233
|
-
"default": "advisory",
|
|
234
|
-
"description": "Metadata completeness policy for Accepted binding ADRs. Strict is opt-in after migration."
|
|
235
|
-
}
|
|
236
|
-
},
|
|
237
|
-
"additionalProperties": false
|
|
238
|
-
},
|
|
239
|
-
"retirement": {
|
|
240
|
-
"type": "object",
|
|
241
|
-
"description": "Configuration for bin/adr-retire retirement detection",
|
|
242
|
-
"properties": {
|
|
243
|
-
"threshold_days": {
|
|
244
|
-
"type": "integer",
|
|
245
|
-
"minimum": 1,
|
|
246
|
-
"default": 90
|
|
247
|
-
},
|
|
248
|
-
"check_tech_removal": {
|
|
249
|
-
"type": "boolean",
|
|
250
|
-
"default": true
|
|
251
|
-
},
|
|
252
|
-
"check_supersession": {
|
|
253
|
-
"type": "boolean",
|
|
254
|
-
"default": true
|
|
255
|
-
},
|
|
256
|
-
"check_policy_mismatch": {
|
|
257
|
-
"type": "boolean",
|
|
258
|
-
"default": true
|
|
259
|
-
}
|
|
260
|
-
},
|
|
261
|
-
"additionalProperties": false
|
|
262
|
-
},
|
|
263
|
-
"watch": {
|
|
264
|
-
"type": "object",
|
|
265
|
-
"description": "Configuration for bin/adr-watch (in-flight ADR guidance via the PostToolUse hook), introduced in adr-kit v0.21. adr-watch prints at most three compact one-line nudges naming the Accepted ADRs that likely apply to a just-edited file. It is deterministic (no LLM, no network), advisory only, and always exits 0.",
|
|
266
|
-
"additionalProperties": false,
|
|
267
|
-
"properties": {
|
|
268
|
-
"enabled": {
|
|
269
|
-
"type": "boolean",
|
|
270
|
-
"description": "When false, adr-watch never emits a nudge and the PostToolUse hook is effectively a no-op for this project. Default true: detection is free and deterministic.",
|
|
271
|
-
"default": true
|
|
272
|
-
},
|
|
273
|
-
"cooldown_hours": {
|
|
274
|
-
"type": "number",
|
|
275
|
-
"description": "Minimum hours before the same ADR+file pair is nudged again. Prevents repeat nudges while iterating on one file within a session. Default 4. Set 0 to disable the cooldown entirely.",
|
|
276
|
-
"minimum": 0,
|
|
277
|
-
"default": 4
|
|
278
|
-
}
|
|
279
|
-
}
|
|
280
|
-
},
|
|
281
|
-
"inject": {
|
|
282
|
-
"type": "object",
|
|
283
|
-
"description": "Configuration for the bin/adr-watch edit-tier injector (PreToolUse hook), introduced in adr-kit v0.31 (ADR-004). Before an Edit/Write, it injects the top-ranked governing Accepted ADR's Decision text so the agent honours the decision before writing. Deterministic (no LLM, no network), advisory only, always exits 0.",
|
|
284
|
-
"additionalProperties": false,
|
|
285
|
-
"properties": {
|
|
286
|
-
"enabled": {
|
|
287
|
-
"type": "boolean",
|
|
288
|
-
"description": "When false, the PreToolUse injector never emits context and the hook is a no-op for this project. Default true.",
|
|
289
|
-
"default": true
|
|
290
|
-
},
|
|
291
|
-
"max_tokens": {
|
|
292
|
-
"type": "integer",
|
|
293
|
-
"description": "Approximate upper bound on injected Decision text, in tokens (coarse chars/token estimate). The single top-ranked ADR's Decision is truncated to this budget so context is not flooded. Default 400. Set 0 to disable truncation.",
|
|
294
|
-
"minimum": 0,
|
|
295
|
-
"default": 400
|
|
296
|
-
},
|
|
297
|
-
"cooldown_hours": {
|
|
298
|
-
"type": "number",
|
|
299
|
-
"description": "Minimum hours before the same ADR+file pair is injected again. Independent of the watch cooldown. Default 4. Set 0 to disable.",
|
|
300
|
-
"minimum": 0,
|
|
301
|
-
"default": 4
|
|
302
|
-
}
|
|
303
|
-
}
|
|
304
|
-
},
|
|
305
|
-
"lifecycle": {
|
|
306
|
-
"type": "object",
|
|
307
|
-
"description": "Configuration for the ADR lifecycle commands (bin/adr document, bin/adr accept --auto), introduced in adr-kit v0.37.0. Controls the auto-accept gate defaults that apply when --auto is used without explicit flags.",
|
|
308
|
-
"additionalProperties": false,
|
|
309
|
-
"properties": {
|
|
310
|
-
"auto_accept": {
|
|
311
|
-
"type": "object",
|
|
312
|
-
"description": "Defaults for 'adr accept --auto'. All keys are optional; CLI flags override config values.",
|
|
313
|
-
"additionalProperties": false,
|
|
314
|
-
"properties": {
|
|
315
|
-
"mode": {
|
|
316
|
-
"type": "string",
|
|
317
|
-
"enum": [
|
|
318
|
-
"auto",
|
|
319
|
-
"assist"
|
|
320
|
-
],
|
|
321
|
-
"description": "Default operating mode for 'adr accept --auto'. 'assist' (default) reports eligibility without mutating the file; 'auto' immediately accepts and rewrites the ADR when all gates pass. Overridden by --auto-mode on the command line.",
|
|
322
|
-
"default": "assist"
|
|
323
|
-
},
|
|
324
|
-
"quality_threshold": {
|
|
325
|
-
"type": "number",
|
|
326
|
-
"minimum": 0,
|
|
327
|
-
"maximum": 1,
|
|
328
|
-
"description": "Minimum quality score (0.0\u20131.0) required before auto-accept proceeds. Overridden by --quality-threshold on the command line. Default 0.70.",
|
|
329
|
-
"default": 0.7
|
|
330
|
-
}
|
|
331
|
-
}
|
|
332
|
-
}
|
|
333
|
-
}
|
|
334
|
-
},
|
|
335
|
-
"guardian": {
|
|
336
|
-
"type": "object",
|
|
337
|
-
"description": "Configuration for the ADR Guardian (bin/adr-guardian + /adr-kit:guardian skill), introduced in adr-kit v0.18.0. The guardian is a periodic ADR-set health detector that injects a staleness nudge at Claude Code SessionStart when a health tier is due. Detection is free (no LLM) and default-on. The LLM tier (adr-suggest + audit) always asks before spending unless llm_autorun is explicitly set true.",
|
|
338
|
-
"additionalProperties": false,
|
|
339
|
-
"properties": {
|
|
340
|
-
"enabled": {
|
|
341
|
-
"type": "boolean",
|
|
342
|
-
"description": "When false, the guardian detector is disabled entirely and no nudge is ever emitted. Default true. The guardian's detection (cheap tier) is free; disabling it only makes sense for projects that run a CI-based sweep instead.",
|
|
343
|
-
"default": true
|
|
344
|
-
},
|
|
345
|
-
"drift_stale_days": {
|
|
346
|
-
"type": "number",
|
|
347
|
-
"description": "Number of days after which the cheap tier (drift + retire + lint) is considered stale and triggers a nudge. Default 1 (daily). Fractional values are accepted (e.g. 0.5 for a 12-hour cadence).",
|
|
348
|
-
"minimum": 0,
|
|
349
|
-
"default": 1
|
|
350
|
-
},
|
|
351
|
-
"llm_stale_days": {
|
|
352
|
-
"type": "number",
|
|
353
|
-
"description": "Number of days after which the LLM tier (adr-suggest missing-ADR detection + full audit) is considered stale and triggers a nudge. Default 14 (bi-weekly). The LLM tier costs money; keep this at 14 or higher to avoid frequent spend.",
|
|
354
|
-
"minimum": 0,
|
|
355
|
-
"default": 14
|
|
356
|
-
},
|
|
357
|
-
"nudge_cooldown_hours": {
|
|
358
|
-
"type": "number",
|
|
359
|
-
"description": "Minimum hours between successive nudges at SessionStart. Prevents repeated nags within a single work day when sessions are opened frequently. Default 24 (once per day at most).",
|
|
360
|
-
"minimum": 0,
|
|
361
|
-
"default": 24
|
|
362
|
-
},
|
|
363
|
-
"llm_autorun": {
|
|
364
|
-
"type": "boolean",
|
|
365
|
-
"description": "When false (default), the /adr-kit:guardian skill always asks the user to confirm cost before running the LLM tier (adr-suggest + full audit). Set true only if you want the LLM tier to run without an interactive confirmation \u2014 consistent with ADR-001's opt-in posture, this defaults to false. The cheap tier (drift + retire + lint) is always free and unaffected by this flag.",
|
|
366
|
-
"default": false
|
|
367
|
-
}
|
|
368
|
-
}
|
|
369
|
-
}
|
|
370
|
-
}
|
|
371
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"$schema": "http://json-schema.org/draft-07/schema#",
|
|
3
|
+
"$id": "https://github.com/rvdbreemen/adr-kit/schemas/adr-kit-config.schema.json",
|
|
4
|
+
"title": "adr-kit project policy (.adr-kit.json)",
|
|
5
|
+
"description": "Schema for the project-level policy file at docs/adr/.adr-kit.json (introduced in adr-kit v0.9.0). Field semantics are documented in the README Configuration section and the lint skill body. Top-level keys starting with '_' (e.g. '_comment', '_note') are silently allowed for embedding annotations and are not subject to validation.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"patternProperties": {
|
|
9
|
+
"^_": {}
|
|
10
|
+
},
|
|
11
|
+
"properties": {
|
|
12
|
+
"strict_from": {
|
|
13
|
+
"type": "string",
|
|
14
|
+
"description": "First ADR identifier (inclusive) on which all gates are enforced strictly. ADRs with a numerically lower number are linted in advisory mode for the gates that opt in via 'severity'. Format must match the canonical ADR-NNN pattern with three-digit zero-padded number.",
|
|
15
|
+
"pattern": "^ADR-\\d{3}$"
|
|
16
|
+
},
|
|
17
|
+
"ignore": {
|
|
18
|
+
"type": "array",
|
|
19
|
+
"description": "List of ADR identifiers (ADR-NNN) or full filenames to skip entirely. Skipped ADRs appear in the aggregate as SKIPPED but produce no per-gate output.",
|
|
20
|
+
"items": {
|
|
21
|
+
"type": "string",
|
|
22
|
+
"minLength": 1
|
|
23
|
+
}
|
|
24
|
+
},
|
|
25
|
+
"severity": {
|
|
26
|
+
"type": "object",
|
|
27
|
+
"description": "Per-gate severity. Default for completeness, evidence, clarity is 'advisory_before_strict_from' when strict_from is set, 'always_strict' otherwise. Defaults for audit and consistency are 'always_strict' regardless: invalid status chains, filename / heading mismatches, and duplicate numbers are real bugs at any age.",
|
|
28
|
+
"additionalProperties": false,
|
|
29
|
+
"properties": {
|
|
30
|
+
"completeness": {
|
|
31
|
+
"type": "string",
|
|
32
|
+
"enum": [
|
|
33
|
+
"always_strict",
|
|
34
|
+
"always_advisory",
|
|
35
|
+
"advisory_before_strict_from"
|
|
36
|
+
]
|
|
37
|
+
},
|
|
38
|
+
"audit": {
|
|
39
|
+
"type": "string",
|
|
40
|
+
"enum": [
|
|
41
|
+
"always_strict",
|
|
42
|
+
"always_advisory",
|
|
43
|
+
"advisory_before_strict_from"
|
|
44
|
+
]
|
|
45
|
+
},
|
|
46
|
+
"evidence": {
|
|
47
|
+
"type": "string",
|
|
48
|
+
"enum": [
|
|
49
|
+
"always_strict",
|
|
50
|
+
"always_advisory",
|
|
51
|
+
"advisory_before_strict_from"
|
|
52
|
+
]
|
|
53
|
+
},
|
|
54
|
+
"clarity": {
|
|
55
|
+
"type": "string",
|
|
56
|
+
"enum": [
|
|
57
|
+
"always_strict",
|
|
58
|
+
"always_advisory",
|
|
59
|
+
"advisory_before_strict_from"
|
|
60
|
+
]
|
|
61
|
+
},
|
|
62
|
+
"consistency": {
|
|
63
|
+
"type": "string",
|
|
64
|
+
"enum": [
|
|
65
|
+
"always_strict",
|
|
66
|
+
"always_advisory",
|
|
67
|
+
"advisory_before_strict_from"
|
|
68
|
+
]
|
|
69
|
+
},
|
|
70
|
+
"policy": {
|
|
71
|
+
"type": "string",
|
|
72
|
+
"enum": [
|
|
73
|
+
"always_strict",
|
|
74
|
+
"always_advisory",
|
|
75
|
+
"advisory_before_strict_from"
|
|
76
|
+
]
|
|
77
|
+
},
|
|
78
|
+
"quality": {
|
|
79
|
+
"type": "string",
|
|
80
|
+
"enum": [
|
|
81
|
+
"always_strict",
|
|
82
|
+
"always_advisory",
|
|
83
|
+
"advisory_before_strict_from"
|
|
84
|
+
]
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
},
|
|
88
|
+
"policy": {
|
|
89
|
+
"type": "object",
|
|
90
|
+
"description": "Configuration for the policy gate (Enforcement block validation), introduced in adr-kit v0.14.0.",
|
|
91
|
+
"additionalProperties": false,
|
|
92
|
+
"properties": {
|
|
93
|
+
"strict_mode": {
|
|
94
|
+
"type": "boolean",
|
|
95
|
+
"description": "When true, schema validation failures are treated as FAIL regardless of severity config. Default true.",
|
|
96
|
+
"default": true
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
},
|
|
100
|
+
"template": {
|
|
101
|
+
"type": "object",
|
|
102
|
+
"description": "Select one shipped ADR body profile for new records, or override lint-required headings. A required_sections override does not register a custom selectable profile. Existing files are parsed by their format frontmatter or deterministic heading detection.",
|
|
103
|
+
"additionalProperties": false,
|
|
104
|
+
"properties": {
|
|
105
|
+
"required_sections": {
|
|
106
|
+
"type": "array",
|
|
107
|
+
"description": "Lint-only required top-level headings, in the order they must appear. Each entry is the exact heading text including the '## ' prefix. This does not create a selectable profile or template.",
|
|
108
|
+
"items": {
|
|
109
|
+
"type": "string",
|
|
110
|
+
"pattern": "^##\\s+\\S"
|
|
111
|
+
},
|
|
112
|
+
"minItems": 1
|
|
113
|
+
},
|
|
114
|
+
"profile": {
|
|
115
|
+
"type": "string",
|
|
116
|
+
"enum": [
|
|
117
|
+
"canonical",
|
|
118
|
+
"madr",
|
|
119
|
+
"nygard"
|
|
120
|
+
],
|
|
121
|
+
"default": "madr",
|
|
122
|
+
"description": "Operational body profile for newly created ADRs. Values are restricted to the shipped profile catalog: MADR is the agent-friendly default; Nygard is concise; canonical preserves the pre-v0.34 adr-kit format. Per-file format frontmatter remains authoritative."
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
},
|
|
126
|
+
"judge": {
|
|
127
|
+
"type": "object",
|
|
128
|
+
"description": "Per-project policy for bin/adr-judge. Controls how Enforcement blocks are evaluated against a staged git diff at commit time. The LLM pass runs on the host client's own model - the only backend (ADR-036) - so this COMMITTED file carries no backend choice beyond judge.backend='host', no model name, no command, no endpoint and no credential; additionalProperties:false refuses them, and the removed keys are refused by name with the replacement named (adr_config.REMOVED_KEYS). The one per-machine fact -- which client CLI the host backend calls -- lives in the gitignored docs/adr/.adr-kit.local.json, written by /adr-kit:init or `adr-judge --set-backend host --host-client <id>`.",
|
|
129
|
+
"additionalProperties": false,
|
|
130
|
+
"properties": {
|
|
131
|
+
"backend": {
|
|
132
|
+
"type": "string",
|
|
133
|
+
"enum": [
|
|
134
|
+
"host"
|
|
135
|
+
],
|
|
136
|
+
"default": "host",
|
|
137
|
+
"description": "Which backend answers the LLM pass. 'host' (the only value, ADR-036): the coding client's own CLI, recorded at install time, no model flag. Operators may override per run with ADR_KIT_LLM_CMD / --llm-cmd."
|
|
138
|
+
},
|
|
139
|
+
"skip_files": {
|
|
140
|
+
"type": "array",
|
|
141
|
+
"description": "Glob patterns for files to exclude from judging. Matches relative to the repo root. Common entries: 'tests/**', 'docs/**', 'vendor/**'. ADR-level path_globs still take precedence; this is a project-wide pre-filter.",
|
|
142
|
+
"items": {
|
|
143
|
+
"type": "string",
|
|
144
|
+
"minLength": 1
|
|
145
|
+
}
|
|
146
|
+
},
|
|
147
|
+
"advisory_only": {
|
|
148
|
+
"type": "boolean",
|
|
149
|
+
"description": "When true, all violations from declarative rules are downgraded to advisory (the hook prints them but exits 0). Intended for early adoption phases where teams want visibility without blocking commits. Default false.",
|
|
150
|
+
"default": false
|
|
151
|
+
},
|
|
152
|
+
"max_diff_bytes": {
|
|
153
|
+
"type": "integer",
|
|
154
|
+
"description": "Diffs larger than this size (in UTF-8 bytes) fail closed with an actionable configuration error because deterministic enforcement did not run. Protects against pathological commits without creating a success bypass. Default 1048576 (1 MiB). Set 0 to disable the cap explicitly. This number governs the PRE-COMMIT path, which judges a single commit and is bound by ADR-015's latency budget. A CI gate judging origin/<base>...HEAD sees a whole-branch diff that is routinely larger, and must pass its own budget with the --max-diff-bytes flag rather than raising this one -- otherwise the local commit budget rises with it (TASK-73).",
|
|
155
|
+
"minimum": 0,
|
|
156
|
+
"default": 1048576
|
|
157
|
+
},
|
|
158
|
+
"llm_enabled": {
|
|
159
|
+
"type": "boolean",
|
|
160
|
+
"description": "User-facing master switch for the per-commit LLM pass. When true, bin/adr-judge asks judge.backend for a verdict on every llm_judge:true ADR at commit time, one isolated call each. Default TRUE as of ADR-017, which superseded the opt-in default of v0.17.0. What bounds the cost is the other flag: llm_judge is per-ADR and defaults to false, so a default-on judge over an empty population costs nothing until an author deliberately opts an ADR in. Once one is opted in, expect one model call per commit that touches its scope, every time -- cost is linear in the number of llm_judge ADRs, not amortised across them. Set false here to switch the pass off project-wide, or ADR_KIT_NO_LLM=1 for a single commit.",
|
|
161
|
+
"default": true
|
|
162
|
+
},
|
|
163
|
+
"llm_timeout_seconds": {
|
|
164
|
+
"type": "integer",
|
|
165
|
+
"description": "Hard timeout in seconds for each individual LLM judge call. Default 120. Per-ADR isolation means one call runs per ADR marked llm_judge, so this bounds each call in a loop, not the pass as a whole: a project with N such ADRs has a worst case of N x this value on a single commit. At the default, 10 ADRs is a 20-minute worst case and 20 ADRs is 40 minutes. Lower it, or reduce how many ADRs carry llm_judge, if that is more than a commit can spend.",
|
|
166
|
+
"minimum": 1,
|
|
167
|
+
"default": 120
|
|
168
|
+
},
|
|
169
|
+
"pre_commit_timeout_ms": {
|
|
170
|
+
"type": "integer",
|
|
171
|
+
"description": "Performance budget in milliseconds for the non-blocking pre-commit perf WARN (TASK-712 performance-bounded hooks; surfaced in bin/adr-judge --profile). When the pre-commit pass runs longer than this and warn_on_exceed is true, a non-blocking WARN is printed; the commit is never blocked by this budget. Distinct from llm_timeout_seconds, which is the hard per-call LLM call timeout. Default 5000.",
|
|
172
|
+
"minimum": 0,
|
|
173
|
+
"default": 5000
|
|
174
|
+
},
|
|
175
|
+
"warn_on_exceed": {
|
|
176
|
+
"type": "boolean",
|
|
177
|
+
"description": "When true, emit a non-blocking WARN whenever a phase exceeds its *_timeout_ms performance budget (TASK-712). Advisory only; never blocks the commit or push. Default true.",
|
|
178
|
+
"default": true
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
},
|
|
182
|
+
"suggest": {
|
|
183
|
+
"type": "object",
|
|
184
|
+
"description": "Per-project policy for bin/adr-suggest, the advisory counterpart to adr-judge: it runs an LLM pass over the staged diff to detect whether the change introduces a NEW architectural decision not yet covered by an ADR, and prints a non-blocking suggestion. It NEVER blocks a commit. All keys are optional; an absent block means defaults. Which model is asked is not configured here: adr-suggest resolves the same host backend as the judge (ADR-036).",
|
|
185
|
+
"additionalProperties": false,
|
|
186
|
+
"properties": {
|
|
187
|
+
"enabled": {
|
|
188
|
+
"type": "boolean",
|
|
189
|
+
"description": "When true, the pre-commit hook and the pull-request guard run the adr-suggest pass. Default true (ADR-035), on the same terms ADR-017 set for the judge: one shared backend registry and the host CLI's own model, so no separate metered spend against a pin. The opt-in this replaced came from ADR-001, which ADR-017 superseded without carrying its reasoning to this second entry point. Set false here to switch it off per project, or export ADR_KIT_SUGGEST_DISABLE=1 to switch it off for one run; ADR_KIT_SUGGEST=1 still re-enables it per commit for a project that has set false. Honored by bin/adr-suggest directly.",
|
|
190
|
+
"default": true
|
|
191
|
+
},
|
|
192
|
+
"llm_timeout_seconds": {
|
|
193
|
+
"type": "integer",
|
|
194
|
+
"description": "Per-call timeout for the suggestion LLM pass in seconds. Defaults to judge.llm_timeout_seconds, then 120.",
|
|
195
|
+
"minimum": 1,
|
|
196
|
+
"default": 120
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
},
|
|
200
|
+
"context": {
|
|
201
|
+
"type": "object",
|
|
202
|
+
"description": "Configuration for bin/adr-context semantic ranking",
|
|
203
|
+
"properties": {
|
|
204
|
+
"default_limit": {
|
|
205
|
+
"type": "integer",
|
|
206
|
+
"minimum": 1,
|
|
207
|
+
"maximum": 100,
|
|
208
|
+
"default": 5
|
|
209
|
+
},
|
|
210
|
+
"min_score": {
|
|
211
|
+
"type": "number",
|
|
212
|
+
"minimum": 0,
|
|
213
|
+
"maximum": 1,
|
|
214
|
+
"default": 0.1
|
|
215
|
+
},
|
|
216
|
+
"strict_index": {
|
|
217
|
+
"type": "boolean",
|
|
218
|
+
"default": false,
|
|
219
|
+
"description": "Fail queries instead of using the visible Markdown compatibility fallback when the generated index is unavailable, stale, invalid, or unsupported."
|
|
220
|
+
},
|
|
221
|
+
"probes_file": {
|
|
222
|
+
"type": "string",
|
|
223
|
+
"minLength": 1,
|
|
224
|
+
"default": "adr-context-probes.json",
|
|
225
|
+
"description": "Project-relative retrieval probe file, resolved from the ADR directory."
|
|
226
|
+
},
|
|
227
|
+
"retrieval_completeness": {
|
|
228
|
+
"enum": [
|
|
229
|
+
"off",
|
|
230
|
+
"advisory",
|
|
231
|
+
"strict"
|
|
232
|
+
],
|
|
233
|
+
"default": "advisory",
|
|
234
|
+
"description": "Metadata completeness policy for Accepted binding ADRs. Strict is opt-in after migration."
|
|
235
|
+
}
|
|
236
|
+
},
|
|
237
|
+
"additionalProperties": false
|
|
238
|
+
},
|
|
239
|
+
"retirement": {
|
|
240
|
+
"type": "object",
|
|
241
|
+
"description": "Configuration for bin/adr-retire retirement detection",
|
|
242
|
+
"properties": {
|
|
243
|
+
"threshold_days": {
|
|
244
|
+
"type": "integer",
|
|
245
|
+
"minimum": 1,
|
|
246
|
+
"default": 90
|
|
247
|
+
},
|
|
248
|
+
"check_tech_removal": {
|
|
249
|
+
"type": "boolean",
|
|
250
|
+
"default": true
|
|
251
|
+
},
|
|
252
|
+
"check_supersession": {
|
|
253
|
+
"type": "boolean",
|
|
254
|
+
"default": true
|
|
255
|
+
},
|
|
256
|
+
"check_policy_mismatch": {
|
|
257
|
+
"type": "boolean",
|
|
258
|
+
"default": true
|
|
259
|
+
}
|
|
260
|
+
},
|
|
261
|
+
"additionalProperties": false
|
|
262
|
+
},
|
|
263
|
+
"watch": {
|
|
264
|
+
"type": "object",
|
|
265
|
+
"description": "Configuration for bin/adr-watch (in-flight ADR guidance via the PostToolUse hook), introduced in adr-kit v0.21. adr-watch prints at most three compact one-line nudges naming the Accepted ADRs that likely apply to a just-edited file. It is deterministic (no LLM, no network), advisory only, and always exits 0.",
|
|
266
|
+
"additionalProperties": false,
|
|
267
|
+
"properties": {
|
|
268
|
+
"enabled": {
|
|
269
|
+
"type": "boolean",
|
|
270
|
+
"description": "When false, adr-watch never emits a nudge and the PostToolUse hook is effectively a no-op for this project. Default true: detection is free and deterministic.",
|
|
271
|
+
"default": true
|
|
272
|
+
},
|
|
273
|
+
"cooldown_hours": {
|
|
274
|
+
"type": "number",
|
|
275
|
+
"description": "Minimum hours before the same ADR+file pair is nudged again. Prevents repeat nudges while iterating on one file within a session. Default 4. Set 0 to disable the cooldown entirely.",
|
|
276
|
+
"minimum": 0,
|
|
277
|
+
"default": 4
|
|
278
|
+
}
|
|
279
|
+
}
|
|
280
|
+
},
|
|
281
|
+
"inject": {
|
|
282
|
+
"type": "object",
|
|
283
|
+
"description": "Configuration for the bin/adr-watch edit-tier injector (PreToolUse hook), introduced in adr-kit v0.31 (ADR-004). Before an Edit/Write, it injects the top-ranked governing Accepted ADR's Decision text so the agent honours the decision before writing. Deterministic (no LLM, no network), advisory only, always exits 0.",
|
|
284
|
+
"additionalProperties": false,
|
|
285
|
+
"properties": {
|
|
286
|
+
"enabled": {
|
|
287
|
+
"type": "boolean",
|
|
288
|
+
"description": "When false, the PreToolUse injector never emits context and the hook is a no-op for this project. Default true.",
|
|
289
|
+
"default": true
|
|
290
|
+
},
|
|
291
|
+
"max_tokens": {
|
|
292
|
+
"type": "integer",
|
|
293
|
+
"description": "Approximate upper bound on injected Decision text, in tokens (coarse chars/token estimate). The single top-ranked ADR's Decision is truncated to this budget so context is not flooded. Default 400. Set 0 to disable truncation.",
|
|
294
|
+
"minimum": 0,
|
|
295
|
+
"default": 400
|
|
296
|
+
},
|
|
297
|
+
"cooldown_hours": {
|
|
298
|
+
"type": "number",
|
|
299
|
+
"description": "Minimum hours before the same ADR+file pair is injected again. Independent of the watch cooldown. Default 4. Set 0 to disable.",
|
|
300
|
+
"minimum": 0,
|
|
301
|
+
"default": 4
|
|
302
|
+
}
|
|
303
|
+
}
|
|
304
|
+
},
|
|
305
|
+
"lifecycle": {
|
|
306
|
+
"type": "object",
|
|
307
|
+
"description": "Configuration for the ADR lifecycle commands (bin/adr document, bin/adr accept --auto), introduced in adr-kit v0.37.0. Controls the auto-accept gate defaults that apply when --auto is used without explicit flags.",
|
|
308
|
+
"additionalProperties": false,
|
|
309
|
+
"properties": {
|
|
310
|
+
"auto_accept": {
|
|
311
|
+
"type": "object",
|
|
312
|
+
"description": "Defaults for 'adr accept --auto'. All keys are optional; CLI flags override config values.",
|
|
313
|
+
"additionalProperties": false,
|
|
314
|
+
"properties": {
|
|
315
|
+
"mode": {
|
|
316
|
+
"type": "string",
|
|
317
|
+
"enum": [
|
|
318
|
+
"auto",
|
|
319
|
+
"assist"
|
|
320
|
+
],
|
|
321
|
+
"description": "Default operating mode for 'adr accept --auto'. 'assist' (default) reports eligibility without mutating the file; 'auto' immediately accepts and rewrites the ADR when all gates pass. Overridden by --auto-mode on the command line.",
|
|
322
|
+
"default": "assist"
|
|
323
|
+
},
|
|
324
|
+
"quality_threshold": {
|
|
325
|
+
"type": "number",
|
|
326
|
+
"minimum": 0,
|
|
327
|
+
"maximum": 1,
|
|
328
|
+
"description": "Minimum quality score (0.0\u20131.0) required before auto-accept proceeds. Overridden by --quality-threshold on the command line. Default 0.70.",
|
|
329
|
+
"default": 0.7
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
}
|
|
334
|
+
},
|
|
335
|
+
"guardian": {
|
|
336
|
+
"type": "object",
|
|
337
|
+
"description": "Configuration for the ADR Guardian (bin/adr-guardian + /adr-kit:guardian skill), introduced in adr-kit v0.18.0. The guardian is a periodic ADR-set health detector that injects a staleness nudge at Claude Code SessionStart when a health tier is due. Detection is free (no LLM) and default-on. The LLM tier (adr-suggest + audit) always asks before spending unless llm_autorun is explicitly set true.",
|
|
338
|
+
"additionalProperties": false,
|
|
339
|
+
"properties": {
|
|
340
|
+
"enabled": {
|
|
341
|
+
"type": "boolean",
|
|
342
|
+
"description": "When false, the guardian detector is disabled entirely and no nudge is ever emitted. Default true. The guardian's detection (cheap tier) is free; disabling it only makes sense for projects that run a CI-based sweep instead.",
|
|
343
|
+
"default": true
|
|
344
|
+
},
|
|
345
|
+
"drift_stale_days": {
|
|
346
|
+
"type": "number",
|
|
347
|
+
"description": "Number of days after which the cheap tier (drift + retire + lint) is considered stale and triggers a nudge. Default 1 (daily). Fractional values are accepted (e.g. 0.5 for a 12-hour cadence).",
|
|
348
|
+
"minimum": 0,
|
|
349
|
+
"default": 1
|
|
350
|
+
},
|
|
351
|
+
"llm_stale_days": {
|
|
352
|
+
"type": "number",
|
|
353
|
+
"description": "Number of days after which the LLM tier (adr-suggest missing-ADR detection + full audit) is considered stale and triggers a nudge. Default 14 (bi-weekly). The LLM tier costs money; keep this at 14 or higher to avoid frequent spend.",
|
|
354
|
+
"minimum": 0,
|
|
355
|
+
"default": 14
|
|
356
|
+
},
|
|
357
|
+
"nudge_cooldown_hours": {
|
|
358
|
+
"type": "number",
|
|
359
|
+
"description": "Minimum hours between successive nudges at SessionStart. Prevents repeated nags within a single work day when sessions are opened frequently. Default 24 (once per day at most).",
|
|
360
|
+
"minimum": 0,
|
|
361
|
+
"default": 24
|
|
362
|
+
},
|
|
363
|
+
"llm_autorun": {
|
|
364
|
+
"type": "boolean",
|
|
365
|
+
"description": "When false (default), the /adr-kit:guardian skill always asks the user to confirm cost before running the LLM tier (adr-suggest + full audit). Set true only if you want the LLM tier to run without an interactive confirmation \u2014 consistent with ADR-001's opt-in posture, this defaults to false. The cheap tier (drift + retire + lint) is always free and unaffected by this flag.",
|
|
366
|
+
"default": false
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
}
|
|
371
|
+
}
|