@eunjae/il 1.1.0 → 1.2.0

package/dist/scripts/il.mjs

@@ -687,18 +687,6 @@ const appendDayAssignment = (task, date, action, msg) => {
 	};
 };
 
-//#endregion
-//#region lib/taskStore.ts
-const createTaskInStore = async (workspaceRoot, task) => {
-	const { alias, aliases } = await allocateAlias(workspaceRoot, task.type === "pr_review" ? "R" : "T", task.id);
-	await writeAliases(workspaceRoot, aliases);
-	await saveTask(workspaceRoot, task.status, task);
-	return {
-		alias,
-		task
-	};
-};
-
 //#endregion
 //#region lib/taskResolver.ts
 const stableRefPattern = /^[TR]-[A-Z0-9]{6}$/;
@@ -723,6 +711,18 @@ const resolveTask = async (workspaceRoot, identifier) => {
 	};
 };
 
+//#endregion
+//#region lib/taskStore.ts
+const createTaskInStore = async (workspaceRoot, task) => {
+	const { alias, aliases } = await allocateAlias(workspaceRoot, task.type === "pr_review" ? "R" : "T", task.id);
+	await writeAliases(workspaceRoot, aliases);
+	await saveTask(workspaceRoot, task.status, task);
+	return {
+		alias,
+		task
+	};
+};
+
 //#endregion
 //#region scripts/il.ts
 const program = new Command();
@@ -752,6 +752,11 @@ const printLines = (lines) => {
 	}
 	process.stdout.write(`${lines.join("\n")}\n`);
 };
