Skip to content

docs(plugin,mcp,readme): the push monitor is consent-gated — say so where agents and operators read (PLAN-2613 S5, TASK-2620) - #1216

Merged
xarmian merged 1 commit into
mainfrom
docs/TASK-2620-push-gating-release-notes
Aug 27, 2026
Merged

docs(plugin,mcp,readme): the push monitor is consent-gated — say so where agents and operators read (PLAN-2613 S5, TASK-2620)#1216
xarmian merged 1 commit into
mainfrom
docs/TASK-2620-push-gating-release-notes

Conversation

@xarmian

@xarmian xarmian commented Aug 27, 2026

Copy link
Copy Markdown
Collaborator

PLAN-2613 S5 / TASK-2620 — the docs half of the release unit. Docs-only (plus the plugin version bump); the v0.15.0 release-notes Highlights are drafted in Pad as DOC-2802 per PLAYB-1160 step 2 and are not in this diff.

What this says, and where

  • plugin/skills/pad/SKILL.md — the monitor section now states the consent gate up front (D1/D2/D4): nothing streams or listens until /pad:connect (arms locally; the monitor announces on connect) or a repo-level push.auto_arm = true (vetoable per user; an auto-arm monitor that exited does not restart mid-session); no machine-global always-on; no grandfathering (D6); and the D7 caveat on the record — an agent can arm from inside its own session, visibly; the gate protects sessions from the outside. Also tells the agent never to arm on its own initiative, and what a push with no accepting session actually does (broadcast publishes with delivered_sessions: 0; targeted miss skips the publish; only the web composer withholds).
  • internal/mcp/instructions.md — a security note for MCP agents: what a push is, that it is consent-gated and self-addressed, that this connection cannot arm/receive/push (no push action in the catalog), and what to tell a user who asks to "push" something.
  • README.md §Security — the operator-facing note: consent gate, self-addressed only, no grandfathering, the accepted caveat, and that a push can inject text but cannot click a permission prompt.
  • plugin/.claude-plugin/plugin.json 0.3.2 → 0.3.3 — skill text changed (TASK-2591 precedent).
  • plugin/monitors/monitors.json re-read against D7: already the gated form from S3; unchanged.

Evidence

Release-bound

The "since v0.15.0" phrasing is forward-looking on purpose: nix/package.nix still says 0.14.0 and the tag does not exist. This PR must merge before the 0.15.0-rc.1 cut (PLAYB-1160), which owns the binary version bump; it must not ship alone.

…here agents and operators read (PLAN-2613 S5, TASK-2620)
@xarmian
xarmian marked this pull request as ready for review August 27, 2026 05:09
@xarmian
xarmian merged commit d28c28e into main Aug 27, 2026
7 checks passed
@xarmian
xarmian deleted the docs/TASK-2620-push-gating-release-notes branch August 27, 2026 05:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant