@prisma/cli 3.0.0-beta.0 → 3.0.0-beta.10

package/dist/controllers/project.js

@@ -1,63 +1,232 @@
-import { CliError, authRequiredError, usageError, workspaceRequiredError } from "../shell/errors.js";
+import { CliError, authRequiredError, featureUnavailableError, usageError, workspaceRequiredError } from "../shell/errors.js";
 import { renderSummaryLine } from "../shell/ui.js";
 import { canPrompt } from "../shell/runtime.js";
 import { requireComputeAuth } from "../lib/auth/guard.js";
-import { resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
+import { formatCommandArgument } from "../shell/command-arguments.js";
+import { readLocalResolutionPin } from "../lib/project/local-pin.js";
+import { buildProjectSetupNextActions, inferTargetName, inspectProjectBinding, projectResolutionErrorToCliError, resolveProjectTarget, sortProjects } from "../lib/project/resolution.js";
+import { bindProjectToDirectory, isValidProjectSetupName, projectCreateFailedError, projectDirectoryBindingErrorToCliError, projectSetupNameRequiredError, resolveProjectForSetup, toProjectSummary } from "../lib/project/setup.js";
+import { promptForProjectSetupChoice } from "../lib/project/interactive-setup.js";
+import { createPreviewAppProvider } from "../lib/app/preview-provider.js";
 import { createCliUseCaseGateways } from "../use-cases/create-cli-gateways.js";
 import { requireAuthenticatedAuthState } from "./auth.js";
 import { parseGitHubRepositoryUrl, readGitOriginRemote } from "../adapters/git.js";
 import { createProjectUseCases } from "../use-cases/project.js";
 import open from "open";
+import { matchError } from "better-result";
 //#region src/controllers/project.ts
 const GITHUB_INSTALL_POLL_INTERVAL_MS = 2e3;
 const GITHUB_INSTALL_POLL_TIMEOUT_MS = 12e4;
 function isRealMode(context) {
 	return !context.runtime.fixturePath && !context.runtime.env.PRISMA_CLI_MOCK_FIXTURE_PATH;
 }
+async function readProjectListLocalBinding(cwd, workspace, projects, signal) {
+	const pinResult = await readLocalResolutionPin(cwd, signal);
+	if (pinResult.isErr()) return localPinReadErrorToInvalidLocalBinding(pinResult.error);
+	const pin = pinResult.value;
+	if (pin.kind === "present") return pin.pin.workspaceId === workspace.id && projects.some((project) => project.id === pin.pin.projectId) ? { status: "linked" } : { status: "invalid" };
+	return { status: "not-linked" };
+}
+function localPinReadErrorToInvalidLocalBinding(error) {
+	return matchError(error, {
+		LocalResolutionPinInvalidJsonError: () => ({ status: "invalid" }),
+		LocalResolutionPinInvalidShapeError: () => ({ status: "invalid" }),
+		LocalResolutionPinReadAbortedError: (error) => {
+			throw error;
+		},
+		UnhandledException: (error) => {
+			throw error;
+		}
+	});
+}
 async function runProjectList(context) {
 	const authState = await requireAuthenticatedAuthState(context);
 	const workspace = authState.workspace;
 	if (!workspace) throw workspaceRequiredError();
 	if (isRealMode(context)) {
-		const client = await requireComputeAuth(context.runtime.env);
+		const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
 		if (!client) throw authRequiredError();
+		const projects = sortProjects(await listRealWorkspaceProjects(client, workspace, context.runtime.signal));
+		const localBinding = await readProjectListLocalBinding(context.runtime.cwd, workspace, projects, context.runtime.signal);
+		const nextActions = buildProjectListNextActions(localBinding);
 		return {
 			command: "project.list",
 			result: {
 				workspace,
-				projects: sortProjects(await listRealWorkspaceProjects(client, workspace)).map(toProjectSummary)
+				projects: projects.map(toProjectSummary),
+				localBinding
 			},
 			warnings: [],
-			nextSteps: []
+			nextSteps: [],
+			nextActions
 		};
 	}
+	const result = await createProjectUseCases(createCliUseCaseGateways(context)).list(authState);
+	const localBinding = await readProjectListLocalBinding(context.runtime.cwd, workspace, result.projects, context.runtime.signal);
+	const nextActions = buildProjectListNextActions(localBinding);
 	return {
 		command: "project.list",
-		result: await createProjectUseCases(createCliUseCaseGateways(context)).list(authState),
+		result: {
+			...result,
+			localBinding
+		},
 		warnings: [],
-		nextSteps: []
+		nextSteps: [],
+		nextActions
 	};
 }
+function buildProjectListNextActions(localBinding) {
+	return localBinding?.status === "linked" ? [] : buildProjectSetupNextActions({
+		createCommand: "prisma-cli project create <name>",
+		reason: localBinding?.status === "invalid" ? "This directory has an invalid local Project binding. Ask the user which Prisma Project to link before running Project-scoped commands." : "This directory is not linked to a Prisma Project. Project list shows available Projects, but none is selected for this directory."
+	});
+}
 async function runProjectShow(context, explicitProject) {
 	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
 	if (!workspace) throw workspaceRequiredError();
+	const result = isRealMode(context) ? await resolveProjectShowInRealMode(context, workspace, explicitProject) : await resolveProjectShowInFixtureMode(context, workspace, explicitProject);
 	return {
 		command: "project.show",
-		result: isRealMode(context) ? await resolveProjectShowInRealMode(context, workspace, explicitProject) : await resolveProjectShowInFixtureMode(context, workspace, explicitProject),
+		result,
 		warnings: [],
-		nextSteps: []
+		nextSteps: [],
+		nextActions: result.project === null ? buildProjectSetupNextActions({
+			commandName: "project show",
+			suggestedProjectName: result.suggestedProjectName,
+			reason: "This directory is not linked to a Prisma Project. Package and directory names can suggest setup defaults, but they do not select a Project."
+		}) : []
+	};
+}
+async function runProjectCreate(context, projectName) {
+	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
+	if (!workspace) throw workspaceRequiredError();
+	if (!isValidProjectSetupName(projectName)) throw projectSetupNameRequiredError("project create");
+	if (!isRealMode(context)) throw featureUnavailableError("Project create is not available in fixture mode", "Creating Projects requires live platform integration.", "Rerun without fixture mode enabled to create a Project.", ["prisma-cli auth login"], "project");
+	const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
+	if (!client) throw authRequiredError();
+	const provider = createPreviewAppProvider(client);
+	const name = projectName.trim();
+	const created = await provider.createProject({
+		name,
+		signal: context.runtime.signal
+	}).catch((error) => {
+		throw projectCreateFailedError(error, name, workspace, {
+			nextSteps: ["prisma-cli project list", "prisma-cli project link <id-or-name>"],
+			permissionFix: "Grant the token permission to create Projects in this workspace, or link an existing Project.",
+			fallbackFix: "Retry the command, or choose an existing Project with prisma-cli project link <id-or-name>."
+		});
+	});
+	const bindResult = await bindProjectToDirectory(context, workspace, {
+		id: created.id,
+		name: created.name
+	}, "created");
+	if (bindResult.isErr()) throw projectDirectoryBindingErrorToCliError(bindResult.error);
+	return {
+		command: "project.create",
+		result: bindResult.value,
+		warnings: [],
+		nextSteps: ["prisma-cli app deploy"]
 	};
 }
+async function runProjectLink(context, projectRef) {
+	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
+	if (!workspace) throw workspaceRequiredError();
+	let provider = null;
+	let projects;
+	if (isRealMode(context)) {
+		const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
+		if (!client) throw authRequiredError();
+		provider = createPreviewAppProvider(client);
+		projects = await listRealWorkspaceProjects(client, workspace, context.runtime.signal);
+	} else projects = listFixtureWorkspaceProjects(context, workspace);
+	let result;
+	if (projectRef?.trim()) result = await requireProjectDirectoryBinding(context, workspace, toProjectSummary(resolveProjectForSetup(projectRef.trim(), projects, workspace)), "linked");
+	else if (canPrompt(context) && !context.flags.yes) result = await resolveInteractiveProjectLinkSetup(context, workspace, projects, provider);
+	else throw await projectLinkTargetRequiredError(context, projects);
+	return {
+		command: "project.link",
+		result,
+		warnings: [],
+		nextSteps: ["prisma-cli app deploy"]
+	};
+}
+async function resolveInteractiveProjectLinkSetup(context, workspace, projects, provider) {
+	const setup = await promptForProjectSetupChoice({
+		context,
+		projects,
+		createProject: (projectName) => {
+			if (!provider) throw featureUnavailableError("Project create is not available in fixture mode", "Creating Projects requires live platform integration.", "Rerun without fixture mode enabled to create a Project.", ["prisma-cli auth login"], "project");
+			return createProjectForLinkSetup(provider, projectName, workspace, context.runtime.signal);
+		},
+		cancel: {
+			why: "Project link needs a Project before it can continue.",
+			fix: "Choose an existing Project or create a new one, then rerun project link.",
+			nextSteps: ["prisma-cli project link <id-or-name>", "prisma-cli project create <name>"]
+		}
+	});
+	return requireProjectDirectoryBinding(context, workspace, setup.project, setup.action);
+}
+async function requireProjectDirectoryBinding(context, workspace, project, action) {
+	const bindResult = await bindProjectToDirectory(context, workspace, project, action);
+	if (bindResult.isErr()) throw projectDirectoryBindingErrorToCliError(bindResult.error);
+	return bindResult.value;
+}
+async function createProjectForLinkSetup(provider, projectName, workspace, signal) {
+	const created = await provider.createProject({
+		name: projectName,
+		signal
+	}).catch((error) => {
+		throw projectCreateFailedError(error, projectName, workspace, {
+			nextSteps: [
+				"prisma-cli project list",
+				"prisma-cli project link <id-or-name>",
+				`prisma-cli project create ${formatCommandArgument(projectName)}`
+			],
+			permissionFix: "Grant the token permission to create Projects in this workspace, or link an existing Project.",
+			fallbackFix: "Retry the command, or choose an existing Project with prisma-cli project link <id-or-name>."
+		});
+	});
+	return {
+		id: created.id,
+		name: created.name,
+		workspace
+	};
+}
+async function projectLinkTargetRequiredError(context, projects) {
+	const suggestedName = await inferTargetName(context.runtime.cwd, context.runtime.signal);
+	const createCommand = `prisma-cli project create ${formatCommandArgument(suggestedName.name)}`;
+	const recoveryCommands = ["prisma-cli project link <id-or-name>", createCommand];
+	return new CliError({
+		code: "PROJECT_LINK_TARGET_REQUIRED",
+		domain: "project",
+		summary: "Choose a Project to link this directory",
+		why: "This directory is not linked to a Prisma Project. Existing Projects are candidates until the user chooses one, and package or directory names are suggestions only.",
+		fix: "Run prisma-cli project link in a TTY to choose from the setup list, pass a Project id or name, or create a new Project.",
+		meta: {
+			suggestedProjectName: suggestedName.name,
+			suggestedProjectNameSource: suggestedName.source,
+			candidates: sortProjects(projects).map(toProjectSummary),
+			recoveryCommands
+		},
+		exitCode: 2,
+		nextSteps: ["prisma-cli project list", ...recoveryCommands],
+		nextActions: buildProjectSetupNextActions({
+			suggestedProjectName: suggestedName.name,
+			createCommand,
+			reason: "Project link needs the user to choose an existing Project or create a new one. Existing Projects, package names, and directory names are candidates only, not selections."
+		})
+	});
+}
 async function runGitConnect(context, gitUrl, options = {}) {
 	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
 	if (!workspace) throw workspaceRequiredError();
 	if (isRealMode(context)) {
-		const client = await requireComputeAuth(context.runtime.env);
+		const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
 		if (!client) throw authRequiredError();
-		const target = await resolveProjectShowInRealMode(context, workspace, options.project);
+		const target = await resolveRequiredProjectInRealMode(context, workspace, options.project, "git connect");
 		const repository = await resolveRepositoryForConnect(context, gitUrl);
 		const api = client;
-		const existing = await readFirstSourceRepository(api, target.project.id);
+		const existing = await readFirstSourceRepository(api, target.project.id, context.runtime.signal);
 		if (existing) {
 			const existingConnection = toRepositoryConnection(existing);
 			if (repositoryFullNamesMatch(existingConnection.repository.fullName, repository.fullName)) return {
@@ -72,12 +241,15 @@ async function runGitConnect(context, gitUrl, options = {}) {
 			throw repoAlreadyConnectedError(existingConnection.repository.fullName);
 		}
 		const resolvedRepository = await resolveInstalledRepository(context, api, workspace.id, repository);
-		const { data, error, response } = await api.POST("/v1/source-repositories", { body: {
-			projectId: target.project.id,
-			provider: "github",
-			providerRepositoryId: resolvedRepository.repository.id,
-			installationId: resolvedRepository.installation.id
-		} });
+		const { data, error, response } = await api.POST("/v1/source-repositories", {
+			body: {
+				projectId: target.project.id,
+				provider: "github",
+				providerRepositoryId: resolvedRepository.repository.id,
+				installationId: resolvedRepository.installation.id
+			},
+			signal: context.runtime.signal
+		});
 		if (error || !data) throw repoConnectionApiError("Failed to connect GitHub repository", response, error);
 		return {
 			command: "git.connect",
@@ -89,7 +261,7 @@ async function runGitConnect(context, gitUrl, options = {}) {
 			nextSteps: []
 		};
 	}
-	const target = await resolveProjectShowInFixtureMode(context, workspace, options.project);
+	const target = await resolveRequiredProjectInFixtureMode(context, workspace, options.project, "git connect");
 	const repository = await resolveRepositoryForConnect(context, gitUrl);
 	const existingConnection = await context.stateStore.readRepositoryConnection(target.project.id);
 	if (existingConnection) {
@@ -120,13 +292,16 @@ async function runGitDisconnect(context, options = {}) {
 	const workspace = (await requireAuthenticatedAuthState(context)).workspace;
 	if (!workspace) throw workspaceRequiredError();
 	if (isRealMode(context)) {
-		const client = await requireComputeAuth(context.runtime.env);
+		const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
 		if (!client) throw authRequiredError();
-		const target = await resolveProjectShowInRealMode(context, workspace, options.project);
+		const target = await resolveRequiredProjectInRealMode(context, workspace, options.project, "git disconnect");
 		const api = client;
-		const existing = await readFirstSourceRepository(api, target.project.id);
+		const existing = await readFirstSourceRepository(api, target.project.id, context.runtime.signal);
 		if (!existing) throw repoNotConnectedError();
-		const { error, response } = await api.DELETE("/v1/source-repositories/{id}", { params: { path: { id: existing.id } } });
+		const { error, response } = await api.DELETE("/v1/source-repositories/{id}", {
+			params: { path: { id: existing.id } },
+			signal: context.runtime.signal
+		});
 		if (error) throw repoConnectionApiError("Failed to disconnect GitHub repository", response, error);
 		return {
 			command: "git.disconnect",
@@ -138,7 +313,7 @@ async function runGitDisconnect(context, options = {}) {
 			nextSteps: []
 		};
 	}
-	const target = await resolveProjectShowInFixtureMode(context, workspace, options.project);
+	const target = await resolveRequiredProjectInFixtureMode(context, workspace, options.project, "git disconnect");
 	const existingConnection = await context.stateStore.readRepositoryConnection(target.project.id);
 	if (!existingConnection) throw repoNotConnectedError();
 	await context.stateStore.clearRepositoryConnection(target.project.id);
@@ -153,30 +328,59 @@ async function runGitDisconnect(context, options = {}) {
 	};
 }
 async function resolveProjectShowInRealMode(context, workspace, explicitProject) {
-	const client = await requireComputeAuth(context.runtime.env);
+	const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
 	if (!client) throw authRequiredError();
-	return resolveProjectTarget({
+	const result = await inspectProjectBinding({
 		context,
 		workspace,
 		explicitProject,
-		listProjects: () => listRealWorkspaceProjects(client, workspace),
-		remember: false
+		listProjects: () => listRealWorkspaceProjects(client, workspace, context.runtime.signal),
+		commandName: "project show"
 	});
+	if (result.isErr()) throw projectResolutionErrorToCliError(result.error);
+	return result.value;
+}
+async function resolveRequiredProjectInRealMode(context, workspace, explicitProject, commandName) {
+	const client = await requireComputeAuth(context.runtime.env, context.runtime.signal);
+	if (!client) throw authRequiredError();
+	const result = await resolveProjectTarget({
+		context,
+		workspace,
+		explicitProject,
+		listProjects: () => listRealWorkspaceProjects(client, workspace, context.runtime.signal),
+		commandName
+	});
+	if (result.isErr()) throw projectResolutionErrorToCliError(result.error);
+	return result.value;
 }
 async function resolveProjectShowInFixtureMode(context, workspace, explicitProject) {
-	return resolveProjectTarget({
+	const result = await inspectProjectBinding({
 		context,
 		workspace,
 		explicitProject,
 		listProjects: async () => listFixtureWorkspaceProjects(context, workspace),
-		remember: false
+		commandName: "project show"
 	});
+	if (result.isErr()) throw projectResolutionErrorToCliError(result.error);
+	return result.value;
 }
-async function listRealWorkspaceProjects(client, workspace) {
-	const { data } = await client.GET("/v1/projects", {});
+async function resolveRequiredProjectInFixtureMode(context, workspace, explicitProject, commandName) {
+	const result = await resolveProjectTarget({
+		context,
+		workspace,
+		explicitProject,
+		listProjects: async () => listFixtureWorkspaceProjects(context, workspace),
+		commandName
+	});
+	if (result.isErr()) throw projectResolutionErrorToCliError(result.error);
+	return result.value;
+}
+async function listRealWorkspaceProjects(client, workspace, signal) {
+	const { data } = await client.GET("/v1/projects", { signal });
 	return sortProjects((data?.data ?? []).filter((project) => project.workspace.id === workspace.id).map((project) => ({
 		id: project.id,
 		name: project.name,
+		..."url" in project && typeof project.url === "string" ? { url: project.url } : {},
 		slug: "slug" in project && typeof project.slug === "string" ? project.slug : null,
 		workspace: {
 			id: project.workspace.id,
@@ -188,21 +392,22 @@ function listFixtureWorkspaceProjects(context, workspace) {
 	return sortProjects(context.api.listProjectsForWorkspace(workspace.id).map((project) => ({
 		id: project.id,
 		name: project.name,
+		...project.url ? { url: project.url } : {},
 		slug: project.slug,
 		workspace
 	})));
 }
 async function resolveRepositoryForConnect(context, gitUrl) {
-	const remoteUrl = gitUrl ?? await readGitOriginRemote(context.runtime.cwd);
+	const remoteUrl = gitUrl ?? await readGitOriginRemote(context.runtime.cwd, context.runtime.signal);
 	if (!remoteUrl) throw usageError("Repository connection requires a GitHub repository URL", "No git-url was provided and the local repo does not have an origin remote.", "Pass a GitHub repository URL, or add a GitHub origin remote and rerun prisma-cli git connect.", ["prisma-cli git connect git@github.com:prisma/prisma-cli.git"], "project");
 	const repository = parseGitHubRepositoryUrl(remoteUrl);
 	if (!repository) throw unsupportedRepositoryProviderError();
 	return repository;
 }
 async function resolveInstalledRepository(context, api, workspaceId, repository) {
-	const lookup = await findRepositoryInInstallations(api, await listScmInstallations(api, workspaceId), repository);
+	const lookup = await findRepositoryInInstallations(api, await listScmInstallations(api, workspaceId, context.runtime.signal), repository, context.runtime.signal);
 	if (lookup.match) return lookup.match;
-	const installUrl = await createGitHubInstallIntent(api, workspaceId);
+	const installUrl = await createGitHubInstallIntent(api, workspaceId, context.runtime.signal);
 	const canWait = canPrompt(context);
 	const opened = await openInstallUrlIfInteractive(context, installUrl);
 	if (!canWait) {
@@ -215,11 +420,11 @@ async function resolveInstalledRepository(context, api, workspaceId, repository)
 	if (result.inspectableInstallationCount > 0) throw repoNotAccessibleError(repository, installUrl, opened);
 	throw repoInstallationRequiredError(repository, installUrl, opened);
 }
-async function findRepositoryInInstallations(api, installations, repository) {
+async function findRepositoryInInstallations(api, installations, repository, signal) {
 	let inspectableInstallationCount = 0;
 	for (const installation of installations) {
 		if (installation.provider !== "github" || installation.suspended) continue;
-		const matchedRepository = await findRepositoryInInstallationIfAvailable(api, installation.id, repository);
+		const matchedRepository = await findRepositoryInInstallationIfAvailable(api, installation.id, repository, signal);
 		if (matchedRepository === "unavailable") continue;
 		inspectableInstallationCount += 1;
 		if (matchedRepository) return {
@@ -241,7 +446,8 @@ async function waitForInstalledRepository(context, api, workspaceId, repository)
 	const deadline = Date.now() + timeoutMs;
 	let inspectableInstallationCount = 0;
 	while (Date.now() <= deadline) {
-		const lookup = await findRepositoryInInstallations(api, await listScmInstallations(api, workspaceId), repository);
+		context.runtime.signal.throwIfAborted();
+		const lookup = await findRepositoryInInstallations(api, await listScmInstallations(api, workspaceId, context.runtime.signal), repository, context.runtime.signal);
 		inspectableInstallationCount = lookup.inspectableInstallationCount;
 		if (lookup.match) return {
 			match: lookup.match,
@@ -249,7 +455,7 @@ async function waitForInstalledRepository(context, api, workspaceId, repository)
 		};
 		const remainingMs = deadline - Date.now();
 		if (remainingMs <= 0) break;
-		await sleep(Math.min(intervalMs, remainingMs));
+		await sleep(Math.min(intervalMs, remainingMs), context.runtime.signal);
 	}
 	return {
 		match: null,
@@ -267,37 +473,54 @@ function writeInstallWaitStatus(context, opened, installUrl) {
 	if (!opened) lines.push(installUrl);
 	context.output.stderr.write(`${lines.join("\n")}\n`);
 }
-function sleep(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
+function sleep(ms, signal) {
+	signal.throwIfAborted();
+	return new Promise((resolve, reject) => {
+		const onAbort = () => {
+			clearTimeout(timeout);
+			reject(signal.reason);
+		};
+		const timeout = setTimeout(() => {
+			signal.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		signal.addEventListener("abort", onAbort, { once: true });
+	});
 }
-async function listScmInstallations(api, workspaceId) {
+async function listScmInstallations(api, workspaceId, signal) {
 	const installations = [];
 	let cursor;
 	const seenCursors = /* @__PURE__ */ new Set();
 	do {
-		const { data, error, response } = await api.GET("/v1/scm-installations", { params: { query: {
-			workspaceId,
-			limit: 100,
-			...cursor ? { cursor } : {}
-		} } });
+		const { data, error, response } = await api.GET("/v1/scm-installations", {
+			params: { query: {
+				workspaceId,
+				limit: 100,
+				...cursor ? { cursor } : {}
+			} },
+			signal
+		});
 		if (error || !data) throw repoConnectionApiError("Failed to inspect GitHub App installations", response, error);
 		installations.push(...data.data);
 		cursor = readNextPaginationCursor(data.pagination, seenCursors, "Failed to inspect GitHub App installations", response);
 	} while (cursor);
 	return installations;
 }
-async function findRepositoryInInstallation(api, installationId, repository) {
+async function findRepositoryInInstallation(api, installationId, repository, signal) {
 	const expectedFullName = repository.fullName.toLowerCase();
 	let cursor;
 	const seenCursors = /* @__PURE__ */ new Set();
 	do {
-		const { data, error, response } = await api.GET("/v1/scm-installations/{installationId}/repositories", { params: {
-			path: { installationId },
-			query: {
-				limit: 100,
-				...cursor ? { cursor } : {}
-			}
-		} });
+		const { data, error, response } = await api.GET("/v1/scm-installations/{installationId}/repositories", {
+			params: {
+				path: { installationId },
+				query: {
+					limit: 100,
+					...cursor ? { cursor } : {}
+				}
+			},
+			signal
+		});
 		if (error || !data) throw repoConnectionApiError("Failed to inspect GitHub repositories", response, error);
 		const matchedRepository = data.data.find((candidate) => candidate.fullName.toLowerCase() === expectedFullName);
 		if (matchedRepository) return matchedRepository;
@@ -312,10 +535,11 @@ function readNextPaginationCursor(pagination, seenCursors, summary, response) {
 	seenCursors.add(nextCursor);
 	return nextCursor;
 }
-async function findRepositoryInInstallationIfAvailable(api, installationId, repository) {
+async function findRepositoryInInstallationIfAvailable(api, installationId, repository, signal) {
 	try {
-		return await findRepositoryInInstallation(api, installationId, repository);
+		return await findRepositoryInInstallation(api, installationId, repository, signal);
 	} catch (error) {
+		if (signal.aborted) throw error;
 		if (isUnavailableScmInstallationError(error)) return "unavailable";
 		throw error;
 	}
@@ -324,28 +548,37 @@ function isUnavailableScmInstallationError(error) {
 	if (!(error instanceof CliError) || error.code !== "REPO_CONNECTION_FAILED") return false;
 	return error.meta.status === 404 || error.meta.status === 422;
 }
-async function createGitHubInstallIntent(api, workspaceId) {
-	const { data, error, response } = await api.POST("/v1/scm-installations/install-intents", { body: {
-		provider: "github",
-		workspaceId
-	} });
+async function createGitHubInstallIntent(api, workspaceId, signal) {
+	const { data, error, response } = await api.POST("/v1/scm-installations/install-intents", {
+		body: {
+			provider: "github",
+			workspaceId
+		},
+		signal
+	});
 	if (error || !data) throw repoConnectionApiError("Failed to create GitHub App installation link", response, error);
 	return data.data.installUrl;
 }
 async function openInstallUrlIfInteractive(context, installUrl) {
 	if (!canPrompt(context)) return false;
 	try {
+		context.runtime.signal.throwIfAborted();
 		await open(installUrl);
+		context.runtime.signal.throwIfAborted();
 		return true;
-	} catch {
+	} catch (error) {
+		if (context.runtime.signal.aborted) throw error;
 		return false;
 	}
 }
-async function readFirstSourceRepository(api, projectId) {
-	const { data, error, response } = await api.GET("/v1/source-repositories", { params: { query: {
-		projectId,
-		limit: 1
-	} } });
+async function readFirstSourceRepository(api, projectId, signal) {
+	const { data, error, response } = await api.GET("/v1/source-repositories", {
+		params: { query: {
+			projectId,
+			limit: 1
+		} },
+		signal
+	});
 	if (error || !data) throw repoConnectionApiError("Failed to inspect GitHub repository connection", response, error);
 	return data.data[0] ?? null;
 }
@@ -494,11 +727,5 @@ function repoConnectionFixForStatus(status) {
 	if (status === 422) return "Make sure the GitHub App installation has access to this repository.";
 	return "Re-run with --trace for the underlying API response details.";
 }
-function toProjectSummary(project) {
-	return {
-		id: project.id,
-		name: project.name
-	};
-}
 //#endregion
-export { listRealWorkspaceProjects, runGitConnect, runGitDisconnect, runProjectList, runProjectShow };
+export { listFixtureWorkspaceProjects, listRealWorkspaceProjects, runGitConnect, runGitDisconnect, runProjectCreate, runProjectLink, runProjectList, runProjectShow };