audit-tools 0.28.10 → 0.29.1

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 (35) hide show
  1. package/README.audit.md +14 -15
  2. package/README.remediate.md +13 -14
  3. package/dist/audit/extractors/designAssessment.d.ts.map +1 -1
  4. package/dist/audit/extractors/designAssessment.js +31 -128
  5. package/dist/audit/extractors/designAssessment.js.map +1 -1
  6. package/dist/audit/extractors/graphSignals.d.ts +63 -0
  7. package/dist/audit/extractors/graphSignals.d.ts.map +1 -0
  8. package/dist/audit/extractors/graphSignals.js +134 -0
  9. package/dist/audit/extractors/graphSignals.js.map +1 -0
  10. package/dist/audit/extractors/risk.d.ts +2 -1
  11. package/dist/audit/extractors/risk.d.ts.map +1 -1
  12. package/dist/audit/extractors/risk.js +21 -2
  13. package/dist/audit/extractors/risk.js.map +1 -1
  14. package/dist/audit/orchestrator/structureExecutors.d.ts.map +1 -1
  15. package/dist/audit/orchestrator/structureExecutors.js +3 -1
  16. package/dist/audit/orchestrator/structureExecutors.js.map +1 -1
  17. package/dist/remediate/steps/dispatch.d.ts +12 -0
  18. package/dist/remediate/steps/dispatch.d.ts.map +1 -1
  19. package/dist/remediate/steps/dispatch.js +27 -3
  20. package/dist/remediate/steps/dispatch.js.map +1 -1
  21. package/dist/remediate/steps/nextStep.d.ts.map +1 -1
  22. package/dist/remediate/steps/nextStep.js +14 -6
  23. package/dist/remediate/steps/nextStep.js.map +1 -1
  24. package/dist/remediate/steps/prompts.d.ts.map +1 -1
  25. package/dist/remediate/steps/prompts.js +14 -9
  26. package/dist/remediate/steps/prompts.js.map +1 -1
  27. package/docs/audit-pkg/contracts.md +1 -1
  28. package/docs/audit-pkg/development.md +5 -6
  29. package/docs/audit-pkg/operator-guide.md +7 -7
  30. package/docs/audit-pkg/product.md +2 -2
  31. package/package.json +1 -1
  32. package/skills/audit-code/SKILL.md +4 -5
  33. package/skills/audit-code/audit-code.prompt.md +5 -6
  34. package/skills/remediate-code/SKILL.md +2 -2
  35. package/docs/audit-pkg/history.md +0 -66
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "audit-tools",
3
- "version": "0.28.10",
3
+ "version": "0.29.1",
4
4
  "private": false,
5
5
  "description": "Portable hybrid code auditing + remediation orchestrators for arbitrary repositories.",
6
6
  "type": "module",
@@ -98,7 +98,7 @@ The prompt payload in `audit-code.prompt.md` remains the canonical instruction a
98
98
  The intended user setup is one global package install:
99
99
 
100
100
  ```bash
101
- npm install -g auditor-lambda
101
+ npm install -g audit-tools
102
102
  ```
103
103
 
104
104
  That makes `audit-code` available on `PATH` and seeds user-level command/skill
@@ -132,12 +132,11 @@ audit-code
132
132
 
133
133
  from the target repository root.
134
134
 
135
- When developing `auditor-lambda` itself, prefer the local wrapper at
136
- `packages/audit-code/audit-code.mjs` (there is no `audit-code.mjs` at the
137
- monorepo root):
135
+ When developing `audit-tools` itself, prefer the local wrapper at
136
+ `audit-code.mjs` (at the repo root):
138
137
 
139
138
  ```bash
140
- node packages/audit-code/audit-code.mjs # from the monorepo root
139
+ node audit-code.mjs # from the repo root
141
140
  ```
142
141
 
143
142
  That keeps the run pinned to the local wrapper and local `dist/` output instead
@@ -17,12 +17,11 @@ First, make sure the repository has current local audit assets:
17
17
  audit-code ensure --quiet
18
18
  ```
19
19
 
20
- When developing `auditor-lambda` itself, the entrypoint lives at
21
- `packages/audit-code/audit-code.mjs` (there is no `audit-code.mjs` at the
22
- monorepo root). From the monorepo root use:
20
+ When developing `audit-tools` itself, the entrypoint lives at
21
+ `audit-code.mjs` (at the repo root). From the repo root use:
23
22
 
24
23
  ```bash
