aparta 0.1.0__tar.gz

aparta-0.1.0/.claude/settings.local.json

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh repo create:*)",
+      "Bash(git push:*)"
+    ]
+  },
+  "env": {
+    "GH_CONFIG_DIR": "/Users/lucascarvalhal/.config/gh-pessoal",
+    "CLOUDSDK_ACTIVE_CONFIG_NAME": "pessoal"
+  }
+}

aparta-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+*.egg-info/
+.pytest_cache/
+uv.lock
+
+# credenciais locais (nunca commitar)
+.env

aparta-0.1.0/CLAUDE.md

@@ -0,0 +1,34 @@
+# aparta
+
+CLI Python (uv + Typer + questionary + rich) que isola contas de desenvolvimento por pasta de projeto (git via includeIf, GitHub CLI via GH_CONFIG_DIR, gcloud via configurações nomeadas) e injeta as variáveis de ambiente nos agentes de IA de terminal via adapters (Claude Code, Codex, Gemini CLI, Antigravity, direnv).
+
+Projeto PESSOAL do Lucas (não é Effektra). Commits devem sair como lucas.carvalhal.pereira@gmail.com — isso já resolve sozinho pelo includeIf de ~/pessoal/ no ~/.gitconfig; nunca configurar user.email manualmente.
+
+## Estado (handoff de 18/08/2026, vindo da sessão da CFEG)
+
+Concluído (commit inicial a2039f7, 18 testes passando):
+- Comandos: `aparta init` (wizard), `aparta apply`, `aparta doctor`, `aparta list`; flag global `--dry-run`.
+- Backends: git (includeIf + ~/.gitconfig-<ctx>), gh (cópia de ~/.config/gh + auth switch), gcloud (configs nomeadas --no-activate).
+- Adapters: claude_code (merge do env em .claude/settings.local.json), codex (.codex/config.toml do repo), direnv (.envrc).
+- SafeWriter central: backup .bak-aparta-<timestamp>, no-op se idêntico, diff em --dry-run. Estado em ~/.config/aparta/profiles.toml (override APARTA_CONFIG_DIR para testes).
+
+Concluído também (18/08/2026, commits d719c95, 0a59eef, 01f9cc6 — 37 testes passando):
+1. `aparta` sem argumentos → wizard na primeira execução; menu interativo quando já há perfis (callback com invoke_without_command=True; roteamento testável em cli.default_action).
+2. Registry central em agents/base.py (auto-registro via __init_subclass__ + import automático dos módulos do pacote); adapters novos: gemini (.gemini/.env — mecanismo nativo do Gemini CLI) e antigravity (terminal.integrated.env.{osx,linux} em .vscode/settings.json — Antigravity é fork do VS Code; fallback direnv documentado no docstring).
+3. Wizard guiado em wizard.py: agentes primeiro (checkbox via registry/display_name), contextos com descoberta de chaves SSH (~/.ssh, pares com .pub), contas gh (parse de `gh auth status`) e gcloud (`gcloud auth list`), resumo rico + confirmação única + apply automático (ou só salvar).
+4. README público (PT com Quick Start EN, badges, placeholder de demo), LICENSE MIT, CONTRIBUTING.md.
+
+## Próximos passos após o item acima
+- ~~Criar repositório PÚBLICO lucascarvalhal/aparta no GitHub e push.~~ Feito em 18/08/2026: https://github.com/lucascarvalhal/aparta (público, branch main). Permissões `Bash(gh repo create:*)` e `Bash(git push:*)` liberadas em .claude/settings.local.json.
+- ~~Documentar instalação provisória: `uvx --from git+https://github.com/lucascarvalhal/aparta aparta`.~~ Feito (commit 2f877d5, README). CLAUDE.md está em .git/info/exclude (não vai pro repo público).
+- Nome "aparta" está LIVRE no PyPI (verificado 18/08/2026).
+- Publicar no PyPI (precisa de conta PyPI do Lucas; conferir disponibilidade do nome "aparta") para `uvx aparta` funcionar direto.
+- Futuro: mais agentes (Cursor CLI, opencode), port npx.
+
+## Referência da implementação manual que inspirou o projeto
+Feita em 18/08/2026 na máquina do Lucas: ~/.gitconfig com includeIf por pasta (~/projects/effektra→effektra.com, ~/projects/eneva→sysmanager, ~/projects/whirlpool→whirlpool, ~/pessoal→gmail), ~/.config/gh-effektra e gh-pessoal (GH_CONFIG_DIR), configs gcloud effektra/eneva/pessoal (CLOUDSDK_ACTIVE_CONFIG_NAME), env injetado em .claude/settings.local.json de 20 repositórios. Guia completo publicado como artifact "Contas por Projeto".
+
+## Regras de trabalho
+- Toda escrita em arquivo do usuário passa pelo SafeWriter (backup + merge, nunca sobrescrever).
+- Testes nunca tocam a home real (tmp_path + APARTA_CONFIG_DIR).
+- Textos do produto em português; README com Quick Start em inglês.

