@myspec/mcp-server 1.1.1-next.163 → 1.1.1-next.165

package/README.md

@@ -363,6 +363,9 @@ Local state is stored under `~/.myspec/` (alongside the on-disk cache root), spl
 | `reply_spec_file_comment_thread` | `file_id`, `thread_id`, `body` | Replies to an existing thread. Conflicts on a trashed file |
 | `update_spec_file_comment` | `file_id`, `comment_id`, `body`, optional `expected_version` | Edits the body of one of YOUR OWN comments; the platform refuses somebody else's. `expected_version` is the **comment's** own `content_version`, not the file's — pairing it with the file would fail an edit because somebody saved the document. Works on a trashed file |
 | `delete_spec_file_comment` | `file_id`, `comment_id` | Soft-deletes one of YOUR OWN comments. Three outcomes, reported in the result: a reply disappears (`comment: null`); a first comment with live replies becomes a tombstone so the thread keeps a head (`comment` is the tombstone); a first comment with no live replies takes the whole thread (`thread_deleted: true`) |
+| `list_tasks` | `project_id`, optional `status`, `assignee_user_id`, `cycle`, `label`, `file_id`, `include_details`, `limit`, `offset` | The project's task board: every checkbox task in its tasks.md files, in file order, each with a stable `task_id`, `status` (`pending`/`in_progress`/`done`), assignee, `priority` (0 none … 4 low, plus `priority_name`), `story_points`, `cycle`, `start_date`/`end_date` (calendar days, `YYYY-MM-DD`), `labels`, and with `include_details` a 500-character preview of its details. Also the files and the labels and cycles in use. Paged: 100 tasks by default (`limit` up to 500), with `total_tasks` and, while more remain, `next_offset` |
+| `update_tasks` | `project_id`, `task_ids[]` (≤ 200), any of `assignee_user_id`, `priority`, `story_points`, `cycle`, `start_date`, `end_date`, `add_labels[]`, `remove_labels[]` | Edits planning fields on every task given. A field left out is left alone; `null` clears it. The assignee must be an org member who can open the project. All or nothing: an unknown id fails the call. Returns the tasks as they are now |
+| `set_task_status` | `project_id`, `task_ids[]` (≤ 200), `status` | Rewrites the tasks' checkboxes in tasks.md (`[ ]`, `[-]`, `[x]`), one revision per file, recorded as an AI change. Partial: returns `updated`/`unchanged`/`removed`/`failed` counts, an outcome per task (with an error code such as `conflict` or `quota_exceeded`) and per file, and the tasks as they are now; an error result only when every task failed |
 
 There is deliberately **no tool to resolve, unresolve or re-anchor a thread**. Those three are human-only: resolving declares a review finished, and re-anchoring is the repair a person makes after the automatic pass has already failed to locate the passage. The platform refuses them for an AI caller with a 403, so a tool would only ever return an error.
 

package/dist/index.js

@@ -2236,6 +2236,7 @@ function transformSpecFileResponse(raw) {
     createdAt: new Date(raw.created_at),
     updatedAt: new Date(raw.updated_at),
     trashedAt: raw.trashed_at ? new Date(raw.trashed_at) : void 0,
+    trashedBy: raw.trashed_by || void 0,
     deletedAt: raw.deleted_at ? new Date(raw.deleted_at) : void 0
   };
 }
