Repository navigation
Add inline build team picker, one-click merge, degradation notices, and agent-first docs - #260
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
With live Guide attachment, Herdr-optional worker execution, and the user-only
merge_changeendpoint 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 twogit mergecommands in a shell, and the onboarding guides led with manualsurla initandsurlaCLI commands.Resulting behavior
build_roleson demand (GET /team/agent-options, keepingGET /teamandwait_for_changessubprocess-free and hiding unusedtest_writercontrols 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 (preservingyolo: falsewith an explicit configured-permissions note for headless clients without a separate YOLO flag, while disclosing background process execution when Herdr is absent), and sends explicitchoicestostart_buildandstart_team_agents.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 throughPOST /team/notices/dismiss.POST /changes/{change_id}/merge) that reports the merged destination branch and commit on success, surfaces actionable recovery messages fordirty_worktree,detached_head,merge_conflict,not_approved, andworking_copy_busy, and retains the manualgit mergecommands as a secondary disclosure.open_viewsfailure 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.mdlead with one-timesurla up(surla setup -global) registration, invoking/surla($surla) in an open coding agent oversurla stdio, live Herdr attachment and themods/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.