@obsfx/trekker 1.7.2 → 1.10.0

package/dist/index.js

@@ -455,7 +455,7 @@ var require_customParseFormat = __commonJS((exports, module) => {
 });
 
 // src/index.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -493,8 +493,8 @@ var epics = sqliteTable("epics", {
   projectId: text("project_id").notNull(),
   title: text("title").notNull(),
   description: text("description"),
-  status: text("status").notNull().default("todo"),
-  priority: integer("priority").notNull().default(2),
+  status: text("status").notNull().default("todo").$type(),
+  priority: integer("priority").notNull().default(2).$type(),
   createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
   updatedAt: integer("updated_at", { mode: "timestamp" }).notNull()
 });
@@ -505,8 +505,8 @@ var tasks = sqliteTable("tasks", {
   parentTaskId: text("parent_task_id"),
   title: text("title").notNull(),
   description: text("description"),
-  priority: integer("priority").notNull().default(2),
-  status: text("status").notNull().default("todo"),
+  priority: integer("priority").notNull().default(2).$type(),
+  status: text("status").notNull().default("todo").$type(),
   tags: text("tags"),
   createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
   updatedAt: integer("updated_at", { mode: "timestamp" }).notNull()
@@ -628,14 +628,15 @@ function createDb(cwd = process.cwd()) {
   const dbPath = getDbPath(cwd);
   sqliteInstance = new Database(dbPath);
   dbInstance = drizzle(sqliteInstance, { schema: exports_schema });
-  sqliteInstance.exec(`
+  sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS projects (
       id TEXT PRIMARY KEY,
       name TEXT NOT NULL UNIQUE,
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL
-    );
-
+    )
+  `);
+  sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS epics (
       id TEXT PRIMARY KEY,
       project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
@@ -645,8 +646,9 @@ function createDb(cwd = process.cwd()) {
       priority INTEGER NOT NULL DEFAULT 2,
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL
-    );
-
+    )
+  `);
+  sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS tasks (
       id TEXT PRIMARY KEY,
       project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
@@ -659,8 +661,9 @@ function createDb(cwd = process.cwd()) {
       tags TEXT,
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL
-    );
-
+    )
+  `);
+  sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS comments (
       id TEXT PRIMARY KEY,
       task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
@@ -668,26 +671,26 @@ function createDb(cwd = process.cwd()) {
       content TEXT NOT NULL,
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL
-    );
-
+    )
+  `);
+  sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS dependencies (
       id TEXT PRIMARY KEY,
       task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
       depends_on_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
       created_at INTEGER NOT NULL
-    );
-
+    )
+  `);
+  sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS id_counters (
       entity_type TEXT PRIMARY KEY,
       counter INTEGER NOT NULL DEFAULT 0
-    );
-
-    -- Initialize counters
-    INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('task', 0);
-    INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('epic', 0);
-    INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('comment', 0);
-
-    -- Events table for history/logbook
+    )
+  `);
+  sqliteInstance.run("INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('task', 0)");
+  sqliteInstance.run("INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('epic', 0)");
+  sqliteInstance.run("INSERT OR IGNORE INTO id_counters (entity_type, counter) VALUES ('comment', 0)");
+  sqliteInstance.run(`
     CREATE TABLE IF NOT EXISTS events (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       action TEXT NOT NULL,
@@ -696,12 +699,11 @@ function createDb(cwd = process.cwd()) {
       snapshot TEXT,
       changes TEXT,
       created_at INTEGER NOT NULL
-    );
-
-    CREATE INDEX IF NOT EXISTS idx_events_entity ON events(entity_id);
-    CREATE INDEX IF NOT EXISTS idx_events_type_action ON events(entity_type, action);
-    CREATE INDEX IF NOT EXISTS idx_events_created_at ON events(created_at);
+    )
   `);
+  sqliteInstance.run("CREATE INDEX IF NOT EXISTS idx_events_entity ON events(entity_id)");
+  sqliteInstance.run("CREATE INDEX IF NOT EXISTS idx_events_type_action ON events(entity_type, action)");
+  sqliteInstance.run("CREATE INDEX IF NOT EXISTS idx_events_created_at ON events(created_at)");
   createSearchIndex(sqliteInstance);
   createHistoryTriggers(sqliteInstance);
   return dbInstance;
@@ -989,19 +991,8 @@ function deleteDb(cwd = process.cwd()) {
 import { eq, sql } from "drizzle-orm";
 
 // src/types/index.ts
-var TASK_STATUSES = [
-  "todo",
-  "in_progress",
-  "completed",
-  "wont_fix",
-  "archived"
-];
-var EPIC_STATUSES = [
-  "todo",
-  "in_progress",
-  "completed",
-  "archived"
-];
+var TASK_STATUSES = ["todo", "in_progress", "completed", "wont_fix", "archived"];
+var EPIC_STATUSES = ["todo", "in_progress", "completed", "archived"];
 var DEFAULT_PRIORITY = 2;
 var DEFAULT_TASK_STATUS = "todo";
 var DEFAULT_EPIC_STATUS = "todo";
@@ -1011,13 +1002,7 @@ var PAGINATION_DEFAULTS = {
   HISTORY_PAGE_SIZE: 50,
   DEFAULT_PAGE: 1
 };
-var VALID_SORT_FIELDS = [
-  "created",
-  "updated",
-  "title",
-  "priority",
-  "status"
-];
+var VALID_SORT_FIELDS = ["created", "updated", "title", "priority", "status"];
 var LIST_ENTITY_TYPES = ["epic", "task", "subtask"];
 var SEARCH_ENTITY_TYPES = ["epic", "task", "subtask", "comment"];
 var PREFIX_MAP = {
@@ -1545,6 +1530,19 @@ function resolveOptions(options) {
   };
 }
 
+// src/utils/constants.ts
+var STATUS_PAD_WIDTH = 11;
+var TYPE_PAD_WIDTH = 7;
+var JSON_INDENT = 2;
+var MS_PER_SECOND = 1000;
+var MAX_PRIORITY = 5;
+var ACTION_PAD_WIDTH = 6;
+var RADIX_DECIMAL = 10;
+var TRUNCATE_OFFSET = 3;
+var TIMESTAMP_SLICE_END = 19;
+var TRUNCATE_DEFAULT = 40;
+var TRUNCATE_CONTENT = 60;
+
 // src/utils/output.ts
 var toonMode = false;
 function setToonMode(enabled) {
@@ -1559,7 +1557,7 @@ function output(data) {
   } else if (typeof data === "string") {
     console.log(data);
   } else {
-    console.log(JSON.stringify(data, null, 2));
+    console.log(JSON.stringify(data, null, JSON_INDENT));
   }
 }
 function success(message, data) {
@@ -1583,7 +1581,11 @@ function error(message, details) {
   }
 }
 function handleCommandError(err) {
-  error(err instanceof Error ? err.message : String(err));
+  if (err instanceof Error) {
+    error(err.message);
+  } else {
+    error(String(err));
+  }
   process.exit(1);
 }
 function handleNotFound(entityType, id) {
@@ -1593,12 +1595,12 @@ function handleNotFound(entityType, id) {
 function outputResult(data, formatter, successMessage) {
   if (isToonMode()) {
     output(data);
-  } else {
-    if (successMessage) {
-      success(successMessage);
-    }
-    console.log(formatter(data));
+    return;
+  }
+  if (successMessage) {
+    success(successMessage);
   }
+  console.log(formatter(data));
 }
 function info(message) {
   if (!toonMode) {
@@ -1654,46 +1656,83 @@ function formatComment(comment) {
   return lines.join(`
 `);
 }
-function formatTaskList(tasks2) {
-  if (tasks2.length === 0) {
-    return "No tasks found.";
+function formatDependencyList(dependencies2, direction) {
+  if (dependencies2.length === 0) {
+    if (direction === "depends_on") {
+      return "No dependencies.";
+    }
+    return "Does not block any tasks.";
   }
-  const lines = tasks2.map((task) => {
-    const tags = task.tags ? ` [${task.tags}]` : "";
-    const parent = task.parentTaskId ? ` (subtask of ${task.parentTaskId})` : "";
-    return `${task.id} | ${task.status.padEnd(11)} | P${task.priority} | ${task.title}${tags}${parent}`;
-  });
-  return lines.join(`
+  if (direction === "depends_on") {
+    return dependencies2.map((d) => `  \u2192 depends on ${d.dependsOnId}`).join(`
 `);
+  }
+  return dependencies2.map((d) => `  \u2192 blocks ${d.taskId}`).join(`
+`);
+}
+function formatPaginationFooter(total, page, limit) {
+  const totalPages = Math.ceil(total / limit);
+  if (totalPages > 1) {
+    return `
+Page ${page} of ${totalPages}`;
+  }
+  return "";
 }
