@rvdbreemen/adr-kit-opencode 0.52.0 → 0.53.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 (83) hide show
  1. package/.claude-plugin/plugin.json +29 -29
  2. package/README.md +865 -850
  3. package/bin/adr +0 -0
  4. package/bin/adr-audit +0 -0
  5. package/bin/adr-context +0 -0
  6. package/bin/adr-discover +0 -0
  7. package/bin/adr-doctor +0 -0
  8. package/bin/adr-generate-scripts +0 -0
  9. package/bin/adr-grill-signal +0 -0
  10. package/bin/adr-guardian +0 -0
  11. package/bin/adr-index +0 -0
  12. package/bin/adr-judge +0 -0
  13. package/bin/adr-judge-precommit +0 -0
  14. package/bin/adr-lint +0 -0
  15. package/bin/adr-mcp +96 -4
  16. package/bin/adr-migrate +0 -0
  17. package/bin/adr-quality +0 -0
  18. package/bin/adr-readiness +0 -0
  19. package/bin/adr-readiness-ci +0 -0
  20. package/bin/adr-related +0 -0
  21. package/bin/adr-renumber +254 -254
  22. package/bin/adr-retire +0 -0
  23. package/bin/adr-settings +0 -0
  24. package/bin/adr-status +0 -0
  25. package/bin/adr-suggest +0 -0
  26. package/bin/adr-watch +0 -0
  27. package/bin/adr_doctor_probes.py +2 -0
  28. package/bin/bump-version +0 -0
  29. package/clients/workflows.json +229 -229
  30. package/hooks/__init__.py +1 -1
  31. package/hooks/adapters/__init__.py +13 -13
  32. package/hooks/adapters/claude.py +27 -27
  33. package/hooks/adapters/codex.py +26 -26
  34. package/hooks/adapters/copilot.py +11 -11
  35. package/hooks/adr-hook.py +128 -128
  36. package/hooks/adr_hook_core.py +843 -843
  37. package/hooks/adr_pr_guard.py +367 -367
  38. package/instructions/ADR-guide.md +101 -48
  39. package/instructions/adr.coding.md +82 -82
  40. package/instructions/adr.review.md +182 -182
  41. package/opencode/plugin.ts +1 -4
  42. package/package.json +5 -2
  43. package/schemas/adr-context-probes.schema.json +56 -56
  44. package/schemas/adr-enforcement.schema.json +57 -57
  45. package/schemas/adr-frontmatter.schema.json +144 -144
  46. package/schemas/adr-index.schema.json +276 -276
  47. package/schemas/adr-kit-config.schema.json +371 -371
  48. package/schemas/adr-readiness.schema.json +41 -41
  49. package/schemas/client-capabilities.schema.json +503 -503
  50. package/schemas/client-certification.schema.json +101 -101
  51. package/schemas/doctor-output.schema.json +92 -92
  52. package/skills/adr/SKILL.md +780 -780
  53. package/skills/audit/SKILL.md +103 -103
  54. package/skills/context/SKILL.md +77 -77
  55. package/skills/grill/SKILL.md +84 -84
  56. package/skills/grill/agents/openai.yaml +4 -4
  57. package/skills/guardian/SKILL.md +316 -316
  58. package/skills/init/SKILL.md +499 -499
  59. package/skills/install-hooks/SKILL.md +154 -154
  60. package/skills/judge/SKILL.md +168 -168
  61. package/skills/lint/SKILL.md +321 -321
  62. package/skills/migrate/SKILL.md +313 -313
  63. package/skills/related/SKILL.md +62 -62
  64. package/skills/retire/SKILL.md +41 -41
  65. package/skills/review/SKILL.md +167 -167
  66. package/skills/settings/SKILL.md +73 -73
  67. package/skills/setup/SKILL.md +128 -128
  68. package/skills/supersede/SKILL.md +136 -136
  69. package/skills/upgrade/SKILL.md +273 -273
  70. package/templates/adr-kit-guide.md +354 -354
  71. package/templates/adr-template.canonical.md +115 -115
  72. package/templates/adr-template.madr.md +131 -131
  73. package/templates/adr-template.md +131 -131
  74. package/templates/adr-template.nygard.md +111 -111
  75. package/templates/cc-settings/guardian-hook-entry.json +9 -9
  76. package/templates/githooks/pre-commit +1 -1
  77. package/templates/github-workflows/adr-audit.yml +58 -58
  78. package/templates/github-workflows/adr-guardian-audit.yml +133 -133
  79. package/templates/github-workflows/adr-index-check.yml +30 -30
  80. package/templates/github-workflows/adr-judge.yml +31 -31
  81. package/templates/github-workflows/adr-readiness.yml +18 -18
  82. package/templates/validate_adr_template.py +38 -38
  83. package/templates/validate_adr_template.sh +74 -74
