MdaMeX
Configure estudos geomecânicos, execute ajustes de modelos em um ambiente HPC e
consulte os resultados diretamente no VS Code. A extensão reúne a edição de
arquivos .mdamex, a validação de entradas, o acompanhamento de jobs Slurm e os
leitores de resultados .mmout e .outh5.
Índice
Requisitos e instalação
- VS Code 1.75 ou superior, com uma pasta de trabalho confiável aberta.
- Acesso SSH ao ambiente HPC e permissão para utilizar os recursos Slurm do seu ambiente.
- Backend MdaMeX instalado no Linux, com suporte ao fluxo de estudos, e solver GeomecBR disponível no ambiente de execução.
- Pasta de modelos e resultados acessível pelo VS Code e pelo backend, com mapeamentos de caminhos configurados na extensão ou fornecidos pelo bootstrap.
- Arquivo de bootstrap corporativo: configuração dos perfis de conexão, executável e caminhos do ambiente.
A extensão é um cliente do backend; sua instalação não instala o backend, o solver
ou o Slurm. Workspaces virtuais e o modo restrito do VS Code não são suportados.
Para instalar um pacote .vsix, abra a visualização Extensões, acesse o menu
… e escolha Install from VSIX…. Selecione o pacote recebido.
Configurar o ambiente
- Abra a pasta do projeto que contém
studies/base/input.mdamex e studies/base/model/.
- Abra a paleta de comandos (
Ctrl+Shift+P; Cmd+Shift+P no macOS) e execute MdaMeX: Importar bootstrap corporativo.
- Selecione o arquivo JSON de bootstrap fornecido para seu ambiente no seletor de arquivos.
- Execute MdaMeX: Configurar credenciais SSH, se o perfil exigir senha ou passphrase. Perfis com agente SSH usam o agente configurado.
- Execute MdaMeX: Testar conexões SSH para verificar o acesso ao orquestrador e ao Slurm.
As credenciais são armazenadas no armazenamento de segredos do VS Code. Elas não
devem ser incluídas no arquivo científico .mdamex nem no bootstrap.
O usuário SSH é descoberto automaticamente com os.userInfo().username no sistema
onde o host da extensão está executando (Windows local ou ambiente remoto, como
Remote SSH/WSL). Para usar outro login, procure mdamex.connection.user nos
Settings do usuário ou configure:
"mdamex.connection.user": "seu-login"
Esse setting tem prioridade sobre a descoberta automática e vale para o orquestrador
e o Slurm em todos os perfis. Espaços nas extremidades são removidos e o login é
convertido para minúsculas, como no vshpc. Vazio restaura a descoberta automática;
o valor descoberto não é gravado nos settings nem no bootstrap.
O bootstrap e o ambiente corporativo não definem o usuário. Arquivos e caches antigos
que contenham user continuam legíveis, mas o campo é descartado. Atualizações do
bootstrap preservam a escolha dos settings. Se a descoberta falhar, a extensão pede
que você configure mdamex.connection.user.
Depois de mudar o login, feche e reabra os painéis de estudos e jobs. Senhas e
passphrases são associadas ao usuário, host e perfil; execute Configurar credenciais
SSH para o novo login, quando necessário.
Os hosts SSH podem ser ajustados nos Settings do usuário, por nome de perfil. O
caminho do executável remoto é um input de texto simples:
{
"mdamex.connection.orchestratorHosts": {
"geomec-hpc": "orchestrator.example.org"
},
"mdamex.connection.slurmHosts": {
"geomec-hpc": "slurm.example.org"
},
"mdamex.connection.executable": "/opt/mdamex/bin/mdamex"
}
Um perfil é uma entrada do bootstrap, como geomec-hpc; somente o bootstrap
cria perfis. Os três Settings têm escopo Usuário: valores de workspace e pasta
não são usados. A extensão mantém somente as entradas dos perfis carregados nos
mapas de hosts; uma chave extra não cria perfil e é removida ao carregar o ambiente.
Os valores de host que ainda correspondem ao padrão da revisão anterior acompanham
as atualizações do bootstrap. Um valor diferente é tratado como override pessoal e
é preservado. Uma entrada vazia restaura o valor atual do bootstrap. O input
mdamex.connection.executable aceita um caminho Unix absoluto e, quando preenchido,
aplica o mesmo executável a todos os perfis; vazio preserva o caminho individual de
cada perfil no bootstrap. Uma inicialização pendente só pode ser retomada com o
mesmo executável salvo na operação.
O bootstrap pode marcar cada endpoint com hostMode: "enforced" e o perfil com
executableMode: "enforced". Nesses casos, o valor do bootstrap prevalece sobre
os Settings pessoais. A política é independente por endpoint/perfil; sem enforced,
continua valendo o comportamento normal de override.
Após alterar hosts, feche e reabra os painéis e configure as credenciais do novo
destino, quando necessário. Portas, autenticação e fingerprints continuam vindo
do perfil.
O host do Slurm nos Settings controla as conexões da extensão para consultar jobs
e testar SSH. As simulações e o diagnóstico nativo do backend usam
execution.sshHost do arquivo .mdamex. O endereço WebSocket de um serviço já
iniciado continua vindo do seu arquivo de descoberta service.json.
Para a primeira carga, configure mdamex.bootstrapSource com uma URL-base HTTPS
(com ou sem / final), uma URL direta terminada em .json ou um caminho local
absoluto para o arquivo, ou importe o JSON com MdaMeX: Importar bootstrap corporativo.
Depois da importação, se mdamex.bootstrapSource estiver vazio, a extensão usa o
updateSource HTTPS-base do bootstrap em cache, sem nome de arquivo. Se o campo
updateSourceMode estiver ausente ou for default, um mdamex.bootstrapSource
explícito prevalece; com updateSourceMode: "enforced", a origem do bootstrap em
cache prevalece sobre o Setting nas atualizações seguintes. Na instalação inicial,
antes de haver um bootstrap em cache, é necessário importar o JSON ou configurar
mdamex.bootstrapSource. URLs-base HTTPS tentam, a partir da versão SemVer da
extensão, bootstrap-v<major>.<minor>.json, depois bootstrap-v<major>.json e,
por fim, bootstrap.json na raiz do repositório. Só tenta o próximo nome se o
servidor responder HTTP 404. URLs diretas terminadas em .json e caminhos locais
absolutos apontam diretamente para o arquivo, sem sufixação.
A busca remota é HTTPS GET com validação TLS padrão do Node.js, timeout de 10 s e
limite de 2 MiB. A resposta deve ser HTTP 200; redirects, URLs SSH, credenciais,
query strings e fragmentos não são aceitos. Apenas HTTP 404 ativa o próximo nome;
403, outros status, falhas de rede/TLS e JSON inválido encerram a tentativa sem
trocar o cache. Não há autenticação por token ou certificado de cliente. O cache
só muda depois de validar o schema e aceitar a revisão crescente.
mdamex.bootstrapAutoUpdate vem habilitado e consulta a origem ao iniciar o VS Code
e quando a origem muda. MdaMeX: Atualizar bootstrap corporativo solicita uma
atualização manual; MdaMeX: Importar bootstrap corporativo seleciona um JSON
completo. O cache atual só é substituído depois de baixar/ler, validar o schema e
aceitar a revisão. Falha de rede, TLS ou validação preserva o último bootstrap
válido. A atualização automática não exibe diálogo; tentativas e falhas ficam no
canal MdaMeX Log. As atualizações manuais pela paleta apresentam o resultado.
Por padrão, a extensão conecta diretamente ao orquestrador. Se o ambiente exigir
proxy HTTP/PAC, procure MdaMeX: Orchestrator Connection Mode nas configurações
do VS Code e selecione system. Também é possível configurar por projeto:
"mdamex.orchestrator.connectionMode": "system"
O modo system segue o proxy do VS Code e do ambiente. O padrão direct acessa
o endpoint do orquestrador sem proxy HTTP/PAC, preservando autenticação e validação
TLS. A escolha vale na próxima conexão; feche e reabra um painel já conectado.
Essa opção não modifica o bootstrap, o SSH ou o proxy das outras conexões.
Mapear o workspace para o Linux
Execute MdaMeX: Configurar mapeamento workspace → Linux pela paleta ou pelo
menu de contexto de uma pasta no Explorer. Selecione a pasta, o escopo de gravação
(usuário, workspace ou pasta) e informe os caminhos correspondentes. O comando
permite adicionar, editar, remover e restaurar a herança, com prévia antes de salvar.
Não exige reimportar o bootstrap nem alterar os perfis SSH.
Na interface de Settings (Ctrl+,), procure mdamex.pathMappings. Na aba
Usuário, use Adicionar Item para incluir a origem e o destino. Cada linha
permite editar ou remover a associação, sem abrir o JSON nem usar o comando assistido.
Também é possível configurar por workspace ou pasta.
O equivalente em settings.json é:
"mdamex.pathMappings": {
"R:\\modelos": "/res/usuarios/usuario/modelos",
"/mnt/modelos": "/res/usuarios/usuario/modelos"
}
A origem é um caminho absoluto visto pelo host da extensão: uma unidade Windows,
um compartilhamento UNC ou uma montagem Linux. Em Remote SSH/WSL, use o caminho
visto nesse ambiente. O destino é o caminho absoluto da mesma pasta no Linux do backend.
A cada conversão, a extensão:
- Procura uma correspondência nos settings
mdamex.pathMappings da pasta relevante.
- Somente se nenhuma regra corresponder, procura nos
pathMappings do bootstrap
(ou ambiente corporativo legado).
- Sem correspondência nas duas listas, mantém um caminho Unix absoluto; um caminho
Windows gera erro com indicação do comando de configuração.
Dentro de cada lista, vence a origem mais específica, respeitando os limites de
pasta. Uma regra dos settings vence mesmo quando o bootstrap contém uma origem
mais específica. Por exemplo, uma regra pessoal para R:\modelos também prevalece
sobre uma regra corporativa para R:\modelos\especial. Outro volume, sem regra
pessoal correspondente, ainda pode ser resolvido pelo bootstrap.
O VS Code combina as associações dos settings por chave: para uma mesma origem,
pasta tem prioridade sobre workspace, que tem prioridade sobre usuário. Origens
diferentes são preservadas. Remover uma associação de um escopo permite que a regra
herdada reapareça. Um objeto vazio não remove associações herdadas; sem nenhuma
correspondência nos settings efetivos, usa-se o bootstrap. Restaurar herança
remove a configuração no escopo escolhido. Atualizações do bootstrap não alteram
os settings do usuário.
O formato anterior em lista continua legível pela extensão. Para convertê-lo ao
objeto editável pela interface de Settings, edite e salve pelo comando assistido no
mesmo escopo, ou substitua a lista no JSON pelo formato acima. O schema de Settings
agora indica o formato de objeto.
A regra é compartilhada pela prévia, diagnóstico no backend e comandos de estudos,
incluindo o caminho de origem de importação. A prévia mostra o caminho resolvido e
se a regra veio dos settings, do bootstrap ou do uso direto de Unix. Essa tradução
não verifica se as pastas representam os mesmos arquivos compartilhados e não copia
arquivos. Use Testar configuração no backend para verificar os arquivos acessíveis.
Novas conversões leem os settings atuais. Feche e reabra estudos já abertos após
mudar seus mapeamentos: destinos e operações pendentes preservam sua identidade,
e uma inicialização pendente não pode ser repetida com outro destino.
Validar as entradas
Arquivos .mdamex usam JSON com comentários, com preenchimento automático e
validação no editor. Campos desconhecidos, duplicados e vírgulas finais são recusados.
Clique com o botão direito no arquivo, no editor ou na aba e abra o menu MdaMeX:
| Ação |
O que verifica |
| Validar configuração |
Estrutura e conteúdo da configuração local. |
| Preparar prévia dos caminhos Unix |
Como os caminhos serão resolvidos para o ambiente Linux. Abre uma prévia local. |
| Testar configuração no backend |
Arquivos, permissões, ferramentas e acesso ao Slurm pelo backend. Abre um relatório de diagnóstico. |
Essas ações não iniciam simulações. A prévia não altera automaticamente a
configuração original. O teste no backend exige uma instalação compatível, mas
pode ser executado antes de iniciar o serviço do estudo.
Projeto green field mínimo
Para listar estudos, basta uma pasta de projeto acessível pelo backend. --study-list
é somente leitura e funciona mesmo antes de existir studies/. Para inicializar o
primeiro estudo sem uma origem alternativa, crie:
projeto/
studies/
base/
input.mdamex
model/
... arquivos referenciados pelo GDT e pela configuração
O input.mdamex precisa ser completo e apontar para GDT, observações, variograma e
dependências presentes em model/. --study-init gera study.json, a configuração
selada, entradas faltantes, work/, results/ e o estado privado .mdamex/; não crie
o manifesto nem os arquivos de serviço manualmente. Uma candidata ou --from pode
fornecer entradas antes do base, conforme a precedência candidata > origem explícita
base.
bootstrap.json e schemas/ na raiz do projeto são opcionais. O bootstrap é configurado
em mdamex.bootstrapSource e mantido no armazenamento privado do VS Code; o schema
de .mdamex acompanha a extensão. $schema é opcional e não é baixado pelo backend.
Para acompanhar um serviço iniciado somente com a raiz do projeto, selecione um .mdamex
da raiz e execute MdaMeX: Abrir painel de ajustes. O painel pode verificar, iniciar
e parar o serviço sem selecionar um estudo. service.idleTimeoutSeconds no .mdamex
configura o encerramento por inatividade entre 1 e 86400 segundos (padrão 1800). Para
serviço raiz, studies/base/input.mdamex prevalece; sem override, vale
shutdown.idleTimeoutSeconds em etc/mdamax.yml. O motivo e horário do encerramento
aparecem no painel após a confirmação do backend.
Criar e executar um estudo
- Execute MdaMeX: Novo estudo e informe um nome com letras minúsculas, números e hífens. O nome
base é reservado.
- Aguarde a criação do estudo e a abertura do painel.
- O painel conecta ao serviço se ele estiver ativo. Se estiver parado, use Iniciar serviço.
- Clique em Revisar e iniciar ajuste. Aguarde a validação das entradas e a preparação da configuração atual salva no estudo.
- Confira o resumo apresentado, incluindo quantidade de simulações, recursos, parâmetros e destinos. Confirme em Iniciar ajuste para submeter as simulações.
Se fechar a revisão sem confirmar, o ajuste permanece preparado e nenhuma
simulação começa. Você pode consultar as abas Entradas do estudo e
Configuração do ajuste e voltar a Revisar e iniciar ajuste; a preparação
será atualizada antes de apresentar o resumo novamente. Falhas na preparação
interrompem o fluxo. Mudanças de estado ou configuração durante a revisão
exigem uma nova revisão. Operações com resposta pendente devem ser recuperadas
com Verificar operação pendente antes de continuar.
Criar o estudo, iniciar o serviço e preparar as entradas são etapas separadas do
início das simulações. Para voltar a um estudo, execute MdaMeX: Abrir estudo.
Quando o .mdamex selecionado pertence a um estudo existente, ele é aberto
diretamente; nos demais casos, escolha um estudo no catálogo.
Cada estudo mantém sua configuração, trabalho, resultados e histórico. Arquivos
HDF5 herdados da base podem ser compartilhados por links relativos para economizar
espaço. Confira a coluna Armazenamento na aba Entradas do estudo: editar um arquivo
compartilhado também altera a base. Mantenha a base disponível e inalterada; em
montagens CIFS, os links relativos precisam funcionar na árvore do projeto.
Estudos existentes podem manter cópias independentes.
Se a pasta candidata já contiver entradas próprias, elas prevalecem sobre as da
base; um input.mdamex próprio precisa conter a configuração completa.
Acompanhar o estudo
O topo do painel mostra separadamente o estado do serviço e o estado do ajuste.
O percentual indica as simulações validadas sobre o total previsto; passe o mouse
sobre ele para ver as contagens. Quando a conexão é perdida, os dados exibidos
representam o último registro recebido.
Use as abas para consultar entradas, configuração, ajustes e jobs, resultados e
logs. Na lista de ajustes, Abrir seleciona a execução a acompanhar.
Os hashes de arquivos e os IDs aparecem abreviados: clique para expandir ou use o
botão de cópia para obter o valor completo, mesmo com o serviço desconectado.
Os diálogos de confirmação e seleção aparecem dentro da extensão. Cancelar
ou Escape fecha o diálogo sem executar a ação. Quando solicitado um arquivo,
informe seu caminho completo. Operações externas mostram progresso na barra de
status do VS Code.
MdaMeX: Gerenciar jobs Slurm abre a consulta geral de jobs do usuário. Para
interromper um ajuste MdaMeX, use Cancelar ajuste no painel do estudo e aguarde
a confirmação do encerramento, pois o ajuste pode envolver várias submissões.
Consultar resultados
Na aba Resultados, clique em Consultar resultados e abra um dos arquivos
completos listados para o ajuste selecionado.
| Formato |
Consulta disponível |
.mmout |
Tabelas de saída e matrizes por iteração, com navegação por fatias e atualização manual. |
.outh5 |
Diagnóstico geomecânico com seleção de data, célula I/J/K, métricas e comparação local. |
Os arquivos precisam estar acessíveis na montagem usada pelo VS Code. O .mmout
abre no leitor tabular da extensão; para .outh5, use MdaMeX: Abrir diagnóstico
geomecânico no menu do arquivo. O backend pode remover resultados individuais
depois da consolidação; consulte os arquivos disponibilizados pelo ajuste.
O objeto opcional work em input.mdamex controla a retenção por work.retention:
none (padrão), prior, post, prior,post ou all. prior copia o ensemble de
entrada para results/models/prior/; post copia o ensemble após a última atualização
MDA para results/models/post/; prior,post conserva ambos; all conserva o prior e
os modelos de todas as iterações em work/attempts/. Os arquivos originais em model/
nunca são alterados. A aba Resultados lista os .prp.h5 preservados e oferece
Navegar para pasta dos modelos quando há arquivos disponíveis.
Controlar o serviço e recuperar a conexão
Se o painel perder a conexão, use Verificar serviço e Reconectar. Fechar o
painel ou desconectar não cancela o ajuste. Se o serviço estiver parado, use
Iniciar serviço.
Após uma interrupção, Iniciar serviço inicia o processo. Se o backend oferecer
reconciliação e o estado do ajuste permitir, o painel pergunta se deseja retomar o
acompanhamento dos jobs. Agora não mantém o serviço iniciado sem reconciliar;
também é possível usar Reconciliar estudo depois. A reconciliação não retoma
automaticamente o cálculo do ajuste nem inicia novas simulações.
Se aparecer uma operação com resultado pendente, use Verificar operação
pendente antes de tentar outra ação. Isso permite recuperar o resultado da
solicitação anterior.
Parar serviço encerra o serviço e mantém os resultados. A ação fica
indisponível enquanto houver execução, cancelamento, reconciliação ou jobs
pendentes. Cancele o ajuste e resolva as pendências antes de parar. Quando o
backend não oferece essa função, o painel orienta sua atualização; reinicie o
serviço após atualizar o backend.
Planejar a recuperação científica
A extensão atende processos v1, v2 e v3. A descoberta do processo define a versão
usada na conexão e autenticação; atualizar a extensão não muda o protocolo de um
processo já ativo. Recuperação científica exige um processo de estudo v3 que
anuncie run.recover e a capacidade correspondente.
Na aba Ajuste, use Planejar recuperação para examinar checkpoint, etapa de
retomada, resultados reaproveitados, jobs a acompanhar, novas tentativas, cálculos,
consolidação e limite de novas submissões. Planejar não executa cálculos nem envia
jobs. A versão opcional do solver aplica-se apenas aos novos envios; as tentativas
existentes conservam sua proveniência e as entradas seladas permanecem preservadas.
Bloqueios explicam as evidências ou ações ainda necessárias. Faça a reconciliação
explicitamente quando indicada e solicite outro plano. Planos deixam de autorizar
execução quando a revisão, a instância ou a execução muda. Reconectar ou abrir o
painel não retoma cálculos automaticamente.
O recibo do plano fica salvo no workspace e reaparece ao reabrir o painel. Se o
estado ou checkpoint mudou, a confirmação fica indisponível. Um plano encontrado
somente no backend, sem recibo local, pode ser consultado como histórico; solicite
novo planejamento para confirmá-lo. A tabela de jobs mostra tentativas e sua
classificação científica, distinguindo reservas ainda não submetidas de envios incertos.
O botão de execução só aparece quando o serviço anuncia o modo execute.
Serviços com modes:["plan"] oferecem exclusivamente revisão. A confirmação mostra
o orçamento completo, solver e checkpoint. Quando houve cancelamento do estudo,
é necessário confirmar Substituir cancelamento e recuperar. Cancelamento de
um job pelo Slurm, isoladamente, não significa cancelamento do estudo.
Se a resposta de planejamento ou execução se perder, use Verificar operação
pendente. A extensão mantém o mesmo identificador e parâmetros até resolver a
resposta. Uma aceitação confirma apenas o início da recuperação; o estado e os
resultados finais continuam sujeitos à validação do backend. Se o serviço atual
não oferecer o modo daquela operação, a pendência é preservada até consultar um
serviço compatível.
A aba Resultados identifica a execução, a geração e o checkpoint do consolidado.
Ao abrir, a extensão confere novamente o manifesto. Se a geração mudou, atualiza
a lista e pede nova seleção; resultados parciais não são tratados como finais.
Refazer um ajuste
Depois de concluir, cancelar ou encerrar um ajuste com falha, e sem jobs pendentes,
clique em Refazer ajuste. Escolha como tratar a execução anterior:
- Novo estudo: copia as entradas para outro estudo e mantém o anterior. Inicie o serviço e prepare o ajuste no novo painel.
- Arquivar neste estudo: preserva trabalho, resultados e registros anteriores no histórico e prepara as entradas atuais.
- Descartar neste estudo: remove trabalho, resultados e registros anteriores após confirmação explícita e prepara as entradas atuais.
Você pode editar input.mdamex, por exemplo para trocar a partição ou os recursos,
antes de refazer. A extensão salva a configuração e o backend relê e valida as
entradas, atualiza seus hashes e apresenta uma nova preparação. Se a divergência
for detectada ao preparar ou iniciar, o painel oferece Refazer com nova configuração.
Quando ainda não houver um ajuste encerrado, oferece reiniciar em um novo estudo,
preservando o anterior.
Para executar, confira a nova preparação e use Revisar e iniciar ajuste.
Refazer no mesmo estudo depende de uma versão compatível do backend.
Deletar um estudo
Execute MdaMeX: Deletar estudo no menu do .mdamex ou na paleta de comandos.
O estudo do arquivo selecionado é usado quando disponível; caso contrário,
escolha-o no catálogo.
Confira o nome, a identidade e a pasta apresentados na confirmação. A exclusão
remove permanentemente os arquivos, resultados e históricos daquele estudo.
Feche o serviço e resolva os jobs pendentes antes de deletar. Essa operação exige
suporte à exclusão de estudos no backend.
Após a confirmação do backend, o Explorador é atualizado. Ao fechar a mensagem
de sucesso, a extensão abre e dá foco a studies/base/input.mdamex, preservando
as alterações não salvas nos documentos abertos. Cancelamentos e falhas de
exclusão não mudam o arquivo em foco. Se o caso base estiver inacessível, a
extensão informa que a exclusão foi concluída e que não conseguiu abrir o arquivo.
Resolver problemas
| Situação |
Como proceder |
| Falha de conexão SSH |
Execute MdaMeX: Testar conexões SSH e confira o perfil e as credenciais com o administrador. |
| Arquivo ou caminho não encontrado |
Confira a montagem compartilhada, os settings mdamex.pathMappings, o fallback do bootstrap e Testar configuração no backend. |
| Serviço indisponível |
Use Verificar serviço; inicie o serviço se estiver parado ou reconecte se estiver ativo. |
| Ajuste interrompido ou operação pendente |
Use a ação de reconciliação indicada no painel antes de iniciar outra operação. |
| Recurso indisponível no backend |
Solicite a atualização da instalação Linux e reinicie o serviço para carregar a nova versão. |
| Resultado ainda em gravação |
Aguarde sua conclusão e consulte novamente os resultados. |
Para consultar os registros da extensão, execute MdaMeX: Mostrar log ou abra
Saída e selecione MdaMeX Log. Os logs do ajuste ficam na aba Logs do painel.
Execute MdaMeX: Instalar skill MdaMeX para agentes e escolha o destino do
projeto aberto: Codex/Agent Skills padrão (.agents/skills), Copilot
(.github/skills), Claude Code (.claude/skills), Gemini CLI
(.gemini/skills), OpenCode (.opencode/skills) ou outra pasta. A instalação
mescla os arquivos do skill, preserva arquivos extras e pede uma escolha antes de
substituir arquivos MdaMeX já existentes. O pacote contém as próprias referências
do skill e não depende do checkout do código-fonte.
O pacote também inclui MANUAL_DO_USUARIO.md, um guia em português com as etapas
de configuração, criação, preparação, execução, acompanhamento, resultados e
recuperação. O agente pode usá-lo para explicar o fluxo antes e durante a operação.
Na etapa de opções adicionais, marque as caixas para incluir o snapshot do perfil
da extensão e/ou habilitar a API externa para agentes. A habilitação usa a mesma
confirmação do comando de alternância da API.
Durante a instalação, também é possível incluir um snapshot do perfil efetivo em
.mdamex/agent-context.json. A extensão pede confirmação porque host, usuário,
caminho do executável e mapeamentos podem identificar infraestrutura interna. O
arquivo nunca inclui senhas, passphrases, chaves privadas ou PSKs; confirme a data
e os dados com os diagnósticos antes de confiar no snapshot. A instalação sem esse
contexto continua disponível.
O skill explica como configurar a extensão e revisar caminhos Windows → Linux.
Para permitir que o agente invoque diagnóstico SSH, teste de configuração e prévia
de caminhos pela extensão, habilite mdamex.externalApi.enabled nas configurações
do VS Code ou execute MdaMeX: Habilitar/desabilitar API externa para agentes na
paleta de comandos. A opção vem desativada. A API externa exige workspace confiável e
expõe essas verificações, o editor interativo de mapeamentos e a leitura paginada de
propriedades .prp.h5 preservadas; operações que criam/excluem estudos ou
iniciam/cancelam ajustes continuam sujeitas aos fluxos
e confirmações do backend/painel.
Autores e licença
Desenvolvido pela área de Reservatórios da Petrobras.
- Gabriel de Oliveira da Silva
- Gabriel Serrão Seabra
- Rogério Ferreira da Cunha
Publisher: ESMDA Geomechanic (esmda-geo).
ID da extensão: esmda-geo.mdamex-ext.
Licença MIT; consulte os arquivos LICENSE e THIRD_PARTY.md distribuídos com a extensão.
O histórico de versões está em CHANGELOG.md e na aba de alterações da extensão.
Desenvolvimento
O repositório do projeto
tem acesso restrito aos usuários autorizados. As instruções de instalação das
dependências, build, testes e contratos estão em mdamex-ext/DEVELOPMENT.md
no código-fonte. No diretório da extensão, use npm run build:all
para compilar, npm test para os testes locais e npm run package para gerar o
VSIX. O empacotamento executa o build e não publica no Marketplace.
