@yahyahammad/venastine 0.2.0 → 0.3.8

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 (129) hide show
  1. package/.env.example +19 -14
  2. package/CONFIG_ARCHITECTURE.md +2002 -0
  3. package/NOTICE +1 -1
  4. package/README.md +233 -94
  5. package/agents/builtin/build.md +73 -0
  6. package/agents/builtin/general.md +80 -0
  7. package/agents/builtin/plan.md +23 -5
  8. package/agents/builtin/test.md +65 -0
  9. package/agents/builtin/writer.md +67 -0
  10. package/agents/manager.py +261 -195
  11. package/agents/subagent_tool.py +277 -43
  12. package/agents/tui_commands.py +7 -12
  13. package/bin/venastine.mjs +528 -382
  14. package/bin/venastine.py +71 -0
  15. package/cli_commands.py +835 -0
  16. package/config.py +95 -1198
  17. package/config.yaml +1090 -0
  18. package/config_edit.py +1301 -0
  19. package/config_schema.py +966 -0
  20. package/config_update.py +749 -0
  21. package/core/agent_activity.py +158 -20
  22. package/core/ansi.py +452 -0
  23. package/core/approval.py +27 -5
  24. package/core/call_view.py +364 -0
  25. package/core/cancel.py +121 -0
  26. package/core/chatgpt_auth.py +747 -0
  27. package/core/claims_view.py +107 -0
  28. package/core/client.py +1238 -82
  29. package/core/commands.py +454 -0
  30. package/core/compaction.py +830 -66
  31. package/core/config_loader.py +516 -97
  32. package/core/connect.py +686 -0
  33. package/core/events.py +68 -6
  34. package/core/file_mentions.py +280 -0
  35. package/core/interaction.py +87 -4
  36. package/core/line_pattern.py +128 -0
  37. package/core/loop.py +1516 -440
  38. package/core/memory.py +120 -8
  39. package/core/pipeline_models.py +23 -9
  40. package/core/provider_errors.py +234 -0
  41. package/core/reasoning/confidence_scoring.py +70 -54
  42. package/core/reasoning/json_retry.py +19 -1
  43. package/core/reasoning/orchestrator.py +232 -53
  44. package/core/reasoning/output_writer.py +90 -31
  45. package/core/reasoning/payload_validation.py +133 -7
  46. package/core/reasoning/pipeline_storage.py +427 -361
  47. package/core/reasoning/review.py +659 -615
  48. package/core/reasoning/scholar.py +38 -14
  49. package/core/reasoning/source_corpus.py +110 -4
  50. package/core/replay.py +158 -26
  51. package/core/session.py +36 -12
  52. package/core/session_view.py +259 -0
  53. package/core/session_wake.py +259 -0
  54. package/core/shell_sessions.py +1553 -0
  55. package/core/workspace_trust.py +1 -1
  56. package/credentials.py +308 -180
  57. package/database.py +82 -1
  58. package/{PRIVACY.md → docs/PRIVACY.md} +19 -7
  59. package/docs/SECURITY.md +108 -0
  60. package/docs/THIRD_PARTY_NOTICES.md +148 -0
  61. package/env_secrets.py +118 -77
  62. package/json_store.py +236 -16
  63. package/logging_setup.py +121 -11
  64. package/main.py +1671 -199
  65. package/mcp_client/client.py +257 -23
  66. package/mcp_client/config.py +484 -379
  67. package/mcp_client/registration.py +163 -2
  68. package/memories/manager.py +15 -0
  69. package/memories/tui_commands.py +7 -12
  70. package/package.json +234 -4
  71. package/project_init/config_files.py +4 -0
  72. package/project_init/generator.py +201 -37
  73. package/project_init/manifest.py +418 -406
  74. package/project_init/tui_commands.py +7 -4
  75. package/prompts/revalidate.md +1 -1
  76. package/prompts/revise.md +17 -15
  77. package/prompts/system_prompts.py +64 -10
  78. package/providers.json.example +94 -92
  79. package/pyproject.toml +51 -2
  80. package/requirements.txt +252 -29
  81. package/safety/policy_enforcement.py +353 -17
  82. package/security/askpass.py +419 -0
  83. package/security/capability.py +37 -7
  84. package/security/confine.py +484 -0
  85. package/security/hosted.py +182 -0
  86. package/security/permissions.py +54 -7
  87. package/security/posture.py +124 -12
  88. package/security/protected_paths.py +198 -6
  89. package/security/sandbox.py +3262 -139
  90. package/security/secrets.py +855 -0
  91. package/skills/tui_commands.py +3 -4
  92. package/storage.py +368 -35
  93. package/tools/base.py +465 -305
  94. package/tools/builtin/_math_common.py +306 -16
  95. package/tools/builtin/_net_common.py +267 -61
  96. package/tools/builtin/arxiv.py +681 -223
  97. package/tools/builtin/ask_user.py +231 -213
  98. package/tools/builtin/discrete_math.py +35 -4
  99. package/tools/builtin/fetch_url.py +239 -21
  100. package/tools/builtin/file_ops.py +341 -33
  101. package/tools/builtin/geometry.py +184 -148
  102. package/tools/builtin/get_time.py +2 -2
  103. package/tools/builtin/linear_algebra.py +66 -23
  104. package/tools/builtin/load_skill.py +10 -0
  105. package/tools/builtin/logic.py +171 -12
  106. package/tools/builtin/pin.py +46 -12
  107. package/tools/builtin/probability_stats.py +224 -228
  108. package/tools/builtin/project_docs.py +80 -21
  109. package/tools/builtin/remember.py +21 -4
  110. package/tools/builtin/shell.py +586 -67
  111. package/tools/builtin/shell_sessions.py +613 -0
  112. package/tools/builtin/symbolic_math.py +80 -10
  113. package/tools/builtin/todo.py +5 -3
  114. package/tools/builtin/web_search.py +329 -151
  115. package/tools/context.py +23 -0
  116. package/tools/isolation.py +387 -314
  117. package/tools/registry.py +347 -30
  118. package/tui/app.py +4645 -438
  119. package/tui/app.tcss +185 -2
  120. package/tui/commands.py +10 -154
  121. package/tui/diffs.py +286 -265
  122. package/tui/hosted_driver.py +102 -0
  123. package/tui/markdown.py +60 -10
  124. package/tui/meters.py +103 -7
  125. package/tui/screens.py +346 -92
  126. package/tui/themes.py +59 -19
  127. package/tui/widgets.py +1575 -111
  128. package/SECURITY.md +0 -88
  129. package/THIRD_PARTY_NOTICES.md +0 -100
