fg-tracker-mcp 0.4.0

package/dist/docs.js

@@ -0,0 +1,127 @@
+/**
+ * Conteúdo estático: resource `fg-tracker://docs/quickstart` e o prompt
+ * `instrument-project`.
+ */
+export const QUICKSTART_URI = 'fg-tracker://docs/quickstart';
+/** @deprecated URI do `stread-track-mcp` ≤ 0.3; ainda registrada como alias, removida na 1.0. */
+export const LEGACY_QUICKSTART_URI = 'stread-track://docs/quickstart';
+export function quickstartMarkdown(endpoint) {
+    return `# FG Tracker — quickstart
+
+APM leve para Node: traces (Express/NestJS/Next.js/Fastify), queries pg, chamadas HTTP de saída, logs e detecção automática de **N+1**, **loops**, **endpoints lentos** e **erros**. API em \`${endpoint}\` (Swagger em \`${endpoint}/docs\`).
+
+## 1. Projeto e chave
+- \`track_list_projects\` lista os projetos do usuário do token; \`track_create_project { name }\` cria um e devolve \`apiKey\` (\`stk_...\`).
+- A chave vai no header \`x-fg-tracker-key\` da ingestão e em \`FG_TRACKER_KEY\` no app instrumentado.
+
+## 2. SDK (\`fg-tracker-sdk\`)
+\`\`\`ts
+import { createTracker } from 'fg-tracker-sdk';
+const tracker = createTracker({
+  apiKey: process.env.FG_TRACKER_KEY!, endpoint: '${endpoint}', serviceName: 'minha-app',
+  release: process.env.FG_TRACKER_RELEASE,    // ou detectado de GITHUB_SHA/VERCEL_GIT_COMMIT_SHA → "minha-app@<sha>"
+  instrumentGlobalFetch: true,                // chamadas a provedores (OpenRouter, Mureka…) viram spans http.client + traceparent
+  captureGlobalErrors: true,                  // uncaughtException/unhandledRejection viram issues
+});
+app.use(tracker.express());                 // Express / NestJS — PRIMEIRO middleware (continua traceparent, lê req.user.id)
+app.use(routes); app.use(tracker.expressErrorHandler()); // exceção real no span → issues por causa, não por status
+tracker.instrumentPg(pool); // pg only; use track_detect_databases for other drivers                 // pg.Pool → spans db.query
+const fetchTracked = tracker.wrapFetch();   // fetch → spans http.client
+export const GET = tracker.wrapNextRoute(async (req) => Response.json({ ok: true }));   // Next.js
+await tracker.span('custom', 'send-email', async (span) => { /* ... */ });
+tracker.setUser({ id: user.id });           // impacto por usuário nas issues
+await tracker.checkIn('backup-diario', () => runBackup(), { intervalSeconds: 86400 }); // monitor de job (§18)
+await tracker.shutdown();                   // no SIGTERM
+\`\`\`
+No deploy: \`npx fg-tracker-release --service minha-app --previous-sha $PREV\` registra a release com commits/arquivos (commits suspeitos nas issues, comparação de latência entre versões).
+Use \`track_instrumentation_guide { framework, projectId }\` para o passo a passo completo por framework com a chave real.
+
+## 3. Logs
+\`\`\`ts
+import { createLogShipper } from 'fg-tracker-sdk';
+const shipper = createLogShipper({ apiKey, endpoint: '${endpoint}', service: 'minha-app', env: 'production' });
+// pino:    pino({ transport: { target: 'fg-tracker-sdk/pino', options: { apiKey, endpoint, service } } })
+// winston: import { winstonTransport } from 'fg-tracker-sdk/winston'; transports: [winstonTransport(shipper)]
+// nest:    NestFactory.create(AppModule, { logger: nestLogger(shipper) })
+\`\`\`
+Logs emitidos dentro de um request instrumentado ganham \`traceId\`/\`spanId\`.
+
+## 4. Ingestão crua (qualquer linguagem)
+\`\`\`bash
+curl -X POST ${endpoint}/v1/ingest -H 'content-type: application/json' -H 'x-fg-tracker-key: stk_...' -d '{
+  "traces": [{ "traceId": "0123456789abcdef0123456789abcdef", "spans": [
+    { "spanId": "0123456789abcdef", "parentSpanId": null, "kind": "http.server", "name": "GET /users/:id",
+      "method": "GET", "route": "/users/:id", "statusCode": 200,
+      "startedAt": "2026-09-12T12:00:00.000Z", "endedAt": "2026-09-12T12:00:00.123Z", "durationMs": 123.4,
+      "attributes": { "url": "/users/42" }, "error": null } ] }] }'
+# → 202 { "accepted": 1, "issuesDetected": 0 }
+
+curl -X POST ${endpoint}/v1/logs -H 'content-type: application/json' -H 'x-fg-tracker-key: stk_...' -d '{
+  "logs": [{ "ts": "2026-09-12T12:00:00.000Z", "level": "info", "service": "minha-app", "message": "pedido criado", "context": { "orderId": 42 } }] }'
+# → 202 { "accepted": 1 }
+\`\`\`
+Kinds de span: \`http.server\` (raiz por request), \`db.query\` (nome = SQL normalizado), \`http.client\`, \`custom\`.
+
+## 5. Verificar e explorar
+- \`track_verify_ingest { projectId }\` — confirma spans/logs recentes.
+- \`track_get_overview { projectId, range }\` — requests, erro, p50/p95/p99, apdex, top lentos.
+- \`track_list_endpoints\`, \`track_list_issues\`, \`track_list_traces\` → \`track_get_trace { traceId }\` (waterfall).
+- \`track_search_logs { projectId, q, service, level, range }\` — sintaxe: texto livre, \`"frase"\`, \`key=value\`, \`~substring\`.
+- \`track_get_issue { projectId, issueId }\` — ocorrências, usuários afetados, releases, regressões e commits/PRs suspeitos.
+- \`track_list_releases { projectId, version? }\`, \`track_register_release\`, \`track_endpoint_history { projectId, name, days }\` — saúde por deploy e latência por rota ao longo do tempo.
+- \`track_list_providers { projectId, range }\` (chamadas de saída por host) e \`track_list_monitors { projectId }\` (uptime e jobs).
+
+## 6. Detectores (rodam na ingestão)
+| tipo | regra |
+|---|---|
+| N_PLUS_ONE | ≥ \`loopThreshold\` (default 10) queries iguais sob o mesmo pai no mesmo trace |
+| LOOP | ≥ \`loopThreshold\` spans \`http.client\`/\`custom\` iguais sob o mesmo pai |
+| SLOW_ENDPOINT | raiz \`http.server\` com \`durationMs > slowThresholdMs\` (default 1000) |
+| ERROR | raiz com status ≥ 500 ou \`error != null\` |
+
+Ranges aceitos: \`15m|1h|6h|24h|7d|30d\`.
+`;
+}
+export function instrumentProjectPrompt(args, endpoint) {
+    const fw = args.framework ? `O usuário indicou o framework **${args.framework}**; confirme lendo o código antes de seguir.` : 'O framework NÃO foi informado: detecte-o.';
+    const proj = args.projectName
+        ? `Use (ou crie) o projeto chamado **${args.projectName}** no FG Tracker.`
+        : 'Nenhum nome de projeto foi informado: use o nome do pacote (`package.json#name`) ou o nome do diretório.';
+    return `Você vai conectar o projeto de código atual ao FG Tracker (APM em ${endpoint}) usando as tools deste servidor MCP. Trabalhe passo a passo, mostre o que fez em cada etapa e só avance quando a anterior estiver ok.
+
+${fw} ${proj}
+
+## Plano
+
+1. **Detectar framework e logger.** Leia \`package.json\` (dependências: express, @nestjs/core, next, fastify; pino, winston; pg, drizzle-orm, kysely, knex) e o ponto de entrada (\`src/main.ts\`, \`src/index.ts\`, \`app/\`). Anote: framework HTTP, logger, os drivers e os pontos de criação dos clientes, gerenciador de pacotes (lockfile) e como o app é iniciado.
+
+2. **Detectar bancos.** Chame \`track_detect_databases { projectPath, serviceName }\`. Confirme os imports e pontos de criação retornados; siga o adapter de cada driver ativo. Não suponha pg.Pool para Postgres.js, Prisma ou outro driver.
+
+2b. **Checar o FG Tracker.** Chame \`track_status\`. Se a API estiver fora do ar ou faltar \`FG_TRACKER_TOKEN\`, pare e explique ao usuário o que configurar.
+
+3. **Escolher ou criar o projeto.** Chame \`track_list_projects\`. Se já existe um projeto com o nome esperado, use-o; senão \`track_create_project { name }\`. Guarde \`projectId\` e \`apiKey\`. Nunca imprima a chave em commits/logs — só em \`.env\` (confira que \`.env\` está no \`.gitignore\`; adicione a variável em \`.env.example\` sem o valor).
+
+4. **Obter o guia.** Chame \`track_instrumentation_guide { framework, projectId }\` para o framework detectado. Se o app tem pino ou winston, chame também com \`framework: "pino"\` ou \`"winston"\`.
+
+5. **Instalar o SDK.** \`pnpm add fg-tracker-sdk\` (ou npm/yarn conforme o lockfile). Se o projeto já usa \`stread-track-sdk\`, troque pelo \`fg-tracker-sdk\` (mesma API).
+
+6. **Aplicar a instrumentação** seguindo o guia, com edits mínimos e idiomáticos ao projeto:
+   - criar o tracker (um por processo) com \`apiKey\` de \`process.env.FG_TRACKER_KEY\` e \`endpoint\` de \`FG_TRACKER_URL\`;
+   - registrar \`tracker.express()\` como PRIMEIRO middleware (Express/Nest), \`wrapNextRoute\` nos route handlers (Next) ou o hook \`onRequest\` (Fastify);
+   - aplicar o adapter retornado por \`track_detect_databases\` ao cliente real antes de passá-lo ao ORM; para drivers desconhecidos envolver a conclusão da operação com \`traceDatabase\` ou \`traceDatabaseSync\`;
+   - \`tracker.wrapFetch()\` para chamadas HTTP de saída relevantes;
+   - transport de logs (pino/winston/nest) com \`createLogShipper\`;
+   - \`tracker.shutdown()\` no encerramento (SIGTERM / \`onApplicationShutdown\` / \`onClose\`).
+
+7. **Variáveis de ambiente.** Adicione \`FG_TRACKER_KEY=<apiKey>\` e \`FG_TRACKER_URL=${endpoint}\` ao \`.env\` local (e os nomes ao \`.env.example\`).
+
+8. **Rodar e gerar tráfego.** Inicie o app, faça algumas requisições reais (curl nas rotas principais, inclusive uma que consulte o banco) e aguarde ~3 s.
+
+9. **Verificar.** Chame \`track_verify_ingest { projectId }\`. Se chegaram spans (e logs, quando configurados), mostre um resumo com \`track_get_overview { projectId, range: "15m" }\` e \`track_list_issues\`.
+
+10. **Corrigir.** Se nada chegou: confira a chave (o SDK loga "4xx" uma vez quando ela é inválida), a ordem do middleware, se o tracker foi criado antes do app subir, se o processo consegue alcançar ${endpoint} (\`curl ${endpoint}/v1/health\`) e se há \`enabled: false\`. Ajuste e repita o passo 8.
+
+Ao final, liste os arquivos alterados, as variáveis adicionadas e o resultado de \`track_verify_ingest\`.`;
+}
+// Database driver detection must precede selection of an integration adapter.
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAC7D,iGAAiG;AACjG,MAAM,CAAC,MAAM,qBAAqB,GAAG,gCAAgC,CAAC;AAEtE,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO;;gMAEuL,QAAQ,oBAAoB,QAAQ;;;;;;;;;;oDAUhL,QAAQ;;;;;;;;;;;;;;;;;;;;;wDAqBJ,QAAQ;;;;;;;;;eASjD,QAAQ;;;;;;;;eAQR,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;CAwBtB,CAAC;AACF,CAAC;AAOD,MAAM,UAAU,uBAAuB,CAAC,IAA0B,EAAE,QAAgB;IAClF,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,mCAAmC,IAAI,CAAC,SAAS,8CAA8C,CAAC,CAAC,CAAC,2CAA2C,CAAC;IAC1K,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW;QAC3B,CAAC,CAAC,qCAAqC,IAAI,CAAC,WAAW,mBAAmB;QAC1E,CAAC,CAAC,0GAA0G,CAAC;IAE/G,OAAO,qEAAqE,QAAQ;;EAEpF,EAAE,IAAI,IAAI;;;;;;;;;;;;;;;;;;;;;;;;wFAwB4E,QAAQ;;;;;;yMAMyG,QAAQ,YAAY,QAAQ;;0GAE3H,CAAC;AAC3G,CAAC;AAED,8EAA8E"}

