@shortcut-cli/shortcut-cli 4.0.0 → 5.0.0

package/build/bin/short-create.js

@@ -0,0 +1,76 @@
+#!/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, Option } from "commander";
+import { exec } from "child_process";
+//#region src/bin/short-create.ts
+const config = loadConfig();
+const spin = spinner();
+const log = console.log;
+const opts = new Command().usage("[options]").description("create a story with provided details").option("-d, --description [text]", "Set description of story", "").option("-e, --estimate [number]", "Set estimate of story").option("--epic [id|name]", "Set epic of story").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, --iteration [id|name]", "Set iteration of story").option("-I, --idonly", "Print only ID of story result").option("-l, --label [id|name]", "Stories with label id/name, by regex", "").option("-o, --owners [id|name]", "Set owners of story, comma-separated", "").option("-O, --open", "Open story in browser").option("-p, --project [id|name]", "Set project of story, required if --state is not set", "").option("-T, --team [id|name]", "Set team of story", "").option("-t, --title [text]", "Set title of story, required", "").option("-s, --state [id|name]", "Set workflow state of story, required if --project is not set", "").addOption(new Option("-y, --type <name>", "Set type of story").choices([
+	"feature",
+	"bug",
+	"chore"
+]).default("feature")).parse(process.argv).opts();
+const main = async () => {
+	const entities = await stories_default.fetchEntities();
+	if (!opts.idonly) spin.start();
+	const project = opts.project ? stories_default.findProject(entities, opts.project) : void 0;
+	const group = opts.team ? stories_default.findGroup(entities, opts.team) : void 0;
+	const state = opts.state ? stories_default.findState(entities, opts.state) : void 0;
+	const epic = opts.epic ? stories_default.findEpic(entities, opts.epic) : void 0;
+	const iteration = opts.iteration ? stories_default.findIteration(entities, opts.iteration) : void 0;
+	const update = {
+		name: opts.title ?? "",
+		story_type: opts.type,
+		description: `${opts.description}`
+	};
+	if (project) update.project_id = project.id;
+	if (group) update.group_id = group.id;
+	if (state) update.workflow_state_id = state.id;
+	if (epic) update.epic_id = epic.id;
+	if (iteration) update.iteration_id = iteration.id;
+	if (opts.estimate) update.estimate = parseInt(opts.estimate, 10);
+	if (opts.owners) update.owner_ids = stories_default.findOwnerIds(entities, opts.owners);
+	if (opts.label) update.labels = stories_default.findLabelNames(entities, opts.label);
+	let story;
+	if (!update.name) {
+		if (!opts.idonly) spin.stop(true);
+		log("Must provide --title");
+	} else if (opts.project && !project) {
+		if (!opts.idonly) spin.stop(true);
+		log(`Project ${opts.project} not found`);
+	} else if (opts.state && !state) {
+		if (!opts.idonly) spin.stop(true);
+		log(`State ${opts.state} not found`);
+	} else if (opts.team && !group) {
+		if (!opts.idonly) spin.stop(true);
+		log(`Team ${opts.team} not found`);
+	} else if (opts.epic && !epic) {
+		if (!opts.idonly) spin.stop(true);
+		log(`Epic ${opts.epic} not found`);
+	} else if (opts.iteration && !iteration) {
+		if (!opts.idonly) spin.stop(true);
+		log(`Iteration ${opts.iteration} not found`);
+	} else if (!update.project_id && !update.workflow_state_id) {
+		if (!opts.idonly) spin.stop(true);
+		log("Must provide --project or --state");
+	} else try {
+		story = await client.createStory(update).then((r) => r.data);
+	} catch (_e) {
+		log("Error creating story");
+	}
+	if (!opts.idonly) spin.stop(true);
+	if (story) {
+		const hydrateStory = stories_default.hydrateStory(entities, story);
+		stories_default.printDetailedStory(hydrateStory);
+		if (opts.gitBranch) stories_default.checkoutStoryBranch(hydrateStory);
+		else if (opts.gitBranchShort) stories_default.checkoutStoryBranch(hydrateStory, `${config.mentionName}/sc-${story.id}/`);
+		if (opts.open) exec("open " + stories_default.storyURL(story));
+	}
+};
+main();
+//#endregion
+export {};

