@hasna/todos 0.11.27 → 0.11.28

package/dist/cli/index.js

@@ -32779,7 +32779,7 @@ function formatTaskLine(t) {
   const plan = t.plan_id ? chalk3.magenta(` [plan:${t.plan_id.slice(0, 8)}]`) : "";
   return `${chalk3.dim(t.id.slice(0, 8))} ${statusFn(t.status.padEnd(11))} ${priorityFn(t.priority.padEnd(8))} ${t.title}${assigned}${lock}${tags}${plan}`;
 }
-program2.name("todos").description("Universal task management for AI coding agents").version(getPackageVersion()).option("--project <path>", "Project path").option("--json", "Output as JSON").option("--agent <name>", "Agent name").option("--session <id>", "Session ID");
+program2.name("todos").description("Universal task management for AI coding agents").version(getPackageVersion()).option("--project <path>", "Project path").option("-j, --json", "Output as JSON").option("--agent <name>", "Agent name").option("--session <id>", "Session ID");
 program2.command("add <title>").description("Create a new task").option("-d, --description <text>", "Task description").option("-p, --priority <level>", "Priority: low, medium, high, critical").option("--parent <id>", "Parent task ID").option("-t, --tags <tags>", "Comma-separated tags").option("--tag <tags>", "Comma-separated tags (alias for --tags)").option("--plan <id>", "Assign to a plan").option("--assign <agent>", "Assign to agent").option("--status <status>", "Initial status").option("--list <id>", "Task list ID").option("--task-list <id>", "Task list ID (alias for --list)").option("--estimated <minutes>", "Estimated time in minutes").option("--approval", "Require approval before completion").option("--recurrence <rule>", "Recurrence rule, e.g. 'every day', 'every weekday', 'every 2 weeks'").option("--due <date>", "Due date (ISO string or YYYY-MM-DD)").option("--reason <text>", "Why this task exists").action((title, opts) => {
   const globalOpts = program2.opts();
   const projectId = autoProject(globalOpts);
@@ -32836,6 +32836,16 @@ program2.command("list").description("List tasks").option("-s, --status <status>
   const projectId = autoProject(globalOpts);
   const hasAssignedFilter = Boolean(opts.assigned || opts.agentName);
   const hasExplicitProjectFilter = Boolean(globalOpts.project || opts.projectName);
+  const allowedSortFields = new Set(["updated", "created", "priority", "status"]);
+  if (opts.sort && !allowedSortFields.has(opts.sort)) {
+    console.error(chalk3.red(`Invalid --sort value: ${opts.sort}. Allowed values: updated, created, priority, status.`));
+    process.exit(1);
+  }
+  const allowedFormats = new Set(["table", "compact", "csv", "json"]);
+  if (opts.format && !allowedFormats.has(opts.format)) {
+    console.error(chalk3.red(`Invalid --format value: ${opts.format}. Allowed values: table, compact, csv, json.`));
+    process.exit(1);
+  }
   const filter = {};
   if (projectId && !(hasAssignedFilter && !hasExplicitProjectFilter)) {
     filter["project_id"] = projectId;
@@ -32875,8 +32885,14 @@ program2.command("list").description("List tasks").option("-s, --status <status>
   }
   if (opts.recurring)
     filter["has_recurrence"] = true;
-  if (opts.limit)
-    filter["limit"] = parseInt(opts.limit, 10);
+  if (opts.limit !== undefined) {
+    const parsedLimit = Number.parseInt(String(opts.limit), 10);
+    if (!Number.isInteger(parsedLimit) || parsedLimit <= 0) {
+      console.error(chalk3.red(`Invalid --limit value: ${opts.limit}. Must be a positive integer.`));
+      process.exit(1);
+    }
+    filter["limit"] = parsedLimit;
+  }
   let tasks = listTasks(filter);
   if (opts.dueToday) {
     const todayEnd = new Date;
@@ -33877,7 +33893,7 @@ program2.command("projects").description("List and manage projects").option("--a
     console.log(`${chalk3.dim(p.id.slice(0, 8))} ${chalk3.bold(p.name)} ${chalk3.dim(p.path)}${taskList}${p.description ? ` - ${p.description}` : ""}`);
   }
 });
-program2.command("project-rename <id-or-slug> <new-slug>").description("Rename a project slug. Cascades to matching task lists. Task prefixes (e.g. APP-00001) are unchanged.").option("--name <name>", "Also update the project display name").option("--json", "Output as JSON").action((idOrSlug, newSlug, opts) => {
+program2.command("project-rename <id-or-slug> <new-slug>").description("Rename a project slug. Cascades to matching task lists. Task prefixes (e.g. APP-00001) are unchanged.").option("--name <name>", "Also update the project display name").option("-j, --json", "Output as JSON").action((idOrSlug, newSlug, opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {
@@ -33907,7 +33923,7 @@ program2.command("project-rename <id-or-slug> <new-slug>").description("Rename a
   }
 });
 var projectsPathCmd = program2.command("projects-path").description("Manage machine-local path overrides for projects");
-projectsPathCmd.command("set <project-id> <path>").description("Set the local path for a project on this machine").option("--json", "Output as JSON").action((projectId, projectPath, opts) => {
+projectsPathCmd.command("set <project-id> <path>").description("Set the local path for a project on this machine").option("-j, --json", "Output as JSON").action((projectId, projectPath, opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {
@@ -33929,7 +33945,7 @@ projectsPathCmd.command("set <project-id> <path>").description("Set the local pa
     process.exit(1);
   }
 });
-projectsPathCmd.command("list <project-id>").description("List all machine path overrides for a project").option("--json", "Output as JSON").action((projectId, opts) => {
+projectsPathCmd.command("list <project-id>").description("List all machine path overrides for a project").option("-j, --json", "Output as JSON").action((projectId, opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {
@@ -34581,7 +34597,7 @@ program2.command("agent-update <name>").alias("agents-update").description("Upda
     handleError(e);
   }
 });
-program2.command("agent <name>").description("Show all info about an agent: tasks, status, last seen, stats").option("--json", "Output as JSON").action((name, opts) => {
+program2.command("agent <name>").description("Show all info about an agent: tasks, status, last seen, stats").option("-j, --json", "Output as JSON").action((name, opts) => {
   const globalOpts = program2.opts();
   const { getAgentByName: findByName } = (init_agents(), __toCommonJS(exports_agents));
   const agent = findByName(name);
@@ -35014,7 +35030,7 @@ program2.command("dashboard").description("Live-updating dashboard showing proje
   const projectId = opts.project || autoProject(globalOpts) || undefined;
   render2(React.createElement(Dashboard2, { projectId, refreshMs: parseInt(opts.refresh, 10) }));
 });
-program2.command("next").description("Show the best pending task to work on next").option("--agent <id>", "Prefer tasks assigned to this agent").option("--project <id>", "Filter to project").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("next").description("Show the best pending task to work on next").option("--agent <id>", "Prefer tasks assigned to this agent").option("--project <id>", "Filter to project").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const filters = {};
@@ -35038,7 +35054,7 @@ program2.command("next").description("Show the best pending task to work on next
   if (task.description)
     console.log(chalk3.dim(`  ${task.description.slice(0, 100)}`));
 });
-program2.command("claim <agent>").description("Atomically claim the best pending task for an agent").option("--project <id>", "Filter to project").option("--json", "Output as JSON").action(async (agent, opts) => {
+program2.command("claim <agent>").description("Atomically claim the best pending task for an agent").option("--project <id>", "Filter to project").option("-j, --json", "Output as JSON").action(async (agent, opts) => {
   const db = getDatabase();
   const filters = {};
   if (opts.project)
@@ -35068,7 +35084,7 @@ program2.command("steal <agent>").description("Work-stealing: take the highest-p
   }
   console.log(chalk3.green(`Stolen: ${task.short_id || task.id.slice(0, 8)} | ${task.priority} | ${task.title}`));
 });
-program2.command("status").description("Show full project health snapshot").option("--agent <id>", "Include next task for this agent").option("--project <id>", "Filter to project").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("status").description("Show full project health snapshot").option("--agent <id>", "Include next task for this agent").option("--project <id>", "Filter to project").option("-j, --json", "Output as JSON").action(async (opts) => {
   const db = getDatabase();
   const filters = {};
   if (opts.project)
@@ -35212,7 +35228,7 @@ Blocked:`));
   }
   console.log();
 });
-program2.command("fail <id>").description("Mark a task as failed with optional reason and retry").option("--reason <text>", "Why it failed").option("--agent <id>", "Agent reporting the failure").option("--retry", "Auto-create a retry copy").option("--json", "Output as JSON").action(async (id, opts) => {
+program2.command("fail <id>").description("Mark a task as failed with optional reason and retry").option("--reason <text>", "Why it failed").option("--agent <id>", "Agent reporting the failure").option("--retry", "Auto-create a retry copy").option("-j, --json", "Output as JSON").action(async (id, opts) => {
   const db = getDatabase();
   const resolvedId = resolvePartialId(db, "tasks", id);
   if (!resolvedId) {
@@ -35230,7 +35246,7 @@ program2.command("fail <id>").description("Mark a task as failed with optional r
   if (result.retryTask)
     console.log(chalk3.yellow(`Retry created: ${result.retryTask.short_id || result.retryTask.id.slice(0, 8)} | ${result.retryTask.title}`));
 });
-program2.command("active").description("Show all currently in-progress tasks").option("--project <id>", "Filter to project").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("active").description("Show all currently in-progress tasks").option("--project <id>", "Filter to project").option("-j, --json", "Output as JSON").action(async (opts) => {
   const db = getDatabase();
   const filters = {};
   if (opts.project)
@@ -35251,7 +35267,7 @@ program2.command("active").description("Show all currently in-progress tasks").o
     console.log(`  ${chalk3.cyan(id)} | ${chalk3.yellow(w.priority)} | ${agent.padEnd(12)} | ${w.title}`);
   }
 });
-program2.command("stale").description("Find tasks stuck in_progress with no recent activity").option("--minutes <n>", "Stale threshold in minutes", "30").option("--project <id>", "Filter to project").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("stale").description("Find tasks stuck in_progress with no recent activity").option("--minutes <n>", "Stale threshold in minutes", "30").option("--project <id>", "Filter to project").option("-j, --json", "Output as JSON").action(async (opts) => {
   const db = getDatabase();
   const filters = {};
   if (opts.project)
@@ -35272,7 +35288,7 @@ program2.command("stale").description("Find tasks stuck in_progress with no rece
     console.log(`  ${chalk3.cyan(id)} | ${t.locked_by || t.assigned_to || "?"} | ${t.title} ${chalk3.dim(`(${staleMin}min stale)`)}`);
   }
 });
-program2.command("redistribute <agent>").description("Release stale in-progress tasks and claim the best one (work-stealing)").option("--max-age <minutes>", "Stale threshold in minutes", "60").option("--project <id>", "Limit to a specific project").option("--limit <n>", "Max stale tasks to release").option("--json", "Output as JSON").action(async (agent, opts) => {
+program2.command("redistribute <agent>").description("Release stale in-progress tasks and claim the best one (work-stealing)").option("--max-age <minutes>", "Stale threshold in minutes", "60").option("--project <id>", "Limit to a specific project").option("--limit <n>", "Max stale tasks to release").option("-j, --json", "Output as JSON").action(async (agent, opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const projectId = opts.project ? resolveTaskId(opts.project) : autoProject(globalOpts) ?? undefined;
@@ -35299,7 +35315,7 @@ Claimed: ${chalk3.cyan(id)} ${result.claimed.title}`));
 No task claimed (nothing available).`));
   }
 });
-program2.command("assign <id> <agent>").description("Assign a task to an agent").option("--json", "Output as JSON").action((id, agent, opts) => {
+program2.command("assign <id> <agent>").description("Assign a task to an agent").option("-j, --json", "Output as JSON").action((id, agent, opts) => {
   const globalOpts = program2.opts();
   const resolvedId = resolveTaskId(id);
   const db = getDatabase();
@@ -35319,7 +35335,7 @@ program2.command("assign <id> <agent>").description("Assign a task to an agent")
     handleError(new Error("Failed to assign"));
   }
 });
-program2.command("unassign <id>").description("Remove task assignment").option("--json", "Output as JSON").action((id, opts) => {
+program2.command("unassign <id>").description("Remove task assignment").option("-j, --json", "Output as JSON").action((id, opts) => {
   const globalOpts = program2.opts();
   const resolvedId = resolveTaskId(id);
   const db = getDatabase();
@@ -35339,7 +35355,7 @@ program2.command("unassign <id>").description("Remove task assignment").option("
     handleError(new Error("Failed to unassign"));
   }
 });
-program2.command("tag <id> <tag>").description("Add a tag to a task").option("--json", "Output as JSON").action((id, tag, opts) => {
+program2.command("tag <id> <tag>").description("Add a tag to a task").option("-j, --json", "Output as JSON").action((id, tag, opts) => {
   const globalOpts = program2.opts();
   const resolvedId = resolveTaskId(id);
   const db = getDatabase();
@@ -35360,7 +35376,7 @@ program2.command("tag <id> <tag>").description("Add a tag to a task").option("--
     handleError(new Error("Failed to tag"));
   }
 });
-program2.command("untag <id> <tag>").description("Remove a tag from a task").option("--json", "Output as JSON").action((id, tag, opts) => {
+program2.command("untag <id> <tag>").description("Remove a tag from a task").option("-j, --json", "Output as JSON").action((id, tag, opts) => {
   const globalOpts = program2.opts();
   const resolvedId = resolveTaskId(id);
   const db = getDatabase();
@@ -35381,7 +35397,7 @@ program2.command("untag <id> <tag>").description("Remove a tag from a task").opt
     handleError(new Error("Failed to untag"));
   }
 });
-program2.command("pin <id>").description("Escalate task to critical priority").option("--json", "Output as JSON").action((id, opts) => {
+program2.command("pin <id>").description("Escalate task to critical priority").option("-j, --json", "Output as JSON").action((id, opts) => {
   const globalOpts = program2.opts();
   const resolvedId = resolveTaskId(id);
   const db = getDatabase();
@@ -35397,7 +35413,7 @@ program2.command("pin <id>").description("Escalate task to critical priority").o
     handleError(new Error("Failed to pin"));
   }
 });
-program2.command("summary").description("Generate a markdown summary of recent task activity").option("--days <n>", "Days of history to include", "7").option("--project <id>", "Filter to project").option("--agent <id>", "Filter to agent").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("summary").description("Generate a markdown summary of recent task activity").option("--days <n>", "Days of history to include", "7").option("--project <id>", "Filter to project").option("--agent <id>", "Filter to agent").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const days = parseInt(opts.days, 10);
@@ -35452,7 +35468,7 @@ program2.command("summary").description("Generate a markdown summary of recent t
   console.log(lines.join(`
 `));
 });
-program2.command("doctor").description("Diagnose common task data issues").option("--fix", "Auto-fix recoverable issues where possible").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("doctor").description("Diagnose common task data issues").option("--fix", "Auto-fix recoverable issues where possible").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const issues = [];
@@ -35494,7 +35510,7 @@ program2.command("doctor").description("Diagnose common task data issues").optio
     console.log(chalk3[errors2 > 0 ? "red" : "yellow"](`
   ${errors2} error(s), ${warns} warning(s). Run with --fix to auto-resolve where possible.`));
 });
-program2.command("health").description("Check todos system health \u2014 database, config, connectivity").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("health").description("Check todos system health \u2014 database, config, connectivity").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const checks = [];
   try {
@@ -35549,7 +35565,7 @@ program2.command("health").description("Check todos system health \u2014 databas
   console.log(`
   ${allOk ? chalk3.green("All checks passed.") : chalk3.yellow("Some checks need attention.")}`);
 });
-program2.command("report").description("Analytics report: task activity, completion rates, agent breakdown").option("--days <n>", "Days to include in report", "7").option("--project <id>", "Filter to project").option("--markdown", "Output as markdown").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("report").description("Analytics report: task activity, completion rates, agent breakdown").option("--days <n>", "Days to include in report", "7").option("--project <id>", "Filter to project").option("--markdown", "Output as markdown").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const days = parseInt(opts.days, 10);
@@ -35614,7 +35630,7 @@ program2.command("report").description("Analytics report: task activity, complet
   console.log(lines.join(`
 `));
 });
-program2.command("today").description("Show task activity from today").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("today").description("Show task activity from today").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { getTasksChangedSince: getTasksChangedSince2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -35644,7 +35660,7 @@ program2.command("today").description("Show task activity from today").option("-
   if (completed.length === 0 && started.length === 0)
     console.log(chalk3.dim("  No activity today."));
 });
-program2.command("yesterday").description("Show task activity from yesterday").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("yesterday").description("Show task activity from yesterday").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { getTasksChangedSince: getTasksChangedSince2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -35677,7 +35693,7 @@ program2.command("yesterday").description("Show task activity from yesterday").o
   if (completed.length === 0 && started.length === 0)
     console.log(chalk3.dim("  No activity yesterday."));
 });
-program2.command("mine").description("Show tasks assigned to you, grouped by status").argument("<agent>", "Agent name or ID").option("--json", "Output as JSON").action(async (agent, opts) => {
+program2.command("mine").description("Show tasks assigned to you, grouped by status").argument("<agent>", "Agent name or ID").option("-j, --json", "Output as JSON").action(async (agent, opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { listTasks: listTasks2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -35728,7 +35744,7 @@ program2.command("mine").description("Show tasks assigned to you, grouped by sta
   if (tasks.length === 0)
     console.log(chalk3.dim(`  No tasks assigned to ${agent}.`));
 });
-program2.command("blocked").description("Show tasks blocked by incomplete dependencies").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+program2.command("blocked").description("Show tasks blocked by incomplete dependencies").option("-j, --json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { listTasks: listTasks2, getBlockingDeps: getBlockingDeps2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -35760,7 +35776,7 @@ program2.command("blocked").description("Show tasks blocked by incomplete depend
     }
   }
 });
-program2.command("overdue").description("Show tasks past their due date").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+program2.command("overdue").description("Show tasks past their due date").option("-j, --json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
   const globalOpts = program2.opts();
   const projectId = autoProject(globalOpts) || opts.project || undefined;
   const { getOverdueTasks: getOverdueTasks2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -35782,7 +35798,7 @@ program2.command("overdue").description("Show tasks past their due date").option
     console.log(`  ${urgency} ${chalk3.cyan(t.short_id || t.id.slice(0, 8))} ${t.title}${t.assigned_to ? chalk3.dim(` \u2014 ${t.assigned_to}`) : ""} ${chalk3.dim(`(due ${dueDate})`)}`);
   }
 });
-program2.command("week").description("Show task activity from the past 7 days").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("week").description("Show task activity from the past 7 days").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { getTasksChangedSince: getTasksChangedSince2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -35835,7 +35851,7 @@ program2.command("week").description("Show task activity from the past 7 days").
   if (tasks.length === 0)
     console.log(chalk3.dim("  No activity this week."));
 });
-program2.command("burndown").description("Show task completion velocity over the past 7 days").option("--days <n>", "Number of days", "7").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("burndown").description("Show task completion velocity over the past 7 days").option("--days <n>", "Number of days", "7").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { getRecentActivity: getRecentActivity2 } = (init_audit(), __toCommonJS(exports_audit));
@@ -35877,7 +35893,7 @@ program2.command("burndown").description("Show task completion velocity over the
   console.log(chalk3.dim(`
   Velocity: ${velocity}/day \xB7 ${totalCompleted} done \xB7 ${totalCreated} created`));
 });
-program2.command("log").description("Show recent task activity log (git-log style)").option("--limit <n>", "Number of entries", "30").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("log").description("Show recent task activity log (git-log style)").option("--limit <n>", "Number of entries", "30").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { getRecentActivity: getRecentActivity2 } = (init_audit(), __toCommonJS(exports_audit));
@@ -35921,7 +35937,7 @@ program2.command("log").description("Show recent task activity log (git-log styl
     console.log(`  ${chalk3.dim(time)} ${icon} ${e.action.padEnd(8)} ${taskRef}${detail}${agent}`);
   }
 });
-program2.command("ready").description("Show all tasks ready to be claimed (pending, unblocked, unlocked)").option("--json", "Output as JSON").option("--project <id>", "Filter to project").option("--limit <n>", "Max tasks to show", "20").action(async (opts) => {
+program2.command("ready").description("Show all tasks ready to be claimed (pending, unblocked, unlocked)").option("-j, --json", "Output as JSON").option("--project <id>", "Filter to project").option("--limit <n>", "Max tasks to show", "20").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { listTasks: listTasks2, getBlockingDeps: getBlockingDeps2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -35954,7 +35970,7 @@ program2.command("ready").description("Show all tasks ready to be claimed (pendi
     console.log(`  ${chalk3.cyan(t.short_id || t.id.slice(0, 8))} ${t.title} ${pri}${due}`);
   }
 });
-program2.command("sprint").description("Sprint dashboard: in-progress, next up, blockers, and overdue").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+program2.command("sprint").description("Sprint dashboard: in-progress, next up, blockers, and overdue").option("-j, --json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { listTasks: listTasks2, getBlockingDeps: getBlockingDeps2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -36015,7 +36031,7 @@ program2.command("sprint").description("Sprint dashboard: in-progress, next up,
   console.log(chalk3.dim(`
   ${inProgress.length} active \xB7 ${pending.length} pending \xB7 ${blocked.length} blocked \xB7 ${overdue.length} overdue`));
 });
-program2.command("handoff").description("Create or view agent session handoffs").option("--create", "Create a new handoff").option("--agent <name>", "Agent name").option("--summary <text>", "Handoff summary").option("--completed <items>", "Comma-separated completed items").option("--in-progress <items>", "Comma-separated in-progress items").option("--blockers <items>", "Comma-separated blockers").option("--next <items>", "Comma-separated next steps").option("--json", "Output as JSON").option("--limit <n>", "Number of handoffs to show", "5").action(async (opts) => {
+program2.command("handoff").description("Create or view agent session handoffs").option("--create", "Create a new handoff").option("--agent <name>", "Agent name").option("--summary <text>", "Handoff summary").option("--completed <items>", "Comma-separated completed items").option("--in-progress <items>", "Comma-separated in-progress items").option("--blockers <items>", "Comma-separated blockers").option("--next <items>", "Comma-separated next steps").option("-j, --json", "Output as JSON").option("--limit <n>", "Number of handoffs to show", "5").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { createHandoff: createHandoff2, listHandoffs: listHandoffs2 } = (init_handoffs(), __toCommonJS(exports_handoffs));
@@ -36077,7 +36093,7 @@ program2.command("handoff").description("Create or view agent session handoffs")
     }
   }
 });
-program2.command("priorities").description("Show task counts grouped by priority").option("--json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
+program2.command("priorities").description("Show task counts grouped by priority").option("-j, --json", "Output as JSON").option("--project <id>", "Filter to project").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { countTasks: countTasks2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -36109,7 +36125,7 @@ program2.command("priorities").description("Show task counts grouped by priority
     console.log(`  ${color(p.padEnd(9))} ${String(c.total).padStart(4)} total  ${chalk3.green(String(c.completed).padStart(3))} done  ${chalk3.blue(String(c.in_progress).padStart(3))} active  ${chalk3.dim(String(c.pending).padStart(3))} pending  ${bar}`);
   }
 });
-program2.command("context").description("Session start context: status, latest handoff, next task, overdue").option("--agent <name>", "Agent name for handoff lookup").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("context").description("Session start context: status, latest handoff, next task, overdue").option("--agent <name>", "Agent name for handoff lookup").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const db = getDatabase();
   const { getStatus: getStatus2 } = (init_tasks(), __toCommonJS(exports_tasks));
@@ -36151,7 +36167,7 @@ program2.command("context").description("Session start context: status, latest h
   console.log(chalk3.dim(`
   as_of: ${new Date().toISOString()}`));
 });
-program2.command("report-failure").description("Create a task from a test/build/typecheck failure and auto-assign it").requiredOption("--error <message>", "Error message or summary").option("--type <type>", "Failure type: test, build, typecheck, runtime, other", "test").option("--file <path>", "File where failure occurred").option("--stack <trace>", "Stack trace or detailed output").option("--title <title>", "Custom task title (auto-generated if omitted)").option("--priority <p>", "Priority: low, medium, high, critical").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("report-failure").description("Create a task from a test/build/typecheck failure and auto-assign it").requiredOption("--error <message>", "Error message or summary").option("--type <type>", "Failure type: test, build, typecheck, runtime, other", "test").option("--file <path>", "File where failure occurred").option("--stack <trace>", "Stack trace or detailed output").option("--title <title>", "Custom task title (auto-generated if omitted)").option("--priority <p>", "Priority: low, medium, high, critical").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const { createTask: createTask2 } = (init_tasks(), __toCommonJS(exports_tasks));
   const { autoAssignTask: autoAssignTask2 } = await Promise.resolve().then(() => (init_auto_assign(), exports_auto_assign));
@@ -36210,7 +36226,7 @@ program2.action(async () => {
 });
 program2.addCommand(makeBrainsCommand());
 var dbCmd = program2.command("db").description("Database management commands");
-dbCmd.command("migrate-pg").description("Apply PostgreSQL migrations to the configured RDS instance").option("--connection-string <url>", "PostgreSQL connection string (overrides cloud config)").option("--json", "Output as JSON").action(async (opts) => {
+dbCmd.command("migrate-pg").description("Apply PostgreSQL migrations to the configured RDS instance").option("--connection-string <url>", "PostgreSQL connection string (overrides cloud config)").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   let connStr;
@@ -36263,7 +36279,7 @@ dbCmd.command("migrate-pg").description("Apply PostgreSQL migrations to the conf
   }
 });
 var cloudCmd = program2.command("cloud").description("Cloud sync commands");
-cloudCmd.command("status").description("Show cloud config, connection health, machine registry, and sync status").option("--json", "Output as JSON").action(async (opts) => {
+cloudCmd.command("status").description("Show cloud config, connection health, machine registry, and sync status").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {
@@ -36354,7 +36370,7 @@ Conflicts`));
     }
   }
 });
-cloudCmd.command("push").description("Push local data to cloud PostgreSQL").option("--tables <tables>", "Comma-separated table names (default: all)").option("--json", "Output as JSON").action(async (opts) => {
+cloudCmd.command("push").description("Push local data to cloud PostgreSQL").option("--tables <tables>", "Comma-separated table names (default: all)").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {
@@ -36414,7 +36430,7 @@ cloudCmd.command("push").description("Push local data to cloud PostgreSQL").opti
     process.exit(1);
   }
 });
-cloudCmd.command("pull").description("Pull cloud data to local \u2014 merges by primary key").option("--tables <tables>", "Comma-separated table names (default: all)").option("--json", "Output as JSON").action(async (opts) => {
+cloudCmd.command("pull").description("Pull cloud data to local \u2014 merges by primary key").option("--tables <tables>", "Comma-separated table names (default: all)").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {
@@ -36472,7 +36488,7 @@ cloudCmd.command("pull").description("Pull cloud data to local \u2014 merges by
     process.exit(1);
   }
 });
-cloudCmd.command("sync").description("Bidirectional sync \u2014 pull remote changes then push local changes").option("--tables <tables>", "Comma-separated table names (default: all)").option("--json", "Output as JSON").action(async (opts) => {
+cloudCmd.command("sync").description("Bidirectional sync \u2014 pull remote changes then push local changes").option("--tables <tables>", "Comma-separated table names (default: all)").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {
@@ -36548,7 +36564,7 @@ cloudCmd.command("sync").description("Bidirectional sync \u2014 pull remote chan
     process.exit(1);
   }
 });
-cloudCmd.command("conflicts").description("List sync conflicts detected during push/pull").option("--resolved", "Show resolved conflicts instead of unresolved").option("--table <table>", "Filter by table name").option("--limit <n>", "Max conflicts to show", "20").option("--json", "Output as JSON").action(async (opts) => {
+cloudCmd.command("conflicts").description("List sync conflicts detected during push/pull").option("--resolved", "Show resolved conflicts instead of unresolved").option("--table <table>", "Filter by table name").option("--limit <n>", "Max conflicts to show", "20").option("-j, --json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const useJson = opts.json || globalOpts.json;
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/todos",
-  "version": "0.11.27",
+  "version": "0.11.28",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",