Module marker 

Marker-delimited managed block: string surgery over a host file.

The canon owns exactly one region of a consumer’s .pre-commit-config.yaml — the lines between its BEGIN and END markers — and everything here is a pure function over the host text: validate the markers, strip the region, splice a new one into the repos: sequence, and hash what is present. Every line outside the markers passes through byte-identical. What the block contains is the hook renderer’s business, and reading or writing the file is the installer’s.

Enums

MarkerError

A host file whose markers cannot be trusted, or that cannot host a block.

Constants

AGENTS_BEGIN

The line that opens the managed documentation region in AGENTS.md.

AGENTS_END

The line that closes the managed documentation region in AGENTS.md.

BEGIN

The line that opens the managed pre-commit region.

END

The line that closes the managed pre-commit region.

Functions

block_hash

The hash the manifest records for a host file’s managed pre-commit region.

block_hash_with

The hash the manifest records for a host file’s region under a marker pair.

block_region

The managed region — BEGIN through END inclusive — as present in a host text, or None when no complete region exists.

block_region_with

The marked region — begin through end inclusive — for the given marker pair, or None when no complete region exists.

place_agents_block

Place an AGENTS.md block into a host, preserving every outside byte.

splice

Splice a rendered block (BEGIN through END, newline-terminated) into the repos: sequence of a marker-free base, returning the new host text and the indentation the block’s entries should have used.

splice_indent

The indentation a spliced block’s sequence items should carry, measured from the base the block will join.

split_block

Split a host text into its lines outside the managed region and the region itself, validating the markers first.

split_block_with

Split a host text into its lines outside a marked region and the region.