claude-dev-env 8.114.10 → 8.116.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.
@@ -0,0 +1,255 @@
1
+ """Patterns and note text for the pieces-per-level PreToolUse note.
2
+
3
+ Groups: the payload keys the hook reads, the commit and pull request option
4
+ names, the patterns that find verb-led clauses in a subject and topics in a
5
+ pull request body, and the note text. The note is context only.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ import re
11
+
12
+ TOOL_NAME_KEY = "tool_name"
13
+ TOOL_INPUT_KEY = "tool_input"
14
+ COMMAND_INPUT_KEY = "command"
15
+ WORKING_DIRECTORY_KEY = "cwd"
16
+ PRE_TOOL_USE_EVENT_NAME = "PreToolUse"
17
+ ADDITIONAL_CONTEXT_KEY = "additionalContext"
18
+ TITLE_INPUT_KEY = "title"
19
+ BODY_INPUT_KEY = "body"
20
+
21
+ EXECUTABLE_SUFFIX = ".exe"
22
+ GIT_PROGRAM_NAME = "git"
23
+ GIT_COMMIT_WORD = "commit"
24
+ GH_PROGRAM_NAME = "gh"
25
+ ALL_GH_CREATE_WORDS = ("pr", "create")
26
+ ALL_QUICK_SCAN_WORDS = ("commit", "create", "pull_request")
27
+ ALL_SHELL_CONTROL_TOKENS = frozenset({"&&", "||", ";", "|", "&", "|&"})
28
+ BACKSLASH = "\\"
29
+ DOUBLED_BACKSLASH = "\\\\"
30
+ LONG_OPTION_PREFIX = "--"
31
+ OPTION_VALUE_SEPARATOR = "="
32
+ SHORT_OPTION_PREFIX = "-"
33
+ ALL_MESSAGE_LONG_OPTIONS = frozenset({"--message"})
34
+ ALL_FILE_LONG_OPTIONS = frozenset({"--file"})
35
+ MESSAGE_SHORT_FLAG = "m"
36
+ MESSAGE_KIND = "message"
37
+ FILE_KIND = "file"
38
+ FILE_SHORT_OPTION = "-F"
39
+ STANDARD_INPUT_PATH = "-"
40
+ MESSAGE_PARAGRAPH_SEPARATOR = "\n\n"
41
+ SHORT_CLUSTER_MINIMUM_LENGTH = 2
42
+ MAXIMUM_COMMAND_CHARACTERS = 8_000
43
+ MAXIMUM_FILE_BYTES = 65_536
44
+ MAXIMUM_PROGRAM_MENTIONS = 16
45
+ MAXIMUM_WRAPPED_TEXTS = 8
46
+ MAXIMUM_SUBSTITUTION_MARKERS = 16
47
+ MAXIMUM_TITLE_CHARACTERS = 300
48
+ MAXIMUM_BODY_CHARACTERS = 20_000
49
+ MAXIMUM_LINE_CHARACTERS = 500
50
+ TOTAL_DEADLINE_SECONDS = 1.0
51
+ EXIT_WAIT_SECONDS = 0.2
52
+ DEADLINE_ENVIRONMENT_VARIABLE = "PIECES_NOTE_TEST_DEADLINE_SECONDS"
53
+ ANALYZE_FLAG = "--analyze"
54
+ ANALYSIS_MODULE_NAME = "pieces_per_level_analysis"
55
+ CREATE_NO_WINDOW_ATTRIBUTE = "CREATE_NO_WINDOW"
56
+ PARSE_CACHE_SIZE = 2
57
+ ALL_SUBSTITUTION_MARKERS = ("$(", "`")
58
+
59
+ HEREDOC_MESSAGE_PATTERN = re.compile(
60
+ r"^\s*\$\(\s*cat\s+<<-?\s*(?P<quote>['\"]?)(?P<tag>\w+)(?P=quote)[ \t]*\n(?P<text>.*?)\n[ \t]*(?P=tag)[ \t]*\n?\s*\)\s*$",
61
+ re.DOTALL,
62
+ )
63
+ GIT_WORD_PATTERN = re.compile(r"\bgit\b")
64
+ COMMIT_WORD_PATTERN = re.compile(r"\bcommit\b")
65
+ HEREDOC_START_PATTERN = re.compile(
66
+ r"(?:-\w*m|--message)[ =]+\"?\$\(\s*cat\s+<<-?\s*(?P<quote>['\"]?)(?P<tag>\w+)(?P=quote)[ \t]*$"
67
+ )
68
+ HEREDOC_TAG_GROUP = "tag"
69
+ HEREDOC_TEXT_GROUP = "text"
70
+ LINE_LEADING_WORD_PATTERN = re.compile(r"[ \t]*(\w*)")
71
+ LINE_SEPARATOR = "\n"
72
+ CARRIAGE_RETURN = "\r"
73
+ CARRIAGE_RETURN_LINE_FEED = "\r\n"
74
+ MINIMUM_HEREDOC_BODY_LINE_OFFSET = 2
75
+
76
+ CONVENTIONAL_SUBJECT_PATTERN = re.compile(
77
+ r"^[a-z]+(?:\([^)\n]*\))?!?:[ \t]+(?P<description>\S.*)$", re.IGNORECASE
78
+ )
79
+ DESCRIPTION_GROUP = "description"
80
+ CODE_SPAN_PATTERN = re.compile(r"`[^`\n]*`")
81
+ PARENTHESIS_PATTERN = re.compile(r"\([^)\n]*\)")
82
+ QUOTED_TEXT_PATTERN = re.compile(r"\"[^\"\n]*\"|'[^'\n]*'")
83
+ MASKED_TEXT = "text"
84
+ REMOVED_TEXT = ""
85
+ MINIMUM_CLAUSE_WORD_COUNT = 1
86
+ CLAUSE_SEPARATOR_PATTERN = re.compile(r"\s*;\s*|\s*,\s*(?:and\s+)?|\s+and\s+", re.IGNORECASE)
87
+ WORD_EDGE_CHARACTERS = ".,;:!?\"'`*_()"
88
+ MINIMUM_PIECE_COUNT = 2
89
+ MAXIMUM_NAMED_PIECES = 6
90
+ MAXIMUM_PIECE_CHARACTERS = 80
91
+ PIECE_TRUNCATION_SUFFIX = "..."
92
+
93
+ ALL_ADJUNCT_WORDS = frozenset({"with", "using", "via", "without", "including", "plus"})
94
+ ALL_LEADING_ADVERBS = frozenset(
95
+ {"always", "also", "now", "never", "then", "only", "just", "finally", "still"}
96
+ )
97
+ ALL_PIECE_VERBS = frozenset(
98
+ {
99
+ "accept",
100
+ "add",
101
+ "align",
102
+ "allow",
103
+ "apply",
104
+ "ask",
105
+ "bind",
106
+ "block",
107
+ "build",
108
+ "bump",
109
+ "cache",
110
+ "center",
111
+ "change",
112
+ "check",
113
+ "clean",
114
+ "clear",
115
+ "close",
116
+ "collapse",
117
+ "convert",
118
+ "copy",
119
+ "create",
120
+ "darken",
121
+ "delete",
122
+ "detect",
123
+ "disable",
124
+ "draw",
125
+ "drop",
126
+ "emit",
127
+ "enable",
128
+ "end",
129
+ "ensure",
130
+ "expand",
131
+ "extract",
132
+ "fetch",
133
+ "finish",
134
+ "fix",
135
+ "format",
136
+ "handle",
137
+ "hide",
138
+ "ignore",
139
+ "install",
140
+ "keep",
141
+ "lighten",
142
+ "link",
143
+ "list",
144
+ "load",
145
+ "log",
146
+ "make",
147
+ "mark",
148
+ "merge",
149
+ "move",
150
+ "name",
151
+ "open",
152
+ "parse",
153
+ "pass",
154
+ "pin",
155
+ "point",
156
+ "prevent",
157
+ "print",
158
+ "publish",
159
+ "put",
160
+ "read",
161
+ "record",
162
+ "refactor",
163
+ "register",
164
+ "reject",
165
+ "remove",
166
+ "rename",
167
+ "render",
168
+ "replace",
169
+ "require",
170
+ "reset",
171
+ "resize",
172
+ "restore",
173
+ "retry",
174
+ "return",
175
+ "rewrite",
176
+ "route",
177
+ "run",
178
+ "save",
179
+ "scale",
180
+ "send",
181
+ "set",
182
+ "show",
183
+ "simplify",
184
+ "skip",
185
+ "split",
186
+ "start",
187
+ "stop",
188
+ "store",
189
+ "support",
190
+ "switch",
191
+ "sync",
192
+ "tell",
193
+ "tidy",
194
+ "track",
195
+ "trim",
196
+ "unpin",
197
+ "update",
198
+ "upgrade",
199
+ "use",
200
+ "validate",
201
+ "verify",
202
+ "wait",
203
+ "wire",
204
+ "wrap",
205
+ "write",
206
+ }
207
+ )
208
+
209
+ WHAT_THIS_DOES_SECTION_NAME = "What this does"
210
+ TOPIC_BULLET_PATTERN = re.compile(r"^[-*+][ \t]+(?:\*\*|__)(?P<topic>[^*_\n]+?)(?:\*\*|__)")
211
+ TOPIC_GROUP = "topic"
212
+ TOPIC_EDGE_CHARACTERS = " \t:.-"
213
+ ALL_LABEL_TOPICS = frozenset(
214
+ {"before", "after", "why", "who notices", "now", "then", "today", "effect", "note", "context"}
215
+ )
216
+
217
+ PROOF_LEAD_CHARACTERS = " \t>-*+_`#"
218
+ PROOF_NUMBER_PATTERN = re.compile(r"^\d+[.)]\s*")
219
+ WITHOUT_LINE_PATTERN = re.compile(r"^without\b")
220
+ WITH_LINE_PATTERN = re.compile(r"^with\b(?!out)")
221
+ WITH_SAME_LINE_PATTERN = re.compile(r"[;,.]\s+[*_`]*with\b(?!out)")
222
+ MINIMUM_PROOF_PAIR_COUNT = 2
223
+
224
+ COMMIT_KIND = "commit"
225
+ PULL_REQUEST_KIND = "pull request"
226
+ PIECE_SEPARATOR = "; "
227
+ MORE_PIECES_TEMPLATE = "and {count} more"
228
+ PROOF_PAIRS_PIECE_TEMPLATE = "{count} without/with proof pairs under Proof in practice"
229
+ QUOTED_PIECE_TEMPLATE = '"{piece}"'
230
+
231
+ COMMIT_NEXT_COMMAND = (
232
+ "The commit that is running holds every piece. To split it, run `git reset --soft HEAD~1`, "
233
+ "then `git add <paths of the first piece>` and commit, then put the next piece on its own "
234
+ "level with `gt create` (or `git switch -c <next-branch>` without Graphite)."
235
+ )
236
+ PULL_REQUEST_NEXT_COMMAND = (
237
+ "Next command: `gt create` (or `git switch -c <next-branch>` from the previous level) for "
238
+ "each further piece, then open one pull request per level with `gh pr create --base "
239
+ "<previous-branch>`."
240
+ )
241
+ NOTE_TEMPLATE = (
242
+ "Your own words name several pieces in this {kind}: {pieces}. Each piece gets its own "
243
+ "commit and its own stack level, committed as its verifier passes, so a reviewer reads "
244
+ "one purpose at a time. {next_command} This note is context only, and the {kind} runs."
245
+ )
246
+ ALL_NEXT_COMMAND_BY_KIND = {
247
+ COMMIT_KIND: COMMIT_NEXT_COMMAND,
248
+ PULL_REQUEST_KIND: PULL_REQUEST_NEXT_COMMAND,
249
+ }
250
+
251
+ COMMIT_MESSAGE_FLAG_PATTERN = re.compile(r"(?<!\S)(?:-[A-Za-z]*m|--message|-F|--file)(?![\w-])")
252
+ BODY_OPTION_PATTERN = re.compile(r"(?<!\S)(?:--body|--body-file|-b|-F|--file)(?![\w-])")
253
+ PULL_REQUEST_CREATE_PATTERN = re.compile(r"\bpr\s+create\b")
254
+ PULL_REQUEST_SCRIPT_CREATE_PATTERN = re.compile(r"\bpull_request\.py\b\s+create\b")
255
+ CLAUSE_SEPARATOR_PRECHECK_PATTERN = re.compile(r"[,;]|\band\b", re.IGNORECASE)
@@ -330,12 +330,22 @@ def _inner_commands(command: str, all_command_segments: list[list[str]]) -> list
330
330
  return [each_command for each_command in all_inner_commands if each_command is not None]
331
331
 
332
332
 
333
- def _all_wrapped_command_parses(command: str) -> list[tuple[str, list[list[str]]]]:
333
+ def _command_segments(command: str) -> list[list[str]]:
334
+ return [
335
+ each_segment for each_segment, _following_operator in pipeline_segments_for_command(command)
336
+ ]
337
+
338
+
339
+ def _all_wrapped_command_parses(
340
+ command: str, maximum_texts: int | None = None
341
+ ) -> list[tuple[str, list[list[str]]]]:
334
342
  """Return each command text with its segments, the command first, each text parsed once.
