needfix_add
Records a bug, feature, or other finding with dedupe-aware manager-authority checks, returning a receipt with the new or existing ID and normalized kind/severity.
Instructions
Manager-authority add of a NeedFix (dedupe-aware).
kind must be one of: bug, feature, improvement, idea, technical_debt,
optimization, benchmark_gap, documentation_drift, security_risk,
investigation, roadmap_candidate, refactor, security, docs, other.
Common synonyms are normalised server-side and reported as
kind_normalized: gap->improvement, defect->bug,
performance->optimization, design->refactor, dead_code->technical_debt,
test_coverage->improvement.
severity must be one of: critical, high, medium, low, info.
status defaults to captured; its authoritative choices are published
in the field hint. Store lifecycle and manager authority still govern it.
Replies with a receipt (aiworkhub.needfix_add_receipt.v1): id,
dedupe_key, status, kind, severity, created_at, provenance.origin,
deduped with existing_id when the dedupe key matched a live row
(the existing row is returned, nothing new is written), kind_normalized.
The row itself is one needfix_show away.
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": {
"title": "<title>",
"description": "<description>"
},
"name": "needfix_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Accepted kind values: benchmark_gap, bug, docs, documentation_drift, feature, idea, improvement, investigation, optimization, other, refactor, roadmap_candidate, security, security_risk, technical_debt. Case, surrounding space and known synonyms are normalized server-side. | other |
| tags | No | Optional list of free-text tags. | |
| scope | No | Optional free-text scope label. With title and description it forms the dedupe key, so the same text under another scope is a separate row. | |
| title | Yes | Short title of the NeedFix; required, non-empty. | |
| status | No | Accepted status values: accepted, archived, captured, deferred, duplicate, rejected, resolved, task_created, task_planned, triaged. Defaults to captured; store lifecycle and authority gates still apply. | captured |
| evidence | No | Optional evidence object, at most 500000 bytes serialized; omit when there is none. | |
| severity | No | Accepted severity values: critical, high, info, low, medium. | medium |
| caused_by | No | Optional object naming the accepted outcome that introduced the defect: schema_id aiworkhub.accepted_outcome_identity.v1, repository_id, task_id, request_id and accepted_outcome_receipt. Verified against the canonical task store and write-once; omit if unknown. | |
| provenance | No | Optional object describing where the finding came from; the server sets origin to manager_add when it is absent and marks the row verified. | |
| description | Yes | Full description of the finding; required, non-empty, at most 200000 bytes. | |
| scope_files | No | Optional list of repository file paths this NeedFix concerns. | |
| evidence_refs | No | Optional list of evidence reference strings. | |
| scope_symbols | No | Optional list of code symbols this NeedFix concerns. | |
| readiness_score | No | Readiness score, an integer from 0 to 100; default 0. |