fg-tracker-mcp 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog — fg-tracker-mcp
+
+## 0.4.0 — 2026-09-15
+
+- **Renomeado de `stread-track-mcp` — nomes antigos continuam funcionando e serão removidos na 1.0.** Veja "Migração de stread-track-mcp" no README.
+- Bin `fg-tracker-mcp`; `stread-track-mcp` continua como alias obsoleto (avisa no stderr).
+- Variáveis `FG_TRACKER_URL`, `FG_TRACKER_TOKEN`, `FG_TRACKER_API_KEY` e `FG_TRACKER_TIMEOUT_MS`, lidas antes dos nomes legados `STREAD_TRACK_*` (fallback).
+- Nome do servidor MCP: `fg-tracker` (versão `0.4.0`). Tools `track_*` e o prompt `instrument-project` não mudaram.
+- Resource `fg-tracker://docs/quickstart`; a URI `stread-track://docs/quickstart` continua registrada.
+- A chave de projeto vai no header `x-fg-tracker-key`. Guias e quickstart passam a instalar `fg-tracker-sdk@^0.4.0` com `FG_TRACKER_KEY`/`FG_TRACKER_URL`.
+- `package.json`: repositório `FORTGROUND/fg-tracker`, `publishConfig.access: public`, `prepack` limpa e recompila `dist/`.
+
+## 0.3.0
+
+- Versão interna do monorepo (a última publicada no npm como `stread-track-mcp` foi a 0.2.0).

package/README.md

