taskchef 7.19.1 → 7.21.0

package/src/dashboard/styles.css

@@ -11,6 +11,10 @@
   --danger: #8b3a35;
   --warning: #8a5c17;
   --shadow: 0 12px 30px rgb(24 33 29 / 10%);
+  --control-height: 38px;
+  --control-padding-inline: 11px;
+  --control-radius: 7px;
+  --control-font-size: 0.86rem;
   font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
 }
 
@@ -112,7 +116,7 @@ time, .timestamp-missing { font-size: 0.75rem; }
 .timestamp-toggle:hover time { color: var(--text); text-decoration: underline; text-underline-offset: 3px; }
 .task-footer { display: flex; align-items: center; justify-content: space-between; gap: 14px; }
 .task-open { flex: none; }
-.primary-button.task-action, .secondary-button.task-action { display: inline-flex; align-items: center; justify-content: center; gap: 6px; min-height: 34px; padding: 5px 9px; font-size: 0.78rem; line-height: 1.2; white-space: nowrap; }
+.primary-button.task-action, .secondary-button.task-action { display: inline-flex; align-items: center; justify-content: center; gap: 6px; min-height: var(--control-height); padding: 0 var(--control-padding-inline); font-size: var(--control-font-size); line-height: 1; white-space: nowrap; }
 .codex-icon { display: block; flex: none; width: 18px; height: 18px; }
 .codex-icon img { display: block; width: 100%; height: 100%; object-fit: contain; }
 