package/requirements.txt CHANGED
@@ -7,25 +7,112 @@
7
7
  # only reachable consumer is behind read/write/edit, which are globally
8
8
  # denied. `pip install -e ".[documents]"` brings them back.
9
9
 
10
- anthropic==0.116.0
11
- ddgs==9.14.4
10
+ # Batch 234, from Dependabot's group (PR #271): anthropic 0.116.0 -> 2.1.0
11
+ # and openai 2.45.0 -> 3.36.0, each the newest release at least two weeks
12
+ # old, the owner's rule from batches 172 and 208 (the PR proposed 2.3.0 and
13
+ # 3.41.0). Both move their HTTP stack to httpx2. anthropic 2.0 also sends
14
+ # `anthropic-version: 2026-10-21` and the key as `Authorization: Bearer`;
15
+ # that API version refuses a temperature on every model, and 1.0 took the
16
+ # parameter out of `messages.stream()`, so core/client.py drops one for
17
+ # ANTHROPIC (ROADMAP_v3 A82). An empty key, which 0.116.0 refused as a
18
+ # TypeError, became a retried "Connection error." (httpx2 refuses the
19
+ # header `Bearer `), so api_initialization refuses it first. Measured with
20
+ # core/client.py's own calls against a local mock on both pin sets;
21
+ # test_sdk_conformance.py re-checks the shapes. What to re-measure when
22
+ # these move: that the stream, the effort query and the error types still
23
+ # match, since the suite fakes both packages everywhere else.
24
+ anthropic==2.1.0
25
+ ddgs==9.16.0
12
26
  httpx==0.28.1
