claude-dev-env 1.37.1 → 1.38.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 (92) hide show
  1. package/CLAUDE.md +3 -0
  2. package/_shared/pr-loop/audit-contract.md +4 -3
  3. package/_shared/pr-loop/fix-protocol.md +2 -0
  4. package/_shared/pr-loop/gh-payloads.md +38 -37
  5. package/_shared/pr-loop/scripts/README.md +0 -1
  6. package/_shared/pr-loop/scripts/preflight.py +2 -1
  7. package/_shared/pr-loop/scripts/tests/test_code_rules_gate.py +2 -2
  8. package/_shared/pr-loop/scripts/tests/test_preflight.py +22 -0
  9. package/_shared/pr-loop/state-schema.md +10 -10
  10. package/agents/clean-coder.md +4 -0
  11. package/agents/code-quality-agent.md +23 -85
  12. package/agents/groq-coder.md +8 -6
  13. package/hooks/blocking/__init__.py +0 -0
  14. package/hooks/blocking/hedging_language_blocker.py +2 -2
  15. package/hooks/blocking/state_description_blocker.py +243 -0
  16. package/hooks/blocking/tdd_enforcer.py +94 -0
  17. package/hooks/blocking/test_hedging_language_blocker.py +1 -1
  18. package/hooks/blocking/test_state_description_blocker.py +618 -0
  19. package/hooks/blocking/test_tdd_enforcer.py +152 -0
  20. package/hooks/config/state_description_blocker_constants.py +130 -0
  21. package/hooks/hooks.json +10 -0
  22. package/package.json +1 -1
  23. package/rules/no-historical-clutter.md +31 -10
  24. package/scripts/config/groq_bugteam_config.py +13 -5
  25. package/skills/bugteam/CONSTRAINTS.md +20 -27
  26. package/skills/bugteam/EXAMPLES.md +1 -1
  27. package/skills/bugteam/PROMPTS.md +60 -31
  28. package/skills/bugteam/SKILL.md +47 -47
  29. package/skills/bugteam/SKILL_EVALS.md +8 -8
  30. package/skills/bugteam/reference/github-pr-reviews.md +31 -31
  31. package/skills/bugteam/reference/team-setup.md +1 -1
  32. package/skills/bugteam/reference/teardown-publish-permissions.md +4 -4
  33. package/skills/copilot-review/SKILL.md +7 -14
  34. package/skills/findbugs/SKILL.md +2 -2
  35. package/skills/fixbugs/SKILL.md +1 -1
  36. package/skills/monitor-open-prs/SKILL.md +6 -6
  37. package/skills/pr-converge/SKILL.md +7 -6
  38. package/skills/pr-converge/reference/convergence-gates.md +28 -30
  39. package/skills/pr-converge/reference/examples.md +4 -4
  40. package/skills/pr-converge/reference/fix-protocol.md +6 -8
  41. package/skills/pr-converge/reference/multi-pr-orchestration.md +10 -10
  42. package/skills/pr-converge/reference/per-tick.md +18 -33
  43. package/skills/pr-converge/reference/stop-conditions.md +7 -7
  44. package/skills/pr-converge/scripts/README.md +65 -117
  45. package/skills/pr-review-responder/EXAMPLES.md +2 -2
  46. package/skills/pr-review-responder/PRINCIPLES.md +2 -8
  47. package/skills/pr-review-responder/README.md +7 -48
  48. package/skills/pr-review-responder/SKILL.md +2 -3
  49. package/skills/pr-review-responder/TESTING.md +8 -65
  50. package/skills/qbug/SKILL.md +10 -16
  51. package/_shared/pr-loop/scripts/config/gh_util_constants.py +0 -31
  52. package/_shared/pr-loop/scripts/gh_util.py +0 -193
  53. package/_shared/pr-loop/scripts/tests/test_gh_util.py +0 -257
  54. package/_shared/pr-loop/scripts/tests/test_gh_util_constants.py +0 -61
  55. package/skills/pr-converge/scripts/check_pr_mergeability.py +0 -78
  56. package/skills/pr-converge/scripts/config/pr_converge_constants.py +0 -134
  57. package/skills/pr-converge/scripts/config/test_pr_converge_constants.py +0 -152
  58. package/skills/pr-converge/scripts/fetch_bugbot_inline_comments.py +0 -70
  59. package/skills/pr-converge/scripts/fetch_bugbot_reviews.py +0 -57
  60. package/skills/pr-converge/scripts/fetch_claude_inline_comments.py +0 -70
  61. package/skills/pr-converge/scripts/fetch_claude_reviews.py +0 -61
  62. package/skills/pr-converge/scripts/fetch_copilot_inline_comments.py +0 -70
  63. package/skills/pr-converge/scripts/fetch_copilot_reviews.py +0 -61
  64. package/skills/pr-converge/scripts/mark_pr_ready.py +0 -54
  65. package/skills/pr-converge/scripts/post-bugbot-run.helpers.ps1 +0 -49
  66. package/skills/pr-converge/scripts/post-bugbot-run.ps1 +0 -33
  67. package/skills/pr-converge/scripts/reply_to_inline_comment.py +0 -84
  68. package/skills/pr-converge/scripts/request_copilot_review.py +0 -71
  69. package/skills/pr-converge/scripts/resolve_pr_head.py +0 -58
  70. package/skills/pr-converge/scripts/review_field_helpers.py +0 -43
  71. package/skills/pr-converge/scripts/reviewer_fetch_core.py +0 -153
  72. package/skills/pr-converge/scripts/reviewer_specs.py +0 -98
  73. package/skills/pr-converge/scripts/test_check_pr_mergeability.py +0 -126
  74. package/skills/pr-converge/scripts/test_fetch_bugbot_inline_comments.py +0 -443
  75. package/skills/pr-converge/scripts/test_fetch_bugbot_reviews.py +0 -299
  76. package/skills/pr-converge/scripts/test_fetch_claude_inline_comments.py +0 -485
  77. package/skills/pr-converge/scripts/test_fetch_claude_reviews.py +0 -368
  78. package/skills/pr-converge/scripts/test_fetch_copilot_inline_comments.py +0 -440
  79. package/skills/pr-converge/scripts/test_fetch_copilot_reviews.py +0 -366
  80. package/skills/pr-converge/scripts/test_mark_pr_ready.py +0 -69
  81. package/skills/pr-converge/scripts/test_post_bugbot_run.py +0 -195
  82. package/skills/pr-converge/scripts/test_reply_to_inline_comment.py +0 -159
  83. package/skills/pr-converge/scripts/test_request_copilot_review.py +0 -101
  84. package/skills/pr-converge/scripts/test_resolve_pr_head.py +0 -79
  85. package/skills/pr-converge/scripts/test_review_field_helpers.py +0 -80
  86. package/skills/pr-converge/scripts/test_reviewer_fetch_core.py +0 -448
  87. package/skills/pr-converge/scripts/test_reviewer_specs.py +0 -107
  88. package/skills/pr-converge/scripts/test_trigger_bugbot.py +0 -139
  89. package/skills/pr-converge/scripts/test_view_pr_context.py +0 -155
  90. package/skills/pr-converge/scripts/trigger_bugbot.py +0 -77
  91. package/skills/pr-converge/scripts/view_pr_context.py +0 -78
  92. package/skills/pr-review-responder/scripts/respond_to_reviews.py +0 -376
