delete_section
Remove specific sections from Markdown documents by ID or heading. The tool automatically saves changes and creates backups for document safety.
Instructions
Delete a section by ID or heading.
The document will be saved after the operation if successful and auto_save is True.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| document_path | Yes | ||
| section_id | No | ||
| heading | No | ||
| auto_save | No | ||
| backup | No | ||
| validation_level | No | NORMAL |
Implementation Reference
- Core handler function that executes the delete_section tool logic: validates the section reference, calculates deletion boundaries, removes the section content, updates the document state, records the transaction for rollback, and returns an EditResult.
def delete_section(self, section_ref: SectionReference, preserve_subsections: bool = False) -> EditResult: """ Delete a section from the document. Args: section_ref: Reference to section to delete preserve_subsections: If True, promote subsections to parent level Returns: EditResult with operation details """ with self._lock: try: # Validate section exists if not self._is_valid_section_reference(section_ref): return EditResult( success=False, operation=EditOperation.DELETE_SECTION, modified_sections=[], errors=[SafeParseError( message=f"Section not found: {section_ref.title}", error_code="SECTION_NOT_FOUND", category=ErrorCategory.VALIDATION, suggestions=["Verify section ID", "Refresh section references"] )], warnings=[] ) # Store rollback data rollback_data = self._current_text # Get current sections current_sections = self.get_sections() # Find section to delete target_section = None for section in current_sections: if section.id == section_ref.id: target_section = section break if not target_section: return EditResult( success=False, operation=EditOperation.DELETE_SECTION, modified_sections=[], errors=[SafeParseError( message="Target section not found in current document", error_code="SECTION_NOT_FOUND", category=ErrorCategory.VALIDATION )], warnings=[] ) # Calculate deletion bounds lines = self._current_text.split('\n') # Find next section at same or higher level to determine end bound delete_end_line = len(lines) for section in current_sections: if (section.line_start > target_section.line_start and section.level <= target_section.level): delete_end_line = section.line_start - 1 break # Simple deletion - remove entire section and subsections new_lines = (lines[:target_section.line_start - 1] + lines[delete_end_line:]) # Update document new_text = '\n'.join(new_lines) self._current_text = new_text self._current_result = self._parser.parse(new_text) self._wrapper = ASTWrapper(self._current_result) # Record transaction operation_dict = { 'operation': EditOperation.DELETE_SECTION, 'section_id': section_ref.id, 'content': "", 'preserve_subsections': preserve_subsections, 'deleted_title': target_section.title } self._record_transaction([operation_dict], rollback_data) # Update version self._version += 1 self._last_modified = datetime.now() return EditResult( success=True, operation=EditOperation.DELETE_SECTION, modified_sections=[section_ref], errors=[], warnings=[], metadata={ 'preserve_subsections': preserve_subsections, 'version': self._version } ) except Exception as e: return EditResult( success=False, operation=EditOperation.DELETE_SECTION, modified_sections=[], errors=[SafeParseError( message=f"Delete operation failed: {str(e)}", error_code="DELETE_ERROR", category=ErrorCategory.SYSTEM )], warnings=[] ) - src/quantalogic_markdown_mcp/mcp_server.py:141-202 (registration)MCP tool registration for 'delete_section'. Defines input parameters (document_path, section_id or heading, etc.), resolves the section reference, calls the SafeMarkdownEditor.delete_section handler, and handles stateless execution with auto-save and backup.
def delete_section(document_path: str, section_id: Optional[str] = None, heading: Optional[str] = None, auto_save: bool = True, backup: bool = True, validation_level: str = "NORMAL") -> Dict[str, Any]: """ Delete a section by ID or heading. The document will be saved after the operation if successful and auto_save is True. """ """ Delete a section by ID or heading. Args: document_path: Path to the Markdown file section_id: The section ID to delete (optional) heading: The section heading to delete (optional) auto_save: Whether to automatically save the document backup: Whether to create a backup before saving validation_level: Validation strictness - "STRICT", "NORMAL", or "PERMISSIVE" """ def operation(editor): if section_id: # Find section by ID section_ref = editor.get_section_by_id(section_id) if not section_ref: from .safe_editor_types import EditResult, OperationType return EditResult( success=False, operation=OperationType.DELETE, modified_sections=[], errors=[f"Section with ID '{section_id}' not found"], warnings=[] ) elif heading: # Find section by heading sections = editor.get_sections() matching_sections = [s for s in sections if s.title == heading] if not matching_sections: from .safe_editor_types import EditResult, OperationType return EditResult( success=False, operation=OperationType.DELETE, modified_sections=[], errors=[f"Section with heading '{heading}' not found"], warnings=[] ) section_ref = matching_sections[0] else: from .safe_editor_types import EditResult, OperationType return EditResult( success=False, operation=OperationType.DELETE, modified_sections=[], errors=["Either section_id or heading must be provided"], warnings=[] ) return editor.delete_section(section_ref, preserve_subsections=False) validation_map = {"STRICT": ValidationLevel.STRICT, "NORMAL": ValidationLevel.NORMAL, "PERMISSIVE": ValidationLevel.PERMISSIVE} validation_enum = validation_map.get(validation_level.upper(), ValidationLevel.NORMAL) return self.processor.execute_operation(document_path, operation, auto_save, backup, validation_enum) - Enum defining EditOperation.DELETE_SECTION used throughout for operation typing and result tracking.
class EditOperation(Enum): """Supported editing operations.""" INSERT_SECTION = "insert_section" UPDATE_SECTION = "update_section" DELETE_SECTION = "delete_section" MOVE_SECTION = "move_section" CHANGE_HEADING_LEVEL = "change_heading_level" INSERT_CONTENT = "insert_content" DELETE_CONTENT = "delete_content" BATCH_OPERATIONS = "batch_operations" - Dataclass defining SectionReference type, used as input parameter for delete_section handler.
@dataclass(frozen=True) class SectionReference: """Immutable reference to a document section.""" id: str # Stable hash-based identifier title: str # Section heading text level: int # Heading level (1-6) line_start: int # Starting line number (0-indexed) line_end: int # Ending line number (0-indexed) path: List[str] # Hierarchical path from root def __hash__(self) -> int: """Hash based on immutable properties.""" return hash((self.id, self.title, self.level, self.line_start)) def __eq__(self, other) -> bool: """Equality based on ID and position.""" return (isinstance(other, SectionReference) and self.id == other.id and self.line_start == other.line_start) - src/quantalogic_markdown_mcp/enhanced_mcp_server.py:94-123 (registration)Alternative/enhanced MCP tool registration for 'delete_section' in the enhanced server.
def delete_section(document_path: str, section_id: Optional[str] = None, heading: Optional[str] = None, auto_save: bool = True, backup: bool = True, validation_level: str = "NORMAL") -> Dict[str, Any]: """Delete a section (stateless only).""" def operation(editor: SafeMarkdownEditor): if section_id: section = editor.get_section_by_id(section_id) elif heading: sections = editor.get_sections() section = next((s for s in sections if s.title == heading), None) else: from .safe_editor_types import EditResult return EditResult( success=False, operation=EditOperation.DELETE_SECTION, errors=["Either section_id or heading must be provided"] ) if section: return editor.delete_section(section, preserve_subsections=False) else: from .safe_editor_types import EditResult return EditResult( success=False, operation=EditOperation.DELETE_SECTION, errors=["Section not found"] ) validation_map = {"STRICT": ValidationLevel.STRICT, "NORMAL": ValidationLevel.NORMAL, "PERMISSIVE": ValidationLevel.PERMISSIVE} validation_enum = validation_map.get(validation_level.upper(), ValidationLevel.NORMAL) return self.processor.execute_operation(document_path, operation, auto_save, backup, validation_enum)