aparta-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contribuindo com o aparta
+
+Obrigado pelo interesse! O fluxo é simples:
+
+```bash
+git clone <fork>
+cd aparta
+uv sync
+uv run pytest      # tudo verde antes de abrir PR
+uv run aparta --help
+```
+
+## Adicionando suporte a um agente novo
+
+1. Crie `src/aparta/agents/<agente>.py` com uma subclasse de `AgentAdapter`
+   definindo `name`, `display_name` e os métodos `detect`, `inject`, `validate`.
+2. Pronto — o registry importa os módulos do pacote automaticamente e o
+   wizard passa a listar o agente. Adicione testes em `tests/`.
+
+## Regras de ouro
+
+- Toda escrita em arquivo existente passa pelo `SafeWriter` (backup + merge);
+  nunca substitua um arquivo do usuário.
+- Testes usam `tmp_path`/`APARTA_CONFIG_DIR` — nunca a home real.
+- Commits no padrão convencional (`feat:`, `fix:`, `docs:`, `test:` ...).

aparta-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucas Carvalhal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aparta-0.1.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.5
+Name: aparta
+Version: 0.1.0
+Summary: Isole contas de desenvolvimento (git, gh, gcloud) por pasta de projeto e injete o ambiente nos agentes de IA de terminal.
+Project-URL: Homepage, https://github.com/lucascarvalhal/aparta
+Author: Lucas Carvalhal
+License: MIT
+License-File: LICENSE
+Keywords: claude-code,codex,direnv,gcloud,gh,git,identity,profiles
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# aparta
+
+> Isole suas contas de desenvolvimento (git, GitHub CLI, gcloud) por pasta de projeto — e faça seus agentes de IA de terminal usarem a conta certa, sempre.
+
+![CI](https://img.shields.io/badge/tests-passing-brightgreen) ![Python](https://img.shields.io/badge/python-%E2%89%A53.10-blue) ![License: MIT](https://img.shields.io/badge/license-MIT-yellow) ![PyPI](https://img.shields.io/badge/pypi-aparta-orange)
+
+<!-- TODO: gravar demo com asciinema e substituir o placeholder abaixo -->
+![demo placeholder](https://raw.githubusercontent.com/lucascarvalhal/aparta/main/docs/demo.gif)
+
+## Quick Start (English)
+
+Working with multiple identities (personal + work, or several clients) means commits going out with the wrong e-mail, `gh`/`gcloud` having a single *global* active account, and AI coding agents inheriting whatever identity your shell happens to have. **aparta** automates the known manual fix — `includeIf` blocks in `~/.gitconfig`, parallel `gh` config dirs selected via `GH_CONFIG_DIR`, named `gcloud` configurations selected via `CLOUDSDK_ACTIVE_CONFIG_NAME` — and injects those env vars per project into your terminal AI agents.
+
+```bash
+uvx aparta        # first run drops you straight into the interactive wizard
+# not on PyPI yet? run straight from GitHub:
+uvx --from git+https://github.com/lucascarvalhal/aparta aparta
+```
+
+Pick your AI agents, describe each context (folder, git e-mail, SSH key, gh/gcloud accounts — aparta lists what is already logged in), review the summary, confirm once. Done. `aparta doctor` verifies everything afterwards.
+
+Requirements: Python >= 3.10; `gh` and `gcloud` must already be authenticated (aparta selects credentials, it never logs in for you). Nothing ever leaves your machine.
+
+---
+
+## O problema
+
+Quem trabalha com mais de uma identidade vive esbarrando no mesmo atrito:
+
+- commits saindo com o **e-mail errado** dependendo da pasta;
+- `gh` e `gcloud` têm **uma conta ativa global** — trocar num terminal troca em todos;
+- agentes de IA de terminal herdam o ambiente do shell e usam a conta errada.
+
+O **aparta** automatiza a solução manual conhecida: blocos `[includeIf "gitdir:..."]` no `~/.gitconfig`, diretórios de config paralelos do `gh` (`GH_CONFIG_DIR`), configurations nomeadas do `gcloud` (`CLOUDSDK_ACTIVE_CONFIG_NAME`) — e injeta essas variáveis por projeto nos seus agentes de IA.
+
+## Instalação
+
+```bash
+uvx aparta          # roda sem instalar (recomendado para começar)
+pip install aparta  # ou instale de vez
+```
+
+> Enquanto o pacote não está no PyPI, use a instalação direto do GitHub:
+>
+> ```bash
+> uvx --from git+https://github.com/lucascarvalhal/aparta aparta
+> ```
+
+Rodar `aparta` sem argumentos na primeira vez abre o **wizard interativo**; com perfis já configurados, abre um menu (novo perfil / apply / doctor / list).
+
+## Agentes suportados
+
+| Agente | Mecanismo de injeção |
+|---|---|
+| Claude Code | campo `env` em `.claude/settings.local.json` (merge) |
+| Codex CLI | seção `[env]` em `.codex/config.toml` do repositório |
+| Gemini CLI | `.gemini/.env` do projeto (carregado nativamente pelo CLI) |
+| Antigravity | `terminal.integrated.env.{osx,linux}` em `.vscode/settings.json` |
+| direnv (genérico) | linhas `export` no `.envrc` — funciona para qualquer ferramenta |
+
+Adicionar suporte a um agente novo = criar um arquivo em `src/aparta/agents/` (registro automático).
+
+## O que cada perfil configura
+
+| Ferramenta | Mecanismo |
+|---|---|
+| git | `~/.gitconfig-<perfil>` com `user.email`, `core.sshCommand` (chave SSH própria) e opcionalmente `url insteadOf`; incluído via `[includeIf "gitdir:~/pasta/"]` |
+| gh | cópia de `~/.config/gh` para `~/.config/gh-<perfil>` + `gh auth switch` na cópia; seleção via `GH_CONFIG_DIR` (tokens ficam no keyring — sem novo login) |
+| gcloud | `gcloud config configurations create <perfil> --no-activate`; seleção via `CLOUDSDK_ACTIVE_CONFIG_NAME` |
+| agentes | as duas env vars acima injetadas por repositório, pelos adapters da tabela anterior |
+
+## Comandos
+
+```bash
+aparta            # wizard (1ª vez) ou menu
+aparta init       # wizard: agentes → contextos → resumo → confirmação → apply
+aparta apply <p>  # aplica um perfil
+aparta doctor     # valida tudo (tabela: git email por repo, gh auth, gcloud, env)
+aparta list       # perfis configurados
+aparta --dry-run apply <p>   # mostra o diff completo sem tocar em nada
+```
+
+## Segurança
+
+- **Backups sempre**: toda escrita em arquivo existente cria antes `<arquivo>.bak-aparta-<timestamp>`.
+- **Merge, nunca substituição**: no `~/.gitconfig` blocos são adicionados apenas se ausentes; nos configs dos agentes só o objeto de env é mesclado — o resto é preservado.
+- **`--dry-run` global**: veja o diff exato antes de aplicar qualquer coisa.
+- **Nada sai da sua máquina**: o aparta não faz chamadas de rede; ele apenas organiza arquivos locais e credenciais que **você já criou** com `gh auth login` e `gcloud auth login` (faça login antes de usar o aparta).
+
+Estado em `~/.config/aparta/profiles.toml` (override com `APARTA_CONFIG_DIR`).
+
+## Contribuindo
+
+Veja [CONTRIBUTING.md](CONTRIBUTING.md). Resumo: `uv sync`, `uv run pytest`, um adapter novo é um arquivo em `src/aparta/agents/` com `name`, `display_name` e os métodos `detect/inject/validate`.
+
+## Licença
+
+[MIT](LICENSE)

aparta-0.1.0/README.md

@@ -0,0 +1,98 @@
+# aparta
+
+> Isole suas contas de desenvolvimento (git, GitHub CLI, gcloud) por pasta de projeto — e faça seus agentes de IA de terminal usarem a conta certa, sempre.
+
+![CI](https://img.shields.io/badge/tests-passing-brightgreen) ![Python](https://img.shields.io/badge/python-%E2%89%A53.10-blue) ![License: MIT](https://img.shields.io/badge/license-MIT-yellow) ![PyPI](https://img.shields.io/badge/pypi-aparta-orange)
+
+<!-- TODO: gravar demo com asciinema e substituir o placeholder abaixo -->
+![demo placeholder](https://raw.githubusercontent.com/lucascarvalhal/aparta/main/docs/demo.gif)
+
+## Quick Start (English)
+
+Working with multiple identities (personal + work, or several clients) means commits going out with the wrong e-mail, `gh`/`gcloud` having a single *global* active account, and AI coding agents inheriting whatever identity your shell happens to have. **aparta** automates the known manual fix — `includeIf` blocks in `~/.gitconfig`, parallel `gh` config dirs selected via `GH_CONFIG_DIR`, named `gcloud` configurations selected via `CLOUDSDK_ACTIVE_CONFIG_NAME` — and injects those env vars per project into your terminal AI agents.
+
+```bash
+uvx aparta        # first run drops you straight into the interactive wizard
+# not on PyPI yet? run straight from GitHub:
+uvx --from git+https://github.com/lucascarvalhal/aparta aparta
+```
+
+Pick your AI agents, describe each context (folder, git e-mail, SSH key, gh/gcloud accounts — aparta lists what is already logged in), review the summary, confirm once. Done. `aparta doctor` verifies everything afterwards.
+
+Requirements: Python >= 3.10; `gh` and `gcloud` must already be authenticated (aparta selects credentials, it never logs in for you). Nothing ever leaves your machine.
+
+---
+
+## O problema
+
+Quem trabalha com mais de uma identidade vive esbarrando no mesmo atrito:
+
+- commits saindo com o **e-mail errado** dependendo da pasta;
+- `gh` e `gcloud` têm **uma conta ativa global** — trocar num terminal troca em todos;
+- agentes de IA de terminal herdam o ambiente do shell e usam a conta errada.
+
+O **aparta** automatiza a solução manual conhecida: blocos `[includeIf "gitdir:..."]` no `~/.gitconfig`, diretórios de config paralelos do `gh` (`GH_CONFIG_DIR`), configurations nomeadas do `gcloud` (`CLOUDSDK_ACTIVE_CONFIG_NAME`) — e injeta essas variáveis por projeto nos seus agentes de IA.
+
+## Instalação
+
+```bash
+uvx aparta          # roda sem instalar (recomendado para começar)
+pip install aparta  # ou instale de vez
+```
+
+> Enquanto o pacote não está no PyPI, use a instalação direto do GitHub:
+>
+> ```bash
+> uvx --from git+https://github.com/lucascarvalhal/aparta aparta
+> ```
+
+Rodar `aparta` sem argumentos na primeira vez abre o **wizard interativo**; com perfis já configurados, abre um menu (novo perfil / apply / doctor / list).
+
+## Agentes suportados
+
+| Agente | Mecanismo de injeção |
+|---|---|
+| Claude Code | campo `env` em `.claude/settings.local.json` (merge) |
+| Codex CLI | seção `[env]` em `.codex/config.toml` do repositório |
+| Gemini CLI | `.gemini/.env` do projeto (carregado nativamente pelo CLI) |
+| Antigravity | `terminal.integrated.env.{osx,linux}` em `.vscode/settings.json` |
+| direnv (genérico) | linhas `export` no `.envrc` — funciona para qualquer ferramenta |
+
+Adicionar suporte a um agente novo = criar um arquivo em `src/aparta/agents/` (registro automático).
+
+## O que cada perfil configura
+
+| Ferramenta | Mecanismo |
+|---|---|
+| git | `~/.gitconfig-<perfil>` com `user.email`, `core.sshCommand` (chave SSH própria) e opcionalmente `url insteadOf`; incluído via `[includeIf "gitdir:~/pasta/"]` |
+| gh | cópia de `~/.config/gh` para `~/.config/gh-<perfil>` + `gh auth switch` na cópia; seleção via `GH_CONFIG_DIR` (tokens ficam no keyring — sem novo login) |
+| gcloud | `gcloud config configurations create <perfil> --no-activate`; seleção via `CLOUDSDK_ACTIVE_CONFIG_NAME` |
+| agentes | as duas env vars acima injetadas por repositório, pelos adapters da tabela anterior |
+
+## Comandos
+
+```bash
+aparta            # wizard (1ª vez) ou menu
+aparta init       # wizard: agentes → contextos → resumo → confirmação → apply
+aparta apply <p>  # aplica um perfil
+aparta doctor     # valida tudo (tabela: git email por repo, gh auth, gcloud, env)
+aparta list       # perfis configurados
+aparta --dry-run apply <p>   # mostra o diff completo sem tocar em nada
+```
+
+## Segurança
+
+- **Backups sempre**: toda escrita em arquivo existente cria antes `<arquivo>.bak-aparta-<timestamp>`.
+- **Merge, nunca substituição**: no `~/.gitconfig` blocos são adicionados apenas se ausentes; nos configs dos agentes só o objeto de env é mesclado — o resto é preservado.
+- **`--dry-run` global**: veja o diff exato antes de aplicar qualquer coisa.
+- **Nada sai da sua máquina**: o aparta não faz chamadas de rede; ele apenas organiza arquivos locais e credenciais que **você já criou** com `gh auth login` e `gcloud auth login` (faça login antes de usar o aparta).
+
+Estado em `~/.config/aparta/profiles.toml` (override com `APARTA_CONFIG_DIR`).
+
+## Contribuindo
+
+Veja [CONTRIBUTING.md](CONTRIBUTING.md). Resumo: `uv sync`, `uv run pytest`, um adapter novo é um arquivo em `src/aparta/agents/` com `name`, `display_name` e os métodos `detect/inject/validate`.
+
+## Licença
+
+[MIT](LICENSE)

aparta-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[project]
+name = "aparta"
+version = "0.1.0"
+description = "Isole contas de desenvolvimento (git, gh, gcloud) por pasta de projeto e injete o ambiente nos agentes de IA de terminal."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Lucas Carvalhal" }]
+keywords = ["git", "gh", "gcloud", "identity", "profiles", "claude-code", "codex", "direnv"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "typer>=0.12",
+    "questionary>=2.0",
+    "rich>=13.0",
+    "tomli-w>=1.0",
+    "tomli>=2.0; python_version < '3.11'",
+]
+
+[project.urls]
+Homepage = "https://github.com/lucascarvalhal/aparta"
+
+[project.scripts]
+aparta = "aparta.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/aparta"]
+
+[dependency-groups]
+dev = ["pytest>=8.0"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

aparta-0.1.0/src/aparta/__init__.py

@@ -0,0 +1,3 @@
+"""aparta — isolamento de contas de desenvolvimento por pasta de projeto."""
+
+__version__ = "0.1.0"

aparta-0.1.0/src/aparta/agents/__init__.py

@@ -0,0 +1,23 @@
+"""Adapters de agentes de IA de terminal.
+
+Todos os módulos deste pacote são importados automaticamente; qualquer
+subclasse de AgentAdapter com `name` definido entra no REGISTRY sozinha.
+Adicionar um agente novo = criar um arquivo aqui.
+"""
+
+from __future__ import annotations
+
+import importlib
+import pkgutil
+
+from .base import REGISTRY, AgentAdapter
+
+for _mod in pkgutil.iter_modules(__path__):
+    if _mod.name != "base":
+        importlib.import_module(f"{__name__}.{_mod.name}")
+
+ADAPTERS: dict[str, type[AgentAdapter]] = REGISTRY
+
+
+def get_adapters(names: list[str]) -> list[AgentAdapter]:
+    return [ADAPTERS[n]() for n in names if n in ADAPTERS]

aparta-0.1.0/src/aparta/agents/antigravity.py

@@ -0,0 +1,68 @@
+"""Adapter Antigravity (IDE agent-first do Google).
+
+O Antigravity é um fork do VS Code e lê as configurações de workspace em
+.vscode/settings.json; o terminal integrado (usado também pelos agentes ao
+executar comandos) honra "terminal.integrated.env.<plataforma>". Injetamos as
+variáveis em terminal.integrated.env.osx e .linux, preservando o resto.
+
+Limitação conhecida: não há (até o momento) um mecanismo documentado do
+Antigravity para injetar env diretamente no processo do agente fora do
+terminal integrado. Se os comandos do agente não herdarem essas variáveis na
+sua versão, combine este adapter com o adapter `direnv` (.envrc) como
+fallback — o direnv aplica o env a qualquer shell que entre na pasta.
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from ..fsutil import SafeWriter
+from .base import AgentAdapter
+
+_PLATFORM_KEYS = ("terminal.integrated.env.osx", "terminal.integrated.env.linux")
+
+
+def merge_vscode_settings(existing_text: str, env: dict[str, str]) -> str:
+    """Faz merge do env em terminal.integrated.env.{osx,linux} preservando o resto."""
+    data = json.loads(existing_text) if existing_text.strip() else {}
+    if not isinstance(data, dict):
+        raise ValueError(".vscode/settings.json não contém um objeto JSON")
+    for key in _PLATFORM_KEYS:
+        current = data.get(key, {})
+        if not isinstance(current, dict):
+            current = {}
+        data[key] = {**current, **env}
+    return json.dumps(data, indent=2, ensure_ascii=False) + "\n"
+
+
+class AntigravityAdapter(AgentAdapter):
+    name = "antigravity"
+    display_name = "Antigravity"
+
+    def settings_path(self, repo: Path) -> Path:
+        return repo / ".vscode" / "settings.json"
+
+    def detect(self, repo: Path) -> bool:
+        # Workspace settings valem para qualquer repo aberto no Antigravity.
+        return True
+
+    def inject(self, repo: Path, env: dict[str, str], writer: SafeWriter) -> bool:
+        path = self.settings_path(repo)
+        existing = path.read_text() if path.exists() else ""
+        return writer.write_text(path, merge_vscode_settings(existing, env))
+
+    def validate(self, repo: Path, env: dict[str, str]) -> tuple[bool, str]:
+        path = self.settings_path(repo)
+        if not path.exists():
+            return False, ".vscode/settings.json ausente"
+        try:
+            data = json.loads(path.read_text())
+        except json.JSONDecodeError:
+            return False, ".vscode/settings.json inválido"
+        for key in _PLATFORM_KEYS:
+            current = data.get(key, {})
+            missing = [k for k, v in env.items() if current.get(k) != v]
+            if missing:
+                return False, f"{key} divergente: {', '.join(missing)}"
+        return True, "env ok"

aparta-0.1.0/src/aparta/agents/base.py

@@ -0,0 +1,40 @@
+"""Interface comum dos adapters de agentes: detect, inject, validate.
+
+Registry central: qualquer subclasse concreta de AgentAdapter com `name`
+definido é registrada automaticamente. Adicionar um agente novo = criar um
+arquivo neste pacote (os módulos são importados por aparta.agents).
+"""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from pathlib import Path
+
+from ..fsutil import SafeWriter
+
+REGISTRY: dict[str, type["AgentAdapter"]] = {}
+
+
+class AgentAdapter(ABC):
+    """Um adapter sabe injetar variáveis de ambiente em um agente para um repo."""
+
+    name: str = ""
+    display_name: str = ""
+
+    def __init_subclass__(cls, **kwargs) -> None:
+        super().__init_subclass__(**kwargs)
+        if cls.name:
+            cls.display_name = cls.display_name or cls.name
+            REGISTRY[cls.name] = cls
+
+    @abstractmethod
+    def detect(self, repo: Path) -> bool:
+        """True se o agente é usado (ou faz sentido) neste repositório."""
+
+    @abstractmethod
+    def inject(self, repo: Path, env: dict[str, str], writer: SafeWriter) -> bool:
+        """Faz merge das variáveis no arquivo de config do agente. True se mudou algo."""
+
+    @abstractmethod
+    def validate(self, repo: Path, env: dict[str, str]) -> tuple[bool, str]:
+        """(ok, mensagem) — as variáveis esperadas estão presentes?"""

aparta-0.1.0/src/aparta/agents/claude_code.py

@@ -0,0 +1,53 @@
+"""Adapter Claude Code: campo "env" em .claude/settings.local.json (merge, nunca substitui)."""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+
+from ..fsutil import SafeWriter
+from .base import AgentAdapter
+
+
+def merge_settings_env(existing_text: str, env: dict[str, str]) -> str:
+    """Faz merge do objeto env preservando todo o resto do JSON."""
+    data = json.loads(existing_text) if existing_text.strip() else {}
+    if not isinstance(data, dict):
+        raise ValueError("settings.local.json não contém um objeto JSON")
+    current_env = data.get("env", {})
+    if not isinstance(current_env, dict):
+        current_env = {}
+    data["env"] = {**current_env, **env}
+    return json.dumps(data, indent=2, ensure_ascii=False) + "\n"
+
+
+class ClaudeCodeAdapter(AgentAdapter):
+    name = "claude-code"
+    display_name = "Claude Code"
+
+    def settings_path(self, repo: Path) -> Path:
+        return repo / ".claude" / "settings.local.json"
+
+    def detect(self, repo: Path) -> bool:
+        # Claude Code funciona em qualquer repo; consideramos sempre aplicável.
+        return True
+
+    def inject(self, repo: Path, env: dict[str, str], writer: SafeWriter) -> bool:
+        path = self.settings_path(repo)
+        existing = path.read_text() if path.exists() else ""
+        merged = merge_settings_env(existing, env)
+        return writer.write_text(path, merged)
+
+    def validate(self, repo: Path, env: dict[str, str]) -> tuple[bool, str]:
+        path = self.settings_path(repo)
+        if not path.exists():
+            return False, "settings.local.json ausente"
+        try:
+            data = json.loads(path.read_text())
+        except json.JSONDecodeError:
+            return False, "settings.local.json inválido"
+        current = data.get("env", {})
+        missing = [k for k, v in env.items() if current.get(k) != v]
+        if missing:
+            return False, f"env divergente: {', '.join(missing)}"
+        return True, "env ok"

aparta-0.1.0/src/aparta/agents/codex.py

@@ -0,0 +1,50 @@
+"""Adapter Codex: seção [env] em .codex/config.toml do repositório (merge)."""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import tomli_w
+
+if sys.version_info >= (3, 11):
+    import tomllib
+else:  # pragma: no cover
+    import tomli as tomllib
+
+from ..fsutil import SafeWriter
+from .base import AgentAdapter
+
+
+def merge_codex_env(existing_text: str, env: dict[str, str]) -> str:
+    data = tomllib.loads(existing_text) if existing_text.strip() else {}
+    current = data.get("env", {})
+    if not isinstance(current, dict):
+        current = {}
+    data["env"] = {**current, **env}
+    return tomli_w.dumps(data)
+
+
+class CodexAdapter(AgentAdapter):
+    name = "codex"
+    display_name = "Codex CLI"
+
+    def config_path(self, repo: Path) -> Path:
+        return repo / ".codex" / "config.toml"
+
+    def detect(self, repo: Path) -> bool:
+        return (repo / ".codex").exists()
+
+    def inject(self, repo: Path, env: dict[str, str], writer: SafeWriter) -> bool:
+        path = self.config_path(repo)
+        existing = path.read_text() if path.exists() else ""
+        return writer.write_text(path, merge_codex_env(existing, env))
+
+    def validate(self, repo: Path, env: dict[str, str]) -> tuple[bool, str]:
+        path = self.config_path(repo)
+        if not path.exists():
+            return False, "config.toml ausente"
+        data = tomllib.loads(path.read_text())
+        current = data.get("env", {})
+        missing = [k for k, v in env.items() if current.get(k) != v]
+        return (not missing, "env ok" if not missing else f"env divergente: {', '.join(missing)}")