Skip to content

plat 330

github-actions[bot] edited this page Sep 20, 2026 · 1 revision

← Pulse platform issue index

PLAT-330 — Read-only workflow users can leave durable suggestions for owners

Coordination Value
State Implemented and regression-tested locally; deployment and live acceptance pending
Date 2026-09-18
Owner security-sandbox
Related subsystem frontend-chat (existing human decisions panel)

Problem and authorized behavior

Run mode, read-only workflow users and workflow bot users cannot edit workflow design, but need to leave requested improvements for owners. Do not grant editing access or duplicate the existing decision store and UI.

submit_workflow_suggestion captures the active workflow at registration and accepts suggestion text, an optional reason and an optional step ID. It rechecks authenticated workflow visibility and workflow allowlists on every invocation. Bot route claims remain restricted to their workflow; the external actor is attributed separately from the bot execution principal.

Suggestions append to the existing workflow SQLite human decision records with source user_suggestion. The existing panel labels them as User suggestion. A new suggestion cannot replace a previous suggestion. Other creation APIs cannot forge suggestion records by setting their source.

Only a current workflow owner can answer, dismiss or consume a suggestion; bot route sessions cannot approve. Acceptance is a review decision, not unattended implementation authority. The record carries no_change; scheduled decision preflight explicitly leaves user suggestions for manual handling. Implementation needs a bounded owner request in Builder.

Contract compatibility

  • Product YAML declares the capability and tool in Builder and Run; Markdown prompts explain submission and review.
  • This is a bounded append-only permission exception, not general human-input creation or workflow mutation permission.
  • Existing human decisions, their approval/apply contracts and reviewer identities remain unchanged. User suggestion is an intake source, not a new Pulse reviewer module.
  • Shared bot credential, MCP management and workflow sharing permissions are unchanged.
  • Crew projects retain their existing private project permissions; this feature targets AgentWorks workflows.

Evidence and acceptance

workflow_suggestion_tool_test.go covers authenticated reader submission, anonymous/unshared rejection, empty text, durable attribution, owner review, reader approval/dismissal/consumption rejection, overwrite rejection, absence of unattended decision turns and bot cross-workflow rejection. Actual Builder/Run product surface E2E and focused human-input tests pass. Frontend TypeScript passes.

Live acceptance after deployment: a reader submits from testing; an owner sees the suggestion after reload, accepts or declines it, and no workflow changes or automatic fixer run occur. Repeat from a routed Slack thread. Do not mark this deployed based on service health alone.

Related: PLAT-262, PLAT-317, PLAT-278, PLAT-326.

Clone this wiki locally