fix(orchestration): wire Heavy Brain mode, fix project grouping and relay display

[FridayLiu]

Summary

Fix multiple issues with the team orchestration feature:

Heavy Brain mode wiring

• Wire the Light/Heavy Brain selection from PromptInput team menu through handleOrchestrationSend to gateway.createOrchestration
• Show team menu (forced Light/Heavy choice) only on team parent sessions before first run; revert to normal send button afterward
• Add plan confirmation support to HeavyBrainOrchestrator — pauses on first dispatch when requirePlanConfirmation is set, same pattern as Light Brain

Project grouping after refresh

• Pass worktreeId and parentDirectory from the team session to OrchestrationCreateRequest so the orchestration run inherits correct project association
• Fix DAG executor to always pass the parent project directory (not the resolved worktree dir) to createSession — the worktree dir is resolved internally from worktreeId, preventing resolveProjectId from deriving the wrong project name

Relay message display

• Add internal flag to ConversationMessage and UnifiedMessage types
• Mark orchestration relay user messages as internal: true so SessionTurn hides the user bubble while preserving turn structure for the assistant response
• Suppress engine-emitted message.updated events for internal sends via internalSendSessions tracking set — prevents the relay prompt from appearing as user input in real-time
• Skip applyTitleFallback for internal messages to prevent the session title from being overwritten by the relay prompt

User prompt persistence

• Persist the user's orchestration prompt to the parent session conversation file in OrchestrationService.createRun so it survives page refresh

Files changed

• electron/main/gateway/engine-manager.ts — internal option on sendMessage, suppress user events, persist internal flag
• electron/main/services/orchestration/index.ts — persist user prompt, pass awaitPlanConfirmation to Heavy Brain, mark relay as internal
• electron/main/services/orchestration/heavy-brain.ts — plan confirmation support, accept awaitPlanConfirmation
• electron/main/services/orchestration/dag-executor.ts — always use parent dir for task execution
• src/pages/Chat.tsx — wire onTeamSend, pass worktreeId/parentDirectory, mode parameter
• src/components/PromptInput.tsx — hide send button when team menu is active
• src/components/SessionTurn.tsx — hide user bubble for internal messages
• src/types/unified.ts — add internal field to message types

[Copilot]

Pull request overview

This PR wires the unified Light/Heavy Brain “team orchestration” flow end-to-end (gateway ↔ engine manager ↔ orchestrators ↔ UI), improves project/worktree grouping reliability after refresh, and adjusts relay-message rendering so orchestration relays don’t appear as normal user input.

Changes:

• Add orchestration run APIs/events to the gateway protocol + client bindings, and implement orchestration services (DAG/task execution, skills/parsers, prompts, user relay channel, plan confirmation).
• Update UI/stores/types to support orchestration runs, plan confirmation cards, role→engine mappings, internal (hidden) relay messages, and team session grouping.
• Enhance headless dev server scripts with a restart command that preserves the managed Cloudflare tunnel where possible.

Reviewed changes

