@clear-capabilities/agentic-security-scanner 0.121.0 → 0.123.0

package/dist/agentic-security.mjs.sha256

@@ -1 +1 @@
-058bfb1a08d130e2e5f07a456b303b52a9874c5d2b679f89408d7e4446e1f214  agentic-security.mjs
+c8cf8da77f8cf7ba57141e8280ea3642843125b66c871e2051e5a99c1894cbbd  agentic-security.mjs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clear-capabilities/agentic-security-scanner",
-  "version": "0.121.0",
+  "version": "0.123.0",
   "description": "Scanner engine for the agentic-security Claude Code plugin — SAST, SCA (function-level reachability + CISA KEV), secrets, IaC, prompt-injection, MCP/agent-tool audit, auth/authZ deep analysis, attack chains, PoC generation, business logic, toxic-combinations scoring, SBOM, SARIF ingest, pipeline integrity, compliance attestation, and more.",
   "type": "module",
   "main": "src/index.js",
@@ -64,7 +64,7 @@
     "test:posture": "node --test test/material-change.test.js test/drift.test.js test/scorecard.test.js test/mttr.test.js test/license-policy.test.js test/aibom.test.js test/sbom.test.js test/api-inventory.test.js test/iam-policy.test.js test/container.test.js test/container-runtime.test.js test/image-packages.test.js test/kev.test.js test/dep-confusion.test.js test/sca-deprecated.test.js test/sca-batch.test.js test/composite-risk.test.js test/sca-coverage.test.js test/gradle-deps.test.js test/sca-route-reachable.test.js test/sca-policy.test.js test/sca-verdict.test.js test/install-script.test.js test/sca-linked-findings.test.js test/packs.test.js test/flow-narration.test.js test/regression-test-gen.test.js test/rule-synthesis.test.js test/policy-gate.test.js test/agents-memory.test.js test/cve-lookup.test.js test/cve-alert-daemon.test.js test/fix-verify-loop.test.js test/fix-acceptance.test.js test/exploitability-probability.test.js test/history-scan.test.js test/viral-features.test.js test/viral-v074.test.js test/state-dir.test.js test/license-graph.test.js test/attack-taxonomy.test.js test/triage-memory.test.js test/pr-augment.test.js test/chat-batch2.test.js test/chat-batch3.test.js test/chat-batch4.test.js test/chat-batch5.test.js test/chat-batch6.test.js test/router.test.js test/legacy-alias-redirect.test.js test/cache-economics.test.js test/coverage-report.test.js test/corpus-status.test.js test/provenance.test.js test/secret-history.test.js",
     "test:dataflow": "node --test test/fn-reach.test.js test/deep-taint.test.js test/calibration.test.js test/holdout-eval.test.js test/cross-lang-meta.test.js test/cross-lang-queues.test.js test/phase5-xlang.test.js test/phase5-coverage.test.js test/phase6-taint.test.js test/llm-validator-consistency.test.js test/llm-validator-default-on.test.js test/parser-py-cst.test.js test/parser-cs-kt.test.js test/parser-go.test.js test/parser-php-rb.test.js test/interproc-k2.test.js test/proven-clean.test.js test/backward-default.test.js test/incremental-cache.test.js test/string-regex-lattice.test.js test/closure-capture.test.js test/points-to.test.js test/type-stubs.test.js test/soft-taint.test.js test/ifds.test.js test/symbolic-exec-proof.test.js test/ifds-summary-edges.test.js test/stub-aware-filter.test.js test/cross-repo.test.js test/proof-gate.test.js test/proof-safe.test.js test/collection-taint.test.js test/kcfa-context.test.js test/kcfa-callstring.test.js test/flow-parity.test.js test/callgraph-resolve.test.js test/import-reachability.test.js",
     "test:mcp": "node --test test/mcp.test.js test/mcp-audit.test.js test/audit-cli.test.js test/mcp-scratchpad.test.js test/mcp-offload.test.js test/sca-upgrade.test.js",
