fg-tracker-mcp 0.4.0

package/dist/guide.js

@@ -0,0 +1,490 @@
+/**
+ * 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 const FRAMEWORKS = ['express', 'nestjs', 'nextjs', 'fastify', 'pino', 'winston'];
+const PLACEHOLDER_KEY = 'stk_SUA_CHAVE_AQUI';
+function envBlock(input) {
+    const key = input.apiKey ?? PLACEHOLDER_KEY;
+    return [
+        '```bash',
+        '# .env (não commitar a chave)',
+        `FG_TRACKER_KEY=${key}`,
+        `FG_TRACKER_URL=${input.endpoint}`,
+        '```',
+    ].join('\n');
+}
+function install(extra = []) {
+    const pkgs = ['fg-tracker-sdk@^0.4.0', ...extra].join(' ');
+    return [
+        '```bash',
+        `pnpm add ${pkgs}`,
+        `# npm install ${pkgs}  |  yarn add ${pkgs}`,
+        '```',
+        '',
+        '> Dentro do monorepo do FG Tracker use `"fg-tracker-sdk": "workspace:*"`. Projetos que já usam `stread-track-sdk` só trocam o nome do pacote nos imports (mesma API; as variáveis `STREAD_TRACK_*` continuam lidas como fallback).',
+    ].join('\n');
+}
+function header(input, title) {
+    const lines = [`# ${title}`, ''];
+    if (input.projectName && input.projectId) {
+        lines.push(`Projeto: **${input.projectName}** (\`${input.projectId}\`). A chave abaixo é a chave real deste projeto — trate como segredo.`);
+    }
+    else {
+        lines.push(`Nenhum projeto informado: o código usa o placeholder \`${PLACEHOLDER_KEY}\`. Crie um projeto com \`track_create_project { name }\` (ou use \`track_list_projects\`) e chame este guia de novo com \`projectId\` para receber a chave real.`);
+    }
+    lines.push('', `API do FG Tracker: \`${input.endpoint}\`.`, '');
+    return lines.join('\n');
+}
+function trackerFile(input, path, service) {
+    return [
+        `\`\`\`ts`,
+        `// ${path}`,
+        `import { createTracker } from 'fg-tracker-sdk';`,
+        ``,
+        `export const tracker = createTracker({`,
+        `  apiKey: process.env.FG_TRACKER_KEY!,          // ${input.apiKey ?? PLACEHOLDER_KEY}`,
+        `  endpoint: process.env.FG_TRACKER_URL ?? '${input.endpoint}',`,
+        `  serviceName: '${service}',`,
+        `  flushIntervalMs: 2000,`,
+        `});`,
+        `\`\`\``,
+    ].join('\n');
+}
+const PG_BLOCK = [
+    '```ts',
+    "// onde o Pool é criado (antes de passá-lo ao drizzle/kysely/knex)",
+    "import { Pool } from 'pg';",
+    "import { tracker } from './tracker.js';",
+    '',
+    'export const pool = tracker.instrumentPg(new Pool({ connectionString: process.env.DATABASE_URL }));',
+    '// queries repetidas ≥ loop_threshold vezes no mesmo request viram issue N_PLUS_ONE',
+    '```',
+].join('\n');
+const FETCH_BLOCK = [
+    '```ts',
+    '// chamadas HTTP de saída → spans http.client (alimenta a detecção de LOOP)',
+    "import { tracker } from './tracker.js';",
+    '',
+    'export const fetchTracked = tracker.wrapFetch();       // use no lugar de fetch',
+    '// ou, global (afeta todo o processo):',
+    '// globalThis.fetch = tracker.wrapFetch(globalThis.fetch);',
+    '',
+    '// spans manuais para trechos relevantes',
+    "await tracker.span('custom', 'send-email', async (span) => { span.setAttribute('to', email); /* ... */ });",
+    '```',
+].join('\n');
+function logsSection(input, service, logger) {
+    const key = input.apiKey ?? PLACEHOLDER_KEY;
+    const shipper = [
+        '```ts',
+        '// src/logs.ts — um shipper por processo; correlaciona traceId/spanId automaticamente',
+        "import { createLogShipper } from 'fg-tracker-sdk';",
+        '',
+        'export const logShipper = createLogShipper({',
+        `  apiKey: process.env.FG_TRACKER_KEY!,          // ${key}`,
+        `  endpoint: process.env.FG_TRACKER_URL ?? '${input.endpoint}',`,
+        `  service: '${service}',`,
+        "  env: process.env.NODE_ENV ?? 'development',",
+        '  flushIntervalMs: 2000,',
+        '  maxBatch: 200,                                   // a API aceita até 500 por lote',
+        '});',
+        '```',
+    ].join('\n');
+    const pino = [
+        '```ts',
+        '// pino v7+ (transport roda em worker thread: passa as opções, não o shipper)',
+        "import pino from 'pino';",
+        '',
+        'export const logger = pino({',
+        "  level: process.env.LOG_LEVEL ?? 'info',",
+        '  transport: {',
+        '    targets: [',
+        "      { target: 'pino-pretty', options: {} },                  // opcional, console",
+        '      {',
+        "        target: 'fg-tracker-sdk/pino',",
+        '        options: {',
+        `          apiKey: process.env.FG_TRACKER_KEY,               // ${key}`,
+        `          endpoint: process.env.FG_TRACKER_URL ?? '${input.endpoint}',`,
+        `          service: '${service}',`,
+        "          env: process.env.NODE_ENV ?? 'development',",
+        '        },',
+        '      },',
+        '    ],',
+        '  },',
+        '});',
+        '```',
+    ].join('\n');
+    const winston = [
+        '```ts',
+        "import winston from 'winston';",
+        "import { winstonTransport } from 'fg-tracker-sdk/winston';",
+        "import { logShipper } from './logs.js';",
+        '',
+        'export const logger = winston.createLogger({',
+        "  level: process.env.LOG_LEVEL ?? 'info',",
+        '  format: winston.format.json(),',
+        '  transports: [',
+        '    new winston.transports.Console(),',
+        '    winstonTransport(logShipper),                  // envia cada log ao FG Tracker',
+        '  ],',
+        '});',
+        '```',
+    ].join('\n');
+    const nest = [
+        '```ts',
+        '// src/main.ts — LoggerService do Nest que espelha no console e envia',
+        "import { nestLogger } from 'fg-tracker-sdk';",
+        "import { logShipper } from './logs.js';",
+        '',
+        'const app = await NestFactory.create(AppModule, { logger: nestLogger(logShipper) });',
+        '```',
+    ].join('\n');
+    const raw = [
+        '```ts',
+        '// qualquer logger: envie direto pelo shipper',
+        "logShipper.log({ level: 'info', message: 'pedido criado', context: { orderId } });",
+        '```',
+    ].join('\n');
+    const parts = ['## Logs (opcional, recomendado)', '', shipper, ''];
+    if (logger === 'pino')
+        parts.push(pino);
+    else if (logger === 'winston')
+        parts.push(winston);
+    else if (logger === 'nest')
+        parts.push(nest, '', 'Se o app usa pino ou winston, chame `track_instrumentation_guide { framework: "pino" | "winston" }` para o transport correspondente.');
+    else
+        parts.push(raw, '', 'Com pino ou winston, chame `track_instrumentation_guide { framework: "pino" | "winston" }` para o transport pronto.');
+    parts.push('', 'Contrato (§11): o shipper envia lotes para `POST /v1/logs` com o header `x-fg-tracker-key`; níveis `trace|debug|info|warn|error|fatal`; `traceId`/`spanId` são preenchidos automaticamente quando o log acontece dentro de um request instrumentado pelo tracker. Se os exports `fg-tracker-sdk/pino` e `fg-tracker-sdk/winston` ainda não existirem na versão instalada do SDK, envie os logs direto para `POST /v1/logs` (veja o resource `fg-tracker://docs/quickstart`).');
+    return parts.join('\n');
+}
+function verifySection(input) {
+    const lines = [
+        '## Verificar',
+        '',
+        '1. Suba o app e gere algumas requisições (ex.: `curl http://localhost:PORTA/rota`).',
+        '2. Aguarde ~3 s (flush a cada 2 s).',
+    ];
+    if (input.projectId) {
+        lines.push(`3. Chame \`track_verify_ingest { projectId: "${input.projectId}" }\` — deve reportar spans (e logs) recentes.`);
+    }
+    else {
+        lines.push('3. Chame `track_verify_ingest { projectId }` — deve reportar spans (e logs) recentes.');
+    }
+    lines.push('4. Se nada chegou: confira `FG_TRACKER_KEY` (4xx no envio = chave inválida, o SDK loga uma vez), se a API responde em `' +
+        input.endpoint +
+        '/v1/health`, e se `app.use(tracker.express())` é o PRIMEIRO middleware.', '', 'Depois, `track_get_overview`, `track_list_endpoints` e `track_list_issues` mostram o que foi coletado.');
+    return lines.join('\n');
+}
+export function buildGuide(input) {
+    const service = input.serviceName ?? input.projectName?.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '') ?? 'minha-app';
+    switch (input.framework) {
+        case 'express':
+            return [
+                header(input, 'Instrumentar Express com FG Tracker'),
+                '## 1. Instalar',
+                install(),
+                '',
+                '## 2. Variáveis de ambiente',
+                envBlock(input),
+                '',
+                '## 3. Tracker (um por processo)',
+                trackerFile(input, 'src/tracker.ts', service),
+                '',
+                '## 4. Middleware — PRIMEIRO da cadeia',
+                '```ts',
+                '// src/app.ts',
+                "import express from 'express';",
+                "import { tracker } from './tracker.js';",
+                '',
+                'const app = express();',
+                'app.use(tracker.express());          // antes de json(), cors, helmet, rotas...',
+                'app.use(express.json());',
+                '',
+                "app.get('/users/:id', async (req, res) => {",
+                "  const { rows } = await pool.query('select * from users where id = $1', [req.params.id]);",
+                '  res.json(rows[0]);',
+                '});',
+                '',
+                'app.listen(3000);',
+                '',
+                "process.on('SIGTERM', () => tracker.shutdown().finally(() => process.exit(0)));   // não perder os últimos spans",
+                '```',
+                '',
+                'O middleware cria um span raiz `http.server` por request, nomeado `GET /users/:id` (rota real do Express, com `baseUrl` de routers montados). Status ≥ 500 vira erro.',
+                '',
+                '## 5. Banco (pg)',
+                PG_BLOCK,
+                '',
+                '## 6. HTTP de saída e spans manuais',
+                FETCH_BLOCK,
+                '',
+                logsSection(input, service, 'any'),
+                '',
+                verifySection(input),
+            ].join('\n');
+        case 'nestjs':
+            return [
+                header(input, 'Instrumentar NestJS (platform-express) com FG Tracker'),
+                '## 1. Instalar',
+                install(),
+                '',
+                'O SDK é ESM. Em projetos Nest (CommonJS) funciona com `require()` no Node ≥ 22.12 ou via `await import("fg-tracker-sdk")`.',
+                '',
+                '## 2. Variáveis de ambiente',
+                envBlock(input),
+                '',
+                '## 3. Tracker + middleware em `main.ts`',
+                '```ts',
+                '// src/main.ts',
+                "import { NestFactory } from '@nestjs/core';",
+                "import { createTracker } from 'fg-tracker-sdk';",
+                "import { AppModule } from './app.module';",
+                '',
+                'export const tracker = createTracker({',
+                `  apiKey: process.env.FG_TRACKER_KEY!,          // ${input.apiKey ?? PLACEHOLDER_KEY}`,
+                `  endpoint: process.env.FG_TRACKER_URL ?? '${input.endpoint}',`,
+                `  serviceName: '${service}',`,
+                '});',
+                '',
+                'async function bootstrap() {',
+                '  const app = await NestFactory.create(AppModule);',
+                '  app.use(tracker.express());        // antes de helmet/cors/pipes/prefixo global',
+                '  app.enableShutdownHooks();',
+                '  await app.listen(Number(process.env.PORT ?? 3000));',
+                '}',
+                'bootstrap();',
+                '```',
+                '',
+                '```ts',
+                '// src/app.module.ts (ou qualquer provider) — flush no encerramento',
+                "import { Module, OnApplicationShutdown } from '@nestjs/common';",
+                "import { tracker } from './main';",
+                '',
+                '@Module({ /* ... */ })',
+                'export class AppModule implements OnApplicationShutdown {',
+                '  async onApplicationShutdown() { await tracker.shutdown(); }',
+                '}',
+                '```',
+                '',
+                '## 4. Banco (pg) — instrumente o Pool no provider que o cria',
+                '```ts',
+                '// src/database/database.module.ts',
+                "import { Module } from '@nestjs/common';",
+                "import { Pool } from 'pg';",
+                "import { tracker } from '../main';",
+                '',
+                "export const PG_POOL = 'PG_POOL';",
+                '',
+                '@Module({',
+                '  providers: [{',
+                '    provide: PG_POOL,',
+                '    useFactory: () => tracker.instrumentPg(new Pool({ connectionString: process.env.DATABASE_URL })),',
+                '  }],',
+                '  exports: [PG_POOL],',
+                '})',
+                'export class DatabaseModule {}',
+                '// TypeORM/Prisma: sem hook direto ainda — use tracker.span("db.query", "nome", fn) nos repositórios críticos',
+                '```',
+                '',
+                '## 5. HTTP de saída e spans manuais',
+                FETCH_BLOCK,
+                '',
+                logsSection(input, service, 'nest'),
+                '',
+                verifySection(input),
+            ].join('\n');
+        case 'nextjs':
+            return [
+                header(input, 'Instrumentar Next.js (App Router, runtime Node) com FG Tracker'),
+                '## 1. Instalar',
+                install(),
+                '',
+                '## 2. Variáveis de ambiente',
+                envBlock(input),
+                '',
+                'Só no servidor (sem `NEXT_PUBLIC_`). Route handlers precisam de `export const runtime = "nodejs"` (default) — não funciona no Edge. Em `output: "export"` não há handlers dinâmicos, nada a instrumentar.',
+                '',
+                '## 3. Tracker (singleton, sobrevive ao HMR)',
+                '```ts',
+                '// src/lib/tracker.ts',
+                "import { createTracker, type Tracker } from 'fg-tracker-sdk';",
+                '',
+                'const g = globalThis as unknown as { __fgTracker?: Tracker };',
+                'export const tracker: Tracker =',
+                '  g.__fgTracker ??',
+                '  (g.__fgTracker = createTracker({',
+                `    apiKey: process.env.FG_TRACKER_KEY!,        // ${input.apiKey ?? PLACEHOLDER_KEY}`,
+                `    endpoint: process.env.FG_TRACKER_URL ?? '${input.endpoint}',`,
+                `    serviceName: '${service}',`,
+                '  }));',
+                '```',
+                '',
+                '## 4. Route handlers',
+                '```ts',
+                '// app/api/users/[id]/route.ts',
+                "import { tracker } from '@/lib/tracker';",
+                "import { pool } from '@/lib/db';",
+                '',
+                'export const GET = tracker.wrapNextRoute(async (_req, ctx: { params: Promise<{ id: string }> }) => {',
+                '  const { id } = await ctx.params;',
+                "  const { rows } = await pool.query('select * from users where id = $1', [id]);",
+                '  return Response.json(rows[0] ?? null, { status: rows[0] ? 200 : 404 });',
+                '});',
+                '',
+                'export const POST = tracker.wrapNextRoute(async (req) => {',
+                '  const body = await req.json();',
+                '  // ...',
+                '  return Response.json({ ok: true }, { status: 201 });',
+                '});',
+                '```',
+                '',
+                'O span `http.server` recebe `GET /api/users/:id` (uuids/números normalizados) e o status da `Response`; exceções viram `error`.',
+                '',
+                '## 5. Server Actions / código fora de route handlers',
+                '```ts',
+                "'use server';",
+                "import { tracker } from '@/lib/tracker';",
+                '',
+                'export async function createOrder(input: FormData) {',
+                "  return tracker.span('custom', 'action createOrder', async (span) => {",
+                "    span.setAttribute('items', input.getAll('item').length);",
+                '    // ...',
+                '  });',
+                '}',
+                '```',
+                '',
+                '## 6. Banco (pg)',
+                '```ts',
+                '// src/lib/db.ts',
+                "import { Pool } from 'pg';",
+                "import { tracker } from '@/lib/tracker';",
+                '',
+                'const g = globalThis as unknown as { __pgPool?: Pool };',
+                'export const pool = g.__pgPool ?? (g.__pgPool = tracker.instrumentPg(new Pool({ connectionString: process.env.DATABASE_URL })));',
+                '```',
+                '',
+                '## 7. HTTP de saída',
+                FETCH_BLOCK.replace("./tracker.js", '@/lib/tracker'),
+                '',
+                logsSection(input, service, 'any'),
+                '',
+                verifySection(input),
+            ].join('\n');
+        case 'fastify':
+            return [
+                header(input, 'Instrumentar Fastify com FG Tracker'),
+                'O SDK não tem plugin Fastify dedicado; o middleware Express funciona num hook `onRequest` sobre `request.raw`/`reply.raw` (o hook chama `done` dentro do contexto assíncrono do span, então `instrumentPg`, `wrapFetch` e `tracker.span` enxergam o request).',
+                '',
+                '## 1. Instalar',
+                install(),
+                '',
+                '## 2. Variáveis de ambiente',
+                envBlock(input),
+                '',
+                '## 3. Tracker',
+                trackerFile(input, 'src/tracker.ts', service),
+                '',
+                '## 4. Plugin (hook onRequest)',
+                '```ts',
+                '// src/plugins/fg-tracker.ts',
+                "import fp from 'fastify-plugin';",
+                "import type { FastifyPluginCallback } from 'fastify';",
+                "import { tracker } from '../tracker.js';",
+                '',
+                'const middleware = tracker.express();',
+                '',
+                'const fgTrackerPlugin: FastifyPluginCallback = (fastify, _opts, done) => {',
+                "  fastify.addHook('onRequest', (request, reply, next) => {",
+                '    // rota declarada (ex.: /users/:id) para nomear o span como no Express',
+                '    const raw = request.raw as typeof request.raw & { route?: { path?: string }; originalUrl?: string };',
+                '    raw.route = { path: request.routeOptions?.url ?? undefined };',
+                '    raw.originalUrl = request.url;',
+                '    middleware(raw as never, reply.raw as never, (err?: unknown) => next(err as Error | undefined));',
+                '  });',
+                '  done();',
+                '};',
+                '',
+                "export default fp(fgTrackerPlugin, { name: 'fg-tracker' });",
+                '```',
+                '',
+                '```ts',
+                '// src/server.ts',
+                "import Fastify from 'fastify';",
+                "import fgTracker from './plugins/fg-tracker.js';",
+                "import { tracker } from './tracker.js';",
+                '',
+                'const app = Fastify({ logger: true });',
+                'await app.register(fgTracker);          // antes das rotas',
+                '',
+                "app.get('/users/:id', async (req) => {",
+                "  const { id } = req.params as { id: string };",
+                "  const { rows } = await pool.query('select * from users where id = $1', [id]);",
+                '  return rows[0];',
+                '});',
+                '',
+                "app.addHook('onClose', async () => { await tracker.shutdown(); });",
+                "await app.listen({ port: Number(process.env.PORT ?? 3000), host: '0.0.0.0' });",
+                '```',
+                '',
+                'Se o `fastify-plugin` não estiver no projeto: `pnpm add fastify-plugin` (ou registre o hook direto na instância principal — o hook precisa ficar no escopo raiz para valer para todas as rotas).',
+                '',
+                '## 5. Banco (pg)',
+                PG_BLOCK,
+                '',
+                '## 6. HTTP de saída e spans manuais',
+                FETCH_BLOCK,
+                '',
+                '## Alternativa: ingestão crua',
+                'Se preferir não usar o hook, envie spans direto para `POST /v1/ingest` com o header `x-fg-tracker-key` (formato em `fg-tracker://docs/quickstart`).',
+                '',
+                logsSection(input, service, 'pino'),
+                '',
+                '> Fastify já usa pino internamente: passe o transport acima em `Fastify({ logger: { transport: { targets: [...] } } })` para enviar os logs do próprio Fastify.',
+                '',
+                verifySection(input),
+            ].join('\n');
+        case 'pino':
+            return [
+                header(input, 'Enviar logs do pino para o FG Tracker'),
+                '## 1. Instalar',
+                install(),
+                '',
+                '## 2. Variáveis de ambiente',
+                envBlock(input),
+                '',
+                logsSection(input, service, 'pino').replace('## Logs (opcional, recomendado)', '## 3. Transport'),
+                '',
+                '## 4. Correlação com traces',
+                'Se o processo também usa o tracker (`createTracker` + `tracker.express()`), cada log emitido durante um request ganha `traceId`/`spanId` e aparece com link para o trace no console. Sem tracker, os logs chegam normalmente, só sem correlação.',
+                '',
+                '## 5. Sintaxe de busca (`track_search_logs` e página /logs)',
+                '- texto livre → busca full-text (`websearch_to_tsquery`); `"frase exata"` entre aspas;',
+                '- `key=value` → filtra `context->>key`;',
+                '- `~trecho` → ILIKE (substring, via trigram).',
+                '',
+                verifySection(input),
+            ].join('\n');
+        case 'winston':
+            return [
+                header(input, 'Enviar logs do winston para o FG Tracker'),
+                '## 1. Instalar',
+                install(),
+                '',
+                '## 2. Variáveis de ambiente',
+                envBlock(input),
+                '',
+                logsSection(input, service, 'winston').replace('## Logs (opcional, recomendado)', '## 3. Shipper + transport'),
+                '',
+                '## 4. Correlação com traces',
+                'Se o processo também usa o tracker (`createTracker` + `tracker.express()`), cada log emitido durante um request ganha `traceId`/`spanId`. Chame `logShipper.flush()` (ou `tracker.shutdown()` + `logShipper.shutdown()`) no encerramento para não perder o último lote.',
+                '',
+                '## 5. Sintaxe de busca (`track_search_logs` e página /logs)',
+                '- texto livre → full-text; `"frase exata"` entre aspas; `key=value` → `context->>key`; `~trecho` → substring.',
+                '',
+                verifySection(input),
+            ].join('\n');
+    }
+}
+//# sourceMappingURL=guide.js.map

package/dist/guide.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Servidor MCP do FG Tracker (docs/CONTRATO.md §12): tools, prompt e resource.
+ * O transporte (stdio) é conectado em `cli.ts`.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TrackClient } from './client.js';
+import { type ToolText } from './format.js';
+export declare const SERVER_NAME = "fg-tracker";
+export declare const SERVER_VERSION = "0.4.0";
+export interface CreateServerOptions {
+    client?: TrackClient;
+}
+export declare function createServer(options?: CreateServerOptions): McpServer;
+export type { ToolText };