dcdpr / jp / 24400078632

67%

Build Type

push

github

Committed by web-flow

Commit Message

feat(plugin): Add command plugin system (RFD 072) (#521)

Introduces the command plugin infrastructure described in RFD 072.
Command plugins are standalone binaries (`jp-<name>`) that communicate
with JP over a JSON-lines protocol on stdin/stdout. JP handles workspace
discovery, config loading, and data access; plugins request these
services over the wire, making it possible to write a plugin in any
language.

Three new subcommands are added under `jp plugin`. `jp plugin list`
shows available and installed plugins from the registry alongside any
`jp-*` binaries found on `$PATH`. `jp plugin install <name>` downloads a
plugin from the registry, verifying its SHA-256 checksum before writing
to disk. `jp plugin update` refreshes the local registry cache and
reports whether installed plugins have newer versions available.

When a user runs an unknown subcommand `jp <name>`, JP resolves the
binary through three sources: the local install directory, the plugin
registry (auto-installing official plugins on first use), and `$PATH`.
Third-party and `$PATH`-discovered plugins prompt for approval before
running unless configured otherwise. Per-plugin execution policy is
controlled via a new `plugins` config section with a `run` field that
accepts `ask` (default for third-party), `unattended` (default for
official), and `deny`. Checksum pinning via
`plugins.command.<name>.checksum.value` prevents running a binary that
has changed since it was pinned.

The new `jp_plugin` crate provides the shared protocol types used by
both the host and plugin side: message types, registry structures, and
protocol constants. The first official plugin, `jp-path`, ships as a
reference implementation. It prints well-known JP directory paths from
the host's `init` message, useful in shell scripts and automation:

    jp path user-local
    jp path workspace
    jp path user-local --plugins=command

A new `plugins.yml` CI workflow builds multi-platform binaries, uploads
them to a rolli... (continued)

Coverage Stats

147 of 1210 new or added lines in 16 files covered. (12.15%)

6 existing lines in 3 files now uncovered.

21999 of 34561 relevant lines covered (63.65%)

218.82 hits per line