@h-rig/cli 0.0.6-alpha.87 → 0.0.6-alpha.89

package/dist/bin/rig.js

@@ -338,7 +338,8 @@ __export(exports__connection_state, {
   resolveGlobalConnectionsPath: () => resolveGlobalConnectionsPath,
   readRepoConnection: () => readRepoConnection,
   readGlobalConnections: () => readGlobalConnections,
-  isRemoteConnectionSelected: () => isRemoteConnectionSelected
+  isRemoteConnectionSelected: () => isRemoteConnectionSelected,
+  clearRepoServerProjectRoot: () => clearRepoServerProjectRoot
 });
 import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
@@ -422,12 +423,28 @@ function readRepoConnection(projectRoot) {
     selected,
     project: typeof record.project === "string" ? record.project : undefined,
     linkedAt: typeof record.linkedAt === "string" ? record.linkedAt : undefined,
-    serverProjectRoot: typeof record.serverProjectRoot === "string" && record.serverProjectRoot.trim() ? record.serverProjectRoot.trim() : undefined
+    serverProjectRoot: typeof record.serverProjectRoot === "string" && record.serverProjectRoot.trim() ? record.serverProjectRoot.trim() : undefined,
+    serverProjectRootAlias: typeof record.serverProjectRootAlias === "string" && record.serverProjectRootAlias.trim() ? record.serverProjectRootAlias.trim() : undefined,
+    serverProjectRootBaseUrl: typeof record.serverProjectRootBaseUrl === "string" && record.serverProjectRootBaseUrl.trim() ? record.serverProjectRootBaseUrl.trim().replace(/\/+$/, "") : undefined
   };
 }
 function writeRepoConnection(projectRoot, state) {
   writeJsonFile(resolveRepoConnectionPath(projectRoot), state);
 }
