@mrrlin-dev/mcp 0.3.54 → 0.3.55

package/dist/bin.cjs

@@ -36506,6 +36506,8 @@ var openApiOperationIds = {
   getProject: "getProject",
   getProjectSnapshot: "getProjectSnapshot",
   getTask: "getTask",
+  archiveTask: "archiveTask",
+  unarchiveTask: "unarchiveTask",
   getWikiPage: "getWikiPage",
   handleGithubInstallCallback: "handleGithubInstallCallback",
   listExecutionArtifacts: "listExecutionArtifacts",
@@ -36556,6 +36558,7 @@ var openApiOperationIds = {
   listArtifactFiles: "listArtifactFiles",
   getOperatorSettings: "getOperatorSettings",
   updateOperatorSettings: "updateOperatorSettings",
+  recordOperatorPresence: "recordOperatorPresence",
   getAgentPool: "getAgentPool",
   putAgentPool: "putAgentPool",
   getConsensusConfig: "getConsensusConfig",
@@ -36600,6 +36603,8 @@ var mrrlinOperatorSettingsSchema = external_exports.object({
   // to it (the web active-project selection is otherwise only a browser cookie). Null = not
   // selected yet.
   activeProjectSlug: external_exports.string().min(1).nullable(),
+  // The last time an authenticated BROWSER operator session was observed. Null means never seen.
+  lastPresenceAt: external_exports.string().datetime().nullable(),
   createdAt: external_exports.string().datetime(),
   updatedAt: external_exports.string().datetime()
 });
@@ -36611,6 +36616,7 @@ var mrrlinOperatorSettingsUpdateSchema = external_exports.object({
   message: "OperatorSettingsUpdate requires at least one field"
 });
 var operatorSettingsResponseSchema = external_exports.object({ data: mrrlinOperatorSettingsSchema });
+var operatorPresenceResponseSchema = external_exports.object({ data: external_exports.object({ lastPresenceAt: external_exports.string().datetime() }) });
 var mrrlinConsensusConfigSchema = external_exports.object({ consensusEnabled: external_exports.boolean() });
 var consensusConfigResponseSchema = external_exports.object({ data: mrrlinConsensusConfigSchema });
 var agentPoolSnapshotSchema = external_exports.object({
@@ -36748,7 +36754,13 @@ var mrrlinTaskDomainSchema = external_exports.enum(["code", "seo", "marketing",
 var mrrlinSpecApprovedSchema = external_exports.enum(["pending", "approved", "skipped", "skipped_legacy"]);
 var mrrlinTaskSourceSchema = external_exports.enum(["fixture-import", "api"]);
 var mrrlinPlanStatusSchema = external_exports.enum(["active", "paused", "done", "archived"]);
-var mrrlinTaskEventTypeSchema = external_exports.enum(["autonomy_set", "director_thread_reset", "note"]);
+var mrrlinTaskEventTypeSchema = external_exports.enum([
+  "autonomy_set",
+  "director_thread_reset",
+  "note",
+  "archived",
+  "restored"
+]);
 var mrrlinTaskEventCreateKindSchema = external_exports.enum(["note"]);
 var githubRepositorySelectionSchema = external_exports.enum(["all", "selected"]);
 var mrrlinTaskIdSchema = external_exports.string().regex(/^GT-\d+$/);
@@ -36862,6 +36874,9 @@ var taxonomyCategorySchema = external_exports.string().min(1).regex(/^[a-z][a-z0
 var taxonomySubcategorySchema = external_exports.string().min(1).regex(/^[a-z][a-z0-9-]*$/);
 var mrrlinTaskAssigneeSchema = external_exports.union([external_exports.string().regex(/^@/), external_exports.string().email()]).nullable();
 var mrrlinTaskSchema = external_exports.object({
+  // Output-optional (not defaulted-required) so existing task fixtures/mocks across the
+  // codebase need no churn; DB rows always resolve it to `string | null` via taskRowToTask.
+  archivedAt: external_exports.string().datetime().nullable().optional(),
   assignee: mrrlinTaskAssigneeSchema,
   autoDeploy: mrrlinAutoDeploySchema,
   // ADR 0020. OUTPUT-optional (not defaulted-required) so hardcoded task fixtures/mocks across the
@@ -37109,6 +37124,7 @@ var mrrlinTaskUpdateSchema = external_exports.object({
   }
 });
 var mrrlinTaskListFiltersSchema = external_exports.object({
+  archived: external_exports.enum(["true", "false", "all"]).optional(),
   assignee: external_exports.string().startsWith("@").optional(),
   autoDeploy: mrrlinAutoDeploySchema.optional(),
   autonomyLevel: mrrlinAutonomyLevelSchema.optional(),
@@ -37829,7 +37845,11 @@ var schedulerPendingTasksResponseSchema = external_exports.object({
     // disclosure that some exist, so a misconfigured `github.operator` (e.g. it doesn't match the
     // person actually running the project) is visible as a large number instead of the autopilot
     // silently doing nothing.
-    excludedByOwnershipCount: external_exports.number().int().min(0)
+    excludedByOwnershipCount: external_exports.number().int().min(0),
+    // Additive: true when the operator-web-presence gate is the reason nothing new is starting
+    // (autonomyPaused takes precedence when both apply). Computed by the same shared helper the
+    // tick uses, so this page can never claim a task is starting when the tick would decline it.
+    presenceGated: external_exports.boolean()
   })
 });
 var wakeDirectorRequestSchema = external_exports.object({
@@ -38386,6 +38406,7 @@ function createMrrlinClient(config2) {
     },
     async listTasks(projectSlug, filters = {}) {
       const path19 = appendQuery(`${projectPath(projectSlug)}/tasks`, {
+        archived: filters.archived,
         assignee: filters.assignee,
         autonomyLevel: filters.autonomyLevel,
         blockedBy: filters.blockedBy,
@@ -38443,6 +38464,18 @@ function createMrrlinClient(config2) {
       const body = await request(`${projectPath(projectSlug)}/tasks/${encodeURIComponent(taskId)}/director-thread/reset`, { method: "POST" });
       return taskResponseSchema.parse(body).data;
     },
+    async archiveTask(projectSlug, taskId) {
+      const body = await request(`${projectPath(projectSlug)}/tasks/${encodeURIComponent(taskId)}/archive`, {
+        method: "POST"
+      });
+      return taskResponseSchema.parse(body).data;
+    },
+    async unarchiveTask(projectSlug, taskId) {
+      const body = await request(`${projectPath(projectSlug)}/tasks/${encodeURIComponent(taskId)}/unarchive`, {
+        method: "POST"
+      });
+      return taskResponseSchema.parse(body).data;
+    },
     async updateWikiPage(projectSlug, pageId, patch) {
       const body = await request(`${projectPath(projectSlug)}/wiki/${encodeURIComponent(pageId)}`, {
         body: JSON.stringify(patch),
@@ -38808,6 +38841,10 @@ function createMrrlinClient(config2) {
       });
       return operatorSettingsResponseSchema.parse(body).data;
     },
+    async recordOperatorPresence() {
+      const body = await request(`/operator/presence`, { method: "POST" });
+      return operatorPresenceResponseSchema.parse(body).data;
+    },
     async getOperatorAgentPool() {
       const body = await request(`/operator/agent-pool`);
       return agentPoolResponseSchema.parse(body).data;
@@ -39322,7 +39359,7 @@ function startCodexProbe(deps = {}) {
 }
 
 // src/_generated/version.ts
-var PKG_VERSION = "0.3.54";
+var PKG_VERSION = "0.3.55";
 
 // src/api-base-url-migrate.ts
 var import_node_fs2 = __toESM(require("node:fs"), 1);
@@ -48772,6 +48809,21 @@ function buildThreadStartParams(msg, config2, desiredModel) {
     "transcript. Just call the tools and reply with the outcome \u2014 start your reply with the result.",
     "When creating or updating tasks, always provide `autonomyLevel` and `autonomyReason`.",
     "",
+    "Tool-use contract \u2014 typed MCP tools are the ONLY channel for Mrrlin data:",
+    "- Every read or write of Mrrlin data \u2014 tasks, plans, wiki pages, inbox items, execution runs,",
+    "  projects \u2014 must go through the corresponding typed MCP tool. Never use `commandExecution`,",
+    "  `curl`, `python`, or any direct HTTP call to the Mrrlin API.",
+    "- A single `create_task` call creates a task completely; it accepts `title`, `notes`, `category`,",
+    "  `subcategory`, `impact`, `autonomyLevel`, `planId`, `parentTaskId`, and more in one call.",
+    "  Do not create then patch, and do not re-read the task afterwards unless the operator asked",
+    "  for confirmation.",
+    "- `commandExecution` is for the operator's own machine and repositories \u2014 running builds, tests,",
+    "  `git`, inspecting local files \u2014 and for public third-party web checks. It is not a transport",
+    "  for this product's API.",
+    "- If no typed tool exists for a needed operation, state that to the operator instead of reaching",
+    "  for the API by hand.",
+    "- Do not spend turns re-reading state you just wrote.",
+    "",
     "Turn lifecycle \u2014 what you can and cannot do between turns:",
     "- Your turn ends the moment you stop producing output. You CANNOT start a new turn yourself:",
     "  no timer and no scheduler wakes you up. Only a new operator message starts the next turn.",
@@ -48845,9 +48897,10 @@ function buildThreadStartParams(msg, config2, desiredModel) {
     '  Never answer "nothing found" from plans alone.',
     '- Only report "nothing found" after the q-variants AND a full-list scan are empty, and then',
     "  state exactly what you searched.",
-    "- For public HTTP/HTML verification through `commandExecution`, prefer built-in tooling such",
-    "  as `curl`, `python3` stdlib `urllib.request`, and `html.parser`; do not assume third-party",
-    "  Python packages such as `requests` or `bs4` are installed.",
+    "- For public/third-party HTTP/HTML verification through `commandExecution`, prefer built-in",
+    "  tooling such as `curl`, `python3` stdlib `urllib.request`, and `html.parser`; do not assume",
+    "  third-party Python packages such as `requests` or `bs4` are installed. This permission covers",
+    "  third-party sites ONLY \u2014 never call the Mrrlin API from `commandExecution`.",
     "",
     "Handoff contract \u2014 durable operator action MUST NOT live only in chat:",
     "- If you conclude that a specific task needs human input, account access, manual evidence,",
@@ -54649,15 +54702,35 @@ function firstTaskIdToken(text) {
 }
 
 // src/consensus/spec-gate.ts
+function mapAcceptedIssueToClarification(issue2) {
+  const text = issue2.text.toLowerCase();
+  let kind;
+  if (issue2.category === "scope") {
+    const directionCues = ["only", "or also", "narrower", "broader", "include", "exclude", "versus", "vs"];
+    kind = directionCues.some((cue) => text.includes(cue)) ? "scope_direction" : "missing_requirement";
+  } else {
+    const acceptanceCues = ["acceptance", "done", "success", "criteria", "satisfy"];
+    kind = acceptanceCues.some((cue) => text.includes(cue)) ? "acceptance_criteria_detail" : "default_choice";
+  }
+  return {
+    kind,
+    diagnostic: false,
+    rawQuestion: issue2.text,
+    whyBlocking: `reviewer raised a ${issue2.category} issue`,
+    category: issue2.category
+  };
+}
 async function runSpecGate(_target, deps, opts) {
   if (!await deps.consensusEnabled()) return { outcome: "SKIPPED" };
   const intent = await deps.readIntent();
   if (intent.taskId !== null && (intent.seed === null || intent.seed.trim() === "")) {
     return {
       outcome: "CONSENSUS_BLOCKED",
-      clarifications: [
+      operatorClarifications: [
         {
-          question: "What are the requirements for this task? There is no operator request on record, so the spec cannot be validated against your intent \u2014 please state what this task must do.",
+          kind: "missing_requirement",
+          diagnostic: false,
+          rawQuestion: "What are the requirements for this task? There is no operator request on record, so the spec cannot be validated against your intent \u2014 please state what this task must do.",
           whyBlocking: "operator_seed_request is empty",
           category: "scope"
         }
@@ -54671,9 +54744,11 @@ async function runSpecGate(_target, deps, opts) {
   if (normalizeDomain(intent.domain) !== "code" && parseAcceptanceCriteria(spec.markdownBody) === null) {
     return {
       outcome: "CONSENSUS_BLOCKED",
-      clarifications: [
+      operatorClarifications: [
         {
-          question: "This spec has no machine-usable acceptance criteria. Add an `## Acceptance criteria` section written as a markdown checklist (`- [ ] \u2026` items) describing exactly what the finished deliverable must satisfy \u2014 the review of the produced work is scored against it.",
+          kind: "acceptance_criteria_detail",
+          diagnostic: false,
+          rawQuestion: "This spec has no machine-usable acceptance criteria. Add an `## Acceptance criteria` section written as a markdown checklist (`- [ ] \u2026` items) describing exactly what the finished deliverable must satisfy \u2014 the review of the produced work is scored against it.",
           whyBlocking: "non-code spec is missing a parseable `## Acceptance criteria` checklist",
           category: "scope"
         }
@@ -54723,9 +54798,11 @@ async function runSpecGate(_target, deps, opts) {
     );
     return {
       outcome: "CONSENSUS_BLOCKED",
-      clarifications: [
+      diagnostics: [
         {
-          question: `SPEC_IDENTITY_MISMATCH: this spec page gates ${intent.taskId}, but its heading identifies a different task \u2014 rewrite the spec heading and content for ${intent.taskId}, or re-link the task.`,
+          kind: "spec_identity_mismatch",
+          diagnostic: true,
+          rawQuestion: `SPEC_IDENTITY_MISMATCH: this spec page gates ${intent.taskId}, but its heading identifies a different task \u2014 rewrite the spec heading and content for ${intent.taskId}, or re-link the task.`,
           whyBlocking: "converged spec content belongs to a different task than the one it gates",
           category: "scope"
         }
@@ -54745,12 +54822,8 @@ async function runSpecGate(_target, deps, opts) {
   }
   if (result.outcome === "CONSENSUS_BLOCKED") {
     const accepted = result.history.at(-1)?.accepted ?? [];
-    const clarifications = accepted.filter((issue2) => issue2.category === "ambiguity" || issue2.category === "scope").map((issue2) => ({
-      question: issue2.text,
-      whyBlocking: `reviewer raised a ${issue2.category} issue`,
-      category: issue2.category
-    }));
-    return clarifications.length > 0 ? { outcome: "CONSENSUS_BLOCKED", clarifications } : { outcome: "CONSENSUS_BLOCKED" };
+    const operatorClarifications = accepted.filter((issue2) => issue2.category === "ambiguity" || issue2.category === "scope").map((issue2) => mapAcceptedIssueToClarification(issue2));
+    return operatorClarifications.length > 0 ? { outcome: "CONSENSUS_BLOCKED", operatorClarifications } : { outcome: "CONSENSUS_BLOCKED" };
   }
   return { outcome: result.outcome };
 }
@@ -55175,6 +55248,22 @@ function buildGateQuestionOptions(question, category) {
     }
   ];
 }
+var HUMANIZE_TEMPLATE_BY_KIND = {
+  scope_direction: "The spec can be read in two different ways. Which direction should it follow?",
+  default_choice: "One important detail is still ambiguous. Which interpretation should the spec use?",
+  missing_requirement: "A required part of the task is still missing from the spec. What should it say?",
+  acceptance_criteria_detail: "The direction is clear, but the spec still needs a sharper success check. What should count as done?"
+};
+var HUMANIZE_CONTEXT_CAP = 200;
+function humanizeClarificationBody(clarification) {
+  const prefix = HUMANIZE_TEMPLATE_BY_KIND[clarification.kind];
+  let context = clarification.rawQuestion.replace(/\b(?:parseable|SPEC_IDENTITY_MISMATCH|machine-usable)\b/gi, "").replace(/\s+/g, " ").trim();
+  if (context.length > HUMANIZE_CONTEXT_CAP) {
+    const cutIdx = context.lastIndexOf(" ", HUMANIZE_CONTEXT_CAP);
+    context = context.slice(0, cutIdx > 0 ? cutIdx : HUMANIZE_CONTEXT_CAP).trim() + "\u2026";
+  }
+  return context ? `${prefix} ${context}` : prefix;
+}
 var defaultNativeSpecGateBuilders = { buildSpecGateDeps, runSpecGate };
 async function runNativeSpecGate(ctx, input, builders = defaultNativeSpecGateBuilders) {
   const deps = builders.buildSpecGateDeps({
@@ -55215,6 +55304,100 @@ async function cachedResult(client, input) {
   }
   return null;
 }
+async function handleConsensusBlocked(result, ctx, input, resolvedTaskId) {
+  const operatorClarifications = result.operatorClarifications ?? [];
+  const diagnostics = result.diagnostics ?? [];
+  if (operatorClarifications.length > 0) {
+    try {
+      const page = await ctx.client.getWikiPage(input.projectSlug, input.pageId);
+      if (page) {
+        const domain2 = await resolveSpecDomain(ctx.client, input.projectSlug, {
+          id: page.id,
+          taskId: page.taskId ?? null
+        });
+        await ctx.client.recordSpecConsensusReview(input.projectSlug, input.pageId, {
+          contentHash: domainScopedReviewHash(page.contentHash, domain2),
+          outcome: "CONSENSUS_BLOCKED_CLARIFICATION",
+          rounds: 0
+        });
+      }
+    } catch (error52) {
+      process.stderr.write(
+        `[mrrlin-mcp consensus] clarification verdict write failed for ${input.projectSlug}/${input.pageId}: ${error52 instanceof Error ? error52.message : String(error52)}
+`
+      );
+    }
+  }
+  let filedQuestionCount = 0;
+  if (operatorClarifications.length > 0) {
+    const page = await ctx.client.getWikiPage(input.projectSlug, input.pageId);
+    const taskId = page?.taskId ?? null;
+    if (!resolvedTaskId && taskId) resolvedTaskId = taskId;
+    let planId = null;
+    if (!taskId) {
+      const plans = await ctx.client.listPlans(input.projectSlug);
+      planId = plans.find((p) => p.specWikiPageId === input.pageId)?.id ?? null;
+    }
+    if (taskId) {
+      const scopeId = taskId;
+      const groupId = operatorClarifications.length > 1 ? `II-${scopeId}-gate-group-${(0, import_node_crypto9.createHash)("sha256").update(operatorClarifications.map((c) => c.rawQuestion).sort().join("\n")).digest("hex").slice(0, 10)}` : void 0;
+      for (const clarification of operatorClarifications) {
+        const id = `II-${scopeId}-gate-${(0, import_node_crypto9.createHash)("sha256").update(clarification.rawQuestion).digest("hex").slice(0, 10)}`;
+        try {
+          const questionOptions = buildGateQuestionOptions(clarification.rawQuestion, clarification.category);
+          await ctx.client.createInboxItem(input.projectSlug, {
+            id,
+            kind: "question",
+            taskId: scopeId,
+            body: humanizeClarificationBody(clarification),
+            origin: "gate",
+            questionOptions,
+            ...groupId ? { groupId } : {}
+          });
+        } catch {
+        }
+      }
+      filedQuestionCount = operatorClarifications.length;
+    } else if (planId) {
+      const scopeId = planId;
+      const groupId = operatorClarifications.length > 1 ? `II-${scopeId}-gate-group-${(0, import_node_crypto9.createHash)("sha256").update(operatorClarifications.map((c) => c.rawQuestion).sort().join("\n")).digest("hex").slice(0, 10)}` : void 0;
+      for (const clarification of operatorClarifications) {
+        const id = `II-${scopeId}-gate-${(0, import_node_crypto9.createHash)("sha256").update(clarification.rawQuestion).digest("hex").slice(0, 10)}`;
+        try {
+          const questionOptions = buildGateQuestionOptions(clarification.rawQuestion, clarification.category);
+          await ctx.client.createInboxItem(input.projectSlug, {
+            id,
+            kind: "question",
+            planId: scopeId,
+            body: humanizeClarificationBody(clarification),
+            origin: "gate",
+            questionOptions,
+            ...groupId ? { groupId } : {}
+          });
+        } catch {
+        }
+      }
+      filedQuestionCount = operatorClarifications.length;
+    }
+  }
+  let error51;
+  if (filedQuestionCount > 0) {
+    error51 = `Consensus blocked on ${filedQuestionCount} clarification(s); filed as operator question(s).`;
+  } else if (diagnostics.length > 0 && operatorClarifications.length === 0) {
+    error51 = "Consensus blocked: the spec content does not match its linked task. This requires fixing the spec/task relationship directly, not an inbox answer.";
+  } else if (operatorClarifications.length > 0) {
+    error51 = `Consensus blocked on ${operatorClarifications.length} clarification(s), but the spec page is not linked to a task or plan, so none could be filed as questions.`;
+  } else {
+    error51 = "Consensus blocked: reviewers did not converge within budget.";
+  }
+  return {
+    kind: "failed",
+    failureReason: "consensus_blocked",
+    error: error51,
+    filedQuestionCount,
+    ...resolvedTaskId ? { taskId: resolvedTaskId } : {}
+  };
+}
 async function run(ctx, input) {
   const result = await runNativeSpecGate(ctx, input);
   if (process.env[SHADOW_ENV_FLAG]) {
@@ -55243,95 +55426,7 @@ async function run(ctx, input) {
   } catch {
   }
   if (result.outcome === "CONSENSUS_BLOCKED") {
-    const clarifications = result.clarifications ?? [];
-    if (clarifications.length > 0) {
-      try {
-        const page = await ctx.client.getWikiPage(input.projectSlug, input.pageId);
-        if (page) {
-          const domain2 = await resolveSpecDomain(ctx.client, input.projectSlug, {
-            id: page.id,
-            taskId: page.taskId ?? null
-          });
-          await ctx.client.recordSpecConsensusReview(input.projectSlug, input.pageId, {
-            contentHash: domainScopedReviewHash(page.contentHash, domain2),
-            outcome: "CONSENSUS_BLOCKED_CLARIFICATION",
-            rounds: 0
-          });
-        }
-      } catch (error52) {
-        process.stderr.write(
-          `[mrrlin-mcp consensus] clarification verdict write failed for ${input.projectSlug}/${input.pageId}: ${error52 instanceof Error ? error52.message : String(error52)}
-`
-        );
-      }
-    }
-    let filedQuestionCount = 0;
-    if (clarifications.length > 0) {
-      const page = await ctx.client.getWikiPage(input.projectSlug, input.pageId);
-      const taskId = page?.taskId ?? null;
-      if (!resolvedTaskId && taskId) resolvedTaskId = taskId;
-      let planId = null;
-      if (!taskId) {
-        const plans = await ctx.client.listPlans(input.projectSlug);
-        planId = plans.find((p) => p.specWikiPageId === input.pageId)?.id ?? null;
-      }
-      if (taskId) {
-        const scopeId = taskId;
-        const groupId = clarifications.length > 1 ? `II-${scopeId}-gate-group-${(0, import_node_crypto9.createHash)("sha256").update(clarifications.map((c) => c.question).sort().join("\n")).digest("hex").slice(0, 10)}` : void 0;
-        for (const clarification of clarifications) {
-          const id = `II-${scopeId}-gate-${(0, import_node_crypto9.createHash)("sha256").update(clarification.question).digest("hex").slice(0, 10)}`;
-          try {
-            const questionOptions = buildGateQuestionOptions(clarification.question, clarification.category);
-            await ctx.client.createInboxItem(input.projectSlug, {
-              id,
-              kind: "question",
-              taskId: scopeId,
-              body: clarification.question,
-              origin: "gate",
-              questionOptions,
-              ...groupId ? { groupId } : {}
-            });
-          } catch {
-          }
-        }
-        filedQuestionCount = clarifications.length;
-      } else if (planId) {
-        const scopeId = planId;
-        const groupId = clarifications.length > 1 ? `II-${scopeId}-gate-group-${(0, import_node_crypto9.createHash)("sha256").update(clarifications.map((c) => c.question).sort().join("\n")).digest("hex").slice(0, 10)}` : void 0;
-        for (const clarification of clarifications) {
-          const id = `II-${scopeId}-gate-${(0, import_node_crypto9.createHash)("sha256").update(clarification.question).digest("hex").slice(0, 10)}`;
-          try {
-            const questionOptions = buildGateQuestionOptions(clarification.question, clarification.category);
-            await ctx.client.createInboxItem(input.projectSlug, {
-              id,
-              kind: "question",
-              planId: scopeId,
-              body: clarification.question,
-              origin: "gate",
-              questionOptions,
-              ...groupId ? { groupId } : {}
-            });
-          } catch {
-          }
-        }
-        filedQuestionCount = clarifications.length;
-      }
-    }
-    let error51;
-    if (filedQuestionCount > 0) {
-      error51 = `Consensus blocked on ${filedQuestionCount} clarification(s); filed as operator question(s).`;
-    } else if (clarifications.length > 0) {
-      error51 = `Consensus blocked on ${clarifications.length} clarification(s), but the spec page is not linked to a task or plan, so none could be filed as questions.`;
-    } else {
-      error51 = "Consensus blocked: reviewers did not converge within budget.";
-    }
-    return {
-      kind: "failed",
-      failureReason: "consensus_blocked",
-      error: error51,
-      filedQuestionCount,
-      ...resolvedTaskId ? { taskId: resolvedTaskId } : {}
-    };
+    return handleConsensusBlocked(result, ctx, input, resolvedTaskId);
   }
   switch (result.outcome) {
     case "CONVERGED":
@@ -55601,6 +55696,8 @@ var mcpToolNames = {
   updatePlan: "update_plan",
   updateTask: "update_task",
   resetDirectorThread: "reset_director_thread",
+  archiveTask: "archive_task",
+  unarchiveTask: "unarchive_task",
   updateWikiPage: "update_wiki_page",
   markSpecReady: "mark_spec_ready",
   runSpecConsensus: "run_spec_consensus",
@@ -56116,6 +56213,8 @@ var getTaskInputSchema = taskScopedSchema;
 var createTaskInputSchema = projectScopedSchema.merge(mrrlinTaskCreateSchema);
 var updateTaskInputSchema = taskScopedSchema.merge(mrrlinTaskUpdateSchema);
 var resetDirectorThreadInputSchema = taskScopedSchema;
+var archiveTaskInputSchema = taskScopedSchema;
+var unarchiveTaskInputSchema = taskScopedSchema;
 var listPlansInputSchema = projectScopedSchema;
 var createPlanInputSchema = projectScopedSchema.merge(mrrlinPlanCreateSchema);
 var updatePlanInputSchema = planScopedSchema.merge(mrrlinPlanUpdateSchema);
@@ -56268,6 +56367,8 @@ var mcpToolInputSchemas = {
   [mcpToolNames.updatePlan]: updatePlanInputSchema,
   [mcpToolNames.updateTask]: updateTaskInputSchema,
   [mcpToolNames.resetDirectorThread]: resetDirectorThreadInputSchema,
+  [mcpToolNames.archiveTask]: archiveTaskInputSchema,
+  [mcpToolNames.unarchiveTask]: unarchiveTaskInputSchema,
   [mcpToolNames.updateWikiPage]: updateWikiPageInputSchema,
   [mcpToolNames.markSpecReady]: markSpecReadyInputSchema,
   [mcpToolNames.runSpecConsensus]: runSpecConsensusInputSchema,
@@ -56331,6 +56432,8 @@ var mcpToolOperationIds = {
   [mcpToolNames.updatePlan]: openApiOperationIds.updatePlan,
   [mcpToolNames.updateTask]: openApiOperationIds.updateTask,
   [mcpToolNames.resetDirectorThread]: openApiOperationIds.resetDirectorThread,
+  [mcpToolNames.archiveTask]: openApiOperationIds.archiveTask,
+  [mcpToolNames.unarchiveTask]: openApiOperationIds.unarchiveTask,
   [mcpToolNames.updateWikiPage]: openApiOperationIds.updateWikiPage,
   [mcpToolNames.markSpecReady]: openApiOperationIds.markSpecReady,
   [mcpToolNames.listInboxItems]: openApiOperationIds.listInboxItems,
@@ -56378,6 +56481,8 @@ var mcpToolDescriptions = {
   [mcpToolNames.updatePlan]: "Update a plan/epic.",
   [mcpToolNames.updateTask]: "Update a task. Honors DB invariants: closed_no_result requires linked Evidence wiki pages. Set directorThreadId here to persist the worker's resumable provider thread handle.",
   [mcpToolNames.resetDirectorThread]: "Clear a task's persisted Director execution thread handle so the next execution run starts a fresh provider thread. Records a director_thread_reset task event.",
+  [mcpToolNames.archiveTask]: "Archive a task: hides it from default reads, removes it from plan progress and scheduler consideration, cancels its non-terminal execution runs, and closes its open inbox items. Reversible \u2014 the project owner can restore it with unarchive_task. Records an 'archived' task event.",
+  [mcpToolNames.unarchiveTask]: "Restore an archived task to its original status and visibility. Owner-only \u2014 refused with NOT_PROJECT_OWNER for any other caller. Does not resurrect the execution runs or inbox items that were cancelled/closed when the task was archived. Records a 'restored' task event.",
   [mcpToolNames.updateWikiPage]: "Update a markdown Wiki page.",
   [mcpToolNames.markSpecReady]: "Mark a wiki page (folder=Specs) as ready (or not) for execution-run gating. The Director sets this true after validating the spec; any edit to the page's markdown auto-resets it to false.",
   [mcpToolNames.runSpecConsensus]: 'Enqueue the consensus review gate over a Specs/{id} page. Returns IMMEDIATELY with one of: already_converged (a CONVERGED review already exists for the current content \u2014 proceed straight to create_execution_run, do NOT call mark_spec_ready, it is already set), already_reviewed (a terminal CONSENSUS_BLOCKED for this content), already_running (a consensus job is in flight), or queued (a new job was launched). The review runs in the background; its result/blocker arrives in the inbox (info on CONVERGED, handoff on failure) and is surfaced into the open chat. Do NOT call again for the same spec and do NOT poll. On queued/already_running, tell the user it was launched and end the turn. Pass extraHeads: ["researcher"] for specs referencing external libraries/APIs, or ["debugger"] for root-cause/investigation specs to add opt-in specialist reviewers on top of the fixed four. For a NON-code task (domain seo/marketing/content, ADR 0020): the low-risk lanes `seo`, `marketing`, and `content` proceed to `create_execution_run` after consensus, using the same flow as code tasks. Report the spec\'s review outcome to the operator.',
@@ -56808,6 +56913,20 @@ function createMrrlinTools(options) {
       "Unable to reset director thread.",
       async (c, { projectSlug, taskId }) => await c.resetDirectorThread(projectSlug, taskId)
     ),
+    [mcpToolNames.archiveTask]: makeTool(
+      client,
+      mcpToolNames.archiveTask,
+      "TASK_ARCHIVE_FAILED",
+      "Unable to archive task.",
+      async (c, { projectSlug, taskId }) => await c.archiveTask(projectSlug, taskId)
+    ),
+    [mcpToolNames.unarchiveTask]: makeTool(
+      client,
+      mcpToolNames.unarchiveTask,
+      "TASK_UNARCHIVE_FAILED",
+      "Unable to unarchive task.",
+      async (c, { projectSlug, taskId }) => await c.unarchiveTask(projectSlug, taskId)
+    ),
     [mcpToolNames.updateWikiPage]: makeTool(
       client,
       mcpToolNames.updateWikiPage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrlin-dev/mcp",
-  "version": "0.3.54",
+  "version": "0.3.55",
   "type": "module",
   "bin": {
     "mrrlin-mcp": "dist/bin.cjs"
@@ -21,12 +21,12 @@
     "@types/ws": "^8.18.1",
     "esbuild": "^0.24.0",
     "tsx": "^4.22.3",
-    "@mrrlin/director-e2e": "0.0.0",
-    "@mrrlin/schemas": "0.0.0",
     "@mrrlin/client": "0.0.0",
-    "@mrrlin/wiki": "0.0.0",
+    "@mrrlin/codex-client": "0.0.0",
     "@mrrlin/tsconfig": "0.0.0",
-    "@mrrlin/codex-client": "0.0.0"
+    "@mrrlin/director-e2e": "0.0.0",
+    "@mrrlin/schemas": "0.0.0",
+    "@mrrlin/wiki": "0.0.0"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",