@shortcut-cli/shortcut-cli 4.0.0 → 5.0.0

package/build/bin/short-story.js

@@ -0,0 +1,458 @@
+#!/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 debugging from "debug";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { execSync } from "child_process";
+import chalk from "chalk";
+import https from "https";
+//#region src/bin/short-story.ts
+const config = loadConfig();
+const spin = spinner();
+const log = console.log;
+const logError = console.error;
+const debug = debugging("short");
+let handledSubcommand = false;
+if (process.argv[2] === "history") {
+	handledSubcommand = true;
+	showStoryHistory(process.argv[3]).catch((e) => {
+		logError("Error fetching story history", e);
+		process.exit(1);
+	});
+}
+if (process.argv[2] === "comments") {
+	handledSubcommand = true;
+	showStoryComments(process.argv[3]).catch((e) => {
+		logError("Error fetching story comments", e);
+		process.exit(1);
+	});
+}
+if (process.argv[2] === "tasks") {
+	handledSubcommand = true;
+	showStoryTasks(process.argv[3]).catch((e) => {
+		logError("Error fetching story tasks", e);
+		process.exit(1);
+	});
+}
+if (process.argv[2] === "sub-tasks") {
+	handledSubcommand = true;
+	showStorySubTasks(process.argv[3]).catch((e) => {
+		logError("Error fetching story sub-tasks", e);
+		process.exit(1);
+	});
+}
+if (process.argv[2] === "relation" && process.argv[3] === "add") {
+	handledSubcommand = true;
+	addStoryRelation(process.argv[4], process.argv[5], process.argv[6], process.argv[7]).catch((e) => {
+		logError("Error creating story relation", e);
+		process.exit(1);
+	});
+}
+const program = new Command().allowExcessArguments(true).argument("[id]").usage("[options] <id>").description("Update and/or display story details").option("-a, --archived", "Update story as archived").option("-c, --comment [text]", "Add comment to story", "").option("-d, --description [text]", "Update description of story", "").option("--deadline [date]", "Update due date of story (YYYY-MM-DD)", "").option("-D, --download", "Download all attached files", "").option("--download-dir [path]", "Directory to download files to", ".").option("-e, --estimate [number]", "Update estimate of story", "").option("--epic [id|name]", "Set epic of story").option("-i, --iteration [id|name]", "Set iteration of story").option("-f, --format [template]", "Format the story output by template", "").option("--from-git", "Fetch story parsed by ID from current git branch").option("--follower [id|name]", "Update followers of story, comma-separated", "").option("--git-branch", "Checkout git branch from story slug <mention-name>/ch<id>/<type>-<title>\n				as required by the Git integration: https://bit.ly/2RKO1FF").option("--git-branch-short", "Checkout git branch from story slug <mention-name>/ch<id>/<title>").option("-I, --idonly", "Print only ID of story results", "").option("-l, --label [id|name]", "Stories with label id/name, by regex", "").option("--move-after [id]", "Move story to position below story ID").option("--move-before [id]", "Move story to position above story ID").option("--move-down [n]", "Move story position downward by n stories").option("--move-up [n]", "Move story position upward by n stories").option("-o, --owners [id|name]", "Update owners of story, comma-separated", "").option("-O, --open", "Open story in browser").option("--oe, --open-epic", "Open story's epic in browser").option("--oi, --open-iteration", "Open story's iteration in browser").option("--op, --open-project", "Open story's project in browser").option("--external-link [url]", "Add external link to story, comma-separated", "").option("-q, --quiet", "Print only story output, no loading dialog", "").option("--requester [id|name]", "Update requester of story", "").option("-s, --state [id|name]", "Update workflow state of story", "").option("-t, --title [text]", "Update title/name of story", "").option("-T, --team [id|name]", "Update team/group of story", "").option("--task [text]", "Create new task on story").option("--task-complete [text]", "Toggle completion of task on story matching text").option("-y, --type [name]", "Update type of story", "").parse(process.argv);
+const opts = program.opts();
+const main = async () => {
+	if (handledSubcommand) return;
+	const entities = await stories_default.fetchEntities();
+	if (!(opts.idonly || opts.quiet)) spin.start();
+	debug("constructing story update");
+	const update = {};
+	if (opts.archived) update.archived = true;
+	if (opts.state) update.workflow_state_id = stories_default.findState(entities, opts.state)?.id;
+	if (opts.estimate) update.estimate = parseInt(opts.estimate, 10);
+	if (opts.title) update.name = opts.title;
+	if (opts.description) update.description = `${opts.description}`;
+	if (opts.deadline) update.deadline = normalizeDate(opts.deadline);
+	if (opts.type) {
+		const storyTypes = [
+			"feature",
+			"bug",
+			"chore"
+		];
+		const typeMatch = new RegExp(opts.type, "i");
+		update.story_type = storyTypes.find((t) => t.match(typeMatch));
+	}
+	if (opts.owners) update.owner_ids = stories_default.findOwnerIds(entities, opts.owners);
+	if (opts.follower) update.follower_ids = stories_default.findOwnerIds(entities, opts.follower);
+	if (opts.epic) update.epic_id = stories_default.findEpic(entities, opts.epic)?.id;
+	if (opts.iteration) update.iteration_id = stories_default.findIteration(entities, opts.iteration)?.id;
+	if (opts.label) update.labels = stories_default.findLabelNames(entities, opts.label);
+	if (opts.team) update.group_id = stories_default.findGroup(entities, opts.team)?.id;
+	if (opts.requester) update.requested_by_id = stories_default.findMember(entities, opts.requester)?.id;
+	const hasPositionUpdate = opts.moveAfter !== void 0 || opts.moveBefore !== void 0 || opts.moveDown !== void 0 || opts.moveUp !== void 0;
+	const hasUpdate = Object.keys(update).length > 0 || hasPositionUpdate || !!opts.externalLink;
+	debug("constructed story update", update);
+	const gitID = [];
+	if (opts.fromGit || !program.args.length) {
+		debug("fetching story ID from git");
+		let branch = "";
+		try {
+			branch = execSync("git branch").toString("utf-8");
+		} catch (e) {
+			debug(e);
+		}
+		const storyIdMatch = branch.match(/\*.*/)?.[0].match(/\/(ch|sc-)([0-9]+)/);
+		if (storyIdMatch?.[2]) {
+			debug("parsing story ID from git branch:", branch);
+			const id = parseInt(storyIdMatch[2], 10);
+			debug("parsed story ID from git branch:", id);
+			if (id) gitID.push(id.toString());
+		} else {
+			stopSpinner();
+			logError("No story ID argument present or found in git branch");
+			process.exit(2);
+		}
+	}
+	program.args.map((a) => (a.match(/\d+/) || [])[0]).concat(gitID).map(async (_id) => {
+		if (!_id) return;
+		const id = parseInt(_id, 10);
+		let story;
+		try {
+			if (opts.comment) {
+				debug("request comment create");
+				await client.createStoryComment(id, { text: opts.comment });
+				debug("response comment create");
+			}
+		} catch (e) {
+			stopSpinner();
+			log("Error creating comment", id);
+			process.exit(3);
+		}
+		try {
+			if (opts.task) {
+				debug("request task create");
+				await client.createTask(id, { description: opts.task });
+				debug("response task create");
+			}
+		} catch (e) {
+			stopSpinner();
+			log("Error creating task", id);
+			process.exit(3);
+		}
+		try {
+			debug("request story");
+			story = await client.getStory(id).then((r) => r.data);
+			debug("response story");
+			if (opts.externalLink) {
+				const links = opts.externalLink.split(",").map((link) => link.trim()).filter(Boolean);
+				update.external_links = Array.from(new Set([...story.external_links || [], ...links]));
+			}
+		} catch (e) {
+			stopSpinner();
+			logError("Error fetching story", id);
+			process.exit(4);
+		}
+		try {
+			if (opts.taskComplete) {
+				debug("calculating task(s) to complete");
+				const descMatch = new RegExp(opts.taskComplete, "i");
+				const tasks = story.tasks.filter((t) => t.description.match(descMatch));
+				const updatedTaskIds = tasks.map((t) => t.id);
+				debug("request tasks complete", updatedTaskIds);
+				await Promise.all(tasks.map((t) => client.updateTask(id, t.id, { complete: !t.complete })));
+				debug("response tasks complete");
+				story.tasks = story.tasks.map((t) => {
+					if (updatedTaskIds.indexOf(t.id) > -1) t.complete = !t.complete;
+					return t;
+				});
+			}
+		} catch (e) {
+			stopSpinner();
+			log("Error updating tasks", e);
+			process.exit(3);
+		}
+		try {
+			if (hasUpdate) {
+				if (hasPositionUpdate) {
+					debug("calculating move up/down");
+					const siblings = await stories_default.listStories({
+						state: story.workflow_state_id.toString(),
+						sort: "state.position:asc,position:asc"
+					});
+					const siblingIds = siblings.map((s) => s.id);
+					const storyIndex = siblingIds.indexOf(~~id);
+					if (opts.moveAfter) update.after_id = ~~opts.moveAfter;
+					else if (opts.moveBefore) update.before_id = ~~opts.moveBefore;
+					else if (opts.moveUp) update.before_id = siblingIds[Math.max(0, storyIndex - (~~opts.moveUp || 1))];
+					else if (opts.moveDown) update.after_id = siblingIds[Math.min(siblings.length - 1, storyIndex + (~~opts.moveDown || 1))];
+					debug("constructed story position update", update);
+				}
+				debug("request story update");
+				const changed = await client.updateStory(id, update).then((r) => r.data);
+				debug("response story update");
+				story = Object.assign({}, story, changed);
+			}
+		} catch (e) {
+			stopSpinner();
+			logError("Error updating story", id);
+			process.exit(5);
+		}
+		if (story) story = stories_default.hydrateStory(entities, story);
+		if (!opts.idonly) spin.stop(true);
+		if (story) {
+			printStory(story, entities);
+			if (opts.open) openURL(stories_default.storyURL(story));
+			if (opts.openEpic) {
+				if (!story.epic_id) {
+					logError("This story is not part of an epic.");
+					process.exit(21);
+				}
+				openURL(stories_default.buildURL("epic", story.epic_id));
+			}
+			if (opts.openIteration) {
+				if (!story.iteration_id) {
+					logError("This story is not part of an iteration.");
+					process.exit(22);
+				}
+				openURL(stories_default.buildURL("iteration", story.iteration_id));
+			}
+			if (opts.openProject) {
+				if (story.project_id !== void 0 && story.project_id !== null) openURL(stories_default.buildURL("project", story.project_id));
+			}
+		}
+		if (opts.download) downloadFiles(story);
+		if (story && opts.gitBranch) {
+			if (!config.mentionName) {
+				stopSpinner();
+				stories_default.checkoutStoryBranch(story, `${story.story_type}-${story.id}-`);
+				logError("Error creating story branch in Shortcut format");
+				logError("Please run: \"short install --force\" to add your mention name to the config.");
+				process.exit(10);
+			}
+			stories_default.checkoutStoryBranch(story);
+		} else if (story && opts.gitBranchShort) stories_default.checkoutStoryBranch(story, `${config.mentionName}/sc-${story.id}/`);
+	});
+	stopSpinner();
+};
+async function showStoryHistory(idArg) {
+	const id = parseInt(idArg || "", 10);
+	if (!id) {
+		logError("Usage: short story history <id>");
+		process.exit(2);
+	}
+	spin.start();
+	try {
+		const history = await client.storyHistory(id).then((r) => r.data);
+		spin.stop(true);
+		if (history.length === 0) {
+			log(`No history found for story #${id}`);
+			process.exit(0);
+		}
+		history.forEach(printHistoryItem);
+		process.exit(0);
+	} catch (e) {
+		spin.stop(true);
+		logError(`Error fetching story history ${id}`);
+		process.exit(4);
+	}
+}
+async function showStoryComments(idArg) {
+	const id = parseInt(idArg || "", 10);
+	if (!id) {
+		logError("Usage: short story comments <id>");
+		process.exit(2);
+	}
+	spin.start();
+	try {
+		const entities = await stories_default.fetchEntities();
+		const story = await client.getStory(id).then((r) => r.data);
+		spin.stop(true);
+		if (!story.comments.length) {
+			log(`No comments found for story #${id}`);
+			process.exit(0);
+		}
+		printStoryComments(story.comments, entities);
+		process.exit(0);
+	} catch (e) {
+		spin.stop(true);
+		logError(`Error fetching story comments ${id}`);
+		process.exit(4);
+	}
+}
+async function showStoryTasks(idArg) {
+	const id = parseInt(idArg || "", 10);
+	if (!id) {
+		logError("Usage: short story tasks <id>");
+		process.exit(2);
+	}
+	spin.start();
+	try {
+		const entities = await stories_default.fetchEntities();
+		const story = await client.getStory(id).then((r) => r.data);
+		spin.stop(true);
+		if (!story.tasks.length) {
+			log(`No tasks found for story #${id}`);
+			process.exit(0);
+		}
+		printStoryTasks(story.tasks, entities);
+		process.exit(0);
+	} catch (e) {
+		spin.stop(true);
+		logError(`Error fetching story tasks ${id}`);
+		process.exit(4);
+	}
+}
+async function showStorySubTasks(idArg) {
+	const id = parseInt(idArg || "", 10);
+	if (!id) {
+		logError("Usage: short story sub-tasks <id>");
+		process.exit(2);
+	}
+	spin.start();
+	try {
+		const entities = await stories_default.fetchEntities();
+		const stories = await client.listStorySubTasks(id).then((r) => r.data);
+		spin.stop(true);
+		if (!stories.length) {
+			log(`No sub-tasks found for story #${id}`);
+			process.exit(0);
+		}
+		stories.map((story) => stories_default.hydrateStory(entities, story)).forEach(stories_default.printFormattedStory({}));
+		process.exit(0);
+	} catch (e) {
+		spin.stop(true);
+		logError(`Error fetching story sub-tasks ${id}`);
+		process.exit(4);
+	}
+}
+async function addStoryRelation(storyIdArg, relatedIdArg, typeFlag, typeValue) {
+	const storyId = parseInt(storyIdArg || "", 10);
+	const relatedId = parseInt(relatedIdArg || "", 10);
+	const relationType = typeFlag === "--type" ? typeValue : void 0;
+	if (!storyId || !relatedId || !relationType) {
+		logError("Usage: short story relation add <storyId> <relatedId> --type <type>");
+		process.exit(2);
+	}
+	const normalized = normalizeRelationType(storyId, relatedId, relationType);
+	if (!normalized) {
+		logError("Invalid relation type. Use one of: blocks, blocked-by, duplicates, duplicated-by, relates-to");
+		process.exit(2);
+	}
+	spin.start();
+	try {
+		const link = await client.createStoryLink(normalized).then((r) => r.data);
+		spin.stop(true);
+		log(`Added relation: story #${link.subject_id} ${link.verb} story #${link.object_id} (#${link.id})`);
+	} catch (e) {
+		spin.stop(true);
+		logError(`Error creating story relation ${storyId} -> ${relatedId}`);
+		process.exit(4);
+	}
+}
+const openURL = (url) => {
+	execSync(`${os.platform() === "darwin" ? "open" : "xdg-open"} '${url}'`);
+};
+const stopSpinner = () => {
+	if (!(opts.idonly || opts.quiet)) spin.stop(true);
+};
+const downloadFiles = (story) => story.files.map((file) => {
+	https.get(stories_default.fileURL(file), (res) => {
+		const filePath = path.join(opts.downloadDir ?? ".", file.name);
+		log(chalk.bold("Downloading file to: ") + filePath);
+		const stream = fs.createWriteStream(filePath);
+		res.pipe(stream);
+		stream.on("finish", () => stream.close());
+	});
+});
+const printStory = (story, entities) => {
+	if (opts.idonly) return log(story.id);
+	if (opts.format) return stories_default.printFormattedStory(opts)(story);
+	stories_default.printDetailedStory(story, entities);
+};
+const printHistoryItem = (item) => {
+	const actor = item.actor_name || item.member_id || "Unknown";
+	log(chalk.blue.bold(`${item.changed_at}`) + ` ${actor}`);
+	item.actions.forEach((action) => {
+		log(`- ${summarizeHistoryAction(action)}`);
+	});
+	log();
+};
+const printStoryComments = (comments, entities) => {
+	const repliesByParent = /* @__PURE__ */ new Map();
+	const roots = [];
+	comments.forEach((comment) => {
+		if (comment.parent_id) {
+			const replies = repliesByParent.get(comment.parent_id) || [];
+			replies.push(comment);
+			repliesByParent.set(comment.parent_id, replies);
+		} else roots.push(comment);
+	});
+	roots.sort((a, b) => a.position - b.position).forEach((comment) => printStoryComment(comment, entities, repliesByParent, 0));
+};
+const printStoryComment = (comment, entities, repliesByParent, depth) => {
+	const indent = "  ".repeat(depth);
+	const author = comment.author_id ? entities.membersById?.get(comment.author_id)?.profile : void 0;
+	const authorText = author ? `${author.name} (${author.mention_name})` : comment.author_id || "Unknown";
+	log(`${indent}${chalk.bold("#" + comment.id)} ${authorText}`);
+	log(`${indent}Created: ${comment.created_at}`);
+	if (comment.updated_at && comment.updated_at !== comment.created_at) log(`${indent}Updated: ${comment.updated_at}`);
+	if (comment.blocker) log(`${indent}Blocker: true`);
+	log(`${indent}${comment.deleted ? "[deleted]" : comment.text || "_"}`);
+	log(`${indent}URL: ${comment.app_url}`);
+	log();
+	(repliesByParent.get(comment.id) || []).sort((a, b) => a.position - b.position).forEach((reply) => printStoryComment(reply, entities, repliesByParent, depth + 1));
+};
+const printStoryTasks = (tasks, entities) => {
+	tasks.slice().sort((a, b) => a.position - b.position).forEach((task) => printStoryTask(task, entities));
+};
+const printStoryTask = (task, entities) => {
+	const status = task.complete ? "[x]" : "[ ]";
+	const owners = task.owner_ids.map((ownerId) => entities.membersById?.get(ownerId)?.profile?.mention_name || ownerId).join(", ");
+	log(`${chalk.bold("#" + task.id)} ${status} ${task.description}`);
+	if (owners) log(`Owners: ${owners}`);
+	if (task.completed_at) log(`Completed: ${task.completed_at}`);
+	if (task.updated_at) log(`Updated: ${task.updated_at}`);
+	log();
+};
+function normalizeRelationType(storyId, relatedId, type) {
+	const normalized = type.toLowerCase().replace(/[_\s]+/g, "-");
+	if (normalized === "blocks") return {
+		subject_id: storyId,
+		object_id: relatedId,
+		verb: "blocks"
+	};
+	if (normalized === "blocked-by") return {
+		subject_id: relatedId,
+		object_id: storyId,
+		verb: "blocks"
+	};
+	if (normalized === "duplicates") return {
+		subject_id: storyId,
+		object_id: relatedId,
+		verb: "duplicates"
+	};
+	if (normalized === "duplicated-by") return {
+		subject_id: relatedId,
+		object_id: storyId,
+		verb: "duplicates"
+	};
+	if (normalized === "relates-to" || normalized === "relates") return {
+		subject_id: storyId,
+		object_id: relatedId,
+		verb: "relates to"
+	};
+}
+const summarizeHistoryAction = (action) => {
+	const entityType = String(action.entity_type || "item");
+	const actionType = String(action.action || "changed");
+	const name = typeof action.name === "string" ? action.name : void 0;
+	const description = typeof action.description === "string" ? action.description : void 0;
+	if (actionType === "update" && action.changes && typeof action.changes === "object") {
+		const fields = Object.keys(action.changes);
+		if (fields.length > 0) return `updated ${entityType} ${name ? `"${name}" ` : ""}(fields: ${fields.join(", ")})`;
+	}
+	if (name) return `${actionType} ${entityType} "${name}"`;
+	if (description) return `${actionType} ${entityType} "${description}"`;
+	return `${actionType} ${entityType}`;
+};
+const normalizeDate = (value) => {
+	if (/^\d{4}-\d{2}-\d{2}$/.test(value)) return (/* @__PURE__ */ new Date(`${value}T00:00:00.000Z`)).toISOString();
+	return new Date(value).toISOString();
+};
+main();
+//#endregion
+export {};