+function rootAllowedForSelection(repo, connection) {
+  const root = repo.serverProjectRoot?.trim();
+  if (!root)
+    return;
+  if (connection.kind === "remote") {
+    if (repo.serverProjectRootAlias !== repo.selected)
+      return;
+    if (repo.serverProjectRootBaseUrl !== connection.baseUrl)
+      return;
+  } else if (repo.serverProjectRootAlias && repo.serverProjectRootAlias !== repo.selected) {
+    return;
+  }
+  return root;
+}
 function resolveSelectedConnection(projectRoot, options = {}) {
   const repo = readRepoConnection(projectRoot);
   if (!repo)
@@ -439,13 +456,41 @@ function resolveSelectedConnection(projectRoot, options = {}) {
   if (!connection) {
     throw new CliError(`Selected Rig server "${repo.selected}" was not found. Run \`rig server list\` or \`rig server use local\`.`, 1);
   }
-  return { alias: repo.selected, connection, serverProjectRoot: repo.serverProjectRoot };
+  return { alias: repo.selected, connection, serverProjectRoot: rootAllowedForSelection(repo, connection) };
+}
+function writeRepoServerProjectRoot(projectRoot, serverProjectRoot, metadata = {}) {
+  const repo = readRepoConnection(projectRoot);
+  if (!repo)
+    return;
+  let inferred = metadata;
+  if (!inferred.alias || !inferred.baseUrl) {
+    try {
+      const selected = resolveSelectedConnection(projectRoot);
+      if (selected?.connection.kind === "remote") {
+        inferred = {
+          alias: inferred.alias ?? selected.alias,
+          baseUrl: inferred.baseUrl ?? selected.connection.baseUrl
+        };
+      }
+    } catch {}
+  }
+  writeRepoConnection(projectRoot, {
+    ...repo,
+    ...metadata.project ? { project: metadata.project } : {},
+    serverProjectRoot,
+    ...inferred.alias ? { serverProjectRootAlias: inferred.alias } : {},
+    ...inferred.baseUrl ? { serverProjectRootBaseUrl: inferred.baseUrl.replace(/\/+$/, "") } : {}
+  });
 }
-function writeRepoServerProjectRoot(projectRoot, serverProjectRoot) {
+function clearRepoServerProjectRoot(projectRoot) {
   const repo = readRepoConnection(projectRoot);
   if (!repo)
     return;
-  writeRepoConnection(projectRoot, { ...repo, serverProjectRoot });
+  writeRepoConnection(projectRoot, {
+    selected: repo.selected,
+    ...repo.project ? { project: repo.project } : {},
+    ...repo.linkedAt ? { linkedAt: repo.linkedAt } : {}
+  });
 }
 function isRemoteConnectionSelected(projectRoot) {
   return resolveSelectedConnection(projectRoot)?.connection.kind === "remote";
@@ -472,12 +517,16 @@ __export(exports__server_client, {
   respondRunPiExtensionUiViaServer: () => respondRunPiExtensionUiViaServer,
   resolveServerConnectionLabel: () => resolveServerConnectionLabel,
   requestServerJson: () => requestServerJson,
+  repairRemoteProjectRootLink: () => repairRemoteProjectRootLink,
   registerProjectViaServer: () => registerProjectViaServer,
   prepareRemoteCheckoutViaServer: () => prepareRemoteCheckoutViaServer,
   postGitHubTokenViaServer: () => postGitHubTokenViaServer,
+  normalizeRepoSlug: () => normalizeRepoSlug,
   listWorkspaceTasksViaServer: () => listWorkspaceTasksViaServer,
   listRunsViaServer: () => listRunsViaServer,
   listGitHubProjectsViaServer: () => listGitHubProjectsViaServer,
+  isRemoteProjectRootLinkError: () => isRemoteProjectRootLinkError,
+  inspectRemoteProjectLink: () => inspectRemoteProjectLink,
   getWorkspaceTaskViaServer: () => getWorkspaceTaskViaServer,
   getRunTimelineViaServer: () => getRunTimelineViaServer,
   getRunPiStatusViaServer: () => getRunPiStatusViaServer,
@@ -489,13 +538,15 @@ __export(exports__server_client, {
   getRunDetailsViaServer: () => getRunDetailsViaServer,
   getGitHubProjectStatusFieldViaServer: () => getGitHubProjectStatusFieldViaServer,
   getGitHubAuthStatusViaServer: () => getGitHubAuthStatusViaServer,
+  formatRemoteProjectLinkHint: () => formatRemoteProjectLinkHint,
   ensureTaskLabelsViaServer: () => ensureTaskLabelsViaServer,
   ensureServerForCli: () => ensureServerForCli,
+  ensureRemoteProjectRootLink: () => ensureRemoteProjectRootLink,
   buildRunPiEventsWebSocketUrl: () => buildRunPiEventsWebSocketUrl,
   abortRunPiViaServer: () => abortRunPiViaServer
 });
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { resolve as resolve3 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, isAbsolute, resolve as resolve3 } from "path";
 import { ensureLocalRigServerConnection } from "@rig/runtime/local-server";
 function setServerPhaseListener(listener) {
   const previous = serverPhaseListener;
@@ -541,11 +592,10 @@ function readStoredGitHubAuthToken(projectRoot) {
   const parsed = readRemoteAuthState(projectRoot);
   return parsed ? cleanToken(typeof parsed.token === "string" ? parsed.token : undefined) : null;
 }
-function inferRemoteServerProjectRootFromAuthState(projectRoot) {
-  const repo = readRepoConnection(projectRoot);
-  const slug = repo?.project?.trim();
-  if (!slug || !/^[^/]+\/[^/]+$/.test(slug))
+function inferRemoteServerProjectRootCandidateFromAuthState(projectRoot, repoSlug) {
+  if (!/^[^/]+\/[^/]+$/.test(repoSlug))
     return null;
+  const repo = readRepoConnection(projectRoot);
   const auth = readRemoteAuthState(projectRoot);
   const authUpdatedAt = typeof auth?.updatedAt === "string" ? Date.parse(auth.updatedAt) : Number.NaN;
   const repoLinkedAt = typeof repo?.linkedAt === "string" ? Date.parse(repo.linkedAt) : Number.NaN;
@@ -554,25 +604,426 @@ function inferRemoteServerProjectRootFromAuthState(projectRoot) {
   const checkoutBaseDir = typeof auth?.checkoutBaseDir === "string" && auth.checkoutBaseDir.trim() ? auth.checkoutBaseDir.trim() : null;
   if (!checkoutBaseDir)
     return null;
-  const inferred = `${checkoutBaseDir.replace(/\/+$/, "")}/${slug}`;
-  writeRepoServerProjectRoot(projectRoot, inferred);
-  return inferred;
+  return `${checkoutBaseDir.replace(/\/+$/, "")}/${repoSlug}`;
 }
 function readLocalConnectionFallbackToken(projectRoot) {
   return readGitHubBearerTokenForRemote(projectRoot) ?? cleanToken(process.env.RIG_GITHUB_TOKEN) ?? readStoredGitHubAuthToken(projectRoot);
 }
+function normalizeRepoSlug(value) {
+  const slug = value?.trim();
+  return slug && /^[^/\s]+\/[^/\s]+$/.test(slug) ? slug : null;
+}
+function readProjectLinkSlug(projectRoot) {
+  const path = resolve3(projectRoot, ".rig", "state", "project-link.json");
+  if (!existsSync3(path))
+    return null;
+  try {
+    const parsed = JSON.parse(readFileSync2(path, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+      return null;
+    return normalizeRepoSlug(typeof parsed.repoSlug === "string" ? String(parsed.repoSlug) : null);
+  } catch {
+    return null;
+  }
+}
+function writeProjectLinkConnection(projectRoot, repoSlug, alias) {
+  const path = resolve3(projectRoot, ".rig", "state", "project-link.json");
+  mkdirSync3(dirname2(path), { recursive: true });
+  writeFileSync2(path, `${JSON.stringify({ repoSlug, connection: alias, linkedAt: new Date().toISOString() }, null, 2)}
+`, "utf8");
+}
+function remoteLinkRepairCommand(repoSlug) {
+  return repoSlug ? `rig server repair-link --repo ${repoSlug}` : "rig server repair-link --repo owner/repo";
+}
+function isRemoteProjectRootLinkError(error) {
+  const text = error instanceof Error ? error.message : String(error ?? "");
+  return /no server-host project root link|remote project(?:-root)? link|x-rig-project-root|serverProjectRoot/i.test(text);
+}
+function formatRemoteProjectLinkHint(resolution) {
+  const repair = remoteLinkRepairCommand(resolution.repoSlug);
+  if (resolution.status === "auth_required") {
+    return `Authenticate the selected remote${resolution.alias ? ` (${resolution.alias})` : ""}, then run \`${repair}\`. Use \`rig github auth import-gh\` or \`rig init --repair --server remote --github-auth device${resolution.repoSlug ? ` --repo ${resolution.repoSlug}` : ""}\`.`;
+  }
+  if (resolution.status === "missing_project") {
+    return `Record the repo slug, then run \`${repair}\` (or \`rig init --repo owner/repo --server remote --github-auth device\`).`;
+  }
+  if (resolution.status === "not_remote")
+    return "Select a remote server with `rig server use <alias>` before repairing a remote project link.";
+  return `Run \`${repair}\` to backfill or prepare a server-host checkout for the selected remote${resolution.alias ? ` (${resolution.alias})` : ""}.`;
+}
+function remoteProjectLinkFailure(input) {
+  const partial = {
+    status: input.status,
+    alias: input.alias,
+    baseUrl: input.baseUrl,
+    repoSlug: input.repoSlug
+  };
+  return {
+    ok: false,
+    ...input,
+    hint: formatRemoteProjectLinkHint(partial),
+    next: remoteLinkRepairCommand(input.repoSlug)
+  };
+}
+function remoteProjectLinkSuccess(input) {
+  return {
+    ok: true,
+    status: input.status,
+    alias: input.alias,
+    baseUrl: input.baseUrl,
+    repoSlug: input.repoSlug,
+    serverProjectRoot: input.serverProjectRoot,
+    source: input.source,
+    prepared: input.prepared ?? input.status === "prepared",
+    validated: input.validated ?? false,
+    message: input.message ?? `Remote project link ready for ${input.repoSlug}.`,
+    hint: "Remote-scoped task/run/status requests will send x-rig-project-root for this server-host checkout.",
+    next: "rig task list"
+  };
+}
+function localCheckoutPathCandidate(projectRoot, candidate) {
+  try {
+    const local = resolve3(projectRoot);
+    const resolved = resolve3(candidate);
+    return resolved === local || resolved.startsWith(`${local}/`);
+  } catch {
+    return false;
+  }
+}
+async function requestRemoteProjectLinkJson(baseUrl, pathname, authToken, init = {}) {
+  const requestUrl = new URL(`${baseUrl}${pathname}`);
+  if (authToken && queryAuthFallbackEnabled())
+    requestUrl.searchParams.set("rt", authToken);
+  const response = await fetch(requestUrl, {
+    ...init,
+    headers: mergeHeaders(init.headers, authToken)
+  });
+  const text = await response.text();
+  const payload = text.trim().length > 0 ? (() => {
+    try {
+      return JSON.parse(text);
+    } catch {
+      return null;
+    }
+  })() : null;
+  return { ok: response.ok, status: response.status, payload, text };
+}
+function payloadError(payload, fallback) {
+  if (payload && typeof payload === "object" && !Array.isArray(payload)) {
+    const record = payload;
+    const value = record.error ?? record.message ?? record.reason;
+    if (typeof value === "string" && value.trim())
+      return value.trim();
+  }
+  return fallback;
+}
+function checkoutPathsFromProjectPayload(payload) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload))
+    return [];
+  const project = payload.project;
+  if (!project || typeof project !== "object" || Array.isArray(project))
+    return [];
+  const checkouts = project.checkouts;
+  if (!Array.isArray(checkouts))
+    return [];
+  return [...checkouts].reverse().flatMap((entry) => {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry))
+      return [];
+    const path = entry.path;
+    return typeof path === "string" && path.trim() ? [path.trim()] : [];
+  });
+}
+function checkoutPathFromPreparePayload(payload) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload))
+    return null;
+  const checkout = payload.checkout;
+  if (!checkout || typeof checkout !== "object" || Array.isArray(checkout))
+    return null;
+  const path = checkout.path;
+  return typeof path === "string" && path.trim() ? path.trim() : null;
+}
+async function validateAndPersistRemoteRoot(input) {
+  const candidate = input.candidate.trim();
+  if (!candidate || !isAbsolute(candidate)) {
+    return remoteProjectLinkFailure({
+      status: "invalid_root",
+      alias: input.alias,
+      baseUrl: input.baseUrl,
+      repoSlug: input.repoSlug,
+      message: `Remote project root candidate is not an absolute server-host path: ${candidate || "(empty)"}.`
+    });
+  }
+  if (localCheckoutPathCandidate(input.projectRoot, candidate)) {
+    return remoteProjectLinkFailure({
+      status: "invalid_root",
+      alias: input.alias,
+      baseUrl: input.baseUrl,
+      repoSlug: input.repoSlug,
+      message: `Refusing to use local checkout path ${candidate} as a remote server project root.`
+    });
+  }
+  let response;
+  try {
+    response = await requestRemoteProjectLinkJson(input.baseUrl, "/api/server/project-root", input.authToken, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ projectRoot: candidate })
+    });
+  } catch (error) {
+    return remoteProjectLinkFailure({
+      status: "error",
+      alias: input.alias,
+      baseUrl: input.baseUrl,
+      repoSlug: input.repoSlug,
+      message: `Could not validate remote project root ${candidate}: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
+  if (response.status === 401 || response.status === 403) {
+    return remoteProjectLinkFailure({
+      status: "auth_required",
+      alias: input.alias,
+      baseUrl: input.baseUrl,
+      repoSlug: input.repoSlug,
+      statusCode: response.status,
+      message: `Remote server ${input.alias} requires authentication before validating project root ${candidate}.`
+    });
+  }
+  if (!response.ok) {
+    return remoteProjectLinkFailure({
+      status: "invalid_root",
+      alias: input.alias,
+      baseUrl: input.baseUrl,
+      repoSlug: input.repoSlug,
+      statusCode: response.status,
+      message: `Remote server rejected project root ${candidate} (${response.status}): ${payloadError(response.payload, response.text || "project-root validation failed")}`
+    });
+  }
+  const record = response.payload && typeof response.payload === "object" && !Array.isArray(response.payload) ? response.payload : {};
+  if (record.ok !== true) {
+    return remoteProjectLinkFailure({
+      status: "invalid_root",
+      alias: input.alias,
+      baseUrl: input.baseUrl,
+      repoSlug: input.repoSlug,
+      message: `Remote server did not accept project root ${candidate}: ${payloadError(response.payload, "project-root validation failed")}`
+    });
+  }
+  const accepted = typeof record.projectRoot === "string" && record.projectRoot.trim() ? record.projectRoot.trim() : typeof record.requestedProjectRoot === "string" && record.requestedProjectRoot.trim() ? record.requestedProjectRoot.trim() : candidate;
+  writeRepoServerProjectRoot(input.projectRoot, accepted, { alias: input.alias, baseUrl: input.baseUrl, project: input.repoSlug });
+  writeProjectLinkConnection(input.projectRoot, input.repoSlug, input.alias);
+  const status = input.status ?? (input.prepared ? "prepared" : "backfilled");
+  return remoteProjectLinkSuccess({
+    status,
+    alias: input.alias,
+    baseUrl: input.baseUrl,
+    repoSlug: input.repoSlug,
+    serverProjectRoot: accepted,
+    source: input.source,
+    prepared: input.prepared,
+    validated: true,
+    message: status === "ready" ? `Remote project link already points to ${accepted} and was validated on ${input.alias}.` : input.prepared ? `Prepared and linked remote checkout ${accepted} for ${input.repoSlug}.` : `Backfilled remote checkout ${accepted} for ${input.repoSlug}.`
+  });
+}
+async function ensureRemoteProjectRootLink(projectRoot, options = {}) {
+  let selected;
+  try {
+    selected = resolveSelectedConnection(projectRoot);
+  } catch (error) {
+    return remoteProjectLinkFailure({ status: "error", message: error instanceof Error ? error.message : String(error) });
+  }
+  if (!selected || selected.connection.kind !== "remote") {
+    return remoteProjectLinkFailure({ status: "not_remote", message: "No remote Rig server is selected for this repo." });
+  }
+  const repo = readRepoConnection(projectRoot);
+  const explicitRepoRequested = options.repoSlug !== undefined;
+  const explicitRepoSlug = explicitRepoRequested ? normalizeRepoSlug(options.repoSlug) : null;
+  const repoProjectSlug = normalizeRepoSlug(repo?.project);
+  const repoSlug = explicitRepoSlug ?? repoProjectSlug ?? readProjectLinkSlug(projectRoot);
+  const alias = selected.alias;
+  const baseUrl = selected.connection.baseUrl;
+  const authToken = options.authToken === undefined ? readGitHubBearerTokenForRemote(projectRoot) : options.authToken;
+  const mode = options.mode ?? "backfill-only";
+  if (explicitRepoRequested && !explicitRepoSlug) {
+    return remoteProjectLinkFailure({
+      status: "missing_project",
+      alias,
+      baseUrl,
+      message: `Invalid --repo value ${JSON.stringify(options.repoSlug)}. Expected owner/repo.`
+    });
+  }
+  if (!repoSlug) {
+    return remoteProjectLinkFailure({
+      status: "missing_project",
+      alias,
+      baseUrl,
+      message: `Remote server ${alias} is selected, but this checkout has no GitHub repo slug recorded.`
+    });
+  }
+  const skippedCandidates = [];
+  const storedRoot = selected.serverProjectRoot?.trim() || null;
+  const storedRootMatchesResolvedRepo = repoProjectSlug === repoSlug;
+  if (storedRoot && storedRootMatchesResolvedRepo) {
+    if (localCheckoutPathCandidate(projectRoot, storedRoot)) {
+      clearRepoServerProjectRoot(projectRoot);
+      skippedCandidates.push(storedRoot);
+    } else {
+      const storedResult = await validateAndPersistRemoteRoot({
+        projectRoot,
+        alias,
+        baseUrl,
+        authToken,
+        repoSlug,
+        candidate: storedRoot,
+        source: "stored",
+        status: "ready"
+      });
+      if (storedResult.ok || storedResult.status === "auth_required" || storedResult.status === "error")
+        return storedResult;
+      clearRepoServerProjectRoot(projectRoot);
+      skippedCandidates.push(storedRoot);
+    }
+  } else if (storedRoot) {
+    skippedCandidates.push(storedRoot);
+  }
+  const authCandidate = inferRemoteServerProjectRootCandidateFromAuthState(projectRoot, repoSlug);
+  if (authCandidate) {
+    const authResult = await validateAndPersistRemoteRoot({ projectRoot, alias, baseUrl, authToken, repoSlug, candidate: authCandidate, source: "auth-state" });
+    if (authResult.ok || authResult.status === "auth_required")
+      return authResult;
+  }
+  let registryResponse;
+  try {
+    registryResponse = await requestRemoteProjectLinkJson(baseUrl, `/api/projects/${encodeURIComponent(repoSlug)}`, authToken);
+  } catch (error) {
+    return remoteProjectLinkFailure({
+      status: "error",
+      alias,
+      baseUrl,
+      repoSlug,
+      message: `Could not read remote project registry for ${repoSlug} on ${alias}: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
+  if (registryResponse.status === 401 || registryResponse.status === 403) {
+    return remoteProjectLinkFailure({
+      status: "auth_required",
+      alias,
+      baseUrl,
+      repoSlug,
+      statusCode: registryResponse.status,
+      message: `Remote server ${alias} requires authentication before reading the ${repoSlug} project registry.`
+    });
+  }
+  if (registryResponse.ok) {
+    const candidates = checkoutPathsFromProjectPayload(registryResponse.payload);
+    for (const candidate of candidates) {
+      const result = await validateAndPersistRemoteRoot({ projectRoot, alias, baseUrl, authToken, repoSlug, candidate, source: "registry" });
+      if (result.ok || result.status === "auth_required")
+        return result;
+      skippedCandidates.push(candidate);
+    }
+    if (mode === "backfill-only") {
+      return remoteProjectLinkFailure({
+        status: candidates.length > 0 ? "invalid_root" : "no_server_checkout",
+        alias,
+        baseUrl,
+        repoSlug,
+        message: candidates.length > 0 ? `Remote registry has checkout candidates for ${repoSlug}, but none validated for ${alias}.` : `Remote registry has ${repoSlug}, but no server checkout path is linked yet.`,
+        skippedCandidates
+      });
+    }
+  } else if (registryResponse.status === 404) {
+    if (mode === "backfill-only") {
+      return remoteProjectLinkFailure({
+        status: "project_not_registered",
+        alias,
+        baseUrl,
+        repoSlug,
+        statusCode: registryResponse.status,
+        message: `Remote server ${alias} has no registered project record for ${repoSlug}.`
+      });
+    }
+  } else {
+    return remoteProjectLinkFailure({
+      status: "error",
+      alias,
+      baseUrl,
+      repoSlug,
+      statusCode: registryResponse.status,
+      message: `Could not backfill ${repoSlug} from remote registry (${registryResponse.status}): ${payloadError(registryResponse.payload, registryResponse.text || "registry lookup failed")}`,
+      skippedCandidates
+    });
+  }
+  let prepareResponse;
+  try {
+    prepareResponse = await requestRemoteProjectLinkJson(baseUrl, `/api/projects/${encodeURIComponent(repoSlug)}/prepare-checkout`, authToken, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ checkout: { kind: "managed-clone" }, repoUrl: `https://github.com/${repoSlug}.git` })
+    });
+  } catch (error) {
+    return remoteProjectLinkFailure({
+      status: "error",
+      alias,
+      baseUrl,
+      repoSlug,
+      message: `Could not prepare remote checkout for ${repoSlug} on ${alias}: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
+  if (prepareResponse.status === 401 || prepareResponse.status === 403) {
+    return remoteProjectLinkFailure({
+      status: "auth_required",
+      alias,
+      baseUrl,
+      repoSlug,
+      statusCode: prepareResponse.status,
+      message: `Remote server ${alias} requires authentication before preparing ${repoSlug}.`
+    });
+  }
+  if (!prepareResponse.ok) {
+    return remoteProjectLinkFailure({
+      status: "error",
+      alias,
+      baseUrl,
+      repoSlug,
+      statusCode: prepareResponse.status,
+      message: `Remote checkout prepare failed for ${repoSlug} (${prepareResponse.status}): ${payloadError(prepareResponse.payload, prepareResponse.text || "prepare-checkout failed")}`,
+      skippedCandidates
+    });
+  }
+  const preparedPath = checkoutPathFromPreparePayload(prepareResponse.payload);
+  if (!preparedPath) {
+    return remoteProjectLinkFailure({
+      status: "invalid_root",
+      alias,
+      baseUrl,
+      repoSlug,
+      message: `Remote checkout prepare for ${repoSlug} did not return a checkout.path.`,
+      skippedCandidates
+    });
+  }
+  return validateAndPersistRemoteRoot({ projectRoot, alias, baseUrl, authToken, repoSlug, candidate: preparedPath, source: "prepare", prepared: true });
+}
+async function inspectRemoteProjectLink(projectRoot) {
+  return ensureRemoteProjectRootLink(projectRoot, { mode: "backfill-only" });
+}
+async function repairRemoteProjectRootLink(context, options = {}) {
+  const resolution = await ensureRemoteProjectRootLink(context.projectRoot, { mode: options.mode ?? "prepare-if-missing", repoSlug: options.repoSlug });
+  if (!resolution.ok)
+    throw new CliError(resolution.message, 1, { hint: resolution.hint });
+  return resolution;
+}
 async function ensureServerForCli(projectRoot) {
   try {
     const selected = resolveSelectedConnection(projectRoot);
     if (selected?.connection.kind === "remote") {
       reportServerPhase(`Connecting to ${selected.alias}\u2026`);
       const authToken = readGitHubBearerTokenForRemote(projectRoot);
-      const serverProjectRoot = selected.serverProjectRoot ?? inferRemoteServerProjectRootFromAuthState(projectRoot) ?? await backfillRemoteServerProjectRoot(projectRoot, selected.connection.baseUrl, authToken);
+      const link = await ensureRemoteProjectRootLink(projectRoot, { mode: "backfill-only", authToken });
       return {
         baseUrl: selected.connection.baseUrl,
         authToken,
         connectionKind: "remote",
-        serverProjectRoot
+        serverProjectRoot: link.ok ? link.serverProjectRoot ?? null : null
       };
     }
     reportServerPhase("Starting local Rig server\u2026");
@@ -590,32 +1041,6 @@ async function ensureServerForCli(projectRoot) {
     throw error;
   }
 }
-async function backfillRemoteServerProjectRoot(projectRoot, baseUrl, authToken) {
-  const repo = readRepoConnection(projectRoot);
-  const slug = repo?.project?.trim();
-  if (!slug)
-    return null;
-  try {
-    const url = new URL(`${baseUrl}/api/projects/${encodeURIComponent(slug)}`);
-    if (authToken && queryAuthFallbackEnabled())
-      url.searchParams.set("rt", authToken);
-    const response = await fetch(url, {
-      headers: mergeHeaders(undefined, authToken)
-    });
-    if (!response.ok)
-      return null;
-    const payload = await response.json();
-    const project = payload.project && typeof payload.project === "object" && !Array.isArray(payload.project) ? payload.project : null;
-    const checkouts = Array.isArray(project?.checkouts) ? project.checkouts : [];
-    const latestCheckout = [...checkouts].reverse().find((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry) && typeof entry.path === "string"));
-    const path = typeof latestCheckout?.path === "string" && latestCheckout.path.trim() ? latestCheckout.path.trim() : null;
-    if (path)
-      writeRepoServerProjectRoot(projectRoot, path);
-    return path;
-  } catch {
-    return null;
-  }
-}
 function appendTaskFilterParams(url, filters) {
   if (filters.assignee)
     url.searchParams.set("assignee", filters.assignee);
@@ -716,13 +1141,20 @@ function canUseRemoteWithoutProjectRoot(pathname) {
 async function requestServerJson(context, pathname, init = {}) {
   const server = await ensureServerForCli(context.projectRoot);
   const requestUrl = new URL(`${server.baseUrl}${pathname}`);
-  if (server.connectionKind === "remote" && !server.serverProjectRoot && !canUseRemoteWithoutProjectRoot(requestUrl.pathname) && (server.authToken || !isLoopbackRemoteBaseUrl(server.baseUrl))) {
-    const repo = readRepoConnection(context.projectRoot);
-    throw new CliError(`Remote server is selected for ${repo?.project ?? "this repo"}, but this checkout has no server-host project root link.`, 1, { hint: "Run `rig init --repair` or `rig init --yes --repo owner/repo --server remote` to repair the remote project link before task/run commands." });
+  let scopedServerProjectRoot = server.serverProjectRoot;
+  if (server.connectionKind === "remote" && !scopedServerProjectRoot && !canUseRemoteWithoutProjectRoot(requestUrl.pathname) && (server.authToken || !isLoopbackRemoteBaseUrl(server.baseUrl))) {
+    const link = await ensureRemoteProjectRootLink(context.projectRoot, { mode: "backfill-only", authToken: server.authToken });
+    if (link.ok && link.serverProjectRoot) {
+      scopedServerProjectRoot = link.serverProjectRoot;
+    } else {
+      const repo = readRepoConnection(context.projectRoot);
+      const target = link.alias && link.baseUrl ? `${link.alias} (${link.baseUrl})` : server.baseUrl;
+      throw new CliError(`Remote server ${target} is selected for ${link.repoSlug ?? repo?.project ?? "this repo"}, but this checkout has no server-host project root link. ${link.message}`, 1, { hint: link.hint });
+    }
   }
   const headers = mergeHeaders(init.headers, server.authToken);
-  if (server.serverProjectRoot)
-    headers.set("x-rig-project-root", server.serverProjectRoot);
+  if (scopedServerProjectRoot)
+    headers.set("x-rig-project-root", scopedServerProjectRoot);
   if (server.connectionKind === "remote" && server.authToken && queryAuthFallbackEnabled()) {
     requestUrl.searchParams.set("rt", server.authToken);
   }
@@ -1346,7 +1778,15 @@ var init__async_ui = __esm(() => {
 });
 
 // packages/cli/src/commands/_pi-frontend.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, mkdtempSync, readFileSync as readFileSync3, rmSync, writeFileSync as writeFileSync2 } from "fs";
+var exports__pi_frontend = {};
+__export(exports__pi_frontend, {
+  shouldRequireOperatorTranscript: () => shouldRequireOperatorTranscript,
+  runWithProcessExitGuard: () => runWithProcessExitGuard,
+  missingOperatorTranscriptMessage: () => missingOperatorTranscriptMessage,
+  buildOperatorPiEnv: () => buildOperatorPiEnv,
+  attachRunBundledPiFrontend: () => attachRunBundledPiFrontend
+});
+import { existsSync as existsSync4, mkdirSync as mkdirSync4, mkdtempSync, readFileSync as readFileSync3, rmSync, writeFileSync as writeFileSync3 } from "fs";
 import { homedir as homedir2, tmpdir } from "os";
 import { join } from "path";
 import { main as runPiMain } from "@earendil-works/pi-coding-agent";
@@ -1398,7 +1838,7 @@ function statusFromRunDetails(run) {
 async function prepareOperatorConsole(context, runId, tempSessionDir) {
   const server = await ensureServerForCli(context.projectRoot);
   const localCwd = join(homedir2(), ".rig", "drones", runId.slice(0, 8));
-  mkdirSync3(localCwd, { recursive: true });
+  mkdirSync4(localCwd, { recursive: true });
   trustDroneCwd(localCwd);
   installRigPiTheme();
   let sessionFileArg = [];
@@ -1420,7 +1860,7 @@ async function prepareOperatorConsole(context, runId, tempSessionDir) {
         return line;
       }).join(`
 `);
-      writeFileSync2(localSessionPath, content);
+      writeFileSync3(localSessionPath, content);
       sessionFileArg = ["--session", localSessionPath];
     }
   } catch {}
@@ -1436,12 +1876,12 @@ async function prepareOperatorConsole(context, runId, tempSessionDir) {
 function trustDroneCwd(localCwd) {
   try {
     const agentDir = join(homedir2(), ".pi", "agent");
-    mkdirSync3(agentDir, { recursive: true });
+    mkdirSync4(agentDir, { recursive: true });
     const trustPath = join(agentDir, "trust.json");
     const store = existsSync4(trustPath) ? JSON.parse(readFileSync3(trustPath, "utf8")) : {};
     if (store[localCwd] !== true) {
       store[localCwd] = true;
-      writeFileSync2(trustPath, `${JSON.stringify(store, null, "\t")}
+      writeFileSync3(trustPath, `${JSON.stringify(store, null, "\t")}
 `);
     }
   } catch {}
@@ -1449,15 +1889,38 @@ function trustDroneCwd(localCwd) {
 function installRigPiTheme() {
   try {
     const themesDir = join(homedir2(), ".pi", "agent", "themes");
-    mkdirSync3(themesDir, { recursive: true });
+    mkdirSync4(themesDir, { recursive: true });
     const themePath = join(themesDir, "rig.json");
     const next = `${JSON.stringify(RIG_PI_THEME, null, "\t")}
 `;
     if (!existsSync4(themePath) || readFileSync3(themePath, "utf8") !== next) {
-      writeFileSync2(themePath, next);
+      writeFileSync3(themePath, next);
     }
   } catch {}
 }
+async function runWithProcessExitGuard(body) {
+  const realExit = process.exit;
+  let exitCode = 0;
+  let signalQuit = () => {};
+  const quit = new Promise((resolve4) => {
+    signalQuit = resolve4;
+  });
+  const guardedExit = (code) => {
+    exitCode = typeof code === "number" ? code : 0;
+    signalQuit();
+    return;
+  };
+  process.exit = guardedExit;
+  try {
+    await Promise.race([Promise.resolve().then(body), quit]);
+  } finally {
+    process.exit = realExit;
+  }
+  return exitCode;
+}
+function runPiMainReturningOnQuit(args, options) {
+  return runWithProcessExitGuard(() => runPiMain(args, options));
+}
 async function attachRunBundledPiFrontend(context, input) {
   const tempSessionDir = mkdtempSync(join(tmpdir(), "rig-pi-frontend-sessions-"));
   const { server, sessionFileArg } = await withSpinner(`Opening Pi console for run ${input.runId}\u2026`, () => prepareOperatorConsole(context, input.runId, tempSessionDir), { outputMode: context.outputMode });
@@ -1473,16 +1936,20 @@ async function attachRunBundledPiFrontend(context, input) {
   };
   let detached = false;
   try {
-    await runPiMain([
+    const piArgs = [
       "--offline",
       "--no-extensions",
       "--no-skills",
       "--no-prompt-templates",
       "--no-context-files",
       ...sessionFileArg
-    ], {
-      extensionFactories: [piRigExtensionFactory]
-    });
+    ];
+    const piOptions = { extensionFactories: [piRigExtensionFactory] };
+    if (input.returnOnQuit) {
+      await runPiMainReturningOnQuit(piArgs, piOptions);
+    } else {
+      await runPiMain(piArgs, piOptions);
+    }
     detached = true;
   } finally {
     restoreEnv();
@@ -1695,6 +2162,21 @@ async function captureConsole(fn) {
     console.error = original.error;
   }
 }
+async function releaseRendererForExternalTui(ctx) {
+  const renderer = ctx.renderer;
+  if (!renderer)
+    return;
+  if (renderer.suspend) {
+    await renderer.suspend();
+    return;
+  }
+  if (renderer.destroy) {
+    await renderer.destroy();
+  }
+}
+async function resumeRendererAfterExternalTui(ctx) {
+  await ctx.renderer?.resume?.();
+}
 function arrayFromPayload(value) {
   if (Array.isArray(value)) {
     return value.filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry)));
@@ -2727,12 +3209,13 @@ var init__help_catalog = __esm(() => {
     {
       name: "server",
       summary: "Choose, inspect, and start the Rig server that owns tasks and runs.",
-      usage: ["rig server <status|list|add|use|start> [options]"],
+      usage: ["rig server <status|list|add|use|repair-link|start> [options]"],
       commands: [
-        { command: "status", description: "Show the selected server for this repo.", primary: true },
+        { command: "status", description: "Show the selected server and remote project-root link for this repo.", primary: true },
         { command: "use local", description: "Switch this repo to the local Rig server.", primary: true },
         { command: "add <alias> <url>", description: "Save a remote Rig server URL.", primary: true },
         { command: "use <alias>", description: "Select a saved remote server alias.", primary: true },
+        { command: "repair-link [--prepare|--backfill-only] [--repo owner/repo]", description: "Backfill or prepare the selected remote's server-host checkout link.", primary: true },
         { command: "list", description: "List saved local/remote server aliases.", primary: true },
         { command: "start [--host <host>] [--port <n>]", description: "Start a local rig-server process." }
       ],
@@ -2740,6 +3223,7 @@ var init__help_catalog = __esm(() => {
         "rig server status",
         "rig server add prod https://where.rig-does.work",
         "rig server use prod",
+        "rig server repair-link --repo owner/repo",
         "rig server use local",
         "rig server start --port 3773"
       ],
@@ -3254,7 +3738,7 @@ function resolveControlPlaneDefinitionRoot(projectRoot) {
 var init__paths = () => {};
 
 // packages/cli/src/report-bug.ts
-import { copyFileSync, existsSync as existsSync7, mkdirSync as mkdirSync4, rmSync as rmSync3, writeFileSync as writeFileSync3 } from "fs";
+import { copyFileSync, existsSync as existsSync7, mkdirSync as mkdirSync5, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "fs";
 import { basename as basename2, extname, join as join2, resolve as resolve8 } from "path";
 function slugifyBugTitle(value) {
   const slug = value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80).replace(/-+$/g, "");
@@ -3293,8 +3777,8 @@ function createBugReportFiles(input) {
     }
     rmSync3(reportDir, { recursive: true, force: true });
   }
-  mkdirSync4(assetDir, { recursive: true });
-  mkdirSync4(screenshotDir, { recursive: true });
+  mkdirSync5(assetDir, { recursive: true });
+  mkdirSync5(screenshotDir, { recursive: true });
   const copiedScreenshots = copyEvidenceFiles(input.projectRoot, screenshotDir, input.screenshots ?? [], "screenshot");
   const copiedAssets = copyEvidenceFiles(input.projectRoot, assetDir, input.assets ?? [], "asset");
   const manifestAssets = [
@@ -3324,15 +3808,15 @@ function createBugReportFiles(input) {
     platform: process.platform,
     arch: process.arch
   };
-  writeFileSync3(join2(assetDir, "README.md"), buildAssetReadme(input.title), "utf8");
-  writeFileSync3(join2(screenshotDir, "README.md"), buildScreenshotReadme(input.title), "utf8");
+  writeFileSync4(join2(assetDir, "README.md"), buildAssetReadme(input.title), "utf8");
+  writeFileSync4(join2(screenshotDir, "README.md"), buildScreenshotReadme(input.title), "utf8");
   if (browserPath && browser) {
-    writeFileSync3(browserPath, `${JSON.stringify(browser, null, 2)}
+    writeFileSync4(browserPath, `${JSON.stringify(browser, null, 2)}
 `, "utf8");
   }
-  writeFileSync3(manifestPath, `${JSON.stringify(manifest, null, 2)}
+  writeFileSync4(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
-  writeFileSync3(taskPath, buildBugReportMarkdown(input, browser, copiedScreenshots, copiedAssets), "utf8");
+  writeFileSync4(taskPath, buildBugReportMarkdown(input, browser, copiedScreenshots, copiedAssets), "utf8");
   return {
     slug,
     reportDir,
@@ -3509,7 +3993,7 @@ function formatAssetMarkdown(name, path) {
 var init_report_bug = () => {};
 
 // packages/cli/src/commands/task-report-bug.ts
-import { existsSync as existsSync8, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync8, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
 import { resolve as resolve9 } from "path";
 import pc3 from "picocolors";
 import {
@@ -3871,7 +4355,7 @@ function appendTaskConfigEntryPreservingText(taskConfigPath, issueId, entry) {
 `).map((line) => `  ${line}`).join(`
 `);
   if (!trimmed || trimmed === "{}") {
-    writeFileSync4(taskConfigPath, `{
+    writeFileSync5(taskConfigPath, `{
 ${serializedEntry}
 }
 `, "utf8");
@@ -3887,7 +4371,7 @@ ${serializedEntry}
     throw new CliError(`Invalid trailing content in task config: ${taskConfigPath}`, 1, { hint: "Remove the trailing content so the file is a single JSON object, then retry." });
   }
   const comma = before.trim() === "{" ? "" : ",";
-  writeFileSync4(taskConfigPath, `${before}${comma}
+  writeFileSync5(taskConfigPath, `${before}${comma}
 ${serializedEntry}
 }
 `, "utf8");
@@ -4272,7 +4756,7 @@ var init_task_report_bug = __esm(() => {
 });
 
 // packages/cli/src/commands/browser.ts
-import { mkdirSync as mkdirSync5, rmSync as rmSync4 } from "fs";
+import { mkdirSync as mkdirSync6, rmSync as rmSync4 } from "fs";
 import { resolve as resolve10 } from "path";
 import { spawn } from "child_process";
 import { emitKeypressEvents } from "readline";
@@ -4850,7 +5334,7 @@ function readBrowserDemoCommandLine(command) {
 }
 async function launchBrowserDemo(runtime) {
   rmSync4(resolve10(runtime.browserDir, runtime.stateDir), { recursive: true, force: true });
-  mkdirSync5(resolve10(runtime.browserDir, runtime.stateDir), { recursive: true });
+  mkdirSync6(resolve10(runtime.browserDir, runtime.stateDir), { recursive: true });
   const launcherPath = resolve10(runtime.browserDir, "scripts/electron-launcher.mjs");
   const launcher = await import(pathToFileURL(launcherPath).href);
   const electronPath = await launcher.resolveElectronPath();
@@ -5199,7 +5683,7 @@ var init_profile_and_review = __esm(() => {
 });
 
 // packages/cli/src/commands/_policy.ts
-import { appendFileSync, mkdirSync as mkdirSync6 } from "fs";
+import { appendFileSync, mkdirSync as mkdirSync7 } from "fs";
 import { resolve as resolve11 } from "path";
 import { evaluate as evaluate2, loadPolicy as loadPolicy2, resolveAction as resolveAction2 } from "@rig/runtime/control-plane/runtime/guard";
 import { resolveHarnessPaths } from "@rig/runtime/control-plane/native/utils";
@@ -5216,7 +5700,7 @@ function appendControlledBashAudit(context, mode, command, args, matchedRuleIds,
   }
   const logsDir = resolveHarnessPaths(context.projectRoot).logsDir;
   const logFile = resolve11(logsDir, "controlled-bash.jsonl");
-  mkdirSync6(logsDir, { recursive: true });
+  mkdirSync7(logsDir, { recursive: true });
   const payload = {
     timestamp: new Date().toISOString(),
     mode,
@@ -5510,9 +5994,9 @@ var exports_pi = {};
 __export(exports_pi, {
   executePi: () => executePi
 });
-import { existsSync as existsSync10, mkdirSync as mkdirSync7, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync10, mkdirSync as mkdirSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "fs";
 import { homedir as homedir5 } from "os";
-import { dirname as dirname2, resolve as resolve13 } from "path";
+import { dirname as dirname3, resolve as resolve13 } from "path";
 function settingsPath(root) {
   return resolve13(root, ".pi", "settings.json");
 }
@@ -5537,8 +6021,8 @@ function packageKey(entry) {
   return JSON.stringify(entry);
 }
 function writeSettings(path, settings) {
-  mkdirSync7(dirname2(path), { recursive: true });
-  writeFileSync5(path, `${JSON.stringify(settings, null, 2)}
+  mkdirSync8(dirname3(path), { recursive: true });
+  writeFileSync6(path, `${JSON.stringify(settings, null, 2)}
 `, "utf-8");
 }
 async function searchNpmForPiExtensions(term) {
@@ -5721,6 +6205,14 @@ function permissionAllowsPr2(payload) {
 function isNotFoundError(error) {
   return /\b(404|not found)\b/i.test(message(error));
 }
+function isLoopbackBaseUrl(baseUrl) {
+  try {
+    const host = new URL(baseUrl).hostname.toLowerCase();
+    return host === "localhost" || host === "127.0.0.1" || host === "::1" || host === "[::1]";
+  } catch {
+    return false;
+  }
+}
 function projectCheckoutReady(payload) {
   if (!payload || typeof payload !== "object" || Array.isArray(payload))
     return null;
@@ -5775,25 +6267,37 @@ async function runFastTaskRunPreflight(context, options = {}) {
   }
   const repo = readRepoConnection(context.projectRoot);
   const remoteWithoutProjectLink = selectedServer?.connectionKind === "remote" && !repo?.project;
-  checks.push(repo ? preflightCheck("project-link", "project linked to selected server", repo.project ? "pass" : remoteWithoutProjectLink ? "fail" : "warn", `${repo.selected}${repo.project ? ` -> ${repo.project}` : " (missing project link)"}`, remoteWithoutProjectLink ? "Run `rig init --repair` or `rig init --yes --repo owner/repo --server remote` to restore the remote project link." : "Run `rig init --yes --repo owner/repo` to record the GitHub repo slug.") : preflightCheck("project-link", "project linked to selected server", legacyServerCompatibility ? "warn" : "fail", "missing .rig/state/connection.json", "Run `rig init` or `rig server use <alias|local>`."));
+  let remoteRootBlocked = false;
+  checks.push(repo ? preflightCheck("project-link", "project linked to selected server", repo.project ? "pass" : remoteWithoutProjectLink ? "fail" : "warn", `${repo.selected}${repo.project ? ` -> ${repo.project}` : " (missing project link)"}`, remoteWithoutProjectLink ? "Run `rig server repair-link --repo owner/repo` or `rig init --repo owner/repo --server remote` to restore the remote project link." : "Run `rig init --yes --repo owner/repo` to record the GitHub repo slug.") : preflightCheck("project-link", "project linked to selected server", legacyServerCompatibility ? "warn" : "fail", "missing .rig/state/connection.json", "Run `rig init` or `rig server use <alias|local>`."));
+  if (selectedServer?.connectionKind === "remote" && repo?.project && !selectedServer.serverProjectRoot) {
+    const link = await ensureRemoteProjectRootLink(context.projectRoot, { mode: "backfill-only", authToken: selectedServer.authToken });
+    const loopbackDevRemote = !selectedServer.authToken && isLoopbackBaseUrl(selectedServer.baseUrl);
+    checks.push(preflightCheck("remote-project-root-link", "remote server checkout/root linked", link.ok ? "pass" : loopbackDevRemote ? "warn" : "fail", link.ok ? `${link.repoSlug} -> ${link.serverProjectRoot}` : link.message, link.ok ? undefined : loopbackDevRemote ? "Loopback development remotes may continue without x-rig-project-root; production remotes must run `rig server repair-link`." : link.hint));
+    remoteRootBlocked = !link.ok && !loopbackDevRemote;
+  }
   try {
     const auth = await request("/api/github/auth/status");
     checks.push(isAuthenticated2(auth) ? preflightCheck("github-auth", "GitHub auth valid", "pass") : preflightCheck("github-auth", "GitHub auth valid", legacyServerCompatibility ? "warn" : "fail", "not authenticated", "Run `rig github auth import-gh` or `rig github auth token --token <token>`."));
   } catch (error) {
     checks.push(preflightCheck("github-auth", "GitHub auth valid", legacyServerCompatibility ? "warn" : "fail", message(error), "Fix GitHub auth on the selected Rig server."));
   }
-  try {
-    const projection = await request("/api/workspace/task-projection");
-    checks.push(preflightCheck("task-projection", "task projection ready", "pass", JSON.stringify(projection).slice(0, 120)));
-  } catch (error) {
-    checks.push(preflightCheck("task-projection", "task projection ready", "warn", message(error), "Refresh task projection with `rig task list` before launching."));
-  }
-  try {
-    const permissions = await request("/api/github/repo/permissions");
-    const allowed = permissionAllowsPr2(permissions);
-    checks.push(allowed === false ? preflightCheck("github-repo-permissions", "GitHub PR permissions", "fail", JSON.stringify(permissions).slice(0, 120), "Grant the selected GitHub token permission to push branches and open PRs.") : preflightCheck("github-repo-permissions", "GitHub PR permissions", allowed === true ? "pass" : "warn", JSON.stringify(permissions).slice(0, 120), "Confirm the selected token can push branches and open PRs."));
-  } catch (error) {
-    checks.push(preflightCheck("github-repo-permissions", "GitHub PR permissions", "warn", message(error), "Ensure the selected token can push branches and open PRs."));
+  if (!remoteRootBlocked) {
+    try {
+      const projection = await request("/api/workspace/task-projection");
+      checks.push(preflightCheck("task-projection", "task projection ready", "pass", JSON.stringify(projection).slice(0, 120)));
+    } catch (error) {
+      checks.push(preflightCheck("task-projection", "task projection ready", "warn", message(error), "Refresh task projection with `rig task list` before launching."));
+    }
+    try {
+      const permissions = await request("/api/github/repo/permissions");
+      const allowed = permissionAllowsPr2(permissions);
+      checks.push(allowed === false ? preflightCheck("github-repo-permissions", "GitHub PR permissions", "fail", JSON.stringify(permissions).slice(0, 120), "Grant the selected GitHub token permission to push branches and open PRs.") : preflightCheck("github-repo-permissions", "GitHub PR permissions", allowed === true ? "pass" : "warn", JSON.stringify(permissions).slice(0, 120), "Confirm the selected token can push branches and open PRs."));
+    } catch (error) {
+      checks.push(preflightCheck("github-repo-permissions", "GitHub PR permissions", "warn", message(error), "Ensure the selected token can push branches and open PRs."));
+    }
+  } else {
+    checks.push(preflightCheck("task-projection", "task projection ready", "warn", "skipped until remote project-root link is repaired", "Run `rig server repair-link`, then retry."));
+    checks.push(preflightCheck("github-repo-permissions", "GitHub PR permissions", "warn", "skipped until remote project-root link is repaired", "Run `rig server repair-link`, then retry."));
   }
   if (repo?.project) {
     try {
@@ -5805,19 +6309,24 @@ async function runFastTaskRunPreflight(context, options = {}) {
     }
   }
   if (taskId) {
-    try {
-      const tasks = await request(`/api/workspace/tasks?limit=200&refresh=1`);
-      const found = Array.isArray(tasks) && tasks.some((task) => taskMatchesId(task, taskId));
-      checks.push(found ? preflightCheck("issue", "task/issue accessible", "pass", taskId) : preflightCheck("issue", "task/issue accessible", legacyServerCompatibility ? "warn" : "fail", taskId, "Confirm the issue exists and matches the configured task filters."));
-    } catch (error) {
-      checks.push(preflightCheck("issue", "task/issue accessible", legacyServerCompatibility ? "warn" : "fail", message(error), "Fix the task source before launching a run."));
-    }
-    try {
-      const runs = await request("/api/runs?limit=200");
-      const duplicate = activeDuplicateRun(runs, taskId);
-      checks.push(duplicate ? preflightCheck("duplicate-active-run", "one active run per task", "fail", String(duplicate.runId ?? taskId), "Attach to or stop the existing run before starting another one for this task.") : preflightCheck("duplicate-active-run", "one active run per task", "pass", taskId));
-    } catch (error) {
-      checks.push(preflightCheck("duplicate-active-run", "one active run per task", "warn", message(error), "Could not list active runs; the server will still reject conflicting runs if configured."));
+    if (!remoteRootBlocked) {
+      try {
+        const tasks = await request(`/api/workspace/tasks?limit=200&refresh=1`);
+        const found = Array.isArray(tasks) && tasks.some((task) => taskMatchesId(task, taskId));
+        checks.push(found ? preflightCheck("issue", "task/issue accessible", "pass", taskId) : preflightCheck("issue", "task/issue accessible", legacyServerCompatibility ? "warn" : "fail", taskId, "Confirm the issue exists and matches the configured task filters."));
+      } catch (error) {
+        checks.push(preflightCheck("issue", "task/issue accessible", legacyServerCompatibility ? "warn" : "fail", message(error), "Fix the task source before launching a run."));
+      }
+      try {
+        const runs = await request("/api/runs?limit=200");
+        const duplicate = activeDuplicateRun(runs, taskId);
+        checks.push(duplicate ? preflightCheck("duplicate-active-run", "one active run per task", "fail", String(duplicate.runId ?? taskId), "Attach to or stop the existing run before starting another one for this task.") : preflightCheck("duplicate-active-run", "one active run per task", "pass", taskId));
+      } catch (error) {
+        checks.push(preflightCheck("duplicate-active-run", "one active run per task", "warn", message(error), "Could not list active runs; the server will still reject conflicting runs if configured."));
+      }
+    } else {
+      checks.push(preflightCheck("issue", "task/issue accessible", "fail", "skipped until remote project-root link is repaired", "Run `rig server repair-link`, then retry."));
+      checks.push(preflightCheck("duplicate-active-run", "one active run per task", "warn", "skipped until remote project-root link is repaired", "Run `rig server repair-link`, then retry."));
     }
   }
   if ((options.runtimeAdapter ?? "pi") === "pi") {
@@ -6298,7 +6807,7 @@ import {
   chmodSync,
   copyFileSync as copyFileSync2,
   existsSync as existsSync12,
-  mkdirSync as mkdirSync8,
+  mkdirSync as mkdirSync9,
   readdirSync,
   readlinkSync,
   rmSync as rmSync5,
@@ -6403,7 +6912,7 @@ async function executeDist(context, args) {
       requireNoExtraArgs(pending, "rig dist install [--scope user|system] [--path <dir>]");
       const scope = parseInstallScope(scopeResult.value);
       const installDir = resolveInstallDir(scope, pathResult.value);
-      mkdirSync8(installDir, { recursive: true });
+      mkdirSync9(installDir, { recursive: true });
       let source = await findLatestDistBinary(context.projectRoot);
       let buildDir = null;
       if (!source) {
@@ -6458,7 +6967,7 @@ async function executeDist(context, args) {
       const fp = await computeRuntimeImageFingerprint(context.projectRoot);
       const currentId = computeRuntimeImageId(fp);
       const imagesDir = resolve16(resolveControlPlaneMonorepoRuntimeDir(context.projectRoot), "images");
-      mkdirSync8(imagesDir, { recursive: true });
+      mkdirSync9(imagesDir, { recursive: true });
       let pruned = 0;
       for (const entry of readdirSync(imagesDir, { withFileTypes: true })) {
         if (entry.isDirectory() && entry.name !== currentId) {
@@ -6470,9 +6979,9 @@ async function executeDist(context, args) {
         console.log(`Pruned ${pruned} stale image(s).`);
       }
       const imageDir = resolve16(imagesDir, currentId);
-      mkdirSync8(resolve16(imageDir, "bin/hooks"), { recursive: true });
-      mkdirSync8(resolve16(imageDir, "bin/plugins"), { recursive: true });
-      mkdirSync8(resolve16(imageDir, "bin/validators"), { recursive: true });
+      mkdirSync9(resolve16(imageDir, "bin/hooks"), { recursive: true });
+      mkdirSync9(resolve16(imageDir, "bin/plugins"), { recursive: true });
+      mkdirSync9(resolve16(imageDir, "bin/validators"), { recursive: true });
       const hookNames = [
         "scope-guard",
         "import-guard",
@@ -6497,8 +7006,8 @@ async function executeDist(context, args) {
       const binPluginsDir = resolve16(resolveControlPlaneHostBinDir(context.projectRoot), "plugins");
       const validatorsRoot = resolve16(hostProjectRoot, "packages/runtime/src/control-plane/validators");
       const binValidatorsDir = resolve16(resolveControlPlaneHostBinDir(context.projectRoot), "validators");
-      mkdirSync8(binPluginsDir, { recursive: true });
-      mkdirSync8(binValidatorsDir, { recursive: true });
+      mkdirSync9(binPluginsDir, { recursive: true });
+      mkdirSync9(binValidatorsDir, { recursive: true });
       if (existsSync12(pluginsDir)) {
         for (const entry of readdirSync(pluginsDir, { withFileTypes: true })) {
           const m = entry.name.match(/^(.+)\.plugin\.(ts|js|mjs|cjs)$/);
@@ -6937,16 +7446,19 @@ function formatConnectionList(connections) {
   return [formatSection("Rig servers", `${rows.length} available`), `${pc5.bold(pad("ALIAS", aliasWidth))}  ${pc5.bold("KIND")}  ${pc5.bold("TARGET")}`, ...lines, "", ...formatNextSteps(["Select one: `rig server use <alias|local>`"])].join(`
 `);
 }
-function formatConnectionStatus(selected, connections) {
+function formatConnectionStatus(selected, connections, repo, remoteProjectLink) {
   const connection = selected === "local" ? { kind: "local", mode: "auto" } : connections[selected];
   const target = !connection ? "not configured" : connection.kind === "remote" ? connection.baseUrl : "local";
+  const rootLabel = remoteProjectLink ? remoteProjectLink.ok ? `ready \xB7 ${remoteProjectLink.serverProjectRoot ?? repo?.serverProjectRoot ?? "linked"}` : `${remoteProjectLink.status ?? "needs repair"} \xB7 ${remoteProjectLink.hint ?? remoteProjectLink.message ?? "run rig server repair-link"}` : repo?.serverProjectRoot ? repo.serverProjectRoot : "not required";
   return [
     formatSection("Rig server", "selected for this repo"),
     `${themeFaint("\u2502")} ${themeDim("selected ")} ${pc5.bold(selected)}`,
     `${themeFaint("\u2502")} ${themeDim("kind     ")} ${formatStatusPill(connection?.kind ?? "unknown")}`,
     `${themeFaint("\u2502")} ${themeDim("target   ")} ${target ?? "not configured"}`,
+    ...repo?.project ? [`${themeFaint("\u2502")} ${themeDim("project  ")} ${repo.project}`] : [],
+    ...connection?.kind === "remote" ? [`${themeFaint("\u2502")} ${themeDim("root     ")} ${rootLabel}`] : [],
     "",
-    ...formatNextSteps(["Change: `rig server use <alias|local>`", "List saved servers: `rig server list`"])
+    ...formatNextSteps(remoteProjectLink && !remoteProjectLink.ok ? ["Repair remote link: `rig server repair-link`", "Authenticate first if needed: `rig github auth import-gh`"] : ["Change: `rig server use <alias|local>`", "List saved servers: `rig server list`"])
   ].join(`
 `);
 }
@@ -7175,7 +7687,7 @@ var init_inbox = __esm(() => {
 
 // packages/cli/src/commands/_snapshot-upload.ts
 import { mkdir, readdir, readFile, writeFile } from "fs/promises";
-import { dirname as dirname3, resolve as resolve17, relative, sep } from "path";
+import { dirname as dirname4, resolve as resolve17, relative, sep } from "path";
 function toPosixPath(path) {
   return path.split(sep).join("/");
 }
@@ -7276,7 +7788,7 @@ __export(exports_init, {
   DEMO_TASKS_RELATIVE_DIR: () => DEMO_TASKS_RELATIVE_DIR,
   DEMO_TASKS: () => DEMO_TASKS
 });
-import { appendFileSync as appendFileSync2, existsSync as existsSync13, mkdirSync as mkdirSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
+import { appendFileSync as appendFileSync2, existsSync as existsSync13, mkdirSync as mkdirSync10, readFileSync as readFileSync8, writeFileSync as writeFileSync7 } from "fs";
 import { spawnSync } from "child_process";
 import { basename as basename3, resolve as resolve18 } from "path";
 import { buildRigInitConfigSource } from "@rig/core";
@@ -7300,14 +7812,14 @@ function parseRepoSlug(value) {
 }
 function ensureRigPrivateDirs(projectRoot) {
   const rigDir = resolve18(projectRoot, ".rig");
-  mkdirSync9(resolve18(rigDir, "state"), { recursive: true });
-  mkdirSync9(resolve18(rigDir, "logs"), { recursive: true });
-  mkdirSync9(resolve18(rigDir, "runs"), { recursive: true });
-  mkdirSync9(resolve18(rigDir, "tmp"), { recursive: true });
-  mkdirSync9(resolve18(projectRoot, "artifacts"), { recursive: true });
+  mkdirSync10(resolve18(rigDir, "state"), { recursive: true });
+  mkdirSync10(resolve18(rigDir, "logs"), { recursive: true });
+  mkdirSync10(resolve18(rigDir, "runs"), { recursive: true });
+  mkdirSync10(resolve18(rigDir, "tmp"), { recursive: true });
+  mkdirSync10(resolve18(projectRoot, "artifacts"), { recursive: true });
   const taskConfigPath = resolve18(rigDir, "task-config.json");
   if (!existsSync13(taskConfigPath))
-    writeFileSync6(taskConfigPath, `{}
+    writeFileSync7(taskConfigPath, `{}
 `, "utf-8");
 }
 function ensureGitignoreEntries(projectRoot) {
@@ -7335,7 +7847,7 @@ function ensureRigConfigPackageDependencies(projectRoot) {
     ...existsSync13(path) ? existing : { name: "rig-project", private: true },
     devDependencies
   };
-  writeFileSync6(path, `${JSON.stringify(next, null, 2)}
+  writeFileSync7(path, `${JSON.stringify(next, null, 2)}
 `, "utf8");
 }
 function applyGitHubProjectConfig(source, options) {
@@ -7361,9 +7873,9 @@ function checkoutForInit(projectRoot, serverKind, strategy) {
   const selected = strategy ?? { kind: "managed-clone" };
   switch (selected.kind) {
     case "managed-clone":
-      return { kind: "managed-clone", path: projectRoot };
+      return { kind: "managed-clone" };
     case "current-ref":
-      return { kind: "current-ref", path: projectRoot, ...selected.ref ? { ref: selected.ref } : {} };
+      return { kind: "current-ref", ...selected.ref ? { ref: selected.ref } : {} };
     case "uploaded-snapshot":
       return { kind: "uploaded-snapshot", path: projectRoot, source: "local-working-tree" };
     case "existing-path":
@@ -7616,7 +8128,7 @@ function remoteGitHubAuthMetadata(payload) {
   };
 }
 function writeRemoteGitHubAuthState(projectRoot, input) {
-  writeFileSync6(resolve18(projectRoot, ".rig", "state", "github-auth.json"), `${JSON.stringify({
+  writeFileSync7(resolve18(projectRoot, ".rig", "state", "github-auth.json"), `${JSON.stringify({
     authenticated: true,
     source: input.source,
     storedOnServer: true,
@@ -7664,7 +8176,7 @@ function runLocalFilesInit(context, options) {
       console.log("rig.config already exists; leaving it unchanged. Pass --repair to rewrite it.");
   } else {
     const projectName = basename3(projectRoot) || "rig-project";
-    writeFileSync6(configTsPath, buildRigInitConfigSource({
+    writeFileSync7(configTsPath, buildRigInitConfigSource({
       projectName,
       taskSource: { kind: "files", path: "tasks" },
       useStandardPlugin: true
@@ -7673,8 +8185,8 @@ function runLocalFilesInit(context, options) {
   ensureRigConfigPackageDependencies(projectRoot);
   const tasksDir = resolve18(projectRoot, "tasks");
   if (!existsSync13(tasksDir)) {
-    mkdirSync9(tasksDir, { recursive: true });
-    writeFileSync6(resolve18(tasksDir, "T-1.json"), `${JSON.stringify({ id: "T-1", title: "My first Rig task", body: "Describe the change you want an agent to make." }, null, 2)}
+    mkdirSync10(tasksDir, { recursive: true });
+    writeFileSync7(resolve18(tasksDir, "T-1.json"), `${JSON.stringify({ id: "T-1", title: "My first Rig task", body: "Describe the change you want an agent to make." }, null, 2)}
 `, "utf-8");
   }
   if (context.outputMode !== "json") {
@@ -7698,7 +8210,7 @@ function runDemoInit(context, options) {
       console.log("rig.config already exists; leaving it unchanged. Pass --repair to rewrite it for the demo.");
     }
   } else {
-    writeFileSync6(configTsPath, buildRigInitConfigSource({
+    writeFileSync7(configTsPath, buildRigInitConfigSource({
       projectName: basename3(projectRoot) || "rig-demo",
       taskSource: { kind: "files", path: DEMO_TASKS_RELATIVE_DIR },
       useStandardPlugin: true
@@ -7707,14 +8219,14 @@ function runDemoInit(context, options) {
   }
   ensureRigConfigPackageDependencies(projectRoot);
   const demoTasksDir = resolve18(projectRoot, DEMO_TASKS_RELATIVE_DIR);
-  mkdirSync9(demoTasksDir, { recursive: true });
+  mkdirSync10(demoTasksDir, { recursive: true });
   const taskIds = [];
   for (const task of DEMO_TASKS) {
     const id = String(task.id);
     taskIds.push(id);
     const taskPath = resolve18(demoTasksDir, `${id}.json`);
     if (!existsSync13(taskPath)) {
-      writeFileSync6(taskPath, `${JSON.stringify(task, null, 2)}
+      writeFileSync7(taskPath, `${JSON.stringify(task, null, 2)}
 `, "utf-8");
     }
   }
@@ -7742,21 +8254,32 @@ function runDemoInit(context, options) {
 }
 async function runControlPlaneInit(context, options) {
   const projectRoot = context.projectRoot;
-  const detectedSlug = options.repoSlug ?? detectOriginRepoSlug(projectRoot);
+  const existingRepoConnection = readRepoConnection(projectRoot);
+  const selectedConnection = (() => {
+    try {
+      return resolveSelectedConnection(projectRoot);
+    } catch {
+      return null;
+    }
+  })();
+  const selectedRemote = selectedConnection?.connection.kind === "remote" ? { alias: selectedConnection.alias, connection: selectedConnection.connection } : null;
+  const detectedSlug = options.repoSlug ?? existingRepoConnection?.project ?? detectOriginRepoSlug(projectRoot);
+  const serverKind = options.server ?? (selectedRemote ? "remote" : "local");
   if (!detectedSlug) {
     const authMethod2 = options.githubAuthMethod ?? (options.githubToken ? "token" : "skip");
-    if ((options.server ?? "local") === "local" && authMethod2 === "skip") {
+    if (serverKind === "local" && authMethod2 === "skip") {
       return runLocalFilesInit(context, options);
     }
     throw new CliError("Could not detect GitHub repo slug from origin. Pass --repo owner/repo \u2014 or run `rig init --yes --server local --github-auth skip` for a local files-source project without GitHub.", 1);
   }
   const repo = parseRepoSlug(detectedSlug);
-  const serverKind = options.server ?? "local";
-  const connectionAlias = options.connectionAlias ?? (serverKind === "local" ? "local" : "remote");
+  const connectionAlias = options.connectionAlias ?? (serverKind === "local" ? "local" : selectedRemote?.alias ?? "remote");
+  const selectedRemoteUrl = selectedRemote && (!options.connectionAlias || options.connectionAlias === selectedRemote.alias) ? selectedRemote.connection.baseUrl : undefined;
+  const remoteUrl = serverKind === "remote" ? (options.remoteUrl ?? selectedRemoteUrl)?.replace(/\/+$/, "") : undefined;
   if (serverKind === "remote") {
-    if (!options.remoteUrl)
-      throw new CliError("Missing --remote-url for --server remote.", 1, { hint: "Re-run as `rig init --server remote --remote-url https://your-rig-server`." });
-    upsertGlobalConnection(connectionAlias, { kind: "remote", baseUrl: options.remoteUrl });
+    if (!remoteUrl)
+      throw new CliError("Missing --remote-url for --server remote.", 1, { hint: "Re-run as `rig init --server remote --remote-url https://your-rig-server`, or first select a saved remote with `rig server use <alias>`." });
+    upsertGlobalConnection(connectionAlias, { kind: "remote", baseUrl: remoteUrl });
   }
   writeRepoConnection(projectRoot, {
     selected: connectionAlias,
@@ -7779,11 +8302,11 @@ async function runControlPlaneInit(context, options) {
         taskSource: { kind: "github-issues", owner: repo.owner, repo: repo.repo },
         useStandardPlugin: true
       }), options);
-      writeFileSync6(configTsPath, source, "utf-8");
+      writeFileSync7(configTsPath, source, "utf-8");
     }
     ensureRigConfigPackageDependencies(projectRoot);
   }
-  writeFileSync6(resolve18(projectRoot, ".rig", "state", "project-link.json"), `${JSON.stringify({ repoSlug: repo.slug, connection: connectionAlias, linkedAt: new Date().toISOString() }, null, 2)}
+  writeFileSync7(resolve18(projectRoot, ".rig", "state", "project-link.json"), `${JSON.stringify({ repoSlug: repo.slug, connection: connectionAlias, linkedAt: new Date().toISOString() }, null, 2)}
 `, "utf8");
   const checkout = checkoutForInit(projectRoot, serverKind, options.remoteCheckout);
   let uploadedSnapshot = null;
@@ -7798,7 +8321,7 @@ async function runControlPlaneInit(context, options) {
   let githubAuth = null;
   let deviceAuth = null;
   const authMethod = options.githubAuthMethod ?? (options.githubToken ? "token" : "skip");
-  const remoteGhTokenWarning = serverKind === "remote" && authMethod === "gh" ? `This sends a GitHub token from this machine to ${options.remoteUrl ?? "the remote Rig server"}.` : null;
+  const remoteGhTokenWarning = serverKind === "remote" && authMethod === "gh" ? `This sends a GitHub token from this machine to ${remoteUrl ?? "the remote Rig server"}.` : null;
   if (remoteGhTokenWarning && !options.yes) {
     throw new CliError(`${remoteGhTokenWarning} Re-run with --yes to confirm this explicit token transfer.`, 1);
   }
@@ -8178,8 +8701,8 @@ var init_init = __esm(() => {
 
 // packages/cli/src/commands/github.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync7 } from "fs";
-import { dirname as dirname4, resolve as resolve19 } from "path";
+import { mkdirSync as mkdirSync11, writeFileSync as writeFileSync8 } from "fs";
+import { dirname as dirname5, resolve as resolve19 } from "path";
 function printPayload(context, payload, fallback) {
   if (context.outputMode === "json")
     console.log(JSON.stringify(payload, null, 2));
@@ -8218,8 +8741,8 @@ function persistRemoteAuthSession(context, source, result, fallbackToken) {
     return;
   const repo = readRepoConnection(context.projectRoot);
   const path = resolve19(context.projectRoot, ".rig", "state", "github-auth.json");
-  mkdirSync10(dirname4(path), { recursive: true });
-  writeFileSync7(path, `${JSON.stringify({
+  mkdirSync11(dirname5(path), { recursive: true });
+  writeFileSync8(path, `${JSON.stringify({
     authenticated: true,
     source,
     storedOnServer: true,
@@ -10343,13 +10866,46 @@ function parseConnection(alias, value, options) {
   }
   return { kind: "remote", baseUrl: parsed.toString().replace(/\/+$/, "") };
 }
-function printJsonOrText(context, payload, text2) {
-  if (context.outputMode === "json") {
-    console.log(JSON.stringify(payload, null, 2));
-  } else {
+function printJsonOrText(context, _payload, text2) {
+  if (context.outputMode !== "json") {
     console.log(text2);
   }
 }
+function formatRemoteProjectLinkText(result) {
+  return formatSuccessCard(result.ok ? "Remote project link ready" : "Remote project link needs repair", [
+    ["selected", result.alias ?? "remote"],
+    ["target", result.baseUrl ?? "unknown"],
+    ["repo", result.repoSlug ?? "owner/repo"],
+    ["status", result.status],
+    ...result.serverProjectRoot ? [["server root", result.serverProjectRoot]] : [],
+    ["next", result.ok ? result.next ?? "rig task list" : result.hint]
+  ]);
+}
+function parseRepairLinkArgs(rest, usage) {
+  let repoSlug;
+  let mode = "prepare-if-missing";
+  const pending = [...rest];
+  while (pending.length > 0) {
+    const token = pending.shift();
+    if (token === "--repo") {
+      const value = pending.shift()?.trim();
+      if (!value)
+        throw new CliError(`Missing --repo value. Usage: ${usage}`, 1);
+      const normalized = normalizeRepoSlug(value);
+      if (!normalized)
+        throw new CliError(`Invalid --repo value: ${value}`, 1, { hint: "Use the canonical owner/repo slug, e.g. `--repo humanity-org/humanwork`." });
+      repoSlug = normalized;
+    } else if (token === "--backfill-only") {
+      mode = "backfill-only";
+    } else if (token === "--prepare") {
+      mode = "prepare-if-missing";
+    } else {
+      throw new CliError(`Unexpected argument: ${String(token)}
+Usage: ${usage}`, 1);
+    }
+  }
+  return { repoSlug, mode };
+}
 async function promptForConnectionAlias(context) {
   const state = readGlobalConnections();
   const repo = readRepoConnection(context.projectRoot);
@@ -10403,37 +10959,67 @@ async function executeConnectionCommand(context, args, options) {
       }
       if (!alias)
         throw new CliError(`Missing alias. Usage: ${usageName(options)} use <alias|local>`, 1);
+      let selectedConnection = { kind: "local", mode: "auto" };
       if (alias !== "local") {
         const state = readGlobalConnections();
-        if (!state.connections[alias])
+        const connection = state.connections[alias];
+        if (!connection)
           throw new CliError(`Unknown Rig server: ${alias}`, 1, { hint: "Run `rig server list` to see saved aliases, or save one with `rig server add <alias> <url>`." });
+        selectedConnection = connection;
       }
       const previousRepo = readRepoConnection(context.projectRoot);
+      const preserveRemoteRoot = Boolean(previousRepo?.serverProjectRoot && previousRepo.selected === alias && selectedConnection.kind === "remote" && previousRepo.serverProjectRootAlias === alias && previousRepo.serverProjectRootBaseUrl === selectedConnection.baseUrl);
       const repoState = {
         selected: alias,
         ...previousRepo?.project ? { project: previousRepo.project } : {},
         linkedAt: new Date().toISOString(),
-        ...previousRepo?.serverProjectRoot && previousRepo.selected === alias ? { serverProjectRoot: previousRepo.serverProjectRoot } : {}
+        ...preserveRemoteRoot ? {
+          serverProjectRoot: previousRepo.serverProjectRoot,
+          serverProjectRootAlias: previousRepo.serverProjectRootAlias,
+          serverProjectRootBaseUrl: previousRepo.serverProjectRootBaseUrl
+        } : {}
       };
       writeRepoConnection(context.projectRoot, repoState);
-      printJsonOrText(context, repoState, formatSuccessCard("Rig server selected", [
+      const remoteProjectLink = alias !== "local" ? await ensureRemoteProjectRootLink(context.projectRoot, { mode: "backfill-only" }).catch((error) => ({
+        ok: false,
+        status: "error",
+        message: error instanceof Error ? error.message : String(error),
+        hint: "Run `rig server repair-link` after authenticating the selected remote."
+      })) : null;
+      const latestRepo = readRepoConnection(context.projectRoot);
+      const details = { selected: latestRepo?.selected ?? alias, repo: latestRepo, remoteProjectLink };
+      printJsonOrText(context, details, formatSuccessCard("Rig server selected", [
         ["selected", alias],
         ["scope", "this repo"],
-        ["next", "rig task list"]
+        ...remoteProjectLink ? [["remote link", remoteProjectLink.ok ? `ready (${remoteProjectLink.serverProjectRoot ?? "linked"})` : `${remoteProjectLink.status}: ${remoteProjectLink.hint}`]] : [],
+        ["next", remoteProjectLink && !remoteProjectLink.ok ? "rig server repair-link" : "rig task list"]
       ]));
-      return { ok: true, group: options.group, command: "use", details: repoState };
+      return { ok: true, group: options.group, command: "use", details };
+    }
+    case "repair-link": {
+      const parsed = parseRepairLinkArgs(rest, `${usageName(options)} repair-link [--prepare|--backfill-only] [--repo owner/repo]`);
+      const result = await repairRemoteProjectRootLink(context, parsed);
+      printJsonOrText(context, result, formatRemoteProjectLinkText(result));
+      return { ok: true, group: options.group, command: "repair-link", details: result };
     }
     case "status": {
       requireNoExtraArgs(rest, `${usageName(options)} status`);
       const repo = readRepoConnection(context.projectRoot);
       const global = readGlobalConnections();
-      const details = { selected: repo?.selected ?? "local", repo, connections: global.connections };
-      printJsonOrText(context, details, formatConnectionStatus(details.selected, global.connections));
+      const remoteProjectLink = repo?.selected && repo.selected !== "local" ? await ensureRemoteProjectRootLink(context.projectRoot, { mode: "backfill-only" }).catch((error) => ({
+        ok: false,
+        status: "error",
+        message: error instanceof Error ? error.message : String(error),
+        hint: "Run `rig server repair-link` after authenticating the selected remote."
+      })) : null;
+      const latestRepo = readRepoConnection(context.projectRoot) ?? repo;
+      const details = { selected: latestRepo?.selected ?? "local", repo: latestRepo, connections: global.connections, remoteProjectLink };
+      printJsonOrText(context, details, formatConnectionStatus(details.selected, global.connections, latestRepo ?? null, remoteProjectLink));
       return { ok: true, group: options.group, command: "status", details };
     }
     default:
       throw new CliError(`Unknown ${options.group} command: ${String(command)}
-Usage: ${usageName(options)} <list|add|use|status>`, 1);
+Usage: ${usageName(options)} <list|add|use|status|repair-link>`, 1);
   }
 }
 var init_connect = __esm(() => {
@@ -10441,13 +11027,14 @@ var init_connect = __esm(() => {
   init_runner();
   init__connection_state();
   init__cli_format();
+  init__server_client();
 });
 
 // packages/cli/src/commands/server.ts
 import { resolveRigServerCommand } from "@rig/runtime/local-server";
 async function executeServer(context, args, options) {
   const [command = "status", ...rest] = args;
-  if (["status", "list", "add", "use"].includes(command)) {
+  if (["status", "list", "add", "use", "repair-link"].includes(command)) {
     return executeConnectionCommand(context, [command, ...rest], { group: "server", interactiveUse: true });
   }
   switch (command) {
@@ -11234,7 +11821,7 @@ var init_task = __esm(() => {
 });
 
 // packages/cli/src/commands/task-run-driver.ts
-import { copyFileSync as copyFileSync3, existsSync as existsSync16, mkdirSync as mkdirSync11, readFileSync as readFileSync12, statSync as statSync2, writeFileSync as writeFileSync8 } from "fs";
+import { copyFileSync as copyFileSync3, existsSync as existsSync16, mkdirSync as mkdirSync12, readFileSync as readFileSync12, statSync as statSync2, writeFileSync as writeFileSync9 } from "fs";
 import { resolve as resolve24 } from "path";
 import { spawn as spawn2, spawnSync as spawnSync4 } from "child_process";
 import { createInterface as createLineInterface } from "readline";
@@ -11337,7 +11924,7 @@ function copyUntrackedDirtyFiles(sourceRoot, targetRoot) {
     try {
       if (!statSync2(sourcePath).isFile())
         continue;
-      mkdirSync11(resolve24(targetPath, ".."), { recursive: true });
+      mkdirSync12(resolve24(targetPath, ".."), { recursive: true });
       copyFileSync3(sourcePath, targetPath);
       copied += 1;
     } catch {}
@@ -12208,8 +12795,8 @@ async function executeRigOwnedTaskRun(context, input) {
     artifactPath: planningClassification.planningRequired ? planningArtifactPath : null,
     classifiedAt: new Date().toISOString()
   };
-  mkdirSync11(resolve24(context.projectRoot, ".rig", "runs", input.runId), { recursive: true });
-  writeFileSync8(resolve24(context.projectRoot, ".rig", "runs", input.runId, "planning-classification.json"), `${JSON.stringify(persistedPlanning, null, 2)}
+  mkdirSync12(resolve24(context.projectRoot, ".rig", "runs", input.runId), { recursive: true });
+  writeFileSync9(resolve24(context.projectRoot, ".rig", "runs", input.runId, "planning-classification.json"), `${JSON.stringify(persistedPlanning, null, 2)}
 `, "utf8");
   patchAuthorityRun(context.projectRoot, input.runId, { planning: persistedPlanning });
   prompt = `${prompt}
@@ -12356,8 +12943,8 @@ ${planningClassification.planningRequired ? `Before implementing, write a concis
         const dirty = applyDirtyBaselineSnapshot({ sourceRoot: context.projectRoot, targetRoot: latestRuntimeWorkspace });
         const readyFile = childEnv.RIG_DIRTY_BASELINE_READY_FILE;
         if (readyFile) {
-          mkdirSync11(resolve24(readyFile, ".."), { recursive: true });
-          writeFileSync8(readyFile, `${JSON.stringify({ ...dirty, workspaceDir: latestRuntimeWorkspace, appliedAt: new Date().toISOString() }, null, 2)}
+          mkdirSync12(resolve24(readyFile, ".."), { recursive: true });
+          writeFileSync9(readyFile, `${JSON.stringify({ ...dirty, workspaceDir: latestRuntimeWorkspace, appliedAt: new Date().toISOString() }, null, 2)}
 `, "utf8");
         }
         appendRunLog(context.projectRoot, input.runId, {
@@ -13303,7 +13890,7 @@ var init_test = __esm(() => {
 });
 
 // packages/cli/src/commands/setup.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync12, readdirSync as readdirSync3, writeFileSync as writeFileSync9 } from "fs";
+import { existsSync as existsSync17, mkdirSync as mkdirSync13, readdirSync as readdirSync3, writeFileSync as writeFileSync10 } from "fs";
 import { resolve as resolve25 } from "path";
 import { createPluginHost } from "@rig/core";
 import {
@@ -13358,12 +13945,12 @@ function runSetupInit(projectRoot) {
   const stateDir = resolveControlPlaneHostStateDir(projectRoot);
   const logsDir = resolveControlPlaneHostLogsDir(projectRoot);
   const artifactsDir = resolveControlPlaneArtifactsDir(projectRoot);
-  mkdirSync12(stateDir, { recursive: true });
-  mkdirSync12(logsDir, { recursive: true });
-  mkdirSync12(artifactsDir, { recursive: true });
+  mkdirSync13(stateDir, { recursive: true });
+  mkdirSync13(logsDir, { recursive: true });
+  mkdirSync13(artifactsDir, { recursive: true });
   const failuresPath = resolve25(stateDir, "failed_approaches.md");
   if (!existsSync17(failuresPath)) {
-    writeFileSync9(failuresPath, `# Failed Approaches
+    writeFileSync10(failuresPath, `# Failed Approaches
 
 `, "utf-8");
   }
@@ -15341,414 +15928,23 @@ async function runInitYes(ctx, args = ["--yes"]) {
 }
 var init_init2 = () => {};
 
-// packages/cli/src/app-opentui/pi-pty-host.ts
-import { fileURLToPath as fileURLToPath2 } from "url";
-import { basename as basename4 } from "path";
-import { RGBA, StyledText, TextAttributes } from "@opentui/core";
-import { Terminal as XtermTerminal2 } from "@xterm/headless";
-function clampCols2(cols) {
-  return Math.max(MIN_COLS2, Math.trunc(cols || 100));
-}
-function clampRows2(rows) {
-  return Math.max(MIN_ROWS2, Math.min(MAX_ROWS2, Math.trunc(rows || 35)));
-}
-function rgbaFromXtermColor(mode, value) {
-  if (mode === 1 || mode === 2 || mode === XTERM_COLOR_MODE_INDEXED_16 || mode === XTERM_COLOR_MODE_INDEXED_256) {
-    return RGBA.fromIndex(value);
-  }
-  if (mode === 3 || mode === XTERM_COLOR_MODE_RGB) {
-    return RGBA.fromInts(value >> 16 & 255, value >> 8 & 255, value & 255);
-  }
-  return;
-}
-function textAttributesFromCell(cell) {
-  let attributes = TextAttributes.NONE;
-  if (cell.isBold())
-    attributes |= TextAttributes.BOLD;
-  if (cell.isDim())
-    attributes |= TextAttributes.DIM;
-  if (cell.isItalic())
-    attributes |= TextAttributes.ITALIC;
-  if (cell.isUnderline())
-    attributes |= TextAttributes.UNDERLINE;
-  if (cell.isBlink())
-    attributes |= TextAttributes.BLINK;
-  if (cell.isInverse())
-    attributes |= TextAttributes.INVERSE;
-  if (cell.isInvisible())
-    attributes |= TextAttributes.HIDDEN;
-  if (cell.isStrikethrough())
-    attributes |= TextAttributes.STRIKETHROUGH;
-  return attributes;
-}
-function sameRgba(a, b) {
-  if (!a && !b)
-    return true;
-  return Boolean(a && b && a.equals(b));
-}
-function sameStyle(a, b) {
-  return sameRgba(a.fg, b.fg) && sameRgba(a.bg, b.bg) && (a.attributes ?? 0) === (b.attributes ?? 0);
-}
-function styleFromCell(cell) {
-  return {
-    fg: rgbaFromXtermColor(cell.getFgColorMode(), cell.getFgColor()),
-    bg: rgbaFromXtermColor(cell.getBgColorMode(), cell.getBgColor()),
-    attributes: textAttributesFromCell(cell)
-  };
-}
-function lineToStyledText(line, cols) {
-  if (!line)
-    return new StyledText([{ __isChunk: true, text: "" }]);
-  const chunks = [];
-  let run = "";
-  let runStyle = null;
-  const flush = () => {
-    if (!run)
-      return;
-    chunks.push({
-      __isChunk: true,
-      text: run,
-      ...runStyle?.fg ? { fg: runStyle.fg } : {},
-      ...runStyle?.bg ? { bg: runStyle.bg } : {},
-      ...(runStyle?.attributes ?? 0) !== 0 ? { attributes: runStyle.attributes } : {}
-    });
-    run = "";
-  };
-  for (let index = 0;index < cols; index += 1) {
-    const cell = line.getCell(index);
-    if (!cell) {
-      if (runStyle !== null)
-        flush();
-      runStyle = null;
-      run += " ";
-      continue;
-    }
-    if (cell.getWidth() === 0)
-      continue;
-    const style = styleFromCell(cell);
-    if (!runStyle || !sameStyle(runStyle, style)) {
-      flush();
-      runStyle = style;
-    }
-    run += cell.getChars() || " ";
-  }
-  flush();
-  return new StyledText(chunks.length > 0 ? chunks : [{ __isChunk: true, text: "" }]);
-}
-function childCommandPrefix2() {
-  const execName = basename4(process.execPath).toLowerCase();
-  const currentEntry = process.argv[1];
-  if (execName === "bun" || execName === "bun.exe") {
-    return currentEntry ? [process.execPath, currentEntry, "__opentui-pi-host"] : [process.execPath, fallbackChildScriptPath];
-  }
-  return [process.execPath, "__opentui-pi-host"];
-}
-function withEnv2(base) {
-  const env = {};
-  for (const [key, value] of Object.entries(base ?? process.env)) {
-    if (key === "RIG_PLAIN" || key === "RIG_CLI_PLAIN_HELP" || key === "NO_COLOR")
-      continue;
-    if (typeof value === "string")
-      env[key] = value;
-  }
-  return {
-    ...env,
-    TERM: "xterm-256color",
-    COLORTERM: "truecolor",
-    FORCE_COLOR: env.FORCE_COLOR ?? "1",
-    RIG_OPENTUI_PI_HOST: "1"
-  };
-}
-function getActivePiHost() {
-  return activeHost2 && !activeHost2.disposed ? activeHost2 : null;
-}
-async function startPiPtyHost(options) {
-  activeHost2?.dispose("replace");
-  const host = new PiPtyHost(options);
-  activeHost2 = host;
-  await host.start();
-  return host;
-}
-function stopActivePiHost(reason = "detach") {
-  activeHost2?.dispose(reason);
-  activeHost2 = null;
-}
-
-class PiPtyHost {
-  runId;
-  projectRoot;
-  onSnapshot;
-  onExit;
-  onError;
-  terminal;
-  disposables = [];
-  decoder = new TextDecoder("utf-8");
-  proc = null;
-  pty = null;
-  status = "starting";
-  cols;
-  rows;
-  message = "starting bundled Pi";
-  lastResizeError = null;
-  exitCode;
-  signal;
-  notifyTimer = null;
-  lastStreamKey = "";
-  _disposed = false;
-  constructor(options) {
-    this.runId = options.runId;
-    this.projectRoot = options.projectRoot;
-    this.cols = clampCols2(options.cols);
-    this.rows = clampRows2(options.rows);
-    this.onSnapshot = options.onSnapshot;
-    this.onExit = options.onExit;
-    this.onError = options.onError;
-    this.terminal = new XtermTerminal2({
-      allowProposedApi: true,
-      cols: this.cols,
-      rows: this.rows,
-      scrollback: 1000
-    });
-    this.registerTerminalResponders();
-    this.disposables.push(this.terminal.onWriteParsed(() => {
-      if (this._disposed)
-        return;
-      const snapshot = this.createSnapshot();
-      const key = snapshot.lines.join(`
-`);
-      if (key === this.lastStreamKey)
-        return;
-      this.lastStreamKey = key;
-      this.onSnapshot?.(snapshot);
-    }));
-  }
-  get disposed() {
-    return this._disposed;
-  }
-  get snapshot() {
-    return this.createSnapshot();
-  }
-  async start() {
-    if (this._disposed)
-      throw new Error("Pi PTY host is disposed.");
-    if (typeof Bun.Terminal !== "function") {
-      throw new Error("Bun native PTY is unavailable in this runtime. Pi host requires Bun.Terminal.");
-    }
-    const spawnOptions = {
-      cwd: this.projectRoot,
-      env: withEnv2(process.env),
-      terminal: {
-        cols: this.cols,
-        rows: this.rows,
-        name: "xterm-256color",
-        data: (_terminal, data) => this.handlePtyData(data)
-      }
-    };
-    const proc = Bun.spawn([
-      ...childCommandPrefix2(),
-      "--run-id",
-      this.runId,
-      "--project-root",
-      this.projectRoot
-    ], spawnOptions);
-    if (!proc.terminal)
-      throw new Error("Bun did not attach a terminal to the bundled Pi child process.");
-    this.proc = proc;
-    this.pty = proc.terminal;
-    this.status = "running";
-    this.message = "bundled Pi running inside this app";
-    this.emitSnapshotSoon(0);
-    proc.exited.then((exitCode) => {
-      if (this._disposed)
-        return;
-      this.status = exitCode === 0 ? "exited" : "failed";
-      this.exitCode = exitCode;
-      this.signal = null;
-      this.message = exitCode === 0 ? "bundled Pi exited" : `bundled Pi exited with code ${exitCode}`;
-      const snapshot = this.createSnapshot();
-      this.onSnapshot?.(snapshot);
-      this.onExit?.(snapshot);
-      if (activeHost2 === this)
-        activeHost2 = null;
-      this.dispose("exit", { kill: false, notify: false });
-    }).catch((error) => {
-      if (this._disposed)
-        return;
-      this.status = "failed";
-      this.message = error instanceof Error ? error.message : String(error);
-      const snapshot = this.createSnapshot();
-      this.onSnapshot?.(snapshot);
-      this.onError?.(error, snapshot);
-      if (activeHost2 === this)
-        activeHost2 = null;
-      this.dispose("error", { kill: false, notify: false });
-    });
-  }
-  write(data) {
-    if (this._disposed || !this.pty)
-      return;
-    try {
-      this.pty.write(data);
-    } catch (error) {
-      this.status = "failed";
-      this.message = error instanceof Error ? error.message : String(error);
-      const snapshot = this.createSnapshot();
-      this.onSnapshot?.(snapshot);
-      this.onError?.(error, snapshot);
-    }
-  }
-  resize(cols, rows) {
-    const nextCols = clampCols2(cols);
-    const nextRows = clampRows2(rows);
-    if (nextCols === this.cols && nextRows === this.rows)
-      return;
-    this.cols = nextCols;
-    this.rows = nextRows;
-    this.terminal.resize(nextCols, nextRows);
-    try {
-      this.pty?.resize(nextCols, nextRows);
-      this.lastResizeError = null;
-    } catch (error) {
-      this.lastResizeError = error instanceof Error ? error.message : String(error);
-    }
-    this.emitSnapshotSoon(0);
-  }
-  detach() {
-    this.dispose("detach");
-    return this.createSnapshot("detached from bundled Pi");
-  }
-  dispose(reason = "dispose", options = {}) {
-    if (this._disposed)
-      return;
-    this._disposed = true;
-    if (this.notifyTimer)
-      clearTimeout(this.notifyTimer);
-    this.notifyTimer = null;
-    for (const disposable of this.disposables.splice(0)) {
-      try {
-        disposable.dispose();
-      } catch {}
-    }
-    if (options.kill !== false) {
-      try {
-        this.proc?.kill("SIGTERM");
-      } catch {}
-    }
-    try {
-      this.pty?.close();
-    } catch {}
-    try {
-      this.terminal.dispose();
-    } catch {}
-    if (activeHost2 === this)
-      activeHost2 = null;
-    if (options.notify) {
-      this.message = reason;
-      this.onSnapshot?.(this.createSnapshot(reason));
-    }
-  }
-  handlePtyData(data) {
-    if (this._disposed)
-      return;
-    const text2 = this.decoder.decode(data, { stream: true });
-    this.respondToRawTerminalQueries(text2);
-    this.terminal.write(data);
-  }
-  emitSnapshotSoon(delayMs = SNAPSHOT_DELAY_MS2) {
-    if (this._disposed || this.notifyTimer)
-      return;
-    this.notifyTimer = setTimeout(() => {
-      this.notifyTimer = null;
-      if (this._disposed)
-        return;
-      this.onSnapshot?.(this.createSnapshot());
-    }, delayMs);
-  }
-  createSnapshot(message2 = this.message) {
-    const buffer = this.terminal.buffer.active;
-    const end = buffer.length;
-    const start = Math.max(0, end - MAX_SNAPSHOT_LINES2);
-    const styledStart = Math.max(start, end - this.rows - STYLED_SNAPSHOT_MARGIN);
-    const lines = [];
-    const styledLines = [];
-    for (let row = start;row < end; row += 1) {
-      const line = buffer.getLine(row);
-      lines.push((line?.translateToString(false) ?? "").slice(0, this.cols));
-      if (row >= styledStart)
-        styledLines[lines.length - 1] = lineToStyledText(line, this.cols);
-    }
-    while (lines.length < this.rows) {
-      lines.push("");
-      styledLines[lines.length - 1] = new StyledText([{ __isChunk: true, text: "" }]);
-    }
-    const resolvedMessage = this.lastResizeError ? `resize degraded: ${this.lastResizeError}` : message2;
-    return {
-      runId: this.runId,
-      status: this.status,
-      cols: this.cols,
-      rows: this.rows,
-      lines,
-      styledLines,
-      message: resolvedMessage,
-      ...this.lastResizeError ? { resizeError: this.lastResizeError } : {},
-      ...this.exitCode !== undefined ? { exitCode: this.exitCode } : {},
-      ...this.signal !== undefined ? { signal: this.signal } : {}
-    };
-  }
-  registerTerminalResponders() {
-    this.disposables.push(this.terminal.parser.registerCsiHandler({ final: "c" }, (params) => {
-      if (params.length === 0 || params[0] === 0)
-        this.write("\x1B[?62;22c");
-      return false;
-    }));
-    this.disposables.push(this.terminal.parser.registerCsiHandler({ prefix: ">", final: "c" }, (params) => {
-      if (params.length === 0 || params[0] === 0)
-        this.write("\x1B[>0;0;0c");
-      return false;
-    }));
-    this.disposables.push(this.terminal.parser.registerCsiHandler({ final: "n" }, (params) => {
-      if (params[0] === 5) {
-        this.write("\x1B[0n");
-      } else if (params[0] === 6) {
-        const row = this.terminal.buffer.active.cursorY + 1;
-        const col = this.terminal.buffer.active.cursorX + 1;
-        this.write(`\x1B[${row};${col}R`);
-      }
-      return false;
-    }));
-  }
-  respondToRawTerminalQueries(text2) {
-    if (!text2)
-      return;
-    const decrqm = /\x1b\[\?(\d+)\$p/g;
-    let match;
-    while ((match = decrqm.exec(text2)) !== null) {
-      this.write(`\x1B[?${match[1]};2$y`);
-    }
-  }
-}
-var MIN_COLS2 = 40, MIN_ROWS2 = 12, MAX_ROWS2 = 300, MAX_SNAPSHOT_LINES2 = 360, STYLED_SNAPSHOT_MARGIN = 6, SNAPSHOT_DELAY_MS2 = 120, fallbackChildScriptPath, activeHost2 = null, XTERM_COLOR_MODE_INDEXED_16 = 16777216, XTERM_COLOR_MODE_INDEXED_256 = 33554432, XTERM_COLOR_MODE_RGB = 50331648;
-var init_pi_pty_host = __esm(() => {
-  fallbackChildScriptPath = fileURLToPath2(new URL("./pi-host-child.ts", import.meta.url));
-});
-
-// packages/cli/src/app-opentui/adapters/inspect.ts
-var exports_inspect = {};
-__export(exports_inspect, {
-  loadInspectRuns: () => loadInspectRuns,
-  loadInspect: () => loadInspect,
-  INSPECT_VIEWS: () => INSPECT_VIEWS
-});
-import { execFile } from "child_process";
-import { existsSync as existsSync21, readFileSync as readFileSync14, readdirSync as readdirSync5, statSync as statSync4 } from "fs";
-import { resolve as resolve28 } from "path";
-import { promisify } from "util";
-import { resolveTaskArtifactDirs as resolveTaskArtifactDirs3 } from "@rig/runtime/control-plane/authority-files";
-import { readTaskArtifactPreview as readTaskArtifactPreview2 } from "@rig/runtime/control-plane/native/workspace-ops";
-import { resolveHarnessPaths as resolveHarnessPaths3, resolveMonorepoRoot as resolveMonorepoRoot3, runCapture as runCapture4 } from "@rig/runtime/control-plane/native/utils";
-function isFailureEntry(entry) {
-  const status = `${entry.status ?? entry.level ?? entry.type ?? ""}`.toLowerCase();
-  return status.includes("fail") || status.includes("error");
+// packages/cli/src/app-opentui/adapters/inspect.ts
+var exports_inspect = {};
+__export(exports_inspect, {
+  loadInspectRuns: () => loadInspectRuns,
+  loadInspect: () => loadInspect,
+  INSPECT_VIEWS: () => INSPECT_VIEWS
+});
+import { execFile } from "child_process";
+import { existsSync as existsSync21, readFileSync as readFileSync14, readdirSync as readdirSync5, statSync as statSync4 } from "fs";
+import { resolve as resolve28 } from "path";
+import { promisify } from "util";
+import { resolveTaskArtifactDirs as resolveTaskArtifactDirs3 } from "@rig/runtime/control-plane/authority-files";
+import { readTaskArtifactPreview as readTaskArtifactPreview2 } from "@rig/runtime/control-plane/native/workspace-ops";
+import { resolveHarnessPaths as resolveHarnessPaths3, resolveMonorepoRoot as resolveMonorepoRoot3, runCapture as runCapture4 } from "@rig/runtime/control-plane/native/utils";
+function isFailureEntry(entry) {
+  const status = `${entry.status ?? entry.level ?? entry.type ?? ""}`.toLowerCase();
+  return status.includes("fail") || status.includes("error");
 }
 async function gitDiff(projectRoot) {
   try {
@@ -15954,14 +16150,6 @@ function recordStep(ctx, runId, label, emitLabel) {
   });
   emitProgress(ctx, emitLabel, label);
 }
-function settleSteps(ctx, runId) {
-  const now = Date.now();
-  const previous = currentAttachState(ctx, runId);
-  if (!previous?.steps)
-    return;
-  const steps = previous.steps.map((step) => step.status === "running" ? { ...step, status: "done", endedAtMs: step.endedAtMs ?? now } : step);
-  patchData(ctx, { piAttach: { ...previous, steps } });
-}
 async function preparePiAttachHandoff(ctx, runId) {
   const cleanRunId = runId.trim();
   const label = `Preparing Pi ${cleanRunId.slice(0, 8)}`;
@@ -16009,85 +16197,41 @@ async function attachRunWithBundledPi(ctx, runId) {
     throw error;
   }
   emitStarted(ctx, label, { piAttach: { runId: cleanRunId, status: "entering-pi" } });
-  patchData(ctx, { piAttach: { runId: cleanRunId, status: "entering-pi", message: "starting bundled Pi", steps: [] } });
+  patchData(ctx, { piAttach: { runId: cleanRunId, status: "entering-pi", message: "handing the terminal to worker Pi\u2026" } });
+  const projectRoot = projectRootOf(ctx);
+  const outputMode = ctx.rig?.outputMode ?? "text";
+  await releaseRendererForExternalTui(ctx);
+  let outcome = null;
+  let attachError = null;
   try {
-    recordStep(ctx, cleanRunId, "connecting to server and fetching run transcript", label);
-    await preparePiAttachHandoff(ctx, cleanRunId).catch((error) => {
-      patchData(ctx, { lastRefreshError: normalizeAppError(error).message });
-      return null;
-    });
-    recordStep(ctx, cleanRunId, "spawning Bun PTY host for bundled Pi", label);
-    const projectRoot = projectRootOf(ctx);
-    const cols = typeof process.stdout.columns === "number" ? process.stdout.columns : 100;
-    const rows = Math.max(1, (typeof process.stdout.rows === "number" ? process.stdout.rows : 35) - 1);
-    const patchTerminal = (snapshot) => {
-      const previousSteps = currentAttachState(ctx, cleanRunId)?.steps;
-      const failed = snapshot.status === "failed";
-      const reason = failed ? snapshot.message ?? `bundled Pi exited with code ${snapshot.exitCode ?? "unknown"}` : undefined;
-      patchData(ctx, {
-        piTerminal: snapshot,
-        piAttach: {
-          runId: cleanRunId,
-          status: failed ? "failed" : snapshot.status === "exited" ? "returned" : "entering-pi",
-          message: snapshot.message ?? "bundled Pi running",
-          result: { runId: cleanRunId, status: snapshot.status, exitCode: snapshot.exitCode },
-          ...previousSteps ? { steps: previousSteps } : {},
-          ...reason ? { failureReason: reason } : {}
-        }
-      });
-    };
-    recordStep(ctx, cleanRunId, "starting bundled Pi", label);
-    await startPiPtyHost({
-      runId: cleanRunId,
-      projectRoot,
-      cols,
-      rows,
-      onSnapshot: (snapshot) => {
-        if (snapshot.status === "running" && snapshot.lines.some((entry) => entry.trim().length > 0)) {
-          settleSteps(ctx, cleanRunId);
-        }
-        patchTerminal(snapshot);
-      },
-      onExit: (snapshot) => {
-        patchTerminal(snapshot);
-        if (snapshot.status === "failed") {
-          Promise.resolve().then(() => (init_inspect2(), exports_inspect)).then(({ loadInspect: loadInspect2 }) => loadInspect2(ctx, cleanRunId)).catch(() => null);
-          emitFailed(ctx, label, new Error(snapshot.message ?? `bundled Pi exited with code ${snapshot.exitCode ?? "unknown"}`), { runId: cleanRunId, result: { status: snapshot.status, exitCode: snapshot.exitCode } });
-          return;
-        }
-        emitCompleted(ctx, label, { runId: cleanRunId, result: { status: snapshot.status, exitCode: snapshot.exitCode } });
-        ctx.emit({ type: "scene.change", scene: "fleet", intent: { scene: "fleet", argv: ["runs"], action: { kind: "refresh", label: "Opening runs" } } });
-        refreshFleet(ctx).catch((error) => emitFailed(ctx, "Refresh runs", error));
-      },
-      onError: (error, snapshot) => {
-        patchTerminal(snapshot);
-        emitFailed(ctx, label, error, { runId: cleanRunId });
-      }
-    });
-    const record = {
-      runId: cleanRunId,
-      status: "running",
-      rendered: "bundled Pi embedded via Bun.Terminal + @xterm/headless"
-    };
-    emitProgress(ctx, label, "bundled Pi is running", { piAttach: { runId: cleanRunId, status: "entering-pi", message: "bundled Pi running", result: record } });
-    return record;
+    const { attachRunBundledPiFrontend: attachRunBundledPiFrontend2 } = await Promise.resolve().then(() => (init__pi_frontend(), exports__pi_frontend));
+    outcome = await attachRunBundledPiFrontend2({ projectRoot, outputMode }, { runId: cleanRunId, returnOnQuit: true });
   } catch (error) {
-    const reason = error instanceof Error ? error.message : String(error);
+    attachError = error;
+  } finally {
+    await resumeRendererAfterExternalTui(ctx);
+  }
+  if (attachError) {
+    const reason = normalizeAppError(attachError).message;
     patchData(ctx, {
-      piAttach: {
-        runId: cleanRunId,
-        status: "failed",
-        message: reason,
-        failureReason: reason,
-        ...currentAttachState(ctx, cleanRunId)?.steps ? { steps: currentAttachState(ctx, cleanRunId).steps } : {}
-      }
+      piTerminal: undefined,
+      piAttach: { runId: cleanRunId, status: "failed", message: reason, failureReason: reason }
     });
-    emitFailed(ctx, label, error, { runId: cleanRunId });
-    throw error;
+    Promise.resolve().then(() => (init_inspect2(), exports_inspect)).then(({ loadInspect: loadInspect2 }) => loadInspect2(ctx, cleanRunId)).catch(() => null);
+    emitFailed(ctx, label, attachError, { runId: cleanRunId });
+    throw attachError;
   }
+  const detached = outcome?.detached === true;
+  patchData(ctx, {
+    piTerminal: undefined,
+    piAttach: { runId: cleanRunId, status: "returned", message: detached ? "detached from worker Pi" : "returned from worker Pi" }
+  });
+  emitCompleted(ctx, label, { runId: cleanRunId, result: { runId: cleanRunId, detached } });
+  ctx.emit({ type: "scene.change", scene: "fleet", intent: { scene: "fleet", argv: ["runs"], action: { kind: "refresh", label: "Opening runs" } } });
+  refreshFleet(ctx).catch((error) => emitFailed(ctx, "Refresh runs", error));
+  return { runId: cleanRunId, status: "returned", detached };
 }
 var init_pi_attach = __esm(() => {
-  init_pi_pty_host();
   init_fleet();
 });
 
@@ -16684,6 +16828,7 @@ var LOG_PAGE = 100, TIMELINE_PAGE = 200;
 var init_run_detail = () => {};
 
 // packages/cli/src/app-opentui/adapters/server.ts
+import { spawnSync as spawnSync5 } from "child_process";
 function withTimeout(promise, ms, label) {
   return new Promise((resolve29, reject) => {
     const timer = setTimeout(() => reject(new Error(`${label} timed out after ${ms}ms`)), ms);
@@ -16720,11 +16865,128 @@ function startLocalRequested(ctx) {
   const action = intent.action;
   return action?.payload?.startLocal === true;
 }
+async function serverAliases(projectRoot) {
+  const { readGlobalConnections: readGlobalConnections2, readRepoConnection: readRepoConnection2 } = await Promise.resolve().then(() => (init__connection_state(), exports__connection_state));
+  const selected = readRepoConnection2(projectRoot)?.selected ?? "local";
+  const global = readGlobalConnections2();
+  const aliases = [{ alias: "local", kind: "local", selected: selected === "local" }];
+  for (const [alias, connection] of Object.entries(global.connections)) {
+    aliases.push({
+      alias,
+      kind: connection.kind,
+      ...connection.kind === "remote" ? { baseUrl: connection.baseUrl } : {},
+      selected: alias === selected
+    });
+  }
+  return aliases;
+}
+function firstString2(parts, offset = 0) {
+  return parts.slice(offset).find((part) => part.trim() && !part.startsWith("-"))?.trim();
+}
+function normalizeUrl(value) {
+  const trimmed = value?.trim().replace(/\/+$/, "");
+  if (!trimmed)
+    return;
+  return /^https?:\/\//i.test(trimmed) ? trimmed : undefined;
+}
+async function useLocalServerFromApp(ctx) {
+  const label = "Selecting local server";
+  emitStarted(ctx, label);
+  try {
+    const projectRoot = projectRootOf(ctx);
+    const { readRepoConnection: readRepoConnection2, writeRepoConnection: writeRepoConnection2 } = await Promise.resolve().then(() => (init__connection_state(), exports__connection_state));
+    const previous = readRepoConnection2(projectRoot);
+    writeRepoConnection2(projectRoot, {
+      selected: "local",
+      ...previous?.project ? { project: previous.project } : {},
+      linkedAt: new Date().toISOString()
+    });
+    emitCompleted(ctx, label, { selected: "local" });
+    return refreshServerStatus(ctx);
+  } catch (error) {
+    emitFailed(ctx, label, error);
+    throw error;
+  }
+}
+async function useRemoteServerFromApp(ctx, alias) {
+  const label = alias ? `Selecting remote ${alias}` : "Selecting remote server";
+  emitStarted(ctx, label);
+  try {
+    const cleanAlias = alias?.trim();
+    if (!cleanAlias)
+      throw new Error("Enter a saved remote alias, or add one with: add remote \u2192 <alias> <https-url>.");
+    const projectRoot = projectRootOf(ctx);
+    const { readGlobalConnections: readGlobalConnections2, readRepoConnection: readRepoConnection2, writeRepoConnection: writeRepoConnection2 } = await Promise.resolve().then(() => (init__connection_state(), exports__connection_state));
+    const connection = readGlobalConnections2().connections[cleanAlias];
+    if (!connection)
+      throw new Error(`Remote alias ${cleanAlias} is not saved yet. Use add remote first.`);
+    if (connection.kind !== "remote")
+      throw new Error(`${cleanAlias} is not a remote server alias.`);
+    const previous = readRepoConnection2(projectRoot);
+    writeRepoConnection2(projectRoot, {
+      selected: cleanAlias,
+      ...previous?.project ? { project: previous.project } : {},
+      linkedAt: new Date().toISOString()
+    });
+    emitCompleted(ctx, label, { selected: cleanAlias, baseUrl: connection.baseUrl });
+    return refreshServerStatus(ctx);
+  } catch (error) {
+    emitFailed(ctx, label, error);
+    throw error;
+  }
+}
+async function addRemoteServerFromApp(ctx, args) {
+  const label = "Adding remote server";
+  emitStarted(ctx, label);
+  try {
+    const alias = firstString2(args, 2);
+    const url = normalizeUrl(firstString2(args, alias ? args.indexOf(alias) + 1 : 3));
+    if (!alias || !url)
+      throw new Error("Add remote expects: <alias> <https-url>. Example: prod https://rig.example.com");
+    const projectRoot = projectRootOf(ctx);
+    const { readRepoConnection: readRepoConnection2, upsertGlobalConnection: upsertGlobalConnection2, writeRepoConnection: writeRepoConnection2 } = await Promise.resolve().then(() => (init__connection_state(), exports__connection_state));
+    upsertGlobalConnection2(alias, { kind: "remote", baseUrl: url });
+    const previous = readRepoConnection2(projectRoot);
+    writeRepoConnection2(projectRoot, {
+      selected: alias,
+      ...previous?.project ? { project: previous.project } : {},
+      linkedAt: new Date().toISOString()
+    });
+    emitCompleted(ctx, label, { alias, baseUrl: url });
+    return refreshServerStatus(ctx);
+  } catch (error) {
+    emitFailed(ctx, label, error);
+    throw error;
+  }
+}
+async function importGitHubAuthFromGhApp(ctx) {
+  const label = "Importing GitHub auth";
+  emitStarted(ctx, label);
+  try {
+    const projectRoot = projectRootOf(ctx);
+    const token = spawnSync5("gh", ["auth", "token"], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 1e4 }).stdout.trim();
+    if (!token)
+      throw new Error("Could not read GitHub token from gh. Sign in with gh auth login, then retry import auth.");
+    const runtime = await runtimeOf(ctx);
+    const { postGitHubTokenViaServer: postGitHubTokenViaServer2, setGitHubBearerTokenForCurrentProcess: setGitHubBearerTokenForCurrentProcess2 } = await Promise.resolve().then(() => (init__server_client(), exports__server_client));
+    const { readRepoConnection: readRepoConnection2 } = await Promise.resolve().then(() => (init__connection_state(), exports__connection_state));
+    const selectedRepo = readRepoConnection2(projectRoot)?.project;
+    const payload = await postGitHubTokenViaServer2(runtime, token, selectedRepo ? { selectedRepo } : {});
+    const apiSessionToken = payload && typeof payload === "object" && !Array.isArray(payload) ? payload.apiSessionToken : undefined;
+    setGitHubBearerTokenForCurrentProcess2(typeof apiSessionToken === "string" ? apiSessionToken : token, projectRoot);
+    emitCompleted(ctx, label, { selectedRepo: selectedRepo ?? null });
+    return refreshServerStatus(ctx);
+  } catch (error) {
+    emitFailed(ctx, label, error);
+    throw error;
+  }
+}
 async function startLocalServerFromApp(ctx) {
   const label = "Starting local server";
   emitStarted(ctx, label);
   patchData(ctx, {
     lastIntent: undefined,
+    remoteProjectLink: undefined,
     server: { label: "starting local server", reachable: false, error: "spawning local rig-server (detached)\u2026" }
   });
   try {
@@ -16749,32 +17011,61 @@ async function startLocalServerFromApp(ctx) {
       reachable: false,
       error: error instanceof Error ? error.message : String(error)
     };
-    patchData(ctx, { server: state, lastRefreshError: state.error });
+    patchData(ctx, { server: state, remoteProjectLink: undefined, lastRefreshError: state.error });
     patchFooter(ctx, { server: "unavailable" });
-    emitCompleted(ctx, label, { server: state.label, reachable: false, error: state.error });
+    emitCompleted(ctx, label, { serverLabel: state.label, reachable: false, error: state.error });
     return state;
   }
 }
+async function repairRemoteProjectRootLinkFromApp(ctx) {
+  const label = "Repairing remote project link";
+  emitStarted(ctx, label);
+  try {
+    const projectRoot = projectRootOf(ctx);
+    const { ensureRemoteProjectRootLink: ensureRemoteProjectRootLink2 } = await Promise.resolve().then(() => (init__server_client(), exports__server_client));
+    emitProgress(ctx, label, "backfilling or preparing server-host checkout");
+    const result = await ensureRemoteProjectRootLink2(projectRoot, { mode: "prepare-if-missing" });
+    patchData(ctx, { remoteProjectLink: result, server: { label: result.alias ?? "remote", baseUrl: result.baseUrl, kind: "remote", reachable: result.status !== "not_remote", remoteProjectLink: result } });
+    patchFooter(ctx, { server: result.alias ?? "remote", message: `remote link ${result.status}` });
+    if (!result.ok) {
+      const error = new Error(result.message);
+      error.hint = result.hint;
+      patchData(ctx, { lastRefreshError: result.message });
+      throw error;
+    }
+    emitCompleted(ctx, label, { repoSlug: result.repoSlug, serverProjectRoot: result.serverProjectRoot, status: result.status });
+    return result;
+  } catch (error) {
+    const message2 = error instanceof Error ? error.message : String(error);
+    const existing = ctx.getState().data?.remoteProjectLink;
+    const remoteProjectLink = existing && typeof existing === "object" && !Array.isArray(existing) ? existing : { ok: false, status: "error", message: message2 };
+    patchData(ctx, { lastRefreshError: message2, remoteProjectLink });
+    emitCompleted(ctx, label, { ok: false, error: message2, remoteProjectLink });
+    throw error;
+  }
+}
 async function refreshServerStatus(ctx) {
   if (startLocalRequested(ctx)) {
     return startLocalServerFromApp(ctx);
   }
   const label = "Checking server";
   emitStarted(ctx, label);
-  patchData(ctx, { server: { label: "checking selected server", reachable: false, error: "checking selected server\u2026" } });
+  patchData(ctx, { server: { label: "checking selected server", reachable: false, error: "checking selected server\u2026" }, remoteProjectLink: undefined });
   const started = Date.now();
   try {
-    const { ensureServerForCli: ensureServerForCli2, requestServerJson: requestServerJson2, resolveServerConnectionLabel: resolveServerConnectionLabel2 } = await Promise.resolve().then(() => (init__server_client(), exports__server_client));
+    const { ensureRemoteProjectRootLink: ensureRemoteProjectRootLink2, ensureServerForCli: ensureServerForCli2, requestServerJson: requestServerJson2, resolveServerConnectionLabel: resolveServerConnectionLabel2 } = await Promise.resolve().then(() => (init__server_client(), exports__server_client));
     const projectRoot = projectRootOf(ctx);
+    const aliases = await serverAliases(projectRoot);
     emitProgress(ctx, label, "resolving selected server");
     const [connectionLabel, server] = await Promise.all([
       resolveServerConnectionLabel2(projectRoot),
       withTimeout(ensureServerForCli2(projectRoot), 5000, "server connection")
     ]);
     emitProgress(ctx, label, "requesting server status", { baseUrl: server.baseUrl, kind: server.connectionKind });
-    const [status, auth] = await Promise.all([
+    const [status, auth, remoteProjectLink] = await Promise.all([
       withRetry("server status", () => withTimeout(requestServerJson2({ projectRoot }, "/api/server/status"), SERVER_PROBE_TIMEOUT_MS, "server status")).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error) })),
-      withRetry("github auth status", () => withTimeout(requestServerJson2({ projectRoot }, "/api/github/auth/status"), SERVER_PROBE_TIMEOUT_MS, "github auth status")).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error) }))
+      withRetry("github auth status", () => withTimeout(requestServerJson2({ projectRoot }, "/api/github/auth/status"), SERVER_PROBE_TIMEOUT_MS, "github auth status")).catch((error) => ({ ok: false, error: error instanceof Error ? error.message : String(error) })),
+      server.connectionKind === "remote" ? withTimeout(ensureRemoteProjectRootLink2(projectRoot, { mode: "backfill-only", authToken: server.authToken }), SERVER_PROBE_TIMEOUT_MS, "remote project link").catch((error) => ({ ok: false, status: "error", message: error instanceof Error ? error.message : String(error) })) : Promise.resolve(null)
     ]);
     const state = {
       label: connectionLabel,
@@ -16783,22 +17074,25 @@ async function refreshServerStatus(ctx) {
       reachable: true,
       latencyMs: Date.now() - started,
       status: status && typeof status === "object" && !Array.isArray(status) ? status : {},
-      auth: auth && typeof auth === "object" && !Array.isArray(auth) ? auth : {}
+      auth: auth && typeof auth === "object" && !Array.isArray(auth) ? auth : {},
+      aliases,
+      ...remoteProjectLink && typeof remoteProjectLink === "object" && !Array.isArray(remoteProjectLink) ? { remoteProjectLink } : {}
     };
-    patchData(ctx, { server: state });
+    patchData(ctx, { server: state, remoteProjectLink: state.remoteProjectLink });
     patchFooter(ctx, { server: connectionLabel, latency: `${state.latencyMs}ms` });
-    emitCompleted(ctx, label, { server: connectionLabel, latencyMs: state.latencyMs });
+    emitCompleted(ctx, label, { serverLabel: connectionLabel, latencyMs: state.latencyMs });
     return state;
   } catch (error) {
     const state = {
       label: "server unavailable",
       reachable: false,
       latencyMs: Date.now() - started,
+      aliases: await serverAliases(projectRootOf(ctx)).catch(() => []),
       error: error instanceof Error ? error.message : String(error)
     };
-    patchData(ctx, { server: state });
+    patchData(ctx, { server: state, remoteProjectLink: undefined });
     patchFooter(ctx, { server: "unavailable" });
-    emitCompleted(ctx, label, { server: state.label, reachable: false, error: state.error });
+    emitCompleted(ctx, label, { serverLabel: state.label, reachable: false, error: state.error });
     return state;
   }
 }
@@ -17378,7 +17672,7 @@ import {
   dim as otuiDim,
   fg as otuiFg,
   t,
-  TextAttributes as TextAttributes2
+  TextAttributes
 } from "@opentui/core";
 function statusColor3(status) {
   switch (status) {
@@ -17483,7 +17777,7 @@ var init_theme2 = __esm(() => {
 });
 
 // packages/cli/src/app-opentui/drone.ts
-import { RGBA as RGBA2, StyledText as StyledText2, TextAttributes as TextAttributes3 } from "@opentui/core";
+import { RGBA, StyledText, TextAttributes as TextAttributes2 } from "@opentui/core";
 function bladeForTick(tick, phase = 0) {
   return BLADE_FRAMES2[(Math.floor(tick / 3) + phase) % BLADE_FRAMES2.length];
 }
@@ -17492,12 +17786,12 @@ function eyeForTick(tick, phase = 0) {
   return pulse > 0.55 ? EYE_FRAMES2[1] : pulse > 0.1 ? EYE_FRAMES2[0] : pulse > -0.45 ? EYE_FRAMES2[2] : EYE_FRAMES2[3];
 }
 function chunk(text2, fg2, bold2 = false, dim = false) {
-  let attributes = TextAttributes3.NONE;
+  let attributes = TextAttributes2.NONE;
   if (bold2)
-    attributes |= TextAttributes3.BOLD;
+    attributes |= TextAttributes2.BOLD;
   if (dim)
-    attributes |= TextAttributes3.DIM;
-  return { __isChunk: true, text: text2, fg: fg2, ...attributes !== TextAttributes3.NONE ? { attributes } : {} };
+    attributes |= TextAttributes2.DIM;
+  return { __isChunk: true, text: text2, fg: fg2, ...attributes !== TextAttributes2.NONE ? { attributes } : {} };
 }
 function styledLine(text2, colorFor) {
   const chunks = [];
@@ -17518,7 +17812,7 @@ function styledLine(text2, colorFor) {
     run += char;
   }
   flush();
-  return new StyledText2(chunks.length > 0 ? chunks : [chunk("", COLOR.ink)]);
+  return new StyledText(chunks.length > 0 ? chunks : [chunk("", COLOR.ink)]);
 }
 function droneColor(char) {
   if (char === "?" || char === "o" || char === "@" || char === "\u2022")
@@ -17610,13 +17904,13 @@ var init_drone = __esm(() => {
   BLADE_FRAMES2 = ["---", "\\\\\\", "|||", "///"];
   EYE_FRAMES2 = ["o", "@", "\u2022", "."];
   COLOR = {
-    body: RGBA2.fromHex(RIG_UI.lime),
-    mini: RGBA2.fromHex(RIG_UI.limeDim),
-    rotor: RGBA2.fromHex(RIG_UI.cyan),
-    path: RGBA2.fromHex(RIG_UI.cyan),
-    eye: RGBA2.fromHex(RIG_UI.ink),
-    dim: RGBA2.fromHex(RIG_UI.ink4),
-    ink: RGBA2.fromHex(RIG_UI.ink2)
+    body: RGBA.fromHex(RIG_UI.lime),
+    mini: RGBA.fromHex(RIG_UI.limeDim),
+    rotor: RGBA.fromHex(RIG_UI.cyan),
+    path: RGBA.fromHex(RIG_UI.cyan),
+    eye: RGBA.fromHex(RIG_UI.ink),
+    dim: RGBA.fromHex(RIG_UI.ink4),
+    ink: RGBA.fromHex(RIG_UI.ink2)
   };
 });
 
@@ -17826,11 +18120,56 @@ var init_doctor3 = __esm(() => {
   DOCTOR_ACTIONS = [
     { detail: "run diagnostics now", item: { id: "run", label: "run", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "run diagnostics" } },
     { detail: "open server controls", item: { id: "server", label: "server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Open server controls" } }, message: "open server controls" } },
-    { detail: "repair project/server/auth link", item: { id: "repair", label: "repair", intent: { scene: "command", argv: ["init", "--repair"], action: { kind: "command-run", label: "Repair project link" } }, message: "repair project link" } },
+    { detail: "repair project/server/auth link", item: { id: "repair", label: "repair", intent: { scene: "init", argv: ["init", "--repair", "--yes"], action: { kind: "init-start", label: "Repair project link" } }, message: "repair project link natively" } },
     { detail: "open tasks", item: { id: "tasks", label: "tasks", intent: { scene: "tasks", argv: ["tasks"], action: { kind: "refresh", label: "Open tasks" } }, message: "open tasks" } }
   ];
 });
 
+// packages/cli/src/app-opentui/remote-link.ts
+function remoteProjectLinkError(message2) {
+  return /no server-host project root link|remote project(?:-root)? link|x-rig-project-root|serverProjectRoot/i.test(message2 ?? "");
+}
+function serverRecordForRemoteLink(state) {
+  const server = state.data.server;
+  return server && typeof server === "object" && !Array.isArray(server) ? server : null;
+}
+function remoteProjectLinkState(state) {
+  const serverRecord = serverRecordForRemoteLink(state);
+  if (!serverRecord || serverRecord.kind !== "remote")
+    return null;
+  const link = serverRecord.remoteProjectLink;
+  if (link && typeof link === "object" && !Array.isArray(link))
+    return link;
+  const direct = state.data.remoteProjectLink;
+  if (direct && typeof direct === "object" && !Array.isArray(direct))
+    return direct;
+  return null;
+}
+function shouldOfferRemoteLinkRepair(state, message2) {
+  const link = remoteProjectLinkState(state);
+  if (link) {
+    if (link.ok === true)
+      return false;
+    const status = link.status ?? "";
+    return REPAIRABLE_REMOTE_LINK_STATUSES.has(status);
+  }
+  const serverRecord = serverRecordForRemoteLink(state);
+  if (serverRecord && serverRecord.kind !== "remote")
+    return false;
+  return remoteProjectLinkError(message2 ?? state.error?.message);
+}
+var REPAIRABLE_REMOTE_LINK_STATUSES;
+var init_remote_link = __esm(() => {
+  REPAIRABLE_REMOTE_LINK_STATUSES = new Set([
+    "auth_required",
+    "project_not_registered",
+    "no_server_checkout",
+    "invalid_root",
+    "needs_prepare",
+    "error"
+  ]);
+});
+
 // packages/cli/src/app-opentui/fleet-stats.ts
 function normalizeStatus(status) {
   return status.replace(/_/g, "-").toLowerCase();
@@ -19746,13 +20085,18 @@ function overviewBody(state, family, snap, layout) {
 function familyRecoveryRows(state, family, errorMessage2) {
   const selected = Math.max(0, state.selection.index);
   const intro = errorMessage2 ? line(`\u2717 couldn't load ${family || "this family"} \u2014 ${errorMessage2}`, { fg: RIG_UI.red, bold: true }) : line(`No data for ${family || "this family"} yet.`, { fg: RIG_UI.ink2 });
-  return [
+  const repairRemote = shouldOfferRemoteLinkRepair(state, errorMessage2);
+  const rows = [
     intro,
-    blank(),
-    selectableDeckRow({ label: "retry", detail: `reload ${family || "the family"}`, index: 0, active: selected === 0 }, { id: "family-retry", label: "retry", intent: { scene: "family", argv: [family], action: { kind: "refresh", label: `Reload ${family}`, payload: { family } } }, message: "reload this family" }),
-    selectableDeckRow({ label: "cockpit", detail: "back to the project cockpit", index: 1, active: selected === 1 }, { id: "family-home", label: "cockpit", intent: { scene: "main", argv: [], action: { kind: "refresh", label: "Home" } }, message: "back to the cockpit" }),
-    selectableDeckRow({ label: "doctor", detail: "diagnose project/setup", index: 2, active: selected === 2 }, { id: "family-doctor", label: "doctor", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "diagnose setup" })
+    blank()
   ];
+  let index = 0;
+  if (repairRemote) {
+    rows.push(selectableDeckRow({ label: "repair link", detail: "backfill/prepare selected remote checkout link", index, active: selected === index }, { id: "family-repair-link", label: "repair link", intent: { scene: "server", argv: ["server", "repair-link"], action: { kind: "remote-link-repair", label: "Repair remote link", payload: { returnScene: "family", family } } }, message: "repair remote project link" }));
+    index += 1;
+  }
+  rows.push(selectableDeckRow({ label: "retry", detail: `reload ${family || "the family"}`, index, active: selected === index }, { id: "family-retry", label: "retry", intent: { scene: "family", argv: [family], action: { kind: "refresh", label: `Reload ${family}`, payload: { family } } }, message: "reload this family" }), selectableDeckRow({ label: "cockpit", detail: "back to the project cockpit", index: index + 1, active: selected === index + 1 }, { id: "family-home", label: "cockpit", intent: { scene: "main", argv: [], action: { kind: "refresh", label: "Home" } }, message: "back to the cockpit" }), selectableDeckRow({ label: "doctor", detail: "diagnose project/setup", index: index + 2, active: selected === index + 2 }, { id: "family-doctor", label: "doctor", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "diagnose setup" }));
+  return rows;
 }
 function renderFamilyScene(state, layout) {
   const family = typeof state.data.familyName === "string" ? state.data.familyName : "";
@@ -19761,9 +20105,16 @@ function renderFamilyScene(state, layout) {
   const loading = state.status === "loading" && !snap;
   const errorMessage2 = state.error?.message ?? lastRefreshError(state) ?? undefined;
   const probeFailed = snap ? snap.state.ran === false && Boolean(state.error) : Boolean(state.error);
+  const selected = Math.max(0, state.selection.index);
   const body = [
     ...loading ? loadingRows(family || "family", state.tick) : snap ? [
-      ...probeFailed && errorMessage2 ? [...errorBanner(errorMessage2), blank()] : [],
+      ...probeFailed && errorMessage2 ? [
+        ...errorBanner(errorMessage2),
+        ...shouldOfferRemoteLinkRepair(state, errorMessage2) ? [
+          selectableDeckRow({ label: "repair link", detail: "backfill/prepare selected remote checkout link", index: 0, active: selected === 0 }, { id: "family-repair-link", label: "repair link", intent: { scene: "server", argv: ["server", "repair-link"], action: { kind: "remote-link-repair", label: "Repair remote link", payload: { returnScene: "family", family } } }, message: "repair remote project link" })
+        ] : [],
+        blank()
+      ] : [],
       ...current.subId ? formView(state, family, snap, current).lines : overviewBody(state, family, snap, layout)
     ] : familyRecoveryRows(state, family, errorMessage2)
   ];
@@ -19797,6 +20148,7 @@ function renderFamilyScene(state, layout) {
 var init_family2 = __esm(() => {
   init_scene();
   init_selectable();
+  init_remote_link();
   init_theme2();
   init_family_domains();
   init_kit();
@@ -20067,27 +20419,38 @@ function runRow(width, run, active, optimistic) {
   const item = runSelectableItem(run);
   return item ? withSelectable(row, item) : row;
 }
-function recoveryRows(selected, reason) {
+function fleetRecoveryItems(state) {
+  if (!shouldOfferRemoteLinkRepair(state))
+    return BASE_FLEET_RECOVERY_ITEMS;
+  return [BASE_FLEET_RECOVERY_ITEMS[0], FLEET_REPAIR_LINK_ITEM, ...BASE_FLEET_RECOVERY_ITEMS.slice(1)];
+}
+function fleetRecoveryDecks(state) {
+  if (!shouldOfferRemoteLinkRepair(state))
+    return BASE_RECOVERY_DECKS;
+  return [BASE_RECOVERY_DECKS[0], { label: "repair link", detail: "backfill/prepare remote project-root link" }, ...BASE_RECOVERY_DECKS.slice(1)];
+}
+function recoveryRows(state, selected, reason) {
+  const items = fleetRecoveryItems(state);
   return [
     ...reason ? [line(reason, { fg: RIG_UI.yellow }), line("", { fg: RIG_UI.ink3 })] : [],
     line("ACTIONS", { fg: RIG_UI.ink3, bold: true }),
-    ...RECOVERY_DECKS.map((deck, index) => selectableDeckRow({ ...deck, index, active: selected === index }, FLEET_RECOVERY_ITEMS[index]))
+    ...fleetRecoveryDecks(state).map((deck, index) => selectableDeckRow({ ...deck, index, active: selected === index }, items[index]))
   ];
 }
-function emptyRows(query, total, selected) {
+function emptyRows(state, query, total, selected) {
   if (!query.trim() && total === 0)
-    return recoveryRows(selected, "No runs yet.");
+    return recoveryRows(state, selected, "No runs yet.");
   if (query.trim() && total > 0) {
     return [
-      ...recoveryRows(selected, `No matching runs for ${JSON.stringify(query)} (${total} total).`)
+      ...recoveryRows(state, selected, `No matching runs for ${JSON.stringify(query)} (${total} total).`)
     ];
   }
-  return recoveryRows(selected, "No runs are visible with this filter.");
+  return recoveryRows(state, selected, "No runs are visible with this filter.");
 }
 function degradedRows(state, selected) {
   if (!state.error)
     return [];
-  return recoveryRows(selected, state.error.message);
+  return recoveryRows(state, selected, state.error.message);
 }
 function renderFleetScene(state, layout) {
   const width = panelWidth4(layout);
@@ -20097,7 +20460,7 @@ function renderFleetScene(state, layout) {
   const runs = sortRuns(filterRunsForSearch(allRuns, query), spec);
   const selectedRun = typeof state.data.selectedRunId === "string" && runs.some((run) => run.runId === state.data.selectedRunId) ? state.data.selectedRunId : runs[0]?.runId;
   const selectedIndex = Math.max(0, runs.findIndex((run) => run.runId === selectedRun));
-  const recoveryIndex = Math.max(0, Math.min(3, state.selection.index));
+  const recoveryIndex = Math.max(0, Math.min(fleetRecoveryItems(state).length - 1, state.selection.index));
   const optimistic = optimisticStatuses(state);
   const updatedAgo = updatedAgoLabel(state);
   const panelTop = 0;
@@ -20129,7 +20492,7 @@ function renderFleetScene(state, layout) {
       ...runs.map((run, index) => runRow(contentWidth, run, index === selectedIndex, optimistic.get(run.runId)))
     ] : state.error ? degradedRows(state, recoveryIndex) : loading ? loadingRows("runs", state.tick) : [
       ...query.trim() ? [line(searchSummary("runs", query, runs.length, allRuns.length), { fg: RIG_UI.ink4 }), line("", { fg: RIG_UI.ink3 })] : [],
-      ...emptyRows(query, allRuns.length, recoveryIndex)
+      ...emptyRows(state, query, allRuns.length, recoveryIndex)
     ]
   ];
   return makeSceneFrame({
@@ -20164,18 +20527,19 @@ function renderFleetScene(state, layout) {
     live: true
   });
 }
-var FLEET_RECOVERY_ITEMS, COL2, GUTTER3 = "  ", RUN_COLUMNS, RECOVERY_DECKS;
+var BASE_FLEET_RECOVERY_ITEMS, FLEET_REPAIR_LINK_ITEM, COL2, GUTTER3 = "  ", RUN_COLUMNS, BASE_RECOVERY_DECKS;
 var init_fleet2 = __esm(() => {
   init_scene();
   init_selectable();
   init_fleet_stats();
+  init_remote_link();
   init_theme2();
-  FLEET_RECOVERY_ITEMS = [
+  BASE_FLEET_RECOVERY_ITEMS = [
     { id: "tasks", label: "tasks", intent: { scene: "tasks", argv: ["tasks"], action: { kind: "refresh", label: "Open tasks" } }, message: "open tasks and dispatch work" },
-    { id: "repair", label: "repair", intent: { scene: "command", argv: ["init", "--repair"], action: { kind: "command-run", label: "Repair project link" } }, message: "repair project/server/auth link" },
     { id: "server", label: "server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Open server controls" } }, message: "server controls" },
     { id: "doctor", label: "doctor", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "diagnose project" }
   ];
+  FLEET_REPAIR_LINK_ITEM = { id: "repair-link", label: "repair link", intent: { scene: "server", argv: ["server", "repair-link"], action: { kind: "remote-link-repair", label: "Repair remote link", payload: { returnScene: "fleet" } } }, message: "backfill or prepare remote project link" };
   COL2 = {
     glyph: 1,
     runId: 8,
@@ -20189,9 +20553,8 @@ var init_fleet2 = __esm(() => {
     { key: "title", label: "task/title", hint: "by task title" },
     { key: "age", label: "age", hint: "by recency" }
   ];
-  RECOVERY_DECKS = [
+  BASE_RECOVERY_DECKS = [
     { label: "tasks", detail: "open tasks and dispatch work" },
-    { label: "repair", detail: "repair project/server/auth link" },
     { label: "server", detail: "open server controls" },
     { label: "doctor", detail: "diagnose project" }
   ];
@@ -20771,11 +21134,11 @@ function renderInitScene(state, layout) {
   const allDone = completed === SETUP_STEPS.length;
   const nextStep = SETUP_STEPS.find((step) => !step.done(signals));
   const selected = Math.max(0, state.selection.index);
-  const primary = nextStep ? selectableDeckRow({ label: "next", detail: `${nextStep.cta} \u2014 recommended`, active: selected === 0 }, { ...nextStep.item, id: "init-primary" }) : selectableDeckRow({ label: "verify", detail: "Setup complete \u2014 run doctor to confirm", active: selected === 0 }, { id: "init-primary", label: "verify", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "verify setup end-to-end" });
+  const primary = nextStep ? selectableDeckRow({ label: "next", detail: `${nextStep.cta} \u2014 recommended`, active: selected === 0 }, { ...nextStep.item, id: "init-primary" }) : selectableDeckRow({ label: "verify", detail: "Init complete \u2014 run doctor to confirm", active: selected === 0 }, { id: "init-primary", label: "verify", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "verify setup end-to-end" });
   const secondaryRows = SECONDARY_ACTIONS.map(({ label, detail, item }, index) => selectableDeckRow({ label, detail, active: selected === index + 1 }, item));
   const progress = allDone ? "all set" : `${completed} of ${SETUP_STEPS.length} complete`;
   const panelLines = [
-    line(allDone ? "SETUP \xB7 ready to go" : "SETUP \xB7 let's get you running", { fg: allDone ? RIG_UI.limeDim : RIG_UI.ink, bold: true }),
+    line(allDone ? "INIT \xB7 ready to go" : "INIT \xB7 let's get you running", { fg: allDone ? RIG_UI.limeDim : RIG_UI.ink, bold: true }),
     line(`progress  ${progress}`, { fg: allDone ? RIG_UI.limeDim : RIG_UI.ink2 }),
     blank(),
     line("CHECKLIST", { fg: RIG_UI.ink3, bold: true }),
@@ -20787,11 +21150,11 @@ function renderInitScene(state, layout) {
     line("OTHER PATHS", { fg: RIG_UI.ink3, bold: true }),
     ...secondaryRows,
     blank(),
-    line("enter/click runs the highlighted action \xB7 esc goes back \xB7 tab switches sections", { fg: RIG_UI.ink4 })
+    line("enter/click runs the highlighted native action \xB7 esc goes back \xB7 tab switches sections", { fg: RIG_UI.ink4 })
   ];
   return makeSceneFrame({
     scene: "init",
-    title: "Setup",
+    title: "Init",
     lines: [],
     panels: [{
       id: "init-setup",
@@ -20804,11 +21167,11 @@ function renderInitScene(state, layout) {
       opacity: 0.98,
       border: false,
       chrome: "ad-terminal",
-      headerText: "rig setup \xB7 guided onboarding",
+      headerText: "rig init \xB7 guided onboarding",
       paddingX: 5,
       paddingY: 2
     }],
-    footer: { message: allDone ? "setup complete" : "setup in progress" },
+    footer: { message: allDone ? "init complete" : "init in progress" },
     live: !allDone || state.status === "action"
   });
 }
@@ -20817,19 +21180,19 @@ var init_init3 = __esm(() => {
   init_scene();
   init_selectable();
   init_theme2();
-  STEP_CONFIG_RUN = { id: "step-config", label: "run setup wizard", intent: { scene: "command", argv: ["init"], action: { kind: "command-run", label: "Run setup wizard" } }, message: "full interactive setup wizard" };
+  STEP_CONFIG_RUN = { id: "step-config", label: "run init", intent: { scene: "init", argv: ["init", "--yes"], action: { kind: "init-start", label: "Run init" } }, message: "initialize without embedded CLI prompts" };
   STEP_SERVER = { id: "step-server", label: "select server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Choose server" } }, message: "select local or remote server" };
-  STEP_AUTH = { id: "step-auth", label: "connect GitHub", intent: { scene: "command", argv: ["github", "auth", "import-gh"], action: { kind: "command-run", label: "Connect GitHub" } }, message: "import GitHub auth into the selected server" };
-  STEP_TASKS = { id: "step-tasks", label: "pick a task source", intent: { scene: "command", argv: ["init", "--repair"], action: { kind: "command-run", label: "Configure task source" } }, message: "configure or repair the task source" };
+  STEP_AUTH = { id: "step-auth", label: "connect GitHub", intent: { scene: "server", argv: ["github", "auth", "status"], action: { kind: "refresh", label: "Open GitHub auth" } }, message: "open native server/auth controls" };
+  STEP_TASKS = { id: "step-tasks", label: "repair task source", intent: { scene: "init", argv: ["init", "--repair", "--yes"], action: { kind: "init-start", label: "Repair task source" } }, message: "repair generated task-source config without embedded CLI prompts" };
   SETUP_STEPS = [
-    { id: "config", label: "Project config", detail: "rig.config + private state", done: (s) => s.configured, cta: "Run setup wizard", item: STEP_CONFIG_RUN },
+    { id: "config", label: "Project config", detail: "rig.config + private state", done: (s) => s.configured, cta: "Run init", item: STEP_CONFIG_RUN },
     { id: "server", label: "Server target", detail: "local or remote, reachable", done: (s) => s.serverReachable, cta: "Choose a server", item: STEP_SERVER },
     { id: "auth", label: "GitHub auth", detail: "signed in on the selected server", done: (s) => s.authSignedIn, cta: "Connect GitHub", item: STEP_AUTH },
     { id: "tasks", label: "Task source", detail: "where work comes from", done: (s) => s.taskSourceReady, cta: "Pick a task source", item: STEP_TASKS }
   ];
   SECONDARY_ACTIONS = [
-    { label: "repair", detail: "reconfigure generated config and private state", item: { id: "repair", label: "repair", intent: { scene: "command", argv: ["init", "--repair"], action: { kind: "command-run", label: "Reconfigure project" } }, message: "verify or rewrite generated config" } },
-    { label: "demo", detail: "seed an offline demo task source to explore", item: { id: "demo", label: "demo", intent: { scene: "command", argv: ["init", "--demo", "--repair"], action: { kind: "command-run", label: "Seed demo project" } }, message: "offline demo project" } },
+    { label: "repair", detail: "reconfigure generated config and private state", item: { id: "repair", label: "repair", intent: { scene: "init", argv: ["init", "--repair", "--yes"], action: { kind: "init-start", label: "Reconfigure project" } }, message: "verify or rewrite generated config natively" } },
+    { label: "demo", detail: "seed an offline demo task source to explore", item: { id: "demo", label: "demo", intent: { scene: "init", argv: ["init", "--demo", "--repair", "--yes"], action: { kind: "init-start", label: "Seed demo project" } }, message: "offline demo project without embedded CLI prompts" } },
     { label: "doctor", detail: "diagnose what is still missing", item: { id: "doctor", label: "doctor", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "verify setup" } }
   ];
 });
@@ -22128,6 +22491,30 @@ var init_run_detail2 = __esm(() => {
 });
 
 // packages/cli/src/app-opentui/scenes/server.ts
+function remoteAliasActions(server) {
+  const aliases = (server?.aliases ?? []).filter((alias) => alias.kind === "remote");
+  return aliases.map((alias) => ({
+    detail: `${alias.selected ? "selected" : "select"} ${alias.baseUrl ?? "remote endpoint"}`,
+    item: {
+      id: `remote-alias:${alias.alias}`,
+      label: alias.selected ? `\u2713 ${alias.alias}` : `use ${alias.alias}`,
+      intent: { scene: "server", argv: ["server", "use", alias.alias], action: { kind: "server-use-remote", label: `Use ${alias.alias}`, payload: { alias: alias.alias } } },
+      message: `select ${alias.alias}`
+    }
+  }));
+}
+function serverActions(state) {
+  const server = serverState(state);
+  const remoteRows = remoteAliasActions(server);
+  let actions = remoteRows.length > 0 ? [...SERVER_ACTIONS.slice(0, 3), ...remoteRows, ...SERVER_ACTIONS.slice(3)] : [...SERVER_ACTIONS];
+  if (!shouldOfferRemoteLinkRepair(state))
+    return actions;
+  const repair = { detail: "backfill or prepare the selected remote checkout/root link", item: { id: "repair-link", label: "repair link", intent: { scene: "server", argv: ["server", "repair-link"], action: { kind: "remote-link-repair", label: "Repair remote link" } }, message: "prepare remote checkout link" } };
+  const doctorIndex = actions.findIndex((entry) => entry.item.id === "doctor");
+  if (doctorIndex < 0)
+    return [...actions, repair];
+  return [...actions.slice(0, doctorIndex), repair, ...actions.slice(doctorIndex)];
+}
 function cleanVisible(value, fallback = "unknown") {
   return value?.trim() || fallback;
 }
@@ -22152,31 +22539,37 @@ function selectedIndex(state, count) {
 function statusRows2(server) {
   const auth = server?.auth;
   const signedIn = auth && (auth.signedIn === true || auth.authenticated === true || auth.status === "authenticated") ? "authenticated" : "auth unknown";
+  const link = server?.remoteProjectLink;
+  const linkText = link ? link.ok ? `ready \xB7 ${link.serverProjectRoot ?? "linked"}` : `${link.status ?? "needs repair"} \xB7 ${link.hint ?? link.message ?? "run repair link"}` : server?.kind === "remote" ? "not checked" : "not required";
+  const selectedLinkSummary = link?.ok ? " \xB7 root link ready" : server?.kind === "remote" && link ? ` \xB7 root link ${link.status ?? "needs repair"}` : "";
   return [
-    line(`selected    ${cleanVisible(server?.label, "not checked")}`, { fg: RIG_UI.ink2 }),
+    line(`selected    ${cleanVisible(server?.label, "not checked")}${selectedLinkSummary}`, { fg: RIG_UI.ink2 }),
     line(`target      ${targetLabel(server)}`, { fg: RIG_UI.ink3 }),
     line(`mode        ${server?.kind ?? "local or remote"}`, { fg: RIG_UI.ink3 }),
     line(`health      ${server ? server.reachable ? "reachable" : "unreachable" : "check pending"}`, { fg: server?.reachable ? RIG_UI.limeDim : server ? RIG_UI.red : RIG_UI.yellow }),
     line(`github      ${signedIn}`, { fg: signedIn === "authenticated" ? RIG_UI.limeDim : RIG_UI.ink4 }),
+    line(`root link   ${linkText}`, { fg: link?.ok ? RIG_UI.limeDim : server?.kind === "remote" ? RIG_UI.yellow : RIG_UI.ink4 }),
+    ...server?.aliases && server.aliases.length > 0 ? [line(`aliases     ${server.aliases.map((alias) => `${alias.selected ? "*" : ""}${alias.alias}${alias.kind === "remote" && alias.baseUrl ? `=${alias.baseUrl}` : ""}`).join(", ")}`, { fg: RIG_UI.ink4 })] : [],
     ...server?.error ? [line(`attention   ${server.error}`, { fg: RIG_UI.yellow })] : []
   ];
 }
 function renderServerScene(state, layout) {
   const server = serverState(state);
-  const selected = selectedIndex(state, 10);
+  const actions = serverActions(state);
+  const selected = selectedIndex(state, actions.length);
   const loading = state.status === "loading" && !server;
   const errorText = state.error?.message ?? lastRefreshError(state);
   const panelLines = [
     ...errorText ? errorBanner(errorText, "select refresh or doctor below to retry") : [],
     line("server controls", { fg: RIG_UI.ink3 }),
     blank(),
-    line("ACTIONS", { fg: RIG_UI.ink3, bold: true }),
-    ...SERVER_ACTIONS.map(({ detail, item }, index) => selectableDeckRow({ label: item.label, detail, index, active: selected === index }, item)),
-    blank(),
     line("STATUS", { fg: RIG_UI.ink3, bold: true }),
     ...loading ? loadingRows("server status", state.tick) : statusRows2(server),
     blank(),
-    line("enter/click runs action \xB7 command rows stay inside OpenTUI PTY", { fg: RIG_UI.ink4 })
+    line("ACTIONS", { fg: RIG_UI.ink3, bold: true }),
+    ...actions.map(({ detail, item }, index) => selectableDeckRow({ label: item.label, detail, index, active: selected === index }, item)),
+    blank(),
+    line("enter/click runs native actions \xB7 add/use remote prompts stay in OpenTUI", { fg: RIG_UI.ink4 })
   ];
   return makeSceneFrame({
     scene: "server",
@@ -22206,14 +22599,15 @@ var init_server3 = __esm(() => {
   init_scene();
   init_selectable();
   init_theme2();
+  init_remote_link();
   SERVER_ACTIONS = [
     { detail: "probe selected server, project root, and GitHub auth", item: { id: "refresh", label: "refresh", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Refresh server" } }, message: "refresh selected server" } },
-    { detail: "select local server for this repo", item: { id: "local", label: "use local", intent: { scene: "command", argv: ["server", "use", "local"], action: { kind: "command-run", label: "Use local server" } }, message: "switch this repo to local" } },
-    { detail: "choose/switch to a saved remote server alias", item: { id: "remote", label: "use remote", intent: { scene: "command", argv: ["server", "use"], action: { kind: "command-run", label: "Choose remote server" } }, message: "choose a saved remote alias" } },
-    { detail: "show saved local/remote aliases", item: { id: "list", label: "list servers", intent: { scene: "command", argv: ["server", "list"], action: { kind: "command-run", label: "List saved servers" } }, message: "list saved server aliases" } },
-    { detail: "open server add command workspace", item: { id: "add", label: "add remote", intent: { scene: "command", argv: ["server", "add"], action: { kind: "command-run", label: "Add remote server" } }, message: "open server add workspace" } },
+    { detail: "select local server for this repo", item: { id: "local", label: "use local", intent: { scene: "server", argv: ["server", "use", "local"], action: { kind: "server-use-local", label: "Use local server" } }, message: "switch this repo to local" } },
+    { detail: "type a saved remote alias to select", item: { id: "remote", label: "use remote", prompt: { label: "Use remote alias", scene: "server", argv: ["server", "use"], intentKind: "server-use-remote", payloadBase: {}, payloadKey: "alias" }, message: "choose a saved remote alias" } },
+    { detail: "show saved local/remote aliases in the status panel", item: { id: "list", label: "list servers", intent: { scene: "server", argv: ["server", "list"], action: { kind: "refresh", label: "List servers" } }, message: "list saved server aliases" } },
+    { detail: "add and select a remote: enter <alias> <https-url>", item: { id: "add", label: "add remote", prompt: { label: "Add remote", scene: "server", argv: ["server", "add"], intentKind: "server-add-remote", payloadBase: {}, payloadKey: "remote", appendValueToArgv: true }, message: "add a remote server alias" } },
     { detail: "spawn the local rig-server detached and return here", item: { id: "start", label: "start local", intent: { scene: "server", argv: ["server", "start"], action: { kind: "refresh", payload: { startLocal: true }, label: "Start local server" } }, message: "start local server detached" } },
-    { detail: "import gh token into the selected server namespace", item: { id: "auth", label: "import auth", intent: { scene: "command", argv: ["github", "auth", "import-gh"], action: { kind: "command-run", label: "Import GitHub auth" } }, message: "import gh auth to selected server" } },
+    { detail: "import gh token into the selected server namespace", item: { id: "auth", label: "import auth", intent: { scene: "server", argv: ["github", "auth", "import-gh"], action: { kind: "github-auth-import", label: "Import GitHub auth" } }, message: "import gh auth to selected server" } },
     { detail: "diagnose server/auth/project linkage", item: { id: "doctor", label: "doctor", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "verify server/auth" } },
     { detail: "verify selected server can list task source", item: { id: "tasks", label: "tasks", intent: { scene: "tasks", argv: ["task", "list"], action: { kind: "refresh", label: "Open tasks" } }, message: "verify task source" } },
     { detail: "verify selected server can list recent runs", item: { id: "runs", label: "runs", intent: { scene: "fleet", argv: ["run", "status"], action: { kind: "refresh", label: "Open runs" } }, message: "open recent runs" } }
@@ -22365,27 +22759,38 @@ function taskRow(width, task, active, optimistic) {
   const item = taskSelectableItem(task);
   return item ? withSelectable(row, item) : row;
 }
-function recoveryRows2(selected, reason) {
+function taskRecoveryItems(state) {
+  if (!shouldOfferRemoteLinkRepair(state))
+    return BASE_TASK_RECOVERY_ITEMS;
+  return [BASE_TASK_RECOVERY_ITEMS[0], BASE_TASK_RECOVERY_ITEMS[1], TASK_REPAIR_LINK_ITEM, ...BASE_TASK_RECOVERY_ITEMS.slice(2)];
+}
+function taskRecoveryDecks(state) {
+  if (!shouldOfferRemoteLinkRepair(state))
+    return BASE_RECOVERY_DECKS2;
+  return [BASE_RECOVERY_DECKS2[0], BASE_RECOVERY_DECKS2[1], { label: "repair link", detail: "backfill/prepare remote project-root link" }, ...BASE_RECOVERY_DECKS2.slice(2)];
+}
+function recoveryRows2(state, selected, reason) {
+  const items = taskRecoveryItems(state);
   return [
     ...reason ? [line(reason, { fg: RIG_UI.yellow }), line("", { fg: RIG_UI.ink3 })] : [],
     line("ACTIONS", { fg: RIG_UI.ink3, bold: true }),
-    ...RECOVERY_DECKS2.map((deck, index) => selectableDeckRow({ ...deck, index, active: selected === index }, TASK_RECOVERY_ITEMS[index]))
+    ...taskRecoveryDecks(state).map((deck, index) => selectableDeckRow({ ...deck, index, active: selected === index }, items[index]))
   ];
 }
-function emptyRows2(query, total, selected) {
+function emptyRows2(state, query, total, selected) {
   if (!query.trim() && total === 0)
-    return recoveryRows2(selected, "No tasks loaded.");
+    return recoveryRows2(state, selected, "No tasks loaded.");
   if (query.trim() && total > 0) {
     return [
-      ...recoveryRows2(selected, `No matching tasks for ${JSON.stringify(query)} (${total} total).`)
+      ...recoveryRows2(state, selected, `No matching tasks for ${JSON.stringify(query)} (${total} total).`)
     ];
   }
-  return recoveryRows2(selected, "No tasks are visible with this filter.");
+  return recoveryRows2(state, selected, "No tasks are visible with this filter.");
 }
 function degradedRows2(state, selected) {
   if (!state.error)
     return [];
-  return recoveryRows2(selected, state.error.message);
+  return recoveryRows2(state, selected, state.error.message);
 }
 function rawString(raw, key) {
   const value = raw?.[key];
@@ -22409,7 +22814,10 @@ function renderTaskDetail(state, taskId3, layout) {
   const activeRunId = task?.activeRun?.runId?.trim();
   const width = panelWidth13(layout);
   const selected = Math.max(0, state.selection.index);
+  const errorText = state.error?.message ?? lastRefreshError(state);
+  const offerRepairLink = shouldOfferRemoteLinkRepair(state, errorText);
   const headerLines = [
+    ...errorText ? errorBanner(errorText, offerRepairLink ? "select repair link below to prepare the remote checkout" : "retry dispatch after resolving the issue") : [],
     line(`${glyph2} ${title}`, { fg: color, bold: true }),
     line(`task ${taskId3} \xB7 ${status}`, { fg: RIG_UI.ink3 }),
     ...task && task.labels.length > 0 ? [line(`labels: ${task.labels.join(", ")}`, { fg: RIG_UI.ink4 })] : [],
@@ -22421,8 +22829,16 @@ function renderTaskDetail(state, taskId3, layout) {
   const actionRows2 = [];
   actionRows2.push(selectableDeckRow({ label: "back", detail: "return to the task list", index, active: selected === index }, { id: "task-detail-back", label: "back", data: { taskDetailId: undefined }, message: "back to task list" }));
   index += 1;
-  actionRows2.push(selectableDeckRow({ label: "dispatch", detail: "submit a Pi run for this task", index, active: selected === index }, { id: `task-detail-run:${taskId3}`, label: `dispatch ${taskId3}`, intent: { scene: "tasks", argv: ["run", taskId3], action: { kind: "task-run-id", payload: { task: taskId3 }, label: `Dispatching ${taskId3}` } }, message: `dispatch task ${taskId3}` }));
-  index += 1;
+  if (offerRepairLink) {
+    actionRows2.push(selectableDeckRow({ label: "repair link", detail: "prepare/backfill the selected remote project-root link", index, active: selected === index }, { id: `task-detail-repair-link:${taskId3}`, label: "repair link", intent: { scene: "server", argv: ["server", "repair-link"], action: { kind: "remote-link-repair", label: "Repair remote link", payload: { returnScene: "tasks", taskDetailId: taskId3 } } }, message: "prepare remote checkout link" }));
+    index += 1;
+  }
+  if (offerRepairLink) {
+    actionRows2.push(line("  dispatch   blocked until the remote project link is repaired", { fg: RIG_UI.ink4 }));
+  } else {
+    actionRows2.push(selectableDeckRow({ label: "dispatch", detail: "submit a Pi run for this task", index, active: selected === index }, { id: `task-detail-run:${taskId3}`, label: `dispatch ${taskId3}`, intent: { scene: "tasks", argv: ["run", taskId3], action: { kind: "task-run-id", payload: { task: taskId3 }, label: `Dispatching ${taskId3}` } }, message: `dispatch task ${taskId3}` }));
+    index += 1;
+  }
   if (activeRunId) {
     actionRows2.push(selectableDeckRow({ label: "attach", detail: `attach the Pi console to run ${activeRunId.slice(0, 8)}`, index, active: selected === index }, { id: `task-detail-attach:${taskId3}`, label: `attach ${activeRunId.slice(0, 8)}`, intent: { scene: "handoff", argv: ["attach", activeRunId], action: { kind: "run-attach", payload: { runId: activeRunId }, label: `Attach Pi ${activeRunId.slice(0, 8)}` } }, message: `attach Pi to ${activeRunId.slice(0, 8)}` }));
     index += 1;
@@ -22481,7 +22897,7 @@ function renderTasksScene(state, layout) {
   const tasks = sortTasks2(filterTasksForSearch(allTasks, query), spec);
   const selected = typeof state.data.selectedTaskId === "string" && tasks.some((task) => task.id === state.data.selectedTaskId) ? state.data.selectedTaskId : tasks[0]?.id;
   const selectedIndex2 = Math.max(0, tasks.findIndex((task) => task.id === selected));
-  const recoveryIndex = Math.max(0, Math.min(4, state.selection.index));
+  const recoveryIndex = Math.max(0, Math.min(taskRecoveryItems(state).length - 1, state.selection.index));
   const dispatching = dispatchingFor(state);
   const dispatchLine = dispatching ? ` \xB7 ${state.data.dispatchingRun?.runId ?? "new"} ${dispatching.status}` : "";
   const updatedAgo = updatedAgoLabel2(state);
@@ -22501,7 +22917,7 @@ function renderTasksScene(state, layout) {
       ...tasks.map((task, index) => taskRow(contentWidth, task, index === selectedIndex2, dispatching && dispatching.taskId === task.id ? dispatching.status : undefined))
     ] : state.error ? degradedRows2(state, recoveryIndex) : loading ? loadingRows("tasks", state.tick) : [
       ...query.trim() ? [line(searchSummary("tasks", query, tasks.length, allTasks.length), { fg: RIG_UI.ink4 }), line("", { fg: RIG_UI.ink3 })] : [],
-      ...emptyRows2(query, allTasks.length, recoveryIndex)
+      ...emptyRows2(state, query, allTasks.length, recoveryIndex)
     ]
   ];
   return makeSceneFrame({
@@ -22535,18 +22951,19 @@ function renderTasksScene(state, layout) {
     live: true
   });
 }
-var TASK_RECOVERY_ITEMS, COL3, GUTTER4 = "  ", TASK_COLUMNS, RECOVERY_DECKS2;
+var BASE_TASK_RECOVERY_ITEMS, TASK_REPAIR_LINK_ITEM, COL3, GUTTER4 = "  ", TASK_COLUMNS, BASE_RECOVERY_DECKS2;
 var init_tasks2 = __esm(() => {
   init_scene();
   init_selectable();
+  init_remote_link();
   init_theme2();
-  TASK_RECOVERY_ITEMS = [
+  BASE_TASK_RECOVERY_ITEMS = [
     { id: "refresh", label: "refresh", intent: { scene: "tasks", argv: ["tasks"], action: { kind: "refresh", label: "Refresh tasks" } }, message: "refresh task source" },
-    { id: "next", label: "next", intent: { scene: "command", argv: ["task", "run", "--next"], action: { kind: "command-run", label: "Run next task" } }, message: "dispatch next runnable task" },
-    { id: "repair", label: "repair", intent: { scene: "command", argv: ["init", "--repair"], action: { kind: "command-run", label: "Repair task source" } }, message: "repair project/task source" },
+    { id: "next", label: "next", intent: { scene: "tasks", argv: ["task", "run", "--next"], action: { kind: "task-run-next", label: "Dispatch next task" } }, message: "dispatch next runnable task" },
     { id: "server", label: "server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Open server controls" } }, message: "server controls" },
     { id: "doctor", label: "doctor", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "diagnose task source" }
   ];
+  TASK_REPAIR_LINK_ITEM = { id: "repair-link", label: "repair link", intent: { scene: "server", argv: ["server", "repair-link"], action: { kind: "remote-link-repair", label: "Repair remote link", payload: { returnScene: "tasks" } } }, message: "backfill or prepare remote project link" };
   COL3 = {
     glyph: 1,
     id: 11,
@@ -22561,10 +22978,9 @@ var init_tasks2 = __esm(() => {
     { key: "assignee", label: "assignee", hint: "by assignee" },
     { key: "title", label: "title", hint: "by title" }
   ];
-  RECOVERY_DECKS2 = [
+  BASE_RECOVERY_DECKS2 = [
     { label: "refresh", detail: "reload task source" },
     { label: "next", detail: "dispatch next runnable task" },
-    { label: "repair", detail: "repair project/task source link" },
     { label: "server", detail: "open server controls" },
     { label: "doctor", detail: "diagnose task source" }
   ];
@@ -22898,6 +23314,29 @@ function createDomainAdapter() {
           else
             await loadInitFacts(ctx);
           return true;
+        case "server-use-local":
+          await useLocalServerFromApp(ctx);
+          return true;
+        case "server-use-remote":
+          await useRemoteServerFromApp(ctx, payloadString8(intent, "alias") ?? intent.argv[2]);
+          return true;
+        case "server-add-remote":
+          await addRemoteServerFromApp(ctx, intent.argv);
+          return true;
+        case "github-auth-import":
+          await importGitHubAuthFromGhApp(ctx);
+          return true;
+        case "remote-link-repair": {
+          await repairRemoteProjectRootLinkFromApp(ctx);
+          const returnScene = payloadString8(intent, "returnScene");
+          if (returnScene && returnScene !== intent.scene) {
+            ctx.emit({ type: "scene.change", scene: returnScene, intent: { scene: returnScene, argv: intent.argv, action: { kind: "refresh", label: `Refresh ${returnScene}`, payload: intent.action.payload } } });
+            await refreshScene(ctx, returnScene, { scene: returnScene, argv: intent.argv, action: { kind: "refresh", label: `Refresh ${returnScene}`, payload: intent.action.payload } });
+          } else {
+            await refreshServerStatus(ctx);
+          }
+          return true;
+        }
         case "doctor-run":
           await runDoctorChecksForApp(ctx);
           return true;
@@ -23000,7 +23439,9 @@ import {
   RigInboxInputsOutput,
   RigRunListOutput,
   RigRunShowOutput,
+  RigServerRepairLinkOutput,
   RigServerStatusOutput,
+  RigServerUseOutput,
   RigStatsOutput,
   RigTaskListOutput,
   RigTaskShowOutput
@@ -23036,7 +23477,9 @@ var init__json_output = __esm(() => {
     "task show": RigTaskShowOutput,
     "run list": RigRunListOutput,
     "run show": RigRunShowOutput,
+    "server use": RigServerUseOutput,
     "server status": RigServerStatusOutput,
+    "server repair-link": RigServerRepairLinkOutput,
     "inbox approvals": RigInboxApprovalsOutput,
     "inbox inputs": RigInboxInputsOutput,
     "doctor check": RigDoctorCheckOutput,
@@ -23046,7 +23489,7 @@ var init__json_output = __esm(() => {
 
 // packages/cli/src/launcher.ts
 import { existsSync as existsSync22 } from "fs";
-import { basename as basename5, resolve as resolve29 } from "path";
+import { basename as basename4, resolve as resolve29 } from "path";
 import { loadDotEnvSecrets } from "@rig/runtime/baked-secrets";
 import { RIG_DEFINITION_DIRNAME, RIG_STATE_DIRNAME, resolveNearestRigProjectRoot } from "@rig/runtime/layout";
 function parsePolicyMode(value) {
@@ -23071,7 +23514,7 @@ function resolveProjectRoot({
     return resolve29(cwd, envProjectRoot);
   }
   const fallbackImportDir = importDir ?? cwd;
-  const execName = basename5(execPath).toLowerCase();
+  const execName = basename4(execPath).toLowerCase();
   const execCandidates = execName === "rig" || execName === "rig.exe" ? [resolve29(execPath, "..", "..")] : [];
   const candidates = [cwd, ...execCandidates, resolve29(fallbackImportDir, "..")];
   for (const candidate of candidates) {
@@ -23367,16 +23810,31 @@ function taskViewIntent(argv, command = "", rest = [], raw) {
   const { payload, label } = taskViewPayload(command, rest);
   return intent("tasks", argv, "refresh", payload, label, raw);
 }
-function routeServer(argv, command, raw, checkingLabel) {
-  if (!command || command === "status") {
+function routeServer(argv, command, rest, raw, checkingLabel) {
+  if (!command || command === "status" || command === "list") {
     return intent("server", argv, "refresh", undefined, command ? checkingLabel : "Loading server", raw);
   }
+  if (command === "use") {
+    const alias = firstNonOption(rest);
+    if (alias === "local")
+      return intent("server", argv, "server-use-local", undefined, "Use local server", raw);
+    if (alias)
+      return intent("server", argv, "server-use-remote", { alias }, `Use ${alias}`, raw);
+    return intent("server", argv, "refresh", undefined, "Select a remote alias in Server", raw);
+  }
+  if (command === "add")
+    return intent("server", argv, "server-add-remote", { argv: [...argv] }, "Add remote server", raw);
+  if (command === "repair-link")
+    return intent("server", argv, "remote-link-repair", undefined, "Repair remote link", raw);
   return commandRunIntent(argv, raw);
 }
 function routeGithub(argv, command, rest, raw) {
   if (command === "auth" && (rest[0]?.toLowerCase() ?? "status") === "status" && rest.length <= 1) {
     return intent("server", argv, "refresh", undefined, "Checking GitHub auth", raw);
   }
+  if (command === "auth" && rest[0]?.toLowerCase() === "import-gh" && rest.length <= 1) {
+    return intent("server", argv, "github-auth-import", undefined, "Import GitHub auth", raw);
+  }
   return commandRunIntent(argv, raw);
 }
 function routeDoctor(argv, command, raw) {
@@ -23425,11 +23883,16 @@ function intentFromArgv(argv) {
     return commandRunIntent(argv);
   }
   if (normalizedGroup === "server")
-    return routeServer(argv, normalizedCommand, undefined, "Checking server");
+    return routeServer(argv, normalizedCommand, rest, undefined, "Checking server");
   if (normalizedGroup === "github")
     return routeGithub(argv, normalizedCommand, rest);
-  if (normalizedGroup === "init")
-    return commandRunIntent(argv);
+  if (normalizedGroup === "init") {
+    if (!normalizedCommand)
+      return intent("init", argv, "refresh", undefined, "Open init");
+    if (rest.includes("--yes") || normalizedCommand === "--yes")
+      return intent("init", argv, "init-start", undefined, "Run init");
+    return intent("init", argv, "refresh", undefined, "Open init");
+  }
   if (normalizedGroup === "doctor")
     return routeDoctor(argv, normalizedCommand);
   if (normalizedGroup === "inbox")
@@ -23492,12 +23955,17 @@ function intentFromTypeBar(value) {
       return commandRunIntent(parts, value);
     return intent("tasks", parts, "refresh", undefined, "Select a task, then press Enter; or use run next", value);
   }
-  if (first === "init")
-    return commandRunIntent(parts, value);
+  if (first === "init") {
+    if (!second)
+      return intent("init", parts, "refresh", undefined, "Open init", value);
+    if (parts.includes("--yes"))
+      return intent("init", parts, "init-start", undefined, "Run init", value);
+    return intent("init", parts, "refresh", undefined, "Open init", value);
+  }
   if (first === "doctor")
     return routeDoctor(parts, second, value);
   if (first === "server")
-    return routeServer(parts, second, value, "Loading server");
+    return routeServer(parts, second, rest, value, "Loading server");
   if (first === "github")
     return routeGithub(parts, second, rest, value);
   if (first === "inbox")
@@ -23948,22 +24416,15 @@ function clearTypeBar(context, message2) {
   context.emitTypeBarPatch({ value: "", mode: "nav", prompt: undefined, message: message2 });
 }
 function handleEmbeddedTerminalKey(context, key) {
-  const state = context.getState();
-  const piHost = getActivePiHost();
-  const commandHost = getActiveCommandHost();
-  const host = state.scene === "handoff" ? piHost : state.scene === "command" ? commandHost : null;
+  if (context.getState().scene !== "command")
+    return false;
+  const host = getActiveCommandHost();
   if (!host)
     return false;
   if (key.ctrl && key.name === "]") {
-    if (state.scene === "handoff") {
-      stopActivePiHost("operator detach");
-      clearTypeBar(context, "detached from Pi");
-      context.runAppAction("Opening runs", () => context.runtime.runIntent({ scene: "fleet", argv: ["runs"], action: { kind: "refresh", label: "Opening runs" } }));
-    } else {
-      stopActiveCommandHost("operator detach");
-      clearTypeBar(context, "closed command");
-      context.runAppAction("Project menu", () => context.runtime.runIntent({ scene: "main", argv: ["main"], action: { kind: "none", label: "Project menu" } }));
-    }
+    stopActiveCommandHost("operator detach");
+    clearTypeBar(context, "closed command");
+    context.runAppAction("Project menu", () => context.runtime.runIntent({ scene: "main", argv: ["main"], action: { kind: "none", label: "Project menu" } }));
     return true;
   }
   const sequence = key.raw || key.sequence;
@@ -24172,7 +24633,6 @@ var init_keymap = __esm(() => {
   init_autocomplete();
   init_command_pty_host();
   init_intent();
-  init_pi_pty_host();
 });
 
 // packages/cli/src/app-opentui/runtime-resources.ts
@@ -24329,7 +24789,7 @@ var init_constants = __esm(() => {
 });
 
 // packages/cli/src/app-opentui/render/graphics.ts
-import { FrameBufferRenderable, RGBA as RGBA3 } from "@opentui/core";
+import { FrameBufferRenderable, RGBA as RGBA2 } from "@opentui/core";
 function sceneKind(scene) {
   if (scene === "tasks")
     return "loop";
@@ -24424,7 +24884,7 @@ function paletteColor(ac, c2, mg, ink5) {
   const b = (AC_RGB[2] * ac + C2_RGB[2] * c2 + MG_RGB[2] * mg + INK_RGB[2] * ink5) / total;
   const intensity = Math.min(1, total / 4);
   const lift = 0.34 + intensity * 0.66;
-  return RGBA3.fromInts(Math.round(r * lift), Math.round(g * lift), Math.round(b * lift), 255);
+  return RGBA2.fromInts(Math.round(r * lift), Math.round(g * lift), Math.round(b * lift), 255);
 }
 function clearCanvas(canvas) {
   canvas.ac.fill(0);
@@ -24779,8 +25239,8 @@ function staticFleetTick(scene) {
 }
 function withAlpha(hex, alpha) {
   const a = Math.max(0, Math.min(255, Math.round(alpha * 255)));
-  const [r, g, b] = RGBA3.fromHex(hex).toInts();
-  return RGBA3.fromInts(r, g, b, a);
+  const [r, g, b] = RGBA2.fromHex(hex).toInts();
+  return RGBA2.fromInts(r, g, b, a);
 }
 function asciiFleetColor(char, row, alpha) {
   if (char === "@" || char === "$" || char === "o")
@@ -24788,7 +25248,7 @@ function asciiFleetColor(char, row, alpha) {
   if (char === "%" || char === "!" || char === "/" || char === "\\" || char === "|")
     return withAlpha(RIG_UI.cyan, alpha);
   if (char === "." || char === "'" || char === "_" || row < 3 || row > FLEET_GRID_HEIGHT - 4) {
-    return RGBA3.fromInts(108, 110, 121, Math.min(170, Math.max(0, Math.min(255, Math.round(alpha * 255)))));
+    return RGBA2.fromInts(108, 110, 121, Math.min(170, Math.max(0, Math.min(255, Math.round(alpha * 255)))));
   }
   return withAlpha(RIG_UI.limeDim, alpha);
 }
@@ -24842,13 +25302,13 @@ var init_graphics = __esm(() => {
   init_theme2();
   init_ascii_fleet();
   init_constants();
-  TRANSPARENT = RGBA3.fromValues(0, 0, 0, 0);
-  BACKDROP = RGBA3.fromHex(RIG_UI.bg);
-  PANEL_BG = RGBA3.fromInts(16, 17, 21, 184);
-  PANEL_HEADER_BG = RGBA3.fromInts(16, 17, 21, 188);
-  PANEL_LINE = RGBA3.fromInts(255, 255, 255, 20);
-  PANEL_LINE_DIM = RGBA3.fromInts(255, 255, 255, 8);
-  PANEL_TEXT_DIM = RGBA3.fromInts(108, 110, 121, 255);
+  TRANSPARENT = RGBA2.fromValues(0, 0, 0, 0);
+  BACKDROP = RGBA2.fromHex(RIG_UI.bg);
+  PANEL_BG = RGBA2.fromInts(16, 17, 21, 184);
+  PANEL_HEADER_BG = RGBA2.fromInts(16, 17, 21, 188);
+  PANEL_LINE = RGBA2.fromInts(255, 255, 255, 20);
+  PANEL_LINE_DIM = RGBA2.fromInts(255, 255, 255, 8);
+  PANEL_TEXT_DIM = RGBA2.fromInts(108, 110, 121, 255);
   AC_RGB = [204, 255, 77];
   C2_RGB = [86, 216, 255];
   MG_RGB = [255, 121, 176];
@@ -24891,7 +25351,7 @@ var init_hover = __esm(() => {
 });
 
 // packages/cli/src/app-opentui/render/text.ts
-import { RGBA as RGBA4, TextAttributes as TextAttributes4, TextRenderable } from "@opentui/core";
+import { RGBA as RGBA3, TextAttributes as TextAttributes3, TextRenderable } from "@opentui/core";
 function lineIsClickable(line2) {
   return line2?.selectable !== undefined || line2?.selectableIndex !== undefined;
 }
@@ -24900,7 +25360,7 @@ function lineSelectableId(line2) {
 }
 function lineBackground(line2) {
   if (line2?.bg)
-    return RGBA4.fromHex(line2.bg);
+    return RGBA3.fromHex(line2.bg);
   const id = lineSelectableId(line2);
   if (id !== undefined && isHovered(id))
     return HOVER_BG;
@@ -24969,7 +25429,7 @@ function applyTextLine(renderable, line2, top, left, width) {
   renderable.content = line2?.styledText ?? line2?.text ?? "";
   renderable.fg = line2?.fg ?? RIG_UI.ink2;
   renderable.bg = lineBackground(line2);
-  renderable.attributes = line2?.bold ? TextAttributes4.BOLD : line2?.dim ? TextAttributes4.DIM : 0;
+  renderable.attributes = line2?.bold ? TextAttributes3.BOLD : line2?.dim ? TextAttributes3.DIM : 0;
 }
 function applyFlowTextLine(renderable, line2, width) {
   renderable.setRigSceneLine?.(line2);
@@ -24979,7 +25439,7 @@ function applyFlowTextLine(renderable, line2, width) {
   renderable.content = line2?.styledText ?? line2?.text ?? "";
   renderable.fg = line2?.fg ?? RIG_UI.ink2;
   renderable.bg = lineBackground(line2);
-  renderable.attributes = line2?.bold ? TextAttributes4.BOLD : line2?.dim ? TextAttributes4.DIM : 0;
+  renderable.attributes = line2?.bold ? TextAttributes3.BOLD : line2?.dim ? TextAttributes3.DIM : 0;
 }
 function clearTextLines(renderables, from = 0) {
   for (let index = from;index < renderables.length; index += 1) {
@@ -24996,19 +25456,30 @@ var TRANSPARENT2, HOVER_BG;
 var init_text = __esm(() => {
   init_theme2();
   init_hover();
-  TRANSPARENT2 = RGBA4.fromInts(0, 0, 0, 0);
-  HOVER_BG = RGBA4.fromHex(RIG_UI.hover);
+  TRANSPARENT2 = RGBA3.fromInts(0, 0, 0, 0);
+  HOVER_BG = RGBA3.fromHex(RIG_UI.hover);
 });
 
+// packages/cli/src/app-opentui/render/terminal-handoff.ts
+function resumeRendererClean(renderer) {
+  try {
+    renderer.pendingSuspendedTerminalSetup = true;
+  } catch {}
+  renderer.resume();
+  try {
+    renderer.requestRender?.();
+  } catch {}
+}
+
 // packages/cli/src/app-opentui/render/panels.ts
-import { RGBA as RGBA5, ScrollBoxRenderable } from "@opentui/core";
+import { RGBA as RGBA4, ScrollBoxRenderable } from "@opentui/core";
 function hexToRgba(hex, alpha) {
   const clean = hex.replace(/^#/, "");
   const full = clean.length === 3 ? clean.split("").map((part) => `${part}${part}`).join("") : clean;
   const value = Number.parseInt(full, 16);
   if (!Number.isFinite(value))
-    return RGBA5.fromInts(14, 15, 17, alpha);
-  return RGBA5.fromInts(value >> 16 & 255, value >> 8 & 255, value & 255, alpha);
+    return RGBA4.fromInts(14, 15, 17, alpha);
+  return RGBA4.fromInts(value >> 16 & 255, value >> 8 & 255, value & 255, alpha);
 }
 function panelBackground(panel) {
   return hexToRgba(panel.backgroundColor ?? RIG_UI.panel, PANEL_OPAQUE_ALPHA);
@@ -25125,12 +25596,12 @@ var TRANSPARENT3, MAX_PANEL_LINES = 420, PANEL_OPAQUE_ALPHA = 255, PANEL_BORDER;
 var init_panels = __esm(() => {
   init_theme2();
   init_text();
-  TRANSPARENT3 = RGBA5.fromInts(0, 0, 0, 0);
+  TRANSPARENT3 = RGBA4.fromInts(0, 0, 0, 0);
   PANEL_BORDER = hexToRgba(RIG_UI.border, 255);
 });
 
 // packages/cli/src/app-opentui/render/type-bar.ts
-import { BoxRenderable, InputRenderable, InputRenderableEvents, RGBA as RGBA6, StyledText as StyledText3, TextRenderable as TextRenderable2 } from "@opentui/core";
+import { BoxRenderable, InputRenderable, InputRenderableEvents, RGBA as RGBA5, StyledText as StyledText2, TextRenderable as TextRenderable2 } from "@opentui/core";
 function createTypeBar(renderer) {
   const background = new BoxRenderable(renderer, {
     id: "typebar-card",
@@ -25277,13 +25748,13 @@ function formatFooter(footer, width) {
     chunks.push(cell4.style(text2));
     used += visibleWidth(text2);
   });
-  return new StyledText3(chunks);
+  return new StyledText2(chunks);
 }
 var TYPEBAR_BG, TYPEBAR_BORDER, FOOTER_SEPARATOR = "  \xB7  ";
 var init_type_bar = __esm(() => {
   init_theme2();
-  TYPEBAR_BG = RGBA6.fromInts(20, 25, 14, 224);
-  TYPEBAR_BORDER = RGBA6.fromInts(204, 255, 77, 92);
+  TYPEBAR_BG = RGBA5.fromInts(20, 25, 14, 224);
+  TYPEBAR_BORDER = RGBA5.fromInts(204, 255, 77, 92);
 });
 
 // packages/cli/src/app-opentui/render/native-host.ts
@@ -25291,7 +25762,7 @@ import {
   BoxRenderable as BoxRenderable2,
   CodeRenderable,
   DiffRenderable,
-  RGBA as RGBA7,
+  RGBA as RGBA6,
   ScrollBoxRenderable as ScrollBoxRenderable2,
   SyntaxStyle,
   TextRenderable as TextRenderable3,
@@ -25301,19 +25772,19 @@ function rigSyntaxStyle() {
   if (syntaxStyle)
     return syntaxStyle;
   syntaxStyle = SyntaxStyle.fromStyles({
-    keyword: { fg: RGBA7.fromHex(RIG_UI.magenta), bold: true },
-    string: { fg: RGBA7.fromHex(RIG_UI.lime) },
-    number: { fg: RGBA7.fromHex(RIG_UI.cyan) },
-    comment: { fg: RGBA7.fromHex(RIG_UI.ink4), italic: true },
-    function: { fg: RGBA7.fromHex(RIG_UI.cyan) },
-    type: { fg: RGBA7.fromHex(RIG_UI.limeDim) },
-    constant: { fg: RGBA7.fromHex(RIG_UI.yellow) },
-    default: { fg: RGBA7.fromHex(RIG_UI.ink2) }
+    keyword: { fg: RGBA6.fromHex(RIG_UI.magenta), bold: true },
+    string: { fg: RGBA6.fromHex(RIG_UI.lime) },
+    number: { fg: RGBA6.fromHex(RIG_UI.cyan) },
+    comment: { fg: RGBA6.fromHex(RIG_UI.ink4), italic: true },
+    function: { fg: RGBA6.fromHex(RIG_UI.cyan) },
+    type: { fg: RGBA6.fromHex(RIG_UI.limeDim) },
+    constant: { fg: RGBA6.fromHex(RIG_UI.yellow) },
+    default: { fg: RGBA6.fromHex(RIG_UI.ink2) }
   });
   return syntaxStyle;
 }
 function tableContent(rows) {
-  return rows.map((row, rowIndex) => row.map((cell4) => [{ __isChunk: true, text: cell4, fg: RGBA7.fromHex(rowIndex === 0 ? RIG_UI.ink3 : RIG_UI.ink2) }]));
+  return rows.map((row, rowIndex) => row.map((cell4) => [{ __isChunk: true, text: cell4, fg: RGBA6.fromHex(rowIndex === 0 ? RIG_UI.ink3 : RIG_UI.ink2) }]));
 }
 function createNativeHost(renderer) {
   try {
@@ -25462,10 +25933,14 @@ var init_preloader = __esm(() => {
 });
 
 // packages/cli/src/app-opentui/scenes/error.ts
+function errorActions(state) {
+  return shouldOfferRemoteLinkRepair(state, state.error?.message) ? [...ERROR_ACTIONS, ERROR_REPAIR_LINK_ACTION] : ERROR_ACTIONS;
+}
 function renderErrorScene(state) {
   const message2 = state.error?.message ?? "Unknown app error";
   const hint = state.error?.hint ?? "Use the actions below to recover.";
-  const selected = Math.max(0, Math.min(3, state.selection.index));
+  const actions = errorActions(state);
+  const selected = Math.max(0, Math.min(actions.length - 1, state.selection.index));
   return makeSceneFrame({
     scene: "error",
     title: "Error",
@@ -25483,7 +25958,7 @@ function renderErrorScene(state) {
         ...hint ? [line(hint, { fg: RIG_UI.yellow })] : [],
         line("", { fg: RIG_UI.ink3 }),
         line("ACTIONS", { fg: RIG_UI.ink3, bold: true }),
-        ...ERROR_ACTIONS.map(({ detail, item }, index) => selectableDeckRow({ label: item.label, detail, index, active: selected === index }, item))
+        ...actions.map(({ detail, item }, index) => selectableDeckRow({ label: item.label, detail, index, active: selected === index }, item))
       ],
       backgroundColor: RIG_UI.panel,
       backgroundAlpha: 184,
@@ -25500,18 +25975,19 @@ function renderErrorScene(state) {
     live: true
   });
 }
-var ERROR_ACTIONS;
+var ERROR_ACTIONS, ERROR_REPAIR_LINK_ACTION;
 var init_error = __esm(() => {
   init_drone();
   init_theme2();
+  init_remote_link();
   init_scene();
   init_selectable();
   ERROR_ACTIONS = [
     { detail: "return to dashboard", item: { id: "main", label: "main", intent: { scene: "main", argv: [], action: { kind: "refresh", label: "Back to dashboard" } }, message: "back to dashboard" } },
     { detail: "run diagnostics", item: { id: "doctor", label: "doctor", intent: { scene: "doctor", argv: ["doctor"], action: { kind: "doctor-run", label: "Run doctor" } }, message: "run diagnostics" } },
-    { detail: "open server controls", item: { id: "server", label: "server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Open server controls" } }, message: "open server controls" } },
-    { detail: "repair project/server/auth link", item: { id: "repair", label: "repair", intent: { scene: "command", argv: ["init", "--repair"], action: { kind: "command-run", label: "Repair project link" } }, message: "repair project link" } }
+    { detail: "open server controls", item: { id: "server", label: "server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Open server controls" } }, message: "open server controls" } }
   ];
+  ERROR_REPAIR_LINK_ACTION = { detail: "backfill or prepare selected remote project-root link", item: { id: "repair-link", label: "repair link", intent: { scene: "server", argv: ["server", "repair-link"], action: { kind: "remote-link-repair", label: "Repair remote link", payload: { returnScene: "server" } } }, message: "repair remote project link" } };
 });
 
 // packages/cli/src/app-opentui/scenes/help.ts
@@ -25686,7 +26162,7 @@ function configuredMenuRows(selectedIndex2) {
   }));
 }
 function onboardingRows(selectedIndex2) {
-  const primary = selectableDeckRow({ label: "setup", detail: "Start guided setup \u2014 recommended", active: selectedIndex2 === 0 }, ONBOARD_PRIMARY);
+  const primary = selectableDeckRow({ label: "init", detail: "Start guided init \u2014 recommended", active: selectedIndex2 === 0 }, ONBOARD_PRIMARY);
   const secondary = ONBOARD_SECONDARY.map(([label, detail, item], index) => ({
     ...deckRow({ label, detail, index: index + 1, active: selectedIndex2 === index + 1, activateOnClick: true }),
     selectable: item
@@ -25746,7 +26222,7 @@ function renderMainScene(state, layout) {
     statusLine(state)
   ] : [
     line("WELCOME", { fg: RIG_UI.ink, bold: true }),
-    line("This project isn't set up yet. One guided flow gets you running.", { fg: RIG_UI.ink2 }),
+    line("This project isn't initialized yet. One native init flow gets you running.", { fg: RIG_UI.ink2 }),
     blank(),
     line("GET STARTED", { fg: RIG_UI.ink, bold: true }),
     ...onboardingRows(actionSelected),
@@ -25787,7 +26263,7 @@ var init_main = __esm(() => {
   init_theme2();
   init_fleet_stats();
   CONFIGURED_MENU = [
-    ["init", "setup, reconfigure, repair project state", { id: "init", label: "init", intent: { scene: "command", argv: ["init"], action: { kind: "command-run", label: "Run init" } }, message: "run setup/reconfigure flow" }],
+    ["init", "guided setup, reconfigure, repair project state", { id: "init", label: "init", intent: { scene: "init", argv: ["init"], action: { kind: "refresh", label: "Open init" } }, message: "open native init flow" }],
     ["server", "local/remote target, auth, linkage", { id: "server", label: "server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Checking server" } }, message: "check selected server" }],
     ["github", "auth, selected repo, stored token", { id: "github", label: "github", intent: { scene: "server", argv: ["github", "auth", "status"], action: { kind: "refresh", label: "Checking GitHub auth" } }, message: "check GitHub auth" }],
     ["tasks", "browse, filter, dispatch, attach active work", { id: "tasks", label: "tasks", intent: { scene: "tasks", argv: ["tasks"], action: { kind: "refresh", label: "Opening tasks" } }, message: "selected tasks" }],
@@ -25806,10 +26282,10 @@ var init_main = __esm(() => {
     ["help", "all actions, shortcuts, mouse controls", { id: "help", label: "help", intent: { scene: "help", argv: ["help"], action: { kind: "none", label: "Opening help" } }, message: "selected help" }]
   ];
   ONBOARD_PRIMARY = {
-    id: "onboard-setup",
-    label: "Start guided setup",
-    intent: { scene: "init", argv: ["init"], action: { kind: "refresh", label: "Setup" } },
-    message: "open the guided setup checklist"
+    id: "onboard-init",
+    label: "Start guided init",
+    intent: { scene: "init", argv: ["init"], action: { kind: "refresh", label: "Init" } },
+    message: "open the native init checklist"
   };
   ONBOARD_SECONDARY = [
     ["server", "select a local or remote target", { id: "server", label: "server", intent: { scene: "server", argv: ["server", "status"], action: { kind: "refresh", label: "Checking server" } }, message: "check selected server" }],
@@ -25822,6 +26298,12 @@ var init_main = __esm(() => {
   TILE_TASKS = { id: "tile-tasks", label: "tasks", intent: { scene: "tasks", argv: ["tasks"], action: { kind: "refresh", label: "Opening tasks" } }, message: "ready tasks \u2014 dispatch work" };
 });
 
+// packages/cli/src/app-opentui/pi-pty-host.ts
+function getActivePiHost() {
+  return null;
+}
+function stopActivePiHost(_reason) {}
+
 // packages/cli/src/app-opentui/runtime.ts
 var exports_runtime = {};
 __export(exports_runtime, {
@@ -25841,7 +26323,7 @@ __export(exports_runtime, {
 });
 import { existsSync as existsSync23 } from "fs";
 import { resolve as resolve30 } from "path";
-import { BoxRenderable as BoxRenderable3, RGBA as RGBA8, StyledText as StyledText4, TextRenderable as TextRenderable4, createCliRenderer } from "@opentui/core";
+import { BoxRenderable as BoxRenderable3, RGBA as RGBA7, StyledText as StyledText3, TextRenderable as TextRenderable4, createCliRenderer } from "@opentui/core";
 function inboxPendingCount(state) {
   const inbox = state.data.inbox;
   if (!inbox || typeof inbox !== "object" || Array.isArray(inbox))
@@ -25888,7 +26370,7 @@ function entryIntentForScene(scene) {
     case "doctor":
       return { scene, argv: ["doctor"], action: { kind: "doctor-run", label: "Doctor" } };
     case "init":
-      return { scene, argv: ["init"], action: { kind: "refresh", label: "Setup" } };
+      return { scene, argv: ["init"], action: { kind: "refresh", label: "Init" } };
     case "run-detail":
       return { scene, argv: ["run", "status"], action: { kind: "refresh", label: "Run" } };
     case "pi":
@@ -25977,7 +26459,7 @@ function sceneSectionLabel(scene) {
     handoff: "pi console",
     server: "server",
     doctor: "doctor",
-    init: "setup",
+    init: "init",
     pi: "pi",
     plugin: "plugins",
     repo: "repo",
@@ -26010,7 +26492,7 @@ function buildNavStrip(state) {
       chunks.push(otuiBold(styles.yellow(String(badgeCount))));
     }
   });
-  return new StyledText4(chunks);
+  return new StyledText3(chunks);
 }
 function requestRender(renderer) {
   renderer.requestRender?.();
@@ -26238,7 +26720,8 @@ async function launchRigOpenTuiApp(options) {
     },
     suspend: () => renderer?.suspend(),
     resume: () => {
-      renderer?.resume();
+      if (renderer)
+        resumeRendererClean(renderer);
       renderApp();
     },
     destroy: () => renderer?.destroy()
@@ -26466,7 +26949,7 @@ async function launchRigOpenTuiApp(options) {
           }
           for (const adapter of options.adapters ?? [])
             await adapter.start?.(runtime);
-          liveEvents = await connectRigServerEvents(options.projectRoot, {
+          connectRigServerEvents(options.projectRoot, {
             onSnapshotInvalidated: () => refreshCurrentDataScene(),
             onRunLogAppended: () => {
               const scene = store.getState().scene;
@@ -26474,11 +26957,17 @@ async function launchRigOpenTuiApp(options) {
                 refreshCurrentDataScene();
             },
             onStatus: (status) => store.patch({ footer: { live: liveLinkLabel(status) } })
-          }).catch(() => null);
-          if (!liveEvents)
-            store.patch({ footer: { live: liveLinkLabel("disconnected") } });
-          if (liveEvents)
+          }).then((subscription) => {
+            if (destroyed) {
+              subscription.close();
+              return;
+            }
+            liveEvents = subscription;
             resources.add(() => liveEvents?.close());
+          }).catch(() => {
+            if (!destroyed)
+              store.patch({ footer: { live: liveLinkLabel("disconnected") } });
+          });
           await runtime.runIntent(store.getState().intent);
         } catch (error) {
           const normalized = normalizeError(error);
@@ -26664,15 +27153,14 @@ var init_runtime = __esm(() => {
   init_help();
   init_main();
   init_selectable();
-  init_pi_pty_host();
-  PRELOADER_BACKDROP = RGBA8.fromHex(RIG_UI.bg);
+  PRELOADER_BACKDROP = RGBA7.fromHex(RIG_UI.bg);
   PRIMARY_NAV = [
     { id: "cockpit", label: "Cockpit", scene: "main", argv: ["main"], enterLabel: "Cockpit", member: ["main"] },
     { id: "runs", label: "Runs", scene: "fleet", argv: ["runs"], enterLabel: "Runs", member: ["fleet", "run-detail", "inspect", "handoff"] },
     { id: "tasks", label: "Tasks", scene: "tasks", argv: ["tasks"], enterLabel: "Tasks", member: ["tasks"] },
     { id: "inbox", label: "Inbox", scene: "inbox", argv: ["inbox"], enterLabel: "Inbox", member: ["inbox"], badge: inboxPendingCount },
     { id: "stats", label: "Stats", scene: "family", argv: ["stats"], enterLabel: "Stats", member: ["family"] },
-    { id: "setup", label: "Setup", scene: "init", argv: ["init"], enterLabel: "Setup", member: ["init", "doctor", "server", "pi", "plugin", "repo", "workspace"] },
+    { id: "init", label: "Init", scene: "init", argv: ["init"], enterLabel: "Init", member: ["init", "doctor", "server", "pi", "plugin", "repo", "workspace"] },
     { id: "help", label: "Help", scene: "help", argv: ["help"], enterLabel: "Help", member: ["help"] }
   ];
   SCENE_DATA_KEY = {
@@ -26782,10 +27270,10 @@ var init_scroll = __esm(() => {
 // packages/cli/src/app-opentui/react/SceneFrameView.tsx
 import { useEffect as useEffect2, useRef as useRef2 } from "react";
 import { useRenderer as useRenderer2 } from "@opentui/react";
-import { TextAttributes as TextAttributes5 } from "@opentui/core";
+import { TextAttributes as TextAttributes4 } from "@opentui/core";
 import { jsxDEV, Fragment } from "@opentui/react/jsx-dev-runtime";
 function lineAttributes(line2) {
-  return line2?.bold ? TextAttributes5.BOLD : line2?.dim ? TextAttributes5.DIM : 0;
+  return line2?.bold ? TextAttributes4.BOLD : line2?.dim ? TextAttributes4.DIM : 0;
 }
 function lineContent(line2) {
   return line2.styledText ?? line2.text ?? "";
@@ -27036,7 +27524,7 @@ var init_nav = __esm(() => {
     { id: "tasks", label: "Tasks", scene: "tasks", argv: ["tasks"], enterLabel: "Tasks", member: ["tasks"] },
     { id: "inbox", label: "Inbox", scene: "inbox", argv: ["inbox"], enterLabel: "Inbox", member: ["inbox"], badge: inboxPendingCount2 },
     { id: "stats", label: "Stats", scene: "family", argv: ["stats"], enterLabel: "Stats", member: ["family"] },
-    { id: "setup", label: "Setup", scene: "init", argv: ["init"], enterLabel: "Setup", member: ["init", "doctor", "server", "pi", "plugin", "repo", "workspace"] },
+    { id: "init", label: "Init", scene: "init", argv: ["init"], enterLabel: "Init", member: ["init", "doctor", "server", "pi", "plugin", "repo", "workspace"] },
     { id: "help", label: "Help", scene: "help", argv: ["help"], enterLabel: "Help", member: ["help"] }
   ];
 });
@@ -27168,8 +27656,48 @@ async function launchRigReactApp(options) {
   const store = createAppStore(initialState);
   const events = createAppEventBus();
   let renderer = null;
+  let root = null;
   let runnerPromise = null;
   let suppressHistoryPush = false;
+  let resolveExit = () => {};
+  const appExit = new Promise((resolve31) => {
+    resolveExit = resolve31;
+  });
+  let relaunching = false;
+  const mountRenderer = async () => {
+    renderer = await createCliRenderer2({
+      screenMode: "alternate-screen",
+      exitOnCtrlC: false,
+      targetFps: 30,
+      maxFps: 30,
+      useMouse: true,
+      autoFocus: false,
+      useKittyKeyboard: { disambiguate: true }
+    });
+    renderer.on("destroy", () => {
+      if (!relaunching)
+        resolveExit();
+    });
+    root = createRoot(renderer);
+    root.render(/* @__PURE__ */ jsxDEV4(RigAppProvider, {
+      value: { store, runtime, runAppAction },
+      children: /* @__PURE__ */ jsxDEV4(App, {
+        sceneRenderers: options.sceneRenderers
+      }, undefined, false, undefined, this)
+    }, undefined, false, undefined, this));
+    relaunching = false;
+  };
+  const teardownRenderer = () => {
+    relaunching = true;
+    try {
+      root?.unmount();
+    } catch {}
+    root = null;
+    try {
+      renderer?.destroy();
+    } catch {}
+    renderer = null;
+  };
   const runAppAction = (label, action) => {
     action().catch((error) => {
       const n = normalizeError(error);
@@ -27211,8 +27739,10 @@ async function launchRigReactApp(options) {
       runnerPromise ??= options.initializeRuntime();
       return runnerPromise;
     },
-    suspend: () => renderer?.suspend(),
-    resume: () => renderer?.resume(),
+    suspend: () => teardownRenderer(),
+    resume: async () => {
+      await mountRenderer();
+    },
     destroy: () => renderer?.destroy()
   };
   events.subscribe((event) => store.patch(reduceAppEvent(store.getState(), event)));
@@ -27220,15 +27750,7 @@ async function launchRigReactApp(options) {
   if (typeof tick.unref === "function") {
     tick.unref();
   }
-  renderer = await createCliRenderer2({
-    screenMode: "alternate-screen",
-    exitOnCtrlC: false,
-    targetFps: 30,
-    maxFps: 30,
-    useMouse: true,
-    autoFocus: false,
-    useKittyKeyboard: { disambiguate: true }
-  });
+  await mountRenderer();
   let liveEvents = null;
   const canAutoRefresh = (state) => {
     if (state.status === "action" || state.status === "loading")
@@ -27259,12 +27781,6 @@ async function launchRigReactApp(options) {
   }, FALLBACK_REFRESH_MS);
   if (typeof poll.unref === "function")
     poll.unref();
-  createRoot(renderer).render(/* @__PURE__ */ jsxDEV4(RigAppProvider, {
-    value: { store, runtime, runAppAction },
-    children: /* @__PURE__ */ jsxDEV4(App, {
-      sceneRenderers: options.sceneRenderers
-    }, undefined, false, undefined, this)
-  }, undefined, false, undefined, this));
   queueMicrotask(() => {
     (async () => {
       try {
@@ -27274,7 +27790,7 @@ async function launchRigReactApp(options) {
         }
         for (const adapter of options.adapters ?? [])
           await adapter.start?.(runtime);
-        liveEvents = await connectRigServerEvents(options.projectRoot, {
+        connectRigServerEvents(options.projectRoot, {
           onSnapshotInvalidated: () => refreshCurrentDataScene(),
           onRunLogAppended: () => {
             const scene = store.getState().scene;
@@ -27282,9 +27798,11 @@ async function launchRigReactApp(options) {
               refreshCurrentDataScene();
           },
           onStatus: (status) => store.patch({ footer: { live: liveLinkLabel(status) } })
-        }).catch(() => null);
-        if (!liveEvents)
+        }).then((subscription) => {
+          liveEvents = subscription;
+        }).catch(() => {
           store.patch({ footer: { live: liveLinkLabel("disconnected") } });
+        });
         await runtime.runIntent(store.getState().intent);
       } catch (error) {
         const n = normalizeError(error);
@@ -27292,14 +27810,11 @@ async function launchRigReactApp(options) {
       }
     })();
   });
-  await new Promise((resolve31) => {
-    renderer?.on("destroy", () => {
-      clearInterval(tick);
-      clearInterval(poll);
-      liveEvents?.close();
-      resolve31();
-    });
-  });
+  await appExit;
+  clearInterval(tick);
+  clearInterval(poll);
+  liveEvents?.close();
+  teardownRenderer();
 }
 var POLLABLE_SCENES;
 var init_launch = __esm(() => {
@@ -27319,7 +27834,7 @@ __export(exports_bootstrap, {
   buildAppLaunchOptions: () => buildAppLaunchOptions
 });
 import { existsSync as existsSync24, readFileSync as readFileSync15 } from "fs";
-import { basename as basename6, resolve as resolve31 } from "path";
+import { basename as basename5, resolve as resolve31 } from "path";
 async function launchRigOpenTuiBootstrap(options) {
   const launchOptions = buildAppLaunchOptions(options);
   await launchOpenTuiApp(launchOptions);
@@ -27425,7 +27940,7 @@ function parsePolicyMode2(value) {
 function resolveProjectRoot2(input) {
   if (input.envProjectRoot)
     return resolve31(input.cwd, input.envProjectRoot);
-  const execName = basename6(input.execPath).toLowerCase();
+  const execName = basename5(input.execPath).toLowerCase();
   const execCandidates = execName === "rig" || execName === "rig.exe" ? [resolve31(input.execPath, "..", "..")] : [];
   const candidates = [input.cwd, ...execCandidates, resolve31(input.importDir, "..")];
   for (const candidate of candidates) {
@@ -27488,7 +28003,7 @@ var init_bootstrap = __esm(() => {
 // packages/cli/bin/rig.ts
 init_launch_routing();
 import { existsSync as existsSync25, readFileSync as readFileSync16 } from "fs";
-import { dirname as dirname5, resolve as resolve32 } from "path";
+import { dirname as dirname6, resolve as resolve32 } from "path";
 function packageVersionFrom(startDir) {
   let current = resolve32(startDir);
   while (true) {
@@ -27500,7 +28015,7 @@ function packageVersionFrom(startDir) {
           return pkg.version;
       } catch {}
     }
-    const parent = dirname5(current);
+    const parent = dirname6(current);
     if (parent === current)
       return null;
     current = parent;