+const failWithHelp = (command, message) => {
+	process.stderr.write(`${message}\n`);
+	command.outputHelp();
+	process.exitCode = 1;
+};
 const listScopes = [
 	"today",
 	"yesterday",
@@ -787,6 +792,7 @@ const resolvePackageVersion = async () => {
 const packageVersion = await resolvePackageVersion();
 program.name("il").description("Terminal task manager").option("--store <path>", "explicit workspace path").option("--global", "use global workspace").option("--repo", "use repo workspace");
 if (packageVersion) program.version(packageVersion);
+program.showHelpAfterError();
 program.command("init").description("initialize repo workspace").action(handleAction(async () => {
 	const repoRoot = await findGitRoot(process.cwd());
 	if (!repoRoot) throw new Error("Not inside a git repository");
@@ -806,22 +812,34 @@ program.command("where").description("show resolved workspace").action(handleAct
 }));
 program.command("add").description("add a task").argument("[title]", "task title").option("--type <type>", "regular|pr_review", "regular").option("--url <url>", "attach URL").option("--pr <url>", "attach PR URL").action(handleAction(async (title, options, command) => {
 	const taskType = options.type;
-	if (!taskTypes.includes(taskType)) throw new Error(`Invalid type: ${taskType}`);
-	if (taskType === "pr_review" && !options.pr) throw new Error("PR review tasks require --pr");
+	if (!taskTypes.includes(taskType)) {
+		failWithHelp(command, `Invalid type: ${taskType}`);
+		return;
+	}
+	if (taskType === "pr_review" && !options.pr) {
+		failWithHelp(command, "PR review tasks require --pr");
+		return;
+	}
 	const workspaceRoot = await resolveWorkspaceFor(true);
 	await withWorkspaceLock(workspaceRoot, async () => {
 		let prAttachment;
 		let prTitle;
 		if (options.pr) {
 			const parsed = parseGitHubPrUrl(options.pr);
-			if (!parsed) throw new Error("Invalid PR URL");
+			if (!parsed) {
+				failWithHelp(command, "Invalid PR URL");
+				return;
+			}
 			const fetched = await fetchGitHubPr(parsed, await resolveGithubToken(workspaceRoot));
 			prAttachment = buildPrAttachment(parsed, fetched ?? void 0);
 			prTitle = fetched?.title ?? `PR #${parsed.number} ${parsed.repo.owner}/${parsed.repo.name}`;
 		}
 		const isExplicitTitle = Boolean(title);
 		let finalTitle = title ?? prTitle;
-		if (!finalTitle) throw new Error("Title is required when no PR URL is provided");
+		if (!finalTitle) {
+			failWithHelp(command, "Title is required when no PR URL is provided");
+			return;
+		}
 		if (taskType === "pr_review" && !isExplicitTitle) finalTitle = `Review: ${finalTitle}`;
 		const metadata = {
 			url: options.url,
@@ -841,7 +859,10 @@ program.command("list").description("list tasks").argument("[status]", "task sta
 	const workspaceRoot = await resolveWorkspaceFor(true);
 	const aliasLookup = buildAliasLookup(await readAliases(workspaceRoot));
 	const lines = [];
-	if (status && !isTaskStatus(status) && !isListScope(status)) throw new Error(`Invalid status or scope: ${status}`);
+	if (status && !isTaskStatus(status) && !isListScope(status)) {
+		failWithHelp(command, `Invalid status or scope: ${status}`);
+		return;
+	}
 	if (status && isListScope(status)) {
 		const dates = listDatesForScope(status);
 		const tasks = await listAllTasks(workspaceRoot);
@@ -892,7 +913,10 @@ addTransitionCommand("cancel");
 program.command("log").description("append a log entry").argument("<id>", "task identifier").argument("<message>", "log message").option("--status <status>", "include status in log entry").action(handleAction(async (identifier, message, options, command) => {
 	const workspaceRoot = await resolveWorkspaceFor(true);
 	const status = options.status;
-	if (status && !taskStatuses.includes(status)) throw new Error(`Invalid status: ${status}`);
+	if (status && !taskStatuses.includes(status)) {
+		failWithHelp(command, `Invalid status: ${status}`);
+		return;
+	}
 	await withWorkspaceLock(workspaceRoot, async () => {
 		const stored = await resolveTask(workspaceRoot, identifier);
 		const updated = appendLog(stored.task, message, status);
@@ -921,7 +945,13 @@ program.command("search").description("search tasks").argument("<query>", "searc
 }));
 program.command("today").description("assign a task for today").argument("<id>", "task identifier").option("--date <date>", "YYYY-MM-DD").option("-m, --message <message>", "assignment message").action(handleAction(async (identifier, options, command) => {
 	const workspaceRoot = await resolveWorkspaceFor(true);
-	const date = todayDate(options.date);
+	let date;
+	try {
+		date = todayDate(options.date);
+	} catch (error) {
+		failWithHelp(command, error instanceof Error ? error.message : String(error));
+		return;
+	}
 	await withWorkspaceLock(workspaceRoot, async () => {
 		const stored = await resolveTask(workspaceRoot, identifier);
 		if (isAssignedOnDate(stored.task, date)) {
@@ -935,7 +965,13 @@ program.command("today").description("assign a task for today").argument("<id>",
 }));
 program.command("untoday").description("unassign a task from today").argument("<id>", "task identifier").option("--date <date>", "YYYY-MM-DD").action(handleAction(async (identifier, options, command) => {
 	const workspaceRoot = await resolveWorkspaceFor(true);
-	const date = todayDate(options.date);
+	let date;
+	try {
+		date = todayDate(options.date);
+	} catch (error) {
+		failWithHelp(command, error instanceof Error ? error.message : String(error));
+		return;
+	}
 	await withWorkspaceLock(workspaceRoot, async () => {
 		const stored = await resolveTask(workspaceRoot, identifier);
 		if (!isAssignedOnDate(stored.task, date)) {
@@ -951,7 +987,10 @@ program.command("attach-pr").description("attach PR metadata to a task").argumen
 	const workspaceRoot = await resolveWorkspaceFor(true);
 	await withWorkspaceLock(workspaceRoot, async () => {
 		const parsed = parseGitHubPrUrl(url);
-		if (!parsed) throw new Error("Invalid PR URL");
+		if (!parsed) {
+			failWithHelp(command, "Invalid PR URL");
+			return;
+		}
 		const fetched = await fetchGitHubPr(parsed, await resolveGithubToken(workspaceRoot));
 		const stored = await resolveTask(workspaceRoot, identifier);
 		const next = appendLog({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eunjae/il",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "bin": {
     "il": "dist/scripts/il.mjs"