package/build/bin/short-team.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+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-team.ts
+const spin = spinner();
+const log = console.log;
+const program = new Command().usage("[command] [options]").description("view a team or list its stories");
+program.command("view <idOrName>").description("view a team by id or name").action(viewTeam);
+program.command("stories <idOrName>").description("list stories for a team by id or name").option("-d, --detailed", "Show more details for each story").option("-f, --format [template]", "Format each story output by template", "").action(listTeamStories);
+const args = process.argv.slice(2);
+if (args.length > 0 && args[0] !== "view" && args[0] !== "stories") process.argv.splice(2, 0, "view");
+program.parse(process.argv);
+if (args.length === 0) {
+	program.outputHelp();
+	process.exit(1);
+}
+async function viewTeam(idOrName) {
+	spin.start();
+	try {
+		const entities = await stories_default.fetchEntities();
+		const team = stories_default.findGroup(entities, idOrName);
+		if (!team) {
+			spin.stop(true);
+			log(`Team ${idOrName} not found`);
+			process.exit(1);
+		}
+		const fullTeam = await client.getGroup(team.id).then((r) => r.data);
+		spin.stop(true);
+		printTeam(fullTeam);
+	} catch (e) {
+		spin.stop(true);
+		log(`Error fetching team: ${e.message ?? String(e)}`);
+		process.exit(1);
+	}
+}
+async function listTeamStories(idOrName, options) {
+	spin.start();
+	try {
+		const entities = await stories_default.fetchEntities();
+		const team = stories_default.findGroup(entities, idOrName);
+		if (!team) {
+			spin.stop(true);
+			log(`Team ${idOrName} not found`);
+			process.exit(1);
+		}
+		const stories = await client.listGroupStories(team.id).then((r) => r.data);
+		spin.stop(true);
+		if (stories.length === 0) {
+			log(`No stories found for team #${team.id} ${team.name}`);
+			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);
+		log(`Error fetching team stories: ${e.message ?? String(e)}`);
+		process.exit(1);
+	}
+}
+function printTeam(team) {
+	log(chalk.bold(`#${team.id}`) + chalk.blue(` ${team.name}`));
+	log(chalk.bold("Mention:       ") + ` ${team.mention_name}`);
+	log(chalk.bold("Stories:       ") + ` ${team.num_stories}`);
+	log(chalk.bold("Started:       ") + ` ${team.num_stories_started}`);
+	log(chalk.bold("Backlog:       ") + ` ${team.num_stories_backlog}`);
+	log(chalk.bold("Epics Started: ") + ` ${team.num_epics_started}`);
+	log(chalk.bold("Members:       ") + ` ${team.member_ids.length}`);
+	log(chalk.bold("Workflows:     ") + ` ${team.workflow_ids.length}`);
+	log(chalk.bold("Archived:      ") + ` ${team.archived}`);
+	if (team.description) log(chalk.bold("Description:   ") + ` ${team.description}`);
+	if (team.color) log(chalk.bold("Color:         ") + ` ${team.color}`);
+	log(chalk.bold("URL:           ") + ` ${team.app_url}`);
+	log();
+}
+//#endregion
+export {};

