@agentistics/mcp 2.203.1 → 2.204.0

package/dist/agentistics-mcp.js

@@ -23,6 +23,43 @@ function liveDeliveryQuery(a) {
   return q.toString() ? `?${q}` : "";
 }
 
+// delivery-calendar-args.ts
+var CALENDAR_STAGES = ["queue", "blocked", "running", "qa", "adjust", "leader", "merge", "ci", "published"];
+var CALENDAR_PRIORITIES = ["urgent", "high", "medium", "low"];
+function list(v, allowed) {
+  const items = (Array.isArray(v) ? v : typeof v === "string" ? v.split(",") : []).filter((x) => typeof x === "string").map((x) => x.trim()).filter(Boolean);
+  return (allowed ? items.filter((x) => allowed.includes(x)) : items).join(",");
+}
+function deliveryCalendarQuery(a) {
+  const q = new URLSearchParams;
+  const task = typeof a?.task === "string" ? a.task.trim() : "";
+  if (task)
+    q.set("task", task);
+  const subtask = typeof a?.subtask === "string" ? a.subtask.trim() : "";
+  if (subtask)
+    q.set("subtask", subtask);
+  for (const [key, value] of [
+    ["version", list(a?.version)],
+    ["stage", list(a?.stage, CALENDAR_STAGES)],
+    ["harness", list(a?.harness)],
+    ["priority", list(a?.priority, CALENDAR_PRIORITIES)]
+  ])
+    if (value)
+      q.set(key, value);
+  for (const key of ["from", "to"]) {
+    const v = a?.[key];
+    if (typeof v === "string" && v.trim())
+      q.set(key, v.trim());
+  }
+  if (a?.all === true)
+    q.set("all", "1");
+  if (a?.confirmedOnly === true)
+    q.set("confirmed", "1");
+  if (a?.format === "ics")
+    q.set("format", "ics");
+  return q.toString() ? `?${q}` : "";
+}
+
 // ../core/src/local-models.ts
 var LOCAL_RUNTIME_PREFIXES = [
   "ollama",
@@ -967,6 +1004,7 @@ var AGENT_TOOL_POLICY = {
   agentistics_task_claim: { ...TASKS, risk: "W", routes: ["POST /api/tasks/:ref/claim"], reason: "a lease that expires on its own and can be released" },
   agentistics_task_activity: { ...TASKS, risk: "R", routes: ["GET /api/tasks/activity"], reason: "reads the board activity log" },
   agentistics_live_delivery: { ...TASKS, risk: "R", routes: ["GET /api/tasks/live"], reason: "reads the live delivery line and the leaders band; changes nothing" },
+  agentistics_delivery_calendar: { ...TASKS, risk: "R", routes: ["GET /api/deliveries/calendar"], reason: "reads the delivery calendar (dates, versions, ETAs); changes nothing" },
   agentistics_task_edit: { ...TASKS, risk: "W", routes: ["POST /api/tasks/:ref"], reason: "edits task fields; reversible by another edit" },
   agentistics_task_session: {
     ...TASKS,
@@ -1008,7 +1046,7 @@ var AGENT_TOOL_POLICY = {
   agentistics_task_phase: {
     ...TASKS,
     risk: "W",
-    routes: ["GET /api/deliveries", "GET /api/deliveries/:subtask", "POST /api/deliveries/:subtask", "POST /api/deliveries/release", "POST /api/deliveries/reconcile"],
+    routes: ["GET /api/deliveries", "GET /api/deliveries/:subtask", "POST /api/deliveries/:subtask", "POST /api/deliveries/release", "POST /api/deliveries/reconcile", "POST /api/deliveries/antigas"],
     reason: "reads or moves a delivery through the fixed phase table; release declares which pieces a release shipped (leader/owner only; the host still reads the green run and the tag); reconcile backfills merged/released pieces (dry run unless apply, leader/owner only); a skipped phase is refused (422 fase_pulada) and every gate is checked by the host from evidence, never from the caller"
   },
   agentistics_task_stage: {
@@ -1224,6 +1262,10 @@ var GO_WINDOW_MS = {
 function isFlowRunId(id) {
   return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(id);
 }
+// ../core/src/deliveryCalendar.ts
+var BRT_OFFSET_MS = -3 * 3600000;
+var RECENT_ACTIVITY_MS = 24 * 3600000;
+var BLIP_MS = 15 * 60000;
 // ../core/src/vaultPassword.ts
 var VAULT_PASSWORD_RULES = ["length", "upper", "special", "digit"];
 var VAULT_PASSWORD_MIN_LENGTH = 9;
@@ -2153,6 +2195,12 @@ var CATALOG = [
   { id: "sessions.highlights", label: "Highlights", category: "sessions", defaultW: 12, defaultH: 6, minW: 6, minH: 3, description: "Record-breaking sessions" },
   { id: "sessions.recent", label: "Recent sessions", category: "sessions", defaultW: 12, defaultH: 7, minW: 6, minH: 4, description: "List of most recent sessions" }
 ];
+async function apiGetText(path) {
+  const res = await fetch(`${API}${path}`);
+  if (!res.ok)
+    throw new Error(`agentistics API ${path} → HTTP ${res.status}`);
+  return res.text();
+}
 async function apiGet(path) {
   const res = await fetch(`${API}${path}`);
   if (!res.ok)
@@ -2486,7 +2534,7 @@ var TOOLS = [
       type: "object",
       properties: {
         task: { type: "string", description: "A task id or part of its title." },
-        stage: { type: "string", enum: ["queue", "running", "qa", "adjust", "leader", "merge", "published"] },
+        stage: { type: "string", enum: ["queue", "blocked", "running", "qa", "adjust", "leader", "merge", "ci", "completed", "published"] },
         stalledOnly: { type: "boolean", description: "Only deliveries that need a person, lost an agent or are blocked." },
         tab: { type: "string", enum: ["active", "queue", "published", "all"], description: "The screen's tab: active (Em andamento), queue (Na fila), published (Publicado) or all (Tudo). Default all." },
         period: { type: "string", enum: ["24h", "7d", "30d", "all"], description: "How far back Publicado reaches. Default 24h." },
@@ -2551,13 +2599,38 @@ var TOOLS = [
     description: "Delete a task and its comments, subtasks, files and links. The SESSIONS filed under it are kept — deleting a board entry never deletes work.",
     inputSchema: { type: "object", properties: { ref: { type: "string" } }, required: ["ref"] }
   },
+  {
+    name: "agentistics_delivery_calendar",
+    description: "BETA. The DELIVERY CALENDAR — when each piece of work started, when it is expected to ship, which release version it rides and when a version really went out; the same source and rules as the \"Calendário de entregas\" screen (`agentop flow calendario` prints the same). Returns `pieces` (task, subtask, stage, `version`, harness/model, priority, `startedAtMs`, `stageEta` and `publishEta` — `kind: none` means there is NO estimate: say so, never invent a time — `publishedAtMs`, `dueDate`, `confirmed`, `late`), `versions` (each with `state` published|planned, `atMs` = the real publication or the LATEST piece estimate, `basis` published|estimate|partial|none, the pieces and the count per stage) and `marks` (an account's usage window renewing, a task's due day). Times are epoch ms; day arguments are BRT days (America/Sao_Paulo). By default only pieces of tasks being worked on now; pass `all` for the history too. Filters: `task` (id or part of the title), `subtask`, `version` (one or a list), `stage`, `harness`, `priority`, `from`/`to` (yyyy-MM-dd or an ISO instant — keeps what touches the period), `confirmedOnly` (published or a medium/high-confidence estimate). `format: \"ics\"` returns the filtered view as an .ics file instead of JSON.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task: { type: "string", description: "A task id or part of its title." },
+        subtask: { type: "string", description: "A subtask id." },
+        version: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }], description: "A release version (2.202.0) or a list." },
+        stage: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }], description: "queue, blocked, running, qa, adjust, leader, merge, ci, published — one or a list." },
+        harness: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+        priority: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }], description: "urgent, high, medium, low." },
+        from: { type: "string", description: "Start of the period: yyyy-MM-dd (BRT) or an ISO instant." },
+        to: { type: "string", description: "End of the period (inclusive)." },
+        all: { type: "boolean", description: "Include pieces of tasks not being worked on now (history)." },
+        confirmedOnly: { type: "boolean", description: "Only published pieces or those with a medium/high-confidence estimate." },
+        format: { type: "string", enum: ["json", "ics"] }
+      },
+      required: []
+    }
+  },
   {
     name: "agentistics_task_phase",
     description: "FLUXO.CICLO-COMPLETO — the minute `tick` also moves a piece in revisao_lider or pr_merge to ci BY ITSELF once its PR is merged (found from the piece's PR number, branch, the PR containing the sha QA approved, or its author worktree's branch; the merge gates `delecoes` + `mergeado` still run, and a refusal leaves the piece where it is with the reason), publishes ci pieces from the FIRST tag that contains the merge, and reminds the LIVE leader of the task (never the owner) of a piece waiting on them for 30 min, then every 2 h, at most 3 times. `get` with a `subtaskId` returns `tickReason`: why the tick has not moved it. `reconcile` (no `subtaskId`; `apply` true to write) is the one-shot BACKFILL: every piece in revisao_lider/pr_merge/ci matched to its merged PR and the first release tag containing it — a report of what moves and what cannot be proven, with the reason. " + "`tick` also enables the mandatory owner-request/placement flows through the official engine switches and reads canonical pedidos; after 10 minutes without complete staging it wakes the current live task leader, including after a handoff or restart, and never asks the owner. " + "Queue actions: `dequeue` withdraws a queued piece with a required free-text `reason` (task leader or owner only), keeps the draft/history, and refuses dispatch until explicitly restaged; `tick` reconciles stale queued pieces against board review/done/abandoned and records a comment. Vacancy counts live backend processes; lost/exited/closed sessions reserve no slots. " + "FLUXO.ENTREGA-DSL — read or move a DELIVERY (one subtask) through its fixed phases: fila → executando → qa → (ajuste ⇄ qa) → revisao_lider → pr_merge → ci → publicado, plus bloqueado (from any phase, back to the stored origin only). Any transition outside that table is REFUSED (422 `fase_pulada`) with a sentence naming what is missing — executando → revisao_lider, ajuste → revisao_lider and every other skip included. The gates each edge needs are run BY THE SERVER from evidence (predispatch, vaga, salvo = sha on origin per ls-remote, qa-modelo = QA model ≠ author model from the registry and never Sonnet over Sonnet, cabeca = the pushed branch is still at the sha QA tested, delecoes = no file deleted outright by the PR, mergeado = gh says the PR is MERGED, the merge commit is on origin/main and the PR head is the sha QA approved — the merge sha is READ FROM THE PR, never from you, release = the batch's version tag exists AND the release.yml run that produced it is green, read in the repository the release recorded); salvo needs every check run on the pushed head to have concluded green (pending or absent refuse); you never pass proof. `action`: `get` (default; omit `subtaskId` to list every delivery) | `phase` (`to` + what that edge reads: `verdict` APROVADO/REPROVADO + `findings` from qa, `reviewedSha` = the sha QA approved for revisao_lider → pr_merge, `detail` for a request for change or a failure reason) | `gate` (`name`: run ONE gate and record its evidence) | `block` (`reason` one of dependencia, pedido_de_bloqueio, limite, maquina, externo, fora_das_autorizacoes; `text`) | `unblock` (`detail`; the leader of the task or the owner — an owner-decision block only the owner) | `step` (`step` 1..9: the step of the current phase, for the Live %. The Live already DERIVES the step from real signals — a session open, a file edit, a test run, a commit, the gates, the PR — so report only when you know better; the card shows the larger of the two and says which it is. Works for a legacy piece with no delivery record too: only the board's `step` event is written, nothing is adopted into the flow) | `configure` (the LEADER of the task or the owner only; `patch`: versionTarget, humanGates [phases needing the owner's approval — skipped and recorded as 'pulado: modo autônomo' while autonomous mode is on], leaderSessionId, pr, tag, allowDeletions {paths, reason}; the QA and author sessions are never settable — the host records them from the sessions it opened and the registry) | `approve` (`phase`, `decision` approve|reject, `note`: answers a human gate the owner was ASKED about; a session identity is deliberately not sent, the owner answers through this same door as the Live card button and `agentop flow approve`) | `stage-run` (predispatch + vaga gates, then start the staged session and move to executando) | `merge` (delecoes gate, squash-merge the PR, move to ci; a failure goes back to revisao_lider) | `release` (the LEADER of the task or the owner DECLARES what a release contains: `version` x.y.z, `mergeSha` = the commit on main carrying it (information only; 40 characters, or a short sha the server resolves), optional `repo` = owner/name (default agentistics/agentistics), `subtaskIds` = every piece in it; no `subtaskId`. Each piece gets its record (a legacy one is adopted), versionTarget/mergeSha/tag/repo, goes to ci and then to publicado as soon as the tag `v<version>` exists and the release.yml run that produced it is green — read by the server from the TAG, not from the sha — with the release's own publish time; a declared piece is never sent back to revisao_lider by the tick (a red tag run keeps it in ci and wakes the leader once); done/abandoned/blocked/unknown/other-task pieces refuse the whole batch, which is written in ONE store write; a second run changes nothing). In autonomous mode nothing here ever asks or waits for the owner.",
     inputSchema: {
       type: "object",
       properties: {
-        action: { type: "string", enum: ["get", "phase", "gate", "block", "unblock", "dequeue", "tick", "step", "configure", "approve", "stage-run", "merge", "release", "reconcile"] },
+        action: { type: "string", enum: ["get", "phase", "gate", "block", "unblock", "dequeue", "tick", "step", "configure", "approve", "stage-run", "merge", "release", "reconcile", "antigas"] },
+        antigasAction: { type: "string", enum: ["publish", "archive", "conclude"], description: "antigas: 'conclude' (the screen's one click) completes the pieces with a session and archives the ones without; add `preview` to read the counts without changing anything. 'publish' marks the old record-less pieces published (optional `version`), 'archive' abandons them with an optional `reason`. Targets: `subtaskIds`, or `all` = every piece the reconcile classifies as antiga. Never deletes; a leader or the owner" },
+        preview: { type: "boolean", description: "antigas conclude: only count what the click would do (concluded vs archived); changes nothing" },
+        all: { type: "boolean", description: 'antigas: act on every old piece in the group "Antigas sem registro" (answers from the board at once; a piece the last reconcile proved is left out)' },
+        expect: { type: "number", description: "antigas: the size of the group you saw; a different size refuses (409 count_changed) and nothing changes" },
         apply: { type: "boolean", description: "reconcile: write the moves (a leader of the task, or the owner). Absent/false = dry run: the report only" },
         subtaskId: { type: "string" },
         version: { type: "string", description: "release: the version the pieces shipped in, x.y.z" },
@@ -2573,7 +2646,7 @@ var TOOLS = [
         phase: { type: "string", description: "approve: the phase whose human gate is answered" },
         decision: { type: "string", enum: ["approve", "reject"] },
         note: { type: "string" },
-        reason: { type: "string", description: "dequeue: required free-text audit reason (leader only); block: dependencia | pedido_de_bloqueio | limite | maquina | externo | fora_das_autorizacoes" },
+        reason: { type: "string", description: "dequeue: required free-text audit reason (leader only); block: dependencia | pedido_de_bloqueio | limite | maquina | externo | fora_das_autorizacoes; antigas archive: why (kept in the comment)" },
         text: { type: "string" },
         step: { type: "number" },
         patch: { type: "object" }
@@ -3202,6 +3275,13 @@ async function callTool(req) {
         const body = await apiSend("DELETE", `/api/tasks/${encodeURIComponent(ref)}`);
         return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
       }
+      case "agentistics_delivery_calendar": {
+        const q = deliveryCalendarQuery(args);
+        if (args?.format === "ics")
+          return { content: [{ type: "text", text: await apiGetText(`/api/deliveries/calendar${q}`) }] };
+        const body = await apiGet(`/api/deliveries/calendar${q}`);
+        return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+      }
       case "agentistics_task_phase": {
         const a = args ?? {};
         const action = typeof a.action === "string" ? a.action : "get";
@@ -3223,6 +3303,19 @@ async function callTool(req) {
           const body = await apiSend("POST", "/api/deliveries/reconcile", { apply: a.apply === true, session: sessionProof(process.env) });
           return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
         }
+        if (action === "antigas") {
+          const body = await apiSend("POST", "/api/deliveries/antigas", {
+            action: a.antigasAction,
+            ids: a.subtaskIds,
+            all: a.all === true,
+            preview: a.preview === true,
+            expect: a.expect,
+            version: a.version,
+            reason: a.reason,
+            session: sessionProof(process.env)
+          });
+          return { content: [{ type: "text", text: JSON.stringify(body, null, 2) }] };
+        }
         if (action !== "tick" && (typeof a.subtaskId !== "string" || !a.subtaskId))
           throw new Error("subtaskId is required");
         const { subtaskId: _s, action: _a, ...rest } = a;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentistics/mcp",
-  "version": "2.203.1",
+  "version": "2.204.0",
   "description": "Agentistics MCP server — Claude Code analytics for Claude Desktop and Claude Code",
   "type": "module",
   "main": "./dist/agentistics-mcp.js",