Copilot reviewed 57 out of 58 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
tests/unit/src/lib/gateway-api.test.ts	Adds unit coverage for orchestration methods/events in GatewayAPI.
tests/unit/shared/server-dev-script.test.ts	Adds integration-style tests for scripts/server-dev.sh restart behavior.
tests/unit/electron/services/orchestration/task-executor.test.ts	Tests TaskExecutor inactivity timeout, retries, worktreeId propagation, role→engine resolution.
tests/unit/electron/services/orchestration/skills.test.ts	Tests JSON extraction/parsing + planning/dispatch skill validators and retry flow.
tests/unit/electron/services/orchestration/light-brain.test.ts	Tests Light Brain worktree context, planner worktree propagation, and plan-confirmation gating.
tests/unit/electron/services/orchestration/index.test.ts	Tests orchestration service persistence, relay contract, role mappings, and plan confirmation gate behavior.
tests/unit/electron/services/orchestration/dag-executor.test.ts	Tests DAG execution ordering, concurrency limits, and team worktree routing logic.
tests/unit/electron/gateway/ws-server.test.ts	Adds gateway WS route + broadcast tests for orchestration requests/notifications.
src/types/unified.ts	Introduces orchestration types + gateway request/notification constants; adds internal?: boolean on messages.
src/stores/session.ts	Adds teamId grouping + teamOrchestrationEnabled feature flag in session store.
src/stores/orchestration.ts	New frontend orchestration store for runs/teams/session grouping + role mappings persistence/sync.
src/pages/Settings.tsx	Adds team orchestration toggle and role→engine mapping editor UI.
src/locales/zh.ts	Adds i18n strings for orchestration UI + settings.
src/locales/ru.ts	Adds i18n strings for orchestration UI + settings.
src/locales/en.ts	Adds i18n strings for orchestration UI + settings.
src/lib/theme.ts	Changes default theme fallback behavior.
src/lib/gateway-client.ts	Adds orchestration APIs + event typings to gateway client.
src/lib/gateway-api.ts	Adds orchestration methods + binds orchestration notifications to handlers.
src/index.css	Adds CSS tooltip workaround for sidebar buttons with title.
src/components/orchestration/TeamResultCard.tsx	UI card for completed/failed run summary + per-subtask results.
src/components/orchestration/TeamPlanCard.tsx	UI card for plan confirmation/editing before execution.
src/components/orchestration/TeamExecutionCard.tsx	UI card for live DAG execution progress + visualization.
src/components/orchestration/SubtaskEditor.tsx	Editor for modifying subtasks (role/engine/deps/description).
src/components/orchestration/OrchestrationCards.tsx	Switchboard component for orchestration status → appropriate card.
src/components/SessionTurn.tsx	Hides user bubble for internal user messages while preserving turn structure.
src/components/PromptInput.tsx	Adds Team Run menu (Light/Heavy) and relay-to-orchestrator UX behavior.
scripts/server-init.sh	Documents new server:restart command.
scripts/server-dev.sh	Implements restart that preserves managed tunnel when possible.
package.json	Adds server:restart npm script; bumps @github/copilot-sdk version.
electron/main/services/orchestration/user-channel.ts	Adds a buffered human-in-the-loop channel for orchestrator relays.
electron/main/services/orchestration/task-executor.ts	Implements per-subtask session execution, retries, inactivity timeout handling.
electron/main/services/orchestration/skills.ts	Adds structured-output “skills” for planning/dispatch JSON formats + retry/correction loop.
electron/main/services/orchestration/prompts.ts	Adds engine-agnostic prompt templates and task-result formatting.
electron/main/services/orchestration/logger.ts	Re-exports scoped logger for orchestration.
electron/main/services/orchestration/light-brain.ts	Implements Light Brain DAG planning + optional plan confirmation + execution.
electron/main/services/orchestration/guardrails.ts	Adds orchestration guardrail constants.
electron/main/services/orchestration/dag-executor.ts	Implements deterministic DAG scheduler + team worktree routing policy.
electron/main/services/orchestration/index.ts	OrchestrationService CRUD, persistence, role mappings, plan-confirmation gate, and run execution wiring.
electron/main/services/orchestration/heavy-brain.ts	Heavy Brain orchestrator loop support (incl. relays / dispatch protocol).
electron/main/services/logger.ts	Adds orchestrationLog scope.
electron/main/index.ts	Initializes orchestrationService at app startup.
electron/main/gateway/ws-server.ts	Adds gateway routes + broadcasts for orchestration APIs and whitelists team-* worktrees.
electron/main/gateway/engine-manager.ts	Adds internal-send suppression + internal message persistence + buffered-part merge into returned message.
electron/main/engines/opencode/index.ts	Adds per-session system prompt composition for orchestration instructions.
electron/main/engines/copilot/index.ts	Adds per-session system prompt composition for orchestration instructions (create/resume).
electron/main/engines/codex/index.ts	Adds per-session system prompt propagation into thread start/resume.
electron/main/engines/claude/index.ts	Adds per-session system prompt append support.
docs/orchestration.md	Adds orchestration architecture/behavior documentation.
bun.lock	Updates lockfile for @github/copilot-sdk bump.
README.zh-CN.md	Updates quick tunnel rotation wording.
README.ru.md	Updates quick tunnel rotation wording.
README.md	Documents server:restart and updates quick tunnel rotation wording.
README.ko.md	Updates quick tunnel rotation wording.
README.ja.md	Updates quick tunnel rotation wording.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

internalSendSessions is only cleared after adapter.sendMessage resolves. If adapter.sendMessage throws/rejects, the session will remain in internalSendSessions, causing future real user message.updated events to be suppressed indefinitely for that engine session. Move the internalSendSessions.delete(engineSessionId) into a finally block that always runs after the send attempt (and only add/delete when options.internal is true).

Suggested change

	const result = await adapter.sendMessage(engineSessionId, content, {
	...options,
	directory: conv.directory,
	});
	// Clear the internal send suppression flag after the send completes
	this.internalSendSessions.delete(engineSessionId);
	let result;
	try {
	result = await adapter.sendMessage(engineSessionId, content, {
	...options,
	directory: conv.directory,
	});
	} finally {
	// Clear the internal send suppression flag after the send attempt completes
	if (options?.internal) {
	this.internalSendSessions.delete(engineSessionId);
	}
	}