Permissions and Security Development SOP
Prerequisites
Read the module overview, then confirm the business owner, inputs, outputs, failure conditions, and permission boundary.
Procedure
- Start with ask by default.
- List allowed and denied tools.
- Choose ask, allow, or deny for network tools while noting that Linux bash remains offline.
- Review every custom tool
effect, then test nested paths, URLs, absolute paths, drives, UNC paths, and directory links against recursive and canonical checks. - Verify all three modes with real tools, not only mocks.
- Never interpret full as disabling deny, workspace, network, audit, or checkpoints.
- Windows constrained shell must fail closed. Host-shell access requires the user to select full mode, disable workspace restriction, allow network, and accept that no OS isolation exists. An isolated Linux environment remains an alternative.
- Run the listed module tests and
npm run check:modules. - Use a deterministic provider that would request the same tool every turn to test the denial boundary. After the first denial, both model-request and approval counts must equal one, the outcome must be
paused, and the target file must not exist. A two-step sequential workflow must also prove that the denied step saves no output and no later step starts. - Preserve trace, evaluation, and owner-approval evidence; do not publish without explicit authorization.
Stop conditions
Stop for unconfirmed business rules, non-reversible side effects, access outside the workspace, unavailable real credentials, or failed security gates. Ask the owner instead of expanding scope.