chatroom-cli 1.118.0 → 1.119.0

package/dist/index.js

@@ -27792,6 +27792,100 @@ var init_base_cli_agent_service = __esm(() => {
   retrySchedule = exports_Schedule.exponential(exports_Duration.millis(DETECTION_RETRY_POLICY.initialDelayMs), DETECTION_RETRY_POLICY.backoffFactor).pipe(exports_Schedule.either(exports_Schedule.spaced(exports_Duration.millis(DETECTION_RETRY_POLICY.maxDelayMs))), exports_Schedule.compose(exports_Schedule.recurs(DETECTION_RETRY_POLICY.maxAttempts - 1)));
 });
 
+// ../../services/backend/src/domain/entities/_shared/v-literals-of.ts
+var toLiteralValidators = (values3) => values3.map((v_) => v.literal(v_));
+var init_v_literals_of = __esm(() => {
+  init_values();
+});
+
+// ../../services/backend/src/domain/entities/agent.ts
+var AGENT_HARNESSES, AgentHarnessEnum, agentHarnessValidator, AGENT_TYPES, AgentTypeEnum, agentTypeValidator, MACHINE_COMMAND_TYPES, MachineCommandTypeEnum, machineCommandTypeValidator, MACHINE_COMMAND_STATUSES, MachineCommandStatusEnum, machineCommandStatusValidator, AgentStartReasonCode, AGENT_START_REASONS, DaemonStartReasonCode, agentStartReasonValidator, USER_EXPLICIT_START_REASONS, EXPLICIT_DAEMON_START_REASONS, isExplicitDaemonStart = (reason) => EXPLICIT_DAEMON_START_REASONS.includes(reason), AGENT_STOP_REASONS, agentPostStopDesiredStateValidator, AgentStopReasonEnum, MODEL_SOURCES, ModelSourceEnum, modelSourceValidator;
+var init_agent = __esm(() => {
+  init_values();
+  init_v_literals_of();
+  AGENT_HARNESSES = [
+    "opencode",
+    "opencode-sdk",
+    "pi",
+    "pi-sdk",
+    "cursor",
+    "cursor-sdk",
+    "claude",
+    "claude-sdk",
+    "codex-sdk",
+    "copilot",
+    "commandcode"
+  ];
+  AgentHarnessEnum = Object.fromEntries(AGENT_HARNESSES.map((h) => [h, h]));
+  agentHarnessValidator = v.union(...toLiteralValidators(AGENT_HARNESSES));
+  AGENT_TYPES = ["remote", "custom"];
+  AgentTypeEnum = Object.fromEntries(AGENT_TYPES.map((t) => [t, t]));
+  agentTypeValidator = v.union(...toLiteralValidators(AGENT_TYPES));
+  MACHINE_COMMAND_TYPES = ["start-agent", "restart-agent", "ping", "status"];
+  MachineCommandTypeEnum = Object.fromEntries(MACHINE_COMMAND_TYPES.map((c) => [c, c]));
+  machineCommandTypeValidator = v.union(...toLiteralValidators(MACHINE_COMMAND_TYPES));
+  MACHINE_COMMAND_STATUSES = ["pending", "completed", "failed"];
+  MachineCommandStatusEnum = Object.fromEntries(MACHINE_COMMAND_STATUSES.map((s) => [s, s]));
+  machineCommandStatusValidator = v.union(...toLiteralValidators(MACHINE_COMMAND_STATUSES));
+  AgentStartReasonCode = {
+    USER_START: "user.start",
+    USER_RESTART: "user.restart",
+    USER_MANUAL_SPAWN: "user.manual_spawn",
+    PLATFORM_TASK_MONITOR_NUDGE: "platform.task_monitor_nudge",
+    PLATFORM_TASK_START_IN_NEW_SESSION: "platform.task_start_in_new_session",
+    PLATFORM_PENDING_TASK_WAKE: "platform.pending_task_wake",
+    PLATFORM_AUTO_RESTART_ON_NEW_CONTEXT: "platform.auto_restart_on_new_context",
+    PLATFORM_TEAM_SWITCH: "platform.team_switch",
+    TEST: "test"
+  };
+  AGENT_START_REASONS = [
+    AgentStartReasonCode.USER_START,
+    AgentStartReasonCode.USER_RESTART,
+    AgentStartReasonCode.USER_MANUAL_SPAWN,
+    AgentStartReasonCode.PLATFORM_TASK_MONITOR_NUDGE,
+    AgentStartReasonCode.PLATFORM_TASK_START_IN_NEW_SESSION,
+    AgentStartReasonCode.PLATFORM_PENDING_TASK_WAKE,
+    AgentStartReasonCode.PLATFORM_AUTO_RESTART_ON_NEW_CONTEXT,
+    AgentStartReasonCode.PLATFORM_TEAM_SWITCH,
+    AgentStartReasonCode.TEST
+  ];
+  DaemonStartReasonCode = {
+    RESPAWN: "daemon.respawn"
+  };
+  agentStartReasonValidator = v.union(...toLiteralValidators(AGENT_START_REASONS));
+  USER_EXPLICIT_START_REASONS = [
+    AgentStartReasonCode.USER_START,
+    AgentStartReasonCode.USER_RESTART
+  ];
+  EXPLICIT_DAEMON_START_REASONS = [
+    ...USER_EXPLICIT_START_REASONS,
+    AgentStartReasonCode.USER_MANUAL_SPAWN,
+    AgentStartReasonCode.PLATFORM_TASK_MONITOR_NUDGE,
+    AgentStartReasonCode.PLATFORM_PENDING_TASK_WAKE,
+    AgentStartReasonCode.PLATFORM_TASK_START_IN_NEW_SESSION,
+    DaemonStartReasonCode.RESPAWN
+  ];
+  AGENT_STOP_REASONS = [
+    "user.stop",
+    "user.restart",
+    "platform.dedup",
+    "platform.team_switch",
+    "platform.task_monitor_nudge",
+    "platform.task_start_in_new_session",
+    "daemon.respawn",
+    "daemon.shutdown",
+    "daemon.stop_timeout",
+    "platform.ephemeral_task_complete",
+    "platform.task_cancelled",
+    "test"
+  ];
+  agentPostStopDesiredStateValidator = v.union(v.literal("running"), v.literal("stopped"));
+  AgentStopReasonEnum = Object.fromEntries(AGENT_STOP_REASONS.map((r) => [r, r]));
+  MODEL_SOURCES = ["team_config", "none"];
+  ModelSourceEnum = Object.fromEntries(MODEL_SOURCES.map((s) => [s, s]));
+  modelSourceValidator = v.union(...toLiteralValidators(MODEL_SOURCES));
+});
+
 // ../../services/backend/src/domain/entities/harness/claude-sdk.config.ts
 var claudeSdkCapabilities;
 var init_claude_sdk_config = __esm(() => {
@@ -28258,7 +28352,7 @@ function createAgentProcessManagerService(deps) {
             await awaitWithinDeadline(deps.execution.stop({
               chatroomId: input.chatroomId,
               role: input.role,
-              reason: "daemon.respawn",
+              reason: DaemonStartReasonCode.RESPAWN,
               pid: slot.pid,
               workingDir: input.workingDir
             }), remaining, input.signal);
@@ -28368,6 +28462,7 @@ function createAgentProcessManagerService(deps) {
 }
 var NATIVE_DELIVERY_SLOT_WAIT_MS = 120000, SLOT_CHANGE_POLL_MS = 100;
 var init_agent_process_manager_service = __esm(() => {
+  init_agent();
   init_types();
   init_check_agent_slot();
 });
@@ -28772,86 +28867,6 @@ var init_native_turn_phase = __esm(() => {
   init_agent_slot();
 });
 
-// ../../services/backend/src/domain/entities/_shared/v-literals-of.ts
-var toLiteralValidators = (values3) => values3.map((v_) => v.literal(v_));
-var init_v_literals_of = __esm(() => {
-  init_values();
-});
-
-// ../../services/backend/src/domain/entities/agent.ts
-var AGENT_HARNESSES, AgentHarnessEnum, agentHarnessValidator, AGENT_TYPES, AgentTypeEnum, agentTypeValidator, MACHINE_COMMAND_TYPES, MachineCommandTypeEnum, machineCommandTypeValidator, MACHINE_COMMAND_STATUSES, MachineCommandStatusEnum, machineCommandStatusValidator, AGENT_START_REASONS, AgentStartReasonEnum, agentStartReasonValidator, USER_EXPLICIT_START_REASONS, EXPLICIT_DAEMON_START_REASONS, isExplicitDaemonStart = (reason) => EXPLICIT_DAEMON_START_REASONS.includes(reason), AGENT_STOP_REASONS, agentPostStopDesiredStateValidator, AgentStopReasonEnum, MODEL_SOURCES, ModelSourceEnum, modelSourceValidator;
-var init_agent = __esm(() => {
-  init_values();
-  init_v_literals_of();
-  AGENT_HARNESSES = [
-    "opencode",
-    "opencode-sdk",
-    "pi",
-    "pi-sdk",
-    "cursor",
-    "cursor-sdk",
-    "claude",
-    "claude-sdk",
-    "codex-sdk",
-    "copilot",
-    "commandcode"
-  ];
-  AgentHarnessEnum = Object.fromEntries(AGENT_HARNESSES.map((h) => [h, h]));
-  agentHarnessValidator = v.union(...toLiteralValidators(AGENT_HARNESSES));
-  AGENT_TYPES = ["remote", "custom"];
-  AgentTypeEnum = Object.fromEntries(AGENT_TYPES.map((t) => [t, t]));
-  agentTypeValidator = v.union(...toLiteralValidators(AGENT_TYPES));
-  MACHINE_COMMAND_TYPES = ["start-agent", "restart-agent", "ping", "status"];
-  MachineCommandTypeEnum = Object.fromEntries(MACHINE_COMMAND_TYPES.map((c) => [c, c]));
-  machineCommandTypeValidator = v.union(...toLiteralValidators(MACHINE_COMMAND_TYPES));
-  MACHINE_COMMAND_STATUSES = ["pending", "completed", "failed"];
-  MachineCommandStatusEnum = Object.fromEntries(MACHINE_COMMAND_STATUSES.map((s) => [s, s]));
-  machineCommandStatusValidator = v.union(...toLiteralValidators(MACHINE_COMMAND_STATUSES));
-  AGENT_START_REASONS = [
-    "user.start",
-    "user.restart",
-    "user.manual_spawn",
-    "platform.task_monitor_nudge",
-    "platform.task_start_in_new_session",
-    "platform.pending_task_wake",
-    "platform.auto_restart_on_new_context",
-    "platform.team_switch",
-    "test"
-  ];
-  AgentStartReasonEnum = Object.fromEntries(AGENT_START_REASONS.map((r) => [r, r]));
-  agentStartReasonValidator = v.union(...toLiteralValidators(AGENT_START_REASONS));
-  USER_EXPLICIT_START_REASONS = [
-    AgentStartReasonEnum["user.start"],
-    AgentStartReasonEnum["user.restart"]
-  ];
-  EXPLICIT_DAEMON_START_REASONS = [
-    ...USER_EXPLICIT_START_REASONS,
-    AgentStartReasonEnum["user.manual_spawn"],
-    AgentStartReasonEnum["platform.task_monitor_nudge"],
-    AgentStartReasonEnum["platform.task_start_in_new_session"],
-    "daemon.respawn"
-  ];
-  AGENT_STOP_REASONS = [
-    "user.stop",
-    "user.restart",
-    "platform.dedup",
-    "platform.team_switch",
-    "platform.task_monitor_nudge",
-    "platform.task_start_in_new_session",
-    "daemon.respawn",
-    "daemon.shutdown",
-    "daemon.stop_timeout",
-    "platform.ephemeral_task_complete",
-    "platform.task_cancelled",
-    "test"
-  ];
-  agentPostStopDesiredStateValidator = v.union(v.literal("running"), v.literal("stopped"));
-  AgentStopReasonEnum = Object.fromEntries(AGENT_STOP_REASONS.map((r) => [r, r]));
-  MODEL_SOURCES = ["team_config", "none"];
-  ModelSourceEnum = Object.fromEntries(MODEL_SOURCES.map((s) => [s, s]));
-  modelSourceValidator = v.union(...toLiteralValidators(MODEL_SOURCES));
-});
-
 // src/daemon/services/agent-process-service/infrastructure/adapters/orphan-process-tracker.ts
 import { createHash } from "node:crypto";
 import {
@@ -43674,7 +43689,7 @@ var init_agent_lifecycle_fact_schema = __esm(() => {
       ...agent,
       kind: exports_external.literal("status"),
       status: exports_external.enum(["offline", "starting", "waiting", "working", "stopping", "error"]),
-      errorSource: exports_external.enum(["configuration", "runtime", "task", "enhancer", "stop"]).optional(),
+      errorSource: exports_external.enum(["configuration", "runtime", "task", "stop"]).optional(),
       errorCode: exports_external.string().optional(),
       errorMessage: exports_external.string().optional()
     }),
@@ -45410,7 +45425,7 @@ class AgentProcessManager {
       slot.state = AGENT_SLOT_STATE.STOPPING;
       const stopGeneration = this.bumpStopGeneration(slot);
       slot.stoppingSince = this.deps.clock.now();
-      await this.doStop(key, slot, pid, { chatroomId, role, reason: "daemon.respawn", workingDir }, stopGeneration);
+      await this.doStop(key, slot, pid, { chatroomId, role, reason: DaemonStartReasonCode.RESPAWN, workingDir }, stopGeneration);
     }
   }
   async killPersistedProcessIfAlive(chatroomId, role, workingDir) {
@@ -45799,6 +45814,9 @@ class AgentProcessManager {
   }
   async doEnsureRunning(key, slot, opts) {
     slot.state = AGENT_SLOT_STATE.SPAWNING;
+    const rateLimit = this.checkRateLimitGate(opts, slot);
+    if (rateLimit)
+      return rateLimit;
     const authorization = await this.deps.backend.mutation(api.machines.authorizeAgentStart, {
       sessionId: this.deps.sessionId,
       machineId: this.deps.machineId,
@@ -45813,9 +45831,6 @@ class AgentProcessManager {
     const wantResume = opts.wantResume;
     console.log(`[AgentProcessManager] harness start: role=${opts.role} harness=${opts.agentHarness} wantResume=${wantResume} reason=${opts.reason}`);
     try {
-      const rateLimit = this.checkRateLimitGate(opts, slot);
-      if (rateLimit)
-        return rateLimit;
       const workingDir = await this.validateWorkingDirGate(opts, slot);
       if (workingDir)
         return workingDir;
@@ -46229,7 +46244,7 @@ async function ensureColdSessionBeforeNativeInject(task, deps) {
         agentHarness,
         model,
         workingDir,
-        reason: AgentStartReasonEnum["platform.task_start_in_new_session"],
+        reason: AgentStartReasonCode.PLATFORM_TASK_START_IN_NEW_SESSION,
         wantResume: false
       }, context5.signal);
       return waitForHarnessSessionId(deps.agentMgr, chatroomId, role, context5.signal);
@@ -47754,7 +47769,7 @@ async function processTasksUpdate(taskService, configurationService, pass, isTas
         agentHarness: agentConfig.agentHarness,
         model: agentConfig.model ?? "",
         workingDir: agentConfig.workingDir,
-        reason: AgentStartReasonEnum["platform.pending_task_wake"],
+        reason: AgentStartReasonCode.PLATFORM_PENDING_TASK_WAKE,
         wantResume: false,
         taskId: task.taskId
       };
@@ -106971,15 +106986,15 @@ var init_team_presets = __esm(() => {
     duo: {
       structureId: TEAM_STRUCTURE_IDS.duo,
       name: "Duo",
-      description: "A planner and builder working as a pair, planner as coordinator, with optional ephemeral enhancer",
-      roles: ["planner", "enhancer", "builder"],
+      description: "A planner and builder working as a pair, planner as coordinator, with optional ephemeral architect and optional ephemeral uiux-engineer roles",
+      roles: ["planner", "architect", "uiux-engineer", "builder"],
       entryPoint: "planner"
     },
     solo: {
       structureId: TEAM_STRUCTURE_IDS.solo,
       name: "Solo",
-      description: "A single agent working independently, with optional ephemeral enhancer",
-      roles: ["solo", "enhancer"],
+      description: "A single agent working independently, with optional ephemeral architect and optional ephemeral uiux-engineer roles",
+      roles: ["solo", "architect", "uiux-engineer"],
       entryPoint: "solo"
     }
   };
@@ -107175,6 +107190,22 @@ var init_agent2 = __esm(() => {
   init_storage2();
 });
 
+// ../../services/backend/prompts/cli/handoff/command.ts
+function handoffCommand(params) {
+  const prefix = params.cliEnvPrefix || "";
+  const chatroomId = params.chatroomId || "<chatroom-id>";
+  const role = params.role || "<role>";
+  const nextRole = params.nextRole || "<target>";
+  const placeholder = params.messagePlaceholder ?? "[Your message here]";
+  const commandPrefix = `${prefix}chatroom handoff --chatroom-id="${chatroomId}" --role="${role}" --next-role="${nextRole}"`;
+  return formatStdinHeredocCommand(commandPrefix, HANDOFF_STDIN_DELIMITER, placeholder, {
+    messageMarker: HANDOFF_MESSAGE_MARKER
+  });
+}
+var init_command2 = __esm(() => {
+  init_stdin_heredoc();
+});
+
 // ../../services/backend/prompts/native/handoff-visibility.ts
 function recipientLabel(toRole) {
   return toRole.toLowerCase() === "user" ? "The user" : `The \`${toRole}\` agent`;
@@ -107198,6 +107229,285 @@ Put your **complete** deliverable in the handoff message — not in session text
 ---`;
 }
 
+// ../../services/backend/prompts/utils/file-reference-guidance.ts
+function getFileReferenceGuidanceComment() {
+  return `<!-- File references (clickable in workspace UI): use repo-relative paths with a file extension — e.g. \`apps/webapp/src/modules/chatroom/foo.ts\` or [apps/webapp/src/foo.ts](apps/webapp/src/foo.ts). Avoid absolute paths, file:// prefixes, and paths without / or extension. -->`;
+}
+function getFileReferenceProofOfCompletionExample() {
+  return `${getFileReferenceGuidanceComment()}
+- \`apps/webapp/src/path/to/file.ts\` — <what changed and why>`;
+}
+
+// ../../services/backend/prompts/teams/architect-handoff-templates.ts
+function normalizeEntryPointRole(entryPointRole) {
+  return entryPointRole.trim().toLowerCase() || "planner";
+}
+function getArchitectFocus() {
+  return "module boundaries, APIs, schemas, indexes and queries, invariants, failure and recovery handling, tests, and implementation sequence";
+}
+function getArchitectRequirements() {
+  return `
+- Cite repository evidence for domain model/entity ownership, lifecycle, invariants, identifiers, and relationships.
+- Define service and module boundaries, public and internal APIs, function signatures, and ownership of side effects.
+- Analyze concurrency and races: concurrent writers, idempotency, ordering and monotonicity, retries, transactions, and failure/recovery behavior.
+- Design read patterns first: primary read paths, indexes, projections/read models, query shapes, scan and transaction limits, and invalidation/subscription scope.
+- Account for Convex reactivity and bandwidth: query invalidation patterns, avoiding unnecessary reactive fanout, and separating high-frequency heartbeat/liveness/status fields from low-frequency identity/configuration fields.
+- Specify concrete schema, query, and mutation changes; migration/backfill sequence; tests; and verification order.`;
+}
+function getEntryPointToArchitectHandoffTemplate(entryPointRole) {
+  const entryPoint = normalizeEntryPointRole(entryPointRole);
+  return `${getHandoffRecipientVisibilityCallout("architect")}
+
+## Handoff Template (${entryPoint} → architect)
+
+The automatically injected \`<user-message>\` is the authoritative request. Add only concise context that the Architect needs to design within the existing repository and team scope.
+
+Provide the request, relevant constraints, and the files or product surfaces that need inspection. Ask for one evidence-backed design focused on ${getArchitectFocus()}.
+
+After completing the design, hand it back to \`${entryPoint}\` with the normal handoff command. Stop after the successful handoff; do not implement the design or delegate further work.
+
+\`\`\`bash
+${handoffCommand({
+    chatroomId: "<chatroom-id>",
+    role: "architect",
+    nextRole: entryPoint,
+    cliEnvPrefix: ""
+  })}
+\`\`\``;
+}
+function getArchitectToEntryPointHandoffTemplate(entryPointRole) {
+  return renderArchitectToEntryPointHandoffTemplate(normalizeEntryPointRole(entryPointRole));
+}
+function getGenericArchitectToEntryPointHandoffTemplate() {
+  return renderArchitectToEntryPointHandoffTemplate("<entry-point-role>", true);
+}
+function renderArchitectToEntryPointHandoffTemplate(entryPoint, generic = false) {
+  const sharedContractsHeading = !generic && entryPoint === "planner" ? "## Shared contracts (planner-owned)" : "## Shared contracts (configured entry-point-owned)";
+  const placeholderInstruction = generic ? " Replace `<entry-point-role>` with the configured entry-point role before running it." : "";
+  return `${getHandoffRecipientVisibilityCallout(entryPoint)}
+
+## Handoff Template (Architect → Entry Point)
+
+Return exactly one recommended, evidence-backed design brief for the authoritative user request to the configured entry point. This is an advisory handback: do not implement code, edit files, spawn subagents, present alternatives, or expand scope. The injected \`<handoff-templates>\` block is the authoritative structure for this handoff; complete every section in order. Use \`Not Applicable.\` only when a section is genuinely inapplicable, with no explanation or filler.
+
+## Summary
+<describe the design problem being solved, the repository/product surface where it fits, and the evidence-backed context; do not refer to hidden session text>
+
+## Goal
+<state the one-sentence outcome this design delivers>
+
+## Key Knowledge for High Quality Bar
+<cite the inspected repository patterns and complete the architect checklist below; do not provide a high-level essay>
+- Produce exactly one recommended design for ${getArchitectFocus()}.
+- Name concrete repository paths, existing abstractions, APIs/types, state/data flow, acceptance criteria, risks, and verification steps.
+${getArchitectRequirements()}
+
+## Force Multipliers
+<name the existing abstractions, patterns, utilities, and platform conventions to reuse, and state why each reduces implementation risk or duplication>
+- Keep the design within the repository's established source-of-truth boundaries and avoid introducing a new registry or abstraction without evidence.
+
+## Files to implement (exhaustive, file-level)
+List every file or product surface the implementer must create or modify. Mark each \`(Required)\` or \`(Optional)\`. For every file, give the exact responsibility, exported types/signatures/query shape, state/data/event boundaries, and target code detailed enough to implement without guessing.
+${getFileReferenceGuidanceComment()}
+
+### \`<repo-relative/path.ext>\` (Required)
+**Change:** <precise add/modify/remove responsibility and why>
+
+\`\`\`text
+// Target code, API/type signature, query shape, or migration/backfill step.
+// Enough detail that implementation requires no invention.
+\`\`\`
+
+<add one block per file; do not collapse multiple files into a directory or vague layer>
+
+${sharedContractsHeading}
+<list cross-file interfaces, schemas, API contracts, state/data boundaries, or write exactly \`Not Applicable.\` when genuinely inapplicable>
+
+### Interfaces & types
+\`\`\`typescript
+// Shared signatures, schemas, query/mutation shapes, or state contracts.
+\`\`\`
+
+### Reference snippets
+\`\`\`typescript
+// Canonical imports, call patterns, or data-flow examples.
+\`\`\`
+
+## Requirements (acceptance criteria)
+- <one concrete, verifiable requirement per bullet; include exact data shape, API contract, migration result, and failure behavior>
+- Include repository test coverage for domain, concurrency, read-pattern, migration, and recovery risk areas.
+- Verify the implemented user-facing entry point or task-delivery path end-to-end; unit tests alone are insufficient.
+
+## What to avoid
+- Do not implement code or edit files as the architect; this handoff is advisory only.
+- Do not present alternative designs, generic advice, or requirements without concrete evidence and file-level consequences.
+- Do not invent APIs, schema fields, query shapes, indexes, or source-of-truth locations when existing repository patterns apply.
+- <explicit task-specific anti-patterns, scope boundaries, and migration/source-of-truth pitfalls>
+
+## Skills to activate
+- <relevant repository skills and why they apply, or write exactly \`Not Applicable.\` when none apply>
+
+## Out of scope
+- <explicit files, flows, behavior, or migration work the implementer must not touch>
+
+## Handoff
+Run the normal handoff command to the configured entry point with this complete design, then stop.${placeholderInstruction}
+
+\`\`\`bash
+${handoffCommand({
+    chatroomId: "<chatroom-id>",
+    role: "architect",
+    nextRole: entryPoint,
+    cliEnvPrefix: ""
+  })}
+\`\`\``;
+}
+var init_architect_handoff_templates = __esm(() => {
+  init_command2();
+});
+
+// ../../services/backend/prompts/teams/uiux-engineer-handoff-templates.ts
+function normalizeEntryPointRole2(entryPointRole) {
+  return entryPointRole.trim().toLowerCase() || "planner";
+}
+function getUiuxEngineerFocus() {
+  return "complete user flows, loading/empty/error/success states, component ownership, theme tokens and layout, keyboard and accessibility behavior, responsive details, and UI tests";
+}
+function getUiuxEngineerRequirements() {
+  return `
+- Specify complete user flows with explicit loading, empty, error, success, disabled, and retry states where applicable.
+- Define exact keyboard shortcuts, focus order, keyboard navigation, focus restoration, and accessible semantics and labels.
+- Define component hierarchy and ownership, props/state/events, data boundaries, and interaction behavior.
+- Choose concrete existing ShadCN components with the Base UI backend and lucide-react/react-icons conventions; do not write "use an appropriate component."
+- Specify Tailwind utility classes or semantic theme-token classes for layout, spacing, sizing, typography, states, responsive behavior, and dark mode.
+- Specify responsive breakpoints/layout behavior, visual feedback, destructive-action safeguards, exact files/components, and the UI/integration/accessibility test plan.`;
+}
+function getEntryPointToUiuxEngineerHandoffTemplate(entryPointRole) {
+  const entryPoint = normalizeEntryPointRole2(entryPointRole);
+  return `${getHandoffRecipientVisibilityCallout("uiux-engineer")}
+
+## Handoff Template (${entryPoint} → uiux-engineer)
+
+The automatically injected \`<user-message>\` is the authoritative request. Add only concise context that the UI/UX Engineer needs to design within the existing repository and team scope.
+
+Provide the request, relevant constraints, and the files or product surfaces that need inspection. Ask for one evidence-backed design focused on ${getUiuxEngineerFocus()}.
+
+After completing the design, hand it back to \`${entryPoint}\` with the normal handoff command. Stop after the successful handoff; do not implement the design or delegate further work.
+
+\`\`\`bash
+${handoffCommand({
+    chatroomId: "<chatroom-id>",
+    role: "uiux-engineer",
+    nextRole: entryPoint,
+    cliEnvPrefix: ""
+  })}
+\`\`\``;
+}
+function getUiuxEngineerToEntryPointHandoffTemplate(entryPointRole) {
+  return renderUiuxEngineerToEntryPointHandoffTemplate(normalizeEntryPointRole2(entryPointRole));
+}
+function getGenericUiuxEngineerToEntryPointHandoffTemplate() {
+  return renderUiuxEngineerToEntryPointHandoffTemplate("<entry-point-role>", true);
+}
+function renderUiuxEngineerToEntryPointHandoffTemplate(entryPoint, generic = false) {
+  const sharedContractsHeading = !generic && entryPoint === "planner" ? "## Shared contracts (planner-owned)" : "## Shared contracts (configured entry-point-owned)";
+  const placeholderInstruction = generic ? " Replace `<entry-point-role>` with the configured entry-point role before running it." : "";
+  return `${getHandoffRecipientVisibilityCallout(entryPoint)}
+
+## Handoff Template (UI/UX Engineer → Entry Point)
+
+Return exactly one recommended, evidence-backed design brief for the authoritative user request to the configured entry point. This is an advisory handback: do not implement code, edit files, spawn subagents, present alternatives, or expand scope. The injected \`<handoff-templates>\` block is the authoritative structure for this handoff; complete every section in order. Use \`Not Applicable.\` only when a section is genuinely inapplicable, with no explanation or filler.
+
+## Summary
+<describe the design problem being solved, the repository/product surface where it fits, and the evidence-backed context; do not refer to hidden session text>
+
+## Goal
+<state the one-sentence outcome this design delivers>
+
+## Key Knowledge for High Quality Bar
+<cite the inspected repository patterns and complete the UI/UX engineer checklist below; do not provide a high-level essay>
+- Produce exactly one recommended design for ${getUiuxEngineerFocus()}.
+- Name concrete repository paths, existing components/tokens, props/state/events, data boundaries, acceptance criteria, risks, and verification steps.
+${getUiuxEngineerRequirements()}
+
+## Force Multipliers
+<name the existing components, patterns, tokens, utilities, and platform conventions to reuse, and state why each reduces implementation risk or duplication>
+- Keep the design within the repository's established source-of-truth boundaries and avoid introducing a new registry or abstraction without evidence.
+
+## Files to implement (exhaustive, file-level)
+List every file or product surface the implementer must create or modify. Mark each \`(Required)\` or \`(Optional)\`. For every file, give the exact responsibility, exported types/signatures/props, state/data/event boundaries, component hierarchy, and target Tailwind/theme-token snippet detailed enough to implement without guessing.
+${getFileReferenceGuidanceComment()}
+
+### \`<repo-relative/path.ext>\` (Required)
+**Change:** <precise add/modify/remove responsibility and why>
+
+\`\`\`text
+// Component hierarchy, props/state/events, test structure, or exact
+// Tailwind/theme-token classes. Enough detail that implementation requires no invention.
+\`\`\`
+
+<add one block per file; do not collapse multiple files into a directory or vague layer>
+
+${sharedContractsHeading}
+<list cross-file interfaces, component/data contracts, state boundaries, or write exactly \`Not Applicable.\` when genuinely inapplicable>
+
+### Interfaces & types
+\`\`\`typescript
+// Shared props, state, events, query shapes, or accessibility contracts.
+\`\`\`
+
+### Reference snippets
+\`\`\`tsx
+// Canonical component imports, hook usage, keyboard wiring, or layout examples.
+\`\`\`
+
+## Requirements (acceptance criteria)
+- <one concrete, verifiable requirement per bullet; include exact states, interactions, semantics, classes/tokens, and responsive behavior>
+- Include UI, integration, and accessibility test coverage for the design's risk areas.
+- Verify the implemented user-facing entry point end-to-end; unit tests alone are insufficient.
+
+## What to avoid
+- Do not implement code or edit files as the UI/UX engineer; this handoff is advisory only.
+- Do not present alternative designs, generic advice, or requirements without concrete evidence and file-level consequences.
+- Do not invent components, props, tokens, keyboard behavior, or source-of-truth locations when existing repository patterns apply.
+- <explicit task-specific anti-patterns, scope boundaries, and destructive-action/source-of-truth pitfalls>
+
+## Skills to activate
+- <relevant repository skills and why they apply, or write exactly \`Not Applicable.\` when none apply>
+
+## Out of scope
+- <explicit files, flows, behavior, or migration work the implementer must not touch>
+
+## Handoff
+Run the normal handoff command to the configured entry point with this complete design, then stop.${placeholderInstruction}
+
+\`\`\`bash
+${handoffCommand({
+    chatroomId: "<chatroom-id>",
+    role: "uiux-engineer",
+    nextRole: entryPoint,
+    cliEnvPrefix: ""
+  })}
+\`\`\``;
+}
+var init_uiux_engineer_handoff_templates = __esm(() => {
+  init_command2();
+});
+
+// ../../services/backend/prompts/teams/duo/handoff-templates/architect.ts
+var duoArchitectHandoffContract;
+var init_architect = __esm(() => {
+  init_architect_handoff_templates();
+  duoArchitectHandoffContract = {
+    role: "architect",
+    receivesFrom: ["planner"],
+    returnsTo: ["planner"],
+    outboundTemplates: {
+      planner: () => getArchitectToEntryPointHandoffTemplate("planner")
+    }
+  };
+});
+
 // ../../services/backend/prompts/utils/code-change-verification.ts
 var CODE_CHANGE_VERIFICATION_CONFIRMATION = "- [ ] I confirm that I have run typecheck and tests for the project (only required if code changes were made)";
 
@@ -107211,15 +107521,6 @@ ${getDelegationBriefDisclosureComment()}`;
 }
 var DELEGATION_BRIEF_DISCLOSURE_CHECKBOX = "- [ ] I confirm the delegation brief is fully met: all (Required) files done, verified end-to-end, acceptance criteria pass";
 
-// ../../services/backend/prompts/utils/file-reference-guidance.ts
-function getFileReferenceGuidanceComment() {
-  return `<!-- File references (clickable in workspace UI): use repo-relative paths with a file extension — e.g. \`apps/webapp/src/modules/chatroom/foo.ts\` or [apps/webapp/src/foo.ts](apps/webapp/src/foo.ts). Avoid absolute paths, file:// prefixes, and paths without / or extension. -->`;
-}
-function getFileReferenceProofOfCompletionExample() {
-  return `${getFileReferenceGuidanceComment()}
-- \`apps/webapp/src/path/to/file.ts\` — <what changed and why>`;
-}
-
 // ../../services/backend/prompts/utils/handoff-section-guidance.ts
 function getHandoffNotApplicableSectionComment(context5) {
   return `<!-- REQUIRED. ${context5}, or write exactly "${HANDOFF_NOT_APPLICABLE_EXACT_TEXT}" with no explanation. Do not omit this section. -->`;
@@ -107360,217 +107661,6 @@ var init_builder = __esm(() => {
   };
 });
 
-// ../../services/backend/src/domain/usecase/enhancer/enhancer-handoff-content.ts
-var ENHANCER_USER_MESSAGE_PLACEHOLDER = "{{USER_MESSAGE}}";
-
-// ../../services/backend/prompts/utils/data-query-design.ts
-function getDataQueryDesignTemplateBlock() {
-  return `## Persistent state and query pattern design
-
-**Goal:** Small updates must not cause large cache invalidations. High-frequency writes use projections to smaller tables.
-
-### 1. Sources of concern
-| Source | Write frequency | Read pattern | Risk |
-|--------|---------------|--------------|------|
-| \`<table/mutation>\` | \`<frequency>\` | \`<pattern>\` | \`<scan / hot partition>\` |
-
-### 2. Schema design
-**Hot path:** \`<table>\` — fields, projection from \`<source>\`
-**Cold path:** \`<table>\` — …
-
-\`\`\`typescript
-// target schema shape
-\`\`\`
-
-### 3. Index design (within limits)
-| Table | Index | Serves query | Budget |
-|-------|-------|--------------|--------|
-
-### 4. Query design (within limits)
-| Query | Index | Rows scanned | Timeout | Invalidation scope |
-|-------|-------|--------------|---------|-------------------|
-
-\`\`\`typescript
-// target query signature
-\`\`\`
-
-<!-- Write exactly "Not Applicable." for the entire section if no persistence changes -->`;
-}
-
-// ../../services/backend/prompts/utils/frontend-design-ux-checklist.ts
-function getFrontendDesignUxPlanningPrinciplesBlock() {
-  return `<!-- Ground every flow in user history and repository patterns. Recommend one existing pattern when multiple exist; do not prescribe style choices the project has not adopted. -->`;
-}
-function getFrontendDesignUxFlowChecklistBlock() {
-  return `**UX quality (complete for every interactive step in this flow):**
-- **States:** loading | empty | error | success — no blank panels, silent failures, or missing retry affordances
-- **Layout:** stable across async transitions — no layout shift when content arrives or state changes
-- **Patterns:** consistent with existing project components — cite the chosen pattern and repo-relative file
-- **Shortcuts:** aligned with project keyboard/shortcut conventions; document tab order and gaps
-- **Feedback:** timely response for async user actions
-- **Interaction affordance:** pointer cursor (or project equivalent) on clickable elements
-- **Safeguards:** confirmation before destructive actions; bulk operations confirmed with scope summary`;
-}
-function getFrontendDesignUxTriggerDescription() {
-  return "when the user request involves user interface changes";
-}
-
-// ../../services/backend/prompts/utils/enhancer-feedback-template-body.ts
-function getEnhancerFeedbackTemplateBody() {
-  return `<handoff-overview>
-## Summary
-<one paragraph: what we're building and the single design direction>
-
-## User intent and constraints
-<explicit requirements from user messages; hard constraints that must not be violated>
-</handoff-overview>
-
-<!-- UI collapses proofs, direction, frontend design, data design, and notes by default; overview and action required are expanded -->
-
-<handoff-proofs>
-## Repository evidence
-<files read, current behavior verified, patterns reused — cite repo-relative paths and short snippets only>
-
-${getHandoffQualityPrinciplesSectionBlock("design")}
-</handoff-proofs>
-
-<handoff-direction>
-## Recommended design
-<!-- ONE design only. No Option A/B/C. -->
-
-<2–4 sentences: the chosen architecture and why it fits the request and existing system>
-</handoff-direction>
-
-<handoff-frontend-design>
-## Frontend / user-centric design
-
-${getFrontendDesignUxPlanningPrinciplesBlock()}
-
-### Flow 1: <name>
-**Entry:** User visits \`<route/page>\` from \`<source>\`.
-
-| Step | User action | System response | UI state |
-|------|-------------|-----------------|----------|
-| 1 | User clicks \`<element label>\` | \`<navigation / modal / fetch>\` | \`<loading → success/error>\` |
-
-${getFrontendDesignUxFlowChecklistBlock()}
-
-**Expected interactions per element:**
-- \`<ElementName>\` (\`apps/webapp/src/...\`): click → \`<handler>\`; keyboard: \`<tab order>\`; disabled when \`<condition>\`
-
-### Element, style, and layout specification
-
-#### \`<ComponentName>\` — \`apps/webapp/src/path/to/Component.tsx\`
-**Change:** <create | modify>
-
-**Layout:** \`<div className="...">\` — flex/grid, gaps, breakpoints
-
-**States:** loading | empty | error | success
-
-\`\`\`tsx
-export function ComponentName({ ... }: Props) {
-  // target structure — props, classNames, branches
-}
-\`\`\`
-
-<!-- Repeat per component; write exactly "Not Applicable." for the entire section if no UI -->
-</handoff-frontend-design>
-
-<handoff-data-design>
-${getDataQueryDesignTemplateBlock()}
-</handoff-data-design>
-
-<handoff-notes>
-## Open questions for user
-<decisions only the user can make, or write "Not Applicable.">
-</handoff-notes>
-
-<handoff-action>
-## Recommended implementation sequence
-<!-- Ordered slices for the planner — references files from design sections. For large or multi-surface revisions, activate the defragmentation skill before delegating. -->
-
-1. …
-2. …
-
-## Files touched (index)
-- \`apps/webapp/src/...\` — …
-- \`services/backend/convex/...\` — …
-</handoff-action>`;
-}
-var init_enhancer_feedback_template_body = __esm(() => {
-  init_handoff_quality_principles();
-});
-
-// ../../services/backend/prompts/enhancer/handoff-templates.ts
-function roleLabel(role) {
-  return role.charAt(0).toUpperCase() + role.slice(1).toLowerCase();
-}
-function getEntryPointToEnhancerHandoffTemplate(entryPointRole) {
-  const label = roleLabel(entryPointRole);
-  return `**Planning Request (${label} → Enhancer)** — after reading the user message and any pinned chatroom context, fill only <additional-context> below. The system injects the user message automatically — do not copy it.
-
-\`\`\`markdown
-<user-message>
-<!-- Injected automatically from the originating user message — do not edit or copy the user message here -->
-${ENHANCER_USER_MESSAGE_PLACEHOLDER}
-</user-message>
-
-<additional-context>
-## Goal
-<what the user wants in plain language — one short paragraph>
-</additional-context>
-\`\`\`
-
-After handoff succeeds, **end your turn immediately**. The enhancer independently downloads the originating message history and returns design input as your next ${entryPointRole.toLowerCase()} task.`;
-}
-function getEnhancerToEntryPointHandoffTemplate(entryPointRole) {
-  const normalizedRole = entryPointRole.toLowerCase();
-  const label = roleLabel(entryPointRole);
-  return `**Design Input (Enhancer → ${label})**
-
-You are the design authority for this request. Recover conversation history, inspect the repository, and return **one** complete design — not options. The ${normalizedRole} agent verifies your design and delegates implementation.
-
-**Rules:**
-- Design first — complete frontend and data/query sections before implementation sequencing.
-- **No alternative approaches** — one \`Recommended design\` only.
-- Frontend and data sections: code granularity (component names, props, classes, file paths, schema, indexes, queries).
-- Complete per-flow **UX quality** checklist in frontend design — states, layout stability, patterns, safeguards.
-- For large or multi-surface revisions, note in implementation sequence that the entry point should activate the \`defragmentation\` skill.
-- In \`<handoff-proofs>\`, complete **Proof of Principles** for how this design satisfies each quality principle (or "Not Applicable.").
-- Write "Not Applicable." only when a major design section truly does not apply.
-
-\`\`\`markdown
-${getEnhancerFeedbackTemplateBody()}
-\`\`\`
-
-Return only the design input markdown — no preamble. Follow this structure; use "Not Applicable." where a major section does not apply.`;
-}
-var init_handoff_templates = __esm(() => {
-  init_enhancer_feedback_template_body();
-});
-
-// ../../services/backend/prompts/teams/duo/handoff-templates/enhancer-to-planner.ts
-function getEnhancerToPlannerHandoffTemplate() {
-  return getEnhancerToEntryPointHandoffTemplate("planner");
-}
-var init_enhancer_to_planner = __esm(() => {
-  init_handoff_templates();
-});
-
-// ../../services/backend/prompts/teams/duo/handoff-templates/enhancer.ts
-var duoEnhancerHandoffContract;
-var init_enhancer = __esm(() => {
-  init_enhancer_to_planner();
-  duoEnhancerHandoffContract = {
-    role: "enhancer",
-    receivesFrom: ["planner"],
-    returnsTo: ["planner"],
-    outboundTemplates: {
-      planner: () => getEnhancerToPlannerHandoffTemplate()
-    }
-  };
-});
-
 // ../../services/backend/prompts/teams/duo/handoff-templates/planner-to-builder.ts
 function getPlannerToBuilderHandoffTemplate() {
   return `${getHandoffRecipientVisibilityCallout("builder")}
@@ -107647,14 +107737,6 @@ Keep one slice ≈ one focused review surface. Delegate slices incrementally —
 }
 var init_planner_to_builder = () => {};
 
-// ../../services/backend/prompts/teams/duo/handoff-templates/planner-to-enhancer.ts
-function getPlannerToEnhancerHandoffTemplate() {
-  return getEntryPointToEnhancerHandoffTemplate("planner");
-}
-var init_planner_to_enhancer = __esm(() => {
-  init_handoff_templates();
-});
-
 // ../../services/backend/prompts/utils/context-disclosure.ts
 function getContextReadDisclosureComment(params = {}) {
   const command = contextReadCommand(params);
@@ -107842,16 +107924,18 @@ var init_chat_handoff_template = () => {};
 var duoPlannerHandoffContract;
 var init_planner = __esm(() => {
   init_planner_to_builder();
-  init_planner_to_enhancer();
   init_planner_to_user();
   init_chat_handoff_template();
+  init_architect_handoff_templates();
+  init_uiux_engineer_handoff_templates();
   duoPlannerHandoffContract = {
     role: "planner",
-    receivesFrom: ["user", "builder", "enhancer"],
-    returnsTo: ["builder", "enhancer", "user"],
+    receivesFrom: ["user", "builder", "architect", "uiux-engineer"],
+    returnsTo: ["builder", "architect", "uiux-engineer", "user"],
     outboundTemplates: {
       builder: () => getPlannerToBuilderHandoffTemplate(),
-      enhancer: () => getPlannerToEnhancerHandoffTemplate(),
+      architect: () => getEntryPointToArchitectHandoffTemplate("planner"),
+      "uiux-engineer": () => getEntryPointToUiuxEngineerHandoffTemplate("planner"),
       user: (query) => query.conversationMode === "chat" ? getChatToUserHandoffTemplate() : getPlannerToUserReportTemplate({
         chatroomId: query.chatroomId,
         role: query.role,
@@ -107861,6 +107945,20 @@ var init_planner = __esm(() => {
   };
 });
 
+// ../../services/backend/prompts/teams/duo/handoff-templates/uiux-engineer.ts
+var duoUiuxEngineerHandoffContract;
+var init_uiux_engineer = __esm(() => {
+  init_uiux_engineer_handoff_templates();
+  duoUiuxEngineerHandoffContract = {
+    role: "uiux-engineer",
+    receivesFrom: ["planner"],
+    returnsTo: ["planner"],
+    outboundTemplates: {
+      planner: () => getUiuxEngineerToEntryPointHandoffTemplate("planner")
+    }
+  };
+});
+
 // ../../services/backend/prompts/cli/handoff-templates/contracts.ts
 function validateRoleHandoffContracts(contracts) {
   const byRole = new Map;
@@ -107901,14 +107999,16 @@ function getDuoHandoffTemplate(query) {
   return getter?.(query) ?? null;
 }
 var DUO_ROLE_HANDOFF_CONTRACTS, validatedDuoRoleHandoffContracts;
-var init_handoff_templates2 = __esm(() => {
+var init_handoff_templates = __esm(() => {
+  init_architect();
   init_builder();
-  init_enhancer();
   init_planner();
+  init_uiux_engineer();
   DUO_ROLE_HANDOFF_CONTRACTS = [
     duoPlannerHandoffContract,
     duoBuilderHandoffContract,
-    duoEnhancerHandoffContract
+    duoArchitectHandoffContract,
+    duoUiuxEngineerHandoffContract
   ];
   validatedDuoRoleHandoffContracts = (() => {
     validateRoleHandoffContracts(DUO_ROLE_HANDOFF_CONTRACTS);
@@ -107916,16 +108016,16 @@ var init_handoff_templates2 = __esm(() => {
   })();
 });
 
-// ../../services/backend/prompts/teams/solo/handoff-templates/enhancer.ts
-var soloEnhancerHandoffContract;
-var init_enhancer2 = __esm(() => {
-  init_handoff_templates();
-  soloEnhancerHandoffContract = {
-    role: "enhancer",
+// ../../services/backend/prompts/teams/solo/handoff-templates/architect.ts
+var soloArchitectHandoffContract;
+var init_architect2 = __esm(() => {
+  init_architect_handoff_templates();
+  soloArchitectHandoffContract = {
+    role: "architect",
     receivesFrom: ["solo"],
     returnsTo: ["solo"],
     outboundTemplates: {
-      solo: () => getEnhancerToEntryPointHandoffTemplate("solo")
+      solo: () => getArchitectToEntryPointHandoffTemplate("solo")
     }
   };
 });
@@ -107948,14 +108048,16 @@ var init_solo_to_user = __esm(() => {
 var soloHandoffContract;
 var init_solo = __esm(() => {
   init_solo_to_user();
-  init_handoff_templates();
   init_chat_handoff_template();
+  init_architect_handoff_templates();
+  init_uiux_engineer_handoff_templates();
   soloHandoffContract = {
     role: "solo",
-    receivesFrom: ["user", "enhancer"],
-    returnsTo: ["user", "enhancer"],
+    receivesFrom: ["user", "architect", "uiux-engineer"],
+    returnsTo: ["architect", "uiux-engineer", "user"],
     outboundTemplates: {
-      enhancer: () => getEntryPointToEnhancerHandoffTemplate("solo"),
+      architect: () => getEntryPointToArchitectHandoffTemplate("solo"),
+      "uiux-engineer": () => getEntryPointToUiuxEngineerHandoffTemplate("solo"),
       user: (query) => query.conversationMode === "chat" ? getChatToUserHandoffTemplate() : getSoloToUserReportTemplate({
         chatroomId: query.chatroomId,
         role: query.role,
@@ -107965,6 +108067,20 @@ var init_solo = __esm(() => {
   };
 });
 
+// ../../services/backend/prompts/teams/solo/handoff-templates/uiux-engineer.ts
+var soloUiuxEngineerHandoffContract;
+var init_uiux_engineer2 = __esm(() => {
+  init_uiux_engineer_handoff_templates();
+  soloUiuxEngineerHandoffContract = {
+    role: "uiux-engineer",
+    receivesFrom: ["solo"],
+    returnsTo: ["solo"],
+    outboundTemplates: {
+      solo: () => getUiuxEngineerToEntryPointHandoffTemplate("solo")
+    }
+  };
+});
+
 // ../../services/backend/prompts/teams/solo/handoff-templates/index.ts
 function listSoloRoleHandoffContracts() {
   return validatedSoloRoleHandoffContracts;
@@ -107977,12 +108093,14 @@ function getSoloHandoffTemplate(query) {
   return getter?.(query) ?? null;
 }
 var SOLO_ROLE_HANDOFF_CONTRACTS, validatedSoloRoleHandoffContracts;
-var init_handoff_templates3 = __esm(() => {
-  init_enhancer2();
+var init_handoff_templates2 = __esm(() => {
+  init_architect2();
   init_solo();
+  init_uiux_engineer2();
   SOLO_ROLE_HANDOFF_CONTRACTS = [
     soloHandoffContract,
-    soloEnhancerHandoffContract
+    soloArchitectHandoffContract,
+    soloUiuxEngineerHandoffContract
   ];
   validatedSoloRoleHandoffContracts = (() => {
     validateRoleHandoffContracts(SOLO_ROLE_HANDOFF_CONTRACTS);
@@ -108040,13 +108158,21 @@ function getHandoffTemplate(query) {
     return getSoloHandoffTemplate(query);
   return null;
 }
-var init_handoff_templates4 = __esm(() => {
+var init_handoff_templates3 = __esm(() => {
+  init_handoff_templates();
   init_handoff_templates2();
-  init_handoff_templates3();
 });
 
 // ../../services/backend/prompts/cli/handoff/view-template.ts
 function viewHandoffTemplate(params) {
+  if (params.nextRole === undefined) {
+    const role = params.role.trim().toLowerCase();
+    if (role === "architect")
+      return getGenericArchitectToEntryPointHandoffTemplate();
+    if (role === "uiux-engineer")
+      return getGenericUiuxEngineerToEntryPointHandoffTemplate();
+    throw new Error(`Role-only handoff template viewing is supported only for architect or uiux-engineer, not ${params.role}`);
+  }
   const template = getHandoffTemplate({
     fromRole: params.role,
     toRole: params.nextRole,
@@ -108059,7 +108185,9 @@ function viewHandoffTemplate(params) {
   return template;
 }
 var init_view_template2 = __esm(() => {
-  init_handoff_templates4();
+  init_architect_handoff_templates();
+  init_uiux_engineer_handoff_templates();
+  init_handoff_templates3();
 });
 
 // src/commands/handoff/view-template.ts
@@ -108104,12 +108232,12 @@ function listHandoffTemplatesCommand(params) {
   });
   if (!listing) {
     const teamId = params.teamId ?? "duo";
-    throw new Error(`No handoff contract for role "${params.role}" in team "${teamId}". Known roles: planner, builder, enhancer (duo) or solo, enhancer (solo).`);
+    throw new Error(`No handoff contract for role "${params.role}" in team "${teamId}". Known roles: planner, builder (duo) or solo.`);
   }
   return formatHandoffTemplateListing(listing);
 }
 var init_list_templates = __esm(() => {
-  init_handoff_templates4();
+  init_handoff_templates3();
 });
 
 // src/commands/handoff/list-templates.ts
@@ -108276,30 +108404,43 @@ function formatDecodeError(error51) {
   return message;
 }
 
-// ../../services/backend/prompts/config/agent-general-knowledge.ts
-var init_agent_general_knowledge = () => {};
+// ../../services/backend/prompts/native/session-continuity.ts
+function getNativeHandoffTurnEndGuidance(nextRole) {
+  return getHandoffTurnEndGuidance(nextRole);
+}
+function getHandoffTurnEndGuidance(nextRole) {
+  const lines = [
+    "",
+    "**Handoff complete. End your turn now — stop tool calls. The system will send you a message when further action is required.**"
+  ];
+  if (nextRole.toLowerCase() === "user") {
+    lines.push("The system delivers the next chatroom task when the user sends one.");
+  } else {
+    lines.push(`The system delivers \`${nextRole}\`'s handback when they finish — do not poll \`messages download\` while waiting. For history reconstruction tasks, \`messages download\` is the correct tool.`);
+  }
+  return lines.join(`
+`);
+}
 // ../../services/backend/prompts/sections/activated-skills.ts
 var init_activated_skills = () => {};
 
 // ../../services/backend/prompts/cli/backlog/command.ts
-var init_command2 = __esm(() => {
+var init_command3 = __esm(() => {
   init_stdin_heredoc();
 });
 
 // ../../services/backend/src/domain/usecase/skills/modules/backlog/index.ts
 var init_backlog = __esm(() => {
-  init_command2();
+  init_command3();
 });
 
 // ../../services/backend/src/domain/usecase/skills/modules/code-review/index.ts
 var init_code_review = () => {};
-
 // ../../services/backend/src/domain/usecase/skills/modules/data-design/index.ts
 var init_data_design = () => {};
 
 // ../../services/backend/src/domain/usecase/skills/modules/defragmentation/index.ts
 var init_defragmentation = () => {};
-
 // ../../services/backend/src/domain/usecase/skills/modules/user-centricity/index.ts
 var init_user_centricity = () => {};
 
@@ -108388,87 +108529,17 @@ var init_general_knowledge = __esm(() => {
   init_utils3();
 });
 
-// ../../services/backend/prompts/enhancer/system-prompt.ts
-var ENHANCER_ROLE_CONTRACT_LINES;
-var init_system_prompt = __esm(() => {
-  init_stdin_heredoc();
-  init_agent_general_knowledge();
-  init_general_knowledge();
-  ENHANCER_ROLE_CONTRACT_LINES = [
-    "You are a single-turn, memoryless **design advisor**. Produce a high-intelligence first design for the user request; you are not an implementer.",
-    "",
-    "## Your role",
-    "- Recover the authoritative user request and relevant history before analysis.",
-    "- Inspect the repository and closely related files to understand existing patterns, constraints, and likely change surfaces.",
-    "- Return **one** complete recommended design — not multiple options. The entry point verifies and delegates.",
-    "- Complete frontend and data/query design sections at code granularity before implementation sequencing.",
-    "- Use <additional-context> from the forwarded request as the entry point's goal; verify against downloaded history and repository evidence.",
-    "- <user-message> is authoritative for what the user said; do not treat <additional-context> as a substitute.",
-    "- Give concrete, evidence-backed design input with repo-relative file references and targeted code snippets when useful.",
-    "- In <handoff-proofs>, complete **Proof of Principles** for how this design satisfies each quality principle.",
-    "- Keep the user request as the north star. Tighten within its scope; do not invent requirements.",
-    "- Your output becomes the first planning input to the stateful team entry point, which owns persistent memory, the ongoing plan, and execution.",
-    "",
-    `## Frontend design (${getFrontendDesignUxTriggerDescription()})`,
-    "- Complete <handoff-frontend-design> with flows, per-flow UX quality checklist, component specs, and layout at code granularity.",
-    "- Ground patterns in repository evidence — cite existing components; recommend one when multiple exist.",
-    '- Write "Not Applicable." for the entire section when no UI changes are involved.',
-    "",
-    "## Large or multi-surface revisions",
-    "- When the request involves refactoring, consolidation, or consistency across many surfaces, note in implementation sequence that the entry point should run `chatroom skill activate defragmentation` before delegating slices.",
-    "",
-    "## Data and query design (when persistence or query patterns change)",
-    "- Complete <handoff-data-design> with schema, indexes, and query patterns within project limits.",
-    '- Write "Not Applicable." for the entire section when no persistence changes are involved.',
-    "",
-    "## What you must NOT do",
-    "- Do NOT implement changes, spawn subagents, or expand scope.",
-    "- Do NOT propose multiple alternative approaches — one recommended design only.",
-    "- Do NOT produce generic advice. Tie findings to user messages, repository evidence, and named files.",
-    "- Do NOT treat <forwarded-request> as the only source of context; download message history first.",
-    "- Output must match <output-template>. **Recommended implementation sequence** and **Files touched** are the last sections."
-  ];
-});
-
-// ../../services/backend/prompts/native/session-continuity.ts
-function getNativeHandoffTurnEndGuidance(nextRole) {
-  return getHandoffTurnEndGuidance(nextRole);
-}
-function getHandoffTurnEndGuidance(nextRole) {
-  const lines = [
-    "",
-    "**Handoff complete. End your turn now — stop tool calls. The system will send you a message when further action is required.**"
-  ];
-  if (nextRole.toLowerCase() === "user") {
-    lines.push("The system delivers the next chatroom task when the user sends one.");
-  } else {
-    lines.push(`The system delivers \`${nextRole}\`'s handback when they finish — do not poll \`messages download\` while waiting. For history reconstruction tasks, \`messages download\` is the correct tool.`);
-  }
-  return lines.join(`
-`);
-}
-function getNativeEnhancerRequestTurnEndGuidance() {
-  return [
-    "",
-    "**Handoff complete. End your turn now — stop tool calls. The system will send you a message when further action is required.**",
-    "Do **not** wait for enhancer input, poll, or monitor the enhancer job in this turn. The system delivers independent planning input as your next task when analysis completes."
-  ].join(`
-`);
-}
-
-// ../../services/backend/prompts/cli/handoff/command.ts
-var init_command3 = __esm(() => {
-  init_stdin_heredoc();
-});
-
 // ../../services/backend/prompts/sections/commands-reference.ts
 var init_commands_reference = __esm(() => {
   init_general_knowledge();
   init_command();
   init_reminder();
-  init_command3();
+  init_command2();
   init_utils3();
 });
+
+// ../../services/backend/prompts/cli/roles/architect.ts
+var init_architect3 = () => {};
 // ../../services/backend/prompts/cli/sections/core-responsibilities.ts
 var init_core_responsibilities = () => {};
 // ../../services/backend/prompts/cli/sections/handoff-rules.ts
@@ -108498,6 +108569,9 @@ var init_planner2 = __esm(() => {
   init_sections();
 });
 
+// ../../services/backend/prompts/cli/roles/uiux-engineer.ts
+var init_uiux_engineer3 = () => {};
+
 // ../../services/backend/prompts/cli/roles/planner-guidance-context.ts
 var init_planner_guidance_context = __esm(() => {
   init_env();
@@ -108516,11 +108590,11 @@ var init_fromContext = __esm(() => {
 
 // ../../services/backend/prompts/cli/roles/fromContext.ts
 var init_fromContext2 = __esm(() => {
+  init_architect3();
   init_builder2();
   init_planner2();
-  init_system_prompt();
+  init_uiux_engineer3();
   init_fromContext();
-  init_utils3();
 });
 
 // ../../services/backend/prompts/teams/duo/prompts/builder.ts
@@ -108552,7 +108626,9 @@ var init_role_guidance = __esm(() => {
 });
 
 // ../../services/backend/prompts/templates.ts
-var init_templates = () => {};
+var init_templates = __esm(() => {
+  init_agent_role();
+});
 
 // ../../services/backend/prompts/sections/role-identity.ts
 var init_role_identity = __esm(() => {
@@ -108560,14 +108636,12 @@ var init_role_identity = __esm(() => {
 });
 
 // ../../services/backend/prompts/native/system-prompt.ts
-var init_system_prompt2 = __esm(() => {
-  init_system_prompt();
+var init_system_prompt = __esm(() => {
   init_commands_reference();
   init_general_knowledge();
   init_role_guidance();
   init_role_identity();
   init_selector_context();
-  init_utils3();
 });
 
 // ../../services/backend/prompts/native/task-started-content.ts
@@ -108601,40 +108675,12 @@ var init_session_vs_chatroom_task = () => {};
 // ../../services/backend/prompts/review-guidelines/index.ts
 var init_review_guidelines = () => {};
 // ../../services/backend/prompts/generator.ts
-function isEnhancerRequestQueuedHandoff(params) {
-  return params.enhancerRequestQueued === true && params.nextRole.toLowerCase() === "enhancer";
-}
-function getEnhancerRequestQueuedConfirmationLines(nativeIntegration) {
-  const turnEndRule = nativeIntegration ? "**Handoff complete. End your turn now — stop tool calls. The system will send you a message when further action is required.** Do **not** wait for enhancer input, poll, monitor the enhancer, or re-submit the handoff. The system delivers independent planning input as your next task when analysis completes." : "**Run get-next-task now and end your turn — stop tool calls. The system will send you a message when further action is required.** Do **not** wait for enhancer input, poll, monitor the enhancer, or re-submit the handoff.";
-  return [
-    "✅ User request queued for handoff enhancer",
-    "",
-    "The user request was sent to the handoff enhancer (async). You will receive independent planning input as your next task when analysis completes.",
-    turnEndRule
-  ];
-}
 function generateHandoffOutput(params) {
-  const {
-    role,
-    nextRole,
-    chatroomId,
-    convexUrl,
-    supportsNativeIntegration,
-    enhancerRequestQueued
-  } = params;
+  const { role, nextRole, chatroomId, convexUrl, supportsNativeIntegration } = params;
   const cliEnvPrefix = getCliEnvPrefix(convexUrl);
-  const enhancerRequest = isEnhancerRequestQueuedHandoff({
-    nextRole,
-    enhancerRequestQueued
-  });
-  const lines = [];
-  if (enhancerRequest) {
-    lines.push(...getEnhancerRequestQueuedConfirmationLines(supportsNativeIntegration));
-  } else {
-    lines.push(`✅ Chatroom task completed and handed off to ${nextRole}`);
-  }
+  const lines = [`✅ Chatroom task completed and handed off to ${nextRole}`];
   if (supportsNativeIntegration) {
-    lines.push(enhancerRequest ? getNativeEnhancerRequestTurnEndGuidance() : getNativeHandoffTurnEndGuidance(nextRole));
+    lines.push(getNativeHandoffTurnEndGuidance(nextRole));
   } else {
     lines.push("");
     lines.push("✅ Level B complete (chatroom task handed off).");
@@ -108650,7 +108696,6 @@ var init_generator = __esm(() => {
   init_command();
   init_reminder();
   init_system_prompt();
-  init_system_prompt2();
   init_classification_guide();
   init_commands_reference();
   init_general_knowledge();
@@ -108812,8 +108857,7 @@ var handoffEffect = (chatroomId, options) => exports_Effect.gen(function* () {
       nextRole,
       chatroomId,
       convexUrl,
-      supportsNativeIntegration: result.supportsNativeIntegration,
-      enhancerRequestQueued: result.enhancerRequestQueued === true
+      supportsNativeIntegration: result.supportsNativeIntegration
     }));
   });
 });
@@ -118412,7 +118456,7 @@ async function runRestartOrchestrator(deps, event) {
         agentHarness: event.agentHarness,
         model: event.model,
         workingDir: event.workingDir,
-        reason: "user.restart",
+        reason: AgentStartReasonCode.USER_RESTART,
         wantResume: event.wantResume
       }, context5.signal);
     });
@@ -118426,7 +118470,7 @@ async function runRestartOrchestrator(deps, event) {
       await deps.runSerializedForAgent({ chatroomId, role, workingDir: event.workingDir }, { timeoutMs: HARNESS_SESSION_READY_TIMEOUT_MS }, (ops, context5) => ops.stopAgent({
         chatroomId,
         role,
-        reason: "user.restart",
+        reason: AgentStartReasonCode.USER_RESTART,
         pid: spawnResult.pid,
         workingDir: event.workingDir
       }, context5.signal));
@@ -118457,6 +118501,7 @@ async function runRestartOrchestrator(deps, event) {
 }
 var init_restart_orchestrator = __esm(() => {
   init_reliability();
+  init_agent();
   init_build_agent_restart_event();
   init_restart_orchestrator_in_flight();
   init_api3();
@@ -135583,10 +135628,10 @@ teamCommand.command("set").description("Set the team preset for a chatroom").req
   const { setTeam: setTeam2 } = await Promise.resolve().then(() => (init_team(), exports_team));
   await setTeam2(options.chatroomId, options.team);
 });
-handoffCommandGroup.command("view-template").description("Print the handoff message template for a role pair").option("--team-id <teamId>", "Team id (solo, duo); defaults to duo").action(async function(options) {
+handoffCommandGroup.command("view-template").description("Print a handoff message template; omit --next-role to inspect a generic architect or UI/UX engineer template").option("--team-id <teamId>", "Team id (solo, duo); defaults to duo").action(async function(options) {
   const parentOpts = this.parent?.opts() ?? {};
-  if (!parentOpts.role || !parentOpts.nextRole) {
-    console.error(parentOpts.role ? `error: required option '--next-role <nextRole>' not specified` : `error: required option '--role <role>' not specified`);
+  if (!parentOpts.role) {
+    console.error(`error: required option '--role <role>' not specified`);
     process.exit(1);
   }
   const { printHandoffViewTemplate: printHandoffViewTemplate2 } = await Promise.resolve().then(() => (init_view_template3(), exports_view_template));
@@ -136030,4 +136075,4 @@ program2.hook("preAction", async (_thisCommand, actionCommand) => {
 });
 program2.parse();
 
-//# debugId=CB5CA35B81D3EFBC64756E2164756E21
+//# debugId=318DFD58C705B11264756E2164756E21