qaas-python 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

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.
qaas/registry.py CHANGED
@@ -14,8 +14,29 @@ import re
14
14
  from pathlib import Path, PurePosixPath
15
15
  from typing import Any, Callable, Sequence
16
16
 
17
+ import warnings
18
+
17
19
  from claude_agent_sdk import ClaudeAgentOptions, HookMatcher
18
20
 
21
+ # The SDK warns that an `allowed_tools` entry auto-approves a tool before
22
+ # `can_use_tool` is consulted. That warning is correct and this codebase acted
23
+ # on it long ago: enforcement lives in the PreToolUse hook, which sees every
24
+ # call, and `can_use_tool` is kept only as a second layer for calls the
25
+ # allowlist did not auto-approve. See the module docstring in `guardrails.py` --
26
+ # an early version really did have that bug, and FORGE's sandbox check was dead
27
+ # code because of it.
28
+ #
29
+ # So the warning describes a hazard we already removed, and it fired on every
30
+ # single agent dispatch: eight lines of alarming red before a run that is
31
+ # working correctly. Silenced here, next to the reason, rather than by the
32
+ # caller -- a user should not have to learn which of our warnings to ignore.
33
+ try: # pragma: no cover - depends on the installed SDK exposing the class
34
+ from claude_agent_sdk.types import CanUseToolShadowedWarning
35
+
36
+ warnings.filterwarnings("ignore", category=CanUseToolShadowedWarning)
37
+ except ImportError: # the SDK renamed or dropped it; nothing to silence
38
+ pass
39
+
19
40
  from qaas.config import AgentSpec
20
41
  from qaas.guardrails import ALWAYS_GRANTED, Guardrail
21
42
  from qaas.mcp.context import ToolContext
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: qaas-python
3
- Version: 0.3.0
3
+ Version: 0.3.2
4
4
  Summary: A multi-agent QA system: finds real defects, reproduces them, files tickets, fixes them, and proves the fix
5
5
  Project-URL: Homepage, https://github.com/allaabdella2-us/qa-multi-agent-system
6
6
  Project-URL: Repository, https://github.com/allaabdella2-us/qa-multi-agent-system
@@ -310,32 +310,28 @@ the refusal and adapts.
310
310
 
311
311
  ---
312
312
 
313
- ## 📈 Benchmarks, honestly
313
+ ## 📈 How you know it works
314
314
 
315
- Against the bundled demo app and its golden ledger:
315
+ `qaas` ships with a **deliberately buggy demo app** and a golden ledger recording
316
+ every defect seeded into it — plus **planted non-defects**: correct-but-suspicious
317
+ code that a careless reader would report.
316
318
 
317
- Two runs against the demo app, scored automatically:
318
-
319
- | metric | run A (full loop) | run B (discovery only) |
320
- |---|--:|--:|
321
- | 🎯 recall | **81%** — 13 of 16 | **69%** — 11 of 16 |
322
- | 🔇 precision | **100%** — 0 FP | **92%** — 1 FP |
323
- | 🏷️ severity agreement | **100%** | **100%** |
324
-
325
- **Both numbers are shown on purpose.** A single figure would be the flattering
326
- one, and it would not survive contact with a second run. These are stochastic
327
- agents: the two runs did not find the same 11–13 defects — run B caught a
328
- contrast failure run A missed, and missed three run A found. Expect variance of
329
- this order.
319
+ ```bash
320
+ cd target-app && docker compose up -d
321
+ qaas run --mode nightly && qaas score
322
+ ```
330
323
 
331
- The ledger's `not_defects` section plants **correct-but-suspicious** code, so
332
- precision is measured rather than assumed.
324
+ `qaas score` reports recall, precision and severity agreement against that
325
+ ledger. That matters more than any number this page could print: it means a
326
+ change to a prompt, a threshold or a model has **a measurement attached** rather
327
+ than an opinion.
333
328
 
334
329
  > [!CAUTION]
335
- > **Treat this as a floor, not a proof.** Seeded defects are easier than real
336
- > ones and the system was calibrated against them. Two runs is not a sample.
337
- > These numbers show the loop works end to end and does not spray false
338
- > positives — not that it will find the hard bug in your codebase.
330
+ > **Seeded defects are easier than real ones**, and this system was calibrated
331
+ > against them. A benchmark shows the loop works end to end and does not spray
332
+ > false positives. It does not show that it will find the hard bug in your
333
+ > codebase. Run it on something you know well and judge it on what it finds
334
+ > there.
339
335
 