335
343
 
336
344
  The texts after the command are the command string every shell wrapper,
337
345
  evaluating program and command substitution inside it runs, unwrapped in
338
346
  turn to ``MAXIMUM_UNWRAP_DEPTH`` levels. A text met twice is parsed once.
347
+ With ``maximum_texts`` set, no further text is parsed or unwrapped once that
348
+ many are held.
339
349
  """
340
350
  all_parses: list[tuple[str, list[list[str]]]] = []
341
351
  all_seen_texts: set[str] = set()
@@ -345,11 +355,10 @@ def _all_wrapped_command_parses(command: str) -> list[tuple[str, list[list[str]]
345
355
  if each_text in all_seen_texts or each_depth > MAXIMUM_UNWRAP_DEPTH:
346
356
  continue
347
357
  all_seen_texts.add(each_text)
348
- all_command_segments = [
349
- each_segment
350
- for each_segment, _following_operator in pipeline_segments_for_command(each_text)
351
- ]
358
+ all_command_segments = _command_segments(each_text)
352
359
  all_parses.append((each_text, all_command_segments))
360
+ if maximum_texts is not None and len(all_parses) >= maximum_texts:
361
+ break
353
362
  all_pending_texts.extend(
354
363
  (each_inner_command, each_depth + 1)
355
364
  for each_inner_command in _inner_commands(each_text, all_command_segments)
@@ -357,15 +366,18 @@ def _all_wrapped_command_parses(command: str) -> list[tuple[str, list[list[str]]
357
366
  return all_parses
358
367
 
359
368
 
360
- def all_wrapped_command_texts(command: str) -> list[str]:
369
+ def all_wrapped_command_texts(command: str, maximum_texts: int | None = None) -> list[str]:
361
370
  """Return the command plus each command string a wrapper or substitution inside it runs.
