Skip to content

Add inline build team picker, one-click merge, degradation notices, and agent-first docs - #260

Merged
raphael merged 26 commits into
mainfrom
s3-views-docs
Nov 19, 2026
Merged

raphael merged 26 commits into
mainfrom
s3-views-docs

Conversation

@raphael

@raphael raphael commented Nov 19, 2026

Copy link
Copy Markdown
Member

With live Guide attachment, Herdr-optional worker execution, and the user-only merge_change endpoint merged on the backend, Surla's browser views page and documentation still exposed the earlier terminal-driven workflow: Build and Team had no inline agent or model controls, single-agent and non-Herdr setups gave no guidance when degraded, Approve still asked the user to copy and run two git merge commands in a shell, and the onboarding guides led with manual surla init and surla CLI commands.

Resulting behavior

  • Inline Build and Team worker picker: Mounting or refreshing Build or Team loads locally installed coding-agent options and the project's required build_roles on demand (GET /team/agent-options, keeping GET /team and wait_for_changes subprocess-free and hiding unused test_writer controls on builder-only projects), pre-filling saved project choices or cross-family defaults from installed agents—or defaulting every needed worker role to the single installed agent when only one CLI is present. Each role row lets the user choose the client program, optional model and reasoning effort, and permission mode (preserving yolo: false with an explicit configured-permissions note for headless clients without a separate YOLO flag, while disclosing background process execution when Herdr is absent), and sends explicit choices to start_build and start_team_agents.
  • Dismissable degradation recommendations: When only one coding-agent family is installed (single_agent_family), when the Guide runs outside an installed Herdr app (outside_herdr), or when Herdr is not installed (herdr_unavailable), the page displays an inline recommendation explaining how Surla is running and what adding a second model family or Herdr provides, persisting dismissals per project through POST /team/notices/dismiss.
  • One-click human Merge on Approve and Build: Once a verification run has a valid live approval and remains unmerged, Approve (and the open build's post-approval summary) offers a primary Merge into current branch button (POST /changes/{change_id}/merge) that reports the merged destination branch and commit on success, surfaces actionable recovery messages for dirty_worktree, detached_head, merge_conflict, not_approved, and working_copy_busy, and retains the manual git merge commands as a secondary disclosure.
  • Agent-driven session recovery and documentation: Signed-out, expired-session, and open_views failure messages now direct the user to ask their coding agent to reopen Surla views or choose Open Page in the Herdr companion instead of typing a terminal command. README.md, docs/HOW_IT_WORKS.md, docs/REFERENCE.md, docs/ARCHITECTURE_PLAYBOOK.md, and .agents/skills/surla-ux-review/SKILL.md lead with one-time surla up (surla setup -global) registration, invoking /surla ($surla) in an open coding agent over surla stdio, live Herdr attachment and the mods/surla/ companion window, inline Build selection, one-click Merge, and graceful single-agent and no-Herdr operation.

Verification

Verified with TypeScript typechecking, viewer bundle consistency (node ui/checkpoint/build.mjs --check), served-page unit suites, and headless Chromium browser journeys across desktop and mobile viewports exercising cross-family and single-agent inline picker defaults, headless permission handling, persistent notice dismissal, and one-click Merge success and refusal states, plus link and reference checks across updated documentation.

@raphael
raphael merged commit 1237cd8 into main Nov 19, 2026
25 checks passed
@raphael
raphael deleted the s3-views-docs branch November 19, 2026 22:45
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