Rastreabilidade entre implementação e documentação
English · Matriz de compatibilidade
Esta auditoria mapeia capacidades públicas para implementação autoritativa, ponto de entrada do usuário, rotas do portal e evidência automatizada representativa. A revisão usou o código de feat/mcp-server-integration para as candidatas CLI 1.8.0, VS Code 1.1.0 e MCP 1.0.0. “Corrigido” significa que esta auditoria alterou documentação ou metadados de release; não significa que a candidata foi publicada.
| Funcionalidade | Implementação | CLI / MCP / VS Code | README | Portal EN | Portal PT-BR | Testes | Status |
|---|---|---|---|---|---|---|---|
| Inicialização e configuração do repositório | src/AdrGuard/Cli/InitCommand.cs; Configuration/* |
CLI, comando VS Code | READMEs raiz e extensão | /product/cli/ |
/pt-br/product/cli/ |
InitCommandIntegrationTests; AdrGuardConfigurationLoaderTests |
Correto |
| Validação canônica, nomes, lifecycle, supersession e relacionamentos | Parsing/*; Validation/*; Cli/CheckCommand.cs |
CLI, VS Code, MCP validate_adrs |
READMEs raiz, extensão e MCP | /product/cli/; /product/relationships/ |
/pt-br/product/cli/; /pt-br/product/relationships/ |
AdrValidatorTests; testes de nomes/lifecycle/relacionamentos |
Corrigido |
| MADR 4.0 e perfis de validação | Parsing/AdrMarkdownParser.cs; Validation/AdrFormat.cs; factories de política |
CLI, VS Code, MCP | READMEs raiz e extensão | /product/madr-4/ |
/pt-br/product/madr-4/ |
Madr4ValidationTests; Madr4CommandIntegrationTests |
Correto |
| Validação incremental e baselines de diagnóstico | Git/GitChangeDetector.cs; Baselines/*; Cli/BaselineCommand.cs |
CLI, VS Code | READMEs raiz e extensão | /product/incremental-validation/ |
/pt-br/product/incremental-validation/ |
IncrementalCheckIntegrationTests; BaselineCommandIntegrationTests |
Corrigido |
| Relatórios texto, JSON e SARIF | Cli/CheckReportRenderer.cs; Cli/ValidationOutput.cs |
CLI, Problems no VS Code | READMEs raiz e extensão | /product/reports/ |
/pt-br/product/reports/ |
CheckReportIntegrationTests; checkReport.test.ts |
Correto |
| Índice padrão e catálogo enriquecido | Indexing/*; Cli/IndexCommand.cs |
CLI, ação interna da Webview | READMEs raiz e extensão | /product/cli/ |
/pt-br/product/cli/ |
AdrIndexGeneratorTests; GovernanceReportIntegrationTests; testes de features |
Corrigido |
| Criação offline e templates | Generation/AdrNewService.cs; templates/loaders; Cli/NewCommand.cs |
CLI, VS Code | READMEs raiz e extensão | /product/creation/; /product/custom-templates/ |
Rotas pt-BR equivalentes | NewCommandIntegrationTests; regressão de templates |
Correto |
| Contratos estruturados de criação/edição visual | Cli/NewFormCommand.cs; EditFormCommand.cs; Editing/* |
Contrato CLI, VS Code | READMEs raiz e extensão | /product/creation/; /product/vscode-extension/ |
Rotas pt-BR equivalentes | testes de formulário CLI e Webview | Corrigido |
| Draft assistido por IA | Generation/AdrGenerationService.cs; providers; Cli/DraftCommand.cs |
CLI, ação interna da Webview | READMEs raiz e extensão | /product/ai-drafting/ |
/pt-br/product/ai-drafting/ |
testes de draft/provider/contexto/segurança e features | Correto |
| Review técnico consultivo e compare ref | Review/*; Cli/ReviewCommand.cs |
CLI, ação interna da Webview | READMEs raiz e extensão | /product/ai-review/; /product/comparative-review/ |
Rotas pt-BR equivalentes | testes de review, política, segurança, relatório e comparação | Correto |
| Impacto arquitetural | Impact/*; Git/GitChangeInventoryReader.cs; Cli/ImpactCommand.cs |
CLI, ação interna VS Code, MCP analyze_impact |
READMEs raiz, extensão e MCP | /product/architecture-impact/ |
/pt-br/product/architecture-impact/ |
contratos/case study/CLI de impacto; MCP | Correto |
| Drift arquitetural e evidência limitada | Drift/*; Cli/DriftCommand.cs |
CLI, ação interna VS Code, MCP verify_architecture |
READMEs raiz, extensão e MCP | /product/architectural-drift/ |
/pt-br/product/architectural-drift/ |
engine/contratos/case study/CLI de drift; MCP | Correto |
| Listagem visual, busca, filtros, ordenação, navegação e workspace | webview/adrListModel.ts; explorer/*; workspace.ts |
VS Code | README da extensão | /product/vscode-extension/; guia visual |
Rotas pt-BR equivalentes | adrListModel.test.ts; integração Explorer/multi-root |
Correto |
| Validação ao salvar e Problems | extensions/vscode/src/validation/*; contracts/checkReport.ts |
VS Code | README da extensão | /product/vscode-extension/ |
/pt-br/product/vscode-extension/ |
scheduler/diagnósticos/integração | Correto |
| Ações visuais de arquitetura, governança e IA | commands/visualFeatures.ts; webview/featureMessages.ts; media/newAdrForm.js |
Ações internas da Webview, não comandos da Command Palette | README da extensão | README sincronizado e guia visual | Equivalentes pt-BR | contratos/argumentos/mensagens/Webview | Corrigido |
| Semântica de Voltar, Cancelar, Salvar e Executar | commands/newAdrForm.ts; media/newAdrForm.js |
Webview VS Code | README da extensão | README sincronizado e guia visual | Equivalentes pt-BR | newAdrFormWebview.test.ts; settings |
Corrigido |
| Registro MCP opcional, descoberta, trust e multi-root | extensions/vscode/src/mcp/*; configuration.ts; extension.ts |
Provider MCP do VS Code | READMEs extensão e MCP | /product/mcp-configuration/; /product/vscode-extension/ |
Equivalentes pt-BR | mcpDiscovery.test.ts; activation/multi-root/trust |
Corrigido |
| Ferramentas de listar/ler/pesquisar ADRs | AdrGuardMcpTools.cs; McpWorkspace.cs |
MCP list_adrs, get_adr, search_adrs |
README do MCP | /product/mcp-tools/ |
/pt-br/product/mcp-tools/ |
McpWorkspaceTests; integração com cliente real |
Correto |
| Ferramenta de relacionamentos declarados | Mesmos módulos MCP e validador compartilhado | MCP get_adr_relationships |
README do MCP | /product/mcp-tools/ |
/pt-br/product/mcp-tools/ |
testes de workspace/integração MCP | Correto |
| Runtime, limites, cancelamento, erros e segurança somente leitura do MCP | McpServerApplication.cs; McpServerOptions.cs; McpResponseLimit.cs; wrapper das ferramentas |
MCP | README do MCP | /product/mcp-security/; /product/mcp-configuration/ |
Equivalentes pt-BR | testes de workspace/integração MCP | Correto |
| Contrato de distribuição NuGet/Registry MCP | .csproj MCP; .mcp/server.json; mcp-release.yml |
Distribuição MCP | README e changelog MCP | /product/mcp-release/ |
/pt-br/product/mcp-release/ |
McpDistributionContractTests; jobs de pacote/instalação |
Corrigido |
| Compatibilidade e publicação com versões independentes | três manifests; workflows de release | CLI, VS Code, MCP | READMEs raiz, extensão e MCP | páginas de CLI/extensão/MCP e esta referência | Equivalentes pt-BR | políticas de release, manifesto, VSIX e pacote | Corrigido |
A sintaxe completa da CLI continua autoritativa em adr-guard --help e no --help de cada comando. Entradas e saídas MCP continuam autoritativas na descoberta de ferramentas e nos contratos schema 1.0. Entradas da Command Palette são somente os comandos contribuídos por extensions/vscode/package.json; ações de arquitetura, governança e IA são internas à Webview retida.