362
371
 
363
372
  The segments come from the quote-aware pipeline parser, so the quoted
364
373
  script in ``powershell -Command "git add -A; git push"`` stays whole until
365
374
  its own turn. Nested wrappers and ``$(...)`` or backtick substitutions
366
- unwrap in turn.
375
+ unwrap in turn. With ``maximum_texts`` set, the list stops at that many texts.
367
376
  """
368
- return [each_text for each_text, _all_segments in _all_wrapped_command_parses(command)]
377
+ return [
378
+ each_text
379
+ for each_text, _all_segments in _all_wrapped_command_parses(command, maximum_texts)
380
+ ]
369
381
 
370
382
 
371
383
  def all_wrapped_command_segments(command: str) -> list[list[str]]:
@@ -44,7 +44,11 @@ SPAWN_OVERSIGHT_DIRECTIVE = (
44
44
  "confirms the fix on the new state. Spawn a fresh verifier agent for each "
45
45
  "check, never the agent that did the work, and brief it with the issue and "
46
46
  "the sources and leave the worker's conclusion out. A verifier's check ends "
47
- "the chain and gets no verifier of its own. Ask the user once before "
47
+ "the chain and gets no verifier of its own. When a piece's verifier passes "
48
+ "and the brief allows commits, commit that piece alone as its own stack level "
49
+ "with a subject for that one behaviour: a piece that depends on it goes on "
50
+ "top, and an independent piece goes on its own branch from trunk. Otherwise "
51
+ "hand the piece back uncommitted and say so. Ask the user once before "
48
52
  "you build new scope the user's words do not name, and keep in-scope work "
49
53
  "moving while the question waits. Report as done only what a verifier "
50
54
  "passed, with its evidence. While the agent runs, read its progress and wake "
@@ -29,6 +29,13 @@ def test_should_return_the_command_string_a_shell_wrapper_runs(
29
29
  assert inner_command in all_command_texts
30
30
 
31
31
 
32
+ def test_should_stop_the_list_at_the_text_count_cap() -> None:
33
+ command = "bash -c \"pwsh -Command 'git push'\""
34
+ assert shell_command_wrappers.all_wrapped_command_texts(command, 1) == [command]
35
+ assert len(shell_command_wrappers.all_wrapped_command_texts(command, 2)) == 2
36
+ assert len(shell_command_wrappers.all_wrapped_command_texts(command)) > 2
37
+
38
+
32
39
  def test_should_return_only_the_command_when_no_wrapper_runs() -> None:
33
40
  assert shell_command_wrappers.all_wrapped_command_texts("git push") == ["git push"]
34
41
 
@@ -361,3 +361,18 @@ def test_the_emitted_directive_reports_only_verified_results() -> None:
361
361
 
362
362
  def test_the_emitted_directive_ends_the_chain_at_the_verifier() -> None:
363
363
  assert "A verifier's check ends the chain and gets no verifier of its own" in _emitted_directive()
364
+
365
+
366
+ def test_the_emitted_directive_commits_each_passed_piece_as_its_own_stack_level() -> None:
367
+ directive = _emitted_directive()
368
+ assert "When a piece's verifier passes and the brief allows commits, commit that piece alone as its own stack level" in directive
369
+ assert "a piece that depends on it goes on top" in directive
370
+ assert "an independent piece goes on its own branch from trunk" in directive
371
+ assert "Otherwise hand the piece back uncommitted and say so." in directive
372
+ assert directive.index("confirms the fix on the new state") < directive.index("commit that piece alone")
373
+
374
+
375
+ def test_the_emitted_directive_stays_context_only_and_inside_its_budget() -> None:
376
+ directive = _emitted_directive()
377
+ assert len(directive) < 1500
378
+ assert "deny" not in directive.lower()
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-dev-env",
3
- "version": "8.114.10",
3
+ "version": "8.116.0",
4
4
  "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
5
5
  "type": "module",
6
6
  "bin": {
@@ -87,3 +87,16 @@ def test_the_pull_request_skill_points_its_decision_tree_at_the_delivery_section
87
87
  assert "independent piece" not in decision_tree
88
88
  assert "`gt create`" not in decision_tree
89
89
  assert "a plain branch from the previous level" not in decision_tree
90
+
91
+
92
+ def test_the_enforcement_section_names_the_note_and_keeps_it_non_blocking() -> None:
93
+ enforcement_text = GUIDE_PATH.read_text(encoding="utf-8").split("## Enforcement", 1)[1]
94
+ assert "hooks/advisory/pieces_per_level_note.py" in enforcement_text
95
+ assert "it never denies or exits non-zero" in enforcement_text
96
+
97
+
98
+ def test_the_enforcement_section_points_to_the_feature_page_for_the_note_details() -> None:
99
+ enforcement_text = GUIDE_PATH.read_text(encoding="utf-8").split("## Enforcement", 1)[1]
100
+ assert "(../../hooks/features/session-context.md)" in enforcement_text
101
+ assert "wall-clock deadline" not in enforcement_text
102
+ assert "split the commit or the pull request" not in enforcement_text