plugins:conformance
Validate an external executable against the plugin protocol.
Syntax#
vigil plugins:conformance --file PATH [--execute --timeout DURATION] [--json]
Options#
| Flag | Description |
|---|
--json | Emit the versioned JSON envelope. |
--file | Choose a local plugin executable. |
--execute | Exercise every declared command in an isolated temporary repository. |
--timeout | Cap each conformance command execution. |
Examples#
vigil plugins:conformance --file ./vigil-plugin-example --json
vigil --allow-mutation plugins:conformance --file ./vigil-plugin-example --execute --json
Example Use Cases#
- Use this command when you need to validate an external executable against the plugin protocol.
- Preview or review the operation before allowing repository changes.
Technical Contract#
| Binding | builtin:plugins:conformance |
|---|
| Stability | stable |
|---|
| Timeout | 30m0s |
|---|
| Required tools | None |
|---|
| Capabilities | filesystem:read, filesystem:write, network, process |
|---|
| Output formats | text, json |
|---|