fg-tracker-mcp 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — fg-tracker-mcp
 
+## 0.6.0 — 2026-09-15
+
+- Tool `infra_detect_environments { profiles?, includeRegions? }` (local, somente leitura): lê os perfis de `~/.aws/config`/`~/.aws/credentials` (+ `AWS_PROFILE` e cadeia padrão), `sts:GetCallerIdentity` por perfil (até 10), deduplica por conta, classifica o ambiente pelo nome do perfil/ARN e detecta as regiões em uso (índices do Resource Explorer ou sondagem com `ListStacks` + `GetResources`).
+- `infra_connect_account`: `environment`, `regions` e `name` opcionais e novo `profile`; sem `regions`, detecta as regiões do perfil. Salva `./fg-tracker-connection-<ambiente>.json` e devolve o comando exato `aws cloudformation deploy ... --profile <perfil> --region <região>`, a ser rodado só com confirmação do usuário.
+- Prompt `connect-infrastructure` reescrito: o agente lê projeto/nível/nome da mensagem, detecta os ambientes, cria uma conexão por ambiente (`<nome> · <Ambiente>`), pede confirmação antes do stack, verifica e descobre; argumentos novos `level` e `name`.
+- API: `regions` opcional na criação da conexão (default `["us-east-1"]`) e `connectionId` em cada nó do grafo.
+
+## 0.5.0 — 2026-09-15
+
+- **Infraestrutura AWS** (CONTRATO.md §27.9): tools `infra_connect_account`, `infra_verify_connection`, `infra_discover` (inventário com credenciais locais, somente leitura → snapshot), `infra_analyze_iac` (CDK/SAM/Serverless/Terraform/CI), `infra_assign_resources`, `infra_instrument`, `infra_validate`, `infra_get_diagram`, `infra_plan_handover`, `infra_open_handover_pr` (lock, guard do CI, patch e comandos git/gh — nunca executa push) e `infra_complete_handover`.
+- Prompt `connect-infrastructure` com o roteiro e as regras de segurança (nenhuma mudança na AWS pelo agente; aprovação humana no FG Tracker).
+- Quickstart ganha a seção "Infraestrutura (AWS)". Dependências `@aws-sdk/client-*` e `@aws-sdk/credential-providers`.
+
 ## 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.

package/README.md

@@ -47,6 +47,8 @@ Os nomes antigos `STREAD_TRACK_*` continuam lidos quando o nome novo está ausen
 
 Tools `track_*` (nomes inalterados), prompt `instrument-project` e resource `fg-tracker://docs/quickstart`.
 
+Infraestrutura AWS (0.6.0): tools `infra_*` e prompt `connect-infrastructure` — detectar contas/ambientes/regiões nas credenciais locais, conectar cada ambiente, descobrir recursos com credenciais locais (somente leitura), analisar o IaC, instrumentar, validar e gerar o PR de transferência de controle. Nenhuma tool altera recursos na AWS. Detalhes em `docs/mcp.md` → Infraestrutura.
+
 ## 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.

package/dist/docs.d.ts

@@ -1,6 +1,6 @@
 /**
  * Conteúdo estático: resource `fg-tracker://docs/quickstart` e o prompt
- * `instrument-project`.
+ * `instrument-project` (o prompt `connect-infrastructure` fica em `infra/tools.ts`).
  */
 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. */

package/dist/docs.js

@@ -1,6 +1,6 @@
 /**
  * Conteúdo estático: resource `fg-tracker://docs/quickstart` e o prompt
- * `instrument-project`.
+ * `instrument-project` (o prompt `connect-infrastructure` fica em `infra/tools.ts`).
  */
 export const QUICKSTART_URI = 'fg-tracker://docs/quickstart';
 /** @deprecated URI do `stread-track-mcp` ≤ 0.3; ainda registrada como alias, removida na 1.0. */
@@ -79,6 +79,17 @@ Kinds de span: \`http.server\` (raiz por request), \`db.query\` (nome = SQL norm
 | SLOW_ENDPOINT | raiz \`http.server\` com \`durationMs > slowThresholdMs\` (default 1000) |
 | ERROR | raiz com status ≥ 500 ou \`error != null\` |
 
+## 7. Infraestrutura (AWS)
+Prompt \`connect-infrastructure\` guia o fluxo completo: o agente detecta sozinho contas, ambientes e regiões. Nenhuma tool altera recursos na AWS; a única mudança é o stack de conexão, criado com o comando devolvido e só com confirmação do usuário. Mudanças de infra só pelo FG Tracker, com aprovação humana.
+0. \`infra_detect_environments { profiles?, includeRegions? }\` — perfis do \`~/.aws\` → conta (STS), ambiente sugerido e regiões em uso (local, somente leitura).
+1. Por ambiente: \`infra_connect_account { projectId, level: 'read'|'operate', environment?, regions?, name?, profile? }\` → template \`./fg-tracker-connection-<ambiente>.json\` + \`aws cloudformation deploy ... --profile --region\` (confirmar com o usuário antes) → \`infra_verify_connection { projectId, connectionId, profile }\`.
+2. \`infra_discover { projectId, regions?, profile? }\` — inventário com credenciais locais (Resource Explorer/Tagging API + CloudFormation) enviado como snapshot.
+3. \`infra_analyze_iac { path? }\` — apps CDK, stacks, assets, SAM/Serverless/Terraform e deploys do CI, com viabilidade de handover.
+4. \`infra_assign_resources { projectId, include, exclude? }\` — confirma o que é do projeto.
+5. \`infra_instrument { projectId, path? }\` — plano: \`instrumentAws\`, \`instrumentPgPool\`, \`startInfraReporter({ ecs: true })\`, camada da extensão nas Lambdas, \`wrapLambda\`.
+6. \`infra_validate { projectId }\` (notas dos 4 pilares) e \`infra_get_diagram { projectId }\` (grafo em texto).
+7. \`infra_plan_handover { projectId, stackNames }\` → \`infra_open_handover_pr\` (gera \`infra/fg-tracker.lock.json\`, guard do CI, patch e comandos git/gh) → após o merge \`infra_complete_handover { projectId, stackNames, prUrl }\`.
+
 Ranges aceitos: \`15m|1h|6h|24h|7d|30d\`.
 `;
 }

