@grwnd/pi-governance 1.2.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +40 -0
- package/dist/extensions/index.cjs +1169 -0
- package/dist/extensions/index.cjs.map +1 -0
- package/dist/extensions/index.d.cts +42 -0
- package/dist/extensions/index.d.ts +42 -0
- package/dist/extensions/index.js +1146 -0
- package/dist/extensions/index.js.map +1 -0
- package/dist/index.cjs +4545 -11
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +282 -1
- package/dist/index.d.ts +282 -1
- package/dist/index.js +4542 -7
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
- package/policies/base.polar +83 -0
- package/policies/tools.polar +16 -0
- package/prompts/admin.md +28 -0
- package/prompts/analyst.md +36 -0
- package/prompts/dry-run.md +36 -0
- package/prompts/project-lead.md +36 -0
package/README.md
CHANGED
|
@@ -184,6 +184,46 @@ policy:
|
|
|
184
184
|
- ./policies/tools.polar
|
|
185
185
|
```
|
|
186
186
|
|
|
187
|
+
## OpenClaw
|
|
188
|
+
|
|
189
|
+
pi-governance works with [OpenClaw](https://github.com/Grwnd-AI) out of the box. OpenClaw runs on Pi, so installing pi-governance as a Pi extension automatically governs every tool call your OpenClaw agent makes — including MCP tools.
|
|
190
|
+
|
|
191
|
+
```
|
|
192
|
+
OpenClaw gateway (WhatsApp, Discord, Telegram, …)
|
|
193
|
+
└─ Pi embedded runner
|
|
194
|
+
└─ @grwnd/pi-governance extension
|
|
195
|
+
├─ RBAC for MCP tools (create_report, upload_asset, …)
|
|
196
|
+
├─ bash command classification
|
|
197
|
+
├─ audit logging (JSONL + webhook)
|
|
198
|
+
└─ HITL approval flow
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
Put MCP tool names directly in your policy rules:
|
|
202
|
+
|
|
203
|
+
```yaml
|
|
204
|
+
# governance-rules.yaml
|
|
205
|
+
roles:
|
|
206
|
+
report_author:
|
|
207
|
+
allowed_tools:
|
|
208
|
+
- list_reports
|
|
209
|
+
- get_report
|
|
210
|
+
- create_report
|
|
211
|
+
- search_documents
|
|
212
|
+
- chat_with_report
|
|
213
|
+
- read
|
|
214
|
+
- grep
|
|
215
|
+
blocked_tools: [bash, write, edit, delete_template]
|
|
216
|
+
execution_mode: supervised
|
|
217
|
+
human_approval:
|
|
218
|
+
required_for: [create_report, upload_asset]
|
|
219
|
+
auto_approve: [list_reports, get_report, search_documents]
|
|
220
|
+
token_budget_daily: 500
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
Every MCP tool call is audited as structured JSON — see who did what, when, and whether it was approved or denied.
|
|
224
|
+
|
|
225
|
+
See the full [OpenClaw integration guide](https://grwnd-ai.github.io/pi-governance/guide/openclaw) for MCP tool reference tables, channel identity mapping, and common patterns.
|
|
226
|
+
|
|
187
227
|
## Documentation
|
|
188
228
|
|
|
189
229
|
Full documentation at **[grwnd-ai.github.io/pi-governance](https://grwnd-ai.github.io/pi-governance/)**.
|