metaphorics
726698e2b0
Review findings on #7586: - validate an explicit release version before comparing; the shared comparator never throws, so 999.bad previously reached every manifest - ci-release-notes imports the comparator by relative path: the release_github job runs without bun install - route Bun cache pruning through compareVersions and delete compareSemverLikeVersions - regression test for the release-version guard
@oh-my-pi/pi-utils
Shared utilities for oh-my-pi packages. Zero ceremony, Bun-first.
Notable modules
| Module | Purpose |
|---|---|
logger |
Centralized logger writing to ~/.omp/logs/ with rotation (TUI-safe — never stdout) |
prompt |
Handlebars-based prompt templating and formatting helpers |
dirs |
Path helpers for omp config directories (~/.omp, XDG-aware on Linux) |
stream |
readStream / readLines helpers over ReadableStream |
ptree / procmgr |
Process trees, ChildProcess wrapper, process lifecycle management |
postmortem |
Cleanup callbacks on exit, signals, and fatal exceptions |
which |
$which() binary lookup with caching |
fetch-retry |
fetch with retry/backoff policies |
fs-error |
Errno guards (isEnoent and friends) |
env / worker-host |
Environment plumbing and side-effect-free worker-host entry contract (workerHostEntry) |
abortable / async |
AbortSignal-aware stream/promise helpers |
peek-file |
Read the first N bytes of a file with pooled buffers |
frontmatter, glob, mime, temp, format, color, snowflake, tab-spacing, path-tree, sanitize-text |
Smaller single-purpose helpers |
Import from the root barrel or per-module subpaths (@oh-my-pi/pi-utils/<module>).
Install
bun add @oh-my-pi/pi-utils
Ships TypeScript source directly (no build step); requires Bun ≥ 1.3.14.