-    "test:report": "node --test test/sarif-ingest.test.js test/junit.test.js test/ci.test.js test/poc-generator.test.js test/verifier.test.js test/verifier-target.test.js test/annotator-errors.test.js test/grader-calibration.test.js test/pr-delta-gate.test.js test/vex.test.js",
+    "test:report": "node --test test/sarif-ingest.test.js test/junit.test.js test/ci.test.js test/poc-generator.test.js test/verifier.test.js test/verifier-target.test.js test/annotator-errors.test.js test/grader-calibration.test.js test/pr-delta-gate.test.js test/vex.test.js test/report-render.test.js",
     "test:bench-modules": "node --test test/phase4-harness.test.js test/pipeline.test.js",
     "test:lifecycle": "node --test test/dead-code.test.js test/no-dead-modules.test.js test/stop-hook.test.js test/plugin-self-check.test.js test/skills-registry.test.js test/bodyguard.test.js test/cache-invalidator-guard.test.js && node ../scripts/lint-command-descriptions.mjs",
     "test:eval": "node --test test/independent-eval.test.js",

package/src/mcp/tools.js

@@ -18,7 +18,7 @@ import * as path from 'node:path';
 import * as crypto from 'node:crypto';
 import { applyFix as applyFixHistory, fixAcceptanceRate } from '../posture/fix-history.js';
 import { verifyLastScan } from '../posture/integrity.js';
-import { analyzeTranscript, formatCacheReport } from '../posture/cache-economics.js';
+import { analyzeTranscript, formatCacheReport, renderCacheStatusLine } from '../posture/cache-economics.js';
 import { redactString, redactFinding } from './redact.js';
 
 // Lazy-loaded: these transitively pull in npm packages (fast-glob,
@@ -1043,6 +1043,7 @@ export const query_cache_telemetry = {
       metrics: result.metrics,
       leaks: result.leaks,
       report: formatCacheReport(result),
+      statusline: renderCacheStatusLine(result.metrics),
     };
   },
 };

package/src/posture/cache-economics.js

@@ -203,6 +203,14 @@ const CAUSE_LABEL = {
   'prefix-change': 'prefix changed (system prompt / tools / context edit)',
 };
 
