pi-change-reason

ProGovernanceFSL-1.1-ALv2

The agent must justify every edit before it runs. No silent drift - each file mutation requires a concrete, one-line reason recorded in the audit trail.

Capabilities

Justify-before-edit gate - every edit, write, and hashline_edit requires a set_change_reason call first.
One-line reasons: quick to write, slow to skip - the cost of opacity.
Reasons are emitted as governance events and land in the local event log.

Installation Instructions

Install the whole bundle

npx --yes @bastilleworks/bastille-install bastilleworks-pro-<version>.tgz

Or install this module only

npx --yes @bastilleworks/bastille-install bastilleworks-pi-change-reason-<version>.tgz

The installer fetches @bastilleworks/shared from public npm automatically. Replace <version> with the version you downloaded.

Usage Instructions

Pi command

/change-reason

Pi command

/change-reason status

When the requirement is on, the agent must call set_change_reason with a one-line reason before each edit, write, or hashline_edit. Turn it off with the same command.

Uninstall

Uninstall this extension

pi uninstall npm:@bastilleworks/pi-change-reason

Or uninstall the entire bundle

npx --yes @bastilleworks/bastille-install uninstall bastilleworks-pro-<version>.tgz

Notes

Independent of pi-change-review - install either, both, or neither. Together they require both a reason and your approval before any change lands.
Requires a valid Polar license.

All modules