@shortcut-cli/shortcut-cli 3.8.1 → 5.0.0

package/build/bin/short-epic.js

@@ -1,75 +1,186 @@
 #!/usr/bin/env node
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.js');
-const require_lib_spinner = require('../lib/spinner.js');
-const require_lib_configure = require('../lib/configure.js');
-const require_lib_client = require('../lib/client.js');
-const require_lib_stories = require('../lib/stories.js');
-let commander = require("commander");
-commander = require_rolldown_runtime.__toESM(commander);
-let child_process = require("child_process");
-
+import { loadConfig } from "../lib/configure.js";
+import client from "../lib/client.js";
+import spinner from "../lib/spinner.js";
+import stories_default from "../lib/stories.js";
+import { Command } from "commander";
+import os from "os";
+import { exec } from "child_process";
 //#region src/bin/short-epic.ts
-const config = require_lib_configure.loadConfig();
-const spin = require_lib_spinner.default();
+const config = loadConfig();
+const spin = spinner();
 const log = console.log;
-const program = commander.default.usage("[command] [options]").description("create or view epics");
-program.command("create").description("create a new epic").option("-n, --name [text]", "Set name of epic, required", "").option("-d, --description [text]", "Set description of epic", "").option("-s, --state [name]", "Set state of epic (to do, in progress, done)", "").option("--deadline [date]", "Set deadline for epic (YYYY-MM-DD)", "").option("--planned-start [date]", "Set planned start date (YYYY-MM-DD)", "").option("-o, --owners [id|name]", "Set owners of epic, comma-separated", "").option("-T, --team [id|name]", "Set team of epic", "").option("-l, --label [id|name]", "Set labels of epic, comma-separated", "").option("-M, --milestone [id]", "Set milestone of epic (deprecated, use objectives)", "").option("-I, --idonly", "Print only ID of epic result").option("-O, --open", "Open epic in browser").action(createEpic);
+const program = new Command().usage("[command] [options]").description("create, view, or update epics");
+program.command("create").description("create a new epic").option("-n, --name [text]", "Set name of epic, required", "").option("-d, --description [text]", "Set description of epic", "").option("-s, --state [name]", "Set state of epic (to do, in progress, done)", "").option("--deadline [date]", "Set deadline for epic (YYYY-MM-DD)", "").option("--planned-start [date]", "Set planned start date (YYYY-MM-DD)", "").option("-o, --owners [id|name]", "Set owners of epic, comma-separated", "").option("-T, --team [id|name]", "Set team of epic", "").option("-l, --label [id|name]", "Set labels of epic, comma-separated", "").option("-M, --milestone [id]", "Set milestone of epic (deprecated, use objectives)", "").option("--objectives [id|name]", "Set objectives of epic, comma-separated", "").option("-I, --idonly", "Print only ID of epic result").option("-O, --open", "Open epic in browser").action(createEpic);
+program.command("view <id>").description("view an epic by id").option("-O, --open", "Open epic in browser").action(viewEpic);
+program.command("update <id>").description("update an existing epic").option("-n, --name [text]", "Set name of epic", "").option("-d, --description [text]", "Set description of epic", "").option("-s, --state [name]", "Set state of epic (to do, in progress, done)", "").option("--deadline [date]", "Set deadline for epic (YYYY-MM-DD)", "").option("--planned-start [date]", "Set planned start date (YYYY-MM-DD)", "").option("-o, --owners [id|name]", "Set owners of epic, comma-separated", "").option("-T, --team [id|name]", "Set team of epic", "").option("-l, --label [id|name]", "Set labels of epic, comma-separated", "").option("-M, --milestone [id]", "Set milestone of epic (deprecated, use objectives)", "").option("--objectives [id|name]", "Set objectives of epic, comma-separated", "").option("-a, --archived", "Archive epic").option("-O, --open", "Open epic in browser").action(updateEpic);
+program.command("stories <id>").description("list stories in an epic").option("-d, --detailed", "Show more details for each story").option("-f, --format [template]", "Format each story output by template", "").action(listEpicStories);
+program.command("comments <id>").description("list comments on an epic").option("-d, --detailed", "Show nested replies for each comment").action(listEpicComments);
 program.parse(process.argv);
 async function createEpic(options) {
-	const entities = await require_lib_stories.default.fetchEntities();
+	const entities = await stories_default.fetchEntities();
 	if (!options.idonly) spin.start();
-	const epicData = { name: options.name };
+	const epicData = { name: options.name ?? "" };
 	if (options.description) epicData.description = options.description;
-	if (options.state) {
-		const stateMap = {
-			todo: "to do",
-			"to do": "to do",
-			inprogress: "in progress",
-			"in progress": "in progress",
-			done: "done"
-		};
-		const mappedState = stateMap[options.state.toLowerCase().replace(/[^a-z]/g, "")] || stateMap[options.state.toLowerCase()];
-		if (mappedState) epicData.state = mappedState;
-	}
+	const state = normalizeEpicState(options.state);
+	if (state) epicData.state = state;
 	if (options.deadline) epicData.deadline = new Date(options.deadline).toISOString();
 	if (options.plannedStart) epicData.planned_start_date = new Date(options.plannedStart).toISOString();
-	if (options.owners) epicData.owner_ids = require_lib_stories.default.findOwnerIds(entities, options.owners);
+	if (options.owners) epicData.owner_ids = stories_default.findOwnerIds(entities, options.owners);
 	if (options.team) {
-		const group = require_lib_stories.default.findGroup(entities, options.team);
-		if (group === null || group === void 0 ? void 0 : group.id) epicData.group_ids = [group.id];
+		const group = stories_default.findGroup(entities, options.team);
+		if (group?.id) epicData.group_ids = [group.id];
 	}
-	if (options.label) epicData.labels = require_lib_stories.default.findLabelNames(entities, options.label);
+	if (options.label) epicData.labels = stories_default.findLabelNames(entities, options.label);
 	if (options.milestone) epicData.milestone_id = parseInt(options.milestone, 10);
+	if (options.objectives) epicData.objective_ids = stories_default.findObjectiveIds(entities, options.objectives);
 	let epic;
 	if (!epicData.name) {
 		if (!options.idonly) spin.stop(true);
 		log("Must provide --name");
 		process.exit(1);
 	} else try {
-		epic = await require_lib_client.default.createEpic(epicData).then((r) => r.data);
+		epic = await client.createEpic(epicData).then((r) => r.data);
 	} catch (e) {
 		if (!options.idonly) spin.stop(true);
-		log("Error creating epic:", e.message || e);
+		log("Error creating epic:", e.message ?? String(e));
 		process.exit(1);
 	}
 	if (!options.idonly) spin.stop(true);
 	if (epic) if (options.idonly) log(epic.id);
 	else {
 		printEpic(epic);
-		if (options.open) (0, child_process.exec)(`open https://app.shortcut.com/${config.urlSlug}/epic/${epic.id}`);
+		if (options.open) openURL(`https://app.shortcut.com/${config.urlSlug}/epic/${epic.id}`);
+	}
+}
+async function viewEpic(id, options) {
+	spin.start();
+	try {
+		const epic = await client.getEpic(parseInt(id, 10)).then((r) => r.data);
+		spin.stop(true);
+		printEpic(epic);
+		if (options.open) openURL(epic.app_url);
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Epic #${id} not found`);
+		else log("Error fetching epic:", error.message ?? String(e));
+		process.exit(1);
+	}
+}
+async function updateEpic(id, options) {
+	const entities = await stories_default.fetchEntities();
+	const updateData = {};
+	if (options.name) updateData.name = options.name;
+	if (options.description) updateData.description = options.description;
+	const state = normalizeEpicState(options.state);
+	if (state) updateData.state = state;
+	if (options.deadline) updateData.deadline = new Date(options.deadline).toISOString();
+	if (options.plannedStart) updateData.planned_start_date = new Date(options.plannedStart).toISOString();
+	if (options.owners) updateData.owner_ids = stories_default.findOwnerIds(entities, options.owners);
+	if (options.team) {
+		const group = stories_default.findGroup(entities, options.team);
+		if (group?.id) updateData.group_ids = [group.id];
+	}
+	if (options.label) updateData.labels = stories_default.findLabelNames(entities, options.label);
+	if (options.milestone) updateData.milestone_id = parseInt(options.milestone, 10);
+	if (options.objectives) updateData.objective_ids = stories_default.findObjectiveIds(entities, options.objectives);
+	if (options.archived) updateData.archived = true;
+	if (Object.keys(updateData).length === 0) {
+		log("No updates provided. Use --name, --description, --state, --deadline, --planned-start, --owners, --team, --label, --milestone, --objectives, or --archived");
+		process.exit(1);
+	}
+	spin.start();
+	try {
+		const epic = await client.updateEpic(parseInt(id, 10), updateData).then((r) => r.data);
+		spin.stop(true);
+		printEpic(epic);
+		if (options.open) openURL(epic.app_url);
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Epic #${id} not found`);
+		else log("Error updating epic:", error.message ?? String(e));
+		process.exit(1);
 	}
 }
