Lock File de Dependências de Módulos

O lock file (invowkmod.lock.cue) registra as versões exatas de todas as dependências de módulo resolvidas, garantindo builds reprodutíveis ao longo do tempo e entre máquinas.

Ele é gerado automaticamente por invowk module sync e invowk module update.

Exemplo de Lock File

version: "2.0"
generated: "2025-01-10T12:34:56Z"

modules: {
    "https://github.com/example/common.invowkmod.git": {
        git_url:          "https://github.com/example/common.invowkmod.git"
        version:          "^1.0.0"
        resolved_version: "1.2.3"
        git_commit:       "abc123def456789012345678901234567890abcd"
        alias:            "common"
        namespace:        "common"
        content_hash:     "sha256:a1b2c3d4e5f6..."
    }
}

Campos da Raiz

Campo	Descrição
version	Versão do formato do lock file (atual: "2.0")
generated	Timestamp de criação do lock file
modules	Mapa de chaves de módulo para entradas travadas

Campos de Entrada de Módulo

Cada entrada em modules contém:

Campo	Descrição
git_url	URL do repositório Git
version	Restrição de versão original de invowkmod.cue
resolved_version	Versão resolvida exata
git_commit	SHA do commit da versão resolvida
alias	Alias de namespace (se definido)
path	Caminho de subdiretório (se definido)
namespace	Namespace calculado para comandos
content_hash	Hash SHA-256 do conteúdo da árvore do módulo em cache (detecção de adulteração)

Chaves de Módulo

A chave no mapa modules é derivada da URL Git e do caminho opcional:

modules: {
    "https://github.com/example/monorepo.invowkmod.git#modules/cli": {
        git_url: "https://github.com/example/monorepo.invowkmod.git"
        path:    "modules/cli"
    }
}

Notas de Uso

• Commite invowkmod.lock.cue no controle de versão para builds reprodutíveis.
• invowk module add grava o lock file automaticamente (não é necessário executar invowk module sync depois).

Workflows Comuns

# Resolve and lock
invowk module sync

# Commit the lock file
git add invowkmod.lock.cue
git commit -m "Lock module dependencies"