[FEATURE] Add MultiEdit Tool

[edenreich]

Summary

Introduce MultiEdit, a batch editing tool built on top of Edit to perform multiple exact find-and-replace operations on a single file in one atomic action. Prefer MultiEdit over Edit when changing several parts of the same file.

Why

Reduces round trips and risk of partial edits; guarantees all-or-nothing changes when multiple replacements are needed.

Spec (condensed)

• name: MultiEdit

• input:

  • file_path (string, absolute)
  • edits (array, min 1) of objects:
    • old_string (string, exact match incl. whitespace)
    • new_string (string)
    • replace_all (boolean, default false)

• Preconditions: Must use Read first; verify directory path.

• Behavior:

  • Apply edits in order, each on the result of previous.
  • Atomic: if any edit fails, none are applied.
  • Same requirements as Edit.

• Warnings / Failures:

  • Fail if old_string doesn’t match exactly.
  • Fail if old_string == new_string.
  • Earlier edits may affect later matches—caller must plan accordingly.

• Guidelines:

  • Keep code idiomatic and unbroken.
  • Always use absolute paths.
  • Use replace_all for broad renames.
  • No emojis unless explicitly requested.
  • To create a new file: supply a new absolute path; first edit uses empty old_string and full file content in new_string.

Acceptance Criteria

• CLI exposes MultiEdit adhering to the above spec.
• Edits execute sequentially and transactionally (all-or-nothing).
• Proper error messages for mismatches, identical old/new strings, and partial-failure scenarios.
• Verified workflow: Read → MultiEdit on existing file and on new-file creation path.
• Tests cover ordered edits, replace_all, rollback on failure, and .ipynb guard.

[edenreich]

@claude Can you implement this tool?

[claude]

Claude finished @edenreich's task —— View job • claude/issue-60-20250817-0138 • Create PR ➔

---

Implementing MultiEdit Tool ✅

I have successfully implemented the MultiEdit tool as requested! Here's what was accomplished:

Todo List

• Analyze codebase structure and existing Edit tool implementation
• Design MultiEdit tool following the specification
• Add MultiEditToolResult domain type
• Implement MultiEdit tool with sequential, atomic operations
• Add MultiEdit to tool registry
• Add comprehensive tests covering all scenarios
• Run quality checks (format, lint, test)
• Commit changes and provide PR link

Implementation Summary

MultiEdit Tool Features:

• ✅ Built on top of the existing Edit tool architecture
• ✅ Performs multiple exact find-and-replace operations atomically
• ✅ Sequential edits - each edit operates on the result of the previous edit
• ✅ All-or-nothing behavior - if any edit fails, none are applied
• ✅ Supports both existing files and new file creation
• ✅ Includes replace_all parameter for each edit operation
• ✅ Comprehensive error handling and validation
• ✅ Same security constraints as the Edit tool

Files Modified/Created:

1. internal/domain/interfaces.go - Added MultiEditToolResult and EditOperationResult types
2. internal/services/tools/multiedit.go - Complete MultiEdit tool implementation
3. internal/services/tools/multiedit_test.go - Comprehensive test suite
4. internal/services/tools/registry.go - Registered MultiEdit tool

Test Coverage:

• ✅ Tool definition validation
• ✅ Read tool usage requirement
• ✅ Successful multiple edits with different parameters
• ✅ Sequential edits changing content between operations
• ✅ Atomic failure rollback when any edit fails
• ✅ Non-unique string handling with and without replace_all
• ✅ New file creation workflow
• ✅ Comprehensive input validation
• ✅ Tool enable/disable behavior

Quality Assurance:

• ✅ All tests pass (12 test functions, 15 sub-tests)
• ✅ Code formatting applied
• ✅ Linter issues resolved
• ✅ Go vet checks pass
• ✅ Follows repository coding standards

Committed & Ready:
Changes have been committed to branch claude/issue-60-20250817-0138 with commit SHA: e6a1a27589fb9a1b471d9ae52e83020171623eeb

The MultiEdit tool is now ready and available in the CLI, providing efficient batch editing capabilities while maintaining the same safety and security guarantees as the existing Edit tool.

---

[ig-semantic-release-bot]

🎉 This issue has been resolved in version 0.22.0 🎉

The release is available on:

• v0.22.0
• GitHub release

Your semantic-release bot 📦🚀