+async function listEpicStories(id, options) {
+	spin.start();
+	try {
+		const entities = await stories_default.fetchEntities();
+		const stories = await client.listEpicStories(parseInt(id, 10), { includes_description: !!options.detailed }).then((r) => r.data);
+		spin.stop(true);
+		if (stories.length === 0) {
+			log(`No stories found in epic #${id}`);
+			return;
+		}
+		stories.map((story) => stories_default.hydrateStory(entities, story)).forEach(options.detailed ? (story) => stories_default.printDetailedStory(story, entities) : stories_default.printFormattedStory({ format: options.format }));
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Epic #${id} not found`);
+		else log("Error fetching epic stories:", error.message ?? String(e));
+		process.exit(1);
+	}
+}
+async function listEpicComments(id, options) {
+	spin.start();
+	try {
+		const entities = await stories_default.fetchEntities();
+		const comments = await client.listEpicComments(parseInt(id, 10)).then((r) => r.data);
+		spin.stop(true);
+		if (comments.length === 0) {
+			log(`No comments found on epic #${id}`);
+			return;
+		}
+		comments.forEach((comment) => printEpicComment(comment, entities.membersById, options.detailed));
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Epic #${id} not found`);
+		else log("Error fetching epic comments:", error.message ?? String(e));
+		process.exit(1);
+	}
+}
+function normalizeEpicState(state) {
+	if (!state) return void 0;
+	const stateMap = {
+		todo: "to do",
+		"to do": "to do",
+		inprogress: "in progress",
+		"in progress": "in progress",
+		done: "done"
+	};
+	return stateMap[state.toLowerCase().replace(/[^a-z]/g, "")] || stateMap[state.toLowerCase()];
+}
 function printEpic(epic) {
 	log(`#${epic.id} ${epic.name}`);
 	if (epic.description) log(`Description:\t${epic.description}`);
 	log(`State:\t\t${epic.state}`);
+	log(`Archived:\t${epic.archived ? "yes" : "no"}`);
 	if (epic.milestone_id) log(`Milestone:\t${epic.milestone_id}`);
+	if (epic.objective_ids && epic.objective_ids.length > 0) log(`Objectives:\t${epic.objective_ids.join(", ")}`);
 	if (epic.deadline) log(`Deadline:\t${epic.deadline}`);
 	if (epic.planned_start_date) log(`Planned Start:\t${epic.planned_start_date}`);
 	if (epic.owner_ids && epic.owner_ids.length > 0) log(`Owners:\t\t${epic.owner_ids.join(", ")}`);
 	if (epic.group_ids && epic.group_ids.length > 0) log(`Teams:\t\t${epic.group_ids.join(", ")}`);
-	if (epic.labels && epic.labels.length > 0) log(`Labels:\t\t${epic.labels.map((l) => l.name).join(", ")}`);
+	if (epic.labels && epic.labels.length > 0) log(`Labels:\t\t${epic.labels.map((label) => label.name).join(", ")}`);
 	log(`URL:\t\t${epic.app_url}`);
 }
