fow_change
Record governed changes and manage packet readiness, evidence reconciliation, dependencies, engineering questions, and risk dispositions.
Instructions
Record a governed change and manage its packet readiness, engineering questions, evidence reconciliation, dependencies and risk dispositions. Author the executable packet plan with fow_packet_author. Route with operation: create_change, get_change, link_change_milestone, set_packet_target_state, evaluate_packet_readiness, start_packet_construction_audit, get_packet_construction_audit, initialize_packet_reconciliation, get_packet_reconciliation, declare_packet_evidence_claim, supersede_packet_evidence_claim, import_packet_evidence_snapshot, collect_packet_evidence_snapshot, reconcile_packet_evidence, disposition_packet_evidence_residual, answer_packet_question, waive_packet_question, block_packet_question, derive_packet_pressure, get_packet_pressure, accept_residual_risk, revise_packet, link_dependency, transition_packet. Prerequisites: Use existing project/change/packet identities and the selected ordinary authority/evidence contract. Effects: Records governed changes, readiness, reconciliation and risk/question dispositions. Some explicit evidence collection/audit routes use configured providers or inference; transitions/supersession can invalidate current authority. Work plans are authored with fow_packet_author. Exact help (replace operation_name with the selected route): fow_capabilities({"view":"operation","operation_tool":"fow_change","operation_name":"create_change"}).
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: create_change, revise_packet. Required by: create_change. | |
| claims | No | Provider snapshot claim records, preserving their identities, content and declared provenance. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| intent | No | Engineering statement of the packet's intended observable behavior and authorized scope. Applies to: revise_packet. | |
| profile | No | Named existing policy/profile used for the selected packet-construction audit. Applies to: start_packet_construction_audit, derive_packet_pressure. | balanced |
| summary | No | Declared concise evidence/readiness summary retained with the snapshot or packet target. Applies to: answer_packet_question, block_packet_question. | |
| claim_id | No | Stable ID of the existing packet-evidence claim. Applies to: supersede_packet_evidence_claim. Required by: supersede_packet_evidence_claim. | |
| goal_ids | No | Existing goal graph IDs governing the packet or campaign scope. Applies to: revise_packet. | |
| in_scope | No | Behaviors and implementation boundaries explicitly included in this packet. Applies to: revise_packet. | |
| provider | No | Compatibility alias for provider_id when importing a packet-evidence snapshot. Applies to: import_packet_evidence_snapshot. | |
| surfaces | No | Explicit provider evidence/association surfaces, such as repo; use the exact configured route contract. Applies to: import_packet_evidence_snapshot. | |
| assertion | No | Structured content of the declared packet-evidence claim, retaining its provenance. Applies to: declare_packet_evidence_claim. | |
| change_id | No | Canonical owning change ID; when address resolution permits omission, the packet/campaign must resolve unambiguously. | |
| claim_key | No | Caller-supplied identity of this claim within its reconciliation scope. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim. | |
| max_depth | No | Maximum traversal depth for this bounded provider-evidence collection. Applies to: collect_packet_evidence_snapshot. | |
| operation | Yes | Operation selector for this multiplexer; use a canonical route listed below. Canonical values: create_change, get_change, link_change_milestone, set_packet_target_state, evaluate_packet_readiness, start_packet_construction_audit, get_packet_construction_audit, initialize_packet_reconciliation, get_packet_reconciliation, declare_packet_evidence_claim, supersede_packet_evidence_claim, import_packet_evidence_snapshot, collect_packet_evidence_snapshot, reconcile_packet_evidence, disposition_packet_evidence_residual, answer_packet_question, waive_packet_question, block_packet_question, derive_packet_pressure, get_packet_pressure, accept_residual_risk, revise_packet, link_dependency, transition_packet. | |
| packet_id | No | Canonical packet identity returned by authoring; it identifies the bounded implementation work. | |
| predicate | No | Relationship asserted between the evidence claim's subject and object. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim. | |
| rationale | No | Concrete reasoning supporting this ordinary mutation, decision or selected authority. Applies to: create_change, supersede_packet_evidence_claim, disposition_packet_evidence_residual, waive_packet_question, block_packet_question, revise_packet. Required by: create_change, supersede_packet_evidence_claim, disposition_packet_evidence_residual. | |
| truncated | No | Whether imported evidence was truncated; partial evidence must not be treated as complete. Applies to: import_packet_evidence_snapshot. | |
| claim_type | No | Canonical evidence-claim category used by packet reconciliation. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim. Canonical values: target, symbol_contract, impact, cleanup, test_obligation. | |
| invariants | No | Conditions that must remain true throughout the scoped behavior or change. Applies to: revise_packet. | |
| max_claims | No | Maximum provider-evidence claims requested by this bounded collection. Applies to: collect_packet_evidence_snapshot. | |
| object_ref | No | Object-side identity of the declared subject/predicate/object evidence claim. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim. | |
| policy_ref | No | Existing policy reference authorizing the requested waiver or residual disposition. Applies to: disposition_packet_evidence_residual, waive_packet_question. Required by: waive_packet_question. | |
| 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. | |
| diagnostics | No | Declared provider diagnostics attached to imported evidence; preserve errors and partial coverage. Applies to: import_packet_evidence_snapshot. | |
| disposition | No | Explicit classification/action for the selected finding, review, packet question or campaign obligation. Applies to: transition_packet. | |
| fingerprint | No | Source/provider-reported evidence fingerprint retained for reconciliation currentness. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| pressure_id | No | Existing packet-pressure projection identity for explicit residual-risk acceptance. Applies to: get_packet_pressure, accept_residual_risk. Required by: accept_residual_risk. | |
| provider_id | No | Evidence-provider identity recorded in the imported snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| question_id | No | Existing open packet-construction or Oracle question identity. Applies to: answer_packet_question, waive_packet_question, block_packet_question. Required by: answer_packet_question, waive_packet_question, block_packet_question. | |
| snapshot_id | No | Existing imported packet-evidence snapshot identity to reconcile. Applies to: reconcile_packet_evidence. Required by: reconcile_packet_evidence. | |
| source_refs | No | References to existing sources governing the proposed change. Applies to: create_change. | |
| subject_ref | No | Subject-side identity of the declared evidence claim. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim. | |
| completeness | No | Declared completeness of each evidence surface; absent or partial evidence must remain explicit. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| milestone_id | No | Existing milestone identity governing or filtering the requested scope. Applies to: create_change, link_change_milestone, start_packet_construction_audit. Required by: link_change_milestone. | |
| out_of_scope | No | Explicitly excluded behavior and implementation work for this packet. Applies to: revise_packet. | |
| target_state | No | Declared packet target-readiness state checked against the governing target policy. Applies to: set_packet_target_state, revise_packet. Canonical values: draft, needs_targets, needs_authority, refined, execution_ready, stale, blocked. | |
| baseline_refs | No | References to existing baselines governing the proposed change. Applies to: create_change. | |
| claim_dynamic | No | Whether the evidence claim requires current dynamic/provider evidence rather than a static declaration. Applies to: declare_packet_evidence_claim. | |
| evidence_refs | No | References to actual supporting evidence; host-declared provenance remains host-declared. Applies to: declare_packet_evidence_claim, answer_packet_question. | |
| packet_status | No | Requested canonical packet lifecycle status, checked against its ordinary transition guards. Applies to: transition_packet. Required by: transition_packet. Canonical values: planned, scaffolded, partial, idle, implemented, superseded, cancelled. | |
| selection_ref | No | Provider selection reference retained in the imported evidence snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| target_policy | No | Packet target-selection policy controlling explicit/provider/materialization readiness requirements. Applies to: set_packet_target_state, revise_packet. Canonical values: code_targets_required, documental_only. | |
| answer_summary | No | Explanation resolving the selected packet-construction question. Applies to: answer_packet_question, block_packet_question. | |
| claim_required | No | Whether the declared claim is required for reconciliation closure. Applies to: declare_packet_evidence_claim. | |
| active_provider | No | Accepted compatibility input; the current fow_change handler does not consume it and it has no effect. Set execution ownership through packet authoring/external-work selection. Applies to: set_packet_target_state, revise_packet. | |
| requirement_ids | No | Explicit existing requirement IDs defining the selected scope. Applies to: create_change, revise_packet. Required by: create_change. | |
| source_revision | No | Declared repository/source revision associated with the work or evidence; does not independently prove implementation. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| blocking_reasons | No | Current readiness blockers recorded for this packet target. Applies to: set_packet_target_state, block_packet_question, revise_packet, transition_packet. | |
| candidate_set_id | No | Singular navigation-candidate-set alias, used when candidate_set_ids is absent or empty. Applies to: set_packet_target_state, revise_packet. | |
| contract_version | No | Version identifier of the imported provider-evidence contract. Applies to: import_packet_evidence_snapshot. | packet-evidence-snapshot-v1 |
| waiver_rationale | No | Concrete reason for explicitly waiving the selected packet-construction question under its policy. Applies to: waive_packet_question. | |
| accepted_risk_ref | No | Durable reference identifying the explicitly accepted residual risk. Applies to: accept_residual_risk. Required by: accept_residual_risk. | |
| architecture_refs | No | References to components, interfaces or decisions in one adopted architecture revision; omission preserves selection and [] explicitly clears it. Applies to: revise_packet. | |
| candidate_set_ids | No | Existing navigation candidate sets supplying the packet's target-readiness context. Applies to: set_packet_target_state, revise_packet. | |
| criterion_results | No | Declared results for the packet's completion criteria; completion, verification and acceptance remain distinct. Applies to: transition_packet. | |
| provider_scope_id | No | Authorized scope identity understood by the configured provider. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| claim_contradicted | No | Whether the declared evidence claim is contradicted, as explicitly reported by its source. Applies to: declare_packet_evidence_claim. | |
| target_binding_ids | No | Existing navigation target-binding identities supporting packet readiness. Applies to: set_packet_target_state, revise_packet. | |
| workspace_revision | No | Provider-declared workspace revision associated with the imported evidence snapshot. Applies to: import_packet_evidence_snapshot. | |
| completion_criteria | No | Ordered packet completion statements; these become stable criteria through the validation-authority workflow. Applies to: revise_packet. | |
| context_snapshot_id | No | Singular navigation-context-snapshot alias, used when context_snapshot_ids is absent or empty. Applies to: set_packet_target_state, revise_packet. | |
| navigation_audit_id | No | Singular navigation-audit alias, used when navigation_audit_ids is absent or empty. Applies to: set_packet_target_state, revise_packet. | |
| successor_packet_id | No | Existing successor/remediation packet identity associated with this lifecycle transition. Applies to: transition_packet. | |
| context_snapshot_ids | No | Existing context snapshots supporting current packet target selection. Applies to: set_packet_target_state, revise_packet. | |
| depends_on_packet_id | No | Existing predecessor packet ID to link as a dependency of the selected packet. Applies to: link_dependency. Required by: link_dependency. | |
| navigation_audit_ids | No | Existing navigation audit IDs supporting packet target readiness. Applies to: set_packet_target_state, revise_packet. | |
| provider_snapshot_id | No | Provider-issued identity of the imported evidence snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot. | |
| unresolved_questions | No | Known unresolved engineering/behavior questions retained on this packet; closure gates require resolution rather than anticipatory coding. Applies to: revise_packet. | |
| construction_audit_id | No | ID of the existing packet-construction audit containing the question being resolved. Applies to: get_packet_construction_audit, answer_packet_question, waive_packet_question, block_packet_question. Required by: answer_packet_question, waive_packet_question, block_packet_question. | |
| linked_navigation_refs | No | Existing navigation references supporting the packet-question answer. Applies to: answer_packet_question. | |
| reconciliation_item_id | No | Existing residual identity returned by packet-evidence reconciliation. Applies to: disposition_packet_evidence_residual. Required by: disposition_packet_evidence_residual. | |
| reconciliation_profile | No | Named reconciliation policy/profile to apply to the declared evidence scope. Applies to: initialize_packet_reconciliation. | target-impact-v1 |
| reconciliation_scope_id | No | Existing packet-evidence reconciliation scope identity. Applies to: get_packet_reconciliation, declare_packet_evidence_claim, import_packet_evidence_snapshot, collect_packet_evidence_snapshot, reconcile_packet_evidence. Required by: declare_packet_evidence_claim, import_packet_evidence_snapshot, collect_packet_evidence_snapshot, reconcile_packet_evidence. | |
| reconciliation_disposition | No | Explicit decision for the selected packet-evidence reconciliation residual. Applies to: disposition_packet_evidence_residual. Required by: disposition_packet_evidence_residual. Canonical values: resolved, waived, rejected, escalated, superseded. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||