fg-tracker-mcp 0.10.0 → 0.11.0

package/dist/schemas.js

@@ -0,0 +1,277 @@
+/**
+ * `outputSchema` das ferramentas de leitura (docs/mcp.md, "Saída estruturada").
+ *
+ * - O que vem da API passa por `loose` (`additionalProperties` livre): um campo novo da API
+ *   não quebra a validação de um cliente MCP antigo. Os campos tipados aqui são os que as
+ *   ferramentas e os prompts usam; os vindos da API são opcionais quando uma API anterior
+ *   pode não mandá-los.
+ * - O que o MCP monta (janela, evidência, links) é estrito.
+ */
+import { z } from 'zod';
+export const loose = z.looseObject;
+/** Janela de tempo absoluta (ISO 8601) a que um número se refere. */
+export const windowSchema = z.object({ from: z.string(), to: z.string() });
+/**
+ * Evidência verificável de uma conclusão: um trace (e span) existente, a métrica e o valor
+ * observados e a janela. Abra com tracker_get_trace { traceId } (filtre por `spanId` com o
+ * nome do span) ou pelo recurso fg-tracker://trace/{traceId}.
+ */
+export const evidenceSchema = z.object({
+    traceId: z.string(),
+    spanId: z.string().optional(),
+    metric: z.string(),
+    value: z.union([z.number(), z.string()]),
+    window: windowSchema,
+    note: z.string().optional(),
+});
+/** Mais relevantes primeiro; o texto da ferramenta resume as primeiras. */
+export const evidenceField = z.array(evidenceSchema);
+/** `dashboard: null` quando a URL do painel é desconhecida (defina FG_TRACKER_WEB_URL). */
+export const linksField = z.object({ dashboard: z.string().nullable(), resource: z.string().optional() });
+const num = z.number();
+const optNum = z.number().nullable().optional();
+const optStr = z.string().nullable().optional();
+const strList = z.array(z.string());
+/** Filtros aplicados (variam por ferramenta: traces também têm sort e hasSpan). */
+const filtersField = loose({ rootKind: z.string().optional(), service: z.string().optional(), env: z.string().optional() });
+const traceItem = loose({ traceId: z.string(), name: z.string(), durationMs: num, startedAt: z.string() });
+/* ---------------- núcleo ---------------- */
+export const statusOutput = loose({
+    api: loose({ url: z.string(), status: z.string() }),
+    credential: z.object({
+        kind: z.enum(['access_token', 'session', 'none']).describe('access_token = token pessoal fgt_… (somente leitura, recomendado); session = sessão do painel (lê e escreve)'),
+        type: z.string().nullable(),
+        name: z.string().nullable(),
+        scope: z.string().nullable(),
+        projects: z.union([z.literal('all'), z.number()]).nullable(),
+        expiresAt: z.string().nullable(),
+        expired: z.boolean().nullable(),
+        warning: z.string().nullable(),
+    }),
+    apiKeyConfigured: z.boolean(),
+    readOnlyMode: z.boolean(),
+    maxItems: num,
+    projects: loose({ total: num.nullable(), items: z.array(z.object({ id: z.string(), name: z.string() })), error: z.string().optional() }),
+    ai: loose({ enabled: z.boolean() }).nullable(),
+});
+export const projectsOutput = loose({
+    total: num,
+    returned: num,
+    truncated: z.boolean(),
+    items: z.array(loose({ id: z.string(), name: z.string(), slug: z.string().optional(), apiKey: z.string().optional() })),
+});
+export const overviewOutput = loose({
+    window: windowSchema,
+    range: z.string().optional(),
+    requests: num.optional(),
+    errorRate: num.optional(),
+    p50Ms: num.optional(),
+    p95Ms: num.optional(),
+    p99Ms: num.optional(),
+    openIssues: num.optional(),
+    jobs: loose({}).optional(),
+    services: strList.optional(),
+    environments: strList.optional(),
+});
+export const endpointsOutput = loose({
+    window: windowSchema,
+    filters: filtersField,
+    total: num,
+    returned: num,
+    items: z.array(loose({ name: z.string(), requests: num.optional(), p95Ms: num.optional(), errorRate: num.optional() })),
+});
+export const issuesOutput = loose({
+    items: z.array(loose({ id: z.string(), sampleTraceId: optStr })),
+    nextCursor: z.string().nullable(),
+    total: num,
+    evidence: evidenceField,
+});
+export const tracesOutput = loose({
+    window: windowSchema,
+    filters: filtersField,
+    items: z.array(traceItem),
+    nextCursor: z.string().nullable(),
+    evidence: evidenceField,
+});
+export const traceOutput = loose({
+    traceId: z.string(),
+    name: z.string().optional(),
+    durationMs: num.optional(),
+    statusCode: optNum,
+    spanPage: loose({ total: num, nextSpanOffset: num.nullable() }),
+    spans: z.array(loose({})),
+    evidence: evidenceField,
+    links: linksField,
+});
+export const logsOutput = loose({
+    window: windowSchema,
+    items: z.array(loose({ ts: z.string(), message: z.string() })),
+    nextCursor: z.string().nullable(),
+});
+export const guideOutput = loose({
+    framework: z.string(),
+    projectId: z.string().nullable(),
+    serviceName: z.string().nullable(),
+    apiKeyIncluded: z.boolean(),
+    databaseDriver: z.string().nullable(),
+    markdown: z.string(),
+});
+export const verifyIngestOutput = loose({
+    window: windowSchema,
+    spans: z.object({ ok: z.boolean(), lastTrace: traceItem.nullable() }),
+    logs: z.object({ ok: z.boolean(), available: z.boolean(), last: loose({ ts: z.string() }).nullable(), error: z.string().nullable() }),
+    verdict: z.enum(['ok', 'nothing']),
+    evidence: evidenceField,
+});
+export const issueOutput = loose({
+    id: z.string().optional(),
+    title: z.string().optional(),
+    type: z.string().optional(),
+    count: num.optional(),
+    evidence: evidenceField,
+    links: linksField,
+});
+export const releasesOutput = loose({
+    version: z.string().nullable(),
+    items: z.array(loose({ version: z.string() })).optional(),
+    detail: loose({}).optional(),
+});
+export const historyOutput = loose({
+    name: z.string().optional(),
+    days: num.optional(),
+    bucketHours: num.optional(),
+    points: z.array(loose({ ts: z.string() })).optional(),
+    markers: z.array(loose({ version: z.string(), at: z.string() })).optional(),
+    filters: z.object({ service: z.string().optional(), env: z.string().optional() }),
+    filtersApplied: z.boolean().describe('false = a API não filtra o histórico por service/env (os números misturam todos)'),
+});
+export const providersOutput = loose({
+    window: windowSchema,
+    totalRequests: num.optional(),
+    errorRate: num.optional(),
+    items: z.array(loose({ host: z.string() })),
+});
+export const trafficOutput = loose({
+    window: z.object({ fromDay: z.string(), toDay: z.string() }),
+    empty: z.boolean(),
+    totals: loose({}).optional(),
+    lastRollupAt: z.string().nullable().optional(),
+    notes: strList,
+});
+export const monitorsOutput = loose({
+    total: num,
+    returned: num,
+    truncated: z.boolean(),
+    items: z.array(loose({ id: z.string(), name: z.string(), slug: z.string(), status: z.string() })),
+});
+export const monitorOutput = loose({
+    id: z.string(),
+    name: z.string().optional(),
+    status: z.string().optional(),
+    checks: z.array(loose({ at: z.string(), status: z.string() })),
+    evidence: evidenceField,
+});
+export const detectDatabasesOutput = loose({
+    databases: z.array(loose({ package: z.string() })),
+    guide: z.string(),
+});
+/* ---------------- diagnóstico (0.11) ---------------- */
+export const endpointOutput = loose({
+    window: windowSchema,
+    filters: filtersField,
+    name: z.string(),
+    requests: num.optional(),
+    errorRate: num.optional(),
+    p50Ms: num.optional(),
+    p95Ms: num.optional(),
+    p99Ms: num.optional(),
+    slowestTraces: z.array(loose({ traceId: z.string(), durationMs: num })).optional(),
+    evidence: evidenceField,
+    links: linksField,
+});
+export const queriesOutput = loose({
+    window: windowSchema,
+    filters: z.object({ service: z.string().optional(), env: z.string().optional(), search: z.string().optional() }),
+    filtersApplied: z.boolean().describe('false = a API ignorou service/env: os números misturam ambientes e serviços'),
+    totalQueries: num.optional(),
+    totalMs: num.optional(),
+    avgMs: num.optional(),
+    total: num,
+    items: z.array(loose({ name: z.string(), count: num, p95Ms: num })),
+    environments: strList.optional(),
+    evidence: evidenceField,
+    links: linksField,
+});
+export const logStatsOutput = loose({
+    window: windowSchema,
+    totals: z.object({ error: num, warn: num, info: num, debug: num, all: num }),
+    histogram: z.array(loose({ ts: z.string() })),
+    facets: loose({ services: z.array(loose({ name: z.string(), count: num })), envs: z.array(loose({ name: z.string(), count: num })) }),
+});
+export const alertEventsOutput = loose({
+    window: windowSchema.nullable(),
+    filters: z.object({ type: strList.optional(), severity: strList.optional(), state: z.string().optional() }),
+    items: z.array(loose({
+        id: z.string(),
+        type: z.string(),
+        severity: z.string(),
+        firedAt: z.string(),
+        state: z.enum(['firing', 'resolved']).nullable(),
+    })),
+    scanned: num,
+    nextCursor: z.string().nullable(),
+    evidence: evidenceField,
+});
+export const environmentsOutput = loose({
+    window: windowSchema,
+    environments: z.array(z.object({
+        name: z.string(),
+        versions: num.nullable(),
+        lastSeen: z.string().nullable(),
+        inTelemetry: z.boolean(),
+    })),
+    services: strList,
+});
+/* ---------------- infra e testes de carga (ferramentas locais/de leitura) ---------------- */
+export const reportOutput = loose({
+    report: z.string(),
+});
+export const infraEnvironmentsOutput = loose({
+    accounts: z.array(loose({ accountId: z.string(), environment: z.string().nullable(), regionsInUse: strList })),
+    skipped: z.array(loose({ reason: z.string() })),
+    profilesFound: strList,
+});
+export const routesOutput = loose({
+    format: z.enum(['text', 'json']),
+    report: z.string().optional(),
+    scan: loose({ root: z.string(), routes: z.array(loose({})) }).optional(),
+});
+export const scenariosOutput = loose({
+    total: num,
+    items: z.array(loose({})),
+});
+export const planOutput = loose({
+    preset: z.string(),
+    plan: loose({}),
+    warnings: strList,
+});
+const compareSide = loose({
+    mode: z.enum(['window', 'release']),
+    release: z.string().nullable(),
+    from: z.string(),
+    to: z.string(),
+    coverage: z.enum(['full', 'partial', 'none']).describe('Spans brutos na janela (retenção): sem eles, não há decomposição'),
+    source: z.enum(['raw', 'rollup', 'none']),
+    totals: loose({ p95Ms: num }).nullable(),
+});
+export const compareOutput = loose({
+    a: compareSide,
+    b: compareSide,
+    delta: loose({ p95Ms: num }).nullable(),
+    routes: z.array(loose({ name: z.string() })),
+    decomposition: loose({ delta: loose({ db: num, httpClient: num, custom: num, gap: num }) }).nullable(),
+    topSpans: z.array(loose({ kind: z.string(), name: z.string(), deltaMs: num })).nullable(),
+    evidence: evidenceField,
+    notes: strList,
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/server.d.ts

@@ -1,16 +1,18 @@
 /**
- * Servidor MCP do FG Tracker (docs/CONTRATO.md §12): tools, prompt e resource.
+ * Servidor MCP do FG Tracker (docs/CONTRATO.md §12, docs/mcp.md): tools, prompts e resources.
  * 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.10.0";
+export declare const SERVER_VERSION = "0.11.0";
 export interface CreateServerOptions {
     client?: TrackClient;
     /** Registra também os nomes antigos `track_*` (default: `FG_TRACKER_LEGACY_TOOL_NAMES`, ligado se ausente). */
     legacyToolNames?: boolean;
+    /** Só registra ferramentas com `readOnlyHint: true` (default: `FG_TRACKER_READ_ONLY`, desligado se ausente). */
+    readOnly?: boolean;
 }
 /** Prefixo das ferramentas próprias do FG Tracker (`infra_*` e `loadtest_*` têm o seu). */
 export declare const TOOL_PREFIX = "tracker_";
@@ -19,6 +21,13 @@ export declare const TOOL_PREFIX = "tracker_";
  * registrados como aliases, para clientes com permissões ou prompts salvos com eles; saem na 1.0.
  */
 export declare const LEGACY_TOOL_PREFIX = "track_";
+/**
+ * Ferramentas que já existiam com o nome `track_*` (0.10.0) e por isso ganham o alias.
+ * Ferramentas novas não ganham: não há permissão nem prompt salvo com um nome que nunca existiu.
+ */
+export declare const LEGACY_ALIASED_TOOLS: ReadonlySet<string>;
 export declare function legacyToolNamesFromEnv(env?: NodeJS.ProcessEnv): boolean;
+/** `FG_TRACKER_READ_ONLY=1` (ou true/on/yes): só as ferramentas de leitura ficam visíveis. */
+export declare function readOnlyFromEnv(env?: NodeJS.ProcessEnv): boolean;
 export declare function createServer(options?: CreateServerOptions): McpServer;
 export type { ToolText };