@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.
- package/.claude-plugin/plugin.json +29 -29
- package/README.md +865 -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 +96 -4
- 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/adr_doctor_probes.py +2 -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 +101 -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
package/bin/adr
CHANGED
|
File without changes
|
package/bin/adr-audit
CHANGED
|
File without changes
|
package/bin/adr-context
CHANGED
|
File without changes
|
package/bin/adr-discover
CHANGED
|
File without changes
|
package/bin/adr-doctor
CHANGED
|
File without changes
|
package/bin/adr-generate-scripts
CHANGED
|
File without changes
|
package/bin/adr-grill-signal
CHANGED
|
File without changes
|
package/bin/adr-guardian
CHANGED
|
File without changes
|
package/bin/adr-index
CHANGED
|
File without changes
|
package/bin/adr-judge
CHANGED
|
File without changes
|
package/bin/adr-judge-precommit
CHANGED
|
File without changes
|
package/bin/adr-lint
CHANGED
|
File without changes
|
package/bin/adr-mcp
CHANGED
|
@@ -26,7 +26,7 @@ the same answer. That is deliberate - the spec forbids relying on prior
|
|
|
26
26
|
requests over the same connection to establish context. See ADR-016 and
|
|
27
27
|
docs/research/2026-07-29-mcp-2026-07-28-revision.md.
|
|
28
28
|
|
|
29
|
-
Exposes exactly
|
|
29
|
+
Exposes exactly 7 tools, each a subprocess call into a sibling bin/ script:
|
|
30
30
|
|
|
31
31
|
adr_context {query, limit?, paths?, components?, symbols?, topics?,
|
|
32
32
|
statuses?, authorities?, include_history?, strict_index?}
|
|
@@ -37,6 +37,12 @@ Exposes exactly 5 tools, each a subprocess call into a sibling bin/ script:
|
|
|
37
37
|
adr_quality {adr_id?} -> bin/adr-quality --format json per ADR
|
|
38
38
|
adr_readiness {adr_id?, all_proposed?, base?, head?, today?}
|
|
39
39
|
-> bin/adr-readiness --format json
|
|
40
|
+
adr_lint {strict?} -> bin/adr-lint --format json
|
|
41
|
+
adr_related {adr_id} -> bin/adr-related --format json
|
|
42
|
+
|
|
43
|
+
Admission is governed by ADR-040: a CLI joins this surface only when it is
|
|
44
|
+
read-only, deterministic and key-free, agent-query-shaped, and covers an
|
|
45
|
+
agent-guide cycle step no exposed tool already covers.
|
|
40
46
|
|
|
41
47
|
adr-suggest is intentionally NOT exposed: it is an LLM-only advisory (its
|
|
42
48
|
deterministic part is just a docs-only skip filter), and this server stays
|
|
@@ -112,9 +118,10 @@ MODERN_CACHE_SCOPE = "public"
|
|
|
112
118
|
|
|
113
119
|
MODERN_INSTRUCTIONS = (
|
|
114
120
|
"adr-kit: read-only Architecture Decision Record tooling. Call tools/list "
|
|
115
|
-
"for the
|
|
116
|
-
"adr_status, adr_quality, adr_readiness). Every
|
|
117
|
-
"project_root and adr_dir arguments to select the
|
|
121
|
+
"for the seven deterministic, key-free tools (adr_context, adr_judge, "
|
|
122
|
+
"adr_status, adr_quality, adr_readiness, adr_lint, adr_related). Every "
|
|
123
|
+
"tool accepts optional project_root and adr_dir arguments to select the "
|
|
124
|
+
"active workspace."
|
|
118
125
|
)
|
|
119
126
|
|
|
120
127
|
# Per-tool subprocess timeout. The wrapped CLIs are regex-only and fast;
|
|
@@ -331,6 +338,46 @@ TOOL_DEFINITIONS: List[Dict[str, Any]] = [
|
|
|
331
338
|
},
|
|
332
339
|
},
|
|
333
340
|
},
|
|
341
|
+
{
|
|
342
|
+
"name": "adr_lint",
|
|
343
|
+
"description": (
|
|
344
|
+
"Lint the ADR set against the deterministic verification gates. "
|
|
345
|
+
"Read-only, key-free. Returns the adr-lint JSON report and exit "
|
|
346
|
+
"status (0 = clean, 1 = failing findings)."
|
|
347
|
+
),
|
|
348
|
+
"inputSchema": {
|
|
349
|
+
"type": "object",
|
|
350
|
+
"properties": {
|
|
351
|
+
"strict": {
|
|
352
|
+
"type": "boolean",
|
|
353
|
+
"description": (
|
|
354
|
+
"CI governance mode: enable the schema gate and make "
|
|
355
|
+
"findings FAIL. False by default."
|
|
356
|
+
),
|
|
357
|
+
},
|
|
358
|
+
**WORKSPACE_PROPERTIES,
|
|
359
|
+
},
|
|
360
|
+
},
|
|
361
|
+
},
|
|
362
|
+
{
|
|
363
|
+
"name": "adr_related",
|
|
364
|
+
"description": (
|
|
365
|
+
"Show the dependency graph (inbound + outbound edges) for one "
|
|
366
|
+
"ADR: related decisions, supersession links, mentions, and "
|
|
367
|
+
"dangling references. Read-only, deterministic. Returns JSON."
|
|
368
|
+
),
|
|
369
|
+
"inputSchema": {
|
|
370
|
+
"type": "object",
|
|
371
|
+
"properties": {
|
|
372
|
+
"adr_id": {
|
|
373
|
+
"type": "string",
|
|
374
|
+
"description": "ADR identifier such as 'ADR-007', 'adr-7' or '7'.",
|
|
375
|
+
},
|
|
376
|
+
**WORKSPACE_PROPERTIES,
|
|
377
|
+
},
|
|
378
|
+
"required": ["adr_id"],
|
|
379
|
+
},
|
|
380
|
+
},
|
|
334
381
|
]
|
|
335
382
|
|
|
336
383
|
|
|
@@ -678,12 +725,57 @@ def tool_adr_readiness(
|
|
|
678
725
|
return _text_result(_parse_json_or_raw(out))
|
|
679
726
|
|
|
680
727
|
|
|
728
|
+
def tool_adr_lint(arguments: Dict[str, Any], root: Path, adr_dir: Path) -> Dict[str, Any]:
|
|
729
|
+
try:
|
|
730
|
+
root, adr_dir = _call_paths(arguments, root, adr_dir)
|
|
731
|
+
except ValueError as exc:
|
|
732
|
+
return _text_result(f"adr_lint: {exc}", is_error=True)
|
|
733
|
+
strict = arguments.get("strict", False)
|
|
734
|
+
if not isinstance(strict, bool):
|
|
735
|
+
return _text_result("adr_lint: 'strict' must be a boolean", is_error=True)
|
|
736
|
+
args = ["--format", "json", "--repo-root", str(root)]
|
|
737
|
+
if strict:
|
|
738
|
+
args.append("--strict")
|
|
739
|
+
args.append(str(adr_dir))
|
|
740
|
+
rc, out, err = run_cli("adr-lint", args, root)
|
|
741
|
+
if rc == 2:
|
|
742
|
+
return _text_result(
|
|
743
|
+
f"adr-lint exited 2 (config/input error): {err.strip() or out.strip()}",
|
|
744
|
+
is_error=True,
|
|
745
|
+
)
|
|
746
|
+
# rc 0 (clean) and rc 1 (failing findings) are both valid lint outcomes.
|
|
747
|
+
payload = {"exit_code": rc, "verdict": "findings" if rc == 1 else "ok",
|
|
748
|
+
"result": _parse_json_or_raw(out)}
|
|
749
|
+
return _text_result(payload)
|
|
750
|
+
|
|
751
|
+
|
|
752
|
+
def tool_adr_related(arguments: Dict[str, Any], root: Path, adr_dir: Path) -> Dict[str, Any]:
|
|
753
|
+
try:
|
|
754
|
+
root, adr_dir = _call_paths(arguments, root, adr_dir)
|
|
755
|
+
except ValueError as exc:
|
|
756
|
+
return _text_result(f"adr_related: {exc}", is_error=True)
|
|
757
|
+
adr_id = arguments.get("adr_id")
|
|
758
|
+
if not isinstance(adr_id, str) or not adr_id.strip():
|
|
759
|
+
return _text_result(
|
|
760
|
+
"adr_related: 'adr_id' must be a non-empty string", is_error=True
|
|
761
|
+
)
|
|
762
|
+
args = ["--format", "json", "--adr-dir", str(adr_dir), adr_id]
|
|
763
|
+
rc, out, err = run_cli("adr-related", args, root)
|
|
764
|
+
if rc != 0:
|
|
765
|
+
return _text_result(
|
|
766
|
+
f"adr-related exited {rc}: {err.strip() or out.strip()}", is_error=True
|
|
767
|
+
)
|
|
768
|
+
return _text_result(_parse_json_or_raw(out))
|
|
769
|
+
|
|
770
|
+
|
|
681
771
|
TOOL_HANDLERS = {
|
|
682
772
|
"adr_context": tool_adr_context,
|
|
683
773
|
"adr_judge": tool_adr_judge,
|
|
684
774
|
"adr_status": tool_adr_status,
|
|
685
775
|
"adr_quality": tool_adr_quality,
|
|
686
776
|
"adr_readiness": tool_adr_readiness,
|
|
777
|
+
"adr_lint": tool_adr_lint,
|
|
778
|
+
"adr_related": tool_adr_related,
|
|
687
779
|
}
|
|
688
780
|
|
|
689
781
|
|
package/bin/adr-migrate
CHANGED
|
File without changes
|
package/bin/adr-quality
CHANGED
|
File without changes
|
package/bin/adr-readiness
CHANGED
|
File without changes
|
package/bin/adr-readiness-ci
CHANGED
|
File without changes
|
package/bin/adr-related
CHANGED
|
File without changes
|