-function formatEpicList(epics2) {
-  if (epics2.length === 0) {
-    return "No epics found.";
+function formatPaginatedTaskList(result) {
+  const lines = [];
+  lines.push(`${result.total} task(s) (page ${result.page}, ${result.limit} per page)
+`);
+  if (result.items.length === 0) {
+    lines.push("No tasks found.");
+    return lines.join(`
+`);
   }
-  const lines = epics2.map((epic) => {
-    return `${epic.id} | ${epic.status.padEnd(11)} | P${epic.priority} | ${epic.title}`;
-  });
+  for (const task of result.items) {
+    let tags = "";
+    if (task.tags) {
+      tags = ` [${task.tags}]`;
+    }
+    let parent = "";
+    if (task.parentTaskId) {
+      parent = ` (subtask of ${task.parentTaskId})`;
+    }
+    lines.push(`${task.id} | ${task.status.padEnd(STATUS_PAD_WIDTH)} | P${task.priority} | ${task.title}${tags}${parent}`);
+  }
+  lines.push(formatPaginationFooter(result.total, result.page, result.limit));
   return lines.join(`
 `);
 }
-function formatCommentList(comments2) {
-  if (comments2.length === 0) {
-    return "No comments found.";
+function formatPaginatedEpicList(result) {
+  const lines = [];
+  lines.push(`${result.total} epic(s) (page ${result.page}, ${result.limit} per page)
+`);
+  if (result.items.length === 0) {
+    lines.push("No epics found.");
+    return lines.join(`
+`);
   }
-  return comments2.map((c) => `[${c.id}] ${c.author}: ${c.content}`).join(`
+  for (const epic of result.items) {
+    lines.push(`${epic.id} | ${epic.status.padEnd(STATUS_PAD_WIDTH)} | P${epic.priority} | ${epic.title}`);
+  }
+  lines.push(formatPaginationFooter(result.total, result.page, result.limit));
+  return lines.join(`
 `);
 }
-function formatDependencyList(dependencies2, direction) {
-  if (dependencies2.length === 0) {
-    return direction === "depends_on" ? "No dependencies." : "Does not block any tasks.";
-  }
-  if (direction === "depends_on") {
-    return dependencies2.map((d) => `  \u2192 depends on ${d.dependsOnId}`).join(`
+function formatPaginatedCommentList(result) {
+  const lines = [];
+  lines.push(`${result.total} comment(s) (page ${result.page}, ${result.limit} per page)
 `);
-  } else {
-    return dependencies2.map((d) => `  \u2192 blocks ${d.taskId}`).join(`
+  if (result.items.length === 0) {
+    lines.push("No comments found.");
+    return lines.join(`
 `);
   }
+  for (const c of result.items) {
+    lines.push(`[${c.id}] ${c.author}: ${c.content}`);
+  }
+  lines.push(formatPaginationFooter(result.total, result.page, result.limit));
+  return lines.join(`
+`);
 }
 
 // src/commands/init.ts
@@ -1706,8 +1745,7 @@ var initCommand = new Command("init").description("Initialize Trekker in the cur
     initProject();
     success("Trekker initialized successfully.");
   } catch (err) {
-    error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+    handleCommandError(err);
   }
 });
 
@@ -1730,8 +1768,7 @@ var wipeCommand = new Command2("wipe").description("Delete all Trekker data in t
     wipeProject();
     success("Trekker data deleted successfully.");
   } catch (err) {
-    error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+    handleCommandError(err);
   }
 });
 function confirm(prompt) {
@@ -1751,7 +1788,7 @@ function confirm(prompt) {
 import { Command as Command3 } from "commander";
 
 // src/services/epic.ts
-import { eq as eq2, and, isNull } from "drizzle-orm";
+import { eq as eq2, and, isNull, desc, sql as sql2 } from "drizzle-orm";
 function createEpic(input) {
   const db = getDb();
   const project = db.select().from(projects).get();
@@ -1775,15 +1812,21 @@ function createEpic(input) {
 }
 function getEpic(id) {
   const db = getDb();
-  const result = db.select().from(epics).where(eq2(epics.id, id)).get();
-  return result;
+  return db.select().from(epics).where(eq2(epics.id, id)).get();
 }
-function listEpics(status) {
+function listEpics(options) {
   const db = getDb();
-  if (status) {
-    return db.select().from(epics).where(eq2(epics.status, status)).all();
+  const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
+  const page = options?.page ?? PAGINATION_DEFAULTS.DEFAULT_PAGE;
+  const offset = (page - 1) * limit;
+  let where;
+  if (options?.status) {
+    where = eq2(epics.status, options.status);
   }
-  return db.select().from(epics).all();
+  const countRow = db.select({ count: sql2`count(*)` }).from(epics).where(where).get();
+  const total = countRow?.count ?? 0;
+  const items = db.select().from(epics).where(where).orderBy(desc(epics.createdAt)).limit(limit).offset(offset).all();
+  return { total, page, limit, items };
 }
 function updateEpic(id, input) {
   const db = getDb();
@@ -1794,16 +1837,24 @@ function updateEpic(id, input) {
   const updates = {
     updatedAt: new Date
   };
-  if (input.title !== undefined)
+  if (input.title !== undefined) {
     updates.title = input.title;
-  if (input.description !== undefined)
+  }
+  if (input.description !== undefined) {
     updates.description = input.description;
-  if (input.status !== undefined)
+  }
+  if (input.status !== undefined) {
     updates.status = input.status;
-  if (input.priority !== undefined)
+  }
+  if (input.priority !== undefined) {
     updates.priority = input.priority;
+  }
   db.update(epics).set(updates).where(eq2(epics.id, id)).run();
-  return getEpic(id);
+  const updated = getEpic(id);
+  if (!updated) {
+    throw new Error(`Epic not found after update: ${id}`);
+  }
+  return updated;
 }
 function deleteEpic(id) {
   const db = getDb();
@@ -1847,36 +1898,41 @@ function completeEpic(id) {
 }
 
 // src/utils/validator.ts
+var TASK_STATUS_SET = new Set(TASK_STATUSES);
+var EPIC_STATUS_SET = new Set(EPIC_STATUSES);
+var LIST_ENTITY_TYPE_SET = new Set(LIST_ENTITY_TYPES);
+var SEARCH_ENTITY_TYPE_SET = new Set(SEARCH_ENTITY_TYPES);
 function isValidTaskStatus(status) {
-  return TASK_STATUSES.includes(status);
+  return TASK_STATUS_SET.has(status);
 }
 function isValidEpicStatus(status) {
-  return EPIC_STATUSES.includes(status);
+  return EPIC_STATUS_SET.has(status);
 }
 function isValidPriority(priority) {
-  return Number.isInteger(priority) && priority >= 0 && priority <= 5;
+  return Number.isInteger(priority) && priority >= 0 && priority <= MAX_PRIORITY;
 }
 function parseStatus(status, type) {
-  if (!status)
+  if (!status) {
     return;
+  }
   const normalizedStatus = status.toLowerCase().replace(/-/g, "_");
   if (type === "task") {
     if (!isValidTaskStatus(normalizedStatus)) {
       throw new Error(`Invalid task status: ${status}. Valid values: ${TASK_STATUSES.join(", ")}`);
     }
     return normalizedStatus;
-  } else {
-    if (!isValidEpicStatus(normalizedStatus)) {
-      throw new Error(`Invalid epic status: ${status}. Valid values: ${EPIC_STATUSES.join(", ")}`);
-    }
-    return normalizedStatus;
   }
+  if (!isValidEpicStatus(normalizedStatus)) {
+    throw new Error(`Invalid epic status: ${status}. Valid values: ${EPIC_STATUSES.join(", ")}`);
+  }
+  return normalizedStatus;
 }
 function parsePriority(priority) {
-  if (priority === undefined)
+  if (priority === undefined) {
     return;
-  const num = parseInt(priority, 10);
-  if (isNaN(num) || !isValidPriority(num)) {
+  }
+  const num = Number.parseInt(priority, RADIX_DECIMAL);
+  if (Number.isNaN(num) || !isValidPriority(num)) {
     throw new Error(`Invalid priority: ${priority}. Must be a number between 0 and 5.`);
   }
   return num;
@@ -1887,34 +1943,68 @@ function validateRequired(value, fieldName) {
   }
 }
 function validatePagination(limit, page) {
-  if (isNaN(limit) || limit < 1) {
+  if (Number.isNaN(limit) || limit < 1) {
     throw new Error("Invalid limit value");
   }
-  if (isNaN(page) || page < 1) {
+  if (Number.isNaN(page) || page < 1) {
     throw new Error("Invalid page value");
   }
 }
+function parsePaginationOptions(opts) {
+  const limit = Number.parseInt(opts.limit, RADIX_DECIMAL);
+  const page = Number.parseInt(opts.page, RADIX_DECIMAL);
+  validatePagination(limit, page);
+  return { limit, page };
+}
 function validateListEntityTypes(types) {
   for (const t of types) {
-    if (!LIST_ENTITY_TYPES.includes(t)) {
+    if (!LIST_ENTITY_TYPE_SET.has(t)) {
       throw new Error(`Invalid type: ${t}. Valid types: ${LIST_ENTITY_TYPES.join(", ")}`);
     }
   }
 }
 function validateSearchEntityTypes(types) {
   for (const t of types) {
-    if (!SEARCH_ENTITY_TYPES.includes(t)) {
+    if (!SEARCH_ENTITY_TYPE_SET.has(t)) {
       throw new Error(`Invalid type: ${t}. Valid types: ${SEARCH_ENTITY_TYPES.join(", ")}`);
     }
   }
 }
 function validatePriorities(priorities) {
   for (const p of priorities) {
-    if (isNaN(p) || p < 0 || p > 5) {
+    if (Number.isNaN(p) || p < 0 || p > MAX_PRIORITY) {
       throw new Error(`Invalid priority: ${p}. Valid priorities: 0-5`);
     }
   }
 }
+var VALID_HISTORY_TYPES = new Set([
+  "epic",
+  "task",
+  "subtask",
+  "comment",
+  "dependency"
+]);
+var VALID_HISTORY_ACTIONS = new Set(["create", "update", "delete"]);
+function validateHistoryTypes(types) {
+  for (const t of types) {
+    if (!VALID_HISTORY_TYPES.has(t)) {
+      throw new Error(`Invalid type: ${t}. Valid types: ${[...VALID_HISTORY_TYPES].join(", ")}`);
+    }
+  }
+}
+function validateHistoryActions(actions) {
+  for (const a of actions) {
+    if (!VALID_HISTORY_ACTIONS.has(a)) {
+      throw new Error(`Invalid action: ${a}. Valid actions: ${[...VALID_HISTORY_ACTIONS].join(", ")}`);
+    }
+  }
+}
+function parseCommaSeparated(input) {
+  if (!input) {
+    return;
+  }
+  return input.split(",").map((s) => s.trim());
+}
 
 // src/commands/epic.ts
 var epicCommand = new Command3("epic").description("Manage epics");
@@ -1932,11 +2022,12 @@ epicCommand.command("create").description("Create a new epic").requiredOption("-
     handleCommandError(err);
   }
 });
-epicCommand.command("list").description("List all epics").option("-s, --status <status>", "Filter by status").action((options) => {
+epicCommand.command("list").description("List all epics").option("-s, --status <status>", "Filter by status").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((options) => {
   try {
     const status = parseStatus(options.status, "epic");
-    const epics2 = listEpics(status);
-    outputResult(epics2, formatEpicList);
+    const { limit, page } = parsePaginationOptions(options);
+    const result = listEpics({ status, limit, page });
+    outputResult(result, formatPaginatedEpicList);
   } catch (err) {
     handleCommandError(err);
   }
@@ -1944,8 +2035,9 @@ epicCommand.command("list").description("List all epics").option("-s, --status <
 epicCommand.command("show <epic-id>").description("Show epic details").action((epicId) => {
   try {
     const epic = getEpic(epicId);
-    if (!epic)
+    if (!epic) {
       return handleNotFound("Epic", epicId);
+    }
     outputResult(epic, formatEpic);
   } catch (err) {
     handleCommandError(err);
@@ -1990,7 +2082,7 @@ epicCommand.command("complete <epic-id>").description("Complete an epic and arch
 import { Command as Command4 } from "commander";
 
 // src/services/task.ts
-import { eq as eq3, and as and2, isNull as isNull2 } from "drizzle-orm";
+import { eq as eq3, and as and2, isNull as isNull2, desc as desc2, sql as sql3 } from "drizzle-orm";
 function createTask(input) {
   const db = getDb();
   const project = db.select().from(projects).get();
@@ -2029,11 +2121,13 @@ function createTask(input) {
 }
 function getTask(id) {
   const db = getDb();
-  const result = db.select().from(tasks).where(eq3(tasks.id, id)).get();
-  return result;
+  return db.select().from(tasks).where(eq3(tasks.id, id)).get();
 }
 function listTasks(options) {
   const db = getDb();
+  const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
+  const page = options?.page ?? PAGINATION_DEFAULTS.DEFAULT_PAGE;
+  const offset = (page - 1) * limit;
   const conditions = [];
   if (options?.status) {
     conditions.push(eq3(tasks.status, options.status));
@@ -2046,14 +2140,25 @@ function listTasks(options) {
   } else if (options?.parentTaskId) {
     conditions.push(eq3(tasks.parentTaskId, options.parentTaskId));
   }
+  let where;
   if (conditions.length > 0) {
-    return db.select().from(tasks).where(and2(...conditions)).all();
+    where = and2(...conditions);
   }
-  return db.select().from(tasks).all();
+  const countRow = db.select({ count: sql3`count(*)` }).from(tasks).where(where).get();
+  const total = countRow?.count ?? 0;
+  const items = db.select().from(tasks).where(where).orderBy(desc2(tasks.createdAt)).limit(limit).offset(offset).all();
+  return { total, page, limit, items };
 }
-function listSubtasks(parentTaskId) {
+function listSubtasks(parentTaskId, options) {
   const db = getDb();
-  return db.select().from(tasks).where(eq3(tasks.parentTaskId, parentTaskId)).all();
+  const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
+  const page = options?.page ?? PAGINATION_DEFAULTS.DEFAULT_PAGE;
+  const offset = (page - 1) * limit;
+  const where = eq3(tasks.parentTaskId, parentTaskId);
+  const countRow = db.select({ count: sql3`count(*)` }).from(tasks).where(where).get();
+  const total = countRow?.count ?? 0;
+  const items = db.select().from(tasks).where(where).orderBy(desc2(tasks.createdAt)).limit(limit).offset(offset).all();
+  return { total, page, limit, items };
 }
 function updateTask(id, input) {
   const db = getDb();
@@ -2070,20 +2175,30 @@ function updateTask(id, input) {
   const updates = {
     updatedAt: new Date
   };
-  if (input.title !== undefined)
+  if (input.title !== undefined) {
     updates.title = input.title;
-  if (input.description !== undefined)
+  }
+  if (input.description !== undefined) {
     updates.description = input.description;
-  if (input.priority !== undefined)
+  }
+  if (input.priority !== undefined) {
     updates.priority = input.priority;
-  if (input.status !== undefined)
+  }
+  if (input.status !== undefined) {
     updates.status = input.status;
-  if (input.tags !== undefined)
+  }
+  if (input.tags !== undefined) {
     updates.tags = input.tags;
-  if (input.epicId !== undefined)
+  }
+  if (input.epicId !== undefined) {
     updates.epicId = input.epicId;
+  }
   db.update(tasks).set(updates).where(eq3(tasks.id, id)).run();
-  return getTask(id);
+  const updated = getTask(id);
+  if (!updated) {
+    throw new Error(`Task not found after update: ${id}`);
+  }
+  return updated;
 }
 function deleteTask(id) {
   const db = getDb();
@@ -2112,15 +2227,18 @@ taskCommand.command("create").description("Create a new task").requiredOption("-
     handleCommandError(err);
   }
 });
-taskCommand.command("list").description("List all tasks").option("-s, --status <status>", "Filter by status").option("-e, --epic <epic-id>", "Filter by epic").action((options) => {
+taskCommand.command("list").description("List all tasks").option("-s, --status <status>", "Filter by status").option("-e, --epic <epic-id>", "Filter by epic").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((options) => {
   try {
     const status = parseStatus(options.status, "task");
-    const tasks2 = listTasks({
+    const { limit, page } = parsePaginationOptions(options);
+    const result = listTasks({
       status,
       epicId: options.epic,
-      parentTaskId: null
+      parentTaskId: null,
+      limit,
+      page
     });
-    outputResult(tasks2, formatTaskList);
+    outputResult(result, formatPaginatedTaskList);
   } catch (err) {
     handleCommandError(err);
   }
@@ -2128,8 +2246,9 @@ taskCommand.command("list").description("List all tasks").option("-s, --status <
 taskCommand.command("show <task-id>").description("Show task details").action((taskId) => {
   try {
     const task = getTask(taskId);
-    if (!task)
+    if (!task) {
       return handleNotFound("Task", taskId);
+    }
     outputResult(task, formatTask);
   } catch (err) {
     handleCommandError(err);
@@ -2138,16 +2257,21 @@ taskCommand.command("show <task-id>").description("Show task details").action((t
 taskCommand.command("update <task-id>").description("Update a task").option("-t, --title <title>", "New title").option("-d, --description <description>", "New description").option("-p, --priority <priority>", "New priority (0-5)").option("-s, --status <status>", "New status").option("--tags <tags>", "New tags (comma-separated)").option("-e, --epic <epic-id>", "New epic ID").option("--no-epic", "Remove from epic").action((taskId, options) => {
   try {
     const updateInput = {};
-    if (options.title !== undefined)
+    if (options.title !== undefined) {
       updateInput.title = options.title;
-    if (options.description !== undefined)
+    }
+    if (options.description !== undefined) {
       updateInput.description = options.description;
-    if (options.priority !== undefined)
+    }
+    if (options.priority !== undefined) {
       updateInput.priority = parsePriority(options.priority);
-    if (options.status !== undefined)
+    }
+    if (options.status !== undefined) {
       updateInput.status = parseStatus(options.status, "task");
-    if (options.tags !== undefined)
+    }
+    if (options.tags !== undefined) {
       updateInput.tags = options.tags;
+    }
     if (options.epic === false) {
       updateInput.epicId = null;
     } else if (options.epic !== undefined) {
@@ -2175,8 +2299,9 @@ subtaskCommand.command("create <parent-task-id>").description("Create a new subt
   try {
     validateRequired(options.title, "Title");
     const parent = getTask(parentTaskId);
-    if (!parent)
+    if (!parent) {
       return handleNotFound("Parent task", parentTaskId);
+    }
     const subtask = createTask({
       title: options.title,
       description: options.description,
@@ -2190,22 +2315,15 @@ subtaskCommand.command("create <parent-task-id>").description("Create a new subt
     handleCommandError(err);
   }
 });
-subtaskCommand.command("list <parent-task-id>").description("List all subtasks of a task").action((parentTaskId) => {
+subtaskCommand.command("list <parent-task-id>").description("List all subtasks of a task").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((parentTaskId, options) => {
   try {
     const parent = getTask(parentTaskId);
-    if (!parent)
+    if (!parent) {
       return handleNotFound("Parent task", parentTaskId);
-    const subtasks = listSubtasks(parentTaskId);
-    if (isToonMode()) {
-      output(subtasks);
-    } else {
-      if (subtasks.length === 0) {
-        console.log(`No subtasks for ${parentTaskId}`);
-      } else {
-        console.log(`Subtasks of ${parentTaskId}:`);
-        console.log(formatTaskList(subtasks));
-      }
     }
+    const { limit, page } = parsePaginationOptions(options);
+    const result = listSubtasks(parentTaskId, { limit, page });
+    outputResult(result, formatPaginatedTaskList);
   } catch (err) {
     handleCommandError(err);
   }
@@ -2213,21 +2331,26 @@ subtaskCommand.command("list <parent-task-id>").description("List all subtasks o
 subtaskCommand.command("update <subtask-id>").description("Update a subtask").option("-t, --title <title>", "New title").option("-d, --description <description>", "New description").option("-p, --priority <priority>", "New priority (0-5)").option("-s, --status <status>", "New status").action((subtaskId, options) => {
   try {
     const subtask = getTask(subtaskId);
-    if (!subtask)
+    if (!subtask) {
       return handleNotFound("Subtask", subtaskId);
+    }
     if (!subtask.parentTaskId) {
       error(`${subtaskId} is not a subtask. Use 'trekker task update' instead.`);
       process.exit(1);
     }
     const updateInput = {};
-    if (options.title !== undefined)
+    if (options.title !== undefined) {
       updateInput.title = options.title;
-    if (options.description !== undefined)
+    }
+    if (options.description !== undefined) {
       updateInput.description = options.description;
-    if (options.priority !== undefined)
+    }
+    if (options.priority !== undefined) {
       updateInput.priority = parsePriority(options.priority);
-    if (options.status !== undefined)
+    }
+    if (options.status !== undefined) {
       updateInput.status = parseStatus(options.status, "task");
+    }
     const updated = updateTask(subtaskId, updateInput);
     outputResult(updated, formatTask, `Subtask updated: ${updated.id}`);
   } catch (err) {
@@ -2237,8 +2360,9 @@ subtaskCommand.command("update <subtask-id>").description("Update a subtask").op
 subtaskCommand.command("delete <subtask-id>").description("Delete a subtask").action((subtaskId) => {
   try {
     const subtask = getTask(subtaskId);
-    if (!subtask)
+    if (!subtask) {
       return handleNotFound("Subtask", subtaskId);
+    }
     if (!subtask.parentTaskId) {
       error(`${subtaskId} is not a subtask. Use 'trekker task delete' instead.`);
       process.exit(1);
@@ -2254,7 +2378,7 @@ subtaskCommand.command("delete <subtask-id>").description("Delete a subtask").ac
 import { Command as Command6 } from "commander";
 
 // src/services/comment.ts
-import { eq as eq4 } from "drizzle-orm";
+import { eq as eq4, desc as desc3, sql as sql4 } from "drizzle-orm";
 function createComment(input) {
   const db = getDb();
   const task = db.select().from(tasks).where(eq4(tasks.id, input.taskId)).get();
@@ -2276,16 +2400,22 @@ function createComment(input) {
 }
 function getComment(id) {
   const db = getDb();
-  const result = db.select().from(comments).where(eq4(comments.id, id)).get();
-  return result;
+  return db.select().from(comments).where(eq4(comments.id, id)).get();
 }
-function listComments(taskId) {
+function listComments(taskId, options) {
   const db = getDb();
+  const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
+  const page = options?.page ?? PAGINATION_DEFAULTS.DEFAULT_PAGE;
+  const offset = (page - 1) * limit;
   const task = db.select().from(tasks).where(eq4(tasks.id, taskId)).get();
   if (!task) {
     throw new Error(`Task not found: ${taskId}`);
   }
-  return db.select().from(comments).where(eq4(comments.taskId, taskId)).all();
+  const where = eq4(comments.taskId, taskId);
+  const countRow = db.select({ count: sql4`count(*)` }).from(comments).where(where).get();
+  const total = countRow?.count ?? 0;
+  const items = db.select().from(comments).where(where).orderBy(desc3(comments.createdAt)).limit(limit).offset(offset).all();
+  return { total, page, limit, items };
 }
 function updateComment(id, input) {
   const db = getDb();
@@ -2297,7 +2427,11 @@ function updateComment(id, input) {
     content: input.content,
     updatedAt: new Date
   }).where(eq4(comments.id, id)).run();
-  return getComment(id);
+  const updated = getComment(id);
+  if (!updated) {
+    throw new Error(`Comment not found after update: ${id}`);
+  }
+  return updated;
 }
 function deleteComment(id) {
   const db = getDb();
@@ -2324,19 +2458,11 @@ commentCommand.command("add <task-id>").description("Add a comment to a task").r
     handleCommandError(err);
   }
 });
-commentCommand.command("list <task-id>").description("List all comments on a task").action((taskId) => {
+commentCommand.command("list <task-id>").description("List all comments on a task").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((taskId, options) => {
   try {
-    const comments2 = listComments(taskId);
-    if (isToonMode()) {
-      output(comments2);
-    } else {
-      if (comments2.length === 0) {
-        console.log(`No comments on ${taskId}`);
-      } else {
-        console.log(`Comments on ${taskId}:`);
-        console.log(formatCommentList(comments2));
-      }
-    }
+    const { limit, page } = parsePaginationOptions(options);
+    const result = listComments(taskId, { limit, page });
+    outputResult(result, formatPaginatedCommentList);
   } catch (err) {
     handleCommandError(err);
   }
@@ -2423,6 +2549,9 @@ function wouldCreateCycle(taskId, dependsOnId) {
   const stack = [dependsOnId];
   while (stack.length > 0) {
     const current = stack.pop();
+    if (current === undefined) {
+      continue;
+    }
     if (current === taskId) {
       return true;
     }
@@ -2812,14 +2941,25 @@ var SAMPLE_SUBTASKS = [
     priority: 3
   }
 ];
+var TASK_JWT = 1;
+var TASK_LOGIN = 2;
+var TASK_PASSWORD_RESET = 3;
+var TASK_DASHBOARD_LAYOUT = 4;
+var TASK_CHART_COMPONENTS = 5;
+var TASK_REALTIME = 6;
+var TASK_USER_ENDPOINTS = 8;
+var TASK_RATE_LIMITING = 9;
+var TASK_JEST_SETUP = 11;
+var TASK_UNIT_TESTS_AUTH = 12;
+var TASK_E2E_TESTING = 13;
 var SAMPLE_DEPENDENCIES = [
-  [2, 1],
-  [3, 1],
-  [6, 5],
-  [6, 4],
-  [9, 8],
-  [12, 11],
-  [13, 11]
+  [TASK_LOGIN, TASK_JWT],
+  [TASK_PASSWORD_RESET, TASK_JWT],
+  [TASK_REALTIME, TASK_CHART_COMPONENTS],
+  [TASK_REALTIME, TASK_DASHBOARD_LAYOUT],
+  [TASK_RATE_LIMITING, TASK_USER_ENDPOINTS],
+  [TASK_UNIT_TESTS_AUTH, TASK_JEST_SETUP],
+  [TASK_E2E_TESTING, TASK_JEST_SETUP]
 ];
 var seedCommand = new Command9("seed").description("Seed the database with sample data (development only)").option("--force", "Skip confirmation prompt").action((options) => {
   try {
@@ -2848,13 +2988,17 @@ var seedCommand = new Command9("seed").description("Seed the database with sampl
     info(`
 Creating tasks...`);
     for (const taskData of SAMPLE_TASKS) {
+      let epicId;
+      if (taskData.epicIndex !== null) {
+        epicId = epicIds[taskData.epicIndex];
+      }
       const task = createTask({
         title: taskData.title,
         description: taskData.description,
         priority: taskData.priority,
         status: taskData.status,
         tags: taskData.tags,
-        epicId: taskData.epicIndex !== null ? epicIds[taskData.epicIndex] : undefined
+        epicId
       });
       taskIds.push(task.id);
       info(`  Created ${task.id}: ${task.title}`);
@@ -2881,8 +3025,7 @@ Creating dependencies...`);
     success(`
 Seed complete! Created ${epicIds.length} epics, ${taskIds.length} tasks, ${SAMPLE_SUBTASKS.length} subtasks, and ${SAMPLE_DEPENDENCIES.length} dependencies.`);
   } catch (err) {
-    error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+    handleCommandError(err);
   }
 });
 
@@ -2940,8 +3083,8 @@ function search(query, options) {
       title: row.title,
       snippet: row.snippet,
       score: Math.abs(row.score),
-      status: row.status || null,
-      parentId: row.parent_id || null
+      status: row.status ?? null,
+      parentId: row.parent_id ?? null
     }))
   };
 }