340
336
  ---
341
337
 
@@ -377,6 +373,6 @@ point, the five phases, what moves between agents, and what the guardrails stop.
377
373
 
378
374
  <div align="center">
379
375
 
380
- **MIT licensed** · [LICENSE](LICENSE) · Built on the [Claude Agent SDK](https://docs.claude.com/en/api/agent-sdk/overview)
376
+ **MIT licensed** · [LICENSE](LICENSE)
381
377
 
382
378
  </div>
@@ -5,7 +5,7 @@ qaas/discover.py,sha256=L5ejBsYs_s41OWAL-Dhc8VlQ5EWw2hGayWTDzfj05R8,8524
5
5
  qaas/envelope.py,sha256=IiqyOy96CHZw2A0pSDWBNIg6yQ2MzfcwkpQWmgMNvzY,9095
6
6
  qaas/guardrails.py,sha256=4JIQGFnQpQeIU92c2_E7PQFwXBnQnzolurwp6Zf-Cnk,18797
7
7
  qaas/paths.py,sha256=NdW0kDqLXBSASIhp5xFSmMijYPU5tNknKdLj1AUp2to,12703
8
- qaas/registry.py,sha256=D58UXtYi3uPpW7x6yVDBuEO2azHb2NCqtpYLJleWS54,19664
8
+ qaas/registry.py,sha256=V6-405Ka-ntRMhFHwMeMKq1jlrLqwiore_CKGBBaytw,20770
9
9
  qaas/runner.py,sha256=ED0arzgx0_Y6R_mcG6OXqzh3GeSOpqVUNa4NJ0QcRk8,7417
10
10
  qaas/scorecard.py,sha256=aUU7g5OtXIW4752A4NxpIZH-OdC8bpNtzJUvCi41JYg,15809
11
11
  qaas/sdk_compat.py,sha256=ftE6PK0jZY85zkYqS7UJTGYwRkYDlH4NspiKbKVfVXQ,1678
@@ -88,8 +88,8 @@ qaas/prompts/USHER.md,sha256=HfJxJMQym81qHHMy3Tyv5YeeTbvU9iTFWCMgeasyzpM,5144
88
88
  qaas/prompts/VAULT.md,sha256=Ansowimx-wMbinQkn9_gGgZFmvmMFMc9v_N8s2Ahws4,2915
89
89
  qaas/prompts/WARDEN.md,sha256=39KsbwWRwe7mtjYEik1owBIDgu4qyD52UHG_T_7gTMw,2950
90
90
  qaas/prompts/_shared.md,sha256=lN_s_rAmakhGuyRuWItC--iyy-Er6ohT_dzGeE_g-fo,2620
91
- qaas_python-0.3.0.dist-info/METADATA,sha256=o5hYJ_s-_JY-K-2ix_KBIvKtSePyleiTj-KiFoYeC90,16769
92
- qaas_python-0.3.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
93
- qaas_python-0.3.0.dist-info/entry_points.txt,sha256=6UScfruyhP9N_xGx3tXJGkaoAiB36dkINuKyOH6OkK4,38
94
- qaas_python-0.3.0.dist-info/licenses/LICENSE,sha256=pHWke5oMtv7PLjIQbN6hRa31J0AKj51VCd5TCTUbbX0,1069
95
- qaas_python-0.3.0.dist-info/RECORD,,
91
+ qaas_python-0.3.2.dist-info/METADATA,sha256=IgEwLQXmnu1Qs68t5hXgac4qmsuN1mJLvulKj0VzQr8,16455
92
+ qaas_python-0.3.2.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
93
+ qaas_python-0.3.2.dist-info/entry_points.txt,sha256=6UScfruyhP9N_xGx3tXJGkaoAiB36dkINuKyOH6OkK4,38
94
+ qaas_python-0.3.2.dist-info/licenses/LICENSE,sha256=pHWke5oMtv7PLjIQbN6hRa31J0AKj51VCd5TCTUbbX0,1069
95
+ qaas_python-0.3.2.dist-info/RECORD,,