package/dist/format.d.ts

@@ -0,0 +1,27 @@
+export interface ToolText {
+    [x: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export declare const MAX_SERIES_POINTS = 48;
+export declare const MAX_LIST_ITEMS = 25;
+export declare const MAX_TRACE_SPANS = 80;
+export declare function text(value: string): ToolText;
+export declare function json(value: unknown, preface?: string): ToolText;
+export declare function errorResult(err: unknown): ToolText;
+/** Executa `fn` e converte qualquer exceção em resultado `isError`. */
+export declare function guard(fn: () => Promise<ToolText>): Promise<ToolText>;
+/** Reduz uma série mantendo a distribuição (amostragem uniforme). */
+export declare function sampleSeries<T>(series: T[], max?: number): T[];
+export declare function truncateList<T>(list: T[], max?: number): {
+    items: T[];
+    truncated: number;
+};
+/** Compacta recursivamente: `series` viram amostras, arrays longos são cortados. */
+export declare function compact(value: unknown, depth?: number): unknown;
+export declare function ms(value: number | null | undefined): string;
+export declare function pct(value: number | null | undefined): string;
+export declare function ago(iso: string, now?: number): string;

package/dist/format.js

@@ -0,0 +1,103 @@
+/**
+ * Helpers de saída: compactação de payloads grandes (mesma regra do §7 do
+ * contrato — séries ≤ 48 pontos, listas ≤ 25 itens, traces ≤ 80 spans) e
+ * conversão para o formato de resultado do MCP.
+ */
+import { TrackApiError } from './client.js';
+export const MAX_SERIES_POINTS = 48;
+export const MAX_LIST_ITEMS = 25;
+export const MAX_TRACE_SPANS = 80;
+export function text(value) {
+    return { content: [{ type: 'text', text: value }] };
+}
+export function json(value, preface) {
+    const body = JSON.stringify(value, null, 2);
+    return text(preface ? `${preface}\n\n${body}` : body);
+}
+export function errorResult(err) {
+    const message = err instanceof TrackApiError ? err.describe() : err instanceof Error ? err.message : String(err);
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+/** Executa `fn` e converte qualquer exceção em resultado `isError`. */
+export async function guard(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        return errorResult(err);
+    }
+}
+/** Reduz uma série mantendo a distribuição (amostragem uniforme). */
+export function sampleSeries(series, max = MAX_SERIES_POINTS) {
+    if (series.length <= max)
+        return series;
+    const step = series.length / max;
+    const out = [];
+    for (let i = 0; i < max; i++) {
+        const item = series[Math.floor(i * step)];
+        if (item !== undefined)
+            out.push(item);
+    }
+    return out;
+}
+export function truncateList(list, max = MAX_LIST_ITEMS) {
+    if (list.length <= max)
+        return { items: list, truncated: 0 };
+    return { items: list.slice(0, max), truncated: list.length - max };
+}
+/** Compacta recursivamente: `series` viram amostras, arrays longos são cortados. */
+export function compact(value, depth = 0) {
+    if (Array.isArray(value)) {
+        const { items, truncated } = truncateList(value);
+        const out = items.map((v) => compact(v, depth + 1));
+        return truncated > 0 ? [...out, `… +${truncated} itens omitidos`] : out;
+    }
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if ((k === 'series' || k === 'seriesQueriesPerMin' || k === 'histogram') && Array.isArray(v)) {
+                out[k] = sampleSeries(v);
+                if (v.length > MAX_SERIES_POINTS)
+                    out[`${k}Points`] = `${v.length} pontos, amostrados para ${MAX_SERIES_POINTS}`;
+            }
+            else if (k === 'spans' && Array.isArray(v)) {
+                const { items, truncated } = truncateList(v, MAX_TRACE_SPANS);
+                out[k] = items;
+                if (truncated > 0)
+                    out.spansOmitted = truncated;
+            }
+            else if (k === 'sparkline' && Array.isArray(v)) {
+                out[k] = v; // 24 pontos, já pequeno
+            }
+            else {
+                out[k] = compact(v, depth + 1);
+            }
+        }
+        return out;
+    }
+    return value;
+}
+export function ms(value) {
+    if (value === null || value === undefined || Number.isNaN(value))
+        return '—';
+    return `${Math.round(value)} ms`;
+}
+export function pct(value) {
+    if (value === null || value === undefined || Number.isNaN(value))
+        return '—';
+    return `${(value * 100).toFixed(2)}%`;
+}
+export function ago(iso, now = Date.now()) {
+    const t = Date.parse(iso);
+    if (Number.isNaN(t))
+        return iso;
+    const s = Math.max(0, Math.round((now - t) / 1000));
+    if (s < 60)
+        return `há ${s} s`;
+    if (s < 3600)
+        return `há ${Math.round(s / 60)} min`;
+    if (s < 86400)
+        return `há ${(s / 3600).toFixed(1)} h`;
+    return `há ${(s / 86400).toFixed(1)} d`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/guide.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Guia de instrumentação: passos + código copiável por framework/logger,
+ * usando a chave real do projeto quando disponível. Segue o SDK atual
+ * (packages/sdk/README.md) e os transports de logs do §11 do contrato.
+ */
+export declare const FRAMEWORKS: readonly ["express", "nestjs", "nextjs", "fastify", "pino", "winston"];
+export type Framework = (typeof FRAMEWORKS)[number];
+export interface GuideInput {
+    framework: Framework;
+    databaseDriver?: string;
+    /** URL base da API do FG Tracker (endpoint do SDK). */
+    endpoint: string;
+    /** Chave do projeto; sem ela usa placeholder. */
+    apiKey?: string;
+    projectName?: string;
+    projectId?: string;
+    serviceName?: string;
+}
+export declare function buildGuide(input: GuideInput): string;