@noclaf/cli 0.6.0 → 0.7.0

package/dist/lib/calendar-logic.js

@@ -0,0 +1,59 @@
+import { FINISHED_STATUSES } from '../core/types.js';
+const pad = (n) => String(n).padStart(2, '0');
+const iso = (d) => `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+/** Datas YYYY-MM-DD de `from` a `to`, inclusive. */
+export function eachDay(from, to) {
+    const out = [];
+    for (let d = new Date(`${from}T00:00:00Z`); iso(d) <= to; d.setUTCDate(d.getUTCDate() + 1))
+        out.push(iso(d));
+    return out;
+}
+const isLeap = (y) => (y % 4 === 0 && y % 100 !== 0) || y % 400 === 0;
+/** Ocorrência anual (mês/dia de `origin`) em `date`; 29/02 cai em 28/02 em ano não bissexto. Devolve anos desde a origem. */
+export function yearsOn(origin, date) {
+    if (!origin)
+        return null;
+    const [oy, om, od] = origin.split('-').map(Number);
+    const [y, m, d] = date.split('-').map(Number);
+    const day = om === 2 && od === 29 && !isLeap(y) ? 28 : od;
+    return om === m && day === d ? y - oy : null;
+}
+/** Monta os dias com eventos (só dias não vazios), agrupados por data. */
+export function buildCalendar(from, to, s) {
+    const byDay = new Map();
+    const add = (date, ev) => {
+        if (date < from || date > to)
+            return;
+        const list = byDay.get(date);
+        if (list)
+            list.push(ev);
+        else
+            byDay.set(date, [ev]);
+    };
+    for (const h of s.holidays)
+        add(h.date, { kind: 'holiday', id: h.id, name: h.name, type: h.type, scope: h.scope });
+    for (const t of s.deadlines) {
+        if (FINISHED_STATUSES.includes(t.status))
+            continue;
+        add(t.end_date, { kind: 'deadline', key: t.key, title: t.title, status: t.status, project: t.project });
+    }
+    for (const v of s.vacations) {
+        for (const d of eachDay(v.start_date, v.end_date))
+            add(d, { kind: 'vacation', id: v.id, person: v.person, notes: v.notes });
+    }
+    for (const h of s.homeOffice)
+        add(h.date, { kind: 'home_office', person: h.person });
+    for (const r of s.releases)
+        add(r.target_date, { kind: 'release', name: r.name, status: r.status });
+    for (const d of eachDay(from, to)) {
+        for (const p of s.people) {
+            if (yearsOn(p.birth_date, d) !== null)
+                add(d, { kind: 'birthday', person: p.name });
+            const y = yearsOn(p.company_anniversary_date, d);
+            if (y !== null && y > 0)
+                add(d, { kind: 'work_anniversary', person: p.name, years: y });
+        }
+    }
+    return [...byDay.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([date, events]) => ({ date, events }));
+}
+//# sourceMappingURL=calendar-logic.js.map

package/dist/lib/calendar-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-logic.js","sourceRoot":"","sources":["../../src/lib/calendar-logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAA8D,MAAM,kBAAkB,CAAC;AAEjH,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACtD,MAAM,GAAG,GAAG,CAAC,CAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AAEpG,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,EAAU;IAC9C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;AAE9E,6HAA6H;AAC7H,MAAM,UAAU,OAAO,CAAC,MAAqB,EAAE,IAAY;IACzD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,OAAO,EAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,EAAU,EAAE,CAAkB;IACxE,MAAM,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjD,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAiB,EAAE,EAAE;QAC9C,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,EAAE;YAAE,OAAO;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;;YACnB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;QAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACnH,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAC5B,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,SAAS;QACnD,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC;YAAE,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9H,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU;QAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;QAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACpG,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YACzB,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,IAAI;gBAAE,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACpF,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,wBAAwB,EAAE,CAAC,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;gBAAE,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AAC9H,CAAC"}

package/dist/lib/calendar-write-logic.js

@@ -0,0 +1,6 @@
+/** Regras puras da escrita no calendário. */
+/** DELETE negado por RLS afeta 0 linhas sem erro: 0 vira mensagem amigável; null se ok. */
+export function deleteFailure(rows, what) {
+    return rows && rows.length > 0 ? null : `${what} não encontrado ou sem permissão.`;
+}
+//# sourceMappingURL=calendar-write-logic.js.map

package/dist/lib/calendar-write-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-write-logic.js","sourceRoot":"","sources":["../../src/lib/calendar-write-logic.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAE7C,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,IAAsB,EAAE,IAAY;IAChE,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,mCAAmC,CAAC;AACrF,CAAC"}

package/dist/lib/dates.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/** Hoje em YYYY-MM-DD, fuso local. */
+export function todayStr(now = new Date()) {
+    const p = (n) => String(n).padStart(2, '0');
+    return `${now.getFullYear()}-${p(now.getMonth() + 1)}-${p(now.getDate())}`;
+}
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+/** YYYY-MM-DD real (rejeita 2026-02-31 por round-trip). */
+export function isIsoDate(s) {
+    if (!DATE_RE.test(s))
+        return false;
+    const d = new Date(`${s}T00:00:00Z`);
+    return !Number.isNaN(d.getTime()) && d.toISOString().slice(0, 10) === s;
+}
+/** Schema zod de data ISO válida, compartilhado pelas tools. */
+export const isoDate = z.string().refine(isIsoDate, 'use uma data real no formato YYYY-MM-DD');
+/** Erro se início > fim (ISO, comparação lexicográfica); null se ok ou se faltar um lado. */
+export function dateRangeError(start, end) {
+    return start && end && start > end ? `Intervalo inválido: início (${start}) deve ser <= fim (${end}).` : null;
+}
+//# sourceMappingURL=dates.js.map

package/dist/lib/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/lib/dates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sCAAsC;AACtC,MAAM,UAAU,QAAQ,CAAC,MAAY,IAAI,IAAI,EAAE;IAC7C,MAAM,CAAC,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,2DAA2D;AAC3D,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,yCAAyC,CAAC,CAAC;AAE/F,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,KAAqB,EAAE,GAAmB;IACvE,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,+BAA+B,KAAK,sBAAsB,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAChH,CAAC"}

package/dist/lib/pg-error.js

@@ -32,6 +32,10 @@ const RULES = [
         re: /null value in column "([^"]+)" of relation "([^"]+)" violates not-null constraint/i,
         text: (m) => `o campo obrigatório "${m[1]}" de ${m[2]} veio vazio — preencha antes de repetir`,
     },
+    {
+        re: /new row violates row-level security policy(?: for table "[^"]+")?/i,
+        text: () => 'sem permissão pra essa ação (seu papel não permite escrever aqui)',
+    },
 ];
 /**
  * Reescreve o trecho cru do Postgres dentro da mensagem, preservando o resto

package/dist/lib/pg-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"pg-error.js","sourceRoot":"","sources":["../../src/lib/pg-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4FAA4F;AAC5F,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAAc;IACtD,MAAM,YAAY,GAAG,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjG,OAAO,YAAY,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,KAAK,GAA4D;IACrE;QACE,EAAE,EAAE,mGAAmG;QACvG,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACV,sCAAsC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK;YAC5F,qDAAqD;KACxD;IACD;QACE,EAAE,EAAE,2DAA2D;QAC/D,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACV,mDAAmD,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;YAClF,oDAAoD;KACvD;IACD;QACE,EAAE,EAAE,8GAA8G;QAClH,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACV,0BAA0B,CAAC,CAAC,CAAC,CAAC,YAAY,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;YAC/E,yDAAyD;KAC5D;IACD;QACE,EAAE,EAAE,oFAAoF;QACxF,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,yCAAyC;KAC/F;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"pg-error.js","sourceRoot":"","sources":["../../src/lib/pg-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,4FAA4F;AAC5F,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAAc;IACtD,MAAM,YAAY,GAAG,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjG,OAAO,YAAY,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACvF,CAAC;AAED,MAAM,KAAK,GAA4D;IACrE;QACE,EAAE,EAAE,mGAAmG;QACvG,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACV,sCAAsC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK;YAC5F,qDAAqD;KACxD;IACD;QACE,EAAE,EAAE,2DAA2D;QAC/D,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACV,mDAAmD,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;YAClF,oDAAoD;KACvD;IACD;QACE,EAAE,EAAE,8GAA8G;QAClH,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CACV,0BAA0B,CAAC,CAAC,CAAC,CAAC,YAAY,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO;YAC/E,yDAAyD;KAC5D;IACD;QACE,EAAE,EAAE,oFAAoF;QACxF,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,yCAAyC;KAC/F;IACD;QACE,EAAE,EAAE,oEAAoE;QACxE,IAAI,EAAE,GAAG,EAAE,CAAC,mEAAmE;KAChF;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/release-logic.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+/** Status aceitos no update; `delivered` só via finalize. */
+export const UPDATABLE_RELEASE_STATUS = z.enum(['planning', 'in_progress', 'cancelled']);
+/** Garante que a release é do projeto; erro acionável senão. */
+export async function assertReleaseInProject(gw, projectId, releaseId) {
+    if (!(await gw.findRelease(projectId, releaseId))) {
+        throw new Error('Release não encontrada neste projeto. Use list_releases pra ver os ids válidos.');
+    }
+}
+//# sourceMappingURL=release-logic.js.map

package/dist/lib/release-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-logic.js","sourceRoot":"","sources":["../../src/lib/release-logic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAEzF,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAuC,EAAE,SAAiB,EAAE,SAAiB;IACxH,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;AACH,CAAC"}

package/dist/lib/sprint-logic.js

@@ -0,0 +1,31 @@
+import { FINISHED_STATUSES } from '../core/types.js';
+/** Plano de encerramento: quem volta pro backlog e quem fica. Pura. */
+export function planSprintEnd(tasks) {
+    const toBacklog = [];
+    const kept = [];
+    for (const t of tasks)
+        (FINISHED_STATUSES.includes(t.status) ? kept : toBacklog).push(t.id);
+    return { toBacklog, kept };
+}
+/** Contagem por status + vencidas (end_date < hoje, fora de done/production). Pura. */
+export function summarizeSprintTasks(tasks, today) {
+    const by_status = {};
+    for (const t of tasks)
+        by_status[t.status] = (by_status[t.status] ?? 0) + 1;
+    const overdue = tasks
+        .filter((t) => t.end_date && t.end_date < today && !FINISHED_STATUSES.includes(t.status))
+        .map(({ key, title, end_date }) => ({ key, title, end_date }));
+    return { total: tasks.length, by_status, overdue };
+}
+/** Encerra a sprint: tasks primeiro, sprint depois. Já encerrada = no-op (preserva end_date). */
+export async function closeSprint(gw, sprint, today) {
+    if (sprint.status === 'encerrada') {
+        return { sprint, already_closed: true, returned_to_backlog: 0, kept_done: 0 };
+    }
+    const tasks = await gw.listSprintTasks(sprint.id);
+    const { toBacklog, kept } = planSprintEnd(tasks);
+    await gw.returnTasksToBacklog(toBacklog);
+    const updated = await gw.updateSprint(sprint.id, { status: 'encerrada', end_date: today });
+    return { sprint: updated, already_closed: false, returned_to_backlog: toBacklog.length, kept_done: kept.length };
+}
+//# sourceMappingURL=sprint-logic.js.map

package/dist/lib/sprint-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sprint-logic.js","sourceRoot":"","sources":["../../src/lib/sprint-logic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAsC,MAAM,kBAAkB,CAAC;AAEzF,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,KAAsB;IAClD,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5F,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC7B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,oBAAoB,CAAC,KAAsB,EAAE,KAAa;IACxE,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,KAAK;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,GAAG,KAAK,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;SACxF,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAiB,EAAE,MAAiB,EAAE,KAAa;IACnF,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3F,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,mBAAmB,EAAE,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACnH,CAAC"}

package/dist/tools/activate-sprint.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { jsonResult, errorResult } from '../lib/tool-result.js';
+import { resolveProjectConfig, isErrorResult } from '../lib/require-config.js';
+import { closeSprint } from '../lib/sprint-logic.js';
+import { todayStr } from '../lib/dates.js';
+import { brand } from '../brand.js';
+import { projectIdProp } from './sprint-common.js';
+const ArgsSchema = z.object({ sprint_id: z.uuid(), project_id: z.uuid().optional() }).strict();
+export const definition = {
+    name: `${brand.toolPrefix}activate_sprint`,
+    description: 'Reativa uma sprint: encerra qualquer outra ativa do projeto (tasks não concluídas voltam pro backlog) ' +
+        'e reabre a escolhida com status "ativa", start_date = hoje e end_date = null (como a UI).',
+    inputSchema: {
+        type: 'object',
+        properties: { sprint_id: { type: 'string', format: 'uuid' }, project_id: projectIdProp },
+        required: ['sprint_id'],
+        additionalProperties: false,
+    },
+};
+export async function handler(args, ctx) {
+    const parsed = ArgsSchema.safeParse(args);
+    if (!parsed.success)
+        return errorResult(`Argumento inválido: ${parsed.error.message}`);
+    const cfg = resolveProjectConfig(ctx, parsed.data.project_id);
+    if (isErrorResult(cfg))
+        return cfg;
+    try {
+        const gw = ctx.gateway;
+        const target = await gw.findSprint(cfg.project_id, parsed.data.sprint_id);
+        if (!target)
+            return errorResult('Sprint não encontrada neste projeto.');
+        if (target.status === 'ativa')
+            return jsonResult({ ok: true, sprint: target, already_active: true });
+        const today = todayStr();
+        const active = await gw.findSprint(cfg.project_id, 'active');
+        const closed = active && active.id !== target.id ? await closeSprint(gw, active, today) : undefined;
+        const sprint = await gw.updateSprint(target.id, { status: 'ativa', start_date: today, end_date: null });
+        return jsonResult({ ok: true, sprint, ...(closed && { closed_previous: closed }) });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+}
+//# sourceMappingURL=activate-sprint.js.map

package/dist/tools/activate-sprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activate-sprint.js","sourceRoot":"","sources":["../../src/tools/activate-sprint.ts"],"names":[],"mappings":"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"}

package/dist/tools/add-holiday.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { jsonResult, errorResult } from '../lib/tool-result.js';
+import { brand } from '../brand.js';
+import { isoDate } from '../lib/dates.js';
+const ArgsSchema = z
+    .object({
+    date: isoDate,
+    name: z.string().trim().min(1),
+    type: z.enum(['full', 'half']).default('full'),
+    scope: z.enum(['national', 'state', 'municipal']).default('national'),
+})
+    .strict();
+export const definition = {
+    name: `${brand.toolPrefix}add_holiday`,
+    description: 'Cria feriado no calendário do time (só admin/gerente).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            date: { type: 'string', description: 'Data (YYYY-MM-DD).' },
+            name: { type: 'string', description: 'Nome do feriado.' },
+            type: { type: 'string', enum: ['full', 'half'], description: 'Padrão full.' },
+            scope: { type: 'string', enum: ['national', 'state', 'municipal'], description: 'Padrão national.' },
+        },
+        required: ['date', 'name'],
+        additionalProperties: false,
+    },
+};
+export async function handler(args, ctx) {
+    const parsed = ArgsSchema.safeParse(args ?? {});
+    if (!parsed.success)
+        return errorResult(`Argumento inválido: ${parsed.error.message}`);
+    const a = parsed.data;
+    try {
+        const h = await ctx.gateway.addHoliday(a);
+        return jsonResult({ holiday_id: h.id, ...a });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+}
+//# sourceMappingURL=add-holiday.js.map

package/dist/tools/add-holiday.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-holiday.js","sourceRoot":"","sources":["../../src/tools/add-holiday.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC;IACN,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;CACtE,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,aAAa;IACtC,WAAW,EAAE,wDAAwD;IACrE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;YAC3D,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACzD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE;YAC7E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE;SACrG;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QAC1B,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAa,EAAE,GAAgB;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/tools/add-home-office.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { jsonResult, errorResult } from '../lib/tool-result.js';
+import { brand } from '../brand.js';
+import { isoDate } from '../lib/dates.js';
+const ArgsSchema = z.object({ date: isoDate }).strict();
+export const definition = {
+    name: `${brand.toolPrefix}add_home_office`,
+    description: 'Marca home office do PRÓPRIO usuário num dia (o banco pode recusar por limite mensal).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            date: { type: 'string', description: 'Data (YYYY-MM-DD).' },
+        },
+        required: ['date'],
+        additionalProperties: false,
+    },
+};
+export async function handler(args, ctx) {
+    const parsed = ArgsSchema.safeParse(args ?? {});
+    if (!parsed.success)
+        return errorResult(`Argumento inválido: ${parsed.error.message}`);
+    const a = parsed.data;
+    try {
+        const h = await ctx.gateway.addHomeOffice(ctx.user.id, a.date);
+        return jsonResult({ home_office_id: h.id, date: a.date });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+}
+//# sourceMappingURL=add-home-office.js.map

package/dist/tools/add-home-office.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-home-office.js","sourceRoot":"","sources":["../../src/tools/add-home-office.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAExD,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,iBAAiB;IAC1C,WAAW,EAAE,wFAAwF;IACrG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;SAC5D;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAa,EAAE,GAAgB;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/tools/add-vacation.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { jsonResult, errorResult } from '../lib/tool-result.js';
+import { brand } from '../brand.js';
+import { isoDate, dateRangeError } from '../lib/dates.js';
+const ArgsSchema = z
+    .object({ user_id: z.uuid(), start_date: isoDate, end_date: isoDate, notes: z.string().optional() })
+    .strict();
+export const definition = {
+    name: `${brand.toolPrefix}add_vacation`,
+    description: 'Registra férias de um usuário no calendário do time (só admin/gerente).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            user_id: { type: 'string', format: 'uuid', description: 'ID do usuário.' },
+            start_date: { type: 'string', description: 'Início (YYYY-MM-DD).' },
+            end_date: { type: 'string', description: 'Fim (YYYY-MM-DD), >= start_date.' },
+            notes: { type: 'string', description: 'Observações.' },
+        },
+        required: ['user_id', 'start_date', 'end_date'],
+        additionalProperties: false,
+    },
+};
+export async function handler(args, ctx) {
+    const parsed = ArgsSchema.safeParse(args ?? {});
+    if (!parsed.success)
+        return errorResult(`Argumento inválido: ${parsed.error.message}`);
+    const a = parsed.data;
+    const bad = dateRangeError(a.start_date, a.end_date);
+    if (bad)
+        return errorResult(bad);
+    try {
+        const v = await ctx.gateway.addVacation({ ...a, notes: a.notes ?? null, created_by: ctx.user.id });
+        return jsonResult({ vacation_id: v.id, ...a });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+}
+//# sourceMappingURL=add-vacation.js.map

package/dist/tools/add-vacation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-vacation.js","sourceRoot":"","sources":["../../src/tools/add-vacation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;KACnG,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,cAAc;IACvC,WAAW,EAAE,yEAAyE;IACtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE;YAC1E,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;YACnE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;YAC7E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;SACvD;QACD,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC;QAC/C,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAa,EAAE,GAAgB;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IACtB,MAAM,GAAG,GAAG,cAAc,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,GAAG;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACnG,OAAO,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/tools/create-release.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { jsonResult, errorResult } from '../lib/tool-result.js';
+import { resolveProjectConfig, isErrorResult } from '../lib/require-config.js';
+import { isoDate } from '../lib/dates.js';
+import { brand } from '../brand.js';
+import { projectIdProp } from './sprint-common.js';
+const ArgsSchema = z
+    .object({
+    name: z.string().trim().min(1).max(100),
+    target_date: isoDate,
+    description: z.string().optional(),
+    project_id: z.uuid().optional(),
+})
+    .strict();
+export const definition = {
+    name: `${brand.toolPrefix}create_release`,
+    description: 'Cria uma release (status planning) no projeto. target_date é obrigatória (YYYY-MM-DD).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string' },
+            target_date: { type: 'string', description: 'YYYY-MM-DD.' },
+            description: { type: 'string' },
+            project_id: projectIdProp,
+        },
+        required: ['name', 'target_date'],
+        additionalProperties: false,
+    },
+};
+export async function handler(args, ctx) {
+    const parsed = ArgsSchema.safeParse(args);
+    if (!parsed.success)
+        return errorResult(`Argumento inválido: ${parsed.error.message}`);
+    const cfg = resolveProjectConfig(ctx, parsed.data.project_id);
+    if (isErrorResult(cfg))
+        return cfg;
+    const { project_id: _p, ...rest } = parsed.data;
+    try {
+        const release = await ctx.gateway.createRelease({ ...rest, project_id: cfg.project_id, created_by: ctx.user.id });
+        return jsonResult({ ok: true, release });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+}
+//# sourceMappingURL=create-release.js.map

package/dist/tools/create-release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-release.js","sourceRoot":"","sources":["../../src/tools/create-release.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,WAAW,EAAE,OAAO;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,gBAAgB;IACzC,WAAW,EAAE,wFAAwF;IACrG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;YAC3D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC/B,UAAU,EAAE,aAAa;SAC1B;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;QACjC,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAa,EAAE,GAAgB;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,uBAAuB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,MAAM,GAAG,GAAG,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,IAAI,aAAa,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAClH,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/tools/create-sprint.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { jsonResult, errorResult } from '../lib/tool-result.js';
+import { resolveProjectConfig, isErrorResult } from '../lib/require-config.js';
+import { closeSprint } from '../lib/sprint-logic.js';
+import { todayStr, isoDate, dateRangeError } from '../lib/dates.js';
+import { brand } from '../brand.js';
+import { projectIdProp } from './sprint-common.js';
+const ArgsSchema = z
+    .object({
+    name: z.string().trim().min(1).max(100),
+    start_date: isoDate.optional(),
+    end_date: isoDate.optional(),
+    replace_active: z.boolean().optional(),
+    project_id: z.uuid().optional(),
+})
+    .strict();
+export const definition = {
+    name: `${brand.toolPrefix}create_sprint`,
+    description: 'Cria uma sprint já ATIVA. Se o projeto já tem sprint ativa, falha dizendo qual — ' +
+        'passe replace_active=true pra encerrá-la (tasks não concluídas voltam pro backlog) e criar a nova.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string' },
+            start_date: { type: 'string', description: 'YYYY-MM-DD. Default: hoje.' },
+            end_date: { type: 'string', description: 'YYYY-MM-DD.' },
+            replace_active: { type: 'boolean', description: 'Encerra a sprint ativa atual antes de criar. Default false.' },
+            project_id: projectIdProp,
+        },
+        required: ['name'],
+        additionalProperties: false,
+    },
+};
+export async function handler(args, ctx) {
+    const parsed = ArgsSchema.safeParse(args);
+    if (!parsed.success)
+        return errorResult(`Argumento inválido: ${parsed.error.message}`);
+    const { name, replace_active } = parsed.data;
+    const today = todayStr();
+    const start = parsed.data.start_date ?? today;
+    const end = parsed.data.end_date ?? null;
+    const bad = dateRangeError(start, end);
+    if (bad)
+        return errorResult(bad);
+    const cfg = resolveProjectConfig(ctx, parsed.data.project_id);
+    if (isErrorResult(cfg))
+        return cfg;
+    try {
+        const gw = ctx.gateway;
+        const active = await gw.findSprint(cfg.project_id, 'active');
+        let closed;
+        if (active) {
+            if (!replace_active) {
+                return errorResult(`Já existe sprint ativa: "${active.name}" (${active.id}). Use replace_active=true pra encerrá-la ` +
+                    `e criar a nova, ou ${brand.toolPrefix}end_sprint antes.`);
+            }
+            closed = await closeSprint(gw, active, today);
+        }
+        const sprint = await gw.createSprint(cfg.project_id, name, start, end);
+        return jsonResult({ ok: true, sprint, ...(closed && { closed_previous: closed }) });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+}
+//# sourceMappingURL=create-sprint.js.map

package/dist/tools/create-sprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-sprint.js","sourceRoot":"","sources":["../../src/tools/create-sprint.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-task.js

@@ -1,7 +1,9 @@
 import { z } from 'zod';
+import { isoDate, dateRangeError } from '../lib/dates.js';
 import { jsonResult, errorResult } from '../lib/tool-result.js';
 import { resolveProjectConfig, isErrorResult } from '../lib/require-config.js';
 import { resolveTaskDeadline, SPRINT_DEADLINE_FALLBACK_DAYS } from '../lib/sprint-deadline.js';
+import { assertReleaseInProject } from '../lib/release-logic.js';
 import { brand } from '../brand.js';
 const TASK_STATUS = [
     'backlog',
@@ -22,8 +24,10 @@ const ArgsSchema = z
     priority: z.enum(TASK_PRIORITY).default('none'),
     type: z.enum(TASK_TYPE).default('task'),
     status: z.enum(TASK_STATUS).default('todo'),
-    end_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+    start_date: isoDate.optional(),
+    end_date: isoDate.optional(),
     sprint: z.string().default('active'),
+    release: z.uuid().optional(),
     assignee_user_ids: z.array(z.uuid()).optional(),
     label_ids: z.array(z.uuid()).optional(),
     link_to_current_repository: z.boolean().default(true),
@@ -36,8 +40,11 @@ export const definition = {
     description: 'Cria uma nova tarefa no projeto atual. Por padrão: status=todo, sprint=active, ' +
         'type=task, assignee=você. Pra colocar no backlog fora de sprint, passe ' +
         'status="backlog" e sprint="none". O reporter é sempre o usuário autenticado. ' +
-        'Tarefa em sprint SEMPRE tem prazo: se a sprint resolver pra alguma sprint e ' +
-        `"end_date" não vier, é aplicado hoje + ${SPRINT_DEADLINE_FALLBACK_DAYS} dias (vem em "warnings"). ` +
+        'Tarefa em sprint SEMPRE tem prazo: ESTIME o "end_date" pelo tamanho do trabalho ' +
+        `(hoje + ${SPRINT_DEADLINE_FALLBACK_DAYS} dias só é aplicado como fallback se você não informar, e vem em "warnings"). ` +
+        '"start_date" (opcional) marca o início no cronograma e deve ser <= end_date. ' +
+        'Deixe FORA da sprint (sprint="none" + status="backlog") só quando for ideia, "um dia"/algum dia, ' +
+        'algo sem dono, ou o usuário pedir explicitamente; fora isso, fica na sprint ativa. ' +
         'Backlog (sprint="none") segue livre de prazo. Se o projeto não tiver sprint ativa, ' +
         'a tarefa nasce no backlog e avisa em "warnings" — criar nunca falha por falta de sprint.',
     inputSchema: {
@@ -48,17 +55,19 @@ export const definition = {
             priority: { type: 'string', enum: [...TASK_PRIORITY] },
             type: { type: 'string', enum: [...TASK_TYPE] },
             status: { type: 'string', enum: [...TASK_STATUS] },
+            start_date: { type: 'string', description: 'Data ISO (YYYY-MM-DD), opcional. Deve ser <= end_date.' },
             end_date: {
                 type: 'string',
-                description: `Data ISO (YYYY-MM-DD). Obrigatório de fato quando a tarefa entra em sprint — omitido, ` +
-                    `vira hoje + ${SPRINT_DEADLINE_FALLBACK_DAYS} dias.`,
+                description: 'Data ISO (YYYY-MM-DD). ESTIME pelo tamanho do trabalho quando a tarefa entra em sprint; ' +
+                    `só se omitido vira o fallback hoje + ${SPRINT_DEADLINE_FALLBACK_DAYS} dias.`,
             },
             sprint: {
                 type: 'string',
-                description: '"active", "none" ou UUID. Default "active" — a tarefa entra na sprint corrente, ' +
-                    'que é onde quem pede costuma trabalhar em seguida; sem sprint ativa, cai no backlog. ' +
+                description: '"active", "none" ou UUID. Default "active" — a tarefa entra na sprint corrente; sem sprint ativa, cai no backlog. ' +
+                    'Use "none" (com status="backlog") só pra ideia, "um dia"/algum dia, algo sem dono ou pedido explícito. ' +
                     'Qualquer valor != "none" puxa "end_date" junto (default de prazo se você não informar).',
             },
+            release: { type: 'string', format: 'uuid', description: 'UUID de uma release do mesmo projeto (list_releases).' },
             assignee_user_ids: { type: 'array', items: { type: 'string', format: 'uuid' } },
             label_ids: { type: 'array', items: { type: 'string', format: 'uuid' } },
             link_to_current_repository: {
@@ -90,6 +99,10 @@ export function resolveTaskLinks(input, repositoryId, userId) {
 }
 /** Monta o payload de insert da task a partir do input + sprint já resolvida. Pura. */
 export function buildTaskInsertPayload(input, projectId, reporterId, sprintId, today) {
+    const endDate = resolveTaskDeadline(sprintId, input.end_date, today);
+    const rangeErr = dateRangeError(input.start_date, endDate);
+    if (rangeErr)
+        throw new Error(rangeErr);
     return {
         title: input.title,
         description: input.description,
@@ -99,7 +112,9 @@ export function buildTaskInsertPayload(input, projectId, reporterId, sprintId, t
         project_id: projectId,
         reporter_id: reporterId,
         sprint_id: sprintId,
-        end_date: resolveTaskDeadline(sprintId, input.end_date, today),
+        ...(input.release && { release_id: input.release }),
+        start_date: input.start_date,
+        end_date: endDate,
     };
 }
 /**
@@ -127,6 +142,7 @@ export function buildCreateTaskResult(task, assigneeIds, labelIds, repoIds, warn
         priority: task.priority,
         type: task.type,
         sprint_id: task.sprint_id,
+        start_date: task.start_date,
         end_date: task.end_date,
         created_at: task.created_at,
         linked: { assignee_user_ids: assigneeIds, label_ids: labelIds, repository_ids: repoIds },
@@ -142,6 +158,8 @@ export async function handler(args, ctx) {
     if (isErrorResult(cfg))
         return cfg;
     try {
+        if (input.release)
+            await assertReleaseInProject(ctx.gateway, cfg.project_id, input.release);
         const sprintId = await ctx.gateway.resolveSprintId(cfg.project_id, input.sprint);
         const payload = buildTaskInsertPayload(input, cfg.project_id, ctx.user.id, sprintId);
         const { assigneeIds, repoIds } = resolveTaskLinks(input, cfg.repository_id, ctx.user.id);