mindwiki_create_proposal

Create a pending proposal for a vault change instead of writing directly. Proposals land in the user's review queue and require human approval before any change applies.

Scope: write

Parameters

Parameter	Type	Required	Description
`type`	string	Yes	Proposal type (see list below)
`summary`	string	Yes	Human-readable summary
`agent`	string	No	Agent or client creating the proposal
`target_files`	array of strings	No	Vault paths affected by this proposal
`rationale`	string	No	Why this proposal is useful
`diff`	string	No	Optional unified diff or before/after explanation
`payload`	object	No	Optional structured payload

Proposal types

edit_note, create_note, merge_notes, split_note, rename_note, move_note, add_tags, update_links, archive_note, flag_contradiction, create_decision, create_summary.

Example Request

json

{
  "tool": "mindwiki_create_proposal",
  "arguments": {
    "type": "merge_notes",
    "summary": "Merge feedback-loops-in-teams.md into patterns/feedback-loops.md — same concept, two captures",
    "agent": "Claude Desktop",
    "target_files": [
      "patterns/feedback-loops.md",
      "capture/2026-05-09-feedback-loops-in-teams.md"
    ],
    "rationale": "The capture restates content already on the canonical pattern page. Merging keeps signal in one place."
  }
}

Example Response

json

{
  "success": true,
  "proposal_id": "prop_2f1a8c9...",
  "status": "pending"
}

Use mindwiki_list_proposals to retrieve pending proposals later. See Proposals for the full workflow.