pi-extension-doctor
v0.1.0
Published
Read-only diagnostics for Pi extension conflicts and stale APIs
Maintainers
Readme
pi-extension-doctor
Local, command-triggered diagnostics for Pi extension conflicts and stale APIs.
Install
pi install npm:pi-extension-doctorOr try it without installing:
pi -e npm:pi-extension-doctorUse
Run /extension-doctor in Pi. Use /extension-doctor --json for deterministic JSON output.
The report distinguishes:
confirmed: conflict visible through Pi's public runtime inventory;inferred: pattern found by bounded static inspection;unknown: a path, encoding, deadline, or resource boundary prevented a safe conclusion.
Safety boundary
The doctor performs bounded reads of package roots already reported by Pi and extension files explicitly declared in each package's pi.extensions manifest. It does not recursively search your home directory or node_modules.
The doctor does not import or execute inspected source, access credentials, use the network, start subprocesses, upload telemetry, modify files, install packages, or repair extensions. Pi may already have loaded active extensions before the command runs; this package does not claim to prevent host execution.
Output omits source snippets, stack traces, and absolute paths. Untrusted identifiers and paths are length-bounded and terminal-control escaped.
Compatibility
The supported host contract is @earendil-works/[email protected] on Node.js 22.19 or newer. Older Pi releases and OMK are not claimed as compatible.
Built and verified with OMK
The release process for this package is coordinated and evidence-gated with OMK. pi-extension-doctor remains a standalone Pi extension: OMK is not a runtime dependency.
License
MIT
