mirror of
https://github.com/sipeed/picoclaw.git
synced 2026-06-12 18:08:54 +00:00
docs(exec): document build tool guard limitation
This commit is contained in:
@@ -84,6 +84,22 @@ By default, PicoClaw blocks the following dangerous commands:
|
||||
- Git: `git push`, `git force`
|
||||
- Other: `eval`, `source *.sh`
|
||||
|
||||
### Known Architectural Limitation
|
||||
|
||||
The exec guard only validates the top-level command sent to PicoClaw. It does **not** recursively inspect child
|
||||
processes spawned by build tools or scripts after that command starts running.
|
||||
|
||||
Examples of workflows that can bypass the direct command guard once the initial command is allowed:
|
||||
|
||||
- `make run`
|
||||
- `go run ./cmd/...`
|
||||
- `cargo run`
|
||||
- `npm run build`
|
||||
|
||||
This means the guard is useful for blocking obviously dangerous direct commands, but it is **not** a full sandbox for
|
||||
unreviewed build pipelines. If your threat model includes untrusted code in the workspace, use stronger isolation such
|
||||
as containers, VMs, or an approval flow around build-and-run commands.
|
||||
|
||||
### Configuration Example
|
||||
|
||||
```json
|
||||
|
||||
Reference in New Issue
Block a user