+// F6 — one-line HUD for a Claude Code statusLine command (mirrors
+// watch-mode.js renderStatusLine). Takes the metrics from computeCacheEconomics.
+export function renderCacheStatusLine(metrics) {
+  if (!metrics || !metrics.turns) return 'agentic-security: no session cost yet';
+  const hit = Math.round(metrics.cacheHitRatio * 100);
+  return `agentic-security: ${money(metrics.actualUsd)} · ${hit}% cached · ${money(metrics.costPerTurnUsd)}/turn`;
+}
+
 export function formatCacheReport(result) {
   if (!result.ok) {
     return result.reason === 'no-transcript'

package/src/report/index.js

@@ -7,6 +7,28 @@ import { SCANNER_VERSION } from '../posture/version.js';
 const SEV_RANK = { critical: 0, high: 1, medium: 2, low: 3, info: 4 };
 const SEV_TO_SARIF = { critical: 'error', high: 'error', medium: 'warning', low: 'note', info: 'none' };
 
+// A short "likely lower risk than its label" note for a high/critical finding the
+// reachability / exploitability / confidence pipeline has already marked down.
+// Detector severities are hardcoded per rule, so a `critical` can outrun its real
+// risk; this surfaces that in the rendered output so the label isn't taken at face
+// value. Returns null when the headline severity is fair as-is. (We annotate, not
+// mutate — `severity` stays canonical for SARIF/exit codes/baselines.)
+function riskNote(f) {
+  if (!/^(critical|high)$/.test(String(f.severity || ''))) return null;
+  const mv = String(f.mitigationVerdict || '').toLowerCase();
+  if (f.unreachable === true || f.unreachableInProd === true || mv.includes('unreachable')) {
+    return 'likely lower risk — not reachable in prod';
+  }
+  if (mv.includes('saniti')) return 'likely lower risk — input appears sanitized';
+  const et = String(f.exploitabilityTier || '').toLowerCase();
+  if (et === 'minimal' || et === 'low') return `likely lower risk — ${et} exploitability`;
+  const ct = String(f.confidenceTier || '').toLowerCase();
+  if (ct === 'low' || (typeof f.confidence === 'number' && f.confidence > 0 && f.confidence < 0.5)) {
+    return 'lower confidence — verify before prioritising';
+  }
+  return null;
+}
+
 function fingerprint(f){
   const s = `${f.file}:${f.line||f.source?.line||0}:${f.vuln||f.type||''}`;
   return crypto.createHash('sha256').update(s).digest('hex').slice(0, 16);
@@ -681,7 +703,9 @@ export function toVex(scan, meta = {}) {
 }
 
 export function toHTML(scan, meta = {}) {
-  const findings = normalizeFindings(scan);
+  // Attach the "likely lower risk" note (computed server-side) so the browser
+  // render can badge over-stated high/critical findings.
+  const findings = normalizeFindings(scan).map(f => ({ ...f, _riskNote: riskNote(f) }));
   const counts = { critical: 0, high: 0, medium: 0, low: 0, info: 0 };
   for (const f of findings) counts[f.severity] = (counts[f.severity] || 0) + 1;
   const stride = {};
@@ -745,6 +769,7 @@ export function toHTML(scan, meta = {}) {
   .f-vuln{font-weight:600;flex:1}
   .f-cwe{color:#64748b;font-size:11px;font-family:ui-monospace,monospace}
   .f-epss{font-size:11px;font-weight:600;color:#f59e0b;background:#f59e0b18;padding:1px 6px;border-radius:3px;white-space:nowrap}
+  .f-note{font-size:11px;font-weight:600;color:#a3a3a3;background:#a3a3a318;padding:1px 6px;border-radius:3px;white-space:nowrap}
   .f-body{display:none;margin-top:12px;padding-top:12px;border-top:1px solid #1e293b;font-size:12px}
   .f.expanded .f-body{display:block}
   .f-body pre{background:#020617;padding:10px;border-radius:4px;overflow-x:auto;font-size:11px;line-height:1.5}
@@ -796,6 +821,7 @@ function makeCard(f) {
       '<span class="f-vuln">' + esc(f.vuln) + '</span>' +
       '<span class="f-cwe">' + esc(f.cwe||'') + '</span>' +
       epssHtml +
+      (f._riskNote ? '<span class="f-note" title="The reachability / confidence pipeline marked this down from its rule-default severity">↓ ' + esc(f._riskNote) + '</span>' : '') +
     '</div>' +
     '<div class="f-body">' +
       (f.snippet ? '<pre>' + esc(f.snippet) + '</pre>' : '') +
@@ -897,6 +923,8 @@ export function toCLI(scan, { verbose=false, color=true }={}){
       ? c(`  V:${f.validator_verdict}`, DIM)
       : '';
     lines.push(`${sevTag} ${c(f.cwe||'    ', DIM)}  ${f.file}:${f.line}  ${BOLD}${f.vuln}${RESET}${epssTag}${kevTag}${verdictTag}`);
+    const rn = riskNote(f);
+    if (rn) lines.push(`        ${c('↓ ' + rn, '\x1b[2;33m')}`);
     if (f.masked) lines.push(`        ${c('value:', DIM)} ${f.masked}`);
     if (verbose && f.fix?.description) {
       lines.push(`        ${c('fix:', DIM)} ${f.fix.description}`);
@@ -1051,6 +1079,14 @@ export function toShipVerdict(scan, options = {}) {
   } else if (advisoryCount > 0) {
     lines.push(c(`  ${advisoryCount} advisory item${advisoryCount === 1 ? '' : 's'} — run /security-scan-all --firehose to see them.`, DIM));
   }
+  // Discoverability: the depth (per-finding explanation) and the shareable report
+  // exist but aren't obvious from the one-screen verdict — point to them.
+  if (findings.length > 0) {
+    lines.push('');
+    lines.push(c('  Want more detail?', BOLD));
+    lines.push(c('     /triage --explain <id>             why it fired, the data-flow trace, and the fix', DIM));
+    lines.push(c('     scan . --format html -o report.html   shareable browser report (charts + filters)', DIM));
+  }
   // Coverage-honesty line (#5/#6): show the scan's blind spots — which
   // languages got flow analysis vs pattern-only, what was skipped, and how
   // many dangerous-looking calls had no finding. One concise line, not bloat.
@@ -1117,6 +1153,8 @@ export function toProTable(scan, options = {}) {
     else if (columns === 'capec') lines.push(`${sev}  ${where}  ${capec}  ${vuln}  ${conf}`);
     else if (columns === 'owasp') lines.push(`${sev}  ${where}  ${cwe}  ${owasp}  ${vuln}  ${conf}`);
     else lines.push(`${sev}  ${where}  ${cwe}  ${cvss}  ${owasp}  ${vuln}  ${conf}`);
+    const rn = riskNote(f);
+    if (rn) lines.push(c('     ↓ ' + rn, '\x1b[2;33m'));
   }
 
   // Footer counts.