fow_campaign_author
Define and revise governed verification campaigns: set scope, cases, obligations, behavioral Oracles, source attestations, and materialization or promotion authority.
Instructions
Define and revise a verification campaign: scope, cases, obligations, behavioral Oracles, source attestations and explicit materialization or promotion authority. Route with operation: start, edit_scope, add_case, edit_case, remove_case, reorder_cases, decide_obligation, bind_obligation, author_oracle, answer_question, attest_source, authorize_materialization, retry_provider_rejection, authorize_promotion, accept_exception, cancel. Prerequisites: Use an existing governed change and current campaign fingerprint for edits. Effects: Authors cases/obligations/Oracle definitions, attestations and explicit provider materialization/promotion commands. Removal/cancellation/exception changes current authority; source files and provider actions require their declared prerequisites. Exact help (replace operation_name with the selected route): fow_capabilities({"view":"operation","operation_tool":"fow_campaign_author","operation_name":"start"}).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| case | No | Structured campaign case: semantic test intent and its required scope/obligations; inspect exact operation help before authoring. Applies to: start, add_case, edit_case. Required by: add_case, edit_case. Exact required/optional dotted fields and guidance: fow_capabilities(view=operation, operation_tool=fow_campaign_author, operation_name=<selected route>). | |
| actor | Yes | Identity of the human or agent recording this action; retain the original identity when replaying its request. | |
| scope | No | Structured campaign scope selecting change, requirements, goals, packets and explicit environment assumptions. Applies to: start, edit_scope. Required by: start, edit_scope. Exact required/optional dotted fields and guidance: fow_capabilities(view=operation, operation_tool=fow_campaign_author, operation_name=<selected route>). | |
| title | No | Short human-readable title of the authored requirement, finding, packet, run step or campaign. Applies to: start, edit_scope. Required by: start, edit_scope. | |
| answer | No | JSON answer matching the selected Oracle question's declared shape; it may be a scalar, array or object rather than necessarily a mapping. Preserve the declared answer_authority and provenance. Applies to: answer_question. Required by: answer_question. Exact required/optional dotted fields and guidance: fow_capabilities(view=operation, operation_tool=fow_campaign_author, operation_name=<selected route>). | |
| oracle | No | Structured behavioral Oracle definition expressing expected/forbidden behavior and test obligations. Applies to: author_oracle. Required by: author_oracle. Exact required/optional dotted fields and guidance: fow_capabilities(view=operation, operation_tool=fow_campaign_author, operation_name=<selected route>). | |
| case_id | No | Stable identifier of the existing campaign case to edit or remove. Applies to: edit_case, remove_case, bind_obligation, author_oracle, attest_source, authorize_materialization, authorize_promotion. Required by: edit_case, remove_case, bind_obligation, author_oracle, attest_source, authorize_materialization, authorize_promotion. | |
| harness | No | Structured test-harness participant contract and provenance; it declares execution boundaries, not observed success. Applies to: attest_source. Exact required/optional dotted fields and guidance: fow_capabilities(view=operation, operation_tool=fow_campaign_author, operation_name=<selected route>). | |
| decision | No | Canonical campaign-obligation decision for decide_obligation; this is a string selector, not a packet gate object. Applies to: decide_obligation. Required by: decide_obligation. Canonical values: required, out_of_scope, duplicate, investigate, waived. Exact required/optional dotted fields and guidance: fow_capabilities(view=operation, operation_tool=fow_campaign_author, operation_name=<selected route>). | |
| operation | Yes | Operation selector for this multiplexer; use a canonical route listed below. Canonical values: start, edit_scope, add_case, edit_case, remove_case, reorder_cases, decide_obligation, bind_obligation, author_oracle, answer_question, attest_source, authorize_materialization, retry_provider_rejection, authorize_promotion, accept_exception, cancel. | |
| oracle_id | No | Existing behavioral Oracle identity selected for the campaign operation. Applies to: author_oracle, answer_question. Required by: answer_question. | |
| rationale | No | Concrete reasoning supporting this ordinary mutation, decision or selected authority. Applies to: remove_case, decide_obligation, retry_provider_rejection. Required by: remove_case, decide_obligation, retry_provider_rejection. | |
| case_order | No | Complete ordered list of current campaign case IDs for the requested reorder. Applies to: reorder_cases. Required by: reorder_cases. | |
| project_id | Yes | Canonical lifecycle project ID. Select the existing project explicitly; development Markdown authorities are separate from runtime projects. | |
| provenance | No | Declared origin of campaign answers/source evidence; does not confer provider audit or human acceptance. Applies to: answer_question. Required by: answer_question. | |
| request_id | Yes | 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. | |
| campaign_id | No | Identifier of the governed test campaign, as returned by campaign authoring. Applies to: edit_scope, add_case, edit_case, remove_case, reorder_cases, decide_obligation, bind_obligation, author_oracle, answer_question, attest_source, authorize_materialization, retry_provider_rejection, authorize_promotion, accept_exception, cancel. Required by: edit_scope, add_case, edit_case, remove_case, reorder_cases, decide_obligation, bind_obligation, author_oracle, answer_question, attest_source, authorize_materialization, retry_provider_rejection, authorize_promotion, accept_exception, cancel. | |
| evidence_id | No | Existing evidence identity to inspect or associate; use returned IDs rather than inventing evidence. Applies to: authorize_promotion. Required by: authorize_promotion. | |
| question_id | No | Existing open packet-construction or Oracle question identity. Applies to: answer_question. Required by: answer_question. | |
| source_files | No | Oracle source mapping from file paths to source-content strings for attestation/materialization. Future files remain declarations until materialized and verified. Applies to: attest_source. Required by: attest_source. | |
| waiver_scope | No | Explicit campaign/Oracle scope covered by the authorized waiver. Applies to: answer_question. | |
| evidence_gaps | No | Known missing verification/evidence obligations retained by an explicit campaign exception. Applies to: accept_exception. Required by: accept_exception. | |
| obligation_id | No | Stable identity of the campaign verification obligation being decided or bound. Applies to: decide_obligation, bind_obligation. Required by: decide_obligation, bind_obligation. | |
| risk_authority | No | Explicit authority permitting the campaign's remaining risks/evidence gaps. Applies to: accept_exception. Required by: accept_exception. | |
| coverage_intent | No | Explanation of the behavior or risk the selected campaign obligation is intended to cover. Applies to: bind_obligation. Required by: bind_obligation. | |
| answer_authority | No | Declared authority/provenance of the Oracle answer; it does not upgrade host assertions into provider-audited evidence. Applies to: answer_question. Required by: answer_question. Canonical values: grounded_fact, accepted_decision, derived_hypothesis, unknown, waived. | |
| authority_reference | No | Reference to the ordinary authority permitting the selected campaign action. Applies to: attest_source, authorize_materialization, authorize_promotion. Required by: attest_source, authorize_materialization, authorize_promotion. | |
| provider_command_id | No | Issued provider-command identity selected for explicit retry or materialization authority. Applies to: retry_provider_rejection. Required by: retry_provider_rejection. | |
| expected_fingerprint | No | Previously issued campaign authority fingerprint; guards against stale authoring. Applies to: edit_scope, add_case, edit_case, remove_case, reorder_cases. | |
| requested_capability | No | Structured provider capability declaration for campaign source/materialization work; use the exact fields supported by the current provider command contract. Applies to: attest_source, authorize_materialization. Required by: authorize_materialization. | |
| disposition_reference | No | Reference to the authority supporting the recorded disposition. Applies to: accept_exception, cancel. Required by: accept_exception, cancel. | |
| regression_obligation | No | Whether the campaign binding declares a required regression obligation. Applies to: authorize_promotion. | |
| exception_obligation_ids | No | Campaign obligation IDs covered by the requested explicit exception. Applies to: accept_exception. Required by: accept_exception. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||