Skip to main content
Glama

fow_change

Destructive

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

TableJSON Schema
NameRequiredDescriptionDefault
actorYesIdentity of the human or agent recording this action; retain the original identity when replaying its request.
titleNoShort human-readable title of the authored requirement, finding, packet, run step or campaign. Applies to: create_change, revise_packet. Required by: create_change.
claimsNoProvider snapshot claim records, preserving their identities, content and declared provenance. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot.
intentNoEngineering statement of the packet's intended observable behavior and authorized scope. Applies to: revise_packet.
profileNoNamed existing policy/profile used for the selected packet-construction audit. Applies to: start_packet_construction_audit, derive_packet_pressure.balanced
summaryNoDeclared concise evidence/readiness summary retained with the snapshot or packet target. Applies to: answer_packet_question, block_packet_question.
claim_idNoStable ID of the existing packet-evidence claim. Applies to: supersede_packet_evidence_claim. Required by: supersede_packet_evidence_claim.
goal_idsNoExisting goal graph IDs governing the packet or campaign scope. Applies to: revise_packet.
in_scopeNoBehaviors and implementation boundaries explicitly included in this packet. Applies to: revise_packet.
providerNoCompatibility alias for provider_id when importing a packet-evidence snapshot. Applies to: import_packet_evidence_snapshot.
surfacesNoExplicit provider evidence/association surfaces, such as repo; use the exact configured route contract. Applies to: import_packet_evidence_snapshot.
assertionNoStructured content of the declared packet-evidence claim, retaining its provenance. Applies to: declare_packet_evidence_claim.
change_idNoCanonical owning change ID; when address resolution permits omission, the packet/campaign must resolve unambiguously.
claim_keyNoCaller-supplied identity of this claim within its reconciliation scope. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim.
max_depthNoMaximum traversal depth for this bounded provider-evidence collection. Applies to: collect_packet_evidence_snapshot.
operationYesOperation 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_idNoCanonical packet identity returned by authoring; it identifies the bounded implementation work.
predicateNoRelationship asserted between the evidence claim's subject and object. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim.
rationaleNoConcrete 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.
truncatedNoWhether imported evidence was truncated; partial evidence must not be treated as complete. Applies to: import_packet_evidence_snapshot.
claim_typeNoCanonical 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.
invariantsNoConditions that must remain true throughout the scoped behavior or change. Applies to: revise_packet.
max_claimsNoMaximum provider-evidence claims requested by this bounded collection. Applies to: collect_packet_evidence_snapshot.
object_refNoObject-side identity of the declared subject/predicate/object evidence claim. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim.
policy_refNoExisting policy reference authorizing the requested waiver or residual disposition. Applies to: disposition_packet_evidence_residual, waive_packet_question. Required by: waive_packet_question.
project_idYesCanonical lifecycle project ID. Select the existing project explicitly; development Markdown authorities are separate from runtime projects.
request_idNoCaller-owned retry identity. For receipted mutations replay the same actor and contents; changed contents can conflict. Inspect exact operation help for its receipt policy.
diagnosticsNoDeclared provider diagnostics attached to imported evidence; preserve errors and partial coverage. Applies to: import_packet_evidence_snapshot.
dispositionNoExplicit classification/action for the selected finding, review, packet question or campaign obligation. Applies to: transition_packet.
fingerprintNoSource/provider-reported evidence fingerprint retained for reconciliation currentness. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot.
pressure_idNoExisting packet-pressure projection identity for explicit residual-risk acceptance. Applies to: get_packet_pressure, accept_residual_risk. Required by: accept_residual_risk.
provider_idNoEvidence-provider identity recorded in the imported snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot.
question_idNoExisting 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_idNoExisting imported packet-evidence snapshot identity to reconcile. Applies to: reconcile_packet_evidence. Required by: reconcile_packet_evidence.
source_refsNoReferences to existing sources governing the proposed change. Applies to: create_change.
subject_refNoSubject-side identity of the declared evidence claim. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim.
completenessNoDeclared 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_idNoExisting 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_scopeNoExplicitly excluded behavior and implementation work for this packet. Applies to: revise_packet.
target_stateNoDeclared 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_refsNoReferences to existing baselines governing the proposed change. Applies to: create_change.
claim_dynamicNoWhether the evidence claim requires current dynamic/provider evidence rather than a static declaration. Applies to: declare_packet_evidence_claim.
evidence_refsNoReferences to actual supporting evidence; host-declared provenance remains host-declared. Applies to: declare_packet_evidence_claim, answer_packet_question.
packet_statusNoRequested 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_refNoProvider selection reference retained in the imported evidence snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot.
target_policyNoPacket 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_summaryNoExplanation resolving the selected packet-construction question. Applies to: answer_packet_question, block_packet_question.
claim_requiredNoWhether the declared claim is required for reconciliation closure. Applies to: declare_packet_evidence_claim.
active_providerNoAccepted 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_idsNoExplicit existing requirement IDs defining the selected scope. Applies to: create_change, revise_packet. Required by: create_change.
source_revisionNoDeclared 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_reasonsNoCurrent readiness blockers recorded for this packet target. Applies to: set_packet_target_state, block_packet_question, revise_packet, transition_packet.
candidate_set_idNoSingular navigation-candidate-set alias, used when candidate_set_ids is absent or empty. Applies to: set_packet_target_state, revise_packet.
contract_versionNoVersion identifier of the imported provider-evidence contract. Applies to: import_packet_evidence_snapshot.packet-evidence-snapshot-v1
waiver_rationaleNoConcrete reason for explicitly waiving the selected packet-construction question under its policy. Applies to: waive_packet_question.
accepted_risk_refNoDurable reference identifying the explicitly accepted residual risk. Applies to: accept_residual_risk. Required by: accept_residual_risk.
architecture_refsNoReferences to components, interfaces or decisions in one adopted architecture revision; omission preserves selection and [] explicitly clears it. Applies to: revise_packet.
candidate_set_idsNoExisting navigation candidate sets supplying the packet's target-readiness context. Applies to: set_packet_target_state, revise_packet.
criterion_resultsNoDeclared results for the packet's completion criteria; completion, verification and acceptance remain distinct. Applies to: transition_packet.
provider_scope_idNoAuthorized scope identity understood by the configured provider. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot.
claim_contradictedNoWhether the declared evidence claim is contradicted, as explicitly reported by its source. Applies to: declare_packet_evidence_claim.
target_binding_idsNoExisting navigation target-binding identities supporting packet readiness. Applies to: set_packet_target_state, revise_packet.
workspace_revisionNoProvider-declared workspace revision associated with the imported evidence snapshot. Applies to: import_packet_evidence_snapshot.
completion_criteriaNoOrdered packet completion statements; these become stable criteria through the validation-authority workflow. Applies to: revise_packet.
context_snapshot_idNoSingular navigation-context-snapshot alias, used when context_snapshot_ids is absent or empty. Applies to: set_packet_target_state, revise_packet.
navigation_audit_idNoSingular navigation-audit alias, used when navigation_audit_ids is absent or empty. Applies to: set_packet_target_state, revise_packet.
successor_packet_idNoExisting successor/remediation packet identity associated with this lifecycle transition. Applies to: transition_packet.
context_snapshot_idsNoExisting context snapshots supporting current packet target selection. Applies to: set_packet_target_state, revise_packet.
depends_on_packet_idNoExisting predecessor packet ID to link as a dependency of the selected packet. Applies to: link_dependency. Required by: link_dependency.
navigation_audit_idsNoExisting navigation audit IDs supporting packet target readiness. Applies to: set_packet_target_state, revise_packet.
provider_snapshot_idNoProvider-issued identity of the imported evidence snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot.
unresolved_questionsNoKnown unresolved engineering/behavior questions retained on this packet; closure gates require resolution rather than anticipatory coding. Applies to: revise_packet.
construction_audit_idNoID 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_refsNoExisting navigation references supporting the packet-question answer. Applies to: answer_packet_question.
reconciliation_item_idNoExisting residual identity returned by packet-evidence reconciliation. Applies to: disposition_packet_evidence_residual. Required by: disposition_packet_evidence_residual.
reconciliation_profileNoNamed reconciliation policy/profile to apply to the declared evidence scope. Applies to: initialize_packet_reconciliation.target-impact-v1
reconciliation_scope_idNoExisting 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_dispositionNoExplicit 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

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed79 schema fields changedv0.5.1
    • addedInput schema / properties / accepted_risk_ref / description
      Added value: +"Durable reference identifying the explicitly accepted residual risk. Applies to: accept_residual_risk. Required by: accept_residual_risk."
    • addedInput schema / properties / active_provider / description
      Added value: +"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."
    • addedInput schema / properties / actor / description
      Added value: +"Identity of the human or agent recording this action; retain the original identity when replaying its request."
    • addedInput schema / properties / answer_summary / description
      Added value: +"Explanation resolving the selected packet-construction question. Applies to: answer_packet_question, block_packet_question."
    • addedInput schema / properties / architecture_refs / description
      Added value: +"References to components, interfaces or decisions in one adopted architecture revision; omission preserves selection and [] explicitly clears it. Applies to: revise_packet."
    • addedInput schema / properties / assertion / description
      Added value: +"Structured content of the declared packet-evidence claim, retaining its provenance. Applies to: declare_packet_evidence_claim."
    • addedInput schema / properties / baseline_refs / description
      Added value: +"References to existing baselines governing the proposed change. Applies to: create_change."
    • addedInput schema / properties / blocking_reasons / description
      Added value: +"Current readiness blockers recorded for this packet target. Applies to: set_packet_target_state, block_packet_question, revise_packet, transition_packet."
    • addedInput schema / properties / candidate_set_id / description
      Added value: +"Singular navigation-candidate-set alias, used when candidate_set_ids is absent or empty. Applies to: set_packet_target_state, revise_packet."
    • addedInput schema / properties / candidate_set_ids / description
      Added value: +"Existing navigation candidate sets supplying the packet's target-readiness context. Applies to: set_packet_target_state, revise_packet."
    • addedInput schema / properties / change_id / description
      Added value: +"Canonical owning change ID; when address resolution permits omission, the packet/campaign must resolve unambiguously."
    • addedInput schema / properties / claim_contradicted / description
      Added value: +"Whether the declared evidence claim is contradicted, as explicitly reported by its source. Applies to: declare_packet_evidence_claim."
    • addedInput schema / properties / claim_dynamic / description
      Added value: +"Whether the evidence claim requires current dynamic/provider evidence rather than a static declaration. Applies to: declare_packet_evidence_claim."
    • addedInput schema / properties / claim_id / description
      Added value: +"Stable ID of the existing packet-evidence claim. Applies to: supersede_packet_evidence_claim. Required by: supersede_packet_evidence_claim."
    • addedInput schema / properties / claim_key / description
      Added value: +"Caller-supplied identity of this claim within its reconciliation scope. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim."
    • addedInput schema / properties / claim_required / description
      Added value: +"Whether the declared claim is required for reconciliation closure. Applies to: declare_packet_evidence_claim."
    • addedInput schema / properties / claim_type / description
      Added value: +"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."
    • addedInput schema / properties / claims / description
      Added value: +"Provider snapshot claim records, preserving their identities, content and declared provenance. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot."
    • addedInput schema / properties / completeness / description
      Added value: +"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."
    • addedInput schema / properties / completion_criteria / description
      Added value: +"Ordered packet completion statements; these become stable criteria through the validation-authority workflow. Applies to: revise_packet."
    • addedInput schema / properties / construction_audit_id / description
      Added value: +"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."
    • addedInput schema / properties / context_snapshot_id / description
      Added value: +"Singular navigation-context-snapshot alias, used when context_snapshot_ids is absent or empty. Applies to: set_packet_target_state, revise_packet."
    • addedInput schema / properties / context_snapshot_ids / description
      Added value: +"Existing context snapshots supporting current packet target selection. Applies to: set_packet_target_state, revise_packet."
    • addedInput schema / properties / contract_version / description
      Added value: +"Version identifier of the imported provider-evidence contract. Applies to: import_packet_evidence_snapshot."
    • addedInput schema / properties / criterion_results / description
      Added value: +"Declared results for the packet's completion criteria; completion, verification and acceptance remain distinct. Applies to: transition_packet."
    • addedInput schema / properties / depends_on_packet_id / description
      Added value: +"Existing predecessor packet ID to link as a dependency of the selected packet. Applies to: link_dependency. Required by: link_dependency."
    • addedInput schema / properties / diagnostics / description
      Added value: +"Declared provider diagnostics attached to imported evidence; preserve errors and partial coverage. Applies to: import_packet_evidence_snapshot."
    • addedInput schema / properties / disposition / description
      Added value: +"Explicit classification/action for the selected finding, review, packet question or campaign obligation. Applies to: transition_packet."
    • addedInput schema / properties / evidence_refs / description
      Added value: +"References to actual supporting evidence; host-declared provenance remains host-declared. Applies to: declare_packet_evidence_claim, answer_packet_question."
    • addedInput schema / properties / fingerprint / description
      Added value: +"Source/provider-reported evidence fingerprint retained for reconciliation currentness. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot."
    • addedInput schema / properties / goal_ids / description
      Added value: +"Existing goal graph IDs governing the packet or campaign scope. Applies to: revise_packet."
    • addedInput schema / properties / in_scope / description
      Added value: +"Behaviors and implementation boundaries explicitly included in this packet. Applies to: revise_packet."
    • addedInput schema / properties / intent / description
      Added value: +"Engineering statement of the packet's intended observable behavior and authorized scope. Applies to: revise_packet."
    • addedInput schema / properties / invariants / description
      Added value: +"Conditions that must remain true throughout the scoped behavior or change. Applies to: revise_packet."
    • addedInput schema / properties / linked_navigation_refs / description
      Added value: +"Existing navigation references supporting the packet-question answer. Applies to: answer_packet_question."
    • addedInput schema / properties / max_claims / description
      Added value: +"Maximum provider-evidence claims requested by this bounded collection. Applies to: collect_packet_evidence_snapshot."
    • addedInput schema / properties / max_depth / description
      Added value: +"Maximum traversal depth for this bounded provider-evidence collection. Applies to: collect_packet_evidence_snapshot."
    • addedInput schema / properties / milestone_id / description
      Added value: +"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."
    • addedInput schema / properties / navigation_audit_id / description
      Added value: +"Singular navigation-audit alias, used when navigation_audit_ids is absent or empty. Applies to: set_packet_target_state, revise_packet."
    • addedInput schema / properties / navigation_audit_ids / description
      Added value: +"Existing navigation audit IDs supporting packet target readiness. Applies to: set_packet_target_state, revise_packet."
    • addedInput schema / properties / object_ref / description
      Added value: +"Object-side identity of the declared subject/predicate/object evidence claim. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim."
    • addedInput schema / properties / operation / description
      Added value: +"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."
    • addedInput schema / properties / operation / examples
      Added value: +[
      +  "create_change"
      +]
    • addedInput schema / properties / out_of_scope / description
      Added value: +"Explicitly excluded behavior and implementation work for this packet. Applies to: revise_packet."
    • addedInput schema / properties / packet_id / description
      Added value: +"Canonical packet identity returned by authoring; it identifies the bounded implementation work."
    • addedInput schema / properties / packet_status / description
      Added value: +"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."
    • addedInput schema / properties / policy_ref / description
      Added value: +"Existing policy reference authorizing the requested waiver or residual disposition. Applies to: disposition_packet_evidence_residual, waive_packet_question. Required by: waive_packet_question."
    • addedInput schema / properties / predicate / description
      Added value: +"Relationship asserted between the evidence claim's subject and object. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim."
    • addedInput schema / properties / pressure_id / description
      Added value: +"Existing packet-pressure projection identity for explicit residual-risk acceptance. Applies to: get_packet_pressure, accept_residual_risk. Required by: accept_residual_risk."
    • addedInput schema / properties / profile / description
      Added value: +"Named existing policy/profile used for the selected packet-construction audit. Applies to: start_packet_construction_audit, derive_packet_pressure."
    • addedInput schema / properties / project_id / description
      Added value: +"Canonical lifecycle project ID. Select the existing project explicitly; development Markdown authorities are separate from runtime projects."
    • addedInput schema / properties / provider / description
      Added value: +"Compatibility alias for provider_id when importing a packet-evidence snapshot. Applies to: import_packet_evidence_snapshot."
    • addedInput schema / properties / provider_id / description
      Added value: +"Evidence-provider identity recorded in the imported snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot."
    • addedInput schema / properties / provider_scope_id / description
      Added value: +"Authorized scope identity understood by the configured provider. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot."
    • addedInput schema / properties / provider_snapshot_id / description
      Added value: +"Provider-issued identity of the imported evidence snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot."
    • addedInput schema / properties / question_id / description
      Added value: +"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."
    • addedInput schema / properties / rationale / description
      Added value: +"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."
    • addedInput schema / properties / reconciliation_disposition / description
      Added value: +"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."
    • addedInput schema / properties / reconciliation_item_id / description
      Added value: +"Existing residual identity returned by packet-evidence reconciliation. Applies to: disposition_packet_evidence_residual. Required by: disposition_packet_evidence_residual."
    • addedInput schema / properties / reconciliation_profile / description
      Added value: +"Named reconciliation policy/profile to apply to the declared evidence scope. Applies to: initialize_packet_reconciliation."
    • addedInput schema / properties / reconciliation_scope_id / description
      Added value: +"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."
    • addedInput schema / properties / request_id / description
      Added value: +"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."
    • addedInput schema / properties / requirement_ids / description
      Added value: +"Explicit existing requirement IDs defining the selected scope. Applies to: create_change, revise_packet. Required by: create_change."
    • addedInput schema / properties / selection_ref / description
      Added value: +"Provider selection reference retained in the imported evidence snapshot. Applies to: import_packet_evidence_snapshot. Required by: import_packet_evidence_snapshot."
    • addedInput schema / properties / snapshot_id / description
      Added value: +"Existing imported packet-evidence snapshot identity to reconcile. Applies to: reconcile_packet_evidence. Required by: reconcile_packet_evidence."
    • addedInput schema / properties / source_refs / description
      Added value: +"References to existing sources governing the proposed change. Applies to: create_change."
    • addedInput schema / properties / source_revision / description
      Added value: +"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."
    • addedInput schema / properties / subject_ref / description
      Added value: +"Subject-side identity of the declared evidence claim. Applies to: declare_packet_evidence_claim. Required by: declare_packet_evidence_claim."
    • addedInput schema / properties / successor_packet_id / description
      Added value: +"Existing successor/remediation packet identity associated with this lifecycle transition. Applies to: transition_packet."
    • addedInput schema / properties / summary / description
      Added value: +"Declared concise evidence/readiness summary retained with the snapshot or packet target. Applies to: answer_packet_question, block_packet_question."
    • addedInput schema / properties / surfaces / description
      Added value: +"Explicit provider evidence/association surfaces, such as repo; use the exact configured route contract. Applies to: import_packet_evidence_snapshot."
    • addedInput schema / properties / target_binding_ids / description
      Added value: +"Existing navigation target-binding identities supporting packet readiness. Applies to: set_packet_target_state, revise_packet."
    • addedInput schema / properties / target_policy / description
      Added value: +"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."
    • addedInput schema / properties / target_state / description
      Added value: +"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."
    • addedInput schema / properties / title / description
      Added value: +"Short human-readable title of the authored requirement, finding, packet, run step or campaign. Applies to: create_change, revise_packet. Required by: create_change."
    • addedInput schema / properties / truncated / description
      Added value: +"Whether imported evidence was truncated; partial evidence must not be treated as complete. Applies to: import_packet_evidence_snapshot."
    • addedInput schema / properties / unresolved_questions / description
      Added value: +"Known unresolved engineering/behavior questions retained on this packet; closure gates require resolution rather than anticipatory coding. Applies to: revise_packet."
    • addedInput schema / properties / waiver_rationale / description
      Added value: +"Concrete reason for explicitly waiving the selected packet-construction question under its policy. Applies to: waive_packet_question."
    • addedInput schema / properties / workspace_revision / description
      Added value: +"Provider-declared workspace revision associated with the imported evidence snapshot. Applies to: import_packet_evidence_snapshot."
  2. First observedv0.1.0

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, openWorldHint=true, idempotentHint=false and readOnlyHint=false, so the safety posture is known. The description adds real value beyond that: it discloses that some evidence-collection/audit routes use configured providers or inference, and that transitions/supersession can invalidate current authority. The request_id schema note also conveys the retry/receipt policy. This is meaningful behavioral context layered on the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Content is clearly labeled (Route, Prerequisites, Effects, Exact help) and the purpose is front-loaded, which is good structure. However, the 24-route enumeration plus the effects boilerplate is heavy prose for a multiplexer whose schema already lists the same canonical operations, so some text is redundant with structured fields rather than earning its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and the 78-parameter schema is fully documented. The description supplies purpose, routing, prerequisites, effects and a help pointer — sufficient for an agent to know which route to select. Deeper per-route argument semantics are deliberately deferred to fow_capabilities, which is a reasonable division of labor.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all 78 parameters, setting the baseline at 3. The description adds no per-parameter format or syntax detail but instead delegates exact per-operation parameter guidance to fow_capabilities. With the schema carrying the full burden, 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific domain (governed change plus packet readiness, engineering questions, evidence reconciliation, dependencies, risk dispositions) and enumerates all 24 routes, so the resource is unambiguous. It also explicitly routes plan authoring to the sibling fow_packet_author, giving clear differentiation. The aggregate 'manage X, Y, Z' framing is broad but the route list grounds it.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides a Prerequisites line (existing project/change/packet identities and the selected ordinary authority/evidence contract) and an Effects line, plus an explicit alternative ('Work plans are authored with fow_packet_author') and a concrete way to get per-route help via fow_capabilities. It does not, however, spell out when to prefer this tool over fow_packet_advance or fow_packet_inspect, leaving some sibling disambiguation implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.