package/dist/docs.js.map

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCtB,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/infra/aws.d.ts

@@ -0,0 +1,97 @@
+export interface SnapshotResource {
+    arn: string;
+    resourceType: string | null;
+    region: string;
+    name?: string;
+    tags?: Record<string, string>;
+    stackName?: string;
+    stackLogicalId?: string;
+}
+export interface DiscoveryResult {
+    accountId: string;
+    callerArn: string;
+    regions: string[];
+    resources: SnapshotResource[];
+    sources: Record<string, 'resource-explorer' | 'tagging-api' | 'resource-explorer+tagging-api' | 'error'>;
+    stacks: Array<{
+        name: string;
+        region: string;
+        status: string;
+        resources: number;
+        mapped: number;
+        stackId: string;
+    }>;
+    warnings: string[];
+}
+/** Mensagem amigável para erros do AWS SDK (credenciais ausentes/expiradas, acesso negado). */
+export declare function describeAwsError(err: unknown): string;
+export interface ParsedArn {
+    partition: string;
+    service: string;
+    region: string;
+    account: string;
+    resource: string;
+    resourceType: string;
+    resourceId: string;
+}
+export declare function parseArn(arn: string): ParsedArn | null;
+/** ARN → tipo CloudFormation (melhor esforço; null quando desconhecido). */
+export declare function arnToResourceType(arn: string): string | null;
+/** Nome legível a partir do ARN. */
+export declare function nameFromArn(arn: string): string;
+/** Serviço amigável (`lambda`, `ecs.service`…) só para o resumo. */
+export declare function serviceLabel(resourceType: string | null, arn: string): string;
+export interface DiscoverOptions {
+    regions: string[];
+    profile?: string;
+    onProgress?: (message: string) => void;
+}
+export declare function discoverAws(options: DiscoverOptions): Promise<DiscoveryResult>;
+/** Lê os outputs de um stack (DescribeStacks, somente leitura). */
+export declare function readStackOutputs(stackName: string, region: string, profile?: string): Promise<Record<string, string>>;
+export type DetectedEnvironment = 'production' | 'staging' | 'development';
+export declare const CANDIDATE_REGIONS: string[];
+/** Perfis de ~/.aws/config e ~/.aws/credentials (respeita AWS_CONFIG_FILE / AWS_SHARED_CREDENTIALS_FILE) + AWS_PROFILE. */
+export declare function listAwsProfiles(env?: NodeJS.ProcessEnv): Promise<string[]>;
+/** Classifica o ambiente por dicas no nome do perfil/ARN; null = perguntar ao usuário. */
+export declare function classifyEnvironment(...hints: Array<string | null | undefined>): DetectedEnvironment | null;
+export declare const ENVIRONMENT_LABEL: Record<DetectedEnvironment, string>;
+export interface RegionDetection {
+    regionsInUse: string[];
+    stacksPerRegion: Record<string, number>;
+    source: 'resource-explorer' | 'probe';
+    warnings: string[];
+}
+/**
+ * Regiões em uso na conta: índices do Resource Explorer (ListIndexes) quando existem; senão sonda
+ * as regiões candidatas com CloudFormation ListStacks (1ª página) e Tagging GetResources (1 recurso).
+ */
+export declare function detectRegionsInUse(options: {
+    profile?: string;
+    includeRegions?: string[];
+}): Promise<RegionDetection>;
+export interface DetectedAccount {
+    profile: string | null;
+    otherProfiles: string[];
+    accountId: string;
+    arn: string;
+    environment: DetectedEnvironment | null;
+    regionsInUse: string[];
+    stacksPerRegion: Record<string, number>;
+    regionSource: RegionDetection['source'];
+    suggestedConnectionName: string;
+    warnings: string[];
+}
+export interface EnvironmentDetection {
+    accounts: DetectedAccount[];
+    skipped: Array<{
+        profile: string | null;
+        reason: string;
+    }>;
+    profilesFound: string[];
+}
+/** GetCallerIdentity por perfil (até 10), deduplica por conta, classifica ambiente e detecta regiões. */
+export declare function detectEnvironments(options: {
+    profiles?: string[];
+    includeRegions?: string[];
+}): Promise<EnvironmentDetection>;