delete_file

The delete_file utility provides a secure method for Sypha to purge redundant files or comprehensive directory trees from your active project.

Parameters

• path (required): The relative path designated for removal.

Workflow Mechanics

1. Verification: Sypha first verifies that the target path is not a system-protected file or explicitly ignored via .syphaignore.
2. Content Analysis: When a directory is targeted, Sypha performs a recursive scan, reporting on the total file count and storage impact.
3. Authorization: Deletions never occur in the background; you must finalize the request via the interface. Sypha provides a clear summary of all assets slated for removal.

Integrity Protections

• Mitigated Command Risk: This tool is significantly safer than granting an AI raw shell access (rm -rf), as the management UI provides a detailed impact summary before action.
• Protected Environment: Critical IDE configurations and system-level directories are automatically safeguarded and cannot be removed using this utility.

Operational Examples

Removing a transient diagnostic file

<delete_file>
  <path>logs/error_dump.log</path>
</delete_file>

Removing an obsolete module directory

<delete_file>
  <path>src/modules/deprecated-feature/</path>
</delete_file>