Skip to content

Commit 47afcf7

Browse files
jamesadevinegithub-actions[bot]Copilot
authored
docs: add missing audit/ module to AGENTS.md architecture tree (#840)
The src/audit/ module (introduced with the ado-aw audit command) was never added to the architecture section of AGENTS.md. The command is referenced in the CLI docs and docs index, but agents reading the architecture tree had no visibility into the module structure. Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 74fe82c commit 47afcf7

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,27 @@ Every compiled pipeline runs as three sequential jobs:
8787
│ ├── ado/ # Shared Azure DevOps REST helpers (auth, list/match/PATCH/POST)
8888
│ │ ├── mod.rs # Shared ADO REST helpers used by all lifecycle commands (`enable`, `disable`, `list`, `status`, `run`, `remove`, `secrets`)
8989
│ │ └── discovery.rs # Project-scope pipeline discovery (`--all-repos` / `--source` flags)
90+
│ ├── audit/ # `ado-aw audit` command — downloads pipeline artifacts and runs analyzers
91+
│ │ ├── mod.rs # Shared audit data types; AuditData report model
92+
│ │ ├── cli.rs # CLI entry point for the `audit` subcommand
93+
│ │ ├── model.rs # AuditData and supporting report structs
94+
│ │ ├── findings.rs # Finding severity levels and structured finding types
95+
│ │ ├── cache.rs # Artifact download cache (keyed on build-id)
96+
│ │ ├── url.rs # Build-reference parsing (bare ID, full ADO URL)
97+
│ │ ├── analyzers/ # Per-signal analyzers that populate AuditData sections
98+
│ │ │ ├── mod.rs
99+
│ │ │ ├── detection.rs # Detection-stage artifact analysis
100+
│ │ │ ├── firewall.rs # AWF network log analysis
101+
│ │ │ ├── jobs.rs # Build timeline / job-level analysis
102+
│ │ │ ├── mcp.rs # MCP tool-call analysis
103+
│ │ │ ├── missing.rs # Missing-tool / missing-data / noop safe-output analysis
104+
│ │ │ ├── otel.rs # OTel agent stats (token usage, duration, turns)
105+
│ │ │ ├── policy.rs # Policy-level findings (safe-output integrity, prompt injection signals)
106+
│ │ │ └── safe_outputs.rs # Safe-output NDJSON analysis
107+
│ │ └── render/ # Report renderers
108+
│ │ ├── mod.rs
109+
│ │ ├── console.rs # Human-readable console report
110+
│ │ └── json.rs # Machine-readable AuditData JSON
90111
│ ├── detect.rs # Agentic pipeline detection — discovers compiled pipelines; used by all lifecycle commands
91112
│ ├── update_check.rs # Version update check — queries GitHub Releases and prints advisory when newer version is available
92113
│ ├── ndjson.rs # NDJSON parsing utilities

0 commit comments

Comments
 (0)