skyrim-creation-kit-agent

# Skyrim Creation Kit Agent Este repositório contém artefatos de pesquisa e engenharia para desenvolver um agente de autoria de mods assistido por IA para *The Elder Scrolls V: Skyrim Special Edition* e *Anniversary Edition*. O projeto foca em metodologias que priorizam a segurança, convertendo intenção de modding de alto nível em operações tipadas, reversíveis e respaldadas por evidências. ## Filosofia Central O sistema opera sobre quatro princípios: 1. **A IA decide O QUÊ**: O LLM/planejador determina a operação desejada. 2. **Software determinístico decide COMO**: Trabalhadores tipados executam as ações. 3. **Validadores decidem SE FUNCIONOU**: Verificações automatizadas garantem a integridade. 4. **Um humano decide SE ACEITA**: A aprovação final é necessária antes da aplicação. O produto alvo é um orquestrador híbrido onde o caminho principal é headless e determinístico. O Creation Kit é tratado como uma capacidade restrita, e não como o núcleo do sistema. ## Status Atual **Pesquisa + Prova de Conceito Sintética Validada.** Este ainda não é um agente de autoria de mods de propósito geral, nem automatiza diretamente o Creation Kit atualmente. O veredito atual do Gate-1 é "VIÁVEL COM LIMITAÇÕES". Embora a maioria das operações em nível de registro possa plausivelmente evitar o Creation Kit, várias áreas permanecem não resolvidas (por exemplo, FaceGen, navmeshes, semântica complexa de quests). ### Vocabulário de Status - `VERIFICADO`: Suportado por evidência direta ou teste reproduzível. - `PASS`: Experimento executado e aprovado nos portões definidos. - `NO VERIFICADO`: Plausível, mas não reproduzido aqui. - `HIPOTESIS`: Experimento ou afirmação de design proposta. - `EXPERIMENTAL`: Implementado apenas como um experimento. - `BLOQUEADO`: Não é possível prosseguir no ambiente disponível. - `DESCARTADO`: Explicitamente rejeitado. - `LEGAL_REVIEW_REQUIRED`: O caminho técnico existe, mas as implicações de licenciamento/EULA não estão resolvidas. ## Arquitetura A forma recomendada do produto é um **orquestrador híbrido + caminho principal headless-first**: ```text Intenção do Usuário ↓ Normalizador de intenção ↓ Planejador / LLM ↓ ModPlan Tipado ↓ Motor de políticas / segurança ↓ Roteador de capacidades ├─ Trabalhador de plugin headless ├─ Trabalhador Papyrus ├─ Validador xEdit └─ Trabalhador Creation Kit [desabilitado até verificação independente] ↓ Espaço de trabalho candidato ↓ Validador ↓ Aprovação humana ``` O planejador não deve receber comandos de shell arbitrários ou primitivas de automação de GUI. As operações são roteadas para trabalhadores específicos com base no tipo. ## Implementação Validada: POC-002 `research/poc_002/` é a primeira prova de conceito executável: - Usa apenas fixtures TES4 sintéticos. - Implementa um parser estrito com enums de operação fechados. - Impõe espaços de trabalho apenas para candidatos com contenção de caminho. - Garante orquestração fail-closed e recibos sem sobrescrita. - Mantém invariantes SHA-256 para arquivos originais. - Inclui 44 testes automatizados (linha de base inicial: 43; +1 regressão adversarial). Para executar o POC-002: ```bash cd research/poc_002 python -m compileall . python -m unittest test_suite.py -v ``` Nota: Isso não prova compatibilidade com plugins reais arbitrários do Skyrim, comportamento em tempo de execução do Creation Kit, xEdit, PapyrusCompiler, Mutagen ou correção in-game. ## UI de Pesquisa Discovery Desk O repositório preserva um pequeno aplicativo de pesquisa Next.js + Drizzle/PostgreSQL chamado "Discovery Desk". - `src/app/`, `src/db/` e `src/lib/research/` pertencem a esta UI. - **Não** é o runtime do futuro agente de autoria. - O desenvolvimento requer uma variável de ambiente `DATABASE_URL` (veja `.env.example`). O processo de build falha rapidamente se a variável estiver ausente, mas nenhum servidor PostgreSQL ativo é necessário para CI, pois o pool de conexões é lazy. ## Regras de Segurança - Nunca modifique a única cópia de um plugin do usuário. - Originais são entradas imutáveis; gravações vão para candidatos. - Sem comandos de shell arbitrários em planos gerados por IA. - Sem automação de GUI por clique em coordenadas como caminho principal. - Evidência de conclusão ausente é falha, não sucesso. - Nunca faça commit de binários de jogos/editores da Bethesda, plugins vanilla ou fontes Papyrus vanilla. - Isolamento de processo é uma fronteira técnica, não uma conclusão automática de licenciamento. ## Licenciamento - **Código central de autoria do repositório**: Licença MIT. - **Mutagen / Synthesis / Spriggit**: GPL-3.0-only. Obras combinadas exigem conformidade com GPL. - **xEdit**: MPL-2.0 upstream. Destinado à execução externa, nunca vendorizado. - **CKPE**: Código LGPLv3 mais sobreposição legal/EULA do Creation Kit. Status: `LEGAL_REVIEW_REQUIRED`. - **Creation Kit, PapyrusCompiler, assets vanilla**: Componentes proprietários instalados pelo usuário. Nunca redistribuídos. Pacotes npm de terceiros e fontes OFL têm avisos separados. ZIPs de pesquisa importados têm proveniência não resolvida. ## Relação com Sky-Claw Este é um repositório e trilha de pesquisa separados. Pode posteriormente integrar-se com Sky-Claw através de um protocolo documentado, mas deve permanecer independentemente testável e não assumir as entranhas do Sky-Claw como sua fronteira de segurança. ## Isenção de Responsabilidade Sem afiliação com Bethesda Game Studios, ZeniMax Media, Valve, Nexus Mods ou autores de ferramentas de terceiros.