13
- openai==2.45.0
14
- # NOTE (ROADMAP_v2 §16): this pin has no ThinkingConfig.thinking_budget --
15
- # that field arrived in a later release. core/client.py checks for it at
16
- # runtime and reports no effort levels on GOOGLE rather than sending a
17
- # field the SDK cannot carry. Moving this pin enables Google effort; it
18
- # also puts §9's verified Google implementation back in scope for retest.
19
- google-genai==1.0.0
20
- pydantic==2.13.4
21
- sympy==1.13.3
22
- sqlmodel==0.0.39
23
- python-dotenv==1.2.2
24
- matplotlib==3.10.3
27
+ openai==3.36.0
28
+ # ROADMAP_v3 §82 (GS1), batch 172: 1.0.0 -> 2.29.0, the owner's choice.
29
+ # Gemini 3 refuses a request whose current turn holds a function call
30
+ # without the thought signature it came with; 1.0.0's Part had no field
31
+ # to hold one, and every model a new Google account can call is Gemini 3,
32
+ # so every GOOGLE tool loop failed on its second request. 2.29.0 was the
33
+ # newest release at least two weeks old when chosen. It also carries
34
+ # ThinkingConfig.thinking_budget, which core/client.py checks for at
35
+ # runtime, so Google reasoning effort is ON now (ROADMAP_v2 §16), and
36
+ # §9's Google implementation was retested live against it. Its
37
+ # transport is httpx now, not requests. 2.32.0 since batch 234, the newest
38
+ # release at least two weeks old; test_sdk_conformance.py is the evidence,
39
+ # with no live Gemini call (no key on this machine).
40
+ google-genai==2.32.0
41
+ # Batch 208, from Dependabot's group, the owner's choice of which: the
42
+ # packages below are ones the suite runs for real rather than faking, so
43
+ # a green suite is evidence about them, and each release was at least two
44
+ # weeks old. pydantic 2.14.0 fixed GHSA-gj4f-r7mf-jjxh (an unbounded
45
+ # Fraction exponent) and GHSA-955g-x97g-8mcp (quadratic multi-host URL
46
+ # validation). sympy 1.14.0 gives test_math_tools.py's measured expansion
47
+ # the same 74,723 characters 1.13.3 did.
48
+ #
49
+ # NO matplotlib SINCE BATCH 212, the owner's choice. It drew one bar chart
50
+ # per research run, and with numpy, fonttools, pillow and seven smaller
51
+ # packages it was 126 MB of a 367 MB install, measured in a fresh venv;
52
+ # core/reasoning/output_writer.py draws the chart as SVG with the standard
53
+ # library now. pillow's floor (batch 201) went with it: nothing else here
54
+ # reaches pillow.
55
+ pydantic==2.14.1
56
+ sympy==1.14.0
57
+ # 0.0.48 since batch 234: test_storage_e2e.py runs it for real.
58
+ sqlmodel==0.0.48
59
+ python-dotenv==1.2.4
25
60
  pyyaml==6.0.3
