@yofriadi/pi-hashline-edit

Install from git URL

pi install git:github.com/yofriadi/pi-extensions@hashline-edit-v<version>

To load only this extension from the monorepo package source, use package filtering in settings:

{
  "packages": [
    {
      "source": "git:github.com/yofriadi/pi-extensions@hashline-edit-v<version>",
      "extensions": ["packages/hashline-edit/src/index.ts"]
    }
  ]
}

Hashline edit mode for pi — a line-addressable edit format using content hashes.

Overview

Each line in a file is identified by its 1-indexed line number and an 8-char base16 hash derived from the exact line content (except trailing \r). The combined LINE:HASH reference acts as both an address and a staleness check.

Displayed format: LINENUM:HASH|CONTENT
Reference format: "LINENUM:HASH" (e.g. "5:a3f19c2e")

Usage

import {
  computeLineHash,
  formatHashLines,
  applyHashlineEdits,
  parseLineRef,
} from "@yofriadi/pi-hashline-edit";

// Format file content with hashline prefixes
const content = "function hello() {\n  return 'world';\n}";
const formatted = formatHashLines(content);
// "1:a3f19c2e|function hello() {\n2:5b0ea94c|  return 'world';\n3:0f8a2c11|}"

// Compute hash for a single line
const hash = computeLineHash(1, "function hello() {");

// Apply edits with hash verification
const result = applyHashlineEdits(content, [
  { set_line: { anchor: "2:5b0ea94c", new_text: "  return 'universe';" } },
]);

Edit Operations

• set_line: Replace a single line
• replace_lines: Replace a contiguous range of lines
• insert_after: Add new content after an anchor line

Note: replace payloads are intentionally not handled by applyHashlineEdits; they should be processed by a separate replace-mode flow.

API

Function	Description
computeLineHash(idx, line)	Compute short hash for a line
formatHashLines(content, startLine?)	Format content with LINE:HASH| prefixes
applyHashlineEdits(content, edits)	Apply hashline edits with validation
parseLineRef(ref)	Parse "LINE:HASH" string to {line, hash}
validateLineRef(ref, fileLines)	Validate hash matches current content
streamHashLinesFromUtf8(source, options?)	Stream hashline output from bytes
streamHashLinesFromLines(lines, options?)	Stream hashline output from lines

License

MIT