@@ -1,159 +0,0 @@
1
- """Tests for reply_to_inline_comment.
2
-
3
- Covers:
4
- - gh api -X POST is invoked against the inline-comments replies endpoint
5
- - the reply body comes from a file via gh's `body=@<path>` form (per gh-body-file rule)
6
- - the reply id from gh's JSON output is returned
7
- - subprocess errors propagate
8
- """
9
-
10
- from __future__ import annotations
11
-
12
- import importlib.util
13
- import json
14
- import subprocess
15
- from pathlib import Path
16
- from types import ModuleType
17
- from unittest.mock import MagicMock, patch
18
-
19
- import pytest
20
-
21
-
22
- def _load_module() -> ModuleType:
23
- module_path = Path(__file__).parent / "reply_to_inline_comment.py"
24
- spec = importlib.util.spec_from_file_location(
25
- "reply_to_inline_comment", module_path
26
- )
27
- assert spec is not None
28
- assert spec.loader is not None
29
- module = importlib.util.module_from_spec(spec)
30
- spec.loader.exec_module(module)
31
- return module
32
-
33
-
34
- reply_to_inline_comment_module = _load_module()
35
-
36
-
37
- def _completed(stdout: str) -> subprocess.CompletedProcess:
38
- process = MagicMock(spec=subprocess.CompletedProcess)
39
- process.stdout = stdout
40
- process.returncode = 0
41
- return process
42
-
43
-
44
- def test_should_invoke_gh_api_post_against_replies_endpoint(tmp_path: Path) -> None:
45
- body_file = tmp_path / "reply.md"
46
- body_file.write_text("Confirmed and fixed.\n", encoding="utf-8")
47
- with patch("subprocess.run") as mock_run:
48
- mock_run.return_value = _completed(json.dumps({"id": 7777}))
49
- reply_to_inline_comment_module.reply_to_inline_comment(
50
- owner="acme",
51
- repo="widget",
52
- number=42,
53
- comment_id=12345,
54
- body_file=body_file,
55
- )
56
- invoked_argv = mock_run.call_args[0][0]
57
- assert invoked_argv[0:2] == ["gh", "api"]
58
- assert "-X" in invoked_argv
59
- assert "POST" in invoked_argv
60
- assert "repos/acme/widget/pulls/42/comments/12345/replies" in invoked_argv
61
-
62
-
63
- def test_should_pass_body_via_field_at_path_form(tmp_path: Path) -> None:
64
- body_file = tmp_path / "reply.md"
65
- body_file.write_text("Confirmed and fixed.\n", encoding="utf-8")
66
- with patch("subprocess.run") as mock_run:
67
- mock_run.return_value = _completed(json.dumps({"id": 7777}))
68
- reply_to_inline_comment_module.reply_to_inline_comment(
69
- owner="acme",
70
- repo="widget",
71
- number=42,
72
- comment_id=12345,
73
- body_file=body_file,
74
- )
75
- invoked_argv = mock_run.call_args[0][0]
76
- assert "-F" in invoked_argv
77
- field_value = invoked_argv[invoked_argv.index("-F") + 1]
78
- assert field_value.startswith("body=@")
79
- assert str(body_file) in field_value
80
-
81
-
82
- def test_should_return_reply_id_from_gh_response(tmp_path: Path) -> None:
83
- body_file = tmp_path / "reply.md"
84
- body_file.write_text("Reply text\n", encoding="utf-8")
85
- with patch("subprocess.run") as mock_run:
86
- mock_run.return_value = _completed(json.dumps({"id": 7777, "body": "..."}))
87
- reply_id = reply_to_inline_comment_module.reply_to_inline_comment(
88
- owner="acme",
89
- repo="widget",
90
- number=42,
91
- comment_id=12345,
92
- body_file=body_file,
93
- )
94
- assert reply_id == 7777
95
-
96
-
97
- def test_should_raise_when_gh_subprocess_fails(tmp_path: Path) -> None:
98
- body_file = tmp_path / "reply.md"
99
- body_file.write_text("Reply text\n", encoding="utf-8")
100
- failure = subprocess.CalledProcessError(
101
- returncode=1, cmd=["gh"], stderr="auth failure"
102
- )
103
- with patch("subprocess.run", side_effect=failure):
104
- with pytest.raises(subprocess.CalledProcessError):
105
- reply_to_inline_comment_module.reply_to_inline_comment(
106
- owner="acme",
107
- repo="widget",
108
- number=42,
109
- comment_id=12345,
110
- body_file=body_file,
111
- )
112
-
113
-
114
- def test_should_build_body_field_value_from_named_prefix_constant(
115
- tmp_path: Path,
116
- ) -> None:
117
- body_file = tmp_path / "reply.md"
118
- body_file.write_text("Reply text\n", encoding="utf-8")
119
- with patch("subprocess.run") as mock_run:
120
- mock_run.return_value = _completed(json.dumps({"id": 7777}))
121
- reply_to_inline_comment_module.reply_to_inline_comment(
122
- owner="acme",
123
- repo="widget",
124
- number=42,
125
- comment_id=12345,
126
- body_file=body_file,
127
- )
128
- invoked_argv = mock_run.call_args[0][0]
129
- field_value = invoked_argv[invoked_argv.index("-F") + 1]
130
- expected_prefix = (
131
- reply_to_inline_comment_module.GH_FIELD_BODY_AT_PREFIX
132
- )
133
- assert expected_prefix == "body=@"
134
- assert field_value == f"{expected_prefix}{body_file}"
135
-
136
-
137
- def test_should_extract_int_id_from_mixed_typed_response_payload(
138
- tmp_path: Path,
139
- ) -> None:
140
- body_file = tmp_path / "reply.md"
141
- body_file.write_text("Reply text\n", encoding="utf-8")
142
- response_with_string_and_object_fields = json.dumps(
143
- {
144
- "id": 7777,
145
- "body": "Reply body text",
146
- "user": {"login": "octocat", "id": 1},
147
- "created_at": "2026-05-02T12:00:00Z",
148
- }
149
- )
150
- with patch("subprocess.run") as mock_run:
151
- mock_run.return_value = _completed(response_with_string_and_object_fields)
152
- reply_id = reply_to_inline_comment_module.reply_to_inline_comment(
153
- owner="acme",
154
- repo="widget",
155
- number=42,
156
- comment_id=12345,
157
- body_file=body_file,
158
- )
159
- assert reply_id == 7777
@@ -1,101 +0,0 @@
1
- """Tests for request_copilot_review.
2
-
3
- Covers:
4
- - gh api -X POST is invoked against requested_reviewers endpoint
5
- - the reviewer id literal is `copilot-pull-request-reviewer[bot]` (the [bot]
6
- suffix is load-bearing per skills/copilot-review/SKILL.md)
7
- - subprocess errors propagate
8
- - the field carries the documented `reviewers[]=<id>` form
9
- """
10
-
11
- from __future__ import annotations
12
-
13
- import importlib.util
14
- import subprocess
15
- from pathlib import Path
16
- from types import ModuleType
17
- from unittest.mock import MagicMock, patch
18
-
19
- import pytest
20
-
21
-
22
- def _load_module() -> ModuleType:
23
- module_path = Path(__file__).parent / "request_copilot_review.py"
24
- spec = importlib.util.spec_from_file_location("request_copilot_review", module_path)
25
- assert spec is not None
26
- assert spec.loader is not None
27
- module = importlib.util.module_from_spec(spec)
28
- spec.loader.exec_module(module)
29
- return module
30
-
31
-
32
- request_copilot_review_module = _load_module()
33
-
34
-
35
- def _completed(stdout: str) -> subprocess.CompletedProcess:
36
- process = MagicMock(spec=subprocess.CompletedProcess)
37
- process.stdout = stdout
38
- process.returncode = 0
39
- return process
40
-
41
-
42
- def test_should_invoke_gh_api_post_against_requested_reviewers_endpoint() -> None:
43
- with patch("subprocess.run") as mock_run:
44
- mock_run.return_value = _completed("{}")
45
- request_copilot_review_module.request_copilot_review(
46
- owner="acme", repo="widget", number=42
47
- )
48
- invoked_argv = mock_run.call_args[0][0]
49
- assert invoked_argv[0:2] == ["gh", "api"]
50
- assert "-X" in invoked_argv
51
- assert "POST" in invoked_argv
52
- assert "repos/acme/widget/pulls/42/requested_reviewers" in invoked_argv
53
-
54
-
55
- def test_should_request_copilot_with_bot_suffix_literal() -> None:
56
- with patch("subprocess.run") as mock_run:
57
- mock_run.return_value = _completed("{}")
58
- request_copilot_review_module.request_copilot_review(
59
- owner="acme", repo="widget", number=42
60
- )
61
- invoked_argv = mock_run.call_args[0][0]
62
- assert "reviewers[]=copilot-pull-request-reviewer[bot]" in invoked_argv
63
-
64
-
65
- def test_should_pass_reviewer_field_via_dash_f_flag() -> None:
66
- with patch("subprocess.run") as mock_run:
67
- mock_run.return_value = _completed("{}")
68
- request_copilot_review_module.request_copilot_review(
69
- owner="acme", repo="widget", number=42
70
- )
71
- invoked_argv = mock_run.call_args[0][0]
72
- assert "-f" in invoked_argv
73
- field_index = invoked_argv.index("-f")
74
- field_value = invoked_argv[field_index + 1]
75
- assert field_value == "reviewers[]=copilot-pull-request-reviewer[bot]"
76
-
77
-
78
- def test_should_raise_when_gh_subprocess_fails() -> None:
79
- failure = subprocess.CalledProcessError(
80
- returncode=1, cmd=["gh"], stderr="auth failure"
81
- )
82
- with patch("subprocess.run", side_effect=failure):
83
- with pytest.raises(subprocess.CalledProcessError):
84
- request_copilot_review_module.request_copilot_review(
85
- owner="acme", repo="widget", number=42
86
- )
87
-
88
-
89
- def test_should_render_endpoint_via_named_template_constant() -> None:
90
- with patch("subprocess.run") as mock_run:
91
- mock_run.return_value = _completed("{}")
92
- request_copilot_review_module.request_copilot_review(
93
- owner="acme", repo="widget", number=42
94
- )
95
- invoked_argv = mock_run.call_args[0][0]
96
- expected_endpoint = (
97
- request_copilot_review_module.GH_REQUESTED_REVIEWERS_PATH_TEMPLATE.format(
98
- owner="acme", repo="widget", number=42
99
- )
100
- )
101
- assert expected_endpoint in invoked_argv
@@ -1,79 +0,0 @@
1
- """Tests for resolve_pr_head.
2
-
3
- Covers:
4
- - gh command targets the single-object PR endpoint with --jq .head.sha
5
- - single-object endpoint does NOT use --paginate or --slurp (per gh-paginate rule)
6
- - the trimmed SHA is returned
7
- - subprocess errors propagate
8
- """
9
-
10
- from __future__ import annotations
11
-
12
- import importlib.util
13
- import subprocess
14
- from pathlib import Path
15
- from types import ModuleType
16
- from unittest.mock import MagicMock, patch
17
-
18
- import pytest
19
-
20
-
21
- def _load_module() -> ModuleType:
22
- module_path = Path(__file__).parent / "resolve_pr_head.py"
23
- spec = importlib.util.spec_from_file_location("resolve_pr_head", module_path)
24
- assert spec is not None
25
- assert spec.loader is not None
26
- module = importlib.util.module_from_spec(spec)
27
- spec.loader.exec_module(module)
28
- return module
29
-
30
-
31
- resolve_pr_head_module = _load_module()
32
-
33
-
34
- def _completed(stdout: str) -> subprocess.CompletedProcess:
35
- process = MagicMock(spec=subprocess.CompletedProcess)
36
- process.stdout = stdout
37
- process.returncode = 0
38
- return process
39
-
40
-
41
- def test_should_invoke_gh_against_single_object_pr_endpoint() -> None:
42
- with patch("subprocess.run") as mock_run:
43
- mock_run.return_value = _completed("85309a0789e\n")
44
- resolve_pr_head_module.resolve_pr_head(owner="acme", repo="widget", number=42)
45
- invoked_argv = mock_run.call_args[0][0]
46
- assert invoked_argv[0] == "gh"
47
- assert invoked_argv[1] == "api"
48
- assert invoked_argv[2] == "repos/acme/widget/pulls/42"
49
- assert "--jq" in invoked_argv
50
- assert ".head.sha" in invoked_argv
51
-
52
-
53
- def test_should_not_use_paginate_or_slurp_on_single_object_endpoint() -> None:
54
- with patch("subprocess.run") as mock_run:
55
- mock_run.return_value = _completed("abc\n")
56
- resolve_pr_head_module.resolve_pr_head(owner="acme", repo="widget", number=42)
57
- invoked_argv = mock_run.call_args[0][0]
58
- assert "--paginate" not in invoked_argv
59
- assert "--slurp" not in invoked_argv
60
-
61
-
62
- def test_should_return_trimmed_sha() -> None:
63
- with patch("subprocess.run") as mock_run:
64
- mock_run.return_value = _completed(" 85309a0789e \n")
65
- resolved_sha = resolve_pr_head_module.resolve_pr_head(
66
- owner="acme", repo="widget", number=42
67
- )
68
- assert resolved_sha == "85309a0789e"
69
-
70
-
71
- def test_should_raise_when_gh_subprocess_fails() -> None:
72
- failure = subprocess.CalledProcessError(
73
- returncode=1, cmd=["gh"], stderr="auth failure"
74
- )
75
- with patch("subprocess.run", side_effect=failure):
76
- with pytest.raises(subprocess.CalledProcessError):
77
- resolve_pr_head_module.resolve_pr_head(
78
- owner="acme", repo="widget", number=42
79
- )
@@ -1,80 +0,0 @@
1
- """Tests for review_field_helpers.
2
-
3
- Covers defensive field-coercion for the four GitHub payload field accessors
4
- shared across fetch_*_reviews.py and fetch_*_inline_comments.py.
5
- """
6
-
7
- from __future__ import annotations
8
-
9
- import importlib.util
10
- from pathlib import Path
11
- from types import ModuleType
12
-
13
-
14
- def _load_module() -> ModuleType:
15
- module_path = Path(__file__).parent / "review_field_helpers.py"
16
- spec = importlib.util.spec_from_file_location("review_field_helpers", module_path)
17
- assert spec is not None
18
- assert spec.loader is not None
19
- module = importlib.util.module_from_spec(spec)
20
- spec.loader.exec_module(module)
21
- return module
22
-
23
-
24
- review_field_helpers_module = _load_module()
25
-
26
-
27
- def test_login_of_should_return_login_string_when_user_dict_has_login() -> None:
28
- payload = {"user": {"login": "cursor[bot]"}}
29
- assert review_field_helpers_module.login_of(payload) == "cursor[bot]"
30
-
31
-
32
- def test_login_of_should_return_none_when_user_field_missing() -> None:
33
- assert review_field_helpers_module.login_of({}) is None
34
-
35
-
36
- def test_login_of_should_return_none_when_user_field_not_dict() -> None:
37
- assert review_field_helpers_module.login_of({"user": "not-a-dict"}) is None
38
-
39
-
40
- def test_login_of_should_return_none_when_login_field_not_string() -> None:
41
- assert review_field_helpers_module.login_of({"user": {"login": 12345}}) is None
42
-
43
-
44
- def test_body_of_should_return_body_string_when_present() -> None:
45
- assert review_field_helpers_module.body_of({"body": "review body"}) == "review body"
46
-
47
-
48
- def test_body_of_should_return_empty_string_when_body_missing() -> None:
49
- assert review_field_helpers_module.body_of({}) == ""
50
-
51
-
52
- def test_body_of_should_return_empty_string_when_body_not_string() -> None:
53
- assert review_field_helpers_module.body_of({"body": None}) == ""
54
-
55
-
56
- def test_submitted_at_of_should_return_string_when_present() -> None:
57
- payload = {"submitted_at": "2026-05-03T12:00:00Z"}
58
- assert (
59
- review_field_helpers_module.submitted_at_of(payload) == "2026-05-03T12:00:00Z"
60
- )
61
-
62
-
63
- def test_submitted_at_of_should_return_empty_string_when_missing() -> None:
64
- assert review_field_helpers_module.submitted_at_of({}) == ""
65
-
66
-
67
- def test_submitted_at_of_should_return_empty_string_when_not_string() -> None:
68
- assert review_field_helpers_module.submitted_at_of({"submitted_at": 0}) == ""
69
-
70
-
71
- def test_state_of_should_return_state_string_when_present() -> None:
72
- assert review_field_helpers_module.state_of({"state": "APPROVED"}) == "APPROVED"
73
-
74
-
75
- def test_state_of_should_return_empty_string_when_missing() -> None:
76
- assert review_field_helpers_module.state_of({}) == ""
77
-
78
-
79
- def test_state_of_should_return_empty_string_when_not_string() -> None:
80
- assert review_field_helpers_module.state_of({"state": ["APPROVED"]}) == ""