@@ -2277,6 +2278,8 @@ function transformProjectResponse(raw) {
     name: raw.name,
     description: raw.description,
     status: raw.status,
+    archivedAt: raw.archived_at ? new Date(raw.archived_at) : void 0,
+    archivedBy: raw.archived_by || void 0,
     projectType: toProjectType(raw.project_type),
     metadata: raw.metadata,
     createdAt: new Date(raw.created_at),
@@ -2304,6 +2307,7 @@ function transformSpecSessionResponse(raw) {
     startedAt: new Date(raw.started_at),
     completedAt: raw.completed_at ? new Date(raw.completed_at) : void 0,
     archivedAt: raw.archived_at ? new Date(raw.archived_at) : void 0,
+    archivedBy: raw.archived_by || void 0,
     createdAt: new Date(raw.created_at),
     updatedAt: new Date(raw.updated_at),
     deletedAt: raw.deleted_at ? new Date(raw.deleted_at) : void 0,
@@ -2314,13 +2318,108 @@ function transformSpecSessionResponse(raw) {
 // ../../packages/platform-client/project/types/lock.types.ts
 var SPEC_FILE_LOCK_TTL_MS = 2 * 6e4;
 
+// ../../packages/platform-client/project/types/task.types.ts
+var TASK_STATUSES = ["pending", "in_progress", "done"];
+var TASK_PRIORITIES = [0, 1, 2, 3, 4];
+var TASK_LIMITS = {
+  maxLabels: 20,
+  maxLabelLength: 40,
+  maxStoryPoints: 9999.99,
+  maxTasksPerRequest: 200
+};
+function parseTimestamp(raw) {
+  if (!raw) return null;
+  const d = new Date(raw);
+  return Number.isNaN(d.getTime()) ? null : d;
+}
+function toStatus(raw) {
+  return TASK_STATUSES.includes(raw) ? raw : "pending";
+}
+function toPriority(raw) {
+  return TASK_PRIORITIES.includes(raw) ? raw : 0;
+}
+function toOutcome(raw) {
+  return raw === "updated" || raw === "unchanged" || raw === "removed" ? raw : "failed";
+}
+function transformProjectTask(raw) {
+  return {
+    id: raw.id,
+    projectId: raw.project_id,
+    specFileId: raw.spec_file_id,
+    parentTaskId: raw.parent_task_id ?? null,
+    key: raw.key,
+    title: raw.title,
+    section: raw.section,
+    position: raw.position,
+    depth: raw.depth,
+    status: toStatus(raw.status),
+    body: raw.body,
+    removedAt: parseTimestamp(raw.removed_at),
+    statusChangedAt: parseTimestamp(raw.status_changed_at),
+    completedAt: parseTimestamp(raw.completed_at),
+    assigneeUserId: raw.assignee_user_id ?? null,
+    priority: toPriority(raw.priority),
+    storyPoints: raw.story_points ?? null,
+    cycle: raw.cycle ?? null,
+    startAt: parseTimestamp(raw.start_at),
+    endAt: parseTimestamp(raw.end_at),
+    labels: raw.labels ?? [],
+    updatedBy: raw.updated_by ?? null,
+    createdAt: parseTimestamp(raw.created_at),
+    updatedAt: parseTimestamp(raw.updated_at)
+  };
+}
+function transformTaskBoard(raw) {
+  return {
+    projectId: raw.project_id,
+    files: (raw.files ?? []).map((f) => ({
+      specFileId: f.spec_file_id,
+      filePath: f.file_path,
+      contentVersion: f.content_version,
+      stale: f.stale
+    })),
+    tasks: (raw.tasks ?? []).map(transformProjectTask),
+    labels: raw.labels ?? [],
+    cycles: raw.cycles ?? []
+  };
+}
+function transformSetTaskStatusResult(raw) {
+  return {
+    results: (raw.results ?? []).map((r) => ({
+      taskId: r.task_id,
+      outcome: toOutcome(r.outcome),
+      ...r.error ? { error: r.error } : {}
+    })),
+    files: (raw.files ?? []).map((f) => ({
+      specFileId: f.spec_file_id,
+      contentVersion: f.content_version,
+      written: f.written,
+      ...f.error ? { error: f.error } : {}
+    })),
+    tasks: (raw.tasks ?? []).map(transformProjectTask)
+  };
+}
+function toRawUpdateTasksRequest(taskIds, patch) {
+  const set = {};
+  if ("assigneeUserId" in patch) set.assignee_user_id = patch.assigneeUserId ?? null;
+  if ("priority" in patch) set.priority = patch.priority ?? null;
+  if ("storyPoints" in patch) set.story_points = patch.storyPoints ?? null;
+  if ("cycle" in patch) set.cycle = patch.cycle ?? null;
+  if ("startAt" in patch) set.start_at = patch.startAt ? patch.startAt.toISOString() : null;
+  if ("endAt" in patch) set.end_at = patch.endAt ? patch.endAt.toISOString() : null;
+  const body = { task_ids: taskIds, set };
+  if (patch.addLabels?.length) body.add_labels = patch.addLabels;
+  if (patch.removeLabels?.length) body.remove_labels = patch.removeLabels;
+  return body;
+}
+
 // ../../packages/platform-client/project/types/comment.types.ts
 var COMMENT_THREAD_FILTER_PARAM = "status";
 var COMMENT_UNRESOLVED_ONLY_PARAM = "unresolved_only";
 var MAX_COMMENT_BODY_LENGTH = 1e4;
 var MAX_ANCHOR_QUOTE_LENGTH = 2e3;
 var MAX_ANCHOR_CONTEXT_LENGTH = 64;
-function parseTimestamp(raw) {
+function parseTimestamp2(raw) {
   if (!raw) {
     return null;
   }
@@ -2364,9 +2463,9 @@ function transformSpecFileCommentResponse(raw) {
     body: raw.body,
     deleted: raw.deleted,
     contentVersion: raw.content_version,
-    createdAt: parseTimestamp(raw.created_at),
-    updatedAt: parseTimestamp(raw.updated_at),
-    deletedAt: parseTimestamp(raw.deleted_at)
+    createdAt: parseTimestamp2(raw.created_at),
+    updatedAt: parseTimestamp2(raw.updated_at),
+    deletedAt: parseTimestamp2(raw.deleted_at)
   };
 }
 function transformSpecFileCommentThreadResponse(raw) {
@@ -2386,10 +2485,10 @@ function transformSpecFileCommentThreadResponse(raw) {
     anchorStatus: toAnchorStatus(raw.anchor_status),
     createdBy: raw.created_by,
     createdByKind: toCommentActorKind(raw.created_by_kind),
-    resolvedAt: parseTimestamp(raw.resolved_at),
+    resolvedAt: parseTimestamp2(raw.resolved_at),
     resolvedBy: raw.resolved_by ?? null,
-    createdAt: parseTimestamp(raw.created_at),
-    updatedAt: parseTimestamp(raw.updated_at),
+    createdAt: parseTimestamp2(raw.created_at),
+    updatedAt: parseTimestamp2(raw.updated_at),
     // Always an array: consumers map over it on every render, so the empty case
     // must not be a value each one has to guard.
     comments: (raw.comments ?? []).map(transformSpecFileCommentResponse)
@@ -2870,6 +2969,7 @@ var HttpProjectClient = class {
     if (opts?.limit) queryParams.set("limit", String(opts.limit));
     if (opts?.offset !== void 0) queryParams.set("offset", String(opts.offset));
     if (opts?.query) queryParams.set("q", opts.query);
+    if (opts?.owner) queryParams.set("owner", opts.owner);
     const query = queryParams.toString();
     const path4 = query ? `/project/v1/projects?${query}` : "/project/v1/projects";
     const response = await this.httpClient.get(path4, jwtToken, {});
@@ -3147,6 +3247,40 @@ var HttpSpecFileCommentClient = class {
   }
 };
 
+// ../../packages/platform-client/project/http/task.http-client.ts
+var HEADER_ACTOR_KIND3 = "X-Actor-Kind";
+function tasksPath(projectId) {
+  return `/project/v1/projects/${encodeURIComponent(projectId)}/tasks`;
+}
+var HttpProjectTaskClient = class {
+  httpClient;
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  async listProjectTasks(projectId, jwtToken) {
+    const raw = await this.httpClient.get(tasksPath(projectId), jwtToken, {});
+    return transformTaskBoard(raw);
+  }
+  async updateProjectTasks(projectId, taskIds, patch, jwtToken) {
+    const raw = await this.httpClient.patch(
+      tasksPath(projectId),
+      toRawUpdateTasksRequest(taskIds, patch),
+      jwtToken,
+      {}
+    );
+    return (raw.tasks ?? []).map(transformProjectTask);
+  }
+  async setProjectTaskStatus(projectId, taskIds, status, jwtToken, opts) {
+    const raw = await this.httpClient.post(
+      `${tasksPath(projectId)}/status`,
+      { task_ids: taskIds, status },
+      jwtToken,
+      opts?.actorKind ? { headers: { [HEADER_ACTOR_KIND3]: opts.actorKind } } : {}
+    );
+    return transformSetTaskStatusResult(raw);
+  }
+};
+
 // ../../packages/platform-client/artifact/types/artifact.types.ts
 function transformArtifactResponse(raw) {
   return {
@@ -3278,14 +3412,14 @@ function buildUpdateArtifactBody(request) {
 // ../../packages/platform-client/artifact/http/artifact.http-client.ts
 var BASE_PATH = "/artifact/v1";
 var HEADER_EXPECTED_VERSION3 = "X-Expected-Version";
-var HEADER_ACTOR_KIND3 = "X-Actor-Kind";
+var HEADER_ACTOR_KIND4 = "X-Actor-Kind";
 function writeHeaders(opts) {
   const headers = {};
   if (opts?.expectedVersion !== void 0) {
     headers[HEADER_EXPECTED_VERSION3] = String(opts.expectedVersion);
   }
   if (opts?.actorKind) {
-    headers[HEADER_ACTOR_KIND3] = opts.actorKind;
+    headers[HEADER_ACTOR_KIND4] = opts.actorKind;
   }
   return headers;
 }
@@ -3863,7 +3997,8 @@ var PlatformClient = class {
       attachment: new HttpAttachmentClient(httpClient),
       artifact: new HttpArtifactClient(httpClient),
       streamToken: new HttpStreamTokenClient(httpClient),
-      comment: new HttpSpecFileCommentClient(httpClient)
+      comment: new HttpSpecFileCommentClient(httpClient),
+      task: new HttpProjectTaskClient(httpClient)
     };
   }
   // ------------------------------------------------------- stream tokens
@@ -3967,6 +4102,26 @@ var PlatformClient = class {
       (jwt, c) => c.comment.deleteComment(fileId, commentId, jwt, { actorKind: "ai" })
     );
   }
+  // ---------------------------------------------------------------- tasks
+  //
+  // The project task board. A status change rewrites tasks.md, so it carries
+  // `actorKind: 'ai'` like every other file write here: the revision is then
+  // recorded as the assistant's, not filed under the user's name. A planning
+  // edit writes no file and the platform records no actor kind for it.
+  /** Every live task of a project's tasks.md files. */
+  async listProjectTasks(projectId) {
+    return this.withTokenRetry((jwt, c) => c.task.listProjectTasks(projectId, jwt));
+  }
+  /** Applies one planning patch to up to 200 tasks; all or nothing. */
+  async updateProjectTasks(projectId, taskIds, patch) {
+    return this.withTokenRetry((jwt, c) => c.task.updateProjectTasks(projectId, taskIds, patch, jwt));
+  }
+  /** Sets the status of up to 200 tasks by rewriting their checkboxes. */
+  async setProjectTaskStatus(projectId, taskIds, status) {
+    return this.withTokenRetry(
+      (jwt, c) => c.task.setProjectTaskStatus(projectId, taskIds, status, jwt, { actorKind: "ai" })
+    );
+  }
   async withTokenRetry(call) {
     const clients = await this.clients();
     const jwt = await this.tokenManager.getValidAccessToken();
@@ -7175,6 +7330,179 @@ var startSpecSessionTool = {
   }
 };
 
+// src/server/tools/tasks.ts
+import { z as z39 } from "zod";
+var LIST_DEFAULT_TASKS = 100;
+var LIST_MAX_TASKS = 500;
+var DETAILS_PREVIEW_CHARS = 500;
+var MAX_CYCLE = 1e5;
+var PRIORITY_NAMES = ["none", "urgent", "high", "medium", "low"];
+var STATUS = z39.enum(["pending", "in_progress", "done"]);
+function toDay(date) {
+  return date ? date.toISOString().slice(0, 10) : null;
+}
+function fromDay(day) {
+  return /* @__PURE__ */ new Date(`${day}T00:00:00Z`);
+}
+function taskSummary(task, opts = {}) {
+  const withDetails = opts.details === true && task.body !== "";
+  const truncated = withDetails && task.body.length > DETAILS_PREVIEW_CHARS;
+  return {
+    task_id: task.id,
+    spec_file_id: task.specFileId,
+    // The id written in the file ("1", "1.1", "T001"); '' when it has none.
+    key: task.key,
+    title: task.title,
+    section: task.section,
+    parent_task_id: task.parentTaskId,
+    status: task.status,
+    assignee_user_id: task.assigneeUserId,
+    priority: task.priority,
+    priority_name: PRIORITY_NAMES[task.priority],
+    story_points: task.storyPoints,
+    cycle: task.cycle,
+    start_date: toDay(task.startAt),
+    end_date: toDay(task.endAt),
+    labels: task.labels,
+    ...withDetails ? { details: truncated ? task.body.slice(0, DETAILS_PREVIEW_CHARS) : task.body } : {},
+    // Only ever present and true.
+    ...truncated ? { details_truncated: true } : {},
+    updated_at: task.updatedAt?.toISOString()
+  };
+}
+var userIdField = z39.string().trim().min(1);
+var labelField = z39.string().trim().min(1).refine((label) => Array.from(label).length <= TASK_LIMITS.maxLabelLength, {
+  message: `A label is at most ${String(TASK_LIMITS.maxLabelLength)} characters.`
+});
+function taskIdsField(what) {
+  return z39.array(z39.uuid()).min(1).max(TASK_LIMITS.maxTasksPerRequest).describe(`${what} At most ${String(TASK_LIMITS.maxTasksPerRequest)} per call.`);
+}
+var listInputSchema2 = {
+  project_id: z39.uuid().describe("UUID of the project whose tasks to list."),
+  status: STATUS.optional().describe("Only tasks with this status."),
+  assignee_user_id: userIdField.optional().describe("Only tasks assigned to this user id (as returned in assignee_user_id)."),
+  cycle: z39.number().int().min(1).optional().describe("Only tasks in this cycle (sprint) number."),
+  label: labelField.optional().describe("Only tasks carrying this label."),
+  file_id: z39.uuid().optional().describe("Only tasks from this tasks.md (its spec file id)."),
+  include_details: z39.boolean().optional().describe(
+    "Also return each task's details (its sub-bullets in tasks.md), previewed to 500 characters. Off by default: they make the result several times larger."
+  ),
+  limit: z39.number().int().min(1).max(LIST_MAX_TASKS).optional().describe(
+    `Tasks per page (default ${String(LIST_DEFAULT_TASKS)}, at most ${String(LIST_MAX_TASKS)}).`
+  ),
+  offset: z39.number().int().min(0).optional().describe("How many matching tasks to skip; pass next_offset from the previous page.")
+};
+var listTasksTool = {
+  name: "list_tasks",
+  description: "List a project's tasks: every checkbox task in its tasks.md files, in file order, each with a stable task_id, status (pending, in_progress, done), assignee, priority (0 none, 1 urgent, 2 high, 3 medium, 4 low), story points, cycle, start/end dates (YYYY-MM-DD) and labels. Also returns the files, and the labels and cycles in use. Filter by status, assignee, cycle, label or file. Paged: 100 tasks by default (limit up to 500), with total_tasks and, while more remain, next_offset. Details (sub-bullets) only with include_details. Use the task_id values with update_tasks and set_task_status.",
+  inputSchema: listInputSchema2,
+  handler: async (args, ctx) => {
+    const board = await ctx.client.listProjectTasks(args.project_id);
+    const matching = board.tasks.filter(
+      (task) => (args.status === void 0 || task.status === args.status) && (args.assignee_user_id === void 0 || task.assigneeUserId === args.assignee_user_id) && (args.cycle === void 0 || task.cycle === args.cycle) && (args.label === void 0 || task.labels.includes(args.label)) && (args.file_id === void 0 || task.specFileId === args.file_id)
+    );
+    const offset = args.offset ?? 0;
+    const page = matching.slice(offset, offset + (args.limit ?? LIST_DEFAULT_TASKS));
+    const next = offset + page.length;
+    return jsonResult({
+      project_id: board.projectId,
+      files: board.files.map((file) => ({
+        spec_file_id: file.specFileId,
+        file_path: file.filePath,
+        content_version: file.contentVersion,
+        // The file could not be re-read just now: its tasks are from the last read.
+        ...file.stale ? { stale: true } : {}
+      })),
+      tasks: page.map((task) => taskSummary(task, { details: args.include_details })),
+      total_tasks: matching.length,
+      offset,
+      // Only while more remain, so its absence means "that was the last page".
+      ...next < matching.length ? { next_offset: next } : {},
+      labels: board.labels,
+      cycles: board.cycles
+    });
+  }
+};
+var updateInputSchema2 = {
+  project_id: z39.uuid().describe("UUID of the project the tasks belong to."),
+  task_ids: taskIdsField("The tasks to change (task_id values from list_tasks)."),
+  assignee_user_id: userIdField.nullable().optional().describe(
+    "User id to assign, or null to unassign. The person must be a member of the organisation who can open the project."
+  ),
+  priority: z39.number().int().min(0).max(4).optional().describe("0 none, 1 urgent, 2 high, 3 medium, 4 low."),
+  story_points: z39.number().min(0).max(TASK_LIMITS.maxStoryPoints).nullable().optional().describe("Estimate in story points, or null to clear it."),
+  cycle: z39.number().int().min(1).max(MAX_CYCLE).nullable().optional().describe("Cycle (sprint) number, or null to clear it."),
+  start_date: z39.iso.date().nullable().optional().describe("Start day as YYYY-MM-DD, or null to clear it."),
+  end_date: z39.iso.date().nullable().optional().describe("Due day as YYYY-MM-DD, or null to clear it. Not before the start day."),
+  add_labels: z39.array(labelField).max(TASK_LIMITS.maxLabels).optional().describe(`Labels to add. A task carries at most ${String(TASK_LIMITS.maxLabels)}.`),
+  remove_labels: z39.array(labelField).max(TASK_LIMITS.maxLabels).optional().describe("Labels to remove.")
+};
+var updateTasksTool = {
+  name: "update_tasks",
+  description: "Edit the planning fields of one or more tasks: assignee, priority, story points, cycle, start and due dates, and labels. The same change applies to every task given. A field left out is left alone; null clears it. Labels are added and removed, not replaced. Does not change status or the task's text, which live in tasks.md: use set_task_status for status. All or nothing: an unknown task id fails the whole call. Returns the tasks as they are now.",
+  inputSchema: updateInputSchema2,
+  handler: async (args, ctx) => {
+    const patch = {};
+    if (args.assignee_user_id !== void 0) patch.assigneeUserId = args.assignee_user_id;
+    if (args.priority !== void 0) patch.priority = args.priority;
+    if (args.story_points !== void 0) patch.storyPoints = args.story_points;
+    if (args.cycle !== void 0) patch.cycle = args.cycle;
+    if (args.start_date !== void 0) {
+      patch.startAt = args.start_date === null ? null : fromDay(args.start_date);
+    }
+    if (args.end_date !== void 0) {
+      patch.endAt = args.end_date === null ? null : fromDay(args.end_date);
+    }
+    if (args.add_labels?.length) patch.addLabels = args.add_labels;
+    if (args.remove_labels?.length) patch.removeLabels = args.remove_labels;
+    if (Object.keys(patch).length === 0) {
+      return errorResult(
+        "Nothing to change: pass at least one of assignee_user_id, priority, story_points, cycle, start_date, end_date, add_labels or remove_labels."
+      );
+    }
+    const tasks = await ctx.client.updateProjectTasks(args.project_id, args.task_ids, patch);
+    return jsonResult({ tasks: tasks.map((task) => taskSummary(task)) });
+  }
+};
+var statusInputSchema = {
+  project_id: z39.uuid().describe("UUID of the project the tasks belong to."),
+  task_ids: taskIdsField("The tasks to move (task_id values from list_tasks)."),
+  status: STATUS.describe("The new status: pending, in_progress or done.")
+};
+var setTaskStatusTool = {
+  name: "set_task_status",
+  description: "Change the status of one or more tasks by rewriting their checkbox in the project's tasks.md files: `[ ]` pending, `[-]` in progress, `[x]` done. Each affected file gets one new revision, recorded as an AI change; nothing else in the file changes. Partial by nature: a file that cannot be written (it kept changing, the organisation is out of storage, or it was moved to the trash) fails only its own tasks. Returns an outcome per task (updated, unchanged, removed: no longer in its file, failed: with an error code), an outcome per file, and the tasks as they are now. Marked as an error only when every task failed.",
+  inputSchema: statusInputSchema,
+  handler: async (args, ctx) => {
+    const result = await ctx.client.setProjectTaskStatus(
+      args.project_id,
+      args.task_ids,
+      args.status
+    );
+    const count = (outcome) => result.results.filter((r) => r.outcome === outcome).length;
+    const failed = count("failed");
+    const body = jsonResult({
+      updated: count("updated"),
+      unchanged: count("unchanged"),
+      removed: count("removed"),
+      failed,
+      results: result.results.map((r) => ({
+        task_id: r.taskId,
+        outcome: r.outcome,
+        ...r.error ? { error: r.error } : {}
+      })),
+      files: result.files.map((file) => ({
+        spec_file_id: file.specFileId,
+        content_version: file.contentVersion,
+        written: file.written,
+        ...file.error ? { error: file.error } : {}
+      })),
+      tasks: result.tasks.map((task) => taskSummary(task))
+    });
+    return failed > 0 && failed === result.results.length ? { ...body, isError: true } : body;
+  }
+};
+
 // src/server/server.ts
 function buildServer(deps) {
   const server = new McpServer({
@@ -7226,6 +7554,9 @@ function buildServer(deps) {
   registerTool(server, replySpecFileCommentThreadTool, ctx);
   registerTool(server, updateSpecFileCommentTool, ctx);
   registerTool(server, deleteSpecFileCommentTool, ctx);
+  registerTool(server, listTasksTool, ctx);
+  registerTool(server, updateTasksTool, ctx);
+  registerTool(server, setTaskStatusTool, ctx);
   return server;
 }
 async function startStdioServer(deps) {
@@ -7397,7 +7728,7 @@ async function canonicaliseRoot(root) {
 import { promises as fs4 } from "fs";
 import { join as join2, relative } from "path";
 import { spawn } from "child_process";
-import { z as z39 } from "zod";
+import { z as z40 } from "zod";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
 // src/reverse/ignore.ts
@@ -7702,37 +8033,37 @@ var READ_FILE_MAX_LINES = 2e3;
 var LIST_DIR_HARD_CAP = 5e3;
 var LIST_DIR_DEFAULT_CAP = 1e3;
 var GREP_MAX_MATCHES_DEFAULT = 200;
-var listDirInput = z39.object({
-  path: z39.string(),
-  recursive: z39.boolean().optional(),
-  maxEntries: z39.number().int().positive().optional(),
-  includeIgnored: z39.boolean().optional()
+var listDirInput = z40.object({
+  path: z40.string(),
+  recursive: z40.boolean().optional(),
+  maxEntries: z40.number().int().positive().optional(),
+  includeIgnored: z40.boolean().optional()
 });
-var readFileInput = z39.object({
-  path: z39.string(),
-  offset: z39.number().int().nonnegative().optional(),
-  limit: z39.number().int().positive().optional(),
-  includeIgnored: z39.boolean().optional()
+var readFileInput = z40.object({
+  path: z40.string(),
+  offset: z40.number().int().nonnegative().optional(),
+  limit: z40.number().int().positive().optional(),
+  includeIgnored: z40.boolean().optional()
 });
-var grepInput = z39.object({
-  pattern: z39.string().describe(
+var grepInput = z40.object({
+  pattern: z40.string().describe(
     "Search pattern. Interpreted as a regular expression by default (ripgrep syntax), e.g. `foo|bar` or `[Rr]ole`. Set `isRegex: false` to match the pattern as an exact literal string instead."
   ),
-  path: z39.string().optional().describe("File or directory under --root to search. Defaults to the whole root."),
-  isRegex: z39.boolean().optional().describe("Treat `pattern` as a regex (default true). Set false for literal-string search."),
-  caseSensitive: z39.boolean().optional(),
-  maxMatches: z39.number().int().positive().optional(),
-  contextLines: z39.number().int().nonnegative().optional(),
-  includeIgnored: z39.boolean().optional()
+  path: z40.string().optional().describe("File or directory under --root to search. Defaults to the whole root."),
+  isRegex: z40.boolean().optional().describe("Treat `pattern` as a regex (default true). Set false for literal-string search."),
+  caseSensitive: z40.boolean().optional(),
+  maxMatches: z40.number().int().positive().optional(),
+  contextLines: z40.number().int().nonnegative().optional(),
+  includeIgnored: z40.boolean().optional()
 });
-var packCodebaseInput = z39.object({
-  subpath: z39.string().optional(),
-  includePatterns: z39.string().optional(),
-  ignorePatterns: z39.string().optional()
+var packCodebaseInput = z40.object({
+  subpath: z40.string().optional(),
+  includePatterns: z40.string().optional(),
+  ignorePatterns: z40.string().optional()
 });
-var packCodebaseReadPageInput = z39.object({
-  outputId: z39.string(),
-  page: z39.number().int().positive()
+var packCodebaseReadPageInput = z40.object({
+  outputId: z40.string(),
+  page: z40.number().int().positive()
 });
 function structuredError(error, message, extra) {
   const payload = { error, message, ...extra ?? {} };
@@ -8260,7 +8591,7 @@ function jsonSchemaFromZod(schema) {
   return zodToJson(schema);
 }
 function zodToJson(schema) {
-  if (schema instanceof z39.ZodObject) {
+  if (schema instanceof z40.ZodObject) {
     const shape = schema.shape;
     const properties = {};
     const required = [];
@@ -8275,19 +8606,19 @@ function zodToJson(schema) {
     if (required.length > 0) out.required = required;
     return out;
   }
-  if (schema instanceof z39.ZodOptional) {
+  if (schema instanceof z40.ZodOptional) {
     return zodToJson(schema.unwrap());
   }
-  if (schema instanceof z39.ZodString) {
+  if (schema instanceof z40.ZodString) {
     return { type: "string" };
   }
-  if (schema instanceof z39.ZodNumber) {
+  if (schema instanceof z40.ZodNumber) {
     return { type: "number" };
   }
-  if (schema instanceof z39.ZodBoolean) {
+  if (schema instanceof z40.ZodBoolean) {
     return { type: "boolean" };
   }
-  if (schema instanceof z39.ZodEnum) {
+  if (schema instanceof z40.ZodEnum) {
     return { type: "string", enum: schema.options };
   }
   return { type: "string" };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myspec/mcp-server",
-  "version": "1.1.1-next.163",
+  "version": "1.1.1-next.165",
   "description": "MySpec MCP server — exposes MySpec platform projects, files and attachments to MCP-aware clients via OAuth-authenticated access tokens.",
   "type": "module",
   "repository": {