@keystrokehq/cli 0.1.38 → 0.1.39

package/dist/index.mjs

@@ -5024,8 +5024,14 @@ function getCliTargetOptions() {
 }
 //#endregion
 //#region src/resolve-project-target.ts
-function resolveLinkedProjectRef(fromDir = process.cwd()) {
-	return readLinkedProjectConfig(fromDir).project;
+/**
+* The active project reference for the current command: the explicit global
+* `--project` flag when set, otherwise the `project` recorded in
+* keystroke.config.ts. Single source of truth for "which project" across every
+* CLI command — commands should never read the flag or linked config directly.
+*/
+function resolveActiveProjectRef(fromDir = process.cwd()) {
+	return (getCliTargetOptions().projectId ?? readLinkedProjectConfig(fromDir).project)?.trim() || void 0;
 }
 /** Activate the organization slug from keystroke.config.ts when present. */
 async function ensureLinkedOrganization(config, fromDir = process.cwd()) {
@@ -5034,7 +5040,7 @@ async function ensureLinkedOrganization(config, fromDir = process.cwd()) {
 	await activateOrganization(config, resolveOrganizationRef(await listOrganizations(config), linked.organization).organization.id);
 }
 async function resolveActiveProject(config, platform, fromDir = process.cwd()) {
-	const ref = getCliTargetOptions().projectId ?? readLinkedProjectConfig(fromDir).project;
+	const ref = resolveActiveProjectRef(fromDir);
 	if (!ref) return;
 	await ensureLinkedOrganization(config, fromDir);
 	return resolveProjectRef(platform ?? createCliPlatformClient(config), ref);
@@ -6928,11 +6934,12 @@ async function runHistoryGet(config, runId) {
 //#region src/commands/history/index.ts
 function registerHistoryCommand(program) {
 	const history = program.command("history").description("List and inspect platform run history");
-	history.command("list").description("List runs across projects in the active organization").option("--project <id>", "Filter by project id").option("--status <status>", "Filter by status (pending, running, sleeping, waiting_hook, completed, failed, canceled)").option("--kind <kind>", "Filter by kind (workflow or agent)").option("--admin", "List all org resources (org owner or admin only)").action(async (options) => {
+	history.command("list").description("List runs across projects in the active organization").option("--status <status>", "Filter by status (pending, running, sleeping, waiting_hook, completed, failed, canceled)").option("--kind <kind>", "Filter by kind (workflow or agent)").option("--admin", "List all org resources (org owner or admin only)").action(async (options) => {
 		const config = createCliConfig();
 		try {
+			const projectId = await resolveActiveProjectId(config);
 			await runHistoryList(config, {
-				...options.project ? { project: options.project } : {},
+				...projectId ? { project: projectId } : {},
 				...options.status ? { status: options.status } : {},
 				...options.kind ? { kind: options.kind } : {},
 				...options.admin ? { admin: true } : {}
@@ -7327,8 +7334,9 @@ async function runInit(options) {
 //#endregion
 //#region src/commands/init.ts
 function registerInitCommand(program) {
-	program.command("init").description("Create a new keystroke project from a template").argument("[directory]", "Directory to create the project in").option("--name <name>", "Project name (kebab-case)").option("--template <name>", "Template to use", "hello-world").option("-y, --yes", "Skip prompts (headless mode for scripts and AI agents)").option("--skip-install", "Skip dependency installation").option("--pm <manager>", "Package manager: npm, pnpm, yarn, or bun").option("--no-example", "Scaffold without the example action, agent, and workflow").option("--project <slug>", "Platform project slug to write into keystroke.config.ts").option("--organization <slug>", "Platform organization slug to write into keystroke.config.ts").action(async (directory, options) => {
+	program.command("init").description("Create a new keystroke project from a template").argument("[directory]", "Directory to create the project in").option("--name <name>", "Project name (kebab-case)").option("--template <name>", "Template to use", "hello-world").option("-y, --yes", "Skip prompts (headless mode for scripts and AI agents)").option("--skip-install", "Skip dependency installation").option("--pm <manager>", "Package manager: npm, pnpm, yarn, or bun").option("--no-example", "Scaffold without the example action, agent, and workflow").option("--organization <slug>", "Platform organization slug to write into keystroke.config.ts").action(async (directory, options) => {
 		try {
+			const project = getCliTargetOptions().projectId;
 			const result = await runInit({
 				directory,
 				name: options.name,
@@ -7337,7 +7345,7 @@ function registerInitCommand(program) {
 				skipInstall: options.skipInstall,
 				packageManager: options.pm,
 				noExample: options.example === false,
-				project: options.project,
+				project,
 				organization: options.organization,
 				version: readCliVersion()
 			});
@@ -7345,7 +7353,7 @@ function registerInitCommand(program) {
 			process.stdout.write("\nNext steps:\n");
 			process.stdout.write(`  cd ${result.targetDir}\n`);
 			process.stdout.write("  keystroke auth login                  # once\n");
-			if (!options.project) process.stdout.write("  keystroke project link --project <slug>  # link this directory to a platform project\n");
+			if (!project) process.stdout.write("  keystroke project link --project <slug>  # link this directory to a platform project\n");
 			process.stdout.write("  keystroke deploy                    # build + ship src/ to the platform\n");
 		} catch (error) {
 			const message = error instanceof Error ? error.message : "Init failed";
@@ -7483,21 +7491,21 @@ async function runProjectLink(config, projectRef, fromDir = process.cwd()) {
 }
 //#endregion
 //#region src/commands/project/run-project-members.ts
-async function resolveMembersProject(platform, config, projectRef) {
-	const ref = projectRef ?? getCliTargetOptions().projectId ?? readLinkedProjectConfig().project;
+async function resolveMembersProject(platform) {
+	const ref = resolveActiveProjectRef();
 	if (!ref) throw new Error("Usage: keystroke --project <slug> project members <command>");
 	return resolveProjectRef(platform, ref);
 }
-async function runProjectMembersList(config, options) {
+async function runProjectMembersList(config) {
 	await withActivePlatformClient(config, async (platform) => {
-		const project = await resolveMembersProject(platform, config, options.projectRef);
+		const project = await resolveMembersProject(platform);
 		const members = await platform.members.listForProject(project.id);
 		process.stdout.write(`${JSON.stringify({ members }, null, 2)}\n`);
 	});
 }
 async function runProjectMembersInvite(config, input) {
 	await withActivePlatformClient(config, async (platform) => {
-		const project = await resolveMembersProject(platform, config, input.projectRef);
+		const project = await resolveMembersProject(platform);
 		const result = await platform.members.inviteToProject({
 			projectId: project.id,
 			emails: input.emails,
@@ -7508,21 +7516,21 @@ async function runProjectMembersInvite(config, input) {
 }
 async function runProjectMembersRole(config, input) {
 	await withActivePlatformClient(config, async (platform) => {
-		const project = await resolveMembersProject(platform, config, input.projectRef);
+		const project = await resolveMembersProject(platform);
 		const member = await platform.members.updateProjectMember(project.id, input.userId, { role: input.role });
 		process.stdout.write(`${JSON.stringify({ member }, null, 2)}\n`);
 	});
 }
 async function runProjectMembersRemove(config, input) {
 	await withActivePlatformClient(config, async (platform) => {
-		const project = await resolveMembersProject(platform, config, input.projectRef);
+		const project = await resolveMembersProject(platform);
 		await platform.members.removeProjectMember(project.id, input.userId);
 		process.stdout.write(`${JSON.stringify({ removed: input.userId }, null, 2)}\n`);
 	});
 }
-async function runProjectMembersLeave(config, options) {
+async function runProjectMembersLeave(config) {
 	await withActivePlatformClient(config, async (platform) => {
-		const project = await resolveMembersProject(platform, config, options.projectRef);
+		const project = await resolveMembersProject(platform);
 		await platform.members.leaveProject(project.id);
 		process.stdout.write(`${JSON.stringify({ left: project.id }, null, 2)}\n`);
 	});
@@ -7536,13 +7544,6 @@ function parseProjectRole$1(role) {
 	if (role === "admin" || role === "builder") return role;
 	throw new Error("Role must be admin or builder");
 }
-function resolveProjectRefOption$1(config, optionsProject) {
-	return optionsProject ?? getCliTargetOptions().projectId ?? readLinkedProjectConfig().project;
-}
-function projectRefInput$1(config, optionsProject) {
-	const projectRef = resolveProjectRefOption$1(config, optionsProject);
-	return projectRef ? { projectRef } : {};
-}
 async function handleProjectMembersError(fallback, action) {
 	const config = createCliConfig();
 	try {
@@ -7557,80 +7558,67 @@ async function handleProjectMembersError(fallback, action) {
 }
 function registerProjectMembersCommand(project) {
 	const members = project.command("members").description("Manage members for a platform project");
-	members.command("list").description("List members for a project").option("--project <slug>", "Project slug").action(async (options) => {
+	members.command("list").description("List members for a project").action(async () => {
 		const config = createCliConfig();
 		await handleProjectMembersError("List project members failed", async () => {
-			await runProjectMembersList(config, projectRefInput$1(config, options.project));
+			await runProjectMembersList(config);
 		});
 	});
-	members.command("invite").description("Invite people to a project").option("--project <slug>", "Project slug").requiredOption("--email <email>", "Email address (repeat for multiple)", collectEmails, []).requiredOption("--role <role>", "Project role (admin or builder)").action(async (options) => {
+	members.command("invite").description("Invite people to a project").requiredOption("--email <email>", "Email address (repeat for multiple)", collectEmails, []).requiredOption("--role <role>", "Project role (admin or builder)").action(async (options) => {
 		const config = createCliConfig();
 		await handleProjectMembersError("Invite project members failed", async () => {
 			await runProjectMembersInvite(config, {
-				...projectRefInput$1(config, options.project),
 				emails: options.email,
 				role: parseProjectRole$1(options.role)
 			});
 		});
 	});
-	members.command("role").description("Update a project member role").argument("<userId>", "Member user id").option("--project <slug>", "Project slug").requiredOption("--role <role>", "Project role (admin or builder)").action(async (userId, options) => {
+	members.command("role").description("Update a project member role").argument("<userId>", "Member user id").requiredOption("--role <role>", "Project role (admin or builder)").action(async (userId, options) => {
 		const config = createCliConfig();
 		await handleProjectMembersError("Update project member role failed", async () => {
 			await runProjectMembersRole(config, {
-				...projectRefInput$1(config, options.project),
 				userId,
 				role: parseProjectRole$1(options.role)
 			});
 		});
 	});
-	members.command("remove").description("Remove a member from a project").argument("<userId>", "Member user id").option("--project <slug>", "Project slug").action(async (userId, options) => {
+	members.command("remove").description("Remove a member from a project").argument("<userId>", "Member user id").action(async (userId) => {
 		const config = createCliConfig();
 		await handleProjectMembersError("Remove project member failed", async () => {
-			await runProjectMembersRemove(config, {
-				...projectRefInput$1(config, options.project),
-				userId
-			});
+			await runProjectMembersRemove(config, { userId });
 		});
 	});
-	members.command("leave").description("Leave a project as the current user").option("--project <slug>", "Project slug").option("-y, --yes", "Skip confirmation prompt").action(async (options) => {
+	members.command("leave").description("Leave a project as the current user").option("-y, --yes", "Skip confirmation prompt").action(async (options) => {
 		const config = createCliConfig();
 		await handleProjectMembersError("Leave project failed", async () => {
 			if (!options.yes) throw new Error("Pass --yes to confirm leaving the project");
-			await runProjectMembersLeave(config, projectRefInput$1(config, options.project));
+			await runProjectMembersLeave(config);
 		});
 	});
 }
 //#endregion
 //#region src/commands/project/run-project-settings.ts
-async function resolveSettingsProject(platform, config, projectRef) {
-	const ref = projectRef ?? getCliTargetOptions().projectId ?? readLinkedProjectConfig().project;
+async function resolveSettingsProject(platform) {
+	const ref = resolveActiveProjectRef();
 	if (!ref) throw new Error("Usage: keystroke --project <slug> project settings <command>");
 	return resolveProjectRef(platform, ref);
 }
-async function runProjectSettingsGet(config, options) {
+async function runProjectSettingsGet(config) {
 	await withActivePlatformClient(config, async (platform) => {
-		const project = await resolveSettingsProject(platform, config, options.projectRef);
+		const project = await resolveSettingsProject(platform);
 		const settings = await platform.projectSettings.get(project.id);
 		process.stdout.write(`${JSON.stringify({ settings }, null, 2)}\n`);
 	});
 }
-async function runProjectSettingsUpdate(config, input) {
+async function runProjectSettingsUpdate(config, patch) {
 	await withActivePlatformClient(config, async (platform) => {
-		const project = await resolveSettingsProject(platform, config, input.projectRef);
-		const { projectRef: _projectRef, ...patch } = input;
+		const project = await resolveSettingsProject(platform);
 		const settings = await platform.projectSettings.update(project.id, patch);
 		process.stdout.write(`${JSON.stringify({ settings }, null, 2)}\n`);
 	});
 }
 //#endregion
 //#region src/commands/project/settings.ts
-function resolveProjectRefOption(config, optionsProject) {
-	return optionsProject ?? getCliTargetOptions().projectId ?? readLinkedProjectConfig().project;
-}
-function projectRefInput(config, optionsProject) {
-	const projectRef = resolveProjectRefOption(config, optionsProject);
-	return projectRef ? { projectRef } : {};
-}
 function parseProjectRole(role) {
 	if (role === "admin" || role === "builder") return role;
 	throw new Error("Default role must be admin or builder");
@@ -7653,18 +7641,17 @@ async function handleProjectSettingsError(fallback, action) {
 }
 function registerProjectSettingsCommand(project) {
 	const settings = project.command("settings").description("View and update project governance settings");
-	settings.command("get").description("Get settings for a project").option("--project <slug>", "Project slug").action(async (options) => {
+	settings.command("get").description("Get settings for a project").action(async () => {
 		const config = createCliConfig();
 		await handleProjectSettingsError("Get project settings failed", async () => {
-			await runProjectSettingsGet(config, projectRefInput(config, options.project));
+			await runProjectSettingsGet(config);
 		});
 	});
-	settings.command("update").description("Update settings for a project").option("--project <slug>", "Project slug").option("--description <description>", "Project description").option("--default-role <role>", "Default role for new members (admin or builder)").option("--invite-permission <permission>", "Who can invite members (admin or all)").action(async (options) => {
+	settings.command("update").description("Update settings for a project").option("--description <description>", "Project description").option("--default-role <role>", "Default role for new members (admin or builder)").option("--invite-permission <permission>", "Who can invite members (admin or all)").action(async (options) => {
 		const config = createCliConfig();
 		await handleProjectSettingsError("Update project settings failed", async () => {
 			if (options.description === void 0 && options.defaultRole === void 0 && options.invitePermission === void 0) throw new Error("At least one of --description, --default-role, or --invite-permission is required");
 			await runProjectSettingsUpdate(config, {
-				...projectRefInput(config, options.project),
 				...options.description !== void 0 ? { description: options.description } : {},
 				...options.defaultRole !== void 0 ? { defaultRole: parseProjectRole(options.defaultRole) } : {},
 				...options.invitePermission !== void 0 ? { invitePermission: parseInvitePermission(options.invitePermission) } : {}
@@ -7691,7 +7678,7 @@ function registerProjectCommand(program) {
 	project.command("metrics").description("List rollup metrics for projects in the active organization").option("--admin", "List all org resources (org owner or admin only)").action(async (options) => {
 		const config = createCliConfig();
 		try {
-			const projectRef = getCliTargetOptions().projectId;
+			const projectRef = resolveActiveProjectRef();
 			await runProjectMetrics(config, {
 				...projectRef ? { projectRef } : {},
 				...options.admin ? { admin: true } : {}
@@ -7704,10 +7691,10 @@ function registerProjectCommand(program) {
 			process.exitCode = 1;
 		}
 	});
-	project.command("deployments").description("View deployment history for platform projects").command("list").description("List deployment history for a project").option("--project <slug>", "Project slug").action(async (options) => {
+	project.command("deployments").description("View deployment history for platform projects").command("list").description("List deployment history for a project").action(async () => {
 		const config = createCliConfig();
 		try {
-			const projectRef = options.project ?? getCliTargetOptions().projectId ?? resolveLinkedProjectRef();
+			const projectRef = resolveActiveProjectRef();
 			if (!projectRef) throw new Error("Usage: keystroke project deployments list --project <slug> (or run `keystroke project link`)");
 			await runProjectDeploymentsList(config, { projectRef });
 		} catch (error) {
@@ -7718,10 +7705,12 @@ function registerProjectCommand(program) {
 			process.exitCode = 1;
 		}
 	});
-	project.command("link").description("Link this directory to a platform project in keystroke.config.ts").requiredOption("--project <slug>", "Platform project slug").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
+	project.command("link").description("Link this directory to a platform project in keystroke.config.ts").option("--dir <path>", "Project directory", process.cwd()).action(async (options) => {
 		const config = createCliConfig();
 		try {
-			await runProjectLink(config, options.project, options.dir);
+			const projectRef = resolveActiveProjectRef(options.dir);
+			if (!projectRef) throw new Error("Usage: keystroke project link --project <slug> (see: keystroke project list)");
+			await runProjectLink(config, projectRef, options.dir);
 		} catch (error) {
 			process.stderr.write(`${formatCliError(error, "Link project failed", {
 				serverUrl: getPlatformUrl(config),
@@ -8135,20 +8124,20 @@ function registerChannelPlatformsCommand(channel) {
 }
 //#endregion
 //#region src/commands/channel/resolve-channel-project.ts
-async function resolveChannelProjectId(config, projectRef) {
+async function resolveChannelProjectId(config) {
 	const platform = createCliPlatformClient(config);
 	await ensureLinkedOrganization(config);
 	await ensureActiveOrganization(config);
-	const ref = projectRef?.trim() || getCliTargetOptions().projectId?.trim() || readLinkedProjectConfig().project?.trim();
+	const ref = resolveActiveProjectRef();
 	if (!ref) throw new Error("Project is required. Pass --project <slug> or run `keystroke project link --project <slug>`.");
 	return (await resolveProjectRef(platform, ref)).id;
 }
 //#endregion
 //#region src/commands/channel/list.ts
 function registerChannelAccountsCommand(channel) {
-	channel.command("accounts").description("List available workspace accounts for a platform").requiredOption("--platform <key>", "Platform key (slack)").option("--project <slug>", "Project slug").action(async (options) => runCliCommand("List channel accounts failed", async () => {
+	channel.command("accounts").description("List available workspace accounts for a platform").requiredOption("--platform <key>", "Platform key (slack)").action(async (options) => runCliCommand("List channel accounts failed", async () => {
 		const config = createCliConfig();
-		const projectId = await resolveChannelProjectId(config, options.project);
+		const projectId = await resolveChannelProjectId(config);
 		const client = createCliPlatformClient(config);
 		await ensureActiveOrganization(config);
 		const accounts = await runChannelAccounts(client, projectId, options.platform);
@@ -8156,9 +8145,9 @@ function registerChannelAccountsCommand(channel) {
 	}));
 }
 function registerChannelListCommand(channel) {
-	channel.command("list").description("List channel bindings for an agent").requiredOption("--agent <id>", "Agent id").option("--project <slug>", "Project slug").action(async (options) => runCliCommand("List agent channels failed", async () => {
+	channel.command("list").description("List channel bindings for an agent").requiredOption("--agent <id>", "Agent id").action(async (options) => runCliCommand("List agent channels failed", async () => {
 		const config = createCliConfig();
-		const projectId = await resolveChannelProjectId(config, options.project);
+		const projectId = await resolveChannelProjectId(config);
 		const client = createCliPlatformClient(config);
 		await ensureActiveOrganization(config);
 		const connections = await runChannelList(client, projectId, options.agent);
@@ -8166,9 +8155,9 @@ function registerChannelListCommand(channel) {
 	}));
 }
 function registerChannelDirectoryCommand(channel) {
-	channel.command("directory").description("List channels available to bind from a platform directory").requiredOption("--platform <key>", "Platform key (slack)").requiredOption("--account <id>", "Workspace account id (team id)").option("--project <slug>", "Project slug").action(async (options) => runCliCommand("List channel directory failed", async () => {
+	channel.command("directory").description("List channels available to bind from a platform directory").requiredOption("--platform <key>", "Platform key (slack)").requiredOption("--account <id>", "Workspace account id (team id)").action(async (options) => runCliCommand("List channel directory failed", async () => {
 		const config = createCliConfig();
-		const projectId = await resolveChannelProjectId(config, options.project);
+		const projectId = await resolveChannelProjectId(config);
 		const client = createCliPlatformClient(config);
 		await ensureActiveOrganization(config);
 		const channels = await runChannelDirectory(client, projectId, options.platform, options.account);
@@ -8176,9 +8165,9 @@ function registerChannelDirectoryCommand(channel) {
 	}));
 }
 function registerChannelBindCommand(channel) {
-	channel.command("bind").description("Bind an agent to a channel").requiredOption("--agent <id>", "Agent id").requiredOption("--platform <key>", "Platform key (slack)").requiredOption("--account <id>", "Workspace account id (team id)").requiredOption("--channel <id>", "Provider channel id").option("--channel-name <name>", "Provider channel name").option("--mode <mode>", "Listen mode (mention, all, dm)", "mention").option("--project <slug>", "Project slug").action(async (options) => runCliCommand("Bind channel failed", async () => {
+	channel.command("bind").description("Bind an agent to a channel").requiredOption("--agent <id>", "Agent id").requiredOption("--platform <key>", "Platform key (slack)").requiredOption("--account <id>", "Workspace account id (team id)").requiredOption("--channel <id>", "Provider channel id").option("--channel-name <name>", "Provider channel name").option("--mode <mode>", "Listen mode (mention, all, dm)", "mention").action(async (options) => runCliCommand("Bind channel failed", async () => {
 		const config = createCliConfig();
-		const projectId = await resolveChannelProjectId(config, options.project);
+		const projectId = await resolveChannelProjectId(config);
 		const client = createCliPlatformClient(config);
 		await ensureActiveOrganization(config);
 		const connection = await runChannelBind(client, projectId, {
@@ -8196,9 +8185,9 @@ function registerChannelBindCommand(channel) {
 	}));
 }
 function registerChannelUnbindCommand(channel) {
-	channel.command("unbind").description("Remove a channel binding from an agent").requiredOption("--agent <id>", "Agent id").requiredOption("--binding <id>", "Binding id").option("--project <slug>", "Project slug").action(async (options) => runCliCommand("Unbind channel failed", async () => {
+	channel.command("unbind").description("Remove a channel binding from an agent").requiredOption("--agent <id>", "Agent id").requiredOption("--binding <id>", "Binding id").action(async (options) => runCliCommand("Unbind channel failed", async () => {
 		const config = createCliConfig();
-		const projectId = await resolveChannelProjectId(config, options.project);
+		const projectId = await resolveChannelProjectId(config);
 		const client = createCliPlatformClient(config);
 		await ensureActiveOrganization(config);
 		const connection = await runChannelUnbind(client, projectId, {
@@ -8209,9 +8198,9 @@ function registerChannelUnbindCommand(channel) {
 	}));
 }
 function registerChannelUpdateBindingCommand(channel) {
-	channel.command("update-binding").description("Update a channel binding listen mode or thread setting").requiredOption("--agent <id>", "Agent id").requiredOption("--binding <id>", "Binding id").option("--mode <mode>", "Listen mode (mention, all, dm)").option("--threads", "Enable thread follow-up (subscribe on mention)").option("--no-threads", "Disable thread follow-up").option("--project <slug>", "Project slug").action(async (options) => runCliCommand("Update channel binding failed", async () => {
+	channel.command("update-binding").description("Update a channel binding listen mode or thread setting").requiredOption("--agent <id>", "Agent id").requiredOption("--binding <id>", "Binding id").option("--mode <mode>", "Listen mode (mention, all, dm)").option("--threads", "Enable thread follow-up (subscribe on mention)").option("--no-threads", "Disable thread follow-up").action(async (options) => runCliCommand("Update channel binding failed", async () => {
 		const config = createCliConfig();
-		const projectId = await resolveChannelProjectId(config, options.project);
+		const projectId = await resolveChannelProjectId(config);
 		const client = createCliPlatformClient(config);
 		await ensureActiveOrganization(config);
 		const patch = {};