@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
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
File without changes
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
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 5 tools, each a subprocess call into a sibling bin/ script:
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 five deterministic, key-free tools (adr_context, adr_judge, "
116
- "adr_status, adr_quality, adr_readiness). Every tool accepts optional "
117
- "project_root and adr_dir arguments to select the active workspace."
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
File without changes
package/bin/adr-related CHANGED
File without changes