@@ -1,115 +1,115 @@
1
- ---
2
- id: "ADR-NNN"
3
- title: "Short Imperative Title"
4
- status: "Proposed"
5
- date: "YYYY-MM-DD"
6
- binding: false
7
- gate: null
8
- documents_shipped: false
9
- verified_in: []
10
- supersedes: []
11
- superseded_by: null
12
- format: "canonical"
13
- topics: []
14
- aliases: []
15
- components: []
16
- symbols: []
17
- context_scope: "selective"
18
- ---
19
-
20
- <!-- markdownlint-disable MD025 -->
21
-
22
- # ADR-NNN Short Imperative Title
23
-
24
- ## Status
25
-
26
- Proposed, YYYY-MM-DD.
27
-
28
- ## Status History
29
-
30
- ```yaml
31
- status_history:
32
- - date: YYYY-MM-DD
33
- status: Proposed
34
- changed_by: user@example.com
35
- reason: Initial proposal
36
- changed_via: adr-kit
37
- ```
38
-
39
- ## Context
40
-
41
- State the problem, constraints, and concrete evidence.
42
-
43
- ## Decision
44
-
45
- State one concrete chosen approach and its rationale.
46
-
47
- ## Decision Contract
48
-
49
- ### Must
50
-
51
- - State required implementation constraints.
52
-
53
- ### Must Not
54
-
55
- - State prohibited implementation choices.
56
-
57
- ### Exceptions
58
-
59
- - State explicit exceptions, or `None`.
60
-
61
- ### Verification
62
-
63
- - Name the test, command, or source anchor that verifies this decision.
64
-
65
- ## Alternatives Considered
66
-
67
- - **Alternative A.** Rejection reason.
68
- - **Alternative B.** Rejection reason.
69
-
70
- ## Consequences
71
-
72
- **Positive:**
73
-
74
- - Expected benefit.
75
-
76
- **Negative:**
77
-
78
- - Accepted cost or risk and its mitigation.
79
-
80
- ## Open Questions
81
-
82
- List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
83
- unresolved items.
84
-
85
- Answer them with `bin/adr answer`, which rewrites an item as
86
- `- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
87
- is resolved, so it no longer blocks acceptance and stays in the record. Do not
88
- delete an answered question: the reasoning is what a future reader needs in
89
- order to re-evaluate the decision.
90
-
91
- ## Related Decisions
92
-
93
- - None.
94
-
95
- ## References
96
-
97
- - Add at least one verifiable local or external reference.
98
-
99
- ## Enforcement
100
-
101
- Delete this optional section when the decision has no machine-checkable surface.
102
-
103
- ```json
104
- {
105
- "forbid_pattern": [
106
- {
107
- "pattern": "\\bForbiddenSymbol\\b",
108
- "path_glob": "src/**/*.py",
109
- "message": "Use AllowedSymbol instead."
110
- }
111
- ],
112
- "forbid_import": [],
113
- "require_pattern": []
114
- }
115
- ```
1
+ ---
2
+ id: "ADR-NNN"
3
+ title: "Short Imperative Title"
4
+ status: "Proposed"
5
+ date: "YYYY-MM-DD"
6
+ binding: false
7
+ gate: null
8
+ documents_shipped: false
9
+ verified_in: []
10
+ supersedes: []
11
+ superseded_by: null
12
+ format: "canonical"
13
+ topics: []
14
+ aliases: []
15
+ components: []
16
+ symbols: []
17
+ context_scope: "selective"
18
+ ---
19
+
20
+ <!-- markdownlint-disable MD025 -->
21
+
22
+ # ADR-NNN Short Imperative Title
23
+
24
+ ## Status
25
+
26
+ Proposed, YYYY-MM-DD.
27
+
28
+ ## Status History
29
+
30
+ ```yaml
31
+ status_history:
32
+ - date: YYYY-MM-DD
33
+ status: Proposed
34
+ changed_by: user@example.com
35
+ reason: Initial proposal
36
+ changed_via: adr-kit
37
+ ```
38
+
39
+ ## Context
40
+
41
+ State the problem, constraints, and concrete evidence.
42
+
43
+ ## Decision
44
+
45
+ State one concrete chosen approach and its rationale.
46
+
47
+ ## Decision Contract
48
+
49
+ ### Must
50
+
51
+ - State required implementation constraints.
52
+
53
+ ### Must Not
54
+
55
+ - State prohibited implementation choices.
56
+
57
+ ### Exceptions
58
+
59
+ - State explicit exceptions, or `None`.
60
+
61
+ ### Verification
62
+
63
+ - Name the test, command, or source anchor that verifies this decision.
64
+
65
+ ## Alternatives Considered
66
+
67
+ - **Alternative A.** Rejection reason.
68
+ - **Alternative B.** Rejection reason.
69
+
70
+ ## Consequences
71
+
72
+ **Positive:**
73
+
74
+ - Expected benefit.
75
+
76
+ **Negative:**
77
+
78
+ - Accepted cost or risk and its mitigation.
79
+
80
+ ## Open Questions
81
+
82
+ List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
83
+ unresolved items.
84
+
85
+ Answer them with `bin/adr answer`, which rewrites an item as
86
+ `- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
87
+ is resolved, so it no longer blocks acceptance and stays in the record. Do not
88
+ delete an answered question: the reasoning is what a future reader needs in
89
+ order to re-evaluate the decision.
90
+
91
+ ## Related Decisions
92
+
93
+ - None.
94
+
95
+ ## References
96
+
97
+ - Add at least one verifiable local or external reference.
98
+
99
+ ## Enforcement
100
+
101
+ Delete this optional section when the decision has no machine-checkable surface.
102
+
103
+ ```json
104
+ {
105
+ "forbid_pattern": [
106
+ {
107
+ "pattern": "\\bForbiddenSymbol\\b",
108
+ "path_glob": "src/**/*.py",
109
+ "message": "Use AllowedSymbol instead."
110
+ }
111
+ ],
112
+ "forbid_import": [],
113
+ "require_pattern": []
114
+ }
115
+ ```
@@ -1,131 +1,131 @@
1
- ---
2
- id: "ADR-NNN"
3
- title: "Short Imperative Title"
4
- status: "Proposed"
5
- date: "YYYY-MM-DD"
6
- binding: false
7
- gate: null
8
- documents_shipped: false
9
- verified_in: []
10
- supersedes: []
11
- superseded_by: null
12
- format: "madr"
13
- topics: []
14
- aliases: []
15
- components: []
16
- symbols: []
17
- context_scope: "selective"
18
- ---
19
-
20
- <!-- markdownlint-disable MD025 -->
21
-
22
- # ADR-NNN Short Imperative Title
23
-
24
- ## Status
25
-
26
- Proposed, YYYY-MM-DD.
27
-
28
- ## Status History
29
-
30
- ```yaml
31
- status_history:
32
- - date: YYYY-MM-DD
33
- status: Proposed
34
- changed_by: user@example.com
35
- reason: Initial proposal
36
- changed_via: adr-kit
37
- ```
38
-
39
- ## Context and Problem Statement
40
-
41
- State the problem, constraints, and concrete evidence.
42
-
43
- ## Decision Drivers
44
-
45
- * Driver one.
46
- * Driver two.
47
-
48
- ## Considered Options
49
-
50
- * Option A.
51
- * Option B.
52
- * Do nothing, when it is a realistic option.
53
-
54
- ## Decision Outcome
55
-
56
- Chosen option: **Option A**, because state the decisive rationale.
57
-
58
- ### Confirmation
59
-
60
- State how implementation of the decision will be verified.
61
-
62
- ## Decision Contract
63
-
64
- ### Must
65
-
66
- * State required implementation constraints.
67
-
68
- ### Must Not
69
-
70
- * State prohibited implementation choices.
71
-
72
- ### Exceptions
73
-
74
- * State explicit exceptions, or `None`.
75
-
76
- ### Verification
77
-
78
- * Name the test, command, or source anchor that verifies this decision.
79
-
80
- ## Consequences
81
-
82
- ### Positive
83
-
84
- * Expected benefit.
85
-
86
- ### Negative
87
-
88
- * Accepted cost or risk and its mitigation.
89
-
90
- ## Pros and Cons of the Options
91
-
92
- ### Option A
93
-
94
- * Good, because ...
95
- * Bad, because ...
96
-
97
- ### Option B
98
-
99
- * Good, because ...
100
- * Bad, because ...
101
-
102
- ## Open Questions
103
-
104
- List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
105
- unresolved items.
106
-
107
- Answer them with `bin/adr answer`, which rewrites an item as
108
- `- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
109
- is resolved, so it no longer blocks acceptance and stays in the record. Do not
110
- delete an answered question: the reasoning is what a future reader needs in
111
- order to re-evaluate the decision.
112
-
113
- ## Related Decisions
114
-
115
- * None.
116
-
117
- ## References
118
-
119
- * Add at least one verifiable local or external reference.
120
-
121
- ## Enforcement
122
-
123
- Delete this optional section when the decision has no machine-checkable surface.
124
-
125
- ```json
126
- {
127
- "forbid_pattern": [],
128
- "forbid_import": [],
129
- "require_pattern": []
130
- }
131
- ```
1
+ ---
2
+ id: "ADR-NNN"
3
+ title: "Short Imperative Title"
4
+ status: "Proposed"
5
+ date: "YYYY-MM-DD"
6
+ binding: false
7
+ gate: null
8
+ documents_shipped: false
9
+ verified_in: []
10
+ supersedes: []
11
+ superseded_by: null
12
+ format: "madr"
13
+ topics: []
14
+ aliases: []
15
+ components: []
16
+ symbols: []
17
+ context_scope: "selective"
18
+ ---
19
+
20
+ <!-- markdownlint-disable MD025 -->
21
+
22
+ # ADR-NNN Short Imperative Title
23
+
24
+ ## Status
25
+
26
+ Proposed, YYYY-MM-DD.
27
+
28
+ ## Status History
29
+
30
+ ```yaml
31
+ status_history:
32
+ - date: YYYY-MM-DD
33
+ status: Proposed
34
+ changed_by: user@example.com
35
+ reason: Initial proposal
36
+ changed_via: adr-kit
37
+ ```
38
+
39
+ ## Context and Problem Statement
40
+
41
+ State the problem, constraints, and concrete evidence.
42
+
43
+ ## Decision Drivers
44
+
45
+ * Driver one.
46
+ * Driver two.
47
+
48
+ ## Considered Options
49
+
50
+ * Option A.
51
+ * Option B.
52
+ * Do nothing, when it is a realistic option.
53
+
54
+ ## Decision Outcome
55
+
56
+ Chosen option: **Option A**, because state the decisive rationale.
57
+
58
+ ### Confirmation
59
+
60
+ State how implementation of the decision will be verified.
61
+
62
+ ## Decision Contract
63
+
64
+ ### Must
65
+
66
+ * State required implementation constraints.
67
+
68
+ ### Must Not
69
+
70
+ * State prohibited implementation choices.
71
+
72
+ ### Exceptions
73
+
74
+ * State explicit exceptions, or `None`.
75
+
76
+ ### Verification
77
+
78
+ * Name the test, command, or source anchor that verifies this decision.
79
+
80
+ ## Consequences
81
+
82
+ ### Positive
83
+
84
+ * Expected benefit.
85
+
86
+ ### Negative
87
+
88
+ * Accepted cost or risk and its mitigation.
89
+
90
+ ## Pros and Cons of the Options
91
+
92
+ ### Option A
93
+
94
+ * Good, because ...
95
+ * Bad, because ...
96
+
97
+ ### Option B
98
+
99
+ * Good, because ...
100
+ * Bad, because ...
101
+
102
+ ## Open Questions
103
+
104
+ List unresolved human decisions as unchecked tasks. Accepted ADRs must have no
105
+ unresolved items.
106
+
107
+ Answer them with `bin/adr answer`, which rewrites an item as
108
+ `- [x] <question> — **Answered <date> by <signer>:** <answer>`. A checked item
109
+ is resolved, so it no longer blocks acceptance and stays in the record. Do not
110
+ delete an answered question: the reasoning is what a future reader needs in
111
+ order to re-evaluate the decision.
112
+
113
+ ## Related Decisions
114
+
115
+ * None.
116
+
117
+ ## References
118
+
119
+ * Add at least one verifiable local or external reference.
120
+
121
+ ## Enforcement
122
+
123
+ Delete this optional section when the decision has no machine-checkable surface.
124
+
125
+ ```json
126
+ {
127
+ "forbid_pattern": [],
128
+ "forbid_import": [],
129
+ "require_pattern": []
130
+ }
131
+ ```