26
- # ROADMAP_v2 §16 TUI. Upper-bounded per D22 -- the mcp lesson was that an
27
- # unpinned dependency mid-major-version-transition migrates you by accident.
28
- textual>=1.0,<2.0
61
+ # config.yaml, via config_schema.py. TWO YAML PARSERS IN ONE TREE IS
62
+ # DELIBERATE -- do not "unify" them. pyyaml above parses agent/skill
63
+ # frontmatter, where nothing is ever written back and ~70 tests pin the
64
+ # behaviour; ruamel is here for the half pyyaml cannot do, which is
65
+ # preserving a hand-authored file's comments across a WRITE. Since batch 84
66
+ # two modules do exactly that -- config_edit.py behind /config, and
67
+ # config_update.py putting a user's values back after an npm update replaces
68
+ # the file -- while the IMPORT path still uses typ="safe". (This said
69
+ # "nothing writes config.yaml yet ... this pin is bought for the config
70
+ # editor that will", which those batches made false.)
71
+ #
72
+ # EXACT, for the reason `mcp` and `textual` are exact: an upper bound lets a
73
+ # MINOR change behaviour underneath CI and makes CI's result depend on when
74
+ # it ran. Two facts to re-measure when this pin moves: 0.18 REMOVED the
75
+ # module-level `load()` / `safe_load()` functions, so the `YAML()` object API
76
+ # is the only one, and `typ="safe"` is what refuses `!!python/...` tags in a
77
+ # file that decides the tool permissions.
78
+ ruamel.yaml==0.19.1
79
+ # ROADMAP_v2 §16 TUI. EXACT, and this comment is textual's OWN record
80
+ # rather than a line borrowed from D22's, which is about `mcp`. The
81
+ # `>=1.0,<2.0` it replaces was written BEFORE 2.0 existed -- 1.0.0 shipped
82
+ # 2024-12-12 and 2.0.0 on 2025-02-16 -- so it was a
83
+ # don't-migrate-me-by-accident ceiling and never a judgement about 2.x.
84
+ # Nothing in the repo had evaluated 2.x, and the ceiling then sat there
85
+ # for twenty months while upstream reached 8.2.8.
86
+ #
87
+ # Exact for the reason batch 32 made `mcp` exact: an upper bound stops a
88
+ # MAJOR and lets a MINOR change behaviour underneath CI, which makes CI's
89
+ # result depend on when it ran.
90
+ #
91
+ # Moving it again is a deliberate step. Each of these was verified in hand
92
+ # against the installed package rather than read from a changelog, and
93
+ # each is what to re-measure next time:
94
+ # * `Static.renderable` is `.content` since 6.0.0 (`.visual` is the
95
+ # rendered form). 43 sites across 8 test files read it.
96
+ # * `Static.update` sends a Rich `Text` through `visualize()`, which
97
+ # converts it with `console=widget.app.console` -- so updating an
98
+ # UNMOUNTED widget raises NoActiveAppError, and the suite builds these
99
+ # panels bare everywhere. `tui.widgets.as_content` is the answer.
100
+ # The conversion also drops `no_wrap` / `overflow`, silently; those
101
+ # are `text-wrap` / `text-overflow` in app.tcss now.
102
+ # * Textual markup replaced Rich markup at 2.0.0, and `markup=False` IS
103
+ # honoured now -- on 1.0.0 it was stored and never read, which is what
104
+ # tui/screens.py's `Text(...)` rule was written against (RA1).
105
+ # * `textual-ansi` is GONE. `ansi-dark` / `ansi-light` replaced it at
106
+ # 8.2.5, `Theme` grew an `ansi: bool`, and the built-in roster is 21
107
+ # rather than 12 -- so SELECTABLE_THEMES in tests/test_themes.py, and
108
+ # every documented test count, moves with the pin.
109
+ # * `dim` is resolved into the drawn COLOUR now instead of reaching the
110
+ # cell as an attribute, which is what a test reading a drawn style
111
+ # off the compositor sees.
112
+ # * The kitty keyboard protocol reaches the WINDOWS driver since 6.6.0.
113
+ # Batch 54's `shift+enter` note was written against its absence.
114
+ # Then re-run the TUI pilots dependabot.yml names -- ~410 run_test sites.
115
+ textual==8.2.8
29
116
 
30
117
  # Imported DIRECTLY at tui/widgets.py:8-9 (`rich.syntax.Syntax`,
31
118
  # `rich.text.Text`) and previously undeclared -- present only because
@@ -33,7 +120,9 @@ textual>=1.0,<2.0
33
120
  # chosen by whatever textual's own range resolved to. Upper-bounded per D22
34
121
  # for D22's own reason, and this was the one package the project imported
35
122
  # without declaring, i.e. the one place such a migration would be silent.
36
- rich>=13,<16
123
+ # The FLOOR is textual's, not a guess: 8.2.8 requires `rich>=14.2.0`, so
124
+ # `>=13` stated a version this project can no longer be installed with.
125
+ rich>=14.2,<16
37
126
 
