Skip to content

findings

Inspect findings stored in a project's knowledge graph.

foil findings

View stored findings from the knowledge graph.

PROJECT_PATH is the project folder (or any path inside it). Defaults to current directory.

Usage:

foil findings [OPTIONS] [PROJECT_PATH]

Options:

  --filter [high|medium|low|high|medium|low]
                                  Filter by severity (e.g., --filter high)
  --file TEXT                     Filter by file path
  --show-all                      Include low-confidence findings
  --format [json|text]
  --help                          Show this message and exit.

Examples

# All findings grouped by file
foil findings ~/src/myapp

# Only HIGH findings
foil findings ~/src/myapp --filter high

# JSON output for tooling
foil findings ~/src/myapp --format json

investigations

Phase 6 agentic investigations are recorded per-finding when you use --deep. Use investigations to browse the history.

foil investigations

View Phase 6 agentic investigation history.

Shows every finding Phase 6 investigated during a foil scan --deep run, including DISMISSED ones — so you can audit what the scanner ruled out and why. CONFIRMED findings are also visible in foil findings (with verified=True); DISMISSED and UNCERTAIN verdicts only show here.

PROJECT_PATH is the project folder (or any path inside it). Defaults to current directory.

Usage:

foil investigations [OPTIONS] [PROJECT_PATH]

Options:

  --filter [confirmed|dismissed|uncertain|confirmed|dismissed|uncertain]
                                  Filter by verdict
  --format [json|text]
  --help                          Show this message and exit.

Verdicts

  • confirmed — investigation reinforced the original HIGH finding
  • dismissed — investigation concluded the code path is safe
  • uncertain — investigation could not reach a verdict within the iteration budget