taskchef 1.0.2 → 3.0.0

package/skills/taskchef-report/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: taskchef-report
+description: "Report the live state of Codex tasks recorded in a TaskChef task history. Use only when the user asks for status, outcomes, or a report about delegated work. Queries each relevant task once, never polls or waits, and never persists status or results."
+---
+
+# TaskChef Report
+
+Read the TaskChef task history and report the current state of its Codex
+tasks once.
+
+Resolve this skill directory with `realpath`. The TaskChef plugin root is two
+parents above the skill directory. Invoke `<plugin-root>/bin/taskchef.js` for
+all deterministic task-log operations.
+
+## Report
+
+1. Select only the tasks the user asked about:
+   - For an exact task ID, run
+     `<plugin-root>/bin/taskchef.js task show <task-id> --json --workspace <workspace>`.
+   - For a project, run
+     `<plugin-root>/bin/taskchef.js task list --project <name-or-path> --json --workspace <workspace>`.
+   - For a title or other description, run
+     `<plugin-root>/bin/taskchef.js task list --json --workspace <workspace>`
+     once, then select matching entries. Ask the user if the match is ambiguous.
+   - Use the full list only when the user asks for an overview of the task history.
+2. Query every selected thread exactly once using immediate native snapshots,
+   with no more than eight targets per call.
+3. Summarize the live state and any reported outcome for each requested task.
+   Distinguish active work, requests for user input, completed work, and failed
+   or partial attempts.
+4. Treat each Codex task as the source of truth. The task log proves that
+   TaskChef created the task, but it does not contain the task's current state.
+5. Never update `tasks.jsonl`. Never persist status, results, transcripts,
+   or hidden reasoning. Do not poll or wait for future activity.
+
+If the task history is empty, say that TaskChef has not recorded any tasks. If
+a recorded task cannot be read, identify it by task ID and thread ID, then
+continue with the remaining entries.

package/skills/taskchef-report/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "TaskChef Report"
+  short_description: "Report on dispatched Codex tasks"
+  default_prompt: "Use $taskchef-report to query the live state of work in the TaskChef task history once."

package/src/cli.js

