Documentation Freshness Audit
This audit compared the AGENTS.md architecture tree against the actual source files and found three source files that exist in the codebase but were missing from the documented tree.
Findings
| Area |
Issue |
File(s) |
| AGENTS.md architecture |
src/compile/extensions/ado_aw_marker.rs not listed in extensions/ |
AGENTS.md |
| AGENTS.md architecture |
src/ado/discovery.rs not listed in ado/ directory |
AGENTS.md |
| AGENTS.md architecture |
src/update_check.rs not listed in src/ |
AGENTS.md |
Details
src/compile/extensions/ado_aw_marker.rs — The always-on AdoAwMarkerExtension that emits the # ado-aw-meta(redacted) JSON marker step in every compiled pipeline. This is a critical extension: src/detect.rsparses these markers to discover and match compiled pipelines for all lifecycle commands. It was registered inextensions/mod.rsasExtension::AdoAwMarker` but omitted from the documentation tree.
src/ado/discovery.rs — The Preview-driven pipeline discovery module that powers the --all-repos and --source flags on secrets set/list/delete. This module calls ADO's Pipeline Preview API per definition and scans the expanded YAML for ado-aw-marker steps. It is a substantial module mentioned in the project but absent from the tree.
src/update_check.rs — A background task spawned on every CLI invocation that checks GitHub Releases for a newer version of ado-aw and prints an advisory if one is found.
Applied Fixes
This pull request was created by the automated documentation freshness check.
To route changes like this to a review issue instead of blocking, configure protected-files: fallback-to-issue in your workflow configuration.
Generated by Documentation Freshness Check · ● 3.2M · ◷
Documentation Freshness Audit
This audit compared the AGENTS.md architecture tree against the actual source files and found three source files that exist in the codebase but were missing from the documented tree.
Findings
src/compile/extensions/ado_aw_marker.rsnot listed in extensions/AGENTS.mdsrc/ado/discovery.rsnot listed in ado/ directoryAGENTS.mdsrc/update_check.rsnot listed in src/AGENTS.mdDetails
src/compile/extensions/ado_aw_marker.rs— The always-onAdoAwMarkerExtensionthat emits the# ado-aw-meta(redacted) JSON marker step in every compiled pipeline. This is a critical extension:src/detect.rsparses these markers to discover and match compiled pipelines for all lifecycle commands. It was registered inextensions/mod.rsasExtension::AdoAwMarker` but omitted from the documentation tree.src/ado/discovery.rs— The Preview-driven pipeline discovery module that powers the--all-reposand--sourceflags onsecrets set/list/delete. This module calls ADO's Pipeline Preview API per definition and scans the expanded YAML forado-aw-markersteps. It is a substantial module mentioned in the project but absent from the tree.src/update_check.rs— A background task spawned on every CLI invocation that checks GitHub Releases for a newer version ofado-awand prints an advisory if one is found.Applied Fixes
ado_aw_marker.rsto theextensions/listing in the AGENTS.md architecture treeado/directory entry to show bothmod.rsanddiscovery.rsupdate_check.rsto the rootsrc/listingThis pull request was created by the automated documentation freshness check.
Warning
Protected Files
This was originally intended as a pull request, but the patch modifies protected files. These files may affect project dependencies, CI/CD pipelines, or agent behaviour. Please review the changes carefully before creating the pull request.
Click here to create the pull request once you have reviewed the changes
Protected files
AGENTS.mdTo route changes like this to a review issue instead of blocking, configure
protected-files: fallback-to-issuein your workflow configuration.