@@ -2952,12 +3095,13 @@ var searchCommand = new Command10("search").description("Search across epics, ta
     if (options.rebuildIndex) {
       rebuildSearchIndex();
     }
-    const limit = parseInt(options.limit, 10);
-    const page = parseInt(options.page, 10);
-    validatePagination(limit, page);
-    const types = options.type ? options.type.split(",").map((t) => t.trim()) : undefined;
-    if (types)
-      validateSearchEntityTypes(types);
+    const { limit, page } = parsePaginationOptions(options);
+    const rawTypes = parseCommaSeparated(options.type);
+    let types;
+    if (rawTypes) {
+      validateSearchEntityTypes(rawTypes);
+      types = rawTypes;
+    }
     const result = search(query, {
       types,
       status: options.status,
@@ -2980,9 +3124,15 @@ function formatSearchResults(result) {
 `);
   }
   for (const r of result.results) {
-    const typeLabel = r.type.toUpperCase().padEnd(7);
-    const statusLabel = r.status ? ` [${r.status}]` : "";
-    const parentLabel = r.parentId ? ` (parent: ${r.parentId})` : "";
+    const typeLabel = r.type.toUpperCase().padEnd(TYPE_PAD_WIDTH);
+    let statusLabel = "";
+    if (r.status) {
+      statusLabel = ` [${r.status}]`;
+    }
+    let parentLabel = "";
+    if (r.parentId) {
+      parentLabel = ` (parent: ${r.parentId})`;
+    }
     lines.push(`${typeLabel} ${r.id}${statusLabel}${parentLabel}`);
     if (r.title) {
       lines.push(`  Title: ${r.title}`);
@@ -3004,6 +3154,8 @@ var import_customParseFormat = __toESM(require_customParseFormat(), 1);
 import { Command as Command11 } from "commander";
 
 // src/services/history.ts
+var parseJsonRecord = JSON.parse;
+var parseJsonChanges = JSON.parse;
 function getHistory(options) {
   const sqlite = requireSqliteInstance();
   const limit = options?.limit ?? PAGINATION_DEFAULTS.HISTORY_PAGE_SIZE;
@@ -3033,7 +3185,10 @@ function getHistory(options) {
     conditions.push("created_at <= ?");
     params.push(options.until.getTime());
   }
-  const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  let whereClause = "";
+  if (conditions.length > 0) {
+    whereClause = `WHERE ${conditions.join(" AND ")}`;
+  }
   const countQuery = `SELECT COUNT(*) as total FROM events ${whereClause}`;
   const countResult = sqlite.query(countQuery).get(...params);
   const total = countResult?.total ?? 0;
@@ -3049,15 +3204,25 @@ function getHistory(options) {
     total,
     page,
     limit,
-    events: results.map((row) => ({
-      id: row.id,
-      action: row.action,
-      entityType: row.entity_type,
-      entityId: row.entity_id,
-      snapshot: row.snapshot ? JSON.parse(row.snapshot) : null,
-      changes: row.changes ? JSON.parse(row.changes) : null,
-      timestamp: new Date(row.created_at)
-    }))
+    events: results.map((row) => {
+      let snapshot = null;
+      if (row.snapshot) {
+        snapshot = parseJsonRecord(row.snapshot);
+      }
+      let changes = null;
+      if (row.changes) {
+        changes = parseJsonChanges(row.changes);
+      }
+      return {
+        id: row.id,
+        action: row.action,
+        entityType: row.entity_type,
+        entityId: row.entity_id,
+        snapshot,
+        changes,
+        timestamp: new Date(row.created_at)
+      };
+    })
   };
 }
 
@@ -3065,31 +3230,14 @@ function getHistory(options) {
 import_dayjs.default.extend(import_customParseFormat.default);
 var historyCommand = new Command11("history").description("View history of all changes (creates, updates, deletes)").option("--entity <id>", "Filter by entity ID (e.g., TREK-1, EPIC-1)").option("--type <types>", "Filter by type: epic,task,subtask,comment,dependency (comma-separated)").option("--action <actions>", "Filter by action: create,update,delete (comma-separated)").option("--since <date>", "Events after date (YYYY-MM-DD)").option("--until <date>", "Events before date (YYYY-MM-DD)").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((options) => {
   try {
-    const types = options.type ? options.type.split(",").map((t) => t.trim()) : undefined;
-    const actions = options.action ? options.action.split(",").map((a) => a.trim()) : undefined;
-    const limit = parseInt(options.limit, 10);
-    const page = parseInt(options.page, 10);
-    if (isNaN(limit) || limit < 1) {
-      throw new Error("Invalid limit value");
-    }
-    if (isNaN(page) || page < 1) {
-      throw new Error("Invalid page value");
-    }
-    const validTypes = ["epic", "task", "subtask", "comment", "dependency"];
+    const types = parseCommaSeparated(options.type);
+    const actions = parseCommaSeparated(options.action);
+    const { limit, page } = parsePaginationOptions(options);
     if (types) {
-      for (const t of types) {
-        if (!validTypes.includes(t)) {
-          throw new Error(`Invalid type: ${t}. Valid types: ${validTypes.join(", ")}`);
-        }
-      }
+      validateHistoryTypes(types);
     }
-    const validActions = ["create", "update", "delete"];
     if (actions) {
-      for (const a of actions) {
-        if (!validActions.includes(a)) {
-          throw new Error(`Invalid action: ${a}. Valid actions: ${validActions.join(", ")}`);
-        }
-      }
+      validateHistoryActions(actions);
     }
     let since;
     let until;
@@ -3121,8 +3269,7 @@ var historyCommand = new Command11("history").description("View history of all c
       console.log(formatHistoryResults(result));
     }
   } catch (err) {
-    error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+    handleCommandError(err);
   }
 });
 function parseDate(dateStr) {
@@ -3154,8 +3301,8 @@ function formatHistoryResults(result) {
 }
 function formatEvent(event) {
   const lines = [];
-  const timestamp = event.timestamp.toISOString().replace("T", " ").substring(0, 19);
-  const actionLabel = event.action.toUpperCase().padEnd(6);
+  const timestamp = event.timestamp.toISOString().replace("T", " ").slice(0, TIMESTAMP_SLICE_END);
+  const actionLabel = event.action.toUpperCase().padEnd(ACTION_PAD_WIDTH);
   const typeLabel = event.entityType.toUpperCase();
   lines.push(`[${timestamp}] ${actionLabel} ${typeLabel} ${event.entityId}`);
   if (event.action === "update" && event.changes) {
@@ -3166,13 +3313,13 @@ function formatEvent(event) {
     }
   } else if (event.snapshot) {
     const snap = event.snapshot;
-    if (snap.title) {
+    if (typeof snap.title === "string") {
       lines.push(`  title: ${snap.title}`);
     }
-    if (snap.content) {
-      lines.push(`  content: ${truncate(String(snap.content), 60)}`);
+    if (typeof snap.content === "string") {
+      lines.push(`  content: ${truncate(snap.content, TRUNCATE_CONTENT)}`);
     }
-    if (snap.status) {
+    if (typeof snap.status === "string") {
       lines.push(`  status: ${snap.status}`);
     }
   }
@@ -3184,15 +3331,21 @@ function formatValue(value) {
     return "(none)";
   }
   if (typeof value === "string") {
-    return truncate(value, 40);
+    return truncate(value, TRUNCATE_DEFAULT);
+  }
+  if (typeof value === "number") {
+    return `${value}`;
+  }
+  if (typeof value === "boolean") {
+    return String(value);
   }
-  return String(value);
+  return JSON.stringify(value);
 }
 function truncate(str, maxLen) {
   if (str.length <= maxLen) {
     return str;
   }
-  return str.substring(0, maxLen - 3) + "...";
+  return `${str.slice(0, Math.max(0, maxLen - TRUNCATE_OFFSET))}...`;
 }
 
 // src/commands/list.ts
@@ -3201,6 +3354,7 @@ var import_customParseFormat2 = __toESM(require_customParseFormat(), 1);
 import { Command as Command12 } from "commander";
 
 // src/services/list.ts
+var VALID_SORT_FIELD_SET = new Set(VALID_SORT_FIELDS);
 function listAll(options) {
   const sqlite = requireSqliteInstance();
   const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
@@ -3225,17 +3379,25 @@ function listAll(options) {
   }
   if (options?.since) {
     conditions.push("created_at >= ?");
-    params.push(Math.floor(options.since.getTime() / 1000));
+    params.push(Math.floor(options.since.getTime() / MS_PER_SECOND));
   }
   if (options?.until) {
     conditions.push("created_at <= ?");
-    params.push(Math.floor(options.until.getTime() / 1000));
+    params.push(Math.floor(options.until.getTime() / MS_PER_SECOND));
+  }
+  let whereClause = "";
+  if (conditions.length > 0) {
+    whereClause = `WHERE ${conditions.join(" AND ")}`;
   }
-  const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   let orderClause = "ORDER BY created_at DESC";
   if (options?.sort && options.sort.length > 0) {
     const sortParts = options.sort.map((s) => {
-      const field = s.field === "created" ? "created_at" : s.field === "updated" ? "updated_at" : s.field;
+      let field = s.field;
+      if (s.field === "created") {
+        field = "created_at";
+      } else if (s.field === "updated") {
+        field = "updated_at";
+      }
       return `${field} ${s.direction.toUpperCase()}`;
     });
     orderClause = `ORDER BY ${sortParts.join(", ")}`;
@@ -3268,8 +3430,8 @@ function listAll(options) {
       status: row.status,
       priority: row.priority,
       parentId: row.parent_id,
-      createdAt: new Date(row.created_at * 1000),
-      updatedAt: new Date(row.updated_at * 1000)
+      createdAt: new Date(row.created_at * MS_PER_SECOND),
+      updatedAt: new Date(row.updated_at * MS_PER_SECOND)
     }))
   };
 }
@@ -3278,11 +3440,14 @@ function parseSort(sortStr) {
   const result = [];
   for (const part of parts) {
     const [field, dir] = part.split(":").map((s) => s.trim().toLowerCase());
-    if (!VALID_SORT_FIELDS.includes(field)) {
+    if (!VALID_SORT_FIELD_SET.has(field)) {
       throw new Error(`Invalid sort field: ${field}. Valid fields: ${VALID_SORT_FIELDS.join(", ")}`);
     }
-    const direction = dir === "asc" ? "asc" : "desc";
-    result.push({ field, direction });
+    if (dir === "asc") {
+      result.push({ field, direction: "asc" });
+    } else {
+      result.push({ field, direction: "desc" });
+    }
   }
   return result;
 }
@@ -3291,21 +3456,29 @@ function parseSort(sortStr) {
 import_dayjs2.default.extend(import_customParseFormat2.default);
 var listCommand = new Command12("list").description("List all epics, tasks, and subtasks").option("--type <types>", "Filter by type: epic,task,subtask (comma-separated)").option("--status <statuses>", "Filter by status (comma-separated)").option("--priority <levels>", "Filter by priority: 0-5 (comma-separated)").option("--since <date>", "Created after date (YYYY-MM-DD)").option("--until <date>", "Created before date (YYYY-MM-DD)").option("--sort <fields>", "Sort by fields (field:direction, comma-separated)", "created:desc").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((options) => {
   try {
-    const limit = parseInt(options.limit, 10);
-    const page = parseInt(options.page, 10);
-    validatePagination(limit, page);
-    const types = options.type ? options.type.split(",").map((t) => t.trim()) : undefined;
-    if (types)
-      validateListEntityTypes(types);
-    const statuses = options.status ? options.status.split(",").map((s) => s.trim()) : undefined;
-    const priorities = options.priority ? options.priority.split(",").map((p) => parseInt(p.trim(), 10)) : undefined;
-    if (priorities)
+    const { limit, page } = parsePaginationOptions(options);
+    const rawTypes = parseCommaSeparated(options.type);
+    let types;
+    if (rawTypes) {
+      validateListEntityTypes(rawTypes);
+      types = rawTypes;
+    }
+    const statuses = parseCommaSeparated(options.status);
+    let priorities;
+    if (options.priority) {
+      priorities = options.priority.split(",").map((p) => Number.parseInt(p.trim(), RADIX_DECIMAL));
+    }
+    if (priorities) {
       validatePriorities(priorities);
+    }
     let sort;
     try {
       sort = parseSort(options.sort);
     } catch (err) {
-      throw new Error(`Invalid sort: ${err instanceof Error ? err.message : String(err)}`);
+      if (err instanceof Error) {
+        throw new Error(`Invalid sort: ${err.message}`);
+      }
+      throw new Error(`Invalid sort: ${String(err)}`);
     }
     const since = parseDate2(options.since);
     if (options.since && !since) {
@@ -3331,16 +3504,24 @@ var listCommand = new Command12("list").description("List all epics, tasks, and
   }
 });
 function parseDate2(dateStr) {
-  if (!dateStr)
+  if (!dateStr) {
     return;
+  }
   const parsed = import_dayjs2.default(dateStr, "YYYY-MM-DD", true);
-  return parsed.isValid() ? parsed.toDate() : undefined;
+  if (parsed.isValid()) {
+    return parsed.toDate();
+  }
+  return;
 }
 function parseUntilDate(dateStr) {
-  if (!dateStr)
+  if (!dateStr) {
     return;
+  }
   const parsed = import_dayjs2.default(dateStr, "YYYY-MM-DD", true);
-  return parsed.isValid() ? parsed.endOf("day").toDate() : undefined;
+  if (parsed.isValid()) {
+    return parsed.endOf("day").toDate();
+  }
+  return;
 }
 function formatListResults(result) {
   const lines = [];
@@ -3363,16 +3544,117 @@ function formatListResults(result) {
 `);
 }
 function formatItem(item) {
-  const typeLabel = item.type.toUpperCase().padEnd(7);
-  const statusLabel = item.status.padEnd(11);
+  const typeLabel = item.type.toUpperCase().padEnd(TYPE_PAD_WIDTH);
+  const statusLabel = item.status.padEnd(STATUS_PAD_WIDTH);
   const priorityLabel = `P${item.priority}`;
-  const parentLabel = item.parentId ? ` (${item.parentId})` : "";
+  let parentLabel = "";
+  if (item.parentId) {
+    parentLabel = ` (${item.parentId})`;
+  }
   return `${typeLabel} ${item.id} | ${statusLabel} | ${priorityLabel} | ${item.title}${parentLabel}`;
 }
+
+// src/commands/ready.ts
+import { Command as Command13 } from "commander";
+
+// src/services/ready.ts
+function getReadyTasks(options) {
+  const sqlite = requireSqliteInstance();
+  const limit = options?.limit ?? PAGINATION_DEFAULTS.LIST_PAGE_SIZE;
+  const page = options?.page ?? PAGINATION_DEFAULTS.DEFAULT_PAGE;
+  const offset = (page - 1) * limit;
+  const baseWhere = `
+    WHERE t.status = 'todo'
+      AND t.parent_task_id IS NULL
+      AND NOT EXISTS (
+        SELECT 1 FROM dependencies d
+        JOIN tasks dt ON dt.id = d.depends_on_id
+        WHERE d.task_id = t.id
+          AND dt.status NOT IN ('completed', 'wont_fix', 'archived')
+      )
+  `;
+  const countResult = sqlite.query(`SELECT COUNT(*) as total FROM tasks t ${baseWhere}`).get();
+  const total = countResult?.total ?? 0;
+  const readyRows = sqlite.query(`
+      SELECT t.id, t.title, t.description, t.priority, t.status,
+             t.epic_id, t.tags, t.created_at, t.updated_at
+      FROM tasks t
+      ${baseWhere}
+      ORDER BY t.priority ASC, t.created_at ASC
+      LIMIT ? OFFSET ?
+    `).all(limit, offset);
+  const dependentsQuery = sqlite.query(`
+    SELECT t.id, t.title, t.status, t.priority
+    FROM dependencies d
+    JOIN tasks t ON t.id = d.task_id
+    WHERE d.depends_on_id = ?
+    ORDER BY t.priority ASC
+  `);
+  const items = readyRows.map((row) => ({
+    id: row.id,
+    title: row.title,
+    description: row.description,
+    priority: row.priority,
+    status: row.status,
+    epicId: row.epic_id,
+    tags: row.tags,
+    createdAt: new Date(row.created_at * MS_PER_SECOND),
+    updatedAt: new Date(row.updated_at * MS_PER_SECOND),
+    dependents: dependentsQuery.all(row.id).map((d) => ({
+      id: d.id,
+      title: d.title,
+      status: d.status,
+      priority: d.priority
+    }))
+  }));
+  return { total, page, limit, items };
+}
+
+// src/commands/ready.ts
+var readyCommand = new Command13("ready").description("Show tasks that are ready to work on (unblocked, todo)").option("--limit <n>", "Results per page (default: 50)", "50").option("--page <n>", "Page number (default: 1)", "1").action((options) => {
+  try {
+    const { limit, page } = parsePaginationOptions(options);
+    const result = getReadyTasks({ limit, page });
+    outputResult(result, formatReadyTasks);
+  } catch (err) {
+    handleCommandError(err);
+  }
+});
+function formatReadyTasks(result) {
+  if (result.items.length === 0) {
+    return "No ready tasks found.";
+  }
+  const lines = [];
+  lines.push(`${result.total} ready task(s) (page ${result.page}, ${result.limit} per page)
+`);
+  for (const task of result.items) {
+    let epic = "";
+    if (task.epicId) {
+      epic = ` (${task.epicId})`;
+    }
+    let tags = "";
+    if (task.tags) {
+      tags = ` [${task.tags}]`;
+    }
+    lines.push(`${task.id} | P${task.priority} | ${task.title}${epic}${tags}`);
+    if (task.dependents.length > 0) {
+      for (const dep of task.dependents) {
+        lines.push(`  -> unblocks ${dep.id} | ${dep.status.padEnd(STATUS_PAD_WIDTH)} | P${dep.priority} | ${dep.title}`);
+      }
+    }
+  }
+  const totalPages = Math.ceil(result.total / result.limit);
+  if (totalPages > 1) {
+    lines.push(`
+Page ${result.page} of ${totalPages}`);
+  }
+  return lines.join(`
+`);
+}
 // package.json
 var package_default = {
   name: "@obsfx/trekker",
-  version: "1.7.2",
+  version: "1.10.0",
   description: "A CLI-based issue tracker built for AI coding agents. Stores tasks, epics, and dependencies in a local SQLite database.",
   type: "module",
   main: "dist/index.js",
@@ -3388,6 +3670,11 @@ var package_default = {
     dev: "bun run src/index.ts",
     test: "bun test",
     "test:watch": "bun test --watch",
+    lint: "eslint . --cache",
+    "lint:fix": "eslint . --fix --cache",
+    format: 'prettier --write "src/**/*.ts" "tests/**/*.ts"',
+    "format:check": 'prettier --check "src/**/*.ts" "tests/**/*.ts"',
+    check: "bun run lint && bun run format:check",
     "db:generate": "drizzle-kit generate",
     "db:migrate": "drizzle-kit migrate",
     "release:patch": "npm version patch && npm run build && npm publish --access public",
@@ -3429,12 +3716,18 @@ var package_default = {
   devDependencies: {
     "@types/bun": "^1.2.2",
     "drizzle-kit": "^0.30.4",
-    typescript: "^5.7.3"
+    eslint: "^10.0.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-unicorn": "^63.0.0",
+    knip: "^5.85.0",
+    prettier: "^3.8.1",
+    typescript: "^5.7.3",
+    "typescript-eslint": "^8.56.1"
   }
 };
 
 // src/index.ts
-var program = new Command13;
+var program = new Command14;
 program.name("trekker").description("CLI-based issue tracker for coding agents").version(package_default.version).option("--toon", "Output in TOON format").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.toon) {
@@ -3453,4 +3746,5 @@ program.addCommand(seedCommand);
 program.addCommand(searchCommand);
 program.addCommand(historyCommand);
 program.addCommand(listCommand);
+program.addCommand(readyCommand);
 program.parse();