@@ -3,17 +3,15 @@ import path from "node:path";
 
 import {
   addProject,
-  buildReconciliationCandidates,
   buildTaskSummary,
-  createTask,
   doctorWorkspace,
   filterTasks,
   importProjects,
   initializeWorkspace,
   listProjects,
   readTask,
+  recordTask,
   removeProject,
-  updateTask,
 } from "./workspace.js";
 
 async function readStdin() {
@@ -38,19 +36,6 @@ function option(args, name, fallback) {
   return args[index + 1];
 }
 
-function options(args, name) {
-  const values = [];
-  for (let index = 0; index < args.length; index += 1) {
-    if (args[index] !== name) continue;
-    if (!args[index + 1] || args[index + 1].startsWith("--")) {
-      throw new Error(`${name} requires a value`);
-    }
-    values.push(args[index + 1]);
-    index += 1;
-  }
-  return values;
-}
-
 function validateCommandArgs(
   args,
   startIndex,
@@ -106,8 +91,10 @@ async function initialize(args) {
   print(result, args, (value) => [
     `Workspace: ${value.workspace}`,
     `Configuration: ${value.config.action}`,
+    `Task log: ${value.tasks.action}`,
+    `Legacy tasks: ${value.legacyTasks.action}`,
     `Instructions: ${value.instructions.action}`,
-    `Skills: ${value.skills.skills.map((skill) => `${skill.name}=${skill.action}`).join(", ")}`,
+    `Legacy skill links removed: ${value.legacySkills.removed.length}`,
   ].join("\n"));
   return 0;
 }
@@ -179,30 +166,21 @@ async function projectRemove(args) {
   if (!args[2] || args[2].startsWith("--")) throw new Error("project remove requires a name");
   validateCommandArgs(args, 3, {
     values: ["--workspace"],
-    switches: ["--json", "--force"],
-  });
-  const result = await removeProject(workspaceRoot(args), args[2], {
-    force: args.includes("--force"),
+    switches: ["--json"],
   });
+  const result = await removeProject(workspaceRoot(args), args[2]);
   print(result, args, (value) => `Removed ${value.project.name}: ${value.project.path}`);
   return 0;
 }
 
-async function create(args) {
+async function taskRecord(args) {
   validateCommandArgs(args, 2, { values: ["--workspace"], switches: ["--json"] });
-  const task = await createTask(workspaceRoot(args), await readJsonStdin());
-  print(task, args, (value) => `Created ${value.id}: ${value.title} (${value.status})`);
-  return 0;
-}
-
-async function update(args) {
-  validateCommandArgs(args, 3, { values: ["--workspace"], switches: ["--json"] });
-  const task = await updateTask(workspaceRoot(args), args[2], await readJsonStdin());
-  print(task, args, (value) => `Updated ${value.id}: ${value.status}`);
+  const dispatch = await recordTask(workspaceRoot(args), await readJsonStdin());
+  print(dispatch, args, (value) => `Recorded ${value.id}: ${value.title}`);
   return 0;
 }
 
-async function show(args) {
+async function taskShow(args) {
   validateCommandArgs(args, 3, { values: ["--workspace"], switches: ["--json"] });
   print(await readTask(workspaceRoot(args), args[2]), args);
   return 0;
@@ -210,24 +188,20 @@ async function show(args) {
 
 async function taskList(args) {
   validateCommandArgs(args, 2, {
-    values: ["--workspace", "--status", "--project"],
+    values: ["--workspace", "--project"],
     switches: ["--json"],
-    repeatable: ["--status"],
   });
-  const tasks = await filterTasks(workspaceRoot(args), {
-    statuses: options(args, "--status"),
+  const dispatches = await filterTasks(workspaceRoot(args), {
     project: option(args, "--project", null),
   });
-  const projects = await listProjects(workspaceRoot(args));
-  const projectNames = new Map(projects.map((project) => [project.path, project.name]));
-  const result = { taskCount: tasks.length, tasks };
+  const result = { taskCount: dispatches.length, tasks: dispatches };
   print(result, args, (value) => table(
-    ["ID", "STATUS", "PROJECT", "TITLE"],
-    value.tasks.map((task) => [
-      task.id,
-      task.status,
-      projectNames.get(task.project) ?? path.basename(task.project),
-      task.title,
+    ["ID", "CREATED", "PROJECT", "TITLE"],
+    value.tasks.map((dispatch) => [
+      dispatch.id,
+      dispatch.createdAt,
+      dispatch.project.name,
+      dispatch.title,
     ]),
   ));
   return 0;
@@ -238,23 +212,11 @@ async function taskSummary(args) {
   const summary = await buildTaskSummary(workspaceRoot(args));
   print(summary, args, (value) => [
     `Tasks: ${value.taskCount}`,
-    ...Object.entries(value.statusCounts).map(([status, count]) => `${status}: ${count}`),
+    ...Object.entries(value.projectCounts).map(([project, count]) => `${project}: ${count}`),
   ].join("\n"));
   return 0;
 }
 
-async function reconciliationCandidates(args) {
-  validateCommandArgs(args, 2, {
-    values: ["--workspace"],
-    switches: ["--json", "--include-finished"],
-  });
-  const result = await buildReconciliationCandidates(workspaceRoot(args), {
-    includeFinished: args.includes("--include-finished"),
-  });
-  print(result, args);
-  return 0;
-}
-
 function usage() {
   process.stdout.write(`TaskChef workspace utility
 
@@ -265,16 +227,14 @@ Usage:
   taskchef project add <path> [--name <name>] [--description <text>] [--github-repo <url> | --no-github] [--json] [--workspace <path>]
   taskchef project import [<file> | -] [--replace] [--json] [--workspace <path>]
   taskchef project list [--json] [--workspace <path>]
-  taskchef project remove <name> [--force] [--json] [--workspace <path>]
-  taskchef task create [--json] [--workspace <path>]
-  taskchef task update <task-id> [--json] [--workspace <path>]
+  taskchef project remove <name> [--json] [--workspace <path>]
+  taskchef task record [--json] [--workspace <path>]
   taskchef task show <task-id> [--json] [--workspace <path>]
-  taskchef task list [--status <status>]... [--project <name-or-path>] [--json] [--workspace <path>]
+  taskchef task list [--project <name-or-path>] [--json] [--workspace <path>]
   taskchef task summary [--json] [--workspace <path>]
-  taskchef task reconcile-candidates [--include-finished] [--json] [--workspace <path>]
 
-Task create and update read JSON from standard input. Project import reads a
-JSON array from a file, or from standard input when the source is '-' or omitted.
+Task record reads JSON from standard input. Project import reads a JSON
+array from a file, or from standard input when the source is '-' or omitted.
 `);
 }
 
@@ -289,14 +249,10 @@ export async function runCli(args) {
   if (args[0] === "project" && args[1] === "import") return projectImport(args);
   if (args[0] === "project" && args[1] === "list") return projectList(args);
   if (args[0] === "project" && args[1] === "remove") return projectRemove(args);
-  if (args[0] === "task" && args[1] === "create") return create(args);
-  if (args[0] === "task" && args[1] === "update" && args[2]) return update(args);
-  if (args[0] === "task" && args[1] === "show" && args[2]) return show(args);
+  if (args[0] === "task" && args[1] === "record") return taskRecord(args);
+  if (args[0] === "task" && args[1] === "show" && args[2]) return taskShow(args);
   if (args[0] === "task" && args[1] === "list") return taskList(args);
   if (args[0] === "task" && args[1] === "summary") return taskSummary(args);
-  if (args[0] === "task" && args[1] === "reconcile-candidates") {
-    return reconciliationCandidates(args);
-  }
   process.stderr.write(`Unknown command: ${args.join(" ")}\n`);
   usage();
   return 2;