devvo-ops-mcp 0.1.0

package/README.md

@@ -0,0 +1,155 @@
+# Devvo Ops MCP
+
+Servidor MCP local para integrar clientes como Cursor, Codex, Claude Desktop e outros agentes ao gerenciador de projetos Devvo Ops. A primeira tool disponível é `get_task_by_key`, que consulta uma task por uma key como `TASK-100`.
+
+```text
+AI Client
+   ↓ MCP stdio
+Devvo Ops MCP
+   ↓ HTTP(S)
+Devvo Ops API
+```
+
+## Arquitetura
+
+O MCP é um cliente externo da API, embora seu código esteja atualmente no mesmo repositório.
+
+> Mesmo estando no mesmo repositório, o MCP não deve importar services, repositories, entities, controllers, banco de dados ou outras implementações internas da API.
+
+```text
+CORRETO
+
+MCP
+ ↓ HTTP
+API
+ ↓
+Services
+```
+
+```text
+INCORRETO
+
+MCP
+ ↓ import
+TaskService
+```
+
+Essa separação permite publicar o pacote independentemente no NPM, reduz acoplamento, evita dependência da implementação interna, mantém autenticação e autorização na API e permite que ambos evoluam separadamente.
+
+## Estrutura
+
+```text
+src/
+├── api/       # transporte HTTP, cliente da API e mapeamento de respostas
+├── auth/      # gerenciamento de tokens e persistência da sessão
+├── cli/       # prompts interativos do CLI
+├── tools/     # tools MCP, sem conhecimento de autenticação
+└── index.ts   # comandos CLI e servidor MCP stdio
+```
+
+## Desenvolvimento
+
+Requer Node.js 20 ou superior.
+
+```bash
+cd mcp
+npm install
+npm run build
+npm test
+```
+
+A URL da API é configurada por `DEVVO_OPS_API_URL`. O valor padrão para desenvolvimento local é `http://localhost:3334`.
+
+## Autenticação
+
+```bash
+npx devvo-ops-mcp login
+```
+
+```text
+email + senha
+ ↓
+API
+ ↓
+refresh token
+ ↓
+~/.devvo-ops-mcp/auth.json
+```
+
+A senha nunca é persistida. O access token permanece somente na memória do processo; apenas o refresh token e, opcionalmente, o email são gravados. O MCP renova tokens automaticamente e salva o novo refresh token quando a API faz rotação.
+
+O arquivo `~/.devvo-ops-mcp/auth.json` é uma credencial sensível: deve permanecer fora do repositório, nunca deve ser commitado, enviado ou compartilhado, e é removido no logout. O pacote solicita permissões `0700` para o diretório e `0600` para o arquivo quando o sistema operacional oferece suporte.
+
+Comandos disponíveis:
+
+```bash
+npx devvo-ops-mcp login
+npx devvo-ops-mcp status
+npx devvo-ops-mcp logout
+```
+
+Executar o pacote sem subcomando inicia o servidor MCP via `stdio`.
+
+## Uso em um cliente MCP
+
+Faça login primeiro e adicione uma configuração equivalente à seguinte no cliente:
+
+```json
+{
+  "mcpServers": {
+    "devvo-ops": {
+      "command": "npx",
+      "args": ["-y", "devvo-ops-mcp"],
+      "env": {
+        "DEVVO_OPS_API_URL": "https://api.example.com"
+      }
+    }
+  }
+}
+```
+
+Não coloque email, senha, access token ou refresh token nessa configuração.
+
+Exemplos de solicitações:
+
+```text
+Mostre a TASK-100.
+O que precisa ser feito na TASK-100?
+Leia a TASK-100 e me explique como você implementaria.
+```
+
+## MCP Inspector
+
+Depois do build, teste o transporte e a tool com:
+
+```bash
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+Também é possível inspecionar diretamente o código TypeScript durante o desenvolvimento:
+
+```bash
+npx @modelcontextprotocol/inspector npx tsx src/index.ts
+```
+
+## Boas práticas para novas tools
+
+Toda nova tool deve manter o fluxo:
+
+```text
+Tool
+ ↓
+ApiClient
+ ↓
+API
+```
+
+Nunca use:
+
+```text
+Tool
+ ↓
+Service interno
+```
+
+As tools devem ter responsabilidade pequena e schemas claros, não conhecer autenticação, não acessar banco diretamente, não duplicar regras de negócio da API, retornar apenas contexto útil ao LLM e utilizar o `ApiClient` compartilhado.

package/dist/api/api-client.d.ts

@@ -0,0 +1,10 @@
+import { AuthManager } from '../auth/auth-manager.js';
+import { HttpClient } from './http-client.js';
+import { type TaskForLlm } from './task-mapper.js';
+export declare class ApiClient {
+    private readonly httpClient;
+    private readonly authManager;
+    constructor(httpClient: HttpClient, authManager: AuthManager);
+    getTaskByKey(key: string): Promise<TaskForLlm>;
+    private authenticatedRequest;
+}

package/dist/api/api-client.js

@@ -0,0 +1,40 @@
+import { ApiUnavailableError, AuthenticationRequiredError, AuthorizationError, TaskNotFoundError, UnexpectedApiResponseError, } from '../errors.js';
+import { mapTaskForLlm } from './task-mapper.js';
+export class ApiClient {
+    httpClient;
+    authManager;
+    constructor(httpClient, authManager) {
+        this.httpClient = httpClient;
+        this.authManager = authManager;
+    }
+    async getTaskByKey(key) {
+        const path = `/tasks/by-key/${encodeURIComponent(key)}`;
+        let response = await this.authenticatedRequest(path);
+        if (response.status === 401) {
+            const accessToken = await this.authManager.refreshAccessToken();
+            response = await this.httpClient.request(path, { accessToken });
+        }
+        if (response.status === 401) {
+            await this.authManager.invalidateSession();
+            throw new AuthenticationRequiredError();
+        }
+        if (response.status === 403) {
+            throw new AuthorizationError();
+        }
+        if (response.status === 404) {
+            throw new TaskNotFoundError(key);
+        }
+        if (response.status >= 500) {
+            throw new ApiUnavailableError();
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new UnexpectedApiResponseError();
+        }
+        return mapTaskForLlm(response.data);
+    }
+    async authenticatedRequest(path) {
+        const accessToken = await this.authManager.getAccessToken();
+        return this.httpClient.request(path, { accessToken });
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/api/api-client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAmB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,MAAM,OAAO,SAAS;IAED;IACA;IAFnB,YACmB,UAAsB,EACtB,WAAwB;QADxB,eAAU,GAAV,UAAU,CAAY;QACtB,gBAAW,GAAX,WAAW,CAAa;IACxC,CAAC;IAEJ,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,MAAM,IAAI,GAAG,iBAAiB,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACxD,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAErD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC;YAChE,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;YAC3C,MAAM,IAAI,2BAA2B,EAAE,CAAC;QAC1C,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACjC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAC3B,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YACpD,MAAM,IAAI,0BAA0B,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,IAAY;QAC7C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/api/http-client.d.ts

@@ -0,0 +1,20 @@
+export type HttpResponse = {
+    status: number;
+    data: unknown;
+};
+export type HttpClientOptions = {
+    baseUrl: string;
+    timeoutMs?: number;
+    fetchImplementation?: typeof fetch;
+};
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly fetchImplementation;
+    constructor(options: HttpClientOptions);
+    request(path: string, options?: {
+        method?: string;
+        body?: unknown;
+        accessToken?: string;
+    }): Promise<HttpResponse>;
+}

package/dist/api/http-client.js

@@ -0,0 +1,47 @@
+import { ApiTimeoutError, ApiUnavailableError, UnexpectedApiResponseError } from '../errors.js';
+export class HttpClient {
+    baseUrl;
+    timeoutMs;
+    fetchImplementation;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.timeoutMs = options.timeoutMs ?? 10_000;
+        this.fetchImplementation = options.fetchImplementation ?? globalThis.fetch;
+    }
+    async request(path, options = {}) {
+        const headers = new Headers({ Accept: 'application/json' });
+        if (options.body !== undefined) {
+            headers.set('Content-Type', 'application/json');
+        }
+        if (options.accessToken) {
+            headers.set('Authorization', `Bearer ${options.accessToken}`);
+        }
+        let response;
+        try {
+            response = await this.fetchImplementation(new URL(path, `${this.baseUrl}/`), {
+                method: options.method ?? 'GET',
+                headers,
+                body: options.body === undefined ? undefined : JSON.stringify(options.body),
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+        }
+        catch (error) {
+            if (error instanceof DOMException &&
+                (error.name === 'AbortError' || error.name === 'TimeoutError')) {
+                throw new ApiTimeoutError();
+            }
+            throw new ApiUnavailableError();
+        }
+        const responseText = await response.text();
+        if (!responseText) {
+            return { status: response.status, data: null };
+        }
+        try {
+            return { status: response.status, data: JSON.parse(responseText) };
+        }
+        catch {
+            throw new UnexpectedApiResponseError();
+        }
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/api/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/api/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAahG,MAAM,OAAO,UAAU;IACJ,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,mBAAmB,CAAe;IAEnD,YAAY,OAA0B;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QAC7C,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,UAAU,CAAC,KAAK,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,UAAqE,EAAE;QAEvE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC5D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE;gBAC3E,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;gBAC/B,OAAO;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;gBAC3E,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,KAAK,YAAY,YAAY;gBAC7B,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,EAC9D,CAAC;gBACD,MAAM,IAAI,eAAe,EAAE,CAAC;YAC9B,CAAC;YACD,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC;QAED,IAAI,CAAC;YACH,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAY,EAAE,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,0BAA0B,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/api/task-mapper.d.ts

@@ -0,0 +1,41 @@
+export type TaskForLlm = {
+    key: string;
+    title: string;
+    description: string | null;
+    status: string;
+    priority: string;
+    type: string;
+    isEpic: boolean;
+    estimatedDuration: string | null;
+    assignee: {
+        name: string;
+        email: string;
+    } | null;
+    project: {
+        key: string;
+        name: string;
+    };
+    sprint: {
+        name: string;
+        status: string;
+    } | null;
+    taskType: string | null;
+    checklist: Array<{
+        text: string;
+        done: boolean;
+    }>;
+    tags: string[];
+    comments: TaskCommentForLlm[];
+    createdAt: string;
+    updatedAt: string;
+};
+export type TaskCommentForLlm = {
+    text: string;
+    author: {
+        name: string;
+        email: string;
+    };
+    createdAt: string;
+    replies: TaskCommentForLlm[];
+};
+export declare function mapTaskForLlm(data: unknown): TaskForLlm;

package/dist/api/task-mapper.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { UnexpectedApiResponseError } from '../errors.js';
+const userSchema = z.object({
+    firstName: z.string(),
+    lastName: z.string(),
+    email: z.string().email(),
+});
+const commentSchema = z.lazy(() => z.object({
+    plainText: z.string(),
+    createdAt: z.string(),
+    author: userSchema,
+    replies: z.array(commentSchema).optional(),
+}));
+const apiTaskSchema = z.object({
+    issueKey: z.string(),
+    title: z.string(),
+    description: z.string().nullable().optional(),
+    status: z.string(),
+    priority: z.string(),
+    type: z.string(),
+    isEpic: z.boolean().optional(),
+    estimatedDurationInput: z.string().nullable().optional(),
+    assignee: userSchema.nullable().optional(),
+    project: z.object({ key: z.string(), name: z.string() }),
+    sprint: z.object({ name: z.string(), status: z.string() }).nullable().optional(),
+    taskType: z.object({ name: z.string() }).nullable().optional(),
+    checklist: z.array(z.object({ text: z.string(), isDone: z.boolean() })).optional(),
+    tags: z.array(z.object({ name: z.string() })).optional(),
+    comments: z.array(commentSchema).optional(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+export function mapTaskForLlm(data) {
+    const parsed = apiTaskSchema.safeParse(data);
+    if (!parsed.success) {
+        throw new UnexpectedApiResponseError();
+    }
+    const task = parsed.data;
+    return {
+        key: task.issueKey,
+        title: task.title,
+        description: task.description ?? null,
+        status: task.status,
+        priority: task.priority,
+        type: task.type,
+        isEpic: task.isEpic ?? false,
+        estimatedDuration: task.estimatedDurationInput ?? null,
+        assignee: task.assignee
+            ? {
+                name: `${task.assignee.firstName} ${task.assignee.lastName}`.trim(),
+                email: task.assignee.email,
+            }
+            : null,
+        project: task.project,
+        sprint: task.sprint ?? null,
+        taskType: task.taskType?.name ?? null,
+        checklist: (task.checklist ?? []).map((item) => ({
+            text: item.text,
+            done: item.isDone,
+        })),
+        tags: (task.tags ?? []).map((tag) => tag.name),
+        comments: (task.comments ?? []).map(mapComment),
+        createdAt: task.createdAt,
+        updatedAt: task.updatedAt,
+    };
+}
+function mapComment(comment) {
+    return {
+        text: comment.plainText,
+        author: {
+            name: `${comment.author.firstName} ${comment.author.lastName}`.trim(),
+            email: comment.author.email,
+        },
+        createdAt: comment.createdAt,
+        replies: (comment.replies ?? []).map(mapComment),
+    };
+}
+//# sourceMappingURL=task-mapper.js.map

package/dist/api/task-mapper.js.map

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

package/dist/auth/auth-manager.d.ts

@@ -0,0 +1,24 @@
+import { HttpClient } from '../api/http-client.js';
+import { SessionStore } from './session-store.js';
+export type AuthStatus = {
+    authenticated: boolean;
+    email?: string;
+};
+export declare class AuthManager {
+    private readonly httpClient;
+    private readonly sessionStore;
+    private accessToken;
+    private accessTokenExpiresAt;
+    private refreshInFlight;
+    constructor(httpClient: HttpClient, sessionStore: SessionStore);
+    login(email: string, password: string): Promise<void>;
+    logout(): Promise<void>;
+    getStatus(): Promise<AuthStatus>;
+    getAccessToken(): Promise<string>;
+    refreshAccessToken(): Promise<string>;
+    invalidateSession(): Promise<void>;
+    private performRefresh;
+    private setAccessToken;
+    private clearAccessToken;
+    private isAccessTokenExpiring;
+}

package/dist/auth/auth-manager.js

@@ -0,0 +1,131 @@
+import { z } from 'zod';
+import { ApiUnavailableError, AuthenticationRequiredError, UnexpectedApiResponseError, } from '../errors.js';
+const tokenPairSchema = z.object({
+    accessToken: z.string().min(1),
+    refreshToken: z.string().min(1),
+});
+export class AuthManager {
+    httpClient;
+    sessionStore;
+    accessToken = null;
+    accessTokenExpiresAt = null;
+    refreshInFlight = null;
+    constructor(httpClient, sessionStore) {
+        this.httpClient = httpClient;
+        this.sessionStore = sessionStore;
+    }
+    async login(email, password) {
+        const response = await this.httpClient.request('/auth/login', {
+            method: 'POST',
+            body: { email, password },
+        });
+        if (response.status === 401 || response.status === 403) {
+            throw new Error('Email ou senha inválidos.');
+        }
+        if (response.status >= 500) {
+            throw new ApiUnavailableError();
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new UnexpectedApiResponseError();
+        }
+        const tokens = parseTokenPair(response.data);
+        this.setAccessToken(tokens.accessToken);
+        await this.sessionStore.saveSession({
+            refreshToken: tokens.refreshToken,
+            user: { email },
+        });
+    }
+    async logout() {
+        this.clearAccessToken();
+        await this.sessionStore.deleteSession();
+    }
+    async getStatus() {
+        const session = await this.sessionStore.getSession();
+        return session ? { authenticated: true, email: session.user?.email } : { authenticated: false };
+    }
+    async getAccessToken() {
+        if (this.accessToken && !this.isAccessTokenExpiring()) {
+            return this.accessToken;
+        }
+        return this.refreshAccessToken();
+    }
+    async refreshAccessToken() {
+        if (!this.refreshInFlight) {
+            this.refreshInFlight = this.performRefresh().finally(() => {
+                this.refreshInFlight = null;
+            });
+        }
+        return this.refreshInFlight;
+    }
+    async invalidateSession() {
+        this.clearAccessToken();
+        await this.sessionStore.deleteSession();
+    }
+    async performRefresh() {
+        const session = await this.sessionStore.getSession();
+        if (!session) {
+            throw new AuthenticationRequiredError();
+        }
+        const response = await this.httpClient.request('/auth/refresh', {
+            method: 'POST',
+            body: { refreshToken: session.refreshToken },
+        });
+        if (response.status === 401 || response.status === 403) {
+            await this.invalidateSession();
+            throw new AuthenticationRequiredError();
+        }
+        if (response.status >= 500) {
+            throw new ApiUnavailableError();
+        }
+        if (response.status < 200 || response.status >= 300) {
+            throw new UnexpectedApiResponseError();
+        }
+        let tokens;
+        try {
+            tokens = tokenPairSchema.parse(response.data);
+        }
+        catch {
+            throw new UnexpectedApiResponseError();
+        }
+        this.setAccessToken(tokens.accessToken);
+        await this.sessionStore.saveSession({
+            refreshToken: tokens.refreshToken,
+            user: session.user,
+        });
+        return tokens.accessToken;
+    }
+    setAccessToken(accessToken) {
+        this.accessToken = accessToken;
+        this.accessTokenExpiresAt = readJwtExpiration(accessToken);
+    }
+    clearAccessToken() {
+        this.accessToken = null;
+        this.accessTokenExpiresAt = null;
+    }
+    isAccessTokenExpiring() {
+        return this.accessTokenExpiresAt !== null && this.accessTokenExpiresAt <= Date.now() + 30_000;
+    }
+}
+function parseTokenPair(data) {
+    try {
+        return tokenPairSchema.parse(data);
+    }
+    catch {
+        throw new UnexpectedApiResponseError();
+    }
+}
+function readJwtExpiration(token) {
+    const payload = token.split('.')[1];
+    if (!payload) {
+        return null;
+    }
+    try {
+        const decoded = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8'));
+        const parsed = z.object({ exp: z.number().positive() }).safeParse(decoded);
+        return parsed.success ? parsed.data.exp * 1000 : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=auth-manager.js.map

package/dist/auth/auth-manager.js.map

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

package/dist/auth/session-store.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+declare const sessionSchema: z.ZodObject<{
+    refreshToken: z.ZodString;
+    user: z.ZodOptional<z.ZodObject<{
+        email: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        email: string;
+    }, {
+        email: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    refreshToken: string;
+    user?: {
+        email: string;
+    } | undefined;
+}, {
+    refreshToken: string;
+    user?: {
+        email: string;
+    } | undefined;
+}>;
+export type Session = z.infer<typeof sessionSchema>;
+export declare class SessionStore {
+    readonly directory: string;
+    readonly filePath: string;
+    constructor(directory?: string);
+    getSession(): Promise<Session | null>;
+    saveSession(session: Session): Promise<void>;
+    deleteSession(): Promise<void>;
+}
+export {};

package/dist/auth/session-store.js

@@ -0,0 +1,55 @@
+import { chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { z } from 'zod';
+const sessionSchema = z.object({
+    refreshToken: z.string().min(1),
+    user: z
+        .object({
+        email: z.string().email(),
+    })
+        .optional(),
+});
+export class SessionStore {
+    directory;
+    filePath;
+    constructor(directory = join(homedir(), '.devvo-ops-mcp')) {
+        this.directory = directory;
+        this.filePath = join(directory, 'auth.json');
+    }
+    async getSession() {
+        let contents;
+        try {
+            contents = await readFile(this.filePath, 'utf8');
+        }
+        catch (error) {
+            if (isFileSystemError(error, 'ENOENT')) {
+                return null;
+            }
+            throw error;
+        }
+        try {
+            return sessionSchema.parse(JSON.parse(contents));
+        }
+        catch {
+            throw new Error('O arquivo de sessão local é inválido. Execute "npx devvo-ops-mcp logout" e depois "npx devvo-ops-mcp login".');
+        }
+    }
+    async saveSession(session) {
+        const safeSession = sessionSchema.parse(session);
+        await mkdir(this.directory, { recursive: true, mode: 0o700 });
+        await chmod(this.directory, 0o700).catch(() => undefined);
+        await writeFile(this.filePath, `${JSON.stringify(safeSession, null, 2)}\n`, {
+            encoding: 'utf8',
+            mode: 0o600,
+        });
+        await chmod(this.filePath, 0o600).catch(() => undefined);
+    }
+    async deleteSession() {
+        await rm(this.filePath, { force: true });
+    }
+}
+function isFileSystemError(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+//# sourceMappingURL=session-store.js.map

package/dist/auth/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/auth/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC;SACJ,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;KAC1B,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAIH,MAAM,OAAO,YAAY;IACd,SAAS,CAAS;IAClB,QAAQ,CAAS;IAE1B,YAAY,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC;QACvD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,8GAA8G,CAC/G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAgB;QAChC,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAC1E,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,KAAc,EAAE,IAAY;IACrD,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC1E,CAAC"}

package/dist/cli/prompts.d.ts

@@ -0,0 +1,2 @@
+export declare function promptEmail(): Promise<string>;
+export declare function promptPassword(): Promise<string>;

package/dist/cli/prompts.js

@@ -0,0 +1,59 @@
+import { createInterface } from 'node:readline/promises';
+export async function promptEmail() {
+    const prompt = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return (await prompt.question('Email: ')).trim();
+    }
+    finally {
+        prompt.close();
+    }
+}
+export async function promptPassword() {
+    if (!process.stdin.isTTY || typeof process.stdin.setRawMode !== 'function') {
+        const prompt = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            return await prompt.question('Senha: ');
+        }
+        finally {
+            prompt.close();
+        }
+    }
+    process.stdout.write('Senha: ');
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    return new Promise((resolve, reject) => {
+        let password = '';
+        const finish = (error) => {
+            process.stdin.removeListener('data', onData);
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            process.stdout.write('\n');
+            if (error) {
+                reject(error);
+            }
+            else {
+                resolve(password);
+            }
+        };
+        const onData = (chunk) => {
+            for (const character of chunk) {
+                if (character === '\u0003') {
+                    finish(new Error('Login cancelado.'));
+                    return;
+                }
+                if (character === '\r' || character === '\n') {
+                    finish();
+                    return;
+                }
+                if (character === '\u007f' || character === '\b') {
+                    password = password.slice(0, -1);
+                    continue;
+                }
+                password += character;
+            }
+        };
+        process.stdin.on('data', onData);
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/cli/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC3E,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACjF,IAAI,CAAC;YACH,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC1C,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAElC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;gBAC9B,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;oBAC3B,MAAM,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;oBACtC,OAAO;gBACT,CAAC;gBACD,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBAC7C,MAAM,EAAE,CAAC;oBACT,OAAO;gBACT,CAAC;gBACD,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;oBACjD,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;oBACjC,SAAS;gBACX,CAAC;gBACD,QAAQ,IAAI,SAAS,CAAC;YACxB,CAAC;QACH,CAAC,CAAC;QAEF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1 @@
+export declare function getApiBaseUrl(environment?: NodeJS.ProcessEnv): string;

package/dist/config.js

@@ -0,0 +1,15 @@
+const DEFAULT_API_URL = 'http://localhost:3334';
+export function getApiBaseUrl(environment = process.env) {
+    const configuredUrl = environment.DEVVO_OPS_API_URL?.trim() || DEFAULT_API_URL;
+    try {
+        const url = new URL(configuredUrl);
+        if (!['http:', 'https:'].includes(url.protocol)) {
+            throw new Error('unsupported protocol');
+        }
+        return url.toString().replace(/\/$/, '');
+    }
+    catch {
+        throw new Error('DEVVO_OPS_API_URL deve ser uma URL HTTP(S) válida.');
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,MAAM,UAAU,aAAa,CAAC,cAAiC,OAAO,CAAC,GAAG;IACxE,MAAM,aAAa,GAAG,WAAW,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,eAAe,CAAC;IAE/E,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+export declare class McpClientError extends Error {
+    constructor(message: string);
+}
+export declare class AuthenticationRequiredError extends McpClientError {
+    constructor();
+}
+export declare class AuthorizationError extends McpClientError {
+    constructor();
+}
+export declare class TaskNotFoundError extends McpClientError {
+    constructor(key: string);
+}
+export declare class ApiUnavailableError extends McpClientError {
+    constructor();
+}
+export declare class ApiTimeoutError extends McpClientError {
+    constructor();
+}
+export declare class UnexpectedApiResponseError extends McpClientError {
+    constructor();
+}

package/dist/errors.js

@@ -0,0 +1,37 @@
+export class McpClientError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+export class AuthenticationRequiredError extends McpClientError {
+    constructor() {
+        super('Autenticação necessária. Execute "npx devvo-ops-mcp login" e tente novamente.');
+    }
+}
+export class AuthorizationError extends McpClientError {
+    constructor() {
+        super('Você não tem permissão para acessar esta task.');
+    }
+}
+export class TaskNotFoundError extends McpClientError {
+    constructor(key) {
+        super(`Task ${key} não encontrada.`);
+    }
+}
+export class ApiUnavailableError extends McpClientError {
+    constructor() {
+        super('A API do Devvo Ops está indisponível. Tente novamente mais tarde.');
+    }
+}
+export class ApiTimeoutError extends McpClientError {
+    constructor() {
+        super('A API do Devvo Ops não respondeu dentro do tempo limite.');
+    }
+}
+export class UnexpectedApiResponseError extends McpClientError {
+    constructor() {
+        super('A API do Devvo Ops retornou uma resposta inesperada.');
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,cAAc;IAC7D;QACE,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACzF,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD;QACE,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACnD,YAAY,GAAW;QACrB,KAAK,CAAC,QAAQ,GAAG,kBAAkB,CAAC,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,cAAc;IACrD;QACE,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC7E,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD;QACE,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACpE,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,cAAc;IAC5D;QACE,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ApiClient } from './api/api-client.js';
+export declare function createServer(apiClient: ApiClient): McpServer;
+export declare function main(args?: string[]): Promise<void>;

package/dist/index.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+import { pathToFileURL } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ApiClient } from './api/api-client.js';
+import { HttpClient } from './api/http-client.js';
+import { AuthManager } from './auth/auth-manager.js';
+import { SessionStore } from './auth/session-store.js';
+import { promptEmail, promptPassword } from './cli/prompts.js';
+import { getApiBaseUrl } from './config.js';
+import { createGetTaskByKeyHandler, getTaskByKeyInputSchema } from './tools/get-task-by-key.js';
+const VERSION = '0.1.0';
+function createDependencies() {
+    const httpClient = new HttpClient({ baseUrl: getApiBaseUrl() });
+    const sessionStore = new SessionStore();
+    const authManager = new AuthManager(httpClient, sessionStore);
+    const apiClient = new ApiClient(httpClient, authManager);
+    return { apiClient, authManager, sessionStore };
+}
+export function createServer(apiClient) {
+    const server = new McpServer({ name: 'devvo-ops-mcp', version: VERSION });
+    server.registerTool('get_task_by_key', {
+        description: 'Busca uma task do gerenciador de projetos Devvo Ops através de sua key, como TASK-100.',
+        inputSchema: getTaskByKeyInputSchema,
+    }, createGetTaskByKeyHandler(apiClient));
+    return server;
+}
+export async function main(args = process.argv.slice(2)) {
+    const { apiClient, authManager, sessionStore } = createDependencies();
+    const command = args[0];
+    if (command === 'login') {
+        const email = await promptEmail();
+        let password = await promptPassword();
+        try {
+            await authManager.login(email, password);
+            process.stdout.write(`Login realizado. Sessão salva em ${sessionStore.filePath}.\n`);
+        }
+        finally {
+            password = '';
+        }
+        return;
+    }
+    if (command === 'logout') {
+        await authManager.logout();
+        process.stdout.write('Sessão local removida.\n');
+        return;
+    }
+    if (command === 'status') {
+        const status = await authManager.getStatus();
+        process.stdout.write(status.authenticated
+            ? `Autenticado${status.email ? ` como ${status.email}` : ''}.\n`
+            : 'Não autenticado. Execute "npx devvo-ops-mcp login".\n');
+        return;
+    }
+    if (command) {
+        throw new Error(`Comando desconhecido: ${command}. Use login, logout ou status.`);
+    }
+    const server = createServer(apiClient);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+const executablePath = process.argv[1];
+if (executablePath && import.meta.url === pathToFileURL(executablePath).href) {
+    main().catch((error) => {
+        const message = error instanceof Error ? error.message : 'Erro inesperado.';
+        console.error(message);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/get-task-by-key.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api/api-client.js';
+export declare const getTaskByKeyInputSchema: {
+    key: z.ZodString;
+};
+export declare function createGetTaskByKeyHandler(apiClient: ApiClient): ({ key }: {
+    key: string;
+}) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: import("../api/task-mapper.js").TaskForLlm;
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+    structuredContent?: undefined;
+}>;

package/dist/tools/get-task-by-key.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export const getTaskByKeyInputSchema = {
+    key: z
+        .string()
+        .trim()
+        .regex(/^[A-Za-z][A-Za-z0-9]*-\d+$/, 'Use uma key como TASK-100.'),
+};
+export function createGetTaskByKeyHandler(apiClient) {
+    return async ({ key }) => {
+        try {
+            const task = await apiClient.getTaskByKey(key.toUpperCase());
+            return {
+                content: [{ type: 'text', text: JSON.stringify(task, null, 2) }],
+                structuredContent: task,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Não foi possível buscar a task.';
+            return {
+                content: [{ type: 'text', text: message }],
+                isError: true,
+            };
+        }
+    };
+}
+//# sourceMappingURL=get-task-by-key.js.map

package/dist/tools/get-task-by-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-task-by-key.js","sourceRoot":"","sources":["../../src/tools/get-task-by-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,IAAI,EAAE;SACN,KAAK,CAAC,4BAA4B,EAAE,4BAA4B,CAAC;CACrE,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,SAAoB;IAC5D,OAAO,KAAK,EAAE,EAAE,GAAG,EAAmB,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzE,iBAAiB,EAAE,IAAI;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAAC;YAC3F,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBACnD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "devvo-ops-mcp",
+  "version": "0.1.0",
+  "description": "Servidor MCP local para consultar o Devvo Ops.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "bin": {
+    "devvo-ops-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.30.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.7",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.4"
+  }
+}