taskchef 4.0.0 → 4.1.0

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Dispatch work from a data-only workspace to visible Codex project tasks.",
   "author": {
     "name": "Favo Yang",

package/README.md

@@ -253,6 +253,17 @@ taskchef project list --workspace <workspace>
 taskchef project remove payments --workspace <workspace>
 ```
 
+Human-readable project listings use one row per GitHub repository. Project
+details repeat on each row so multi-repository projects remain clear, while a
+project without a configured repository has one row containing `-`:
+
+```text
+NAME      KIND    GITHUB REPOSITORY                               PATH
+payments  git     https://github.com/example/payments-api         /workspace/payments
+payments  git     https://github.com/example/payments-sdk         /workspace/payments
+notes     folder  -                                                /workspace/notes
+```
+
 Import projects as a JSON array from a file or standard input:
 
 ```sh
@@ -296,9 +307,20 @@ Inspect the task history without querying Codex tasks:
 taskchef task show t1 --workspace <workspace>
 taskchef task list --workspace <workspace>
 taskchef task list --project payments --workspace <workspace>
+taskchef task list --ascending --workspace <workspace>
 taskchef task summary --workspace <workspace>
 ```
 
+Human-readable task listings put the scannable fields first and the durable ID
+last. Values are kept in full and aligned in columns. Tasks are newest-first by
+default; pass `--ascending` to list them from oldest to newest. The same order
+applies to the `tasks` array in `--json` output.
+
+```text
+TITLE           PROJECT   CREATED                   ID
+Add retry logs  payments  2026-08-12T10:00:00.000Z  c0f010ff-84f2-4838-a69d-0ff1f5d721d7
+```
+
 The complete data contract is in [SPEC.md](SPEC.md). Deferred ideas are in
 [BACKLOG.md](BACKLOG.md).
 

package/SPEC.md

@@ -201,8 +201,9 @@ it was not recorded.
 The CLI reads persisted history without contacting Codex:
 
 - `task show <id>` returns one entry.
-- `task list` returns entries in append order, optionally filtered by
-  historical project name or exact path.
+- `task list` returns entries newest-first by creation time, optionally filtered
+  by historical project name or exact path. `--ascending` returns oldest-first.
+  The selected order applies to both human rows and the JSON `tasks` array.
 - `task summary` returns the total and per-project counts.
 - `task resolve <id> --thread-id <thread-id>` atomically fills one nullable
   thread ID after Codex verifies the exact structured marker match.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taskchef",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "A non-blocking interactive dispatcher for visible Codex tasks.",
   "license": "MIT",
   "author": "Favo Yang",

package/src/cli.js

@@ -88,12 +88,44 @@ function print(value, args, human) {
 }
 
 function table(headers, rows) {
+  const display = (value) => value === null || value === undefined || value === ""
+    ? "-"
+    : String(value);
   const widths = headers.map((header, index) =>
-    Math.max(header.length, ...rows.map((row) => String(row[index]).length)));
-  const format = (row) => row.map((value, index) => String(value).padEnd(widths[index])).join("  ");
+    Math.max(header.length, ...rows.map((row) => display(row[index]).length)));
+  const format = (row) => row.map((value, index) => index === row.length - 1
+    ? display(value)
+    : display(value).padEnd(widths[index])).join("  ");
   return [format(headers), ...rows.map(format)].join("\n");
 }
 
+function projectRows(projects) {
+  return projects.flatMap((project) => {
+    const repositories = project.githubRepos.length > 0 ? project.githubRepos : [null];
+    return repositories.map((repository) => [
+      project.name,
+      project.isGitRepository ? "git" : "folder",
+      repository,
+      project.path,
+    ]);
+  });
+}
+
+function sortTasksByCreatedAt(tasks, ascending) {
+  return tasks
+    .map((task, index) => ({ task, index }))
+    .sort((left, right) => {
+      const leftCreatedAt = left.task.createdAt;
+      const rightCreatedAt = right.task.createdAt;
+      if (!leftCreatedAt && !rightCreatedAt) return left.index - right.index;
+      if (!leftCreatedAt) return 1;
+      if (!rightCreatedAt) return -1;
+      const chronological = Date.parse(leftCreatedAt) - Date.parse(rightCreatedAt);
+      return (ascending ? chronological : -chronological) || left.index - right.index;
+    })
+    .map(({ task }) => task);
+}
+
 async function initialize(args) {
   validateCommandArgs(args, 2, { values: ["--workspace"], switches: ["--json"] });
   const result = await initializeWorkspace(workspaceRoot(args));
@@ -161,13 +193,8 @@ async function projectList(args) {
   validateCommandArgs(args, 2, { values: ["--workspace"], switches: ["--json"] });
   const projects = await listProjects(workspaceRoot(args));
   print({ projectCount: projects.length, projects }, args, (value) => table(
-    ["NAME", "KIND", "GITHUB REPOSITORIES", "PATH"],
-    value.projects.map((project) => [
-      project.name,
-      project.isGitRepository ? "git" : "folder",
-      project.githubRepos.join(", ") || "-",
-      project.path,
-    ]),
+    ["NAME", "KIND", "GITHUB REPOSITORY", "PATH"],
+    projectRows(value.projects),
   ));
   return 0;
 }
@@ -215,19 +242,20 @@ async function taskShow(args) {
 async function taskList(args) {
   validateCommandArgs(args, 2, {
     values: ["--workspace", "--project"],
-    switches: ["--json"],
+    switches: ["--ascending", "--json"],
   });
-  const dispatches = await filterTasks(workspaceRoot(args), {
+  const filtered = await filterTasks(workspaceRoot(args), {
     project: option(args, "--project", null),
   });
+  const dispatches = sortTasksByCreatedAt(filtered, args.includes("--ascending"));
   const result = { taskCount: dispatches.length, tasks: dispatches };
   print(result, args, (value) => table(
-    ["ID", "CREATED", "PROJECT", "TITLE"],
+    ["TITLE", "PROJECT", "CREATED", "ID"],
     value.tasks.map((dispatch) => [
-      dispatch.id,
-      dispatch.createdAt,
-      dispatch.project.name,
       dispatch.title,
+      dispatch.project?.name,
+      dispatch.createdAt,
+      dispatch.id,
     ]),
   ));
   return 0;
@@ -257,7 +285,7 @@ Usage:
   taskchef task record [--json] [--workspace <path>]
   taskchef task resolve <task-id> --thread-id <thread-id> [--json] [--workspace <path>]
   taskchef task show <task-id> [--json] [--workspace <path>]
-  taskchef task list [--project <name-or-path>] [--json] [--workspace <path>]
+  taskchef task list [--project <name-or-path>] [--ascending] [--json] [--workspace <path>]
   taskchef task summary [--json] [--workspace <path>]
 
 Task record reads JSON from standard input. Project import reads a JSON