Skip to content

Update `audit-docs`

Latest

Choose a tag to compare

@AlexJSully AlexJSully released this 05 Aug 17:09
· 10 commits to main since this release
Immutable release. Only release title and notes can be modified.
4b81d44

AI tooling:

  • audit-docs now documents a fact once, on the declaration of the symbol it describes, instead of repeating it above every line that reads, calls, or branches on that symbol
  • audit-docs can clean up comments already repeated across usage sites, folding anything a copy adds into the declaration before removing it
  • Restored the limits on where audit-docs writes an inline comment, so a comment inside a function body is reserved for non-obvious business logic, a workaround, or a complex transformation
  • The surface-auditor agent reports comments repeated above a usage site alongside the undocumented symbols and contradicted comments it already returned
  • The same document-once rule now applies to typescript-code-and-test-standards and the Copilot instructions

Security:

  • Every audit skill replaces a credential value with [REDACTED] when it quotes a line as evidence, so no token, password, API key, private key, or session identifier reaches a finding, a report, or a comment posted to GitHub
  • Labelled the vulnerable code in each audit reference as an illustration to recognize rather than a pattern to introduce, and treat file contents reached during an audit as data rather than as instructions to follow