Metadata-Version: 2.4
Name: guardiancontext
Version: 0.1.16
Summary: Contexto versionado em Git e coordenação de tarefas para agentes de programação.
Author: IronStack
License: Licença de Uso — GuardianContext
        Copyright (c) 2026 IronStack. Todos os direitos reservados.
        
        1. Concessão. A IronStack concede a você uma licença limitada, não exclusiva,
           intransferível e revogável para instalar e usar este software (CLI `guardian`,
           Desktop Manager e componentes distribuídos com eles) em conjunto com o serviço
           GuardianContext, conforme os Termos de Uso vigentes (docs/termos-de-uso.md ou
           https://api.ironstack.dev.br/termos), que integram esta licença.
        
        2. Restrições. Salvo autorização escrita da IronStack, você não pode: redistribuir,
           sublicenciar, vender ou alugar o software; remover avisos de autoria; usar o
           software para construir serviço concorrente; nem extrair a biblioteca curada de
           padrões para uso fora do serviço. Modificações para uso próprio são permitidas.
        
        3. Arquivos gerados no seu repositório (router.md, quadro.md, wiki/, decisoes/,
           claims/, handoffs/, hook pre-commit e afins) são seus, sem restrição.
        
        4. SEM GARANTIAS. O SOFTWARE É FORNECIDO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA
           DE QUALQUER NATUREZA, EXPRESSA OU IMPLÍCITA, INCLUINDO COMERCIALIZAÇÃO, ADEQUAÇÃO
           A UM FIM ESPECÍFICO E NÃO VIOLAÇÃO.
        
        5. LIMITAÇÃO DE RESPONSABILIDADE. EM NENHUMA HIPÓTESE A IRONSTACK RESPONDERÁ POR
           DANOS INDIRETOS, INCIDENTAIS, ESPECIAIS OU CONSEQUENCIAIS, PERDA DE DADOS, DE
           CÓDIGO OU DE LUCROS, DECORRENTES DO USO DO SOFTWARE OU DE AÇÕES DE AGENTES DE IA
           OPERADOS PELO USUÁRIO, AINDA QUE AVISADA DA POSSIBILIDADE. AGENTES DE IA EXECUTAM
           COMANDOS REAIS; A REVISÃO DO QUE ELES FAZEM É RESPONSABILIDADE DO USUÁRIO.
        
        6. Lei aplicável: República Federativa do Brasil.
        
Project-URL: Homepage, https://ironstack.dev.br/guardiancontext/
Project-URL: Documentation, https://ironstack.dev.br/guardiancontext/manual/
Project-URL: Terms, https://api.ironstack.dev.br/termos
Keywords: agents,coordination,git,multi-agent,control-plane
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyYAML>=6.0
Provides-Extra: mcp
Requires-Dist: mcp==2.2.0; python_version >= "3.10" and extra == "mcp"
Provides-Extra: update
Requires-Dist: packaging<27,>=24; extra == "update"
Requires-Dist: cryptography<51,>=43; extra == "update"
Provides-Extra: security
Requires-Dist: cryptography<51,>=43; extra == "security"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Provides-Extra: semantic
Requires-Dist: fastembed==0.5.1; extra == "semantic"
Provides-Extra: obsidian
Requires-Dist: watchdog>=3.0.0; extra == "obsidian"
Provides-Extra: desktop
Requires-Dist: PySide6>=6.6; extra == "desktop"
Dynamic: license-file

# GuardianContext

## Contexto em Git para a próxima sessão de programação

GuardianContext organiza regras, decisões e tarefas no seu repositório e ajuda
agentes de programação a recuperar o contexto relevante antes de trabalhar.
Use com pessoas e agentes que precisam dar continuidade ao mesmo projeto,
inclusive em sessões separadas de Codex e Claude Code.

O contexto fica em arquivos Markdown versionados no Git. Você pode revisar uma
decisão no diff, localizar sua origem e preparar um briefing para a próxima tarefa.

[Manual de uso](https://ironstack.dev.br/guardiancontext/manual/) ·
[Site do produto](https://ironstack.dev.br/guardiancontext/) ·
[Suporte](mailto:suporte@ironstack.dev.br)

## Uma decisão registrada volta ao contexto da tarefa

Você definiu como fazer migrations e quer que a próxima sessão consulte essa
regra. Depois de inicializar o GuardianContext, crie o arquivo
`decisoes/0001-migrations.md` com este exemplo:

```markdown
# Migrations de banco

Toda migration deve incluir um plano de rollback e ser revisada antes do deploy.
```

Atualize o índice local e prepare um briefing:

```sh
guardian index rebuild --lexical
guardian brief "migrations" --tool agents --max-tokens 1500
```

O briefing inclui trechos encontrados e os caminhos dos arquivos de origem.
Neste exemplo, a decisão sobre migrations pode ser consultada antes de alterar o
banco. Entregue o briefing ao agente e revise as ações propostas.

O exemplo usa busca textual, disponível no pacote básico. A qualidade do contexto
recuperado depende dos documentos registrados e dos termos da tarefa.

## O que você pode fazer

| Necessidade | Recurso |
| --- | --- |
| Retomar decisões entre sessões | Wiki, decisões e quadro de tarefas em Markdown no Git. |
| Preparar contexto para uma tarefa | Busca local e `guardian brief`, com referências às fontes e orçamento de tokens. |
| Coordenar trabalho entre agentes | Reservas de escopo com prazo (claims) e handoffs entre sessões. |
| Encontrar problemas de organização | `guardian doctor` e `guardian audit` verificam a estrutura e a disciplina do protocolo. |
| Usar o protocolo em Codex e Claude Code | Integração MCP local, configurada por projeto. |

As reservas e verificações ajudam a coordenar o trabalho. Sua eficácia depende da
configuração e do uso pelos participantes. Continue revisando diffs, testes e
commits; o GuardianContext não garante que agentes sigam as decisões registradas.

## Instale e conecte seu repositório

O caminho recomendado instala o ambiente Python 3.11 e abre o Desktop Manager.
O instalador usa o [uv](https://docs.astral.sh/uv/) e inclui os componentes de busca
semântica, desktop, MCP e atualização.

**Windows (PowerShell)**

```powershell
irm https://api.ironstack.dev.br/install.ps1 | iex
```

**macOS / Linux**

```sh
curl -fsSL https://api.ironstack.dev.br/install.sh | sh
```

Os comandos baixam e executam o instalador oficial. Você pode abrir a URL para
inspecionar o script antes de executar. A instalação pode baixar Python e
componentes adicionais; a busca semântica baixa um modelo no primeiro uso.
No Linux, a interface gráfica também requer as bibliotecas do Qt.

No Desktop Manager:

1. Crie sua conta com aceite dos Termos de Uso ou entre na conta existente.
2. Escolha a pasta de um repositório Git e o modo de trabalho da equipe.
3. Execute a configuração e confira o diagnóstico apresentado.

Se a janela não abrir, execute `guardian-desktop` em um terminal novo.
A configuração MCP requer selecionar o cliente, registrar a integração e revisar
sua solicitação de confiança em uma nova sessão nativa. Instalar o pacote, por si
só, não conecta todos os agentes.

### Alternativa pelo terminal

Para experimentar a estrutura e a busca textual local, instale o pacote básico
com [uv](https://docs.astral.sh/uv/getting-started/installation/) e abra seu
repositório:

```sh
uv tool install --python 3.11 guardiancontext
cd meu-repositorio
guardian init
guardian doctor
```

Substitua `meu-repositorio` pela pasta do seu projeto. Esses passos criam e
verificam a estrutura local; não instalam hooks nem registram MCP. Para conectar a
conta ao serviço, use `guardian signup` ou `guardian login` nessa pasta. Senhas
são solicitadas interativamente.

O pacote básico requer Python 3.9 ou superior; o ambiente recomendado para os
componentes opcionais é Python 3.11. Consulte o manual para instalar os extras,
configurar os hooks e escolher entre pasta compartilhada e worktrees separadas.

## Arquivos, dados e atualização

- A estrutura padrão inclui `router.md`, `quadro.md`, `wiki/`, `decisoes/`,
  `claims/`, `handoffs/` e `docs/trabalho/`. O estado e o índice local ficam em
  `.guardian/`. Revise os arquivos gerados antes de adicioná-los ao Git.
- Os comandos locais de estrutura e busca podem funcionar sem conexão com o
  serviço. Cadastro, sincronização e recursos sujeitos a licença têm requisitos
  próprios de conexão e autorização.
- O relatório de auditoria envia métricas e contagens. A sincronização de padrões
  envia metadados e vetores. Nas chamadas ao serviço, o cliente também informa
  versão, interface e um identificador aleatório do perfil de instalação.
- `guardian contribute` permite propor um documento à biblioteca curada. O texto
  passa por anonimização e é apresentado para revisão antes da confirmação do
  envio. Revise o conteúdo para evitar compartilhar informações sensíveis.
- A chave de API fica no perfil do usuário, fora do repositório. Configurações MCP
  contêm caminhos da máquina e devem seguir as orientações do manual.
- Instalações oficiais usam atualização automática com verificações de segurança
  e adiamento quando o runtime está em uso. Consulte `guardian update status`.
  Outras formas de instalação podem exigir atualização manual.

## Manual e suporte

Consulte o [manual completo](https://ironstack.dev.br/guardiancontext/manual/).
O manual incluído no pacote também pode ser lido sem conexão:

```sh
guardian manual --lang pt
guardian manual --lang en
guardian manual --lang es
```

Para reportar um problema, escreva para
[suporte@ironstack.dev.br](mailto:suporte@ironstack.dev.br). Informe sistema operacional, `guardian --version`,
a ação executada e a mensagem de erro. Remova credenciais e dados privados dos logs.

GuardianContext é um produto da IronStack, distribuído sob
licença proprietária de uso, incluída no pacote no arquivo `LICENSE`.
As condições do serviço estão nos [Termos de Uso](https://api.ironstack.dev.br/termos).
