Files
hermes-agent/website/docs/user-guide
teknium1 dd2141b928 fix: cap only generic sample tokens, one step, last; bump plugin-guard to v4
Follow-up to the cherry-picked #112146 (@KoNit-K):

- Move the __main__ demotion to the end of _filter_findings behind a
  severity == "critical" guard and a MAIN_GUARD_DEMOTIONS table (the
  DOC_PROSE_DEMOTIONS idiom), so it is a one-step cap that can never
  re-raise a finding an earlier remap already lowered.
- Treat ValueError from ast.parse (NUL bytes, undecodable text) like a
  SyntaxError: no cap, the file is runtime code (fail closed).
- Bump PLUGIN_SCANNER_VERSION to plugin-guard-v4: the verdict semantics
  for a plugin shape changed, and the version is what install output
  and recorded provenance show.
- Trim to two invariant tests: the reporter's repro shape (token inside
  the guard -> caution + confirmable/--force, same token above the guard
  -> dangerous, --force refused) and narrowness (destructive payload and
  a provider-shaped sk- key inside the guard, plus an unparseable file,
  all stay critical -> dangerous).
- Docs: one paragraph on the __main__ cap next to the test-tree cap.

Co-authored-by: kokhlo <konstantin.khlopkov93@gmail.com>
2026-09-16 17:01:30 -07:00
..