argus 0.5.0

argus 0.5.0

One output system across every command, a guard that writes scan evidence
only where it judged, and refusals that say what to do. Tried end to end
before this tag: 0.5.0-rc.1 and rc.2, on two real Projects, and on a Linux
account with umask 002.

Breaking, read first:

• A committed profile: in .argus.yml must be a profile directory name:
  lowercase letters, digits, dot, underscore and hyphen, not starting with a
  dot. A config naming "Generic" or "acme app" is now refused under the rule
  project-config, and init asks again rather than writing one.
• argus dast and argus guard run refuse an --out that another user could
  replace while a scanner starts (rule private-out): a directory on the way
  that belongs to another user, or that others can write to without the sticky
  bit. A directory writable only by your own per-user group, as umask 002
  leaves one on most Linux systems, is allowed. The refusal names the directory
  and the chmod that fixes it. Write access granted by an ACL is not detected.
• A scope's exclude_paths must be a list of paths. A single string, an empty
  item, or an item holding a line break or a non-ASCII byte is refused under
  scope-file; before, each was silently dropped, and ZAP could request a URL
  the scope meant to exclude.

What changed:

• Every command speaks through one output system. A terminal gets colour,
  aligned rows and a held-back view of bookkeeping; a pipe or a CI log gets
  every line, plain. -q prints only what needs you (refusals, failures,
  SUSPECT, NOT CHECKED, the verdict); -v prints everything; --no-color,
  --plain and --no-input do what they say. docs/CI.md lists them.
• Refusals are one block: REFUSED, the rule word a CI job can match, and what
  to do. docs/CI.md lists every rule word and the commands that print it.
• argus init asks its questions in place, answered with the arrow keys or by
  typing; piped, it asks nothing. It asks git whether .argus/ is ignored and
  adds the entry when nothing ignores it.
• gate and review report a scanner that is not installed, left an empty or
  misshapen report, or could not read a directory, as NOT CHECKED, never as
  clean.
• dast streams each stage live and summarises every SUSPECT and failed stage,
  even under -q. Its exit is 3 over 1 over 4, whatever order the stages ran.
  The one file it writes, operator.md, is only ever created, in the directory
  it judged and holds for the whole run; each scanner runs in that same
  directory, and a replaced --out stops the run and says so. The exclude list
  is printed in ZAP's run, the one tool that honours it, and one line says the
  other tools do not.
• A run writes only files it creates, never through a link or a second name,
  and never into argus's own inputs.
• Whether evidence is gitignored is asked of the repository the evidence is
  actually in, without running that repository's hooks or fsmonitor, and
  without trusting GIT_DIR and friends from the environment.
• A command printed for you to paste stays one inert command, whatever bytes a
  path holds.
• dast speaks as dast:, its own voice. Its stages are section headings, and
  where the evidence is is said once, as dast: output. The Guard's rows inside
  a run are unchanged.
• dast --intrusive is refused in one block under the rule tier, exit 1 as
  before; a run into argus's own inputs, or into a Project outside .argus/, is
  refused under argus-inputs, argus-data or run-dir.
• A committed output: in .argus.yml must be valid UTF-8 with no character that
  can rewrite a terminal line; a hostile value could hide rows or forge one.
• A directory named with non-ASCII letters, such as café, is printed as itself
  in a private-out refusal, with its chmod line to paste.
• No command formats its own status line; a test keeps it that way.

Known, and not in this release: terminal control bytes in a path still reach
the screen in plain rows (#121); a handful of other refusal gaps are listed in
semgrep notice about its own rule file is counted as an unanalysed file,
which can turn a clean scan into NOT CHECKED (#131).

This release is not signed. SHA256SUMS catches a corrupt download and proves
nothing about who built the bytes; provenance is the decision docs/adr/0008
leaves open.
-----BEGIN PGP SIGNATURE-----

iJEEABYKADkWIQTKKELDW9dCd1WCColBoKZCVabq8AUCasEbaRsUgAAAAAAEAA5t
YW51MiwyLjUrMS4xMiwwLDMACgkQQaCmQlWm6vBVXgEA789GZi0KSM/fEun7I/od
368lHCSIDib/UxVCWqBqtEABAOSQwGoovXrNgXadr1WvOSztr5b5QwmLzx+/Y9KL
rIMM
=8sY9
-----END PGP SIGNATURE-----