@oh-my-pi/hashline 15.13.2 → 16.0.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [15.13.3] - 2026-06-15
+
+### Changed
+
+- Changed the recommended hashline range separator from `..` to `.=` (e.g. `SWAP 1.=3:`, `DEL 4.=5`) so the inclusive `<=`-style end is self-evident. `HL_RANGE_SEP` is now `.=`; the prompt, grammar, error messages, and emitted headers all use it. The lenient parser still accepts the legacy `..` (and `-`/`…`/space) forms.
+
 ## [15.13.2] - 2026-06-15
 
 ### Breaking Changes

package/README.md

@@ -26,7 +26,7 @@ await fs.writeText("hello.ts", before);
 const tag = snapshots.record("hello.ts", before);
 const patcher = new Patcher({ fs, snapshots });
 const patch = Patch.parse(String.raw`[hello.ts#${tag}]
-SWAP 1..1:
+SWAP 1.=1:
 +const greeting = "hello";`);
 const result = await patcher.apply(patch);
 
@@ -47,9 +47,9 @@ still matches the recorded content hash, and refusing or attempting
 session-aware recovery on mismatch.
 
 Inside a section:
-- `SWAP A..B:` — replace lines A..B with following `+TEXT` body rows.
+- `SWAP A.=B:` — replace lines A.=B with following `+TEXT` body rows.
 - `SWAP.BLK A:` — replace the syntactic block beginning on line A.
-- `DEL A..B` / `DEL.BLK A` — delete concrete lines or a resolved block.
+- `DEL A.=B` / `DEL.BLK A` — delete concrete lines or a resolved block.
 - `INS.PRE A:` / `INS.POST A:` / `INS.HEAD:` / `INS.TAIL:` — insert following body rows.
 - `INS.BLK.POST A:` — insert following body rows after the resolved block's last line.
 - `+TEXT` — literal body row (use `+` alone for a blank line).

package/dist/types/format.d.ts

@@ -32,8 +32,8 @@ export declare const HL_INSERT_AFTER_BLOCK_KEYWORD = "INS.BLK.POST";
 export declare const HL_HEADER_COLON = ":";
 /** Separator between a hashline file path and its opaque snapshot tag. */
 export declare const HL_FILE_HASH_SEP = "#";
-/** Separator between two line numbers in a range, e.g. `5..10`. */
-export declare const HL_RANGE_SEP = "..";
+/** Separator between two line numbers in a range, e.g. `5.=10`. */
+export declare const HL_RANGE_SEP = ".=";
 /** Separator between a line number and displayed line content in hashline mode. */
 export declare const HL_LINE_BODY_SEP = ":";
 /** Bare positive line-number Lid (no decorations, no captures, no anchors). */

package/dist/types/messages.d.ts

@@ -17,13 +17,13 @@ export declare const END_PATCH_MARKER = "*** End Patch";
  */
 export declare const ABORT_MARKER = "*** Abort";
 /** Two consecutive hunks targeted the exact same concrete range. */
-export declare const REPLACE_PAIR_COALESCED_WARNING = "Two hunks targeted the same range; kept only the second. One `SWAP N..M:` hunk per range \u2014 the body is the final content, never old+new.";
+export declare const REPLACE_PAIR_COALESCED_WARNING = "Two hunks targeted the same range; kept only the second. One `SWAP N.=M:` hunk per range \u2014 the body is the final content, never old+new.";
 /** Bare body rows auto-converted to literal `+` rows. */
 export declare const BARE_BODY_AUTO_PIPED_WARNING = "Auto-prefixed bare body row(s) with `+`. Body rows must be `+TEXT` literal lines.";
 /** Unified-diff-style `-` row in a hunk body. */
 export declare const MINUS_ROW_REJECTED = "`-` rows are not valid; the range already names the lines being changed. For a literal `-` line, write `+-\u2026`.";
 /** Replace hunk with no body. */