package/build/bin/short-custom-field.js

@@ -0,0 +1,50 @@
+#!/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-custom-field.ts
+const spin = spinner();
+const log = console.log;
+const program = new Command().argument("<id>").usage("<id> [options]").description("view a custom field by id").parse(process.argv);
+const id = program.args[0];
+if (!id) {
+	program.outputHelp();
+	process.exit(1);
+}
+async function main() {
+	if (!id) process.exit(1);
+	spin.start();
+	try {
+		const field = await client.getCustomField(id).then((r) => r.data);
+		spin.stop(true);
+		printField(field);
+	} catch (e) {
+		spin.stop(true);
+		const error = e;
+		if (error.response?.status === 404) log(`Custom field ${id} not found`);
+		else log(`Error fetching custom field: ${error.message ?? String(e)}`);
+		process.exit(1);
+	}
+}
+function printField(field) {
+	log(chalk.bold(field.id) + chalk.blue(` ${field.name}`));
+	log(chalk.bold("Type:          ") + ` ${field.field_type}`);
+	log(chalk.bold("Enabled:       ") + ` ${field.enabled}`);
+	log(chalk.bold("Story Types:   ") + ` ${(field.story_types || []).join(", ") || "_"}`);
+	log(chalk.bold("Position:      ") + ` ${field.position}`);
+	log(chalk.bold("Fixed:         ") + ` ${field.fixed_position || false}`);
+	if (field.canonical_name) log(chalk.bold("Canonical:     ") + ` ${field.canonical_name}`);
+	if (field.description) log(chalk.bold("Description:   ") + ` ${field.description}`);
+	if (field.values?.length) {
+		log(chalk.bold("Values:"));
+		field.values.forEach((value) => {
+			log(`  - ${value.value} (${value.id}) enabled=${value.enabled} position=${value.position}${value.color_key ? ` color=${value.color_key}` : ""}`);
+		});
+	}
+	log(chalk.bold("Created:       ") + ` ${field.created_at}`);
+	log(chalk.bold("Updated:       ") + ` ${field.updated_at}`);
+}
+main();
+//#endregion
+export {};

package/build/bin/short-custom-fields.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-custom-fields.ts
+const spin = spinner();
+const log = console.log;
+const opts = new Command().description("Display custom fields available for stories").option("-d, --disabled", "List custom fields including disabled", "").option("-s, --search [query]", "List custom fields with name containing query", "").parse(process.argv).opts();
+async function main() {
+	spin.start();
+	const fields = await client.listCustomFields().then((r) => r.data);
+	spin.stop(true);
+	const searchMatch = new RegExp(opts.search ?? "", "i");
+	fields.filter((field) => !!`${field.id} ${field.name} ${field.description || ""}`.match(searchMatch)).forEach(printFieldSummary);
+}
+function printFieldSummary(field) {
+	if (!field.enabled && !opts.disabled) return;
+	log(chalk.bold(field.id) + chalk.blue(` ${field.name}`));
+	log(chalk.bold("Type:          ") + ` ${field.field_type}`);
+	log(chalk.bold("Enabled:       ") + ` ${field.enabled}`);
+	log(chalk.bold("Story Types:   ") + ` ${(field.story_types || []).join(", ") || "_"}`);
+	log(chalk.bold("Values:        ") + ` ${field.values?.length || 0}`);
+	if (field.description) log(chalk.bold("Description:   ") + ` ${field.description}`);
+	log();
+}
+main();
+//#endregion
+export {};

package/build/bin/{short-doc.cjs → short-doc.js}

