@oh-my-pi/hashline 16.5.2 → 17.0.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [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

package/dist/types/patcher.d.ts

@@ -15,6 +15,12 @@ export interface PatcherOptions {
      * host did not wire a resolver). Plain line-range ops never need it.
      */
     blockResolver?: BlockResolver;
+    /**
+     * Enforce the seen-line guard: reject anchored edits on lines the read/search
+     * that minted the tag never displayed. Defaults to `true`. When `false`, tags
+     * validate on content hash alone and any anchor into the tagged content applies.
+     */
+    enforceSeenLines?: boolean;
 }
 /** Per-section result returned by {@link Patcher.apply} / {@link Patcher.commit}. */
 export interface PatchSectionResult {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/hashline",
-	"version": "16.5.2",
+	"version": "17.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/patcher.ts

@@ -73,6 +73,12 @@ export interface PatcherOptions {
 	 * host did not wire a resolver). Plain line-range ops never need it.
 	 */
 	blockResolver?: BlockResolver;
+	/**
+	 * Enforce the seen-line guard: reject anchored edits on lines the read/search
+	 * that minted the tag never displayed. Defaults to `true`. When `false`, tags
+	 * validate on content hash alone and any anchor into the tagged content applies.
+	 */
+	enforceSeenLines?: boolean;
 }
 
 /** Per-section result returned by {@link Patcher.apply} / {@link Patcher.commit}. */
@@ -197,6 +203,7 @@ export class Patcher {
 	readonly snapshots: SnapshotStore;
 	readonly recovery: Recovery;
 	readonly blockResolver: BlockResolver | undefined;
+	readonly #enforceSeenLines: boolean;
 
 	constructor(options: PatcherOptions) {
 		if (!options.snapshots) {
@@ -206,6 +213,7 @@ export class Patcher {
 		this.snapshots = options.snapshots;
 		this.recovery = new Recovery(options.snapshots);
 		this.blockResolver = options.blockResolver;
+		this.#enforceSeenLines = options.enforceSeenLines ?? true;
 	}
 
 	/**
@@ -628,7 +636,9 @@ export class Patcher {
 			// The line numbers in `edits` index the exact content the tag names.
 			// Reject any anchor the read never displayed: editing lines the model
 			// has not seen is the off-by-memory mistake that mangles files.
-			if (expected !== undefined) this.#assertSeenLines(section, expected, matchedSnapshot);
+			if (expected !== undefined && this.#enforceSeenLines) {
+				this.#assertSeenLines(section, expected, matchedSnapshot);
+			}
 			const result = applyEdits(normalized, resolved);
 			return withResolveWarnings(blockResolutions.length > 0 ? { ...result, blockResolutions } : result);
 		}