montreal-core

Fábrica de Governança de Agentes — Harness Core para OpenCode e Claude Code (Montreal)

O montreal-core é o instalador oficial da esteira de agentes autônomos da Montreal. É o rebrand do pacote hsy-core (decisão QA-01/ADR-0003 D4): a identidade publicada muda, o comportamento dos comandos permanece idêntico.

Aliases legados (depreciados, ainda funcionais): hsy-core, harness-core e hsy continuam apontando para o mesmo binário.

✅ Requisitos

• Node.js >= 18 (zero dependências npm)
• Windows 10/11 e macOS 12+; Linux best-effort

🧭 Os dois caminhos (mesmo instalador)

| Caminho | Como usar | |---|---| | OpenCode | npx montreal-core (assistente visual), npx montreal-core install [CHAVE], npx montreal-core uninstall | | Claude Code | npx montreal-core --claude (assistente visual), npx montreal-core claude <subcomando> |

🔵 OpenCode

npx montreal-core                 # Assistente visual no navegador (:5321)
npx montreal-core install [KEY]   # Instalação direta via terminal
npx montreal-core uninstall       # Remove o plugin e limpa as configurações

No OpenCode, os 14 especialistas e o Maestro rodam em memória (nada é gravado no disco do cliente).

🟠 Claude Code

npx montreal-core --claude                    # Assistente visual (:5322)
npx montreal-core claude install <CHAVE>      # Sincroniza e materializa o plugin
npx montreal-core claude refresh [--force]    # Re-sincroniza (fast-path; --force ignora cache)
npx montreal-core claude status [--json]      # Estado local (a licença nunca aparece em claro)
npx montreal-core claude verify [--path <dir>]# Valida a estrutura do plugin materializado
npx montreal-core claude doctor [--json]      # Diagnóstico de versão/capacidades
npx montreal-core claude uninstall            # Remove plugin + estado (idempotente)

Como funciona: valida a licença, baixa o catálogo (somente GET — pull-only: nada do cliente sai da máquina), materializa o plugin em ~/.claude/skills/montreal-core/ (auto-carregado pelo Claude Code, sem marketplace) e guarda o estado em ~/.montreal-core/. "Sempre atualizado" via hook SessionStart + refresh. Cada artefato materializado carrega um watermark por licença (rastreabilidade forense — não é DRM); o comando forense claude trace existe, mas fica fora do help público.

⚠️ Limitações honestas

• Mudanças em agents/, hooks/ e settings.json valem na próxima sessão ou após /reload-plugins (o status sinaliza conteúdo pendente).
• Mudanças em SKILL.md são detectadas ao vivo.
• O guard de modelo (PreModelSwitch) vem desligado por default até validação empírica do contrato de hooks.
• O piso de versão do Claude Code está não determinado (spike pendente) — claude doctor reporta isso e não inventa número.

© Montreal Informática · Todos os direitos reservados.