@obsfx/trekker 1.7.2 → 1.8.0

package/README.md

@@ -41,6 +41,7 @@ My concerns about the future and security of that project led me here. Trekker i
 
 What you get:
 - Task and epic tracking with dependencies
+- Ready command to find unblocked tasks and see what they unblock
 - Full-text search across tasks, epics, subtasks, and comments
 - Unified list view with filtering by type, status, priority, and custom sorting
 - Optional kanban board UI available as a [separate package](https://github.com/obsfx/trekker-dashboard)
@@ -78,6 +79,12 @@ trekker dep add TREK-2 TREK-1
 trekker dep add TREK-3 TREK-1
 ```
 
+See what is ready to work on:
+
+```bash
+trekker ready
+```
+
 Update task status as you work:
 
 ```bash
@@ -142,6 +149,29 @@ trekker dep remove <task-id> <depends-on-id>
 trekker dep list <task-id>
 ```
 
+### Ready
+
+Show tasks that are ready to work on — unblocked and in `todo` status. For each ready task, shows downstream dependents that will be unblocked once it is completed:
+
+```bash
+trekker ready
+```
+
+Example output:
+```
+2 ready task(s):
+
+TREK-1 | P0 | Setup database
+  -> unblocks TREK-2 | todo        | P1 | Build API layer
+  -> unblocks TREK-3 | todo        | P1 | Build UI layer
+TREK-4 | P2 | Write docs
+```
+
+Tasks are sorted by priority (critical first). A task is considered ready when:
+- Status is `todo`
+- It is a top-level task (not a subtask)
+- All its dependencies are resolved (`completed`, `wont_fix`, or `archived`)
+
 ### Search
 
 Full-text search across epics, tasks, subtasks, and comments using FTS5:

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";
@@ -3369,10 +3369,86 @@ function formatItem(item) {
   const parentLabel = item.parentId ? ` (${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() {
+  const sqlite = requireSqliteInstance();
+  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
+      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')
+        )
+      ORDER BY t.priority ASC, t.created_at ASC
+    `).all();
+  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
+  `);
+  return 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 * 1000),
+    updatedAt: new Date(row.updated_at * 1000),
+    dependents: dependentsQuery.all(row.id).map((d) => ({
+      id: d.id,
+      title: d.title,
+      status: d.status,
+      priority: d.priority
+    }))
+  }));
+}
+
+// src/commands/ready.ts
+var readyCommand = new Command13("ready").description("Show tasks that are ready to work on (unblocked, todo)").action(() => {
+  try {
+    const readyTasks = getReadyTasks();
+    outputResult(readyTasks, formatReadyTasks);
+  } catch (err) {
+    handleCommandError(err);
+  }
+});
+function formatReadyTasks(tasks2) {
+  if (tasks2.length === 0) {
+    return "No ready tasks found.";
+  }
+  const lines = [];
+  lines.push(`${tasks2.length} ready task(s):
+`);
+  for (const task of tasks2) {
+    const epic = task.epicId ? ` (${task.epicId})` : "";
+    const tags = task.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(11)} | P${dep.priority} | ${dep.title}`);
+      }
+    }
+  }
+  return lines.join(`
+`);
+}
 // package.json
 var package_default = {
   name: "@obsfx/trekker",
-  version: "1.7.2",
+  version: "1.8.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",
@@ -3434,7 +3510,7 @@ var package_default = {
 };
 
 // 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 +3529,5 @@ program.addCommand(seedCommand);
 program.addCommand(searchCommand);
 program.addCommand(historyCommand);
 program.addCommand(listCommand);
+program.addCommand(readyCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@obsfx/trekker",
-  "version": "1.7.2",
+  "version": "1.8.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",