@@ -1,36 +1,34 @@
 #!/usr/bin/env node
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-const require_lib_spinner = require('../lib/spinner.cjs');
-const require_lib_client = require('../lib/client.cjs');
-let commander = require("commander");
-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);
-
+import client from "../lib/client.js";
+import spinner from "../lib/spinner.js";
+import { Command } from "commander";
+import os from "os";
+import { exec } from "child_process";
+import chalk from "chalk";
 //#region src/bin/short-doc.ts
-const spin = require_lib_spinner.default();
+const spin = spinner();
 const log = console.log;
-const program = new commander.Command().usage("[command] [options]").description("view, create, or update a doc");
+const program = new Command().usage("[command] [options]").description("view, create, or update a doc");
 program.command("view <id>").description("view a doc by ID").option("--html", "Include HTML content in output").option("-O, --open", "Open doc in browser").option("-q, --quiet", "Print only doc content, no metadata").action(viewDoc);
 program.command("create").description("create a new doc").option("-t, --title <text>", "Set title of doc (required)").option("-c, --content <text>", "Set content of doc (required)").option("--markdown", "Treat content as markdown (default is HTML)").option("-I, --idonly", "Print only ID of doc result").option("-O, --open", "Open doc in browser").action(createDoc);
 program.command("update <id>").description("update an existing doc").option("-t, --title <text>", "Update title of doc").option("-c, --content <text>", "Update content of doc").option("--markdown", "Treat content as markdown (default is HTML)").option("-O, --open", "Open doc in browser").action(updateDoc);
 program.command("delete <id>").description("delete a doc").option("--confirm", "Confirm deletion without prompting").action(deleteDoc);
 const args = process.argv.slice(2);
