propose_finding
Propose a gap or caveat finding for a project, keeping it as a candidate until confirmed. Re-proposing an active finding returns its existing ID to prevent duplicates.
Instructions
Propose a gap or caveat finding.
PROPOSING IS FREE — a proposed finding is never surfaced in the trusted context bundle. It is a candidate until confirmed with evidence.
finding_class ∈ {gap, caveat}.
severity ∈ {low, medium, high, critical}.
Fingerprint dedup: re-proposing an active finding returns the existing id (no duplicate write).
Returns
dict with keys: finding_id, status, finding_class,
category, statement, severity.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"project_key": "<project_key>",
"finding_class": "<finding_class>",
"category": "<category>",
"statement": "<statement>",
"severity": "<severity>"
},
"name": "propose_finding"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| impact | No | ||
| category | Yes | ||
| severity | Yes | ||
| statement | Yes | ||
| project_key | Yes | ||
| finding_class | Yes | ||
| source_session_id | No | ||
| resolution_condition | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||