finding-interpreter

What problem does it solve?

The Finding Interpreter turns raw security scan output into plain-language findings that non-technical business owners can understand and act on, removing jargon and focusing on business impact and safe remediation steps.

Core Features & Use Cases

• Plain-language translation: Convert technical scan details (CVSS, CVE, server banners) into clear "what is wrong" and "what it means for your business" statements.
• Tier-aware guidance: Produce different output levels (Watchman explanation-only, Sentinel with remediation) and recommend who should fix issues (self, developer, hosting-provider).
• Safety-first recommendations: Bound remediation to generic, verifiable steps and authoritative references; flag low-confidence items for human review.
• Client memory integration: Detect recurring findings by consulting client history and escalate language for repeated issues.
• Use case: Produce a client brief describing an outdated CMS vulnerability for a small restaurant owner, mapping severity to business impact and safe next steps.

Quick Start

Interpret scan-20260321-001 for client-001 and generate interpreted-findings.json containing plain-language findings, mapped business impact, remediation guidance, confidence, and review flags.