Name: hashline-core
Author: willhama

Imported from willhama/md-file-study (corpus/code-yeongyu__oh-my-openagent/files/packages/hashline-core/AGENTS.md). Install upstream with npx skills add willhama/md-file-study --skill hashline-core. Copyright stays with the author.

hashline-core — Hash-Anchored Edit Primitives (Core)

Generated: 2026-06-17

OVERVIEW

The engine behind the Hashline edit tool (inspired by oh-my-pi). Tags every line with a LINE#HASH| content hash, validates edit refs against current content (rejecting stale lines), then applies structured replace/append/prepend edits with autocorrection, deduplication, and unified-diff generation. Package: @oh-my-opencode/hashline-core.

PUBLIC API (`src/index.ts`, ~26 fns + 7 types) — by area

Area	Files	Key exports
Hash compute	`hash-computation.ts`, `xxhash32.ts`, `constants.ts`	`computeLineHash`, `computeLegacyLineHash`, `formatHashLine(s)`, `streamHashLinesFrom{Utf8,Lines}`, `NIBBLE_STR`, `HASHLINE_DICT`
Validation	`validation.ts`	`parseLineRef`, `validateLineRef(s)`, `normalizeLineRef`, `HashlineMismatchError`
Apply	`edit-operations.ts`, `edit-operation-primitives.ts`	`applyHashlineEdits`, `applyHashlineEditsWithReport`, `apply{SetLine,ReplaceLines,InsertAfter,InsertBefore,Append,Prepend}`
Normalize/dedup/order	`normalize-edits.ts`, `edit-deduplication.ts`, `edit-ordering.ts`	`normalizeHashlineEdits`, `dedupeEdits`, `detectOverlappingRanges`
Autocorrect	`autocorrect-replacement-lines.ts`, `edit-text-normalization.ts`	`autocorrectReplacementLines`, prefix/indent/echo strippers
Diff/display	`diff-utils.ts`, `hashline-edit-diff.ts`	`toHashlineContent`, `generateUnifiedDiff`, `countLineDiffs`, `generateHashlineDiff`
Canonicalize/chunk	`file-text-canonicalization.ts`, `hashline-chunk-formatter.ts`	`canonicalizeFileText`/`restoreFileText` (BOM + LF/CRLF), `createHashlineChunkFormatter` (200 lines / 64 KB)

DEPENDENCIES & CONSUMERS

Depends on: diff (^9) — for createTwoFilesPatch in generateUnifiedDiff only. Otherwise self-contained.
Consumed by: the ~15 thin re-export shims under omo-opencode/src/tools/hashline-edit/. NOT consumed by the Codex edition (Light has no hashline).

NOTES

"Option 2" hashing: no npm xxhash dependency. xxhash32.ts prefers native Bun.hash.xxHash32() at call time and falls back to a pure-JS impl, so it runs under Bun and Node.
Legacy hash compatibility: validation accepts both computeLineHash (trimEnd + strip \r) and computeLegacyLineHash (strip ALL whitespace) — old stored hashes still validate.
Seed rule: content lines seed 0; whitespace-only lines seed lineNumber (distinct hash per position).
normalizeHashlineEdits rejects unknown ops with "Legacy format was removed; use op/pos/end/lines." — the discriminated union is replace | append | prepend only.
Parent: packages/AGENTS.md.

Install hashline-core and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "willhama-md-file-study-hashline-core", "kind": "skill", "name": "hashline-core", "description": "The engine behind the Hashline edit tool (inspired by [oh-my-pi](https://github.com/can1357/oh-my-pi)). Tags every line with a `LINE#HASH|` content hash, validates edit refs against current content (rejecting stale lines), then applies structured `replace`/`append`/`prepend` edits with autocorrection, deduplication, and unified-diff generation. Package: `@oh-my-opencode/hashline-core`.", "publisher": "willhama", "version": "1.0.0", "capabilities": { "domains": [ "math" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "The engine behind the Hashline edit tool (inspired by [oh-my-pi](https://github.com/can1357/oh-my-pi)). Tags every line with a `LINE#HASH|` content hash, validates edit refs against current content (rejecting stale lines), then applies structured `replace`/`append`/`prepend` edits with autocorrection, deduplication, and unified-diff generation. Package: `@oh-my-opencode/hashline-core`." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/willhama/md-file-study", "path": "corpus/code-yeongyu__oh-my-openagent/files/packages/hashline-core/AGENTS.md", "ref": "c19de1e5213e9860055ac2385c28916a272efb46", "url": "https://github.com/willhama/md-file-study/blob/c19de1e5213e9860055ac2385c28916a272efb46/corpus/code-yeongyu__oh-my-openagent/files/packages/hashline-core/AGENTS.md", "key": "willhama/md-file-study/corpus/code-yeongyu__oh-my-openagent/files/packages/hashline-core/AGENTS.md" } }, "instructions": "# hashline-core — Hash-Anchored Edit Primitives (Core)\n\n**Generated:** 2026-06-17\n\n## OVERVIEW\n\nThe engine behind the Hashline edit tool (inspired by [oh-my-pi](https://github.com/can1357/oh-my-pi)). Tags every line with a `LINE#HASH|` content hash, validates edit refs against current content (rejecting stale lines), then applies structured `replace`/`append`/`prepend` edits with autocorrection, deduplication, and unified-diff generation. Package: `@oh-my-opencode/hashline-core`.\n\n## PUBLIC API (`src/index.ts`, ~26 fns + 7 types) — by area\n\n| Area | Files | Key exports |\n|------|-------|------", "cost": { "context_tokens": 702 } }

hashline-core

About

hashline-core — Hash-Anchored Edit Primitives (Core)

OVERVIEW

PUBLIC API (`src/index.ts`, ~26 fns + 7 types) — by area

DEPENDENCIES & CONSUMERS

NOTES

Install hashline-core and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews

About

hashline-core — Hash-Anchored Edit Primitives (Core)

OVERVIEW

PUBLIC API (src/index.ts, ~26 fns + 7 types) — by area

DEPENDENCIES & CONSUMERS

NOTES

Install hashline-core and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews

PUBLIC API (`src/index.ts`, ~26 fns + 7 types) — by area