package/build/bin/short-teams.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import client from "../lib/client.js";
+import spinner from "../lib/spinner.js";
+import { Command } from "commander";
+import chalk from "chalk";
+//#region src/bin/short-teams.ts
+const spin = spinner();
+const log = console.log;
+const opts = new Command().description("Display teams available for stories and epics").option("-a, --archived", "List teams including archived", "").option("-s, --search [query]", "List teams with name containing query", "").parse(process.argv).opts();
+async function main() {
+	spin.start();
+	const teams = await client.listGroups().then((r) => r.data);
+	spin.stop(true);
+	const searchMatch = new RegExp(opts.search ?? "", "i");
+	teams.filter((team) => !!`${team.id} ${team.name} ${team.mention_name}`.match(searchMatch)).forEach(printTeamSummary);
+}
+function printTeamSummary(team) {
+	if (team.archived && !opts.archived) return;
+	log(chalk.bold(`#${team.id}`) + chalk.blue(` ${team.name}`));
+	log(chalk.bold("Mention:       ") + ` ${team.mention_name}`);
+	log(chalk.bold("Stories:       ") + ` ${team.num_stories}`);
+	log(chalk.bold("Started:       ") + ` ${team.num_stories_started}`);
+	if (team.archived) log(chalk.bold("Archived:      ") + ` ${team.archived}`);
+	log();
+}
+main();
+//#endregion
+export {};

