oh-my-pi/packages/hashline/CHANGELOG.md

Changelog

[Unreleased]

[17.3.0] - 2026-08-13

Fixed

• Repaired mis-set replacement ranges using exact outside-row matches, indentation, tree-sitter structure, and a narrow pure-closer shape: opening comment fences and other syntax-essential edges are retained only when a parse-valid candidate satisfies those constraints; ambiguous placements are rejected.

[17.2.15] - 2026-08-12

Added

• Added a post-apply parse advisory warning that alerts users when an applied edit fails to parse (despite the pre-edit content parsing successfully), helping catch balance-neutral misplacements that previously failed silently.

Fixed

• Fixed a bug where Rust lifetimes (e.g., 'static) were incorrectly parsed as starting a string literal, which blinded the delimiter-balance scanner and could lead to silent signature deletions. Single-quote lexing on .rs files is now language-aware and correctly distinguishes lifetimes from character literals.
• Fixed an issue where terminal newlines in files were incorrectly exposed as editable blank rows.

[17.2.12] - 2026-08-08

Breaking Changes

• PUT N.=M @name over a span now throws when @name was never captured, instead of warning and deleting the range. Pasting a never-captured register over a span wrote nothing back, so a mistyped or hallucinated register name silently destroyed content. Gap pastes (PUT >N @name) keep the warned no-op behaviour from 17.2.11.

Added

• applyEdits now takes a path and uses the native tree-sitter parser to decide every boundary repair that depends on delimiter semantics. The authored edits are materialized first: if that result parses, it is returned untouched, so a } inside a regex literal, a string, or Markdown prose is never mistaken for a block closer. A closer-spare repair lands only when the repaired result is shown to parse — never on delimiter arithmetic alone — so an unrecognized language or an unprovable candidate leaves the edit exactly as authored. Wired through the patcher, recovery, section apply, and the edit tool's preview.
• Auto-repair for replacement ranges that start one line early on a structural closer (the } of the construct above): the closer is spared and the payload lands after it, gated on the same parse proof.
• Warning for balanced payloads over ranges that end mid-block (deleting opener(s) whose closer(s) survive below), pointing at the block-op remedy (PUT N*:). Raised only when the baseline parsed and the authored result does not, so it cannot fire on prose or an unknown language.
• Warning when a + body row is itself a valid hunk header (+CUT 5.=9). Such a row is literal content by definition and is inserted into the file as text; naming it at the moment it happens turns a silent source-file corruption into an actionable diagnostic.

Fixed

• Rejected patches whose pasted N:TEXT read-output rows repeat a source line number. Each such row is recovered as a single-line PUT N.=N:, so a body written as consecutive lines under one number collapsed through the same-range coalescer, keeping only the last row and silently dropping the rest — in one incident replacing a block opener with } and deleting the following statement. The error now names the repeated line and teaches the explicit PUT form.

[17.2.11] - 2026-08-07

Changed

• Pasting an empty named register (PUT … @name with no matching capture) now surfaces a warning listing available registers and removes the span target instead of throwing an error.

Fixed