-export declare const EMPTY_REPLACE = "`SWAP N..M:` needs at least one `+TEXT` body row. To delete lines, use `DEL N..M`.";
+export declare const EMPTY_REPLACE = "`SWAP N.=M:` needs at least one `+TEXT` body row. To delete lines, use `DEL N.=M`.";
 /** `replace_block N:` hunk with no body. */
 export declare const EMPTY_BLOCK = "`SWAP.BLK N:` needs at least one `+TEXT` body row. To delete a block, use `DEL.BLK N`.";
 /**
@@ -55,7 +55,7 @@ export declare function insertAfterBlockUnresolvedLoweredWarning(line: number):
  */
 export declare const UNRESOLVED_BLOCK_INTERNAL = "internal error: unresolved `SWAP.BLK` edit reached the applier (resolveBlockEdits was not run).";
 /** Delete hunk received a body row. */
-export declare const DELETE_TAKES_NO_BODY = "`DEL N..M` does not take body rows. Remove the body, or use `SWAP N..M:`.";
+export declare const DELETE_TAKES_NO_BODY = "`DEL N.=M` does not take body rows. Remove the body, or use `SWAP N.=M:`.";
 /** `delete_block N` hunk received a body row. */
 export declare const DELETE_BLOCK_TAKES_NO_BODY = "`DEL.BLK N` does not take body rows. Remove the body, or use `SWAP.BLK N:`.";
 /** Insert hunk with no body. */

package/dist/types/types.d.ts