38
127
  # ROADMAP_v2 §17 MCP client. Upper-bounded per D22 -- and D22 exists
39
128
  # BECAUSE of this package: it was mid-major-version transition when §17
@@ -44,8 +133,10 @@ rich>=13,<16
44
133
  # .is_error, was camelCase), timeouts are float seconds (was timedelta),
45
134
  # the exception is MCPError (was McpError), streamablehttp_client is
46
135
  # removed, and httpx/httpx-sse are replaced by httpx2 -- which is why
47
- # there are now two HTTP stacks installed. httpx stays; anthropic, openai
48
- # and ddgs all still need it.
136
+ # there are now two HTTP stacks installed. httpx stays: the harness imports
137
+ # it itself (fetch_url, arxiv, scholar, /connect, the hosted sign-in) and
138
+ # google-genai needs it. Since batch 234 anthropic and openai are on httpx2
139
+ # too, and ddgs needs neither (measured with `pip show` in a fresh venv).
49
140
  # EXACT, not the `>=2.0,<3` range this used to carry (batch 32, CI run
50
141
  # 32778904550). D22's upper bound did its job -- no major migration -- but a
51
142
  # MINOR still changed observable behaviour underneath it: 2.1.0 stopped
@@ -60,13 +151,145 @@ rich>=13,<16
60
151
  # raising ToolError on purpose keeps its message, a tool that CRASHES has
61
152
  # its text withheld -- and re-run tests/test_mcp_client.py, which is written
62
153
  # to hold on both versions.