-if (args.length > 0 && isUUID(args[0])) process.argv.splice(2, 0, "view");
+if (args.length > 0 && args[0] && isUUID(args[0])) process.argv.splice(2, 0, "view");
 program.parse(process.argv);
 if (args.length === 0) {
 	program.outputHelp();
 	process.exit(1);
-} else if (args.length > 0 && !isUUID(args[0])) {
-	if (![
+} else if (args.length > 0 && args[0] && !isUUID(args[0])) {
+	const validCommands = [
 		"view",
 		"create",
 		"update",
 		"delete"
-	].includes(args[0]) && !args[0].startsWith("-")) {
-		console.error(`Error: Unknown command or invalid doc ID: ${args[0]}`);
+	];
+	const firstArg = args[0];
+	if (!validCommands.includes(firstArg) && !firstArg.startsWith("-")) {
+		console.error(`Error: Unknown command or invalid doc ID: ${firstArg}`);
 		console.error("Run \"short doc --help\" for usage information.");
 		process.exit(1);
 	}
@@ -44,7 +42,7 @@ async function viewDoc(id, options) {
 	try {
 		const params = {};
 		if (options.html) params.content_format = "html";
-		doc = await require_lib_client.default.getDoc(id, params).then((r) => r.data);
+		doc = await client.getDoc(id, Object.keys(params).length > 0 ? params : void 0).then((r) => r.data);
 	} catch (e) {
 		if (!options.quiet) spin.stop(true);
 		log("Error fetching doc:", e.message ?? String(e));
@@ -72,8 +70,8 @@ async function createDoc(options) {
 	};
 	let doc;
 	try {
-		const result = await require_lib_client.default.createDoc(docData);
-		doc = await require_lib_client.default.getDoc(result.data.id).then((r) => r.data);
+		const result = await client.createDoc(docData);
+		doc = await client.getDoc(result.data.id).then((r) => r.data);
 	} catch (e) {
 		if (!options.idonly) spin.stop(true);
 		log("Error creating doc:", e.message ?? String(e));
@@ -82,7 +80,7 @@ async function createDoc(options) {
 	if (!options.idonly) spin.stop(true);
 	if (options.idonly) log(doc.id);
 	else {
-		log(chalk.default.green("Doc created successfully!"));
+		log(chalk.green("Doc created successfully!"));
 		printDoc(doc);
 	}
 	if (options.open) openURL(doc.app_url);
@@ -101,14 +99,14 @@ async function updateDoc(id, options) {
 	}
 	let doc;
 	try {
-		doc = await require_lib_client.default.updateDoc(id, docData).then((r) => r.data);
+		doc = await client.updateDoc(id, docData).then((r) => r.data);
 	} catch (e) {
 		spin.stop(true);
 		log("Error updating doc:", e.message ?? String(e));
 		process.exit(1);
 	}
 	spin.stop(true);
-	log(chalk.default.green("Doc updated successfully!"));
+	log(chalk.green("Doc updated successfully!"));
 	printDoc(doc);
 	if (options.open) openURL(doc.app_url);
 }
@@ -120,35 +118,35 @@ async function deleteDoc(id, options) {
 	}
 	spin.start();
 	try {
-		await require_lib_client.default.deleteDoc(id, {});
+		await client.deleteDoc(id, {});
 	} catch (e) {
 		spin.stop(true);
 		log("Error deleting doc:", e.message ?? String(e));
 		process.exit(1);
 	}
 	spin.stop(true);
-	log(chalk.default.green(`Doc ${id} deleted successfully.`));
+	log(chalk.green(`Doc ${id} deleted successfully.`));
 }
 function printDoc(doc, includeHtml = false) {
-	log(chalk.default.blue.bold(doc.title || "(Untitled)"));
-	log(chalk.default.bold("ID:") + `       ${doc.id}`);
-	log(chalk.default.bold("URL:") + `      ${doc.app_url}`);
-	log(chalk.default.bold("Created:") + `  ${doc.created_at}`);
-	if (doc.created_at !== doc.updated_at) log(chalk.default.bold("Updated:") + `  ${doc.updated_at}`);
-	if (doc.archived) log(chalk.default.bold("Archived:") + ` ${doc.archived}`);
+	log(chalk.blue.bold(doc.title || "(Untitled)"));
+	log(chalk.bold("ID:") + `       ${doc.id}`);
+	log(chalk.bold("URL:") + `      ${doc.app_url}`);
+	log(chalk.bold("Created:") + `  ${doc.created_at}`);
+	if (doc.created_at !== doc.updated_at) log(chalk.bold("Updated:") + `  ${doc.updated_at}`);
+	if (doc.archived) log(chalk.bold("Archived:") + ` ${doc.archived}`);
 	log();
 	if (doc.content_markdown) {
-		log(chalk.default.bold("Content (Markdown):"));
+		log(chalk.bold("Content (Markdown):"));
 		log(doc.content_markdown);
 	}
 	if (includeHtml && doc.content_html) {
 		log();
-		log(chalk.default.bold("Content (HTML):"));
+		log(chalk.bold("Content (HTML):"));
 		log(doc.content_html);
 	}
 }
 function openURL(url) {
-	(0, child_process.exec)(`${os.default.platform() === "darwin" ? "open" : "xdg-open"} '${url}'`);
+	exec(`${os.platform() === "darwin" ? "open" : "xdg-open"} '${url}'`);
 }
-
-//#endregion
+//#endregion
+export {};

package/build/bin/{short-docs.cjs → short-docs.js}

@@ -1,32 +1,35 @@
 #!/usr/bin/env node
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
-const require_lib_spinner = require('../lib/spinner.cjs');
-const require_lib_client = require('../lib/client.cjs');
-let commander = require("commander");
-
+import client from "../lib/client.js";
+import spinner from "../lib/spinner.js";
+import { Command } from "commander";
 //#region src/bin/short-docs.ts
-const spin = require_lib_spinner.default("Loading docs... %s ");
+const spin = spinner("Loading docs... %s ");
 const log = console.log;
-const opts = new commander.Command().description(`List and search Shortcut Docs. By default, lists all docs you have access to.
+const opts = new Command().description(`List and search Shortcut Docs. By default, lists all docs you have access to.
   Use --title to search docs by title.`).usage("[options]").option("-a, --archived", "Search for archived docs (requires --title)").option("-m, --mine", "Search for docs created by me (requires --title)").option("-f, --following", "Search for docs I am following (requires --title)").option("-t, --title [text]", "Search docs by title (required for search filters)").option("-q, --quiet", "Print only doc output, no loading dialog").option("-I, --idonly", "Print only IDs of doc results").parse(process.argv).opts();
 const main = async () => {
 	if (!opts.quiet) spin.start();
 	let docs = [];
 	try {
-		if (opts.title) {
+		if (opts.title) if (!opts.archived && !opts.mine && !opts.following) {
+			const result = await client.listDocs();
+			const title = opts.title.toLowerCase();
+			docs = result.data.filter((doc) => (doc.title || "").toLowerCase().includes(title));
+		} else {
 			const searchParams = { title: opts.title };
 			if (opts.archived !== void 0) searchParams.archived = !!opts.archived;
 			if (opts.mine) searchParams.created_by_me = true;
 			if (opts.following) searchParams.followed_by_me = true;
-			docs = (await require_lib_client.default.searchDocuments(searchParams)).data.data;
-		} else {
+			docs = (await client.searchDocuments(searchParams)).data.data;
+		}
+		else {
 			if (opts.archived || opts.mine || opts.following) {
 				if (!opts.quiet) spin.stop(true);
 				log("Note: --archived, --mine, and --following require --title for searching.");
 				log("Listing all docs instead...");
 				if (!opts.quiet) spin.start();
 			}
-			docs = (await require_lib_client.default.listDocs()).data;
+			docs = (await client.listDocs()).data;
 		}
 	} catch (e) {
 		if (!opts.quiet) spin.stop(true);
@@ -38,13 +41,18 @@ const main = async () => {
 		log("No docs found.");
 		return;
 	}
-	docs.forEach((doc) => printDoc(doc));
+	docs.forEach((doc) => {
+		printDoc(doc);
+	});
 };
 const printDoc = (doc) => {
-	if (opts.idonly) return log(doc.id);
+	if (opts.idonly) {
+		log(doc.id);
+		return;
+	}
 	log(`${doc.id} ${doc.title || "(Untitled)"}`);
 	log(`\tURL: ${doc.app_url}`);
 };
 main();
-
-//#endregion
+//#endregion
+export {};

package/build/bin/short-epic.js

@@ -0,0 +1,186 @@
+#!/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 os from "os";
+import { exec } from "child_process";
+//#region src/bin/short-epic.ts
+const config = loadConfig();
+const spin = spinner();
+const log = console.log;
+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 stories_default.fetchEntities();
+	if (!options.idonly) spin.start();
+	const epicData = { name: options.name ?? "" };
+	if (options.description) epicData.description = options.description;
+	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 = stories_default.findOwnerIds(entities, options.owners);
+	if (options.team) {
+		const group = stories_default.findGroup(entities, options.team);
+		if (group?.id) epicData.group_ids = [group.id];
+	}
+	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 client.createEpic(epicData).then((r) => r.data);
+	} catch (e) {
+		if (!options.idonly) spin.stop(true);
+		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) 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((label) => label.name).join(", ")}`);
+	log(`URL:\t\t${epic.app_url}`);
+}
+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

@@ -0,0 +1,36 @@
+#!/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-epics.ts
+const log = console.log;
+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, entities] = await Promise.all([client.listEpics().then((r) => r.data), stories_default.fetchEntities()]);
+	spin.stop(true);
+	const textMatch = new RegExp(opts.title ?? "", "i");
+	const objectiveIds = opts.objectives ? stories_default.findObjectiveIds(entities, opts.objectives) : [];
+	epics.filter((epic) => {
+		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, 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.started) defaultFormat += `Started:\t%st\n`;
+	if (epic.completed) defaultFormat += `Completed:\t%co\n`;
+	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
+export {};

package/build/bin/short-find.js

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