opencode-hashline 1.1.3 → 1.2.0

package/README.en.md

@@ -44,7 +44,12 @@ The AI model can then reference lines by their hash tags for precise editing:
 
 ### 🤔 Why does this help?
 
-Traditional line numbers shift as edits are made, causing off-by-one errors and stale references. Hashline tags are **content-addressable** — they're derived from both the line index and the line's content, so they serve as a stable, verifiable reference that the AI can use to communicate about code locations with precision.
+Hashline solves the fundamental problems of the two existing AI file-editing approaches:
+
+- **`str_replace`** requires an absolutely exact match of `old_string`. Any extra whitespace, wrong indentation, or duplicate lines in the file — and the edit fails with "String to replace not found". This is so common it has a [mega-thread of 27+ related issues on GitHub](https://github.com/anthropics/claude-code/issues).
+- **`apply_patch`** (unified diff) only works on models specifically trained for this format. On other models the results are catastrophic: Grok 4 fails **50.7%** of patches, GLM-4.7 fails **46.2%** ([source](https://habr.com/ru/companies/bothub/news/995986/)).
+
+Hashline addresses each line with a unique `lineNumber:hash`. No string matching, no model-specific training dependency — just precise, verifiable line addressing.
 
 ---
 
@@ -355,22 +360,25 @@ const hl = createHashline({ cacheSize: 50, hashLength: 3 });
 
 ## 📊 Benchmark
 
-### Correctness: hashline vs str_replace
+### Correctness: hashline vs str_replace vs apply_patch
+
+We tested all three approaches on **60 fixtures from [react-edit-benchmark](https://github.com/can1357/oh-my-pi/tree/main/packages/react-edit-benchmark)** — mutated React source files with known bugs (flipped booleans, swapped operators, removed guard clauses, etc.):
 
-We tested both approaches on **60 fixtures from [react-edit-benchmark](https://github.com/can1357/oh-my-pi/tree/main/packages/react-edit-benchmark)** — mutated React source files with known bugs (flipped booleans, swapped operators, removed guard clauses, etc.):
+| | hashline | str_replace | apply_patch |
+|---|:---:|:---:|:---:|
+| **Passed** | **60/60 (100%)** | 58/60 (96.7%) | **60/60 (100%)** |
+| **Failed** | 0 | 2 | 0 |
+| **Ambiguous edits** | 0 | 4 | 0 |
 
-| | hashline | str_replace |
-|---|:---:|:---:|
-| **Passed** | **60/60 (100%)** | 58/60 (96.7%) |
-| **Failed** | 0 | 2 |
-| **Ambiguous edits** | 0 | 4 |
+`apply_patch` with context lines matches hashline's reliability — **when the model generates the patch correctly**. The key weakness of `apply_patch` is its dependency on model-specific training: models not trained on this format produce malformed diffs (missing context lines, wrong indentation), causing patch application to fail.
 
-str_replace fails when the `old_string` appears multiple times in the file (e.g. repeated guard clauses, similar code blocks). Hashline addresses each line uniquely via `lineNumber:hash`, so ambiguity is impossible.
+`str_replace` fails when `old_string` appears multiple times in the file (repeated guard clauses, similar code blocks). Hashline addresses each line uniquely via `lineNumber:hash` — ambiguity is impossible and no model-specific format is required.
 
 ```bash
 # Run yourself:
-npx tsx benchmark/run.ts              # hashline mode
-npx tsx benchmark/run.ts --no-hash    # str_replace mode
+npx tsx benchmark/run.ts               # hashline mode
+npx tsx benchmark/run.ts --no-hash     # str_replace mode
+npx tsx benchmark/run.ts --apply-patch # apply_patch mode
 ```
 
 <details>

package/README.md

@@ -44,7 +44,12 @@ AI-модель может ссылаться на строки по их хеш
 
 ### 🤔 Почему это помогает?
 
-Традиционные номера строк сдвигаются при редактировании, вызывая ошибки смещения и устаревшие ссылки. Хеш-теги Hashline **контентно-адресуемы** — они вычисляются из индекса строки и её содержимого, что делает их стабильной, верифицируемой ссылкой для точной коммуникации о местоположении в коде.
+Hashline решает фундаментальные проблемы двух существующих подходов к редактированию файлов AI:
+
+- **`str_replace`** требует абсолютно точного совпадения `old_string`. Любой лишний пробел, неверный отступ или дублирующиеся строки в файле — и редактирование завершается ошибкой «String to replace not found». Это настолько распространённая проблема, что у неё есть [мегатред на 27+ тикетов на GitHub](https://github.com/anthropics/claude-code/issues).
+- **`apply_patch`** (unified diff) работает только на моделях, специально обученных этому формату. На других моделях результаты катастрофические: Grok 4 проваливает **50.7%** патчей, GLM-4.7 — **46.2%** ([источник](https://habr.com/ru/companies/bothub/news/995986/)).
+
+Hashline адресует каждую строку уникальным хешем `lineNumber:hash`. Никакого строкового совпадения, никакой зависимости от специального обучения модели — только точная, верифицируемая адресация.
 
 ---
 
@@ -330,22 +335,25 @@ const hl = createHashline({ cacheSize: 50, hashLength: 3 });
 
 ## 📊 Бенчмарк
 
-### Корректность: hashline vs str_replace
+### Корректность: hashline vs str_replace vs apply_patch
+
+Все три подхода протестированы на **60 фикстурах из [react-edit-benchmark](https://github.com/can1357/oh-my-pi/tree/main/packages/react-edit-benchmark)** — мутированных файлах React с известными багами (инвертированные булевы, перепутанные операторы, удалённые guard-клаузы и т.д.):
 
-Оба подхода протестированы на **60 фикстурах из [react-edit-benchmark](https://github.com/can1357/oh-my-pi/tree/main/packages/react-edit-benchmark)** — мутированных файлах React с известными багами (инвертированные булевы, перепутанные операторы, удалённые guard-клаузы и т.д.):
+| | hashline | str_replace | apply_patch |
+|---|:---:|:---:|:---:|
+| **Прошло** | **60/60 (100%)** | 58/60 (96.7%) | **60/60 (100%)** |
+| **Провалено** | 0 | 2 | 0 |
+| **Неоднозначные правки** | 0 | 4 | 0 |
 
-| | hashline | str_replace |
-|---|:---:|:---:|
-| **Прошло** | **60/60 (100%)** | 58/60 (96.7%) |
-| **Провалено** | 0 | 2 |
-| **Неоднозначные правки** | 0 | 4 |
+`apply_patch` с контекстными строками работает так же надёжно, как hashline — **при условии, что модель правильно генерирует патч**. Слабое место `apply_patch` — зависимость от обучения конкретной модели: не обученные под этот формат модели производят некорректные diff-ы (пропускают контекст, путают отступы), что приводит к провалу применения патча.
 
-str_replace ломается, когда `old_string` встречается в файле несколько раз (например, повторяющиеся guard-клаузы, похожие блоки кода). Hashline адресует каждую строку уникально через `lineNumber:hash`, поэтому неоднозначность исключена.
+`str_replace` ломается, когда `old_string` встречается в файле несколько раз (повторяющиеся guard-клаузы, похожие блоки кода). Hashline адресует каждую строку уникально через `lineNumber:hash` — неоднозначность исключена, модельный формат не нужен.
 
 ```bash
 # Запустите сами:
-npx tsx benchmark/run.ts              # режим hashline
-npx tsx benchmark/run.ts --no-hash    # режим str_replace
+npx tsx benchmark/run.ts               # режим hashline
+npx tsx benchmark/run.ts --no-hash     # режим str_replace
+npx tsx benchmark/run.ts --apply-patch # режим apply_patch
 ```
 
 <details>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-hashline",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "description": "Hashline plugin for OpenCode — content-addressable line hashing for precise AI code editing",
   "main": "dist/opencode-hashline.cjs",
   "module": "dist/opencode-hashline.js",