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.
- package/README.audit.md +14 -15
- package/README.remediate.md +13 -14
- package/dist/audit/extractors/designAssessment.d.ts.map +1 -1
- package/dist/audit/extractors/designAssessment.js +31 -128
- package/dist/audit/extractors/designAssessment.js.map +1 -1
- package/dist/audit/extractors/graphSignals.d.ts +63 -0
- package/dist/audit/extractors/graphSignals.d.ts.map +1 -0
- package/dist/audit/extractors/graphSignals.js +134 -0
- package/dist/audit/extractors/graphSignals.js.map +1 -0
- package/dist/audit/extractors/risk.d.ts +2 -1
- package/dist/audit/extractors/risk.d.ts.map +1 -1
- package/dist/audit/extractors/risk.js +21 -2
- package/dist/audit/extractors/risk.js.map +1 -1
- package/dist/audit/orchestrator/structureExecutors.d.ts.map +1 -1
- package/dist/audit/orchestrator/structureExecutors.js +3 -1
- package/dist/audit/orchestrator/structureExecutors.js.map +1 -1
- package/dist/remediate/steps/dispatch.d.ts +12 -0
- package/dist/remediate/steps/dispatch.d.ts.map +1 -1
- package/dist/remediate/steps/dispatch.js +27 -3
- package/dist/remediate/steps/dispatch.js.map +1 -1
- package/dist/remediate/steps/nextStep.d.ts.map +1 -1
- package/dist/remediate/steps/nextStep.js +14 -6
- package/dist/remediate/steps/nextStep.js.map +1 -1
- package/dist/remediate/steps/prompts.d.ts.map +1 -1
- package/dist/remediate/steps/prompts.js +14 -9
- package/dist/remediate/steps/prompts.js.map +1 -1
- package/docs/audit-pkg/contracts.md +1 -1
- package/docs/audit-pkg/development.md +5 -6
- package/docs/audit-pkg/operator-guide.md +7 -7
- package/docs/audit-pkg/product.md +2 -2
- package/package.json +1 -1
- package/skills/audit-code/SKILL.md +4 -5
- package/skills/audit-code/audit-code.prompt.md +5 -6
- package/skills/remediate-code/SKILL.md +2 -2
- package/docs/audit-pkg/history.md +0 -66
package/package.json
CHANGED
|
@@ -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
|
|
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 `
|
|
136
|
-
`
|
|
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
|
|
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 `
|
|
21
|
-
`
|
|
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
|
|
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 `
|
|
66
|
+
When developing `audit-tools` itself, from the repo root use:
|
|
68
67
|
|
|
69
68
|
```bash
|
|
70
|
-
node
|
|
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
|
|
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 `
|
|
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.
|