package/build/bin/short-workflows.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import client from "../lib/client.js";
+import spinner from "../lib/spinner.js";
+import { Command } from "commander";
+import chalk from "chalk";
+//#region src/bin/short-workflows.ts
+const spin = spinner();
+const log = console.log;
+const opts = new Command().description("Display workflows/states available for stories").option("-s, --search [query]", "List states containing query", "").parse(process.argv).opts();
+const main = async () => {
+	spin.start();
+	const wfs = await client.listWorkflows().then((r) => r.data);
+	spin.stop(true);
+	wfs.map(printWf);
+};
+const printWf = (wf) => {
+	log(chalk.bold(`#${wf.id}`) + ` ${wf.name}`);
+	log("    == States:");
+	wf.states.map(printWfState);
+};
+const printWfState = (state) => {
+	if (!state.name.match(new RegExp(opts.search ?? "", "i"))) return;
+	log(chalk.bold(`    #${state.id}`) + ` ${state.name}`);
+	log(`         Type:   \t${state.type}`);
+	log(`         Stories:\t${state.num_stories}`);
+};
+main();
+//#endregion
+export {};

package/build/bin/short-workspace.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import configure_default from "../lib/configure.js";
+import stories_default from "../lib/stories.js";
+import { program as program$1 } from "./short-search.js";
+import { Command } from "commander";
+//#region src/bin/short-workspace.ts
+const config = configure_default.loadConfig();
+const log = console.log;
+const program = new Command().description("List stories matching saved workspace query").argument("[name]").option("-l, --list", "List saved workspaces").option("-q, --quiet", "Print only workspace story output, no loading dialog", "").option("-n, --name [name]", "Load named workspace", "").option("-u, --unset [name]", "Force unset saved workspace").parse(process.argv);
+const opts = program.opts();
+const toArgs = (obj) => Object.entries(obj).map(([k, v]) => `--${k} '${v}'`).join(" ");
+const main = async () => {
+	if (!config || !config.token) {
+		log("Not installed yet.");
+		log("Please run: short install");
+		return;
+	} else if (!config.workspaces) {
+		log("No workspace saved.");
+		log("Please run:");
+		log("  short search [options] --save");
+		log("to create your first one.");
+		return;
+	} else if (opts.list) {
+		log("Workspaces:");
+		const workspaces = config.workspaces ?? {};
+		Object.keys(workspaces).forEach((w) => {
+			log(" ", w + ":", toArgs(workspaces[w] ?? {}));
+		});
+		return;
+	} else if (opts.unset) {
+		if (configure_default.removeWorkspace(opts.unset)) log("Successfully removed %s workspace", opts.unset);
+		else log("Failed to remove %s workspace", opts.unset);
+		return;
+	}
+	const name = `${opts.name || program.args[0] || "default"}`;
+	const workspace = config.workspaces?.[name];
+	if (!workspace) {
+		log("No workspace saved with name", name);
+		log("Please run:");
+		log("  short search [options] --save", name);
+		log("to create it.");
+		return;
+	}
+	const foundOpts = program$1.parse(process.argv).opts();
+	const additionalArgs = {
+		...workspace,
+		...Object.fromEntries(Object.entries(foundOpts).filter(([, v]) => v !== void 0 && v !== "" && v !== false))
+	};
+	if (!opts.quiet) {
+		log("Loading %s workspace ...", name);
+		log();
+	}
+	let stories = [];
+	try {
+		stories = await stories_default.listStories(additionalArgs);
+	} catch (e) {
+		log("Error fetching stories:", e);
+	}
+	stories.map(stories_default.printFormattedStory(additionalArgs));
+};
+main();
+//#endregion
+export {};