25
- node packages/audit-code/audit-code.mjs ensure --quiet
24
+ node audit-code.mjs ensure --quiet
26
25
  ```
27
26
 
28
27
  Then ask the backend for exactly one next step. This is also the **capability
@@ -64,10 +63,10 @@ lower it under rate-limit pressure. The backend's learned quota adapts from
64
63
  there. The token values should match the window of the model(s) dispatching the
65
64
  packets (e.g. 200000 / 32000 for a 200k-context model).
66
65
 
67
- When developing `auditor-lambda` itself, from the monorepo root use:
66
+ When developing `audit-tools` itself, from the repo root use:
68
67
 
69
68
  ```bash
70
- node packages/audit-code/audit-code.mjs next-step --host-max-active-subagents 4 --host-context-tokens 200000 --host-output-tokens 32000
69
+ node audit-code.mjs next-step --host-max-active-subagents 4 --host-context-tokens 200000 --host-output-tokens 32000
71
70
  ```
72
71
 
73
72
  Read the returned JSON only far enough to find `prompt_path`, then read and
@@ -51,7 +51,7 @@ instruction asset.
51
51
  The intended user setup is one global package install:
52
52
 
53
53
  ```bash
54
- npm install -g remediator-lambda
54
+ npm install -g audit-tools
55
55
  ```
56
56
 
57
57
  That makes `remediate-code` available on `PATH` and seeds user-level
@@ -76,7 +76,7 @@ bootstrap.
76
76
 
77
77
  ## Repo-local fallback
78
78
 
79
- When developing inside the `remediator-lambda` repository itself, prefer:
79
+ When developing inside the `audit-tools` repository itself, prefer:
80
80
 
81
81
  ```bash
82
82
  node remediate-code.mjs
@@ -1,66 +0,0 @@
1
- # History
2
-
3
- This page keeps short archival context that used to live in several
4
- phase-specific documents. It is not the current roadmap or release gate.
5
-
6
- ## Field-trial lessons
7
-
8
- Earlier real-repository runs surfaced issues around:
9
-
10
- - completion detection
11
- - worker launch failures
12
- - result ingestion validation
13
- - command hangs without progress
14
- - requeue task explosion
15
- - evidence schema ambiguity
16
- - noisy runtime placeholders
17
- - weak root-cause clustering
18
- - missing work-block presentation
19
- - unenforceable reviewed ranges
20
-
21
- Most of those findings have dedicated regression coverage now. The durable
22
- lesson is that failure states should be explicit, schema validation should be
23
- field-level, and packetization should optimize for coherent review context
24
- rather than raw worker-count reduction alone.
25
-
26
- ## Remediation baseline
27
-
28
- The old remediation baseline recorded fixes across:
29
-
30
- - CI and release smoke coverage
31
- - extractor path handling
32
- - schema-contract validation
33
- - orchestration state handling
34
- - provider and supervisor behavior
35
- - CLI and IO robustness
36
- - reporting and synthesis behavior
37
- - generated install payload parity
38
-
39
- Current readiness is tracked in `docs/product.md`, `docs/operator-guide.md`,
40
- `docs/contracts.md`, `docs/release.md`, and `docs/development.md`.
41
-
42
- ## Monorepo migration & drift reconciliation (2026-05 → 2026-06)
43
-
44
- The auditor and remediator began as standalone repos (`auditor-lambda`,
45
- `remediator-lambda`) and were merged into this npm-workspaces monorepo on a
46
- shared `@audit-tools/shared` foundation. `providers/` and `quota/` had been
47
- copy-pasted into both tools and forked in place; the ten resulting drift bugs
48
- were all fixed by centralizing the forked logic into `shared` (one source of
49
- truth). Durable decisions from that work:
50
-
51
- - **Access scoping is JSON, not MCP.** `AccessDeclaration` rides on the step
52
- contract, so it works with any host; the MCP servers stay compatibility
53
- adapters over the same contract.
54
- - **`--dangerously-skip-permissions` defaults ON for the remediator, OFF for the
55
- auditor.** The remediator applies changes unattended and cannot pause; the
56
- auditor is read-only. The asymmetry is intentional and the flag is overrideable.
57
- - **The remediator's machine input is `audit-findings.json`, not the Markdown
58
- report.** `audit-report.md` is human-facing; a Markdown file handed to the
59
- remediator flows through the free-form LLM extractor, not a deterministic parse.
60
- - **Prompts use one strict path** — no "or / unless / if-available" fallbacks.
61
-
62
- Large files were then broken up as behaviour-preserving pure moves (`cli.ts` from
63
- 4072 lines to a thin dispatcher plus `src/cli/*` handlers; `graph.ts`,
64
- `reviewPackets.ts`, `internalExecutors.ts`, and the generated language table all
65
- split out). The sprint-by-sprint handoff docs that tracked this work were removed
66
- once shipped; this section is their durable residue.