@clear-capabilities/agentic-security-scanner 0.80.0 → 0.84.1

package/src/.agentic-security/streak.json

@@ -1,14 +1,14 @@
 {
   "firstScanDate": "2026-05-28T17:41:23.688Z",
-  "lastScanDate": "2026-05-29T16:40:09.988Z",
-  "totalScans": 48,
+  "lastScanDate": "2026-05-29T22:33:27.822Z",
+  "totalScans": 58,
   "daysCleanCritical": 0,
   "lastCleanDate": null,
   "lastCriticalDate": "2026-05-29",
   "hasEverHadCritical": true,
   "bestDaysCleanCritical": 0,
   "totalFindingsAtFirstScan": 432,
-  "totalFindingsAtLastScan": 524,
+  "totalFindingsAtLastScan": 584,
   "totalFixesInferred": 0,
   "lastGrade": "C",
   "bestGrade": "C",

package/src/engine.js

@@ -159,6 +159,13 @@ import { buildMigrationPlan as buildPqcPlan, persistMigrationPlan as persistPqcP
 import { analyzeLicenseGraph, loadLicenseGraphPolicy } from './posture/license-graph.js';
 import { generateAttributions, persistAttributions } from './posture/license-attributions.js';
 import { annotateAttackTaxonomy, summarizeTaxonomy } from './posture/attack-taxonomy.js';
+import { suppressByPastDecisions } from './posture/triage-memory.js';
+import { suppressByIntent } from './posture/intent-context.js';
+import { annotateGitHistory } from './posture/git-history.js';
+import { applyThreatModel } from './posture/threat-model-grounding.js';
+import { annotateCrossRepoSignals } from './posture/pattern-propagation.js';
+import { annotateRiskDollars } from './posture/risk-dollars.js';
+import { annotateTimeToFix }   from './posture/time-to-fix.js';
 import { annotateTypeNarrowing } from './posture/type-narrowing.js';
 import { annotateWhyFired } from './posture/why-fired.js';
 import { scanSpecificationDrift } from './posture/specification-mining.js';
@@ -7736,6 +7743,40 @@ async function runFullScan({fileContents={}, depFileContents={}, scanRoot=null},
     if (process.env.AGENTIC_SECURITY_NO_ATTACK_TAX !== '1') {
       _runAnnotator("annotateAttackTaxonomy", () => { annotateAttackTaxonomy(finalFindings); });
     }
+    // Triage memory — demote findings whose (family, dir) bucket was
+    // previously marked wont-fix or false-positive in this project.
+    if (process.env.AGENTIC_SECURITY_NO_TRIAGE_MEMORY !== '1') {
+      _runAnnotator("suppressByPastDecisions", () => { suppressByPastDecisions(scanRoot, finalFindings); });
+    }
+    // Intent-aware FP suppression — demote findings on files marked as
+    // intentionally vulnerable (sandbox/CTF/tutorial/example/etc.).
+    if (process.env.AGENTIC_SECURITY_NO_INTENT_CTX !== '1') {
+      _runAnnotator("suppressByIntent", () => { suppressByIntent(scanRoot, finalFindings); });
+    }
+    // Git history — stamp each finding with introducedBy / introducedIn /
+    // originatingPrompt by running `git blame` on the finding's line.
+    if (process.env.AGENTIC_SECURITY_NO_GIT_HISTORY !== '1') {
+      _runAnnotator("annotateGitHistory", () => { annotateGitHistory(scanRoot, finalFindings); });
+    }
+    // Threat-model grounding — bump severity on crown-jewels, demote
+    // out-of-scope, tag compliance regimes, stamp attacker profile.
+    if (process.env.AGENTIC_SECURITY_NO_THREAT_MODEL_GROUNDING !== '1') {
+      _runAnnotator("applyThreatModel", () => { applyThreatModel(scanRoot, finalFindings); });
+    }
+    // Cross-repo pattern propagation — surface sibling-repo fixes and
+    // triage decisions for the same family from this developer's history.
+    if (process.env.AGENTIC_SECURITY_NO_CROSS_REPO !== '1') {
+      _runAnnotator("annotateCrossRepoSignals", () => { annotateCrossRepoSignals(scanRoot, finalFindings); });
+    }
+    // Risk-in-dollars — combine EPSS + crown-jewel + reachability into an
+    // expected-value-of-exploitation USD figure per finding.
+    if (process.env.AGENTIC_SECURITY_NO_RISK_DOLLARS !== '1') {
+      _runAnnotator("annotateRiskDollars", () => { annotateRiskDollars(scanRoot, finalFindings); });
+    }
+    // Time-to-fix — estimate engineering hours per finding.
+    if (process.env.AGENTIC_SECURITY_NO_TIME_TO_FIX !== '1') {
+      _runAnnotator("annotateTimeToFix", () => { annotateTimeToFix(scanRoot, finalFindings); });
+    }
   }
   // v3 next-gen: crown-jewel mapping (FR-PROD-5) — score each file/finding by
   // business impact. Must run before persona prioritization (which uses it).

package/src/mcp/.agentic-security/findings.json

@@ -1,7 +1,7 @@
 {
-  "scanId": "8b572c4d-add7-4731-b9bb-f9e1f46ae535",
-  "startedAt": "2026-05-28T18:13:59.832Z",
-  "durationMs": 216,
+  "scanId": "47925823-e41f-4a38-acec-1c5dfb77f44d",
+  "startedAt": "2026-05-29T20:35:23.218Z",
+  "durationMs": 217,
   "scanned": {
     "files": 6,
     "lines": 0
@@ -8417,7 +8417,7 @@
   "_v3": {
     "counterfactual": {
       "spofControls": [],
-      "controlsDetected": 73
+      "controlsDetected": 75
     },
     "threatModel": {
       "summary": {

package/src/mcp/.agentic-security/last-scan.json

@@ -1,7 +1,7 @@
 {
-  "scanId": "8b572c4d-add7-4731-b9bb-f9e1f46ae535",
-  "startedAt": "2026-05-28T18:13:59.832Z",
-  "durationMs": 216,
+  "scanId": "47925823-e41f-4a38-acec-1c5dfb77f44d",
+  "startedAt": "2026-05-29T20:35:23.218Z",
+  "durationMs": 217,
   "scanned": {
     "files": 6,
     "lines": 0
@@ -8417,7 +8417,7 @@
   "_v3": {
     "counterfactual": {
       "spofControls": [],
-      "controlsDetected": 73
+      "controlsDetected": 75
     },
     "threatModel": {
       "summary": {

package/src/mcp/.agentic-security/last-scan.json.sig

@@ -1 +1 @@
-45066aa2e5bc1eff0060249590f9b659f87ee1b5bf259c508d585c75d5be346a
+7bb61d3bece7b47b3d112df139e09a5a95a0c51828999fa1734804ee3f7b6efc

package/src/mcp/.agentic-security/scan-history.json

@@ -139,5 +139,193 @@
       "toctou-fs:tools.js:753",
       "toctou-fs:tools.js:835"
     ]
+  },
+  {
+    "timestamp": "2026-05-29T20:12:38.328Z",
+    "label": "scan",
+    "total": 35,
+    "critical": 0,
+    "high": 0,
+    "medium": 35,
+    "low": 0,
+    "kev": 0,
+    "ids": [
+      "struct:audit.js:102:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:113:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:127:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:128:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:52:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:54:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:88:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:32:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:49:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:159:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:163:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:167:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:196:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:211:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:226:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:227:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:281:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:320:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:328:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:535:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:671:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:746:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:748:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:753:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:756:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:835:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:844:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:873:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:875:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "toctou-fs:audit.js:127",
+      "toctou-fs:audit.js:52",
+      "toctou-fs:tools.js:196",
+      "toctou-fs:tools.js:320",
+      "toctou-fs:tools.js:753",
+      "toctou-fs:tools.js:835"
+    ]
+  },
+  {
+    "timestamp": "2026-05-29T20:12:45.655Z",
+    "label": "scan",
+    "total": 35,
+    "critical": 0,
+    "high": 0,
+    "medium": 35,
+    "low": 0,
+    "kev": 0,
+    "ids": [
+      "struct:audit.js:102:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:113:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:127:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:128:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:52:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:54:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:88:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:32:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:49:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:159:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:163:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:167:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:196:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:211:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:226:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:227:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:281:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:320:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:328:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:535:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:671:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:746:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:748:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:753:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:756:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:835:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:844:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:873:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:875:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "toctou-fs:audit.js:127",
+      "toctou-fs:audit.js:52",
+      "toctou-fs:tools.js:196",
+      "toctou-fs:tools.js:320",
+      "toctou-fs:tools.js:753",
+      "toctou-fs:tools.js:835"
+    ]
+  },
+  {
+    "timestamp": "2026-05-29T20:35:14.131Z",
+    "label": "scan",
+    "total": 35,
+    "critical": 0,
+    "high": 0,
+    "medium": 35,
+    "low": 0,
+    "kev": 0,
+    "ids": [
+      "struct:audit.js:102:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:113:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:127:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:128:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:52:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:54:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:88:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:32:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:49:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:159:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:163:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:167:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:196:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:211:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:226:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:227:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:281:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:320:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:328:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:535:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:671:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:746:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:748:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:753:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:756:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:835:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:844:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:873:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:875:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "toctou-fs:audit.js:127",
+      "toctou-fs:audit.js:52",
+      "toctou-fs:tools.js:196",
+      "toctou-fs:tools.js:320",
+      "toctou-fs:tools.js:753",
+      "toctou-fs:tools.js:835"
+    ]
+  },
+  {
+    "timestamp": "2026-05-29T20:35:23.436Z",
+    "label": "scan",
+    "total": 35,
+    "critical": 0,
+    "high": 0,
+    "medium": 35,
+    "low": 0,
+    "kev": 0,
+    "ids": [
+      "struct:audit.js:102:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:113:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:127:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:128:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:52:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:54:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:audit.js:88:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:32:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:server.js:49:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:159:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:163:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:167:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:196:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:211:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:226:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:227:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:281:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:320:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:328:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:535:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:671:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:746:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:748:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:753:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:756:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:835:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:844:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:873:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "struct:tools.js:875:Synchronous_Blocking_I/O_(DoS_Risk_in_Server_Context)",
+      "toctou-fs:audit.js:127",
+      "toctou-fs:audit.js:52",
+      "toctou-fs:tools.js:196",
+      "toctou-fs:tools.js:320",
+      "toctou-fs:tools.js:753",
+      "toctou-fs:tools.js:835"
+    ]
   }
 ]

package/src/mcp/.agentic-security/streak.json

@@ -1,12 +1,12 @@
 {
   "firstScanDate": "2026-05-28T17:48:43.176Z",
-  "lastScanDate": "2026-05-28T18:14:00.070Z",
-  "totalScans": 3,
-  "daysCleanCritical": 1,
-  "lastCleanDate": "2026-05-28",
+  "lastScanDate": "2026-05-29T20:35:23.458Z",
+  "totalScans": 7,
+  "daysCleanCritical": 2,
+  "lastCleanDate": "2026-05-29",
   "lastCriticalDate": null,
   "hasEverHadCritical": false,
-  "bestDaysCleanCritical": 1,
+  "bestDaysCleanCritical": 2,
   "totalFindingsAtFirstScan": 40,
   "totalFindingsAtLastScan": 40,
   "totalFixesInferred": 0,

package/src/mcp/tools.js

@@ -946,6 +946,56 @@ export const read_agents_memory = {
   },
 };
 
+// ─── query_triage_memory ───────────────────────────────────────────────────
+// Natural-language Q&A over past triage decisions (wont-fix / false-positive
+// markings + reasons). Backed by .agentic-security/triage-memory.jsonl, which
+// is auto-populated by triage.transition(). Returns at most 10 most-relevant
+// past decisions.
+
+export const query_triage_memory = {
+  name: 'query_triage_memory',
+  description: 'Search past triage decisions (wont-fix / false-positive) by natural-language query. Returns up to 10 most-relevant past decisions with their reasons. Use when you see a new finding and want to know "did we already decide on something like this?" — answers in seconds without re-reading the full AGENTS.md narrative.',
+  inputSchema: {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+      query: { type: 'string', description: 'Free-text terms to match against past reasons / vuln text / file paths / family names.' },
+    },
+  },
+  async handler({ query }, ctx) {
+    const { queryMemory } = await import('../posture/triage-memory.js');
+    const results = queryMemory(ctx.sessionRoot, query || '');
+    return {
+      _meta: META,
+      count: results.length,
+      results,
+    };
+  },
+};
+
+// ─── query_findings_memory ─────────────────────────────────────────────────
+// Natural-language Q&A across the scanner's accumulated institutional
+// memory: current findings + past triage decisions + scan history +
+// AGENTS.md narrative. Use to answer "have we seen something like this
+// before?" without reading multiple files.
+
+export const query_findings_memory = {
+  name: 'query_findings_memory',
+  description: 'Search the scanner accumulated memory (current scan findings + past wont-fix/false-positive decisions + scan history + AGENTS.md narrative) by natural-language terms. Returns top-10 results scored by term-match count and ranked finding > triage > history > AGENTS.md.',
+  inputSchema: {
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+      query: { type: 'string', description: 'Natural-language search terms (2+ chars each).' },
+    },
+    required: ['query'],
+  },
+  async handler({ query }, ctx) {
+    const { queryFindingsMemory } = await import('../posture/findings-memory.js');
+    return { _meta: META, ...queryFindingsMemory(ctx.sessionRoot, query || '') };
+  },
+};
+
 // ─── lookup_cve ────────────────────────────────────────────────────────────
 // LangChain harness-anatomy #8: bridge the knowledge-cutoff gap by exposing
 // the local OSV / KEV / EPSS cache as a structured tool. Read-only — never
@@ -1041,4 +1091,4 @@ export const apply_sca_upgrade = {
   },
 };
 
-export const ALL_TOOLS = [scan_diff, query_taint, explain_finding, apply_fix, verify_fix, synthesize_fix, find_rule_module, append_scratchpad, read_scratchpad, append_agents_memory, read_agents_memory, lookup_cve, synthesize_sca_upgrade, apply_sca_upgrade];
+export const ALL_TOOLS = [scan_diff, query_taint, explain_finding, apply_fix, verify_fix, synthesize_fix, find_rule_module, append_scratchpad, read_scratchpad, append_agents_memory, read_agents_memory, lookup_cve, synthesize_sca_upgrade, apply_sca_upgrade, query_triage_memory, query_findings_memory];