• Fixed an issue where pipe-numbered read/search rows copied into top-level and bare-body patch payloads were not properly recovered (#7905).

[17.2.10] - 2026-08-06

Changed

• Updated internal caching dependency to use @oh-my-pi/pi-utils/lru.

[17.2.2] - 2026-07-31

Breaking Changes

• Replaced legacy SWAP, INS, and PASTE syntax with unified PUT and CUT hunks

Added

• Added named register support (@reg) and span paste capabilities to clipboard operations
• Added conservative recovery for uniformly omitted replacement indents near brace openers, preserving intentional indentation-only edits

Changed

• Made .= the canonical inclusive range separator while retaining legacy separator variants as lenient input
• Unified replacement, insertion, register paste, block, head/tail, move, and removal headers under a composable PUT, CUT, MV, and REM grammar

Fixed

• Improved resilience against common model output formatting errors, including numbered read rows, summarized ranges, diff-style old/new rows, empty PUT deletes, harmless CUT colons, and single-line span shorthand

[17.2.0] - 2026-07-30

Breaking Changes

• Removed DEL, DEL.BLK, COPY, and COPY.BLK from the patch language. Use CUT / CUT.BLK for deletion; a cut does not require a following PASTE and leaves the removed content available to later pastes.

Added

• Added clipboard ops: CUT N.=M captures lines into a register (and deletes them), CUT.BLK N captures tree-sitter blocks, and PASTE.PRE|POST N / PASTE.HEAD|TAIL / PASTE.BLK.POST N insert the captured lines without retyping. The register flows top-to-bottom across sections, so content moves between files in one patch; PASTE does not consume it and the last capture wins.
• Added PatcherOptions.clipboard for a host-owned register that persists across Patcher.apply batches. Batches work on a fork (forkClipboard) published per landed section (commitClipboard), so failed batches never poison the register and a mid-batch write failure still preserves content already cut from disk.
• Added clipboard safety guards: a PASTE with an empty register, a capture overwriting un-pasted CUT content, and clipboard ops in same-path sections interleaved across another file's section are all rejected with targeted diagnostics. CUT ranges participate in overlap validation, the seen-lines guard, and drift recovery (every captured line must remap).

Changed

• Simplified grammar.lark around shared target and position shapes, collapsing the concrete and block CUT forms plus the INS / PASTE position variants into their common grammar rules.

Fixed

• Prevented CPU and memory exhaustion in streaming previews by rejecting line anchors above Number.MAX_SAFE_INTEGER and ranges spanning more than 100,000 lines.
• Fixed an issue where recorded snapshot tags desynced from disk when the filesystem transformed content on write (e.g., auto-formatting on save), which previously caused subsequent edits to incorrectly reformat unrelated parts of the file. Patcher.commit now correctly keys the returned file hash and snapshot on the actual content written to disk and issues a warning when a drift is detected.

[17.1.5] - 2026-07-27

Changed

• Improved reversed-range and invalid block-anchor diagnostics with absolute endpoint corrections plus nearby syntactic opener suggestions, without auto-applying the suggested edit (#6671).
• Accepted a single dot between integer range endpoints, such as DEL 235.258, as an unambiguous range separator (#6671).

[17.1.2] - 2026-07-24

Changed

• Bare - bullet body rows are now auto-accepted as literal content with a warning when the hunk is unambiguously a Markdown bullet list (every - row bullet-shaped and no plain +new diff counterpart); ambiguous - rows still fail with the teaching error.

[17.0.8] - 2026-07-22

Changed

• Improved snapshot recovery line remapping by utilizing native line diffing.
• Switched line anchor recovery diffs to native diffLineRuns, processing UTF-16 code units directly and removing JS diff fallback.

Removed

• Removed npm diff dependency.

[17.0.4] - 2026-07-18

Fixed

• Rejected DEL N: headers with a trailing colon instead of silently tolerating the colon, so delete-with-body mistakes surface the corrective "has no colon" guidance.

[17.0.0] - 2026-07-15

Added

• Added enforceSeenLines option to PatcherOptions (defaulting to true) to control whether seen-line validation is enforced on anchored edits, allowing tags to validate on content hash alone when disabled.

[16.5.0] - 2026-07-13

Fixed

• Fixed a critical issue where ambiguous swaps could silently delete range boundaries.
• Prevented incorrect auto-repairing of structural closing lines when payload placement is ambiguous.
• Fixed a bug in stale-hash recovery that could incorrectly relocate edits onto duplicated context after the original target changed.

[16.3.3] - 2026-07-02

Breaking Changes

• Removed SnapshotStore.byHashExact. Consumers should now use byHash, which resolves collisions by returning the most recently recorded version.

Changed

• Improved patch application robustness by resolving 16-bit snapshot tag collisions to the most recent version instead of rejecting them.

Fixed

• Fixed frequent edit rejections after a structural-summary read (affecting parseable code over 100 lines) by automatically inlining unseen anchor lines and merging them into the snapshot's seen lines, allowing immediate retries to succeed without requiring a separate range re-read.

[16.3.0] - 2026-07-02

Changed

• Significantly improved performance on large files by optimizing stale-anchor remap validation.

Fixed

• Fixed an issue where snapshot tag collisions could cause line-anchored edits to be incorrectly applied to unrelated content, improving recovery and edit-preview safety.
• Fixed tracking of edit anchors when earlier in-session insertions or deletions shift unchanged target lines.
• Fixed hashline edit guidance and parsing errors for Markdown list rows.

[16.2.8] - 2026-06-30

Fixed

• Fixed hashline writes preserving UTF-8 BOM bytes when the host text decoder hides the leading U+FEFF. (#3867)

[16.2.6] - 2026-06-29

Fixed

• Fixed a parser error ("payload line has no preceding hunk header") caused by stray dots before the trailing colon in hunk headers, improving compatibility with GLM 5.2 outputs.

[16.2.0] - 2026-06-27

Added

• Added REM (remove) and MV (move/rename) section operations to hashline patches, allowing files to be deleted or relocated (with snapshot history migration) directly within the edit tool.

[16.1.23] - 2026-06-26

Added

• Updated prompt documentation to include support for Markdown section operations

Fixed

• Improved file path recovery to correctly handle read-only or incorrectly typed paths

[16.1.14] - 2026-06-22

Fixed

• Improved delimiter-balance repair to correctly identify and spare deleted structural closers
• Prevented premature deletion of structural closers when existing code below the range covers them
• Accurate tracking of inserted lines to improve boundary repair logic for surrounding code blocks
• Fixed delimiter-balance repair so deleted closer suffixes are kept only when the replacement prefix still has unmatched openers for them, avoiding duplicated trailing braces while preserving omitted outer closers.

[16.1.8] - 2026-06-20

Fixed

• Fixed multi-hunk delimiter-balance repair so a SWAP that drops a structural closer no longer keeps it when another hunk already removed the matching opener (a deliberate wrapper removal); the missing-closer repair now weighs each group against the whole patch's residual delimiter balance — summed per hunk so quote/comment state never bleeds across non-contiguous hunks — and consumes that residual per repair so a genuine missing closer elsewhere still fires. (#3142)

[16.1.2] - 2026-06-19

Changed

• Refined documentation and prompt instructions for clarity and brevity

[16.0.2] - 2026-06-16

Fixed

• Auto-repaired duplicated JSX/XML closing boundary lines at the end of single-line replacement expansions. (#2705)

[16.0.1] - 2026-06-15

Fixed

• Auto-repaired one-sided multi-line boundary echoes by dropping delimiter-neutral duplicated boundary lines and emitted a boundary-echo warning
• Parser now treats a leading \ on inline payload bodies as the payload delimiter, matching standalone payload rows.
• Restored the warning emitted when escaped indented payload rows (\\ TEXT) are accepted as payload delimiters.

[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

• Renamed all hashline DSL operators to concise abbreviated keywords:
  • replace -> SWAP
  • delete -> DEL
  • insert before/after/head/tail -> INS.PRE/POST/HEAD/TAIL
  • replace_block -> SWAP.BLK
  • delete_block -> DEL.BLK
  • insert_after_block -> INS.BLK.POST

[15.13.1] - 2026-06-15

Breaking Changes

• Rejected edits anchored to lines not displayed in the tagged read/search output, requiring unseen ranges to be re-read before reapplying

Changed

• Rejected replace block, delete block, and insert after block operations that resolve to a single line and instructed users to use the plain single-line form or anchor the true construct opener

Fixed

• Normalized cwd-relative hashline paths to forward-slash form on Windows.

[15.12.5] - 2026-06-13

Fixed

• Fixed delimiter-balance boundary repair so it does not keep a deleted structural closer when the replacement payload already restates that closer.

[15.12.0] - 2026-06-12

Changed

• Condensed all parser/applier/patcher error and warning messages: shorter wording, same diagnostic anchors (op names, line numbers, suggested fallback forms)

[15.11.4] - 2026-06-12

Added

• Added inward landing correction for insert after block N:: a body indented deeper than the block's closing line now slides back across the block's trailing closer lines and lands inside the block at its claimed depth, with a warning naming the landing line. Same conservative guards as the outward shift — comparable indentation only, closers only, abandoned when another hunk targets a crossed line; plain insert after M: stays literal
• Added closer-anchor lowering for insert after block N:: anchoring on a pure closing-delimiter line (where no block begins, so resolution previously failed the whole patch) now applies as plain insert after N: with a warning teaching the opener-only rule. resolveBlockEdits gained an onWarning callback; apply, preview, and patcher paths surface it on warnings

Changed

• Condensed the edit-tool prompt: one-line op definitions, 5–20-word rules, and a tighter <critical> recap; landing-correction mechanics are no longer described to the agent

[15.11.1] - 2026-06-11

Fixed

• Fixed the insert after block N: prompt guidance so it explicitly says N must be the block opener, not the closing delimiter or last visible line, and points visible closing-line edits to plain insert after M:. (#2292)

[15.11.0] - 2026-06-10

Changed

• Block-unresolved errors (replace block N: / delete block N / insert after block N: failing to resolve a syntactic block) now append a numbered preview of the file around the anchor line — same *-marked context rows the hash-mismatch error shows — so the offending line is visible without a re-read

[15.10.11] - 2026-06-10

Breaking Changes

• Changed BlockResolution.isDelete to BlockResolution.op ("replace" | "delete" | "insert_after") so resolutions can describe every block-anchored op

Added

• Added insert after block N: patch syntax to insert body rows after the last line of the tree-sitter-resolved block beginning on line N, so a statement can be placed after a construct without counting to its closing line
• Added depth-guided landing correction for insert after N: hunks: a body indented shallower than its anchor line slides past the structural closer lines below the anchor until depth returns to the body's level, with a warning naming the final landing line. The shift never crosses content lines, skips incomparable indentation styles and pure-closer bodies, and is abandoned when another hunk targets a crossed line
• Added a global byte ceiling to InMemorySnapshotStore (maxTotalBytes, default 64 MiB): the cap was previously per-file only, so a session reading many large files retained up to 30 paths × 4 full-text versions indefinitely

Changed

• Trimmed the replace block N: ops entry in the patch prompt to grammar and pointing rules; the usage doctrine it duplicated stays in the rules section
• Changed buildCompactDiffPreview to treat blank rows as gap separators alongside … markers: separators never stack (removed lines omitted from the preview no longer leave two adjacent), and leading/trailing separators are trimmed

Fixed

• Fixed the boundary-echo repair stripping payload edges without the balance-neutrality guard its own documentation promised: in brace-heavy code where bare } lines repeat, a payload intentionally beginning/ending with lines identical to the range's neighbors had both edges silently dropped, writing content that differed from what was authored
• Fixed lenient bare-body handling silently mutating payloads: interior blank rows in an un-prefixed body were dropped outright, and a body of numeric-keyed literals (1: "one" dict/YAML shapes) satisfied the uniform line-prefix check and had its keys stripped from every line — blank rows are now preserved when proven interior, and the uniform strip refuses lone-literal remainders
• Fixed the multi-section "all-or-nothing" claim being false for write failures: commits run serially, so a mid-batch write error left earlier sections on disk while the thrown error said nothing — the error now lists exactly which sections were written and which were not
• Fixed delete/replace ranges ending on the phantom trailing line of a newline-terminated file silently stripping the file's final newline; such anchors are now rejected with guidance toward N-1 / insert tail: (inserts there remain valid, and genuine empty last lines of unterminated files stay deletable)

[15.10.5] - 2026-06-08

Added

• Added maxAddedRunContext option to control how many added lines are shown at each side of collapsed inserted runs, with maxUnchangedRun kept as a backward-compatible alias

Changed

• Changed buildCompactDiffPreview to omit removed lines from the preview while preserving removal counts for offset tracking
• Changed buildCompactDiffPreview to collapse long contiguous added runs with a bare … marker, keeping only the first and last maxAddedRunContext lines visible (the surrounding line numbers convey how many were elided)

Fixed

• Fixed compact edit previews to omit deleted content, keep visible lines anchored to the current file, and collapse long inserted runs with a bare … elision marker.
• Fixed compact edit previews to render added/current lines without diff-prefix padding and normalize adjacent ASCII/Unicode elision markers to one ….

[15.10.3] - 2026-06-08

Added

• Added a BlockResolution type and surfaced resolved block spans on ApplyResult.blockResolutions / PatchSectionResult.blockResolutions. resolveBlockEdits now accepts an onResolved callback that reports each replace block N: / delete block N anchor's resolved [start, end] span (and whether it was a delete). Spans are surfaced only on the no-drift apply paths, where the resolved line numbers line up with the tag the caller read.

Changed

• Reworked the edit tool prompt (prompt.md): added a replace block N vs replace N..M decision rule, documented that a leading decorator/attribute/doc-comment is a separate node not swept into the block (point N at the first decorator line, or use replace N..M for a Rust-style /// sibling comment), reframed the blast-radius guidance so "block replace" no longer reads as the dangerous option, and added a decorated-definition example.

[15.10.2] - 2026-06-08

Fixed

• Stripped read-output line-number prefixes (N:) from auto-piped bare body rows so that pasting 3:text without a + prefix no longer injects 3: as literal content. Stripping is applied only when every bare row in the hunk carries the prefix (the signature of a pasted snapshot) and removes at most one prefix per row, so a genuine body that merely starts with digits: (YAML port maps, timestamps) is left intact (#1492).

[15.9.67] - 2026-06-06

Breaking Changes

• Changed hashline file section headers from ¶PATH#TAG to [PATH#TAG] so model-authored edits use ASCII delimiters instead of a pilcrow sigil.

Fixed

• Fixed missing-header diagnostics and copied-content prefix stripping to consistently teach and recognize 4-hex snapshot tags.

[15.8.2] - 2026-06-03

Fixed

• Fixed delimiter-balance boundary repair to also drop a single duplicated structural opener (e.g. a restated foo( / if (x) { signature line surviving just above the range), not only duplicated closers. Zero-balance duplicates remain untouched.

[15.8.0] - 2026-06-02

Fixed

• Fixed hashline replacements that accidentally restated unchanged lines above and below the selected range so they no longer duplicate both boundary lines (#1664).

[15.7.0] - 2026-05-31

Added

• Added replace block N: and delete block N patch syntax to replace or delete the entire syntactic block that begins on line N using tree-sitter-resolved spans
• Added BlockResolver support in Patcher and PatchSection.applyTo/applyPartialTo to wire language-specific block-resolution at apply time
• Added resolveBlockEdits and block edit type definitions to the package API for resolving deferred replace block / delete block edits

[15.5.13] - 2026-05-29

Breaking Changes

• Changed hashline section tags from 3-hex to 4-hex content-hash tags, so legacy 3-digit tags are no longer valid
• Changed hashline syntax to verb-based v4: body-bearing ops are replace N..M:, insert before N:, insert after N:, insert head:, and insert tail:, while bodyless delete N..M handles deletion. Removed >A..B repeat rows and the old prepend: / append: virtual insert headers; - rows remain rejected with a teaching error.

Added

• Added maxPaths and maxVersionsPerPath options to InMemorySnapshotStore to bound tracked paths and per-path snapshot history
• Re-introduced balance-validated boundary repair in applyEdits. A replacement hunk (replace N..M: + body) is normalized so its payload preserves the deleted region's delimiter balance: when the body restates a closing delimiter that survives just outside the range (duplicate } / ); / ]) the echo is dropped, and when the range deletes a structural closer the body never restates (missing closer) the closer is spared instead of deleted. A repair fires only when one boundary operation drives the per-channel () / [] / {} imbalance to exactly zero while leaving surrounding text byte-identical (single-line ops are limited to pure structural-closer lines), so balance-preserving edits and intentional balanced duplicates are never touched. Bracket counting skips strings, template literals, and comments. Each repair surfaces a delimiter-balance warning through ApplyResult.warnings.

Changed

• Changed patch application to accept edits whenever the live file's normalized content hash matches the section tag, even when that anchor was not covered by a stored snapshot

Removed

• Removed SnapshotStore.recordContiguous and SnapshotStore.recordSparse in favor of full-file record(path, fullText) snapshots

Fixed

• Fixed hash mismatch rejections caused by CRLF or trailing spaces/tabs by normalizing those characters before computing file-hash tags

[15.5.12] - 2026-05-29

Changed

• InMemorySnapshotStore now coalesces consecutive same-path reads into one tag whenever their views agree on every shared line. Overlapping or directly abutting range reads extend the existing snapshot's contiguous run in place; reads separated by a gap union into a SparseSnapshot spanning both ranges. A disagreeing shared line is treated as "the file changed on disk" and mints a fresh tag, preserving the prior superset-dedup behavior. This stops sequential range reads of an unchanged file (e.g. :50-100 then :100-200, or :1-100 then :150-200) from fragmenting into separate anchors.

[15.5.11] - 2026-05-29

Added

• MismatchError now distinguishes "hash recognized but file content drifted" from "hash never recorded for this path". The latter (likely fabricated or carried over from a prior session) emits a dedicated hash #X is not from this session rejection message with explicit "never invent the tag" guidance. The MismatchDetails interface gains an optional hashRecognized?: boolean (defaults to true for backward compatibility); MismatchError exposes it as a readonly field so callers can branch on the cause.

[15.5.8] - 2026-05-28

Breaking Changes

• Removed the single-number hunk header shorthand. A hunk header now REQUIRES two line numbers (A A for a single line, A B for a range); a bare A row throws single-number hunk header "A" is no longer accepted. The &A body-row shorthand for &A..A is unchanged.
• Changed hunk header syntax from A-B: to @@ A..B @@ with @@ A @@ shorthand for single lines
• Changed repeat payload sigil from ^A-B to &A..B with &A shorthand for single lines
• Changed range separator from - to .. in all contexts (anchors and repeats)
• Changed empty hunk behavior: concrete ranges now delete (no blank-line insertion); BOF/EOF empty hunks are now no-ops
• Removed ApplyOptions parameter from applyEdits() and related APIs; auto-absorb behavior is no longer configurable
• Removed diagnostic warnings for auto-absorbed duplicates from ApplyResult; warnings now come only from parser, patcher, or recovery
• Removed legacy hashline block syntax A-B:, A-B:-, and ^A-B and replaced edits with @@ A..B @@ hunks using + and & body rows
• Removed A: shorthand syntax; use explicit A-A: for single-line anchors
• Removed ↑ and ↓ payload sigils; use |TEXT for literal rows and ^A-B for repeating original lines
• Removed standalone delete rows; use inline A-B:- syntax instead
• Removed after_anchor cursor kind; all inserts now use before_anchor positioning
• Replaced insert-above/insert-below payload sigils with linear body rows: |TEXT emits literal text and ^A-B repeats original file lines inline.
• Replaced standalone delete rows with inline range deletes: use A-B:-.
• Changed empty A-B:, BOF:, and EOF: blocks to write one blank line instead of being rejected.

Added

• Added compatibility parsing for apply_patch-style and unified-diff row noise by stripping path noise and converting context/delete body rows into hashline-compatible operations with warnings
• Added A-B:- inline delete syntax for concrete range anchors
• Added ^A-B repeat payload syntax to emit original file lines inline
• Added support for empty anchor blocks to write one blank line at the anchor position

Changed

• Changed unified-diff compatibility mode to silently drop -old rows and convert context rows to +TEXT literals with a warning instead of rejecting them
• Changed ABORT_MARKER behavior to terminate parsing without surfacing a warning
• Changed numeric ranges to A..B form and accepted @@ A @@ as shorthand for @@ A..A @@
• Changed empty hunk behavior so a concrete empty hunk deletes the selected range and BOF/EOF empty hunks no longer insert a blank line
• Changed parse behavior for *** Abort to stop processing without returning a speculative truncation warning
• Changed payload row format from three sigils (|, ↑, ↓) to two (|, ^)
• Changed range anchor syntax to require explicit A-B form (no single-line shorthand)
• Changed error messages to reference new syntax and remove references to removed sigils

[15.5.5] - 2026-05-27

Breaking Changes

• Changed hashline payload continuations from +TEXT to \TEXT; use \ for an explicit blank payload line.

Added

• Added parsePatchStreaming(diff) and PatchSection.applyPartialTo(text, options) for incremental diff previews. Both tolerate a trailing in-flight op (no payload yet, or a per-token parse error mid-stream) instead of throwing or emitting a phantom empty-payload edit.
• Added Executor.endStreaming() — sibling of end() that drops a pending op with no accumulated payload rather than flushing it.

Fixed

• Parser now skips markdown-style # ... lines when they directly precede a hashline operation, making model-generated explanatory rows in prompt examples non-blocking.

Removed

• Removed the A-B! / A! deletion operator. Use A-B: with the desired payload (or empty payload to blank the range) instead.

All notable changes to this package will be documented in this file.

[15.5.4] - 2026-05-27

Added

• Added a high-level Patcher API with all-or-nothing apply and staged prepare/commit flows for multi-file patch updates
• Added pluggable Filesystem and SnapshotStore abstractions with built-in NodeFilesystem, InMemoryFilesystem, and InMemorySnapshotStore adapters
• Added patch parsing that consumes ¶PATH#HASH hunk headers, validates section file hashes, and supports optional patch envelope markers
• Added tolerant input handling that strips read/search prefixes and supports optional cwd/fallback-path resolution when parsing patch payloads
• Added automatic line-ending and BOM normalization on read, with original encoding shape restored on write
• Added follow-up helpers buildCompactDiffPreview and streamHashLines for compact diff previews and chunked streaming of numbered lines
• Added stale-file-hash recovery that replays edits against snapshots and merges results onto current file content when direct hash validation fails
• Initial standalone release. Extracted from @oh-my-pi/pi-coding-agent.

Fixed

• Fixed repeated patch application mutating cached after_anchor edits between target snapshots
• Fixed multi-section patching to preflight write policies and reject duplicate canonical targets before any section is committed
• Fixed mixed line-ending restoration to preserve the first newline style instead of rewriting ties to LF