taskchef 5.5.2 → 5.7.0

package/.codex-plugin/plugin.json

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

package/README.md

@@ -237,15 +237,16 @@ taskchef project remove <name>
 taskchef dispatch prepare
 taskchef task record
 taskchef task resolve <task-id> --thread-id <thread-id>
-taskchef task show <task-id>
+taskchef task show <task-id-or-8-character-prefix>
 taskchef task list
 taskchef task summary
 ```
 
 Workspace resolution is deterministic: `--workspace <path>`, then the
 `TASKCHEF_WORKSPACE` environment variable, then `~/.agents/taskchef`. The
-current directory is never an implicit workspace. Data commands accept
-`--json` for machine-readable output. Run `taskchef help` for every option.
+current directory is never an implicit workspace. Data commands use concise
+human-readable output by default and accept `--json` for machine-readable
+output. Run `taskchef help` for every option.
 
 `taskchef dispatch prepare --json` is the CLI equivalent of the MCP
 `prepare_dispatch` operation: it resolves the canonical workspace, loads and
@@ -370,7 +371,8 @@ taskchef task resolve c0f010ff-84f2-4838-a69d-0ff1f5d721d7 \
 Inspect the task history without querying Codex tasks:
 
 ```sh
-taskchef task show t1
+taskchef task show c0f010ff
+taskchef task show c0f010ff --json
 taskchef task list
 taskchef task list --project payments
 taskchef task list --ascending
@@ -386,6 +388,29 @@ with other empty table cells. Tasks are newest-first by default; pass
 the complete values in `--json` output, and the selected order applies to its
 `tasks` array.
 
+`task show` accepts either the full task ID or the exact eight-character task
+ID printed by the default human-readable list. A short ID must identify exactly
+one recorded task; use `task list --full-id` when a short ID is missing or
+ambiguous. Its default output labels the title, project name and path, creation
+time, full task and thread IDs, and instruction. A null thread ID appears as
+`-`, and multiline instructions retain their original line breaks and
+indentation. Pass `--json` to receive the unchanged complete task object.
+
+```text
+Title: Add retry logs
+Project: payments
+Project path: /workspace/payments
+Created: 2026-08-12T10:00:00.000Z
+Task ID: c0f010ff-84f2-4838-a69d-0ff1f5d721d7
+Thread ID: 019f9d46-f42c-7482-9707-3c107bf241ee
+Instruction:
+<!-- taskchef_id=c0f010ff-84f2-4838-a69d-0ff1f5d721d7 -->
+
+Add structured logs for failed payment retries and test them.
+```
+
+The list remains a compact table:
+
 ```text
 TITLE           PROJECT   CREATED                   ID        THREAD ID
 Add retry logs  payments  2026-08-12T10:00:00.000Z  c0f010ff  019f9d46

package/SPEC.md

@@ -296,7 +296,15 @@ it was not recorded.
 
 The CLI reads persisted history without contacting Codex:
 
-- `task show <id>` returns one entry.
+- `task show <id-or-8-character-prefix>` returns one entry. By default it emits
+  labeled human-readable lines for title, project name and path, creation time,
+  full task ID, thread ID, and instruction. A null thread ID renders as `-`.
+  The instruction starts on the line after `Instruction:` and retains its
+  stored line breaks and indentation. `--json` returns the unchanged complete
+  task object. The short form is the exact ID text printed by the default
+  human-readable `task list` output and succeeds only when it identifies
+  exactly one recorded task. Missing, ambiguous, malformed, shorter, and
+  wrong-case prefixes fail without selecting a task.
 - `task list` returns entries newest-first by creation time, optionally filtered
   by historical project name or exact path. `--ascending` returns oldest-first.
   Human rows include task and thread ID columns, abbreviating UUID-shaped IDs

package/package.json

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

package/src/cli.js

@@ -12,10 +12,11 @@ import {
   importProjects,
   initializeWorkspace,
   listProjects,
+  listTasks,
   prepareDispatch,
-  readTask,
   recordTask,
   removeProject,
+  requireSafeId,
   resolveTask,
 } from "./workspace.js";
 
@@ -160,6 +161,52 @@ function displayId(value, fullId) {
   return uuidSection ? uuidSection[0] : value;
 }
 
+function taskDetails(task) {
+  return [
+    `Title: ${task.title}`,
+    `Project: ${task.project.name}`,
+    `Project path: ${task.project.path}`,
+    `Created: ${task.createdAt}`,
+    `Task ID: ${task.id}`,
+    `Thread ID: ${task.threadId ?? "-"}`,
+    "Instruction:",
+    task.instruction,
+  ].join("\n");
+}
+
+async function readTaskForShow(workspace, taskId) {
+  const id = requireSafeId(taskId, "taskId");
+  const tasks = await listTasks(workspace);
+  if (!/^[0-9a-fA-F]{8}$/.test(id)) {
+    const exact = tasks.find((task) => task.id === id);
+    if (exact) return exact;
+    if (id.length < 8) {
+      throw new Error(
+        `task ID prefix is too short: ${id}; use all 8 characters shown by taskchef task list`,
+      );
+    }
+    if (id.length === 8) {
+      throw new Error(
+        `malformed task ID prefix: ${id}; use the 8 hexadecimal characters shown by taskchef task list`,
+      );
+    }
+    throw new Error(`task not found: ${id}`);
+  }
+
+  const matches = tasks.filter((task) => displayId(task.id, false) === id);
+  if (matches.length === 0) {
+    throw new Error(
+      `task not found for ID prefix: ${id}; run taskchef task list --full-id to verify the task ID`,
+    );
+  }
+  if (matches.length > 1) {
+    throw new Error(
+      `task ID prefix is ambiguous: ${id}; run taskchef task list --full-id and pass the full task ID`,
+    );
+  }
+  return matches[0];
+}
+
 async function initialize(args) {
   validateCommandArgs(args, 2, {
     values: ["--workspace", "--codex-cli"],
@@ -314,7 +361,7 @@ async function taskResolve(args) {
 
 async function taskShow(args) {
   validateCommandArgs(args, 3, { values: ["--workspace"], switches: ["--json"] });
-  print(await readTask(workspaceRoot(args), args[2]), args);
+  print(await readTaskForShow(workspaceRoot(args), args[2]), args, taskDetails);
   return 0;
 }
 
@@ -367,11 +414,13 @@ Usage:
   taskchef dispatch prepare [--json] [--workspace <path>]
   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 show <task-id-or-8-character-prefix> [--json] [--workspace <path>]
   taskchef task list [--project <name-or-path>] [--ascending] [--full-id] [--json] [--workspace <path>]
   taskchef task summary [--json] [--workspace <path>]
 
 Task record reads one JSON value from closed, non-interactive standard input.
+Task show accepts a full task ID or the exact 8-character ID printed by task list.
+Task show prints human-readable details by default; --json prints the complete task object.
 Project import reads a JSON
 array from a file, or from standard input when the source is '-' or omitted.
 Workspace resolution precedence is --workspace, TASKCHEF_WORKSPACE, then