package/build/bin/short.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { description, version } from "../package.js";
+import { Command } from "commander";
+//#region src/bin/short.ts
+process.on("unhandledRejection", console.log);
+new Command().version(version).description(description).command("install [options]", "install and configure API access").command("search [options] [SEARCH OPERATORS]", "search stories with optional query").alias("s").command("find [options] [SEARCH OPERATORS]", "[DEPRECATED] search stories with optional query").command("story [ID|command] [options]", "view or manipulate stories").alias("st").command("create [options]", "create a story").alias("c").command("members [options]", "list members").alias("m").command("teams [options]", "list teams").command("team [command] [options]", "view a team or list its stories").command("labels [options]", "list labels").command("label [command] [options]", "view stories for a label").command("custom-fields [options]", "list custom fields").command("custom-field <id> [options]", "view a custom field").command("workflows [options]", "list workflows and their states").alias("wf").command("epics [options]", "list epics and their states").alias("e").command("epic [command] [options]", "create, view, or update an epic").command("objectives [options]", "list objectives and their states").alias("o").command("objective [command] [options]", "view, create, or update objectives").command("iterations [options]", "list iterations").alias("i").command("iteration [command] [options]", "view, create, update, or delete an iteration").command("docs [options]", "list and search docs").alias("d").command("doc [command] [options]", "view, create, or update a doc").command("projects [options]", "list projects and their states").alias("p").command("workspace [NAME] [options]", "list stories matching saved workspace query", { isDefault: true }).alias("w").command("api <path> [options]", "make a request to the Shortcut API").parse(process.argv);
+//#endregion
+export {};

package/build/lib/client.js

@@ -0,0 +1,9 @@
+import { loadConfig } from "./configure.js";
+import { ShortcutClient } from "@shortcut/client";
+//#region src/lib/client.ts
+const config = loadConfig();
+const clientConfig = {};
+if (process.env.SHORTCUT_API_BASE_URL) clientConfig.baseURL = process.env.SHORTCUT_API_BASE_URL;
+const client = new ShortcutClient(config.token ?? "", clientConfig);
+//#endregion
+export { client as default };