@@ -53,7 +53,7 @@ export type Edit = {
      * time — it is computed by {@link resolveBlockEdits} once file text +
      * path (→ language) are available, then expanded into concrete edits:
      * a non-empty `payloads` without `mode` (from `replace_block`) becomes
-     * the same `replacement` inserts + deletes that `replace start..end:`
+     * the same `replacement` inserts + deletes that `replace start.=end:`
      * produces; an empty `payloads` (from `delete_block`) becomes a pure
      * range deletion; `mode: "insert_after"` becomes plain `after_anchor`
      * inserts at the block's last line. `applyEdits` never sees this
@@ -82,7 +82,7 @@ export interface ApplyResult {
      */
     blockResolutions?: BlockResolution[];
 }
-/** A parsed `[A..B]` line range. */
+/** A parsed `[A.=B]` line range. */
 export interface ParsedRange {
     start: Anchor;
     end: Anchor;
@@ -132,7 +132,7 @@ export interface BlockSpan {
 /**
  * One `replace_block N:` / `delete_block N` / `insert_after_block N:` anchor
  * resolved to its concrete line span. Surfaced on {@link ApplyResult} so the
- * host can echo "block N → lines start..end" and let the model catch a wrong
+ * host can echo "block N → lines start.=end" and let the model catch a wrong
  * opener — e.g. a decorator or doc-comment that sits in a separate node
  * outside the resolved block.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/hashline",
-	"version": "15.13.2",
+	"version": "16.0.0",
 	"description": "Hashline: a compact, line-anchored patch language and applier. Pluggable FS/IO so it works over disk, in-memory, or any custom backend.",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",

package/src/apply.ts

@@ -232,7 +232,7 @@ interface ReplacementGroup {
  * Detect a replacement group starting at `start`: a run of `before_anchor`
  * replacement inserts sharing one source op line, immediately followed by the
  * contiguous range deletes for that same op. Mirrors how the parser lowers an
- * `replace N..M:` hunk with a body.
+ * `replace N.=M:` hunk with a body.
  */
 function findReplacementGroup(edits: readonly AppliedEdit[], start: number): ReplacementGroup | undefined {
 	const first = edits[start];
@@ -453,7 +453,7 @@ function describeBoundaryRepair(group: ReplacementGroup, action: string): string
  * by {@link findDuplicateSuffix}/{@link findDuplicatePrefix}.
  *
  * Scoped to multi-line ranges (a construct rewrite) on purpose: a single-line
- * `replace N..N` expanding into several lines is an *expansion* where every
+ * `replace N.=N` expanding into several lines is an *expansion* where every
  * payload line is intentional new content, so a payload line that happens to
  * equal a neighbor stays — only a genuine block rewrite retypes a boundary
  * keeper by mistake. The dropped lines must be delimiter-neutral so removing the

package/src/block.ts

@@ -7,7 +7,7 @@
  * runs at every apply/preview boundary that has text: it calls the injected
  * {@link BlockResolver} to resolve each block's `[start, end]` span, then emits
  * the exact same edits the concrete form produces in the parser: `replace
- * start..end:` inserts + deletes for a replace, a pure range delete for a
+ * start.=end:` inserts + deletes for a replace, a pure range delete for a
  * delete, and plain `after_anchor` inserts at `end` for an insert-after. After
  * it runs, no `block` edits remain, so {@link applyEdits} (and recovery) only
  * ever see resolved edits.
@@ -145,7 +145,7 @@ export function resolveBlockEdits(
 			}
 			continue;
 		}
-		// Mirror the parser's `replace start..end:` expansion exactly: one
+		// Mirror the parser's `replace start.=end:` expansion exactly: one
 		// `before_anchor` replacement insert per payload row at `span.start`,
 		// then one delete per line across `[span.start, span.end]`. An empty
 		// `payloads` (from `delete_block N`) emits no inserts — a pure deletion.

package/src/format.ts

@@ -38,8 +38,8 @@ export const HL_HEADER_COLON = ":";
 /** Separator between a hashline file path and its opaque snapshot tag. */
 export const HL_FILE_HASH_SEP = "#";
 
-/** Separator between two line numbers in a range, e.g. `5..10`. */
-export const HL_RANGE_SEP = "..";
+/** Separator between two line numbers in a range, e.g. `5.=10`. */
+export const HL_RANGE_SEP = ".=";
 
 /** Separator between a line number and displayed line content in hashline mode. */
 export const HL_LINE_BODY_SEP = ":";

package/src/grammar.lark

@@ -21,7 +21,7 @@ insert_block_anchor: "INS.BLK.POST " LID ":"
 insert_pos: "PRE " LID | "POST " LID | "HEAD" | "TAIL"
 emit_op: "+" /(.*)/ LF
 
-header_range: LID ".." LID
+header_range: LID ".=" LID
 LID: /[1-9]\d*/
 
 %import common.LF

package/src/messages.ts

@@ -1,6 +1,6 @@
 /** Centralized error/warning text for the hashline parser, applier, and patcher. */
 
-import { formatNumberedLine, HL_FILE_HASH_SEP, HL_FILE_PREFIX, HL_FILE_SUFFIX } from "./format";
+import { formatNumberedLine, HL_FILE_HASH_SEP, HL_FILE_PREFIX, HL_FILE_SUFFIX, HL_RANGE_SEP } from "./format";
 
 /** Lines of context shown either side of a hash mismatch. */
 export const MISMATCH_CONTEXT = 2;
@@ -43,11 +43,10 @@ export const END_PATCH_MARKER = "*** End Patch";
 export const ABORT_MARKER = "*** Abort";
 
 /** Two consecutive hunks targeted the exact same concrete range. */
-export const REPLACE_PAIR_COALESCED_WARNING =
-	"Two hunks targeted the same range; kept only the second. One `SWAP N..M:` hunk per range — the body is the final content, never old+new.";
+export const REPLACE_PAIR_COALESCED_WARNING = `Two hunks targeted the same range; kept only the second. One \`SWAP N${HL_RANGE_SEP}M:\` hunk per range — the body is the final content, never old+new.`;
 
 /** Bare bodyless hunk followed by an overlapping concrete hunk. */
-("Dropped a bare hunk overlapped by the concrete hunk after it. One `SWAP N..M:` hunk per range — the body is the final content, never old+new.");
+`Dropped a bare hunk overlapped by the concrete hunk after it. One \`SWAP N${HL_RANGE_SEP}M:\` hunk per range — the body is the final content, never old+new.`;
 
 /** Bare body rows auto-converted to literal `+` rows. */
 export const BARE_BODY_AUTO_PIPED_WARNING =
@@ -58,7 +57,7 @@ export const MINUS_ROW_REJECTED =
 	"`-` rows are not valid; the range already names the lines being changed. For a literal `-` line, write `+-…`.";
 
 /** Replace hunk with no body. */
-export const EMPTY_REPLACE = "`SWAP N..M:` needs at least one `+TEXT` body row. To delete lines, use `DEL N..M`.";
+export const EMPTY_REPLACE = `\`SWAP N${HL_RANGE_SEP}M:\` needs at least one \`+TEXT\` body row. To delete lines, use \`DEL N${HL_RANGE_SEP}M\`.`;
 
 /** `replace_block N:` hunk with no body. */
 export const EMPTY_BLOCK = "`SWAP.BLK N:` needs at least one `+TEXT` body row. To delete a block, use `DEL.BLK N`.";
@@ -77,7 +76,7 @@ export function blockUnresolvedMessage(
 	fileLines?: readonly string[],
 ): string {
 	const phrase = op === "delete" ? `DEL.BLK ${line}` : `SWAP.BLK ${line}:`;
-	const fallback = op === "delete" ? `DEL ${line}..M` : `SWAP ${line}..M:`;
+	const fallback = op === "delete" ? `DEL ${line}${HL_RANGE_SEP}M` : `SWAP ${line}${HL_RANGE_SEP}M:`;
 	let message =
 		`\`${phrase}\` could not resolve a syntactic block beginning on line ${line} ` +
 		`(unsupported language, blank/closer line, or parse error). Use \`${fallback}\` with explicit lines.`;
@@ -118,7 +117,7 @@ export const UNRESOLVED_BLOCK_INTERNAL =
 	"internal error: unresolved `SWAP.BLK` edit reached the applier (resolveBlockEdits was not run).";
 
 /** Delete hunk received a body row. */
-export const DELETE_TAKES_NO_BODY = "`DEL N..M` does not take body rows. Remove the body, or use `SWAP N..M:`.";
+export const DELETE_TAKES_NO_BODY = `\`DEL N${HL_RANGE_SEP}M\` does not take body rows. Remove the body, or use \`SWAP N${HL_RANGE_SEP}M:\`.`;
 
 /** `delete_block N` hunk received a body row. */
 export const DELETE_BLOCK_TAKES_NO_BODY = "`DEL.BLK N` does not take body rows. Remove the body, or use `SWAP.BLK N:`.";
@@ -226,7 +225,11 @@ export type BlockOp = "replace" | "delete" | "insert_after";
 export function blockSingleLineMessage(line: number, op: BlockOp): string {
 	const blockForm = op === "insert_after" ? "INS.BLK.POST" : op === "delete" ? "DEL.BLK" : "SWAP.BLK";
 	const plainForm =
-		op === "insert_after" ? `INS.POST ${line}:` : op === "delete" ? `DEL ${line}` : `SWAP ${line}..${line}:`;
+		op === "insert_after"
+			? `INS.POST ${line}:`
+			: op === "delete"
+				? `DEL ${line}`
+				: `SWAP ${line}${HL_RANGE_SEP}${line}:`;
 	return (
 		`\`${blockForm} ${line}\` resolved a single-line block — line ${line} is a bare statement, not the opening line ` +
 		`of a multi-line construct. For that one line use \`${plainForm}\`; to act on an enclosing construct, anchor ${blockForm} ` +

package/src/parser.ts

@@ -3,7 +3,7 @@
  * flat list of {@link Edit}s. Sits between the {@link Tokenizer} and the
  * applier.
  */
-import { HL_PAYLOAD_REPLACE } from "./format";
+import { HL_PAYLOAD_REPLACE, HL_RANGE_SEP } from "./format";
 import {
 	BARE_BODY_AUTO_PIPED_WARNING,
 	DELETE_BLOCK_TAKES_NO_BODY,
@@ -18,7 +18,9 @@ import type { Anchor, Cursor, Edit } from "./types";
 
 function validateRangeOrder(range: ParsedRange, lineNum: number): void {
 	if (range.end.line < range.start.line) {
-		throw new Error(`line ${lineNum}: range ${range.start.line}..${range.end.line} ends before it starts.`);
+		throw new Error(
+			`line ${lineNum}: range ${range.start.line}${HL_RANGE_SEP}${range.end.line} ends before it starts.`,
+		);
 	}
 }
 
@@ -52,33 +54,33 @@ function detectApplyPatchContamination(text: string, _hasPending: boolean): stri
 		return (
 			`apply_patch sentinel ${JSON.stringify(preview)} is not valid in hashline. ` +
 			"File sections start with `[path#HASH]` (no `Update File:` / `Add File:` keyword). " +
-			"Use `SWAP N..M:`, `DEL N..M`, or `INS.PRE|POST|HEAD|TAIL:` ops."
+			`Use \`SWAP N${HL_RANGE_SEP}M:\`, \`DEL N${HL_RANGE_SEP}M\`, or \`INS.PRE|POST|HEAD|TAIL:\` ops.`
 		);
 	}
 	if (/^@@\s+[-+]?\d+,\d+\s+[-+]?\d+,\d+\s+@@/.test(trimmed)) {
 		return (
 			"unified-diff hunk header (`@@ -N,M +N,M @@`) is not valid in hashline. " +
-			"Use `SWAP N..M:`, `DEL N..M`, or `INS.PRE|POST|HEAD|TAIL:` ops."
+			`Use \`SWAP N${HL_RANGE_SEP}M:\`, \`DEL N${HL_RANGE_SEP}M\`, or \`INS.PRE|POST|HEAD|TAIL:\` ops.`
 		);
 	}
 	if (trimmed.startsWith("@@")) {
 		const preview = trimmed.length > 48 ? `${trimmed.slice(0, 48)}…` : trimmed;
 		return (
 			`\`@@\`-bracketed hunk header ${JSON.stringify(preview)} is not valid in hashline. ` +
-			"Drop the `@@ ... @@` brackets and write a verb header such as `SWAP N..M:`."
+			`Drop the \`@@ ... @@\` brackets and write a verb header such as \`SWAP N${HL_RANGE_SEP}M:\`.`
 		);
 	}
-	if (/^DEL\s+[1-9]\d*(?:\s*(?:\.\.|-|…|\s)\s*[1-9]\d*)?\s*:/.test(trimmed)) {
-		return "`DEL N..M` has no colon and no body. Remove the colon and body rows.";
+	if (/^DEL\s+[1-9]\d*(?:\s*(?:\.\.|\.=|-|…|\s)\s*[1-9]\d*)?\s*:/.test(trimmed)) {
+		return `\`DEL N${HL_RANGE_SEP}M\` has no colon and no body. Remove the colon and body rows.`;
 	}
 	if (/^[1-9]\d*\s*$/.test(trimmed)) {
-		return `hunk headers need a verb. Use \`SWAP ${trimmed}..${trimmed}:\` to replace, or \`DEL ${trimmed}\` to delete.`;
+		return `hunk headers need a verb. Use \`SWAP ${trimmed}${HL_RANGE_SEP}${trimmed}:\` to replace, or \`DEL ${trimmed}\` to delete.`;
 	}
-	const bareRange = /^([1-9]\d*)\s*[-. …]+\s*([1-9]\d*)\s*:?$/.exec(trimmed);
+	const bareRange = /^([1-9]\d*)\s*[-. …=]+\s*([1-9]\d*)\s*:?$/.exec(trimmed);
 	if (bareRange !== null) {
 		return (
 			`bare range hunk header ${JSON.stringify(trimmed)} is not valid. ` +
-			`Hunk headers need a verb: write \`SWAP ${bareRange[1]}..${bareRange[2]}:\` or \`DEL ${bareRange[1]}..${bareRange[2]}\`.`
+			`Hunk headers need a verb: write \`SWAP ${bareRange[1]}${HL_RANGE_SEP}${bareRange[2]}:\` or \`DEL ${bareRange[1]}${HL_RANGE_SEP}${bareRange[2]}\`.`
 		);
 	}
 	return null;
@@ -253,7 +255,7 @@ export class Executor {
 		if (text.trim().length === 0) return;
 		throw new Error(
 			`line ${lineNum}: payload line has no preceding hunk header. ` +
-				`Use \`SWAP N..M:\`, \`DEL N..M\`, or \`INS.PRE|POST|HEAD|TAIL:\` above the body. Got ${JSON.stringify(text)}.`,
+				`Use \`SWAP N${HL_RANGE_SEP}M:\`, \`DEL N${HL_RANGE_SEP}M\`, or \`INS.PRE|POST|HEAD|TAIL:\` above the body. Got ${JSON.stringify(text)}.`,
 		);
 	}
 

package/src/prompt.md

@@ -5,16 +5,16 @@ Every file section starts with `[PATH#TAG]`. `TAG` is the 4-hex snapshot tag fro
 </headers>
 
 <ops>
-`SWAP N..M:` — replace original lines N..M with the body rows below. INCLUSIVE — line M is consumed too.
+`SWAP N.=M:` — replace original lines N.=M with the body rows below. INCLUSIVE — line M is consumed too.
 `SWAP.BLK N:` — replace the whole syntactic block that BEGINS on line N; tree-sitter resolves the closing line. Body rows below.
-`DEL N..M` — delete original lines N..M. No body.
+`DEL N.=M` — delete original lines N.=M. No body.
 `DEL.BLK N` — delete the whole syntactic block that BEGINS on line N.
 `INS.PRE N:` — insert the body rows immediately before line N.
 `INS.POST N:` — insert the body rows immediately after line N.
 `INS.BLK.POST N:` — insert the body rows after the END of the block that BEGINS on line N — outside it, at sibling depth. To append inside a block, use `INS.POST`.
 `INS.HEAD:` — insert the body rows at the very start of the file.
 `INS.TAIL:` — insert the body rows at the very end of the file.
-Single line: `SWAP N..N:` / `DEL N`. The range is the ORIGINAL lines you touch; body length is irrelevant (replacing 1 line with 10 is still `SWAP N..N:`).
+Single line: `SWAP N.=N:` / `DEL N`. The range is the ORIGINAL lines you touch; body length is irrelevant (replacing 1 line with 10 is still `SWAP N.=N:`).
 </ops>
 
 <body-rows>
@@ -34,9 +34,9 @@ There is NO other body row kind. NEVER write `-old` or a bare/context line. To k
 - On a stale-tag rejection or any surprising result: STOP and re-`read` before further edits.
 - One hunk per range; the body is the final content, never an old/new pair.
 - Ranges cover ONLY lines whose content changes. Never widen over unchanged lines — a stale wide range shreds everything it spans.
-- Whole construct → `SWAP.BLK N` (tree-sitter resolves the end); lines inside it → `SWAP N..M`.
-- `SWAP.BLK N` resolves EXACTLY the node at N. Leading decorators/attributes/doc-comments are separate nodes: point N at the FIRST decorator to sweep both; standalone line-comments are never swept — use `SWAP N..M`.
-- Block ops (`SWAP.BLK`/`DEL.BLK`/`INS.BLK.POST`) anchor the OPENING line of a MULTI-LINE construct — never its closer, its last line, or a bare statement inside it. Anchoring a single statement resolves to ONE line and is REJECTED: use the plain op (`SWAP N..N` / `DEL N` / `INS.POST N`) for one line, or point N at the real opener. Saw the closer? Use plain `INS.POST M:`.
+- Whole construct → `SWAP.BLK N` (tree-sitter resolves the end); lines inside it → `SWAP N.=M`.
+- `SWAP.BLK N` resolves EXACTLY the node at N. Leading decorators/attributes/doc-comments are separate nodes: point N at the FIRST decorator to sweep both; standalone line-comments are never swept — use `SWAP N.=M`.
+- Block ops (`SWAP.BLK`/`DEL.BLK`/`INS.BLK.POST`) anchor the OPENING line of a MULTI-LINE construct — never its closer, its last line, or a bare statement inside it. Anchoring a single statement resolves to ONE line and is REJECTED: use the plain op (`SWAP N.=N` / `DEL N` / `INS.POST N`) for one line, or point N at the real opener. Saw the closer? Use plain `INS.POST M:`.
 - Non-adjacent changes = separate hunks; untouched lines stay out of every range.
 - Pure additions use `INS.PRE` / `INS.POST` / `INS.HEAD` / `INS.TAIL`, never a widened `SWAP` — retyped keepers are exactly what gets dropped. A multi-line `SWAP` whose body restates the line just outside the range is auto-dropped as an off-by-one keeper (with a warning), but issue the payload as the final content for the range only and never lean on the repair.
 - NEVER format/restyle code with this tool; run the project formatter instead.
@@ -62,7 +62,7 @@ INS.POST 1:
 Replace line 2 with two lines:
 ```
 [greet.py#A1B2]
-SWAP 2..2:
+SWAP 2.=2:
 +    greeting = "Hi"
 +    msg = f"{greeting}, {name}"
 ```
@@ -102,24 +102,24 @@ SWAP.BLK 1:
 
 <anti-patterns>
 # WRONG — empty `SWAP` to delete. RIGHT: DEL 4
-SWAP 4..4:
+SWAP 4.=4:
 
-# WRONG — range describes post-edit size. RIGHT: SWAP 1..1: (body length is irrelevant)
-SWAP 1..2:
+# WRONG — range describes post-edit size. RIGHT: SWAP 1.=1: (body length is irrelevant)
+SWAP 1.=2:
 +def greet(name):
 
 # WRONG — `-` rows / bare context lines do not exist. The range deletes; the body is only the new content.
-SWAP 3..3:
+SWAP 3.=3:
     msg = "Hello, " + name
 -   print(msg)
 +   return msg
 # RIGHT
-SWAP 3..3:
+SWAP 3.=3:
 +   return msg
 
 # WRONG — a pure insertion done as a widened `SWAP`: you only want to add one line after 2,
-# but you replace 2..4, retype the keepers in the body, and drop one (here line 4, `greet("world")`).
-SWAP 2..4:
+# but you replace 2.=4, retype the keepers in the body, and drop one (here line 4, `greet("world")`).
+SWAP 2.=4:
 +    msg = "Hello, " + name
 +    extra = compute(name)
 +    print(msg)

package/src/tokenizer.ts

@@ -4,7 +4,7 @@
  * Format shape:
  * ```
  * [path/to/file.ts#1A2B]
- * replace 5..7:
+ * replace 5.=7:
  * +literal new line
  * ```
  */
@@ -40,6 +40,7 @@ const CHAR_SPACE = 32;
 const CHAR_DOT = 46;
 const CHAR_HYPHEN = 45;
 const CHAR_ELLIPSIS = 0x2026;
+const CHAR_EQUALS = 61;
 
 const CHAR_UPPER_A = 65;
 const CHAR_UPPER_F = 70;
@@ -167,7 +168,11 @@ function scanRangeSeparator(line: string, index: number, end: number): number |
 			consumedSeparator = true;
 			continue;
 		}
-		if (code === CHAR_DOT && cursor + 1 < end && line.charCodeAt(cursor + 1) === CHAR_DOT) {
+		if (
+			code === CHAR_DOT &&
+			cursor + 1 < end &&
+			(line.charCodeAt(cursor + 1) === CHAR_DOT || line.charCodeAt(cursor + 1) === CHAR_EQUALS)
+		) {
 			cursor += 2;
 			consumedSeparator = true;
 			continue;
@@ -277,7 +282,7 @@ function scanHunkAnchor(line: string, start: number, end: number): TargetScan |
 		};
 	}
 	// `delete_block N` — resolve N to a tree-sitter block range at apply time
-	// and delete its whole span. Like `delete N..M`, it takes no body and no
+	// and delete its whole span. Like `delete N.=M`, it takes no body and no
 	// trailing colon.
 	const deleteBlockEnd = scanKeyword(line, cursor, end, HL_DELETE_BLOCK_KEYWORD);
 	if (deleteBlockEnd !== null) {

package/src/types.ts

@@ -47,7 +47,7 @@ export type Edit =
 			 * time — it is computed by {@link resolveBlockEdits} once file text +
 			 * path (→ language) are available, then expanded into concrete edits:
 			 * a non-empty `payloads` without `mode` (from `replace_block`) becomes
-			 * the same `replacement` inserts + deletes that `replace start..end:`
+			 * the same `replacement` inserts + deletes that `replace start.=end:`
 			 * produces; an empty `payloads` (from `delete_block`) becomes a pure
 			 * range deletion; `mode: "insert_after"` becomes plain `after_anchor`
 			 * inserts at the block's last line. `applyEdits` never sees this
@@ -78,7 +78,7 @@ export interface ApplyResult {
 	blockResolutions?: BlockResolution[];
 }
 
-/** A parsed `[A..B]` line range. */
+/** A parsed `[A.=B]` line range. */
 export interface ParsedRange {
 	start: Anchor;
 	end: Anchor;
@@ -134,7 +134,7 @@ export interface BlockSpan {
 /**
  * One `replace_block N:` / `delete_block N` / `insert_after_block N:` anchor
  * resolved to its concrete line span. Surfaced on {@link ApplyResult} so the
- * host can echo "block N → lines start..end" and let the model catch a wrong
+ * host can echo "block N → lines start.=end" and let the model catch a wrong
  * opener — e.g. a decorator or doc-comment that sits in a separate node
  * outside the resolved block.
  */