-
-//#endregion
+function printEpicComment(comment, membersById, detailed, depth = 0) {
+	const indent = "  ".repeat(depth);
+	const author = membersById?.get(comment.author_id)?.profile;
+	const authorName = author ? `${author.name} (${author.mention_name})` : comment.author_id;
+	log(`${indent}#${comment.id} ${authorName}`);
+	log(`${indent}Created: ${comment.created_at}`);
+	if (comment.updated_at !== comment.created_at) log(`${indent}Updated: ${comment.updated_at}`);
+	log(`${indent}${comment.deleted ? "[deleted]" : comment.text || "_"}`);
+	log(`${indent}URL: ${comment.app_url}`);
+	log();
+	if (detailed) comment.comments.forEach((reply) => printEpicComment(reply, membersById, detailed, depth + 1));
+}
+function openURL(url) {
+	exec(`${os.platform() === "darwin" ? "open" : "xdg-open"} '${url}'`);
+}
+//#endregion
+export {};

package/build/bin/short-epics.js

@@ -1,37 +1,36 @@
 #!/usr/bin/env node
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.js');
-const require_lib_spinner = require('../lib/spinner.js');
-const require_lib_client = require('../lib/client.js');
-let commander = require("commander");
-commander = require_rolldown_runtime.__toESM(commander);
-let chalk = require("chalk");
-chalk = require_rolldown_runtime.__toESM(chalk);
-
+import client from "../lib/client.js";
+import spinner from "../lib/spinner.js";
+import stories_default from "../lib/stories.js";
+import { Command } from "commander";
+import chalk from "chalk";
 //#region src/bin/short-epics.ts
 const log = console.log;
