Skip to main content

Module fragments

Module fragments 

Source
Expand description

The texts rk self-depend add serves: one fragment set per manager and venue pair, the .envrc line, and the seed file for a manager the target has no file for.

Every text is an authored file under blocks/, per distribution:a-human-faced-artifact-is-authored-text; each carries RK_DEVSHELL_* tokens rendered with a plain replace, never a format, so the ${system} interpolation survives untouched. The fragments describe where they go in a form a coding agent can apply with no parser: a closed placement vocabulary, a literal anchor substring, and a three-state present from the lexical observation.

Structs§

Anchor
Where a fragment goes.
Fragment
One fragment: what to add, where, and whether it is already there.

Constants§

BLOCK_NAMES
Every self-depend block, by name.

Functions§

envrc_line
The one .envrc line, without its newline.
fragments
The fragments one pair serves, in application order, judged against the target. Every pair ends with the .envrc line: the sync runs on directory entry whatever manager moves the pin.
pinned_url
The pinned flake-input URL for a tag: the grammar’s prefix and the tag.
seed
The whole seed file for a pair whose manager file is absent, pinned at tag; None for a pair the matrix renders no fragment for.
seed_envrc
The whole seed .envrc, for the flake pair alone: use flake is what puts rk on the path there, and no other manager loads through direnv by default.
seed_flake
The whole seed flake, pinned at tag.