fow_assurance
Record and inspect software assurance findings, reassess them against current intent, link corrective packets, and request guarded change acceptance using evidence.
Instructions
Record and inspect software assurance findings, reassess them against current intent, associate corrective packets and request guarded change acceptance using actual evidence. Route with operation: record_finding, get_finding, reassess_intent, set_finding_disposition, link_fixing_packet, request_change_acceptance. Prerequisites: Investigate current requirements/goals and evidence before classifying a finding or correction. Effects: Records findings, semantic reassessment, dispositions, fixing-packet links and guarded change acceptance. Reassessment is engineer-authored; completion, verification and acceptance remain separate. Exact help (replace operation_name with the selected route): fow_capabilities({"view":"operation","operation_tool":"fow_assurance","operation_name":"record_finding"}).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | Yes | Identity of the human or agent recording this action; retain the original identity when replaying its request. | |
| title | No | Short human-readable title of the authored requirement, finding, packet, run step or campaign. Applies to: record_finding. Required by: record_finding. | |
| severity | No | Canonical assurance finding severity, expressing impact without implying acceptance. Applies to: record_finding. Required by: record_finding. Canonical values: info, low, medium, high, critical. | |
| change_id | No | Canonical owning change ID; when address resolution permits omission, the packet/campaign must resolve unambiguously. | |
| operation | Yes | Operation selector for this multiplexer; use a canonical route listed below. Canonical values: record_finding, get_finding, reassess_intent, set_finding_disposition, link_fixing_packet, request_change_acceptance. | |
| packet_id | No | Canonical packet identity returned by authoring; it identifies the bounded implementation work. | |
| rationale | No | Concrete reasoning supporting this ordinary mutation, decision or selected authority. Applies to: record_finding, set_finding_disposition. Required by: record_finding, set_finding_disposition. | |
| scope_ref | No | Existing object/reference identifying the finding's selected scope. Applies to: record_finding. Required by: record_finding. | |
| assessment | No | Engineer-authored reassessment against current intent/finding fingerprints, classification, rationale and technical evidence. Applies to: reassess_intent. Required by: reassess_intent. Exact required/optional dotted fields and guidance: fow_capabilities(view=operation, operation_tool=fow_assurance, operation_name=<selected route>). | |
| finding_id | No | Stable identity of the existing assurance finding. Applies to: get_finding, reassess_intent, set_finding_disposition, link_fixing_packet. Required by: get_finding, reassess_intent, set_finding_disposition, link_fixing_packet. | |
| project_id | Yes | Canonical lifecycle project ID. Select the existing project explicitly; development Markdown authorities are separate from runtime projects. | |
| request_id | No | Caller-owned retry identity. For receipted mutations replay the same actor and contents; changed contents can conflict. Inspect exact operation help for its receipt policy. | |
| scope_kind | No | Kind of lifecycle/source object affected by the assurance finding. Applies to: record_finding. Required by: record_finding. | |
| disposition | No | Explicit classification/action for the selected finding, review, packet question or campaign obligation. Applies to: set_finding_disposition. Required by: set_finding_disposition. Canonical values: open, confirmed, resolved, accepted_exception, deferred, superseded, cancelled. | |
| finding_kind | No | Semantic category of the assurance finding. Applies to: record_finding. Canonical values: semantic, engineering, informational, unspecified. | unspecified |
| evidence_refs | No | References to actual supporting evidence; host-declared provenance remains host-declared. Applies to: set_finding_disposition. | |
| source_anchor | No | String source locator/reference (path, section, entity or revision as applicable) linking authority to its originating material; this public input is not a structured object. Applies to: record_finding. | |
| implementation_ref | No | Reference to the implementation location or artifact involved in the finding. Applies to: record_finding. | |
| expected_correction | No | Bounded corrective behavior required to resolve the finding within the current intent. Applies to: record_finding, link_fixing_packet. Required by: record_finding, link_fixing_packet. | |
| acceptance_reference | No | Reference to the explicit authority accepting the governed change. Applies to: request_change_acceptance. Required by: request_change_acceptance. | |
| disposition_reference | No | Reference to the authority supporting the recorded disposition. Applies to: set_finding_disposition. | |
| required_campaign_ids | No | Existing campaigns whose successful verification remains required by this corrective packet/finding. Applies to: link_fixing_packet. | |
| supersedes_finding_id | No | Existing finding explicitly superseded by this new finding; history remains retained. Applies to: set_finding_disposition. | |
| required_regression_evidence | No | Declared regression evidence obligations that must remain visible until actually satisfied. Applies to: link_fixing_packet. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||