Function appendSubProjectRelativePath

src/node/runtime/runtimeHelpers.ts:86–116

(
  metadata: WorkspaceMetadataForRuntime,
  runtime: Runtime,
  workspaceRoot: string
)

 * sub-project paths by falling back to the workspace root.
 */
export function appendSubProjectRelativePath(
  metadata: WorkspaceMetadataForRuntime,
  runtime: Runtime,
  workspaceRoot: string
): string {
  const subProjectPath = metadata.subProjectPath?.trim();
  if (!subProjectPath) {
    return workspaceRoot;
  }

  // Self-heal stale persisted state: project paths can change (e.g. project
  // removed/re-added at a new location, config edited by hand). When the
  // recorded sub-project path is no longer a descendant of the workspace's
  // owning project, fall back to the workspace root rather than throwing —
  // a wrong cwd is recoverable, a thrown error here breaks workspace
  // startup/commands until the user manually edits the config.
  const relativeSubProjectPath = path.relative(metadata.projectPath, subProjectPath);
  if (
    !relativeSubProjectPath ||
    relativeSubProjectPath.startsWith("..") ||
    path.isAbsolute(relativeSubProjectPath)
  ) {
    return workspaceRoot;
  }

  const runtimeRelativeSubProjectPath = relativeSubProjectPath.replace(/\\/g, "/");

  // Use the runtime path normalizer so SSH/Docker/devcontainer cwd paths use the
  // target runtime's separator semantics instead of host-only path joining.
  return runtime.normalizePath(runtimeRelativeSubProjectPath, workspaceRoot);
}

export function resolveWorkspaceExecutionPath(
  metadata: WorkspaceMetadataForRuntime,