-const spin = require_lib_spinner.default();
-const program = commander.default.description("Display epics available for stories").option("-a, --archived", "List only epics including archived", "").option("-c, --completed", "List only epics that have been completed", "").option("-d, --detailed", "List more details for each epic", "").option("-f, --format [template]", "Format each epic output by template", "").option("-M, --milestone [ID]", "List epics in milestone matching id", "").option("-t, --title [query]", "List epics with name/title containing query", "").option("-s, --started", "List epics that have been started", "").parse(process.argv);
+const spin = spinner();
+const opts = new Command().description("Display epics available for stories").option("-a, --archived", "List only epics including archived", "").option("-c, --completed", "List only epics that have been completed", "").option("-d, --detailed", "List more details for each epic", "").option("-f, --format [template]", "Format each epic output by template", "").option("-M, --milestone [ID]", "List epics in milestone matching id", "").option("--objectives [id|name]", "List epics linked to objective id/name, comma-separated", "").option("-t, --title [query]", "List epics with name/title containing query", "").option("-s, --started", "List epics that have been started", "").parse(process.argv).opts();
 const main = async () => {
 	spin.start();
-	const epics = await require_lib_client.default.listEpics(null).then((r) => r.data);
+	const [epics, entities] = await Promise.all([client.listEpics().then((r) => r.data), stories_default.fetchEntities()]);
 	spin.stop(true);
-	const textMatch = new RegExp(program.title, "i");
+	const textMatch = new RegExp(opts.title ?? "", "i");
+	const objectiveIds = opts.objectives ? stories_default.findObjectiveIds(entities, opts.objectives) : [];
 	epics.filter((epic) => {
-		return !!`${epic.name} ${epic.name}`.match(textMatch) && !!(program.milestone ? epic.milestone_id == program.milestone : true);
-	}).map(printItem);
+		const matchesObjectives = objectiveIds.length === 0 || objectiveIds.some((objectiveId) => epic.objective_ids.includes(objectiveId));
+		return !!`${epic.name} ${epic.name}`.match(textMatch) && !!(opts.milestone ? String(epic.milestone_id) === opts.milestone : true) && matchesObjectives;
+	}).forEach((epic) => printItem(epic, entities.objectivesById));
 };
-const printItem = (epic) => {
-	if (epic.archived && !program.archived) return;
-	if (!epic.started && program.started) return;
-	if (!epic.completed && program.completed) return;
-	let defaultFormat = `#%id %t\nMilestone:\t%m\nState:\t\t%s\nDeadline:\t%dl\n`;
+const printItem = (epic, objectivesById) => {
+	if (epic.archived && !opts.archived) return;
+	if (!epic.started && opts.started) return;
+	if (!epic.completed && opts.completed) return;
+	let defaultFormat = `#%id %t\nMilestone:\t%m\nObjectives:\t%obj\nState:\t\t%s\nArchived:\t%ar\nDeadline:\t%dl\n`;
 	defaultFormat += `Points:\t\t%p\nPoints Started: %ps\nPoints Done:\t%pd\nCompletion:\t%c\n`;
-	if (epic.archived) defaultFormat += `Archived:\t%ar\n`;
 	if (epic.started) defaultFormat += `Started:\t%st\n`;
 	if (epic.completed) defaultFormat += `Completed:\t%co\n`;
-	if (program.detailed) defaultFormat += `Description:\t%d\n`;
-	log((program.format || defaultFormat).replace(/%id/, chalk.default.bold(`${epic.id}`)).replace(/%t/, chalk.default.blue(`${epic.name}`)).replace(/%m/, `${epic.milestone_id || "_"}`).replace(/%s/, `${epic.state}`).replace(/%dl/, `${epic.deadline || "_"}`).replace(/%d/, `${epic.description}`).replace(/%p/, `${epic.stats.num_points}`).replace(/%ps/, `${epic.stats.num_points_started}`).replace(/%pd/, `${epic.stats.num_points_done}`).replace(/%c/, `${Math.round(epic.stats.num_points_done / (epic.stats.num_points || 1) * 100)}%`).replace(/%a/, `${epic.archived}`).replace(/%st/, `${epic.started_at}`).replace(/%co/, `${epic.completed_at}`));
+	if (opts.detailed) defaultFormat += `Description:\t%d\n`;
+	const objectiveNames = epic.objective_ids?.map((objectiveId) => objectivesById?.get(objectiveId)?.name || String(objectiveId)).join(", ") || "_";
+	log((opts.format || defaultFormat).replace(/%id/, chalk.bold(`${epic.id}`)).replace(/%t/, chalk.blue(`${epic.name}`)).replace(/%m/, `${epic.milestone_id || "_"}`).replace(/%obj/, objectiveNames).replace(/%s/, `${epic.state}`).replace(/%dl/, `${epic.deadline || "_"}`).replace(/%d/, `${epic.description}`).replace(/%p/, `${epic.stats.num_points}`).replace(/%ps/, `${epic.stats.num_points_started}`).replace(/%pd/, `${epic.stats.num_points_done}`).replace(/%ar/, `${epic.archived}`).replace(/%c/, `${Math.round(epic.stats.num_points_done / (epic.stats.num_points || 1) * 100)}%`).replace(/%st/, `${epic.started_at}`).replace(/%co/, `${epic.completed_at}`));
 };
 main();
-
-//#endregion
+//#endregion
+export {};

package/build/bin/short-find.js

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
-const require_bin_short_search = require('./short-search.js');
-
+import { main } from "./short-search.js";
 //#region src/bin/short-find.ts
-require_bin_short_search.main();
-
-//#endregion
+main();
+//#endregion
+export {};

package/build/bin/short-install.js

@@ -1,43 +1,87 @@
 #!/usr/bin/env node
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.js');
-const require_lib_configure = require('../lib/configure.js');
-const require_package = require('../package.js');
-let commander = require("commander");
-commander = require_rolldown_runtime.__toESM(commander);
-let __shortcut_client = require("@shortcut/client");
-let prompt = require("prompt");
-prompt = require_rolldown_runtime.__toESM(prompt);
-
+import { loadCachedConfig, updateConfig } from "../lib/configure.js";
+import { version } from "../package.js";
+import { Command } from "commander";
+import { ShortcutClient } from "@shortcut/client";
+import { createInterface } from "readline/promises";
+import { Writable } from "stream";
 //#region src/bin/short-install.ts
-const extant = require_lib_configure.loadCachedConfig();
+const extant = loadCachedConfig();
 const log = console.log;
-const program = commander.default.version(require_package.version).description("Install access token and other settings for the Shortcut API").option("-f, --force", "Force install/reinstall").option("-r, --refresh", "Refresh the configuration with details from Shortcut.").parse(process.argv);
+const TOKEN_PROMPT = "Enter your Shortcut API token. You can get one at https://app.shortcut.com/settings/account/api-tokens\nAPI token: ";
+const opts = new Command().version(version).description("Install access token and other settings for the Shortcut API").option("-f, --force", "Force install/reinstall").option("-r, --refresh", "Refresh the configuration with details from Shortcut.").option("-t, --token <token>", "Shortcut API token to save without prompting").parse(process.argv).opts();
 const enrichConfigWithMemberDetails = async (config) => {
 	log("Fetching user/member details from Shortcut...");
-	const member = await new __shortcut_client.ShortcutClient(config.token).getCurrentMemberInfo().then((r) => r.data);
+	const clientConfig = {};
+	if (process.env.SHORTCUT_API_BASE_URL) clientConfig.baseURL = process.env.SHORTCUT_API_BASE_URL;
+	const member = await new ShortcutClient(config.token ?? "", clientConfig).getCurrentMemberInfo().then((r) => r.data);
 	return {
+		...config,
 		mentionName: member.mention_name,
-		urlSlug: member.workspace2.url_slug,
-		...config
+		urlSlug: member.workspace2.url_slug
 	};
 };
+var MaskedWritable = class extends Writable {
+	muted = false;
+	_write(chunk, encoding, callback) {
+		const text = typeof chunk === "string" ? chunk : chunk.toString();
+		if (!this.muted) {
+			process.stdout.write(text);
+			callback();
+			return;
+		}
+		if (text.includes("\n")) process.stdout.write("\n");
+		callback();
+	}
+};
+const promptForToken = async () => {
+	const output = new MaskedWritable();
+	const rl = createInterface({
+		input: process.stdin,
+		output,
+		terminal: true
+	});
+	try {
+		process.stdout.write(TOKEN_PROMPT);
+		output.muted = true;
+		const token = (await rl.question("")).trim();
+		output.muted = false;
+		process.stdout.write("\n");
+		return token;
+	} catch (error) {
+		output.muted = false;
+		process.stdout.write("\n");
+		if (error instanceof Error && "code" in error && error.code === "ABORT_ERR") process.exit(130);
+		throw error;
+	} finally {
+		rl.close();
+	}
+};
+const resolveToken = async () => {
+	if (opts.token) return opts.token.trim();
+	if (!process.stdin.isTTY || !process.stdout.isTTY) {
+		console.error("No API token provided. Pass --token when running non-interactively.");
+		process.exit(1);
+	}
+	return promptForToken();
+};
 const main = async () => {
-	if (program.refresh) require_lib_configure.updateConfig(await enrichConfigWithMemberDetails(extant));
-	else if (!extant.token || program.force) {
-		const schema = { properties: { token: {
-			message: "API Token -> https://app.shortcut.com/xxxx/settings/account/api-tokens",
-			required: true
-		} } };
-		prompt.default.start({ message: "Shortcut" });
-		prompt.default.get(schema, async (err, result) => {
-			if (err) return log(err);
-			const config = await enrichConfigWithMemberDetails(result);
-			log("Saving config...");
-			if (require_lib_configure.updateConfig(config)) log("Saved config");
-			else log("Error saving config");
+	if (opts.refresh) updateConfig(await enrichConfigWithMemberDetails(extant));
+	else if (!extant.token || opts.force) {
+		const token = await resolveToken();
+		if (!token) {
+			console.error("No API token provided.");
+			process.exit(1);
+		}
+		const config = await enrichConfigWithMemberDetails({
+			...extant,
+			token
 		});
+		log("Saving config...");
+		if (updateConfig(config)) log("Saved config");
+		else log("Error saving config");
 	} else if (extant.token) log("A configuration/token is already saved. To override, re-run with --force");
 };
 main();
-
-//#endregion
+//#endregion
+export {};

package/build/bin/short-iteration.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+import { loadConfig } from "../lib/configure.js";
+import client from "../lib/client.js";
+import spinner from "../lib/spinner.js";
+import stories_default from "../lib/stories.js";
+import { Command } from "commander";
+import { exec } from "child_process";
+import chalk from "chalk";
+//#region src/bin/short-iteration.ts
+const config = loadConfig();
+const spin = spinner();
+const log = console.log;
+const program = new Command().usage("[command] [options]").description("view, create, update, or delete iterations");
+program.command("view <id>").description("view an iteration by id").option("-O, --open", "Open iteration in browser").action(viewIteration);
+program.command("create").description("create a new iteration").option("-n, --name [text]", "Set name of iteration, required", "").option("-d, --description [text]", "Set description of iteration", "").option("--start-date [date]", "Set start date (YYYY-MM-DD), required", "").option("--end-date [date]", "Set end date (YYYY-MM-DD), required", "").option("-T, --team [id|name]", "Set team/group of iteration", "").option("-I, --idonly", "Print only ID of iteration result").option("-O, --open", "Open iteration in browser").action(createIteration);
+program.command("update <id>").description("update an existing iteration").option("-n, --name [text]", "Set name of iteration", "").option("-d, --description [text]", "Set description of iteration", "").option("--start-date [date]", "Set start date (YYYY-MM-DD)", "").option("--end-date [date]", "Set end date (YYYY-MM-DD)", "").option("-T, --team [id|name]", "Set team/group of iteration", "").option("-O, --open", "Open iteration in browser").action(updateIteration);
+program.command("delete <id>").description("delete an iteration").action(deleteIteration);
+program.command("stories <id>").description("list stories in an iteration").option("-f, --format [template]", "Format each story output by template", "").action(listIterationStories);
+program.parse(process.argv);
+async function viewIteration(id, options) {
+	spin.start();
+	try {
+		const iteration = await client.getIteration(parseInt(id, 10)).then((r) => r.data);
+		spin.stop(true);
+		printIteration(iteration);
+		if (options.open) exec(`open https://app.shortcut.com/${config.urlSlug}/iteration/${iteration.id}`);
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Iteration #${id} not found`);
+		else log("Error fetching iteration:", error.message ?? String(e));
+		process.exit(1);
+	}
+}
+async function createIteration(options) {
+	const entities = await stories_default.fetchEntities();
+	if (!options.idonly) spin.start();
+	const iterationData = {
+		name: options.name || "",
+		start_date: options.startDate || "",
+		end_date: options.endDate || ""
+	};
+	if (options.description) iterationData.description = options.description;
+	if (options.team) {
+		const group = stories_default.findGroup(entities, options.team);
+		if (group?.id) iterationData.group_ids = [group.id];
+	}
+	if (!iterationData.name) {
+		if (!options.idonly) spin.stop(true);
+		log("Must provide --name");
+		process.exit(1);
+	}
+	if (!iterationData.start_date) {
+		if (!options.idonly) spin.stop(true);
+		log("Must provide --start-date");
+		process.exit(1);
+	}
+	if (!iterationData.end_date) {
+		if (!options.idonly) spin.stop(true);
+		log("Must provide --end-date");
+		process.exit(1);
+	}
+	let iteration;
+	try {
+		iteration = await client.createIteration(iterationData).then((r) => r.data);
+	} catch (e) {
+		if (!options.idonly) spin.stop(true);
+		log("Error creating iteration:", e.message ?? String(e));
+		process.exit(1);
+	}
+	if (!options.idonly) spin.stop(true);
+	if (iteration) if (options.idonly) log(iteration.id);
+	else {
+		printIteration(iteration);
+		if (options.open) exec(`open https://app.shortcut.com/${config.urlSlug}/iteration/${iteration.id}`);
+	}
+}
+async function updateIteration(id, options) {
+	const entities = await stories_default.fetchEntities();
+	spin.start();
+	const updateData = {};
+	if (options.name) updateData.name = options.name;
+	if (options.description) updateData.description = options.description;
+	if (options.startDate) updateData.start_date = options.startDate;
+	if (options.endDate) updateData.end_date = options.endDate;
+	if (options.team) {
+		const group = stories_default.findGroup(entities, options.team);
+		if (group?.id) updateData.group_ids = [group.id];
+	}
+	if (Object.keys(updateData).length === 0) {
+		spin.stop(true);
+		log("No updates provided. Use --name, --description, --start-date, --end-date, or --team");
+		process.exit(1);
+	}
+	let iteration;
+	try {
+		iteration = await client.updateIteration(parseInt(id, 10), updateData).then((r) => r.data);
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Iteration #${id} not found`);
+		else log("Error updating iteration:", error.message ?? String(e));
+		process.exit(1);
+	}
+	spin.stop(true);
+	if (iteration) {
+		printIteration(iteration);
+		if (options.open) exec(`open https://app.shortcut.com/${config.urlSlug}/iteration/${iteration.id}`);
+	}
+}
+async function deleteIteration(id) {
+	spin.start();
+	try {
+		await client.deleteIteration(parseInt(id, 10));
+		spin.stop(true);
+		log(`Iteration #${id} deleted successfully`);
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Iteration #${id} not found`);
+		else log("Error deleting iteration:", error.message ?? String(e));
+		process.exit(1);
+	}
+}
+async function listIterationStories(id, options) {
+	spin.start();
+	try {
+		const [stories, entities] = await Promise.all([client.listIterationStories(parseInt(id, 10)).then((r) => r.data), stories_default.fetchEntities()]);
+		spin.stop(true);
+		if (stories.length === 0) {
+			log(`No stories found in iteration #${id}`);
+			return;
+		}
+		log(chalk.bold(`Stories in iteration #${id}:`));
+		log();
+		stories.forEach((story) => {
+			const hydrated = stories_default.hydrateStory(entities, story);
+			if (options.format) stories_default.printFormattedStory({ format: options.format })(hydrated);
+			else {
+				const state = hydrated.state?.name ?? "Unknown";
+				const owners = hydrated.owners?.map((o) => o?.profile.mention_name).filter(Boolean).join(", ");
+				log(`${chalk.bold("#" + story.id)} ${chalk.blue(story.name)}`);
+				log(`  Type: ${story.story_type} | State: ${state} | Owners: ${owners || "_"}`);
+				log(`  Points: ${story.estimate ?? "_"}`);
+				log();
+			}
+		});
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Iteration #${id} not found`);
+		else log("Error fetching stories:", error.message ?? String(e));
+		process.exit(1);
+	}
+}
+function printIteration(iteration) {
+	const stats = iteration.stats;
+	const totalStories = stats.num_stories_done + stats.num_stories_started + stats.num_stories_unstarted + stats.num_stories_backlog;
+	const completionPct = stats.num_points > 0 ? Math.round(stats.num_points_done / stats.num_points * 100) : 0;
+	log(chalk.blue.bold(`#${iteration.id}`) + chalk.blue(` ${iteration.name}`));
+	if (iteration.description) log(chalk.bold("Description:") + ` ${iteration.description}`);
+	log(chalk.bold("Status:") + `      ${formatStatus(iteration.status)}`);
+	log(chalk.bold("Start Date:") + `  ${iteration.start_date}`);
+	log(chalk.bold("End Date:") + `    ${iteration.end_date}`);
+	if (iteration.group_ids && iteration.group_ids.length > 0) log(chalk.bold("Teams:") + `       ${iteration.group_ids.join(", ")}`);
+	log(chalk.bold("Stories:") + `     ${totalStories} (${stats.num_stories_done} done)`);
+	log(chalk.bold("Points:") + `      ${stats.num_points} (${stats.num_points_done} done)`);
+	log(chalk.bold("Completion:") + `  ${completionPct}%`);
+	log(chalk.bold("URL:") + `         ${iteration.app_url}`);
+	log();
+}
+function formatStatus(status) {
+	switch (status) {
+		case "started": return chalk.green(status);
+		case "done": return chalk.gray(status);
+		default: return chalk.yellow(status);
+	}
+}
+//#endregion
+export {};