63
- mcp==2.0.0
154
+ #
155
+ # 2.2.0 SINCE BATCH 165's follow-up, for CVE-2026-59951: a Streamable HTTP
156
+ # SERVER kept every session's state with no expiry and no cap, so a client
157
+ # could grow its memory without bound. This harness is an MCP client and
158
+ # serves nothing, so it was never exposed -- the bump is because pip-audit
159
+ # fails on any advisory, and a fix existed. Taken the deliberate way, the
160
+ # split read first: 2.1.0 withholds a crashed tool's text and drops
161
+ # outputSchema/structuredContent for tools that return content blocks;
162
+ # 2.2.0 follows redirects only within the same origin (or http -> https on
163
+ # one host) and no longer honours a passed-in client's follow_redirects.
164
+ # Neither touches what this client does. test_mcp_client.py,
165
+ # test_mcp_config.py and the integration servers all pass on it, and
166
+ # mcp-types moves with it in lockstep.
167
+ #
168
+ # 2.3.0 SINCE BATCH 208, the deliberate way again. Its release notes'
169
+ # behaviour changes, against this client: httpx2 >=2.10.0 is required
170
+ # (it was 2.5.0); a 2025-11-25-or-earlier connection no longer sends an
171
+ # empty `_meta` or `params`, and `initialize` leaves `experimental` out,
172
+ # neither of which mcp_client/ sends or reads; a call the server rejects
173
+ # with HeaderMismatch is re-listed and retried once, and a rejected call
174
+ # never ran. ONE MORE CHANGE DOES TOUCH IT, which the notes' "the default
175
+ # stays 1 MiB" hides: on 2.2.0's httpx2 a streamed answer had no size limit,
176
+ # and 2.3.0 fails a call whose one server-sent event passes
177
+ # `max_sse_event_size`, 1 MiB by default, which a streamed screenshot does.
178
+ # The owner chose 16 MiB, as config.yaml's `mcp_max_event_bytes`;
179
+ # CONFIG_ARCHITECTURE.md has the measurement and what it does not cover.
180
+ # The registration fact in mcp_client/registration.py was re-measured on
181
+ # it.
182
+ mcp==2.3.0
183
+
184
+ # ROADMAP_v3 §49 (SS8). The engine for a monitor session's pattern -- a
185
+ # regex the MODEL wrote, matched against program output nobody controls,
186
+ # inside the harness's own process. Imported by core/line_pattern.py and
187
+ # nowhere else.
188
+ #
189
+ # NOT the stdlib `re`, and the reason was measured: `re` holds the GIL for
190
+ # the whole match, so `(a+)+$` against 25 a's and a `b` froze EVERY thread
191
+ # for 1.9 s -- the TUI's included -- and each extra character doubles it.
192
+ # RE2 matches in linear time, releases the GIL, and refuses backreferences
193
+ # and lookaround at compile time, so the agent is told instead of the
194
+ # harness hanging.
195
+ #
196
+ # EXACT, for the reason textual and mcp are exact. BSD-3-Clause; wheels
197
+ # for cp310-cp314 on Windows (x64, x86, arm64), macOS 13-15 (arm64,
198
+ # x86_64) and manylinux_2_28 (x86_64, aarch64). There is NO wheel for musl
199
+ # (Alpine) or glibc older than 2.28, where pip builds the sdist and needs a
200
+ # C++ toolchain and Abseil. Another package ships a module named `re2`
201
+ # that falls back to `re`, which is why core/line_pattern.py refuses a
202
+ # `re2` from any other distribution. What to re-measure when this moves:
203
+ # `re2.Options` still has `log_errors` and `max_mem`; a compile error is
204
+ # still `re2.error` and still silent with `log_errors = False` (it writes
205
+ # to stderr through Abseil otherwise, which paints over Textual); and the
206
+ # wheel list above.
207
+ google-re2==1.1.20251105
208
+
209
+ # ROADMAP_v3 §49 slice 5a (SS57). AES-256-GCM for the harness-held secret
210
+ # store, and scrypt is the stdlib's -- `hashlib` has the KDF and no cipher,
211
+ # so this is the dependency or a hand-rolled AEAD, and this repository
212
+ # ships a `cryptography-verification` skill whose whole subject is not
213
+ # doing the second one.
214
+ #
215
+ # DECLARING IT ADDS NOTHING TO AN INSTALL, measured rather than assumed:
216
+ # google-genai==1.0.0 -> google-auth>=2.14.1 -> cryptography>=38.0.3, with
217
+ # no extra marker, so it is already in the hard closure of the line above.
218
+ # Re-measured on the 2.29.0 pin (batch 172): google-auth>=2.56.0 ->
219
+ # cryptography>=38.0.3 (>=41.0.5 on Python 3.14), still no extra marker.
220
+ # What the declaration buys is that a dependency this project's SECURITY
221
+ # rests on is pinned by this project rather than by whatever google-auth
222
+ # happens to resolve to.
223
+ #
224
+ # Apache-2.0 OR BSD-3-Clause -- permissive, so THIRD_PARTY_NOTICES.md's
225
+ # no-copyleft claim still holds. It is the SECOND dependency shipping
226
+ # compiled native code (google-re2 was the first): the wheels carry a Rust
227
+ # extension and OpenSSL, and that file's paragraph names both now.
228
+ #
229
+ # A FLOOR AND A CEILING rather than an exact pin, like `rich`: an exact pin
230
+ # here would fight google-auth's own floor on a resolver that has to
231
+ # satisfy both. The ceiling is D22's rule, so a MAJOR cannot change
232
+ # behaviour underneath CI. The floor was the AEAD API this uses, stable
233
+ # since 3.x, until batch 208 raised it to 50.0.0 for the reason batch
234
+ # 201 floored pillow (a floor batch 212 removed with matplotlib): pip leaves an installed package alone while it still satisfies
235
+ # the range, and 42.0 through 49.x carry between 15 and 2 known
236
+ # advisories (OSV, measured 2026-10-31), so a venv built earlier kept
237
+ # one. 50.0.0 is the first release with none. What to re-measure when it
238
+ # moves: `AESGCM` still raises `cryptography.exceptions.InvalidTag` with NO
239
+ # message (the store relies on the three failure causes being
240
+ # indistinguishable), and the wheel list still covers this project's
241
+ # platforms.
242
+ cryptography>=50.0.0,<52
243
+
244
+ # ROADMAP_v3 §83 (CG6, CG16). Checks the ID token a ChatGPT-plan sign-in
245
+ # returns against OpenAI's published keys: RS256, issuer, audience, expiry
246
+ # and nonce. The owner chose declaring it over a hand-written RS256 check
247
+ # on `cryptography` -- signature verification is code to get exactly right,
248
+ # and this library is the one everybody else gets it right with.
249
+ #
250
+ # DECLARING IT ADDS NOTHING TO AN INSTALL, measured the way `cryptography`'s
251
+ # entry was: mcp==2.3.0 -> pyjwt[crypto]>=2.10.1, with no marker, so it is
252
+ # already in the hard closure of the mcp line above. What the declaration
253
+ # buys is that a check this project's sign-in rests on no longer depends on
254
+ # mcp happening to pull it in. MIT, so THIRD_PARTY_NOTICES.md's no-copyleft
255
+ # claim holds; pure Python.
256
+ #
257
+ # A FLOOR AND A CEILING, for `cryptography`'s reason: an exact pin here
258
+ # would fight mcp's own floor, `>=2.10.1`. The ceiling is D22's rule. The
259
+ # floor was mcp's until batch 208 raised it to 2.15.0, for `cryptography`'s
260
+ # reason above: the owner's venv held 2.13.0, which the old floor allowed and
261
+ # which carries 29 known advisories (OSV, measured 2026-10-31), two of
262
+ # them in exactly the calls core/chatgpt_auth.py makes -- a RecursionError
263
+ # out of `jwt.decode` on a deeply nested header (GHSA-8wjv-2p76-3863), and
264
+ # one malformed RSA key aborting a whole `PyJWKSet` (GHSA-w6j9-cwv2-h6wq).
265
+ # 2.15.0 is the first release with none. What to re-measure when it
266
+ # moves: `jwt.decode` still refuses an algorithm outside the list it is
267
+ # given (the `none` and HS256 tests in tests/test_chatgpt_auth.py), and
268
+ # `PyJWKSet` still reads OpenAI's JWKS.
269
+ PyJWT>=2.15.0,<3
270
+
271
+ # TECHNICAL_DEBT 18, batch 116. A PRODUCTION dependency: `arxiv.py` imports
272
+ # it at module load, and pyproject.toml reads this file for its dependency
273
+ # list via `dynamic = ["dependencies"]`.
274
+ #
275
+ # THE TIDY THIS COMMENT WARNED ABOUT HAS NOW HAPPENED, and the warning was
276
+ # right about the risk and wrong about the mechanism. It said a tidy of the
277
+ # test block "would drop it from the shipped set", as though the shipped set
278
+ # were something other than this file -- it was not, which is why the test
279
+ # block itself shipped. Batch 136 (S18-07) moved that block to
280
+ # requirements-test.txt, so the distinction is real now and defusedxml is
281
+ # unambiguously on the shipped side of it. It stayed because this paragraph
282
+ # said why; that is the comment earning its place rather than the claim it
283
+ # happened to get wrong.
284
+ #
285
+ # stdlib ElementTree expands declared entities on a feed this project does
286
+ # not write (Bandit B405/B314). Pinned exactly rather than floored, the way
287
+ # textual is: item 18 asks for "version-pinned re-verification", and a
288
+ # parser's refusals are exactly what a silent minor bump could change.
289
+ defusedxml==0.7.1
64
290
 
65
- # --- Test dependencies -------------------------------------------------
66
- # Previously absent, which the docs recorded as a known open item since
67
- # §14: the suite has always needed pytest and pytest-mock, and §16's TUI
68
- # pilot tests add pytest-asyncio. Listed now so `pip install -r` produces
69
- # a working suite instead of one that fails at import.
70
- pytest>=8.0
71
- pytest-mock>=3.14
72
- pytest-asyncio>=1.0
291
+ # Test dependencies live in requirements-test.txt, NOT here (S18-07,
292
+ # batch 136). pyproject.toml reads THIS file for `[project].dependencies`
293
+ # via `dynamic`, so anything below this line is a hard requirement of the
294
+ # published package and of every end user's venv. Install the suite's own
295
+ # packages with `pip install -r requirements-test.txt`.