Skip to content

Commit 0d89586

Browse files
docs: complete audience→axial rename drift in man page + docs (#137)
The `audience` subcommand/module/A2ML-kind was renamed to `axial` in 1d95bab, but the man page and two docs were not swept — leaving a removed subcommand documented and a dangling `src/audience/mod.rs` path. This is the genuine structural drift Hypatia's SD022 should have caught; instead it false-flagged the valid `src/aggregate/` (that directory exists and is wired — a false positive). ## Changes - `man/panic-attack.1`: `audience` subcommand + examples → `axial` (and `reports/audience.html` → `reports/axial.html`). - `docs/codebase-annotations.md`: dangling `src/audience/mod.rs` → `src/axial/mod.rs`; `audience` in the A2ML-kind list → `axial`. - `docs/release-prep.md`: `audience` in the subcommand checklists → `axial`. - Adds the repo-standard `MPL-2.0` + owner SPDX header to the two previously header-less `.md` docs (panic-attack policy: SPDX on all files), so the licence-enforcer pre-commit hook passes cleanly. Code rename was already complete (`src/axial/`, the `Axial` subcommand, `ReportBundleKind::Axial`, etc.); this is docs/man only. The JWT `aud`-claim references in `src/assail/analyzer.rs` are a different concept and were left untouched. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
1 parent b26acb0 commit 0d89586

3 files changed

Lines changed: 18 additions & 11 deletions

File tree

docs/codebase-annotations.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
<!-- SPDX-License-Identifier: MPL-2.0 -->
2+
<!-- SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> -->
3+
14
# Codebase Annotation Map
25

36
This document annotates the panic-attack codebase at an architectural level so maintainers can
@@ -46,7 +49,7 @@ trace data flow, intent, and operational boundaries across modules.
4649
- Aggregates `assault`, `amuck`, `abduct` artifacts.
4750
- Asserts normalized facts then applies compact inference rules.
4851
- Emits explainable campaign verdict (`pass`/`warn`/`fail`) plus priorities.
49-
- `src/audience/mod.rs`
52+
- `src/axial/mod.rs`
5053
- Observes target reactions from execution output and stored report artifacts.
5154
- Supports head/tail excerpts, exact/fuzzy pattern matches (`grep`/`agrep`), aspell, i18n.
5255
- Exports JSON + Markdown and optional Pandoc conversion.
@@ -81,7 +84,7 @@ trace data flow, intent, and operational boundaries across modules.
8184
- `src/a2ml/mod.rs`
8285
- Minimal A2ML parser for AI manifest ingestion.
8386
- Nickel exporter for config interoperability.
84-
- Includes schema-versioned A2ML report bundle import/export for assail/attack/assault/ambush/amuck/abduct/adjudicate/audience.
87+
- Includes schema-versioned A2ML report bundle import/export for assail/attack/assault/ambush/amuck/abduct/adjudicate/axial.
8588
- `src/panll/mod.rs`
8689
- PanLL event-chain export adapter.
8790

@@ -101,7 +104,7 @@ trace data flow, intent, and operational boundaries across modules.
101104
- `src/adjudicate/mod.rs` for campaign-level verdict logic.
102105
- `src/kanren/` for deeper relational inference.
103106
- Add new observation signals:
104-
- `src/audience/mod.rs::detect_signals`.
107+
- `src/axial/mod.rs::detect_signals`.
105108
- Add new mutation primitives:
106109
- `src/amuck/mod.rs::MutationOperation`.
107110
- Add new isolation semantics:

docs/release-prep.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,9 @@
1+
<!-- SPDX-License-Identifier: MPL-2.0 -->
2+
<!-- SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> -->
3+
14
# Release Prep Checklist
25

3-
This checklist is for shipping the `amuck`/`abduct`/`adjudicate`/`audience` + A2ML report-bundle work without pulling unrelated tree changes.
6+
This checklist is for shipping the `amuck`/`abduct`/`adjudicate`/`axial` + A2ML report-bundle work without pulling unrelated tree changes.
47

58
## 1. Validation Gates
69

@@ -28,7 +31,7 @@ panic-attack a2ml-export --kind ambush reports/ambush.json --output /tmp/ambush.
2831
panic-attack a2ml-import /tmp/ambush.a2ml --output /tmp/ambush.roundtrip.json --kind ambush
2932
```
3033

31-
Repeat for `assault`, `amuck`, `abduct`, `adjudicate`, and `audience` when test fixtures are available.
34+
Repeat for `assault`, `amuck`, `abduct`, `adjudicate`, and `axial` when test fixtures are available.
3235

3336
## 3. Curated Staging Set
3437

man/panic-attack.1

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
.\" SPDX-License-Identifier: MPL-2.0
12
.TH PANIC-ATTACK 1 "2026-02-11" "panic-attack 2.0.0" "panic-attack manual"
23
.SH NAME
34
panic-attack \- universal stress testing and logic-based bug signature detection
@@ -33,7 +34,7 @@ Copies a target into an isolated workspace, optionally includes related files, a
3334
.B adjudicate REPORTS...
3435
Aggregates assault/amuck/abduct report artifacts into a campaign-level verdict using rule-based inference.
3536
.TP
36-
.B audience TARGET
37+
.B axial TARGET
3738
Observes reaction signals by executing an external tool against a target and/or by inspecting existing report artifacts.
3839
.TP
3940
.B analyze REPORT.json
@@ -55,7 +56,7 @@ Compares two reports (defaults to the two most recent stored VerisimDB files).
5556
Exports the AI manifest in Nickel syntax.
5657
.TP
5758
.B a2ml-export --kind KIND INPUT --output OUT
58-
Encodes a report artifact as a schema-versioned A2ML report bundle (supports assail, attack, assault, ambush, amuck, abduct, adjudicate, audience).
59+
Encodes a report artifact as a schema-versioned A2ML report bundle (supports assail, attack, assault, ambush, amuck, abduct, adjudicate, axial).
5960
.TP
6061
.B a2ml-import INPUT --output OUT [--kind KIND]
6162
Decodes an A2ML report bundle back into JSON (optionally assert expected kind).
@@ -94,14 +95,14 @@ Run a checker against the abducted target while preserving isolation metadata.
9495
.B panic-attack adjudicate reports/assault-a.json reports/amuck-a.json reports/abduct-a.json
9596
Compile a larger picture from multiple report types and emit a campaign verdict.
9697
.TP
97-
.B panic-attack audience ./src/main.rs --exec-program panic-attack --exec-arg amuck --exec-arg {target} --repeat 3
98+
.B panic-attack axial ./src/main.rs --exec-program panic-attack --exec-arg amuck --exec-arg {target} --repeat 3
9899
Watch repeated target reactions while another tool runs against it.
99100
.TP
100-
.B panic-attack audience ./src/main.rs --report reports/amuck-a.json --head 30 --tail 30 --grep panic --agrep segmntation --agrep-distance 2 --aspell --aspell-lang en
101+
.B panic-attack axial ./src/main.rs --report reports/amuck-a.json --head 30 --tail 30 --grep panic --agrep segmntation --agrep-distance 2 --aspell --aspell-lang en
101102
Inspect report reactions with excerpting, exact/fuzzy pattern matching, and optional spell-check signals.
102103
.TP
103-
.B panic-attack audience ./src/main.rs --report reports/amuck-a.json --lang fr --pandoc-to html --pandoc-output reports/audience.html
104-
Export localized audience markdown and convert it to another format with pandoc.
104+
.B panic-attack axial ./src/main.rs --report reports/amuck-a.json --lang fr --pandoc-to html --pandoc-output reports/axial.html
105+
Export localized axial markdown and convert it to another format with pandoc.
105106
.TP
106107
.B panic-attack a2ml-export --kind ambush reports/ambush.json --output reports/ambush.a2ml
107108
Encode an ambush/assault-style report in A2ML report-bundle form.

0 commit comments

Comments
 (0)