@shortcut-cli/shortcut-cli 3.8.1 → 5.0.0

package/build/bin/short-story.js

@@ -1,71 +1,105 @@
 #!/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 debug = require("debug");
-debug = require_rolldown_runtime.__toESM(debug);
-let path = require("path");
-path = require_rolldown_runtime.__toESM(path);
-let fs = require("fs");
-fs = require_rolldown_runtime.__toESM(fs);
-let os = require("os");
-os = require_rolldown_runtime.__toESM(os);
-let child_process = require("child_process");
-let chalk = require("chalk");
-chalk = require_rolldown_runtime.__toESM(chalk);
-let https = require("https");
-https = require_rolldown_runtime.__toESM(https);
-
+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 = require_lib_configure.loadConfig();
-const spin = require_lib_spinner.default();
+const config = loadConfig();
+const spin = spinner();
 const log = console.log;
 const logError = console.error;
-const debug$1 = (0, debug.default)("short");
-const program = commander.default.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("-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("--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("-q, --quiet", "Print only story output, no loading dialog", "").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 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 () => {
-	const entities = await require_lib_stories.default.fetchEntities();
-	if (!(program.idonly || program.quiet)) spin.start();
-	debug$1("constructing story update");
+	if (handledSubcommand) return;
+	const entities = await stories_default.fetchEntities();
+	if (!(opts.idonly || opts.quiet)) spin.start();
+	debug("constructing story update");
 	const update = {};
-	if (program.archived) update.archived = true;
-	if (program.state) update.workflow_state_id = (require_lib_stories.default.findState(entities, program.state) || {}).id;
-	if (program.estimate) update.estimate = parseInt(program.estimate, 10);
-	if (program.title) update.name = program.title;
-	if (program.description) update.description = `${program.description}`;
-	if (program.type) {
-		const typeMatch = new RegExp(program.type, "i");
-		update.story_type = [
+	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"
-		].filter((t) => !!t.match(typeMatch))[0];
+		];
+		const typeMatch = new RegExp(opts.type, "i");
+		update.story_type = storyTypes.find((t) => t.match(typeMatch));
 	}
-	if (program.owners) update.owner_ids = require_lib_stories.default.findOwnerIds(entities, program.owners);
-	if (program.epic) update.epic_id = (require_lib_stories.default.findEpic(entities, program.epic) || {}).id;
-	if (program.iteration) update.iteration_id = (require_lib_stories.default.findIteration(entities, program.iteration) || {}).id;
-	if (program.label) update.labels = require_lib_stories.default.findLabelNames(entities, program.label);
-	if (program.team) update.group_id = (require_lib_stories.default.findGroup(entities, program.team) || {}).id;
-	const hasPositionUpdate = program.moveAfter !== void 0 || program.moveBefore !== void 0 || program.moveDown !== void 0 || program.moveUp !== void 0;
-	const hasUpdate = Object.keys(update).length > 0 || hasPositionUpdate;
-	debug$1("constructed story update", update);
+	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 (program.fromGit || !program.args.length) {
-		debug$1("fetching story ID from git");
+	if (opts.fromGit || !program.args.length) {
+		debug("fetching story ID from git");
 		let branch = "";
 		try {
-			branch = (0, child_process.execSync)("git branch").toString("utf-8");
+			branch = execSync("git branch").toString("utf-8");
 		} catch (e) {
-			debug$1(e);
+			debug(e);
 		}
-		if (branch.match(/\*.*[0-9]+/)) {
-			debug$1("parsing story ID from git branch:", branch);
-			const id = parseInt(branch.match(/\*.*/)[0].match(/\/(ch|sc-)([0-9]+)/)[2], 10);
-			debug$1("parsed story ID from git branch:", id);
+		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();
@@ -74,13 +108,14 @@ const main = async () => {
 		}
 	}
 	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 (program.comment) {
-				debug$1("request comment create");
-				await require_lib_client.default.createStoryComment(id, { text: program.comment });
-				debug$1("response comment create");
+			if (opts.comment) {
+				debug("request comment create");
+				await client.createStoryComment(id, { text: opts.comment });
+				debug("response comment create");
 			}
 		} catch (e) {
 			stopSpinner();
@@ -88,10 +123,10 @@ const main = async () => {
 			process.exit(3);
 		}
 		try {
-			if (program.task) {
-				debug$1("request task create");
-				await require_lib_client.default.createTask(id, { description: program.task });
-				debug$1("response task create");
+			if (opts.task) {
+				debug("request task create");
+				await client.createTask(id, { description: opts.task });
+				debug("response task create");
 			}
 		} catch (e) {
 			stopSpinner();
@@ -99,23 +134,27 @@ const main = async () => {
 			process.exit(3);
 		}
 		try {
-			debug$1("request story");
-			story = await require_lib_client.default.getStory(id).then((r) => r.data);
-			debug$1("response story");
+			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 (program.taskComplete) {
-				debug$1("calculating task(s) to complete");
-				const descMatch = new RegExp(program.taskComplete, "i");
+			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$1("request tasks complete", updatedTaskIds);
-				await Promise.all(tasks.map((t) => require_lib_client.default.updateTask(id, t.id, { complete: !t.complete })));
-				debug$1("response tasks complete");
+				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;
@@ -129,22 +168,22 @@ const main = async () => {
 		try {
 			if (hasUpdate) {
 				if (hasPositionUpdate) {
-					debug$1("calculating move up/down");
-					const siblings = await require_lib_stories.default.listStories({
+					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 (program.moveAfter) update.after_id = ~~program.moveAfter;
-					else if (program.moveBefore) update.before_id = ~~program.moveBefore;
-					else if (program.moveUp) update.before_id = siblingIds[Math.max(0, storyIndex - (~~program.moveUp || 1))];
-					else if (program.moveDown) update.after_id = siblingIds[Math.min(siblings.length - 1, storyIndex + (~~program.moveDown || 1))];
-					debug$1("constructed story position update", update);
+					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$1("request story update");
-				const changed = await require_lib_client.default.updateStory(id, update);
-				debug$1("response story 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) {
@@ -152,61 +191,268 @@ const main = async () => {
 			logError("Error updating story", id);
 			process.exit(5);
 		}
-		if (story) story = require_lib_stories.default.hydrateStory(entities, story);
-		if (!program.idonly) spin.stop(true);
+		if (story) story = stories_default.hydrateStory(entities, story);
+		if (!opts.idonly) spin.stop(true);
 		if (story) {
 			printStory(story, entities);
-			if (program.open) openURL(require_lib_stories.default.storyURL(story));
-			if (program.openEpic) {
+			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(require_lib_stories.default.buildURL("epic", story.epic_id));
+				openURL(stories_default.buildURL("epic", story.epic_id));
 			}
-			if (program.openIteration) {
+			if (opts.openIteration) {
 				if (!story.iteration_id) {
 					logError("This story is not part of an iteration.");
 					process.exit(22);
 				}
-				openURL(require_lib_stories.default.buildURL("iteration", story.iteration_id));
+				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 (program.openProject) openURL(require_lib_stories.default.buildURL("project", story.project_id));
 		}
-		if (program.download) downloadFiles(story);
-		if (story && program.gitBranch) {
+		if (opts.download) downloadFiles(story);
+		if (story && opts.gitBranch) {
 			if (!config.mentionName) {
 				stopSpinner();
-				require_lib_stories.default.checkoutStoryBranch(story, `${story.story_type}-${story.id}-`);
+				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);
 			}
-			require_lib_stories.default.checkoutStoryBranch(story);
-		} else if (story && program.gitBranchShort) require_lib_stories.default.checkoutStoryBranch(story, `${config.mentionName}/sc-${story.id}/`);
+			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) => {
-	(0, child_process.execSync)(`${os.default.platform() === "darwin" ? "open" : "xdg-open"} '${url}'`);
+	execSync(`${os.platform() === "darwin" ? "open" : "xdg-open"} '${url}'`);
 };
 const stopSpinner = () => {
-	if (!(program.idonly || program.quiet)) spin.stop(true);
+	if (!(opts.idonly || opts.quiet)) spin.stop(true);
 };
 const downloadFiles = (story) => story.files.map((file) => {
-	https.default.get(require_lib_stories.default.fileURL(file), (res) => {
-		const filePath = path.default.join(program.downloadDir, file.name);
-		log(chalk.default.bold("Downloading file to: ") + filePath);
-		const stream = fs.default.createWriteStream(filePath);
+	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 (program.idonly) return log(story.id);
-	if (program.format) return require_lib_stories.default.printFormattedStory(program)(story);
-	require_lib_stories.default.printDetailedStory(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
+//#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 {};