@@ -148,8 +152,15 @@ dialog { width: min(760px, calc(100vw - 32px)); max-height: min(82vh, 900px); pa
 dialog::backdrop { background: rgb(18 23 21 / 50%); backdrop-filter: blur(2px); }
 .dialog-header { display: flex; align-items: flex-start; justify-content: space-between; gap: 20px; }
 .dialog-header h2 { margin-bottom: 12px; font-size: 1.6rem; }
-.dialog-actions { display: flex; gap: 8px; margin-bottom: 26px; }
-.primary-button, .secondary-button, .danger-button { padding: 8px 12px; border-radius: 7px; font-weight: 700; cursor: pointer; }
+.dialog-actions { display: flex; align-items: flex-start; flex-wrap: wrap; gap: 8px; margin-bottom: 26px; }
+.more-task-actions { width: var(--control-height); min-width: var(--control-height); padding-inline: 0; font-size: 1.2rem; line-height: 1; }
+.manual-transition-panel, .manual-transition-controls { display: contents; }
+.manual-transition-panel[hidden] { display: none; }
+.manual-transition-error, .manual-transition-pending { flex-basis: 100%; margin: 0; }
+.manual-transition-controls > button[hidden] { display: none; }
+.manual-transition-error { color: var(--danger); font-size: 0.86rem; }
+.manual-transition-pending { color: var(--muted); font-size: 0.86rem; }
+.primary-button, .secondary-button, .danger-button { display: inline-flex; align-items: center; justify-content: center; min-height: var(--control-height); padding: 0 var(--control-padding-inline); border-radius: var(--control-radius); font-size: var(--control-font-size); font-weight: 700; line-height: 1; cursor: pointer; }
 .primary-button { border: 1px solid var(--accent); background: var(--accent); color: white; }
 .secondary-button { border: 1px solid var(--border); background: var(--surface); }
 .danger-button { border: 1px solid var(--danger); background: var(--surface); color: var(--danger); }
@@ -160,11 +171,20 @@ dialog section + section { margin-top: 24px; }
 .result-history-item { padding: 13px 14px; border: 1px solid var(--border); border-radius: 8px; background: var(--surface-muted); }
 .result-history-latest { border-color: var(--accent); background: var(--accent-soft); box-shadow: inset 3px 0 var(--accent); }
 .result-history-header { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 9px; }
+.result-history-header .timestamp-toggle { margin-left: auto; }
+.result-history-source { color: var(--muted); font-size: 0.72rem; font-weight: 700; }
 .result-history-item p { margin-bottom: 7px; }
 .result-history-item p:last-child { margin-bottom: 0; }
 .result-history-item h4 { margin: 10px 0 3px; color: var(--muted); font-size: 0.72rem; letter-spacing: 0.04em; text-transform: uppercase; }
 .result-history-turn, .result-history-empty { color: var(--muted); font-size: 0.78rem; overflow-wrap: anywhere; }
 .result-history-empty { margin: 0; }
+.usage-panel { margin-top: 8px; }
+.usage-summary { display: grid; gap: 3px; margin: 10px 0 4px; color: var(--muted); font-size: 0.8rem; }
+.usage-summary strong { color: var(--text); font-size: 0.9rem; }
+.usage-calculating { display: flex; align-items: center; gap: 7px; }
+.usage-spinner { width: 12px; height: 12px; border: 2px solid var(--border); border-top-color: var(--accent); border-radius: 50%; animation: usage-spin 0.8s linear infinite; }
+@keyframes usage-spin { to { transform: rotate(360deg); } }
+@media (prefers-reduced-motion: reduce) { .usage-spinner { animation: none; border-top-color: var(--border); background: var(--accent); } }
 pre { max-height: 280px; margin: 0; padding: 14px; overflow: auto; border-radius: 7px; background: var(--surface-muted); white-space: pre-wrap; overflow-wrap: anywhere; font: 0.86rem/1.55 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
 .metadata { display: grid; grid-template-columns: minmax(100px, 150px) 1fr; margin: 0; font-size: 0.88rem; }
 .metadata dt, .metadata dd { padding: 7px 0; border-bottom: 1px solid var(--border); overflow-wrap: anywhere; }
@@ -175,6 +195,7 @@ pre { max-height: 280px; margin: 0; padding: 14px; overflow: auto; border-radius
 :focus-visible { outline: 3px solid rgb(33 95 74 / 35%); outline-offset: 3px; }
 
 @media (max-width: 650px) {
+  :root { --control-height: 40px; }
   .site-header { align-items: flex-start; gap: 14px; padding-top: 28px; }
   .title-row { align-items: flex-start; }
   .toolbar-primary { grid-template-columns: repeat(2, minmax(0, 1fr)); }
@@ -189,7 +210,6 @@ pre { max-height: 280px; margin: 0; padding: 14px; overflow: auto; border-radius
   .task-open { align-self: flex-start; }
   select { min-height: 40px; }
   .status-filter-option span { min-height: 38px; }
-  .primary-button.task-action, .secondary-button.task-action { min-height: 40px; }
   .dialog-actions { align-items: center; flex-flow: row wrap; }
   .metadata { grid-template-columns: 1fr; }
   .metadata dt { padding-bottom: 0; border-bottom: 0; }

package/src/dashboard.js

@@ -16,12 +16,14 @@ import {
   acquireWorkspaceLock,
   canonicalDirectory,
   canonicalGitRoot,
+  manuallyTransitionTask,
   parseTaskLogContent,
   readConfig,
   readTask,
 } from "./workspace.js";
 import { DASHBOARD_SERVER_VERSION, TASKCHEF_VERSION } from "./version.js";
 import { taskGitHubProjection } from "./dashboard/github-links.js";
+import { createUsageTracker } from "./usage-tracker.js";
 
 const TASKS_FILE_NAME = "tasks.jsonl";
 const STATIC_ROOT = fileURLToPath(new URL("./dashboard/", import.meta.url));
@@ -30,6 +32,7 @@ const LOOPBACK_HOSTS = new Set(["127.0.0.1", "::1"]);
 const DEFAULT_MAX_FILE_BYTES = 16 * 1024 * 1024;
 const DEFAULT_MAX_TASKS = 2_000;
 const DEFAULT_MAX_EVENT_CLIENTS = 16;
+const MAX_MANUAL_TRANSITION_BODY_BYTES = 4 * 1024;
 export const DASHBOARD_HEALTH_PATH = "/api/health";
 export const DASHBOARD_HEALTH_MAX_BYTES = 8 * 1024;
 const CONTENT_SECURITY_POLICY = [
@@ -159,6 +162,11 @@ function assertDashboardTaskBounds(tasks, maximumTasks) {
       boundedText(turn.turnRef, 512, `${name} turn ${turnIndex + 1} turn ref`);
       boundedText(turn.turnId, 512, `${name} turn ${turnIndex + 1} turn ID`);
       boundedText(turn.result?.summary, 2_000, `${name} turn ${turnIndex + 1} result summary`);
+      boundedText(
+        turn.provenance?.actionId,
+        512,
+        `${name} turn ${turnIndex + 1} manual action ID`,
+      );
     }
     const results = task.results ?? [];
     if (results.length > 10_000) {
@@ -168,6 +176,11 @@ function assertDashboardTaskBounds(tasks, maximumTasks) {
       boundedText(result.summary, 2_000, `${name} result ${resultIndex + 1} summary`);
       boundedText(result.turnRef, 512, `${name} result ${resultIndex + 1} turn ref`);
       boundedText(result.turnId, 512, `${name} result ${resultIndex + 1} turn ID`);
+      boundedText(
+        result.provenance?.actionId,
+        512,
+        `${name} result ${resultIndex + 1} manual action ID`,
+      );
     }
     boundedText(task.project.name, 1_000, `${name} project name`);
     boundedText(task.project.path, 8_192, `${name} project path`);
@@ -382,6 +395,79 @@ function sendJson(response, status, value) {
   response.end(`${JSON.stringify(value)}\n`);
 }
 
+async function readBoundedJsonBody(request, maximumBytes = MAX_MANUAL_TRANSITION_BODY_BYTES) {
+  const contentType = request.headers["content-type"] ?? "";
+  if (!/^application\/json(?:\s*;|$)/i.test(contentType)) {
+    const error = new Error("Request content type must be application/json.");
+    error.code = "unsupported_media_type";
+    throw error;
+  }
+  const chunks = [];
+  let total = 0;
+  for await (const chunk of request) {
+    total += chunk.length;
+    if (total > maximumBytes) {
+      const error = new Error("Request body is too large.");
+      error.code = "body_too_large";
+      throw error;
+    }
+    chunks.push(chunk);
+  }
+  let value;
+  try {
+    value = JSON.parse(Buffer.concat(chunks, total).toString("utf8"));
+  } catch {
+    const error = new Error("Request body must be valid JSON.");
+    error.code = "malformed_json";
+    throw error;
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    const error = new Error("Request body must be a JSON object.");
+    error.code = "invalid_request";
+    throw error;
+  }
+  return value;
+}
+
+function manualTransitionInput(body) {
+  const fields = new Set(["schemaVersion", "actionId", "expected", "targetStatus"]);
+  const unexpected = Object.keys(body).find((key) => !fields.has(key));
+  const missing = [...fields].find((key) => !(key in body));
+  if (unexpected || missing || body.schemaVersion !== 1) {
+    const error = new Error("Manual transition request has an invalid shape.");
+    error.code = "invalid_request";
+    throw error;
+  }
+  const { schemaVersion: _schemaVersion, ...input } = body;
+  return input;
+}
+
+function manualTransitionErrorResponse(error) {
+  const definitions = new Map([
+    ["malformed_json", [400, "Request body must be valid JSON."]],
+    ["invalid_request", [400, "Manual transition request is invalid."]],
+    ["task_not_found", [404, "Task not found."]],
+    ["stale_task", [409, "This task changed. Review its current state and try again."]],
+    ["invalid_transition", [409, "This task can no longer be changed manually."]],
+    ["idempotency_conflict", [409, "This manual action ID was already used."]],
+    ["body_too_large", [413, "Request body is too large."]],
+    ["unsupported_media_type", [415, "Request content type must be application/json."]],
+    ["ELOCKED", [503, "TaskChef is busy updating the workspace. Try again."]],
+  ]);
+  const definition = definitions.get(error?.code);
+  const [status, message] = definition ?? [500, "Dashboard request failed."];
+  return {
+    status,
+    body: {
+      code: error?.code === "ELOCKED"
+        ? "workspace_busy"
+        : (definition ? error.code : "dashboard_error"),
+      message,
+      ...(error?.task ? { task: taskDetailProjection(error.task) } : {}),
+    },
+  };
+}
+
 function ssePayload(event, value) {
   return `event: ${event}\ndata: ${JSON.stringify(value)}\n\n`;
 }
@@ -455,6 +541,7 @@ export async function createDashboardServer({
   launcher = "standalone",
   taskchefVersion = TASKCHEF_VERSION,
   serverVersion = DASHBOARD_SERVER_VERSION,
+  usageTracker = null,
 } = {}) {
   if (!LOOPBACK_HOSTS.has(host)) {
     throw new Error("dashboard host must be a loopback address");
@@ -470,6 +557,7 @@ export async function createDashboardServer({
   }
   const monitor = new DashboardMonitor(workspace, monitorOptions);
   await monitor.start();
+  const taskUsageTracker = usageTracker ?? createUsageTracker({ workspace: monitor.workspace });
   const identity = Object.freeze({
     schemaVersion: 1,
     service: "taskchef-dashboard",
@@ -574,7 +662,47 @@ export async function createDashboardServer({
         response.writeHead(200, securityHeaders("application/json; charset=utf-8"));
         response.end();
       } else {
-        sendJson(response, 200, { schemaVersion: 1, task: taskDetailProjection(task) });
+        const usage = await taskUsageTracker.get(task).catch(() => ({
+          status: "unavailable",
+          reason: "Task usage is temporarily unavailable.",
+          task: null,
+          turns: {},
+        }));
+        sendJson(response, 200, {
+          schemaVersion: 1,
+          task: { ...taskDetailProjection(task), usage },
+        });
+      }
+      return;
+    }
+
+    const transitionMatch = url.pathname.match(
+      /^\/api\/tasks\/([a-zA-Z0-9._-]+)\/manual-transition$/,
+    );
+    if (transitionMatch && method === "POST") {
+      if (request.headers.origin !== allowedOrigin) {
+        sendJson(response, 403, {
+          code: "invalid_origin",
+          message: "Dashboard origin validation failed.",
+        });
+        return;
+      }
+      try {
+        const body = await readBoundedJsonBody(request);
+        const result = await manuallyTransitionTask(
+          monitor.workspace,
+          transitionMatch[1],
+          manualTransitionInput(body),
+        );
+        await monitor.refresh({ force: true }).catch(() => {});
+        sendJson(response, 200, {
+          schemaVersion: 1,
+          task: taskDetailProjection(result.task),
+          idempotent: result.idempotent,
+        });
+      } catch (error) {
+        const failure = manualTransitionErrorResponse(error);
+        sendJson(response, failure.status, failure.body);
       }
       return;
     }

package/src/mcp.js

@@ -13,6 +13,7 @@ import { parseTaskChefMarker } from "./delegation.js";
 import { createDashboardManager } from "./dashboard-manager.js";
 import { resolveWorkspacePath } from "./workspace-path.js";
 import { DASHBOARD_SERVER_VERSION, TASKCHEF_VERSION } from "./version.js";
+import { createUsageTracker } from "./usage-tracker.js";
 
 const projectSchema = z.object({
   name: z.string(),
@@ -22,9 +23,23 @@ const projectSchema = z.object({
   description: z.string().optional(),
 });
 
+const turnProvenanceSchema = z.union([
+  z.object({ kind: z.enum(["legacy", "mcp"]) }),
+  z.object({
+    kind: z.literal("dashboard_manual"),
+    actionId: z.string(),
+    fromStatus: z.enum(["working", "needs_input"]),
+    toStatus: z.enum(["completed", "failed"]),
+    expectedTurnRef: z.string().nullable(),
+    expectedThreadId: z.string().nullable(),
+    expectedUpdatedAt: z.string(),
+  }),
+]);
+
 const taskSchema = z.object({
   schemaVersion: z.union([
     z.literal(4), z.literal(5), z.literal(6), z.literal(7), z.literal(8), z.literal(9),
+    z.literal(10),
   ]),
   id: z.string(),
   project: projectSchema,
@@ -37,7 +52,7 @@ const taskSchema = z.object({
   turnRef: z.string().nullable(),
   turnId: z.string().nullable(),
   updatedAt: z.string(),
-  updatedBy: z.enum(["dispatcher", "mcp"]),
+  updatedBy: z.enum(["dispatcher", "mcp", "dashboard"]),
   turns: z.array(z.object({
     turnRef: z.string().nullable(),
     turnId: z.string().nullable(),
@@ -48,6 +63,7 @@ const taskSchema = z.object({
       summary: z.string(),
       updatedAt: z.string(),
     }).nullable(),
+    provenance: turnProvenanceSchema.nullable(),
   })),
   latestTurn: z.object({
     turnRef: z.string().nullable(),
@@ -59,6 +75,7 @@ const taskSchema = z.object({
       summary: z.string(),
       updatedAt: z.string(),
     }).nullable(),
+    provenance: turnProvenanceSchema.nullable(),
   }).nullable(),
   results: z.array(z.object({
     status: z.enum(["needs_input", "completed", "failed"]),
@@ -66,6 +83,7 @@ const taskSchema = z.object({
     turnRef: z.string().nullable(),
     turnId: z.string().nullable(),
     updatedAt: z.string(),
+    provenance: turnProvenanceSchema.optional(),
   })),
   lastResult: z.object({
     status: z.enum(["needs_input", "completed", "failed"]),
@@ -73,6 +91,7 @@ const taskSchema = z.object({
     turnRef: z.string().nullable(),
     turnId: z.string().nullable(),
     updatedAt: z.string(),
+    provenance: turnProvenanceSchema.optional(),
   }).nullable(),
 });
 
@@ -145,6 +164,7 @@ export function createTaskChefMcpServer({
   dashboardManager = createDashboardManager({ workspace }),
   readConfiguration = readConfig,
   logDashboardDiagnostic,
+  usageTracker = createUsageTracker({ workspace }),
 } = {}) {
   const server = new McpServer(
     { name: "taskchef", version: TASKCHEF_VERSION },
@@ -287,6 +307,7 @@ export function createTaskChefMcpServer({
     },
     async (input) => {
       const task = await reportState(workspace, input);
+      void usageTracker.observe(task).catch(() => {});
       return toolResult("task", task, `Recorded ${task.status} state for TaskChef task ${task.id}.`);
     },
   );
@@ -314,6 +335,7 @@ export function createTaskChefMcpServer({
     },
     async (input) => {
       const task = await reportResult(workspace, input);
+      void usageTracker.observe(task).catch(() => {});
       return toolResult("task", task, `Recorded ${task.status} result for TaskChef task ${task.id}.`);
     },
   );