Sprint B.6: CLI guardrails — --dry-run, protected_repos, VULP_AGENT marker

- global --dry-run: sync/release/init/collab/license print 'DRY RUN: would...'
  and exit 0 (no auth needed for previews where possible)
- config protected_repos (name/basename, case-insensitive): mutating commands
  exit 1 on listed repos unless --force; checked before dry-run
- VULP_AGENT env: activity::log centrally appends '· via agent' to detail,
  covering both CLI and TUI writers
- sync: unknown --action now rejected before touching any repo
This commit is contained in:
dualfroz committed 2026-07-06 15:43:14 +02:00
1 parent f1432d1cd3
commit 8119cdeba7
8 files changed
+133 -14

No files matched your search

+14
View File
@@ -23,6 +23,20 @@ vulp <command> [--json] # non-interactive (scripts/AI)
- Mutating commands write to the same `~/.vulp/activity.log` as the TUI,
so CLI actions appear in the TUI's Overview feed.
## Guardrails (for AI agents especially)
- **`--dry-run`** (global flag): mutating commands (`sync`, `release`,
`init`, `repo collab`, `repo license`) print `DRY RUN: would ...` lines
and exit 0 without changing anything. Read commands ignore it.
- **`protected_repos`** (config, comma-separated in `vulp config`): mutating
commands refuse to touch listed repos (exit 1) unless **`--force`** is
passed. Matching is by display label or dir basename, case-insensitive.
The protection check runs before `--dry-run`, so a dry run also reveals it.
- **`VULP_AGENT`** (env var, any non-empty value): every activity-log entry
written while it's set gets a `· via agent` marker in its detail, so human
and agent actions are distinguishable in `vulp activity` and the TUI feed.
AI agents driving vulp should always set it.
## Workspace (local, no network)
```