portzilla 0.3.0 → 0.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 +16 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -104,7 +104,7 @@ $ cargo install --path .
|
|
|
104
104
|
```console
|
|
105
105
|
$ curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/011010/portzilla/main/scripts/install.sh | sh
|
|
106
106
|
# specific version / directory:
|
|
107
|
-
$ curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/011010/portzilla/main/scripts/install.sh | PORTZILLA_VERSION=0.
|
|
107
|
+
$ curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/011010/portzilla/main/scripts/install.sh | PORTZILLA_VERSION=0.4.0 PORTZILLA_INSTALL_DIR=/usr/local/bin sh
|
|
108
108
|
```
|
|
109
109
|
|
|
110
110
|
**npm** (same native binary):
|
|
@@ -188,7 +188,19 @@ For agents with MCP access (Claude Code, etc.) — typed JSON in/out instead of
|
|
|
188
188
|
$ claude mcp add portzilla -- portzilla serve --mcp
|
|
189
189
|
```
|
|
190
190
|
|
|
191
|
-
Exposes `claim`, `who`, `ls`, `release`, `prune` as MCP tools with the same JSON shapes as `--json`. See **[docs/CLI.md#mcp-server](docs/CLI.md#mcp-server)**.
|
|
191
|
+
Exposes `claim`, `who`, `ls`, `release`, `prune`, and read-only `history` as MCP tools with the same JSON shapes as `--json`. See **[docs/CLI.md#mcp-server](docs/CLI.md#mcp-server)**.
|
|
192
|
+
|
|
193
|
+
## Audit history
|
|
194
|
+
|
|
195
|
+
Portzilla keeps the latest 10,000 operational events alongside the lease state. Lease changes, managed-process exits, and guard denies/warnings are recorded; guard allows and raw shell commands are not.
|
|
196
|
+
|
|
197
|
+
```console
|
|
198
|
+
$ portzilla history --json
|
|
199
|
+
$ portzilla history --session my-session --event guard_denied
|
|
200
|
+
$ portzilla history clear
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
History is newest-first and supports `--session`, `--port`, `--event`, `--before`, and `--limit`. Hook and guard event writes are best-effort: a journal failure never changes an allow/deny decision. The MCP server exposes the same read-only history query; clearing history is CLI-only. See **[docs/CLI.md#history](docs/CLI.md#history)**.
|
|
192
204
|
|
|
193
205
|
## Kill guard
|
|
194
206
|
|
|
@@ -213,7 +225,7 @@ Full harness setup, `sh -c` unwrapping rules, and fail-open/closed semantics →
|
|
|
213
225
|
|
|
214
226
|
## Data file & config
|
|
215
227
|
|
|
216
|
-
Resolution order: `PORTZILLA_DATA_DIR` → `$XDG_DATA_HOME/portzilla` → `~/.local/share/portzilla`. State at `leases.json` (atomic write + `leases.json.lock`).
|
|
228
|
+
Resolution order: `PORTZILLA_DATA_DIR` → `$XDG_DATA_HOME/portzilla` → `~/.local/share/portzilla`. State at `leases.json` (atomic write + `leases.json.lock`). New writes use the v3 envelope, which stores leases and bounded audit history together.
|
|
217
229
|
|
|
218
230
|
`PORTZILLA_DATA_DIR` isolates tests/CI. `tag` max 1024 chars, `session` max 512, hook stdin capped at 1 MiB. New leases persist `process_start_time` when available; reassignment JSON includes `reassignment_reason` (`lease_conflict` or `os_occupied`). Claims for an explicit PID that does not exist yet are retained as unverified/dead records, not as ownership promises. The normal CLI default attributes a claim to its live parent process. See **[docs/CLI.md](docs/CLI.md)**.
|
|
219
231
|
|
|
@@ -229,7 +241,7 @@ Resolution order: `PORTZILLA_DATA_DIR` → `$XDG_DATA_HOME/portzilla` → `~/.lo
|
|
|
229
241
|
|
|
230
242
|
## Roadmap
|
|
231
243
|
|
|
232
|
-
v0.1: `claim`/`ls`/`who`/`release`/`prune` + JSON + locked state. v0.1.x: MCP server. v0.2: kill guard + harness adapters + `portzilla guard`. v0.3: `portzilla run` + installable agent skill. The optional foreground `watch` command is implemented; an active daemon remains future work. Full plan → [`docs/ROADMAP.md`](docs/ROADMAP.md). Release procedure → [`docs/RELEASING.md`](docs/RELEASING.md).
|
|
244
|
+
v0.1: `claim`/`ls`/`who`/`release`/`prune` + JSON + locked state. v0.1.x: MCP server. v0.2: kill guard + harness adapters + `portzilla guard`. v0.3: `portzilla run` + installable agent skill + audit history. The optional foreground `watch` command is implemented; an active daemon remains future work. Full plan → [`docs/ROADMAP.md`](docs/ROADMAP.md). Release procedure → [`docs/RELEASING.md`](docs/RELEASING.md).
|
|
233
245
|
|
|
234
246
|
## License
|
|
235
247
|
|