@@ -0,0 +1,83 @@
+# fg-tracker-mcp
+
+Servidor [MCP](https://modelcontextprotocol.io) (stdio) do FG Tracker para agentes de código (Claude Code, Cursor, Windsurf, Claude Desktop): projetos, métricas, traces, issues com commits suspeitos, releases, monitores, provedores externos, logs e guia de instrumentação. Documentação completa: `docs/mcp.md` no repositório.
+
+## Instalação
+
+Claude Code:
+
+```bash
+claude mcp add fg-tracker \
+  -e FG_TRACKER_URL=http://localhost:4050 \
+  -e FG_TRACKER_TOKEN=<token-de-sessao> \
+  -- npx -y fg-tracker-mcp
+```
+
+Cursor / Windsurf / Claude Desktop (JSON):
+
+```json
+{
+  "mcpServers": {
+    "fg-tracker": {
+      "command": "npx",
+      "args": ["-y", "fg-tracker-mcp"],
+      "env": {
+        "FG_TRACKER_URL": "http://localhost:4050",
+        "FG_TRACKER_TOKEN": "<token-de-sessao>"
+      }
+    }
+  }
+}
+```
+
+Em produção, `FG_TRACKER_URL` é a URL da API mostrada no painel em **Conectar**. O domínio `https://tracker-api.fortground.com.br` será o endereço definitivo; até ele entrar no ar, use a URL atual do painel.
+
+## Variáveis de ambiente
+
+| variável | default | uso |
+|---|---|---|
+| `FG_TRACKER_URL` | `http://localhost:4050` | URL base da API |
+| `FG_TRACKER_TOKEN` | — | token de sessão (`Authorization: Bearer`) — projetos, métricas, traces, issues, logs |
+| `FG_TRACKER_API_KEY` | — | chave de projeto (`x-fg-tracker-key`) — opcional, só ingestão |
+| `FG_TRACKER_TIMEOUT_MS` | `15000` | timeout das chamadas HTTP |
+
+Os nomes antigos `STREAD_TRACK_*` continuam lidos quando o nome novo está ausente.
+
+## Tools, prompt e resource
+
+Tools `track_*` (nomes inalterados), prompt `instrument-project` e resource `fg-tracker://docs/quickstart`.
+
+## Migração de stread-track-mcp
+
+O pacote foi renomeado de `stread-track-mcp` (última versão no npm: 0.2.0) para `fg-tracker-mcp` (0.4.0). Nomes antigos continuam funcionando e serão removidos na 1.0.
+
+| antigo | novo | compatibilidade |
+|---|---|---|
+| pacote `stread-track-mcp` | `fg-tracker-mcp` | as versões antigas seguem no npm |
+| bin `stread-track-mcp` | `fg-tracker-mcp` | o bin antigo é alias obsoleto (mesmo arquivo, aviso no stderr) |
+| `STREAD_TRACK_URL`, `STREAD_TRACK_TOKEN`, `STREAD_TRACK_API_KEY`, `STREAD_TRACK_TIMEOUT_MS` | `FG_TRACKER_URL`, `FG_TRACKER_TOKEN`, `FG_TRACKER_API_KEY`, `FG_TRACKER_TIMEOUT_MS` | o novo tem precedência; o antigo é fallback |
+| nome do servidor MCP `stread-track` | `fg-tracker` | renomeie a entrada na config do cliente quando quiser |
+| resource `stread-track://docs/quickstart` | `fg-tracker://docs/quickstart` | a URI antiga continua registrada (mesmo conteúdo) |
+| header `x-stread-track-key` | `x-fg-tracker-key` | a API aceita os dois |
+| tools `track_*`, prompt `instrument-project` | inalterados | — |
+
+Na config do cliente: troque `"stread-track": { "command": "npx", "args": ["-y", "stread-track-mcp"] }` por `"fg-tracker": { "command": "npx", "args": ["-y", "fg-tracker-mcp"] }` e renomeie as variáveis de `env`.
+
+## Database detection (0.2.0)
+
+`track_detect_databases { projectPath, serviceName }` inspects local Node project
+manifests and imports without opening .env/credential files, following symlinks,
+executing project scripts or reading dependencies. It returns candidate engines,
+driver adapters, source references and an implementation guide. Multiple databases
+are reported separately; a dependency alone is not proof of production use.
+
+The coding agent must verify client creation sites, apply the appropriate SDK
+adapter, preserve transactions/pool settings, and validate real `db.query` spans
+under an HTTP request with `track_get_trace`. Detect before requesting
+`track_instrumentation_guide { framework, databaseDriver, projectId }`.
+
+Native adapters: pg and Postgres.js (including Drizzle). Generic adapters cover
+synchronous, Promise and error-first callback operations; explicit completion
+wrappers cover other engines, ORM operations and cursor/stream consumption.
+Unknown drivers are not silently treated as pg. SQL is normalized and values are
+not exported. No double instrumentation at both ORM and driver layers.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/**
+ * Entrada do binário `fg-tracker-mcp` (alias obsoleto: `stread-track-mcp`): sobe o servidor MCP em stdio.
+ * Env: FG_TRACKER_URL (default http://localhost:4050), FG_TRACKER_TOKEN, FG_TRACKER_API_KEY,
+ * FG_TRACKER_TIMEOUT_MS — os nomes legados STREAD_TRACK_* continuam valendo como fallback.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { configFromEnv, TrackClient } from './client.js';
+import { createServer, SERVER_NAME, SERVER_VERSION } from './server.js';
+const argv = process.argv.slice(2);
+if (argv.includes('--help') || argv.includes('-h')) {
+    process.stdout.write([
+        `${SERVER_NAME}-mcp ${SERVER_VERSION} — servidor MCP (stdio) do FG Tracker`,
+        '',
+        'Uso: fg-tracker-mcp              (sem argumentos; fala MCP JSON-RPC via stdin/stdout)',
+        '     fg-tracker-mcp --version',
+        '',
+        'Variáveis de ambiente:',
+        '  FG_TRACKER_URL         URL da API (default http://localhost:4050)',
+        '  FG_TRACKER_TOKEN       token de sessão (Authorization: Bearer) — projetos, métricas, logs',
+        '  FG_TRACKER_API_KEY     chave de projeto (x-fg-tracker-key) — opcional, só ingestão',
+        '  FG_TRACKER_TIMEOUT_MS  timeout das chamadas HTTP (default 15000)',
+        '  (os nomes antigos STREAD_TRACK_* ainda são lidos como fallback; serão removidos na 1.0)',
+        '',
+        'Instalação no Claude Code:',
+        '  claude mcp add fg-tracker -e FG_TRACKER_URL=http://localhost:4050 -e FG_TRACKER_TOKEN=... -- npx -y fg-tracker-mcp',
+        '',
+    ].join('\n'));
+    process.exit(0);
+}
+if (argv.includes('--version') || argv.includes('-v')) {
+    process.stdout.write(`${SERVER_VERSION}\n`);
+    process.exit(0);
+}
+const config = configFromEnv();
+const client = new TrackClient(config);
+const server = createServer({ client });
+// stdout é o canal JSON-RPC: qualquer diagnóstico vai para stderr.
+const invoked = process.argv[1]?.split(/[\\/]/).pop() ?? '';
+if (invoked.startsWith('stread-track-')) {
+    console.error(`[fg-tracker-mcp] "${invoked}" está obsoleto: use "fg-tracker-mcp" (o alias será removido na 1.0).`);
+}
+console.error(`[fg-tracker-mcp] API ${config.baseUrl} · token ${config.token ? 'ok' : 'ausente'} · apiKey ${config.apiKey ? 'ok' : 'ausente'}`);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+const shutdown = () => {
+    void server.close().finally(() => process.exit(0));
+};
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB;QACE,GAAG,WAAW,QAAQ,cAAc,uCAAuC;QAC3E,EAAE;QACF,uFAAuF;QACvF,+BAA+B;QAC/B,EAAE;QACF,wBAAwB;QACxB,qEAAqE;QACrE,6FAA6F;QAC7F,sFAAsF;QACtF,oEAAoE;QACpE,2FAA2F;QAC3F,EAAE;QACF,4BAA4B;QAC5B,sHAAsH;QACtH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,cAAc,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;AAC/B,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AACvC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAExC,mEAAmE;AACnE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;AAC5D,IAAI,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;IACxC,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,uEAAuE,CAAC,CAAC;AACrH,CAAC;AACD,OAAO,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,OAAO,YAAY,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,aAAa,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;AAEhJ,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,MAAM,QAAQ,GAAG,GAAS,EAAE;IAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC,CAAC;AACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Cliente HTTP mínimo para a API do FG Tracker (docs/CONTRATO.md §4, §8, §11).
+ * Lê `FG_TRACKER_URL`, `FG_TRACKER_TOKEN` (Bearer de sessão), `FG_TRACKER_API_KEY`
+ * (chave de projeto, header `x-fg-tracker-key`) e `FG_TRACKER_TIMEOUT_MS` — com
+ * fallback para os nomes legados `STREAD_TRACK_*` (`stread-track-mcp` ≤ 0.3).
+ */
+/** API local do monorepo. O endereço definitivo da API será `https://tracker-api.fortground.com.br`. */
+export declare const DEFAULT_URL = "http://localhost:4050";
+/** Header da chave de projeto (a API aceita também o legado `x-stread-track-key`). */
+export declare const API_KEY_HEADER = "x-fg-tracker-key";
+/**
+ * Lê `FG_TRACKER_<name>` e, se ausente/vazia, o legado `STREAD_TRACK_<name>`
+ * (obsoleto, removido na 1.0).
+ */
+export declare function readEnv(name: string, env?: NodeJS.ProcessEnv): string | undefined;
+export interface TrackClientConfig {
+    baseUrl: string;
+    token?: string;
+    apiKey?: string;
+    timeoutMs?: number;
+}
+export type QueryValue = string | number | boolean | undefined | null;
+export declare class TrackApiError extends Error {
+    readonly status: number | undefined;
+    readonly path: string;
+    readonly hint?: string | undefined;
+    constructor(message: string, status: number | undefined, path: string, hint?: string | undefined);
+    /** Mensagem amigável pronta para devolver ao agente. */
+    describe(): string;
+}
+export declare function configFromEnv(env?: NodeJS.ProcessEnv): TrackClientConfig;
+export declare class TrackClient {
+    readonly config: TrackClientConfig;
+    constructor(config: TrackClientConfig);
+    get baseUrl(): string;
+    get hasToken(): boolean;
+    get hasApiKey(): boolean;
+    /** Headers de autenticação: Bearer (sessão) e/ou chave de projeto. */
+    private authHeaders;
+    request<T = unknown>(method: 'GET' | 'POST' | 'PATCH' | 'DELETE', path: string, options?: {
+        query?: Record<string, QueryValue>;
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<T>;
+    get<T = unknown>(path: string, query?: Record<string, QueryValue>): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    patch<T = unknown>(path: string, body?: unknown): Promise<T>;
+}
+export type RangeKey = '15m' | '1h' | '6h' | '24h' | '7d' | '30d';
+export declare const RANGE_KEYS: readonly RangeKey[];
+export declare const RANGE_SECONDS: Record<RangeKey, number>;
+export interface Project {
+    id: string;
+    name: string;
+    slug: string;
+    apiKey: string;
+    slowThresholdMs: number;
+    loopThreshold: number;
+    apdexTargetMs: number;
+    createdAt: string;
+    stats?: {
+        requests24h: number;
+        errorRate24h: number;
+        p95Ms24h: number;
+        openIssues: number;
+    };
+}
+export interface HealthResponse {
+    status: string;
+    database: 'up' | 'down';
+    uptimeSeconds: number;
+    version: string;
+}
+export interface TracesResponse {
+    items: Array<{
+        traceId: string;
+        name: string;
+        method: string | null;
+        statusCode: number | null;
+        startedAt: string;
+        durationMs: number;
+        spanCount: number;
+        dbQueries: number;
+        hasIssue: boolean;
+    }>;
+    nextCursor: string | null;
+}
+export interface LogsResponse {
+    items: Array<{
+        id?: number | string;
+        ts: string;
+        level: number | string;
+        service: string;
+        message: string;
+        context?: Record<string, unknown> | null;
+        traceId?: string | null;
+        spanId?: string | null;
+        requestId?: string | null;
+        env?: string | null;
+        host?: string | null;
+    }>;
+    nextCursor: string | null;
+}

package/dist/client.js

@@ -0,0 +1,166 @@
+/**
+ * Cliente HTTP mínimo para a API do FG Tracker (docs/CONTRATO.md §4, §8, §11).
+ * Lê `FG_TRACKER_URL`, `FG_TRACKER_TOKEN` (Bearer de sessão), `FG_TRACKER_API_KEY`
+ * (chave de projeto, header `x-fg-tracker-key`) e `FG_TRACKER_TIMEOUT_MS` — com
+ * fallback para os nomes legados `STREAD_TRACK_*` (`stread-track-mcp` ≤ 0.3).
+ */
+/** API local do monorepo. O endereço definitivo da API será `https://tracker-api.fortground.com.br`. */
+export const DEFAULT_URL = 'http://localhost:4050';
+/** Header da chave de projeto (a API aceita também o legado `x-stread-track-key`). */
+export const API_KEY_HEADER = 'x-fg-tracker-key';
+/**
+ * Lê `FG_TRACKER_<name>` e, se ausente/vazia, o legado `STREAD_TRACK_<name>`
+ * (obsoleto, removido na 1.0).
+ */
+export function readEnv(name, env = process.env) {
+    return env[`FG_TRACKER_${name}`]?.trim() || env[`STREAD_TRACK_${name}`]?.trim() || undefined;
+}
+export class TrackApiError extends Error {
+    status;
+    path;
+    hint;
+    constructor(message, status, path, hint) {
+        super(message);
+        this.status = status;
+        this.path = path;
+        this.hint = hint;
+        this.name = 'TrackApiError';
+    }
+    /** Mensagem amigável pronta para devolver ao agente. */
+    describe() {
+        return this.hint ? `${this.message}\n\nDica: ${this.hint}` : this.message;
+    }
+}
+export function configFromEnv(env = process.env) {
+    const baseUrl = (readEnv('URL', env) || DEFAULT_URL).replace(/\/+$/, '');
+    const token = readEnv('TOKEN', env);
+    const apiKey = readEnv('API_KEY', env);
+    const timeoutRaw = Number(readEnv('TIMEOUT_MS', env));
+    const timeoutMs = Number.isFinite(timeoutRaw) && timeoutRaw > 0 ? timeoutRaw : 15_000;
+    return { baseUrl, token, apiKey, timeoutMs };
+}
+function buildQuery(query) {
+    if (!query)
+        return '';
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null || value === '')
+            continue;
+        params.set(key, String(value));
+    }
+    const s = params.toString();
+    return s ? `?${s}` : '';
+}
+function isConnectionError(err) {
+    const cause = err?.cause;
+    const code = cause?.code ?? err?.code;
+    if (code && /ECONNREFUSED|ENOTFOUND|ECONNRESET|EAI_AGAIN|UND_ERR_CONNECT_TIMEOUT|EHOSTUNREACH/.test(code))
+        return true;
+    const msg = err instanceof Error ? err.message : String(err);
+    return /fetch failed|ECONNREFUSED|network/i.test(msg);
+}
+function extractMessage(body, fallback) {
+    if (body && typeof body === 'object') {
+        const m = body.message;
+        if (typeof m === 'string')
+            return m;
+        if (Array.isArray(m))
+            return m.map(String).join('; ');
+    }
+    if (typeof body === 'string' && body.trim())
+        return body.slice(0, 300);
+    return fallback;
+}
+export class TrackClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    get baseUrl() {
+        return this.config.baseUrl;
+    }
+    get hasToken() {
+        return Boolean(this.config.token);
+    }
+    get hasApiKey() {
+        return Boolean(this.config.apiKey);
+    }
+    /** Headers de autenticação: Bearer (sessão) e/ou chave de projeto. */
+    authHeaders(extra) {
+        const headers = { accept: 'application/json', ...extra };
+        if (this.config.token)
+            headers.authorization = `Bearer ${this.config.token}`;
+        if (this.config.apiKey)
+            headers[API_KEY_HEADER] = this.config.apiKey;
+        return headers;
+    }
+    async request(method, path, options = {}) {
+        const url = `${this.config.baseUrl}${path}${buildQuery(options.query)}`;
+        const headers = this.authHeaders(options.headers);
+        let init = { method, headers, signal: AbortSignal.timeout(this.config.timeoutMs ?? 15_000) };
+        if (options.body !== undefined) {
+            headers['content-type'] = 'application/json';
+            init = { ...init, body: JSON.stringify(options.body) };
+        }
+        let res;
+        try {
+            res = await fetch(url, init);
+        }
+        catch (err) {
+            if (isConnectionError(err)) {
+                throw new TrackApiError(`API do FG Tracker não está no ar em ${this.config.baseUrl} (conexão recusada).`, undefined, path, 'suba a API com `pnpm dev:api` no monorepo do FG Tracker ou ajuste FG_TRACKER_URL.');
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/abort|timeout/i.test(msg)) {
+                throw new TrackApiError(`Tempo esgotado ao chamar ${method} ${path} em ${this.config.baseUrl}.`, undefined, path);
+            }
+            throw new TrackApiError(`Falha ao chamar ${method} ${path}: ${msg}`, undefined, path);
+        }
+        const text = await res.text();
+        let body = null;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+        }
+        if (res.ok)
+            return body;
+        const message = extractMessage(body, `${res.status} ${res.statusText}`);
+        switch (res.status) {
+            case 401:
+                throw new TrackApiError(`Não autenticado (401) em ${method} ${path}: ${message}`, 401, path, this.config.token
+                    ? 'o FG_TRACKER_TOKEN expirou ou é inválido — faça login de novo (POST /v1/auth/login) e defina FG_TRACKER_TOKEN com o novo token.'
+                    : 'defina FG_TRACKER_TOKEN com um token de sessão do FG Tracker (POST /v1/auth/login → `token`). Para ingestão use FG_TRACKER_API_KEY.');
+            case 403:
+                throw new TrackApiError(`Sem permissão (403) em ${method} ${path}: ${message}`, 403, path, 'o usuário do FG_TRACKER_TOKEN não é membro deste projeto. Peça a um owner/admin para convidá-lo em /members.');
+            case 404:
+                throw new TrackApiError(`Não encontrado (404) em ${method} ${path}: ${message}`, 404, path);
+            case 400:
+                throw new TrackApiError(`Requisição inválida (400) em ${method} ${path}: ${message}`, 400, path);
+            default:
+                throw new TrackApiError(`Erro ${res.status} em ${method} ${path}: ${message}`, res.status, path);
+        }
+    }
+    get(path, query) {
+        return this.request('GET', path, { query });
+    }
+    post(path, body) {
+        return this.request('POST', path, { body });
+    }
+    patch(path, body) {
+        return this.request('PATCH', path, { body });
+    }
+}
+export const RANGE_KEYS = ['15m', '1h', '6h', '24h', '7d', '30d'];
+export const RANGE_SECONDS = {
+    '15m': 15 * 60,
+    '1h': 60 * 60,
+    '6h': 6 * 60 * 60,
+    '24h': 24 * 60 * 60,
+    '7d': 7 * 24 * 60 * 60,
+    '30d': 30 * 24 * 60 * 60,
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/database.d.ts

@@ -0,0 +1,15 @@
+export interface DatabaseDetection {
+    package: string;
+    system: string;
+    adapter: string;
+    manifests: string[];
+    imports: string[];
+}
+/** Local bounded inspection: never read .env, credentials, lockfile contents or execute project code. */
+export declare function detectDatabases(projectPath: string): Promise<{
+    projectPath: string;
+    databases: DatabaseDetection[];
+    truncated: boolean;
+    instructions: string;
+}>;
+export declare function databaseGuide(driver: string, serviceName: string): string;

package/dist/database.js

@@ -0,0 +1,119 @@
+import { readdir, readFile, realpath } from 'node:fs/promises';
+import { join, relative, extname } from 'node:path';
+const DRIVERS = {
+    postgres: { system: 'postgresql', adapter: 'instrumentPostgres' },
+    pg: { system: 'postgresql', adapter: 'instrumentPg' },
+    '@neondatabase/serverless': { system: 'postgresql', adapter: 'generic' },
+    mysql2: { system: 'mysql', adapter: 'instrumentDatabase' },
+    mysql: { system: 'mysql', adapter: 'instrumentDatabase' },
+    mariadb: { system: 'mariadb', adapter: 'instrumentDatabase' },
+    'better-sqlite3': { system: 'sqlite', adapter: 'generic-sync' },
+    sqlite3: { system: 'sqlite', adapter: 'generic' },
+    '@libsql/client': { system: 'libsql', adapter: 'instrumentDatabase' },
+    mongodb: { system: 'mongodb', adapter: 'generic' },
+    mongoose: { system: 'mongodb', adapter: 'generic' },
+    '@prisma/client': { system: 'prisma-provider', adapter: 'generic' },
+    ioredis: { system: 'redis', adapter: 'generic' },
+    redis: { system: 'redis', adapter: 'generic' },
+    mssql: { system: 'mssql', adapter: 'generic' },
+    tedious: { system: 'mssql', adapter: 'generic' },
+    oracledb: { system: 'oracle', adapter: 'instrumentDatabase' },
+    '@aws-sdk/client-dynamodb': { system: 'dynamodb', adapter: 'generic' },
+    '@clickhouse/client': { system: 'clickhouse', adapter: 'generic' },
+    'cassandra-driver': { system: 'cassandra', adapter: 'instrumentDatabase' },
+    couchbase: { system: 'couchbase', adapter: 'generic' },
+    'snowflake-sdk': { system: 'snowflake', adapter: 'generic' },
+    '@elastic/elasticsearch': { system: 'elasticsearch', adapter: 'generic' },
+};
+const SKIP = new Set(['node_modules', 'dist', 'build', 'out', 'coverage', 'vendor', 'infra', 'test-results']);
+/** Local bounded inspection: never read .env, credentials, lockfile contents or execute project code. */
+export async function detectDatabases(projectPath) {
+    const root = await realpath(projectPath);
+    const candidates = new Map();
+    const files = [];
+    let visited = 0;
+    let truncated = false;
+    async function walk(directory, depth) {
+        if (depth > 8) {
+            truncated = true;
+            return;
+        }
+        for (const entry of (await readdir(directory, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
+            if (++visited > 10000) {
+                truncated = true;
+                return;
+            }
+            if (entry.isSymbolicLink() || entry.name.startsWith('.') || SKIP.has(entry.name))
+                continue;
+            const path = join(directory, entry.name);
+            if (entry.isDirectory())
+                await walk(path, depth + 1);
+            else if (entry.name === 'package.json' || ['.ts', '.tsx', '.js', '.mjs', '.cjs'].includes(extname(path)))
+                files.push(path);
+        }
+    }
+    await walk(root, 0);
+    const contents = [];
+    for (const path of files) {
+        const source = await readFile(path, 'utf8');
+        if (source.length > 512_000) {
+            truncated = true;
+            continue;
+        }
+        const name = relative(root, path);
+        if (name.endsWith('package.json')) {
+            let manifest;
+            try {
+                manifest = JSON.parse(source);
+            }
+            catch {
+                continue;
+            }
+            for (const dependency of Object.keys({ ...manifest.dependencies, ...manifest.optionalDependencies })) {
+                const match = DRIVERS[dependency];
+                if (!match)
+                    continue;
+                const current = candidates.get(dependency) ?? { package: dependency, ...match, manifests: [], imports: [] };
+                current.manifests.push(name);
+                candidates.set(dependency, current);
+            }
+        }
+        else if (!/\.(test|spec)\./.test(name))
+            contents.push([name, source]);
+    }
+    for (const [name, source] of contents) {
+        for (const [dependency, match] of Object.entries(DRIVERS)) {
+            const escaped = dependency.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const pattern = new RegExp(`(?:from\\s*|require\\s*\\(\\s*|import\\s*\\(\\s*)['"]${escaped}(?:/[^'"]*)?['"]`, 'g');
+            let found;
+            while ((found = pattern.exec(source))) {
+                const current = candidates.get(dependency) ?? { package: dependency, ...match, manifests: [], imports: [] };
+                current.imports.push(`${name}:${source.slice(0, found.index).split('\n').length}`);
+                candidates.set(dependency, current);
+            }
+        }
+    }
+    return { projectPath: root, databases: [...candidates.values()], truncated,
+        instructions: 'Inspect the reported initialization sites; dependencies are candidates, imports are evidence, not proof of an active production database. Instrument every active client exactly once, at one layer (driver OR ORM). For unknown drivers use traceDatabase/traceDatabaseSync around actual completed operations. Never infer the engine from DATABASE_URL or read secrets. Do not claim automatic support for an unknown cursor/callback lifecycle.' };
+}
+export function databaseGuide(driver, serviceName) {
+    const known = DRIVERS[driver];
+    const system = known?.system ?? 'custom';
+    let snippet;
+    if (driver === 'postgres')
+        snippet = `const raw = postgres(process.env.DATABASE_URL!);\nconst sql = tracker.instrumentPostgres(raw);\nconst db = drizzle(sql); // Drizzle queries, transactions and savepoints use this client`;
+    else if (driver === 'pg')
+        snippet = `const pool = tracker.instrumentPg(new Pool({ connectionString: process.env.DATABASE_URL }));\n// Also instrument clients acquired with pool.connect() when queries use those directly.`;
+    else if (known?.adapter === 'instrumentDatabase')
+        snippet = `const db = tracker.instrumentDatabase(rawClient, {\n  system: '${system}', methods: ['query', 'execute'],\n  statement: (_method, args) => typeof args[0] === 'string' ? args[0] : undefined,\n  callbacks: true, // only for drivers with a final error-first callback\n});\n// Instrument separately acquired transaction connections too. For cursors, wrap consumption instead.`;
+    else if (driver === '@prisma/client')
+        snippet = `const db = prisma.$extends({ query: { $allModels: {\n  async $allOperations({ model, operation, args, query }) {\n    return tracker.traceDatabase({ system: 'prisma', operation: model + '.' + operation }, () => query(args));\n  }\n} } });\n// Cover raw queries separately. Do NOT export args; this captures ORM operation timing, not underlying SQL.`;
+    else if (driver === 'mongodb' || driver === 'mongoose')
+        snippet = `const result = await tracker.traceDatabase(\n  { system: 'mongodb', operation: 'tracks.find' },\n  () => collection.find(filter).toArray(), // include cursor consumption, never serialize filter/documents\n);`;
+    else if (known?.adapter === 'generic-sync')
+        snippet = `const result = tracker.traceDatabaseSync(\n  { system: '${system}', operation: 'query', statement: 'select * from tracks where id = ?' },\n  () => statement.get(id),\n);`;
+    else
+        snippet = `const result = await tracker.traceDatabase(\n  { system: '${system}', operation: 'repository.operation' },\n  () => clientOperation(), // await the real operation; consume cursor/stream here if applicable\n);\n// For callback drivers: await a Promise settled by the operation's final callback.\n// For sync drivers: traceDatabaseSync preserves a synchronous result and throws.`;
+    return `# Database instrumentation: ${driver}\n\nInstall fg-tracker-sdk@^0.4.0 (formerly stread-track-sdk). Reuse the request tracker (${serviceName}); do not create a second tracker for the database.\n\n\`\`\`ts\n${snippet}\n\`\`\`\n\nUse the existing connection settings, pool sizes and transaction boundaries. Generic adapters support any engine when the operation completion is supplied explicitly; they do not auto-understand every driver. Bind values, result rows, documents, connection strings and credentials must never be exported. SQL spans use normalized statements; non-SQL operations use static names. Do not instrument both ORM and driver for the same operation.\n\nImplement these changes at the actual client/repository initialization sites, not merely in an unused example file. Run a real request, use track_get_trace and verify db.query spans share its traceId and have parentSpanId. Verify rollback, errors and parallel requests. Logs-only frontends must not create a tracker. Confirm completion only after the runtime exports the linked query spans.\n`;
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

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

package/dist/docs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Conteúdo estático: resource `fg-tracker://docs/quickstart` e o prompt
+ * `instrument-project`.
+ */
+export declare const QUICKSTART_URI = "fg-tracker://docs/quickstart";
+/** @deprecated URI do `stread-track-mcp` ≤ 0.3; ainda registrada como alias, removida na 1.0. */
+export declare const LEGACY_QUICKSTART_URI = "stread-track://docs/quickstart";
+export declare function quickstartMarkdown(endpoint: string): string;
+export interface InstrumentPromptArgs {
+    projectName?: string;
+    framework?: string;
+}
+export declare function instrumentProjectPrompt(args: InstrumentPromptArgs, endpoint: string): string;