Targeted Line Range Edits

Targeted Line-Range Mutation Protocol (replace_file_content Precision)

Overview

When tasked with fixing a bug in an existing file (e.g., adding an error check to src/services/billing.ts), naive agents re-emit the entire 500-line file from scratch using whole-file overwrite tools (write_to_file(Overwrite: true)).

Full-file rewriting causes severe operational problems:

1. Severe Token Waste: Emitting 500 lines to change 5 lines burns 3,500+ output tokens per edit turn.
2. Git Merge Conflicts: Re-writing the entire file touches timestamps and trailing whitespace on 495 unchanged lines, breaking git blame and creating merge conflicts.
3. Accidental Deletions: Long generation streams frequently truncate or hallucinate omissions in unchanged functions.

The Targeted Line-Range Mutation Protocol uses replace_file_content with precise [StartLine, EndLine] bounding, modifying strictly the target 5-to-10 line slice.

Full-File Overwrite vs. Line-Range Replacement

┌─────────────────────────────────────────────────────────────┐
│                 Code Modification Comparison                │
│                                                             │
│  Full-File Overwrite (500 Lines / 3,800 Tokens):            │
│  • Agent regenerates lines 1 through 500                    │
│  • 3,800 output tokens billed ($0.057)                      │
│  • 18.2 seconds streaming duration                          │
│  • Risk of hallucinated omissions in downstream functions   │
│                                                             │
│  Targeted Line-Range Mutation (8 Lines / 45 Tokens):        │
│  • `replace_file_content(StartLine: 45, EndLine: 52)`       │
│  ↳ 45 clean tokens billed (98.8% Token Savings!)            │
│  ↳ 0.4 seconds execution duration, zero merge conflicts     │
└─────────────────────────────────────────────────────────────┘

The 4 Rules of Precision Line-Range Editing

┌───────────────────────────────────────────────────────────────────────────┐
│ 1. BOUND THE SEARCH RANGE: `StartLine` and `EndLine` must closely bracket │
│    the target (e.g. 5 lines before and after target block)                │
│                                                                           │
│ 2. EXACT CHARACTER MATCH: `TargetContent` must match leading indentation  │
│    and whitespace character-for-character                                 │
│                                                                           │
│ 3. COMPLETE DROP-IN REPLACEMENT: `ReplacementContent` must contain all    │
│    required lines without placeholder comments like `// rest of code...`  │
│                                                                           │
│ 4. SINGLE CONTIGUOUS BLOCK: Use `replace_file_content` for 1 block; use    │
│    `multi_replace_file_content` for multiple separated blocks             │
└───────────────────────────────────────────────────────────────────────────┘

Production Tool Invocation Standard

When patching an authentication check in src/auth.ts:

{
  "TargetFile": "c:/Users/ASUS/Documents/Newfolder/Antigravity/Major AI Skills/src/auth.ts",
  "StartLine": 42,
  "EndLine": 50,
  "TargetContent": "  const session = await getSession(token);\n  if (!session) {\n    return null;\n  }\n  return session.user;",
  "ReplacementContent": "  const session = await getSession(token);\n  if (!session || session.isExpired) {\n    logger.warn('Expired session access attempt');\n    return null;\n  }\n  return session.user;",
  "AllowMultiple": false,
  "Instruction": "Add expiration check and security warning to getSession verification.",
  "Description": "Fixed session expiration check in auth service.",
  "toolAction": "Patching session expiration check in auth.ts",
  "toolSummary": "Line Range Edit"
}

Benchmark Comparison

Applying 40 single-function bug fixes across full-stack repositories:

Agent Operational Directive

MANDATORY: Agents must NEVER overwrite entire source files to apply localized bug fixes or function edits. Always use replace_file_content with precise StartLine and EndLine parameters.