pi-ext
bugabingas pi extensions
owned by admin
docs: record extension startup performance rules
74b669fdc63a9c512b07afbd1b3c09a55e960de2
Oliver Krylow <o.krylow@isp-insoft.de> ·
SSH signature · not checked
Browse filesCompare with HEAD
Changed files (1)
52 52 escalate to a human.
53 53 Do not work around `mise` or add ad-hoc scripts.
55 +##
Startup performance 57 +- Treat every Win32 process spawn as expensive; prefer native Node APIs and defer unavoidable spawns to first use.
58 +- Keep entry modules thin; lazy-load command and tool implementations on first use.
59 +- Gate optional domain work with cheap relevance checks before importing implementations.
60 +- Never block startup or reload on subprocess probes, broad filesystem scans, or Git status.
61 +- Abort asynchronous startup work on reload and ignore stale results.
62 +- Check executable presence through native PATH access, not version subprocesses.
63 +- Preserve registration, validation, rendering, and first-use behavior when deferring work.
64 +- Measure performance only with the complete extension set on Win32 and WSL.
55 66 ##
Tool Widget Rendering 57 68 Tool widgets must match Pi built-ins: compact by default, expanded details on `app.tools.expand` (`ctrl+o` by default).