ctx_refactor

{
  "properties": {
    "action": {
      "description": "rename|references|definition|implementations|declaration|type_hierarchy|symbols_overview|inspections|replace_symbol_body|insert_before_symbol|insert_after_symbol|rename_preview|rename_apply|move_preview|move_apply|safe_delete_preview|safe_delete_apply|inline_preview|inline_apply|reformat",
      "type": "string"
    },
    "column": {
      "description": "0-indexed column",
      "type": "integer"
    },
    "direction": {
      "description": "supertypes|subtypes",
      "enum": [
        "supertypes",
        "subtypes"
      ],
      "type": "string"
    },
    "end_line": {
      "description": "1-based last line (path+line fallback)",
      "type": "integer"
    },
    "expected_hash": {
      "description": "BLAKE3 hex of current range (TOCTOU guard)",
      "type": "string"
    },
    "file": {
      "description": "Scope name_path resolution to this file (avoids AMBIGUOUS_SYMBOL for common names)",
      "type": "string"
    },
    "force": {
      "description": "Override refactoring conflicts",
      "type": "boolean"
    },
    "keep_definition": {
      "description": "Keep declaration after inline",
      "type": "boolean"
    },
    "line": {
      "description": "1-indexed line",
      "type": "integer"
    },
    "mode": {
      "description": "run|list",
      "enum": [
        "run",
        "list"
      ],
      "type": "string"
    },
    "name_path": {
      "description": "Symbol path for body edits (qualified or bare)",
      "type": "string"
    },
    "new_name": {
      "description": "New symbol name",
      "type": "string"
    },
    "new_text": {
      "description": "Full replacement declaration text (replace_symbol_body)",
      "type": "string"
    },
    "optimize_imports": {
      "description": "Remove unused imports",
      "type": "boolean"
    },
    "path": {
      "description": "Path",
      "type": "string"
    },
    "plan_hash": {
      "description": "BLAKE3 plan hash from rename_preview",
      "type": "string"
    },
    "propagate": {
      "description": "Delete unreferenced dependencies",
      "type": "boolean"
    },
    "scope": {
      "description": "project|all",
      "enum": [
        "project",
        "all"
      ],
      "type": "string"
    },
    "search_comments": {
      "description": "Rename in comments/strings",
      "type": "boolean"
    },
    "search_text_occurrences": {
      "description": "Rename in non-code text",
      "type": "boolean"
    },
    "target_parent": {
      "description": "Destination parent symbol for member move",
      "type": "string"
    },
    "target_path": {
      "description": "Destination directory/file (project-relative)",
      "type": "string"
    },
    "text": {
      "description": "Sibling text to insert (auto-indented)",
      "type": "string"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Rename, move, safe_delete, inline, read-only analyses via LSP/IDE.
WORKFLOW: use action=references first to find usages before refactoring.
ANTIPATTERN: not for symbol discovery — use ctx_symbol/ctx_compose.
Single-phase edits (replace_symbol_body, reformat) work headless via name_path.
Two-phase ops (_preview+_apply) need JetBrains IDE (else BACKEND_REQUIRED).
Conflicts blocked unless force=true. See `action` parameter for full list.