supa.cc 0.3.0__tar.gz

supa_cc-0.3.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,81 @@
+name: Relatar um bug
+description: Informe um comportamento incorreto após uma instalação concluída.
+title: "[Bug]: "
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use o formulário de instalação se o Supa.cc não foi instalado corretamente.
+        **Nunca inclua PATs, tokens, dumps de credenciais, itens do armazenamento nativo ou dumps completos de ambiente.**
+  - type: input
+    id: os
+    attributes:
+      label: Sistema operacional
+      placeholder: Ex. macOS 15, Ubuntu 24.04 ou Windows 11
+    validations:
+      required: true
+  - type: input
+    id: supa_cc_version
+    attributes:
+      label: Versão do Supa.cc
+      description: Saída de `supa.cc --version`.
+    validations:
+      required: true
+  - type: input
+    id: python_version
+    attributes:
+      label: Versão do Python
+      description: Saída de `python3 --version` ou `python --version`.
+    validations:
+      required: true
+  - type: input
+    id: supabase_cli_version
+    attributes:
+      label: Versão do Supabase CLI
+      description: Saída de `supabase --version`.
+    validations:
+      required: true
+  - type: dropdown
+    id: installation_method
+    attributes:
+      label: Método de instalação
+      options:
+        - Homebrew
+        - pipx
+        - Instalação de desenvolvimento
+        - Outro
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Como reproduzir
+      description: Liste os comandos e passos mínimos, sem segredos.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Comportamento esperado
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Comportamento atual
+    validations:
+      required: true
+  - type: textarea
+    id: doctor
+    attributes:
+      label: Saída sanitizada de `supa.cc doctor --json`
+      description: Remova nomes de contas, caminhos pessoais e outros dados identificáveis. Nunca execute o modo `--live` para preencher este campo.
+      render: json
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Confirmação de segurança
+      options:
+        - label: Revisei o relato e removi PATs, tokens, dumps de credenciais e outros segredos.
+          required: true

supa_cc-0.3.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Dúvidas e suporte
+    url: https://github.com/dgabreuu/supa.cc/issues
+    about: Consulte as issues existentes ou escolha um dos formulários oficiais.
+  - name: Relatar uma vulnerabilidade
+    url: https://github.com/dgabreuu/supa.cc/security/advisories/new
+    about: Envie problemas de segurança de forma privada; nunca publique tokens.

supa_cc-0.3.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,31 @@
+name: Sugerir uma funcionalidade
+description: Proponha uma melhoria ou novo comportamento para o Supa.cc.
+title: "[Funcionalidade]: "
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use os formulários específicos para bugs e problemas de instalação.
+        **Nunca inclua PATs, tokens, dumps de credenciais, itens do armazenamento nativo ou dumps completos de ambiente.**
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problema ou necessidade
+      description: Explique o caso de uso sem incluir dados sensíveis.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Solução proposta
+      description: Descreva o comportamento desejado e alternativas consideradas.
+    validations:
+      required: true
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Confirmação de segurança
+      options:
+        - label: Revisei a proposta e removi PATs, tokens, dumps de credenciais e outros segredos.
+          required: true

supa_cc-0.3.0/.github/ISSUE_TEMPLATE/install_problem.yml

@@ -0,0 +1,80 @@
+name: Problema de instalação
+description: Peça ajuda para instalar, atualizar ou iniciar o Supa.cc.
+title: "[Instalação]: "
+labels: [installation]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Para bugs após uma instalação concluída, use o formulário de bug.
+        **Nunca inclua PATs, tokens, dumps de credenciais, itens do armazenamento nativo ou dumps completos de ambiente.**
+  - type: input
+    id: os
+    attributes:
+      label: Sistema operacional
+      placeholder: Inclua distribuição e versão, quando aplicável.
+    validations:
+      required: true
+  - type: input
+    id: supa_cc_version
+    attributes:
+      label: Versão do Supa.cc
+      description: Informe a saída de `supa.cc --version`, ou "não disponível" se o comando não inicia.
+    validations:
+      required: true
+  - type: input
+    id: python_version
+    attributes:
+      label: Versão do Python
+    validations:
+      required: true
+  - type: input
+    id: supabase_cli_version
+    attributes:
+      label: Versão do Supabase CLI
+    validations:
+      required: true
+  - type: dropdown
+    id: installation_method
+    attributes:
+      label: Método de instalação
+      options:
+        - Homebrew
+        - pipx
+        - Instalação de desenvolvimento
+        - Outro
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Como reproduzir
+      description: Inclua o comando de instalação e os passos executados.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Comportamento esperado
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Comportamento atual
+      description: Inclua a mensagem de erro completa depois de remover segredos e caminhos pessoais.
+    validations:
+      required: true
+  - type: textarea
+    id: doctor
+    attributes:
+      label: Saída sanitizada de `supa.cc doctor --json`
+      description: Se o comando estiver disponível, remova nomes de contas, caminhos pessoais e dados identificáveis. Nunca use `--live` para este diagnóstico.
+      render: json
+  - type: checkboxes
+    id: safety
+    attributes:
+      label: Confirmação de segurança
+      options:
+        - label: Revisei o relato e removi PATs, tokens, dumps de credenciais e outros segredos.
+          required: true

supa_cc-0.3.0/.github/workflows/ci.yml

@@ -0,0 +1,84 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test-build:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.9", "3.x"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Install development dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Test and validate dependencies
+        run: |
+          python -m pytest
+          python -m pip check
+          # These fixes require Python 3.10+. Keep exceptions confined to the 3.9 matrix.
+          pip-audit --skip-editable ${{ matrix.python-version == '3.9' && '--ignore-vuln PYSEC-2026-1375 --ignore-vuln PYSEC-2026-1374 --ignore-vuln GHSA-6v7p-g79w-8964 --ignore-vuln PYSEC-2026-196 --ignore-vuln GHSA-58qw-9mgm-455v --ignore-vuln GHSA-jp4c-xjxw-mgf9 --ignore-vuln PYSEC-2026-1845 --ignore-vuln GHSA-gc5v-m9x4-r6x2 --ignore-vuln PYSEC-2026-142 --ignore-vuln PYSEC-2026-141' || '' }}
+          python scripts/runtime_requirements.py runtime-requirements.txt
+          pip-audit --requirement runtime-requirements.txt
+      - name: Build artifacts
+        run: python -m build
+      - name: Inspect artifact members
+        run: python scripts/inspect_artifacts.py dist
+      - name: Install wheel in isolated environment
+        shell: bash
+        run: |
+          python -m venv wheel-test
+          wheel-test/bin/python -m pip install dist/*.whl
+          wheel-test/bin/python -m pip check
+          wheel-test/bin/supa.cc --version
+          wheel-test/bin/supa.cc version
+        if: runner.os != 'Windows'
+      - name: Install wheel in isolated Windows environment
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          python -m venv wheel-test
+          $wheel = (Get-ChildItem dist\*.whl).FullName
+          wheel-test\Scripts\python.exe -m pip install $wheel
+          wheel-test\Scripts\python.exe -m pip check
+          wheel-test\Scripts\supa.cc.exe --version
+          wheel-test\Scripts\supa.cc.exe version
+      - uses: actions/upload-artifact@v4
+        with:
+          name: packages-${{ matrix.os }}-py${{ matrix.python-version }}
+          path: dist/*
+
+  linux-distributions:
+    strategy:
+      matrix:
+        include:
+          - image: fedora:latest
+            install: dnf install -y python3 python3-pip
+          - image: archlinux:latest
+            install: pacman -Syu --noconfirm python python-pip
+    runs-on: ubuntu-latest
+    container: ${{ matrix.image }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Python
+        run: ${{ matrix.install }}
+      - name: Test environment behavior and build without Secret Service
+        run: |
+          python3 -m pip install --break-system-packages --upgrade pip
+          python3 -m pip install --break-system-packages -e ".[dev]"
+          python3 -m pytest -m "not real_keychain and not real_secret_service" tests/test_environment.py tests/test_installation.py tests/test_linux_secret_service_smoke.py
+          python3 -m build
+          python3 -m pip check

supa_cc-0.3.0/.github/workflows/release.yml

@@ -0,0 +1,104 @@
+name: Publish release
+
+on:
+  release:
+    types: [published]
+
+permissions: {}
+
+jobs:
+  build:
+    if: github.event.release.draft == false && github.event.release.prerelease == false
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Require stable published release
+        env:
+          RELEASE_DRAFT: ${{ github.event.release.draft }}
+          RELEASE_PRERELEASE: ${{ github.event.release.prerelease }}
+        run: |
+          if [ "$RELEASE_DRAFT" != "false" ] || [ "$RELEASE_PRERELEASE" != "false" ]; then
+            echo "Refusing to build a draft or prerelease."
+            exit 1
+          fi
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+        with:
+          ref: ${{ github.event.release.tag_name }}
+          persist-credentials: false
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Validate release tag and package version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          python - <<'PY'
+          import os
+          import pathlib
+          import tomllib
+
+          version = tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["version"]
+          expected_tag = f"v{version}"
+          if os.environ["RELEASE_TAG"] != expected_tag:
+              raise SystemExit(f"release tag must be {expected_tag}")
+          PY
+      - name: Install development dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Test and validate dependencies
+        run: |
+          python -m pytest
+          python -m pip check
+          pip-audit --skip-editable
+          python scripts/runtime_requirements.py runtime-requirements.txt
+          pip-audit --requirement runtime-requirements.txt
+      - name: Build release artifacts once
+        run: python -m build
+      - name: Inspect release artifacts
+        run: python scripts/inspect_artifacts.py dist
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: python-packages
+          path: dist/
+          if-no-files-found: error
+          retention-days: 7
+
+  publish:
+    needs: build
+    if: success()
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/supa.cc/0.3.0/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          name: python-packages
+          path: dist/
+      - name: Publish to PyPI with Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1
+
+  verify-pypi:
+    needs: publish
+    if: success()
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
+        with:
+          python-version: "3.12"
+      - name: Install pipx
+        run: python -m pip install pipx
+      - name: Verify package from PyPI
+        run: |
+          pipx install supa.cc==0.3.0
+          supa.cc --version
+          supa.cc version

supa_cc-0.3.0/.gitignore

@@ -0,0 +1,124 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.pyre/
+.pytype/
+cover/
+
+# Python local packages
+__pypackages__/
+
+# Virtual environments
+.env
+.env.*
+!.env.example
+!.env.*.example
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Logs
+*.log
+*.log.*
+logs/
+
+# Supabase local CLI state
+.supabase/
+supabase/.temp/
+supabase/.branches/
+supabase/.cache/
+
+# Sensitive local artifacts
+*.pem
+*.key
+*.crt
+*.p12
+*.pfx
+*.jks
+*.keystore
+credentials.json
+service-account*.json
+*.diff
+
+# supa.cc / Supabase runtime state (never commit; lives under ~/.config by default)
+accounts.json
+active-account
+session-sync.json
+.session-sync.lock
+.accounts.json.lock
+.accounts.json.*
+access-token
+
+# Generated publication snapshots
+.publish/
+
+# Local agent / editor / session tooling
+.claude/
+.cursor/
+.opencode/
+.superpowers/
+docs/superpowers/
+napkin.md

supa_cc-0.3.0/AGENTS.md

@@ -0,0 +1,37 @@
+# Instruções para agentes
+
+Mantenha toda contribuição genérica e segura para este repositório open source público.
+
+## Estrutura
+
+| Caminho | Responsabilidade |
+| --- | --- |
+| `supa_cc/` | Código-fonte Python |
+| `tests/` | Suíte `pytest` |
+| `docs/` | Instalação, uso, segurança, remediação e release |
+| `Formula/` | Fórmula Homebrew |
+| `pyproject.toml` | Metadados, dependências, build e ferramentas |
+| `README.md` | Apresentação pública concisa |
+| `SKILL.md` | Invariantes operacionais para agentes |
+
+## Convenções
+
+- Python 3.9+, build com `hatchling` e console script `supa.cc`.
+- Siga os padrões existentes em `supa_cc/`, mantenha arquivos focados e cubra mudanças de comportamento em `tests/`.
+- Dependências de runtime: `click`, `questionary`, `rich` e `keyring`. Dependências de desenvolvimento são declaradas em `pyproject.toml`.
+- Execute `python3 -m pytest`; veja [Como contribuir](CONTRIBUTING.md) para preparação do ambiente, build e smokes nativos.
+- Atualize o documento canônico correspondente: [Instalação](docs/installation.md), [Uso](docs/usage.md), [Segurança](docs/security.md) ou [Solução de problemas](docs/troubleshooting.md).
+
+## GitHub
+
+- O repositório oficial é `https://github.com/dgabreuu/supa.cc.git`.
+- Operações no GitHub assumem a conta `dgabreuu`; não sugira outra conta, chave SSH ou remote.
+- Use mensagens de commit concisas e alinhadas ao histórico.
+
+## Segurança pública
+
+- Nunca exponha PATs reais em código, testes, logs, documentação, prompts ou transcripts. Os formatos aceitos começam com `sbp_` ou `sbp_oauth_` e são validados antes do armazenamento; não publique exemplos com aparência de credencial.
+- Não publique caminhos locais absolutos, e-mails pessoais, nomes de usuário, remotes privados, dumps completos de ambiente ou conteúdo do armazenamento nativo.
+- Não introduza fallback plaintext, `keyrings.alt` ou backends não suportados. Preserve as invariantes detalhadas em [SKILL.md](SKILL.md) e no [modelo de segurança](docs/security.md).
+- Preserve os backends nativos: Keychain no macOS, Secret Service no Linux e Windows Credential Manager por `WinVaultKeyring` no Windows.
+- Antes de publicar, revise histórico, arquivos ignorados, logs, caches, ambientes virtuais, fixtures e capturas de tela em busca de segredos.

supa_cc-0.3.0/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+Todas as mudanças relevantes deste projeto serão documentadas neste arquivo.
+O formato segue, de maneira simplificada, o Keep a Changelog.
+
+## [0.3.0] - Não lançado (preparado)
+
+### Adicionado
+
+- Suporte a Debian/Ubuntu, Arch Linux e Fedora com Secret Service, além de suporte ao Windows Credential Manager.
+- Diagnóstico seguro com `doctor`, saída JSON e validação autenticada explícita por `--account <nome> --live`.
+- Sincronização da sessão nativa do perfil oficial `supabase` ao ativar ou remover a conta ativa.
+
+### Alterado
+
+- A troca de conta passa a verificar a sessão nativa efetiva da Supabase CLI e a manter estado de coordenação sem segredo.
+- O armazenamento de credenciais e os caminhos de estado agora são selecionados de acordo com macOS, Linux ou Windows.
+
+### Segurança
+
+- Backends de credenciais são restritos ao Keychain, Secret Service ou `WinVaultKeyring`, sem fallback plaintext.
+- No macOS e Linux, o executável da Supabase CLI é validado por tipo, execução, proprietário e modos; no Windows, o arquivo regular e a identidade do caminho são verificados após a abertura e imediatamente antes da criação do processo, sem alegar execução por descritor, validação de ACL ou modos POSIX.
+- A credencial nativa e operações de recuperação são verificadas antes da conclusão de mudanças sensíveis.
+- Travas e metadados de recuperação tornam a atualização da sessão resistente a interrupções entre etapas.
+
+### Migração da 0.2.0
+
+- No macOS, a 0.3.0 preserva o serviço de credenciais `supa.cc.supabase.accounts.v2` e o índice `~/.config/supa.cc/accounts.json` usados pela 0.2.0.
+- Linux e Windows são canais novos na 0.3.0 e, portanto, não possuem estado da 0.2.0 para migrar nesses sistemas.
+
+[0.3.0]: https://github.com/dgabreuu/supa.cc/compare/v0.2.0...HEAD

supa_cc-0.3.0/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Como contribuir
+
+Obrigado por contribuir com o Supa.cc. Use as [GitHub Issues](https://github.com/dgabreuu/supa.cc/issues) para bugs, problemas de instalação e propostas de funcionalidade. Vulnerabilidades devem seguir exclusivamente a [política de segurança](SECURITY.md).
+
+## Ambiente de desenvolvimento
+
+O projeto requer Python 3.9 ou mais recente. Faça um fork, clone o repositório e instale o pacote com as dependências de desenvolvimento.
+
+### macOS e Linux (POSIX)
+
+```bash
+python3 -m pip install -e ".[dev]"
+python3 -m pytest
+```
+
+### Windows
+
+```powershell
+py -m pip install -e ".[dev]"
+py -m pytest
+```
+
+Para mudanças de empacotamento, valide também:
+
+```text
+python3 -m build
+python3 scripts/inspect_artifacts.py dist
+# Windows: substitua python3 por py
+```
+
+## Smokes nativos
+
+Testes que acessam o armazenamento real são opt-in, específicos da plataforma e exigem consentimento explícito. Eles criam o serviço `supa.cc.tests.<uuid>` e a conta `smoke-<uuid>`, removidos em `finally`; nunca acessa o serviço canônico do Supa.cc nem credenciais do Supabase CLI.
+
+```bash
+SUPA_CC_RUN_KEYCHAIN_SMOKE=1 .venv/bin/pytest -q tests/test_macos_keychain_smoke.py
+SUPA_CC_REAL_SECRET_SERVICE=1 .venv/bin/pytest -q tests/test_linux_secret_service_smoke.py
+SUPA_CC_RUN_WINDOWS_CREDENTIAL_MANAGER_SMOKE=1 .venv/bin/pytest -q tests/test_windows_credential_manager_smoke.py
+```
+
+## Diretrizes
+
+- Mantenha mudanças pequenas, focadas e acompanhadas por testes quando alterarem comportamento.
+- Preserve suporte a macOS, Debian/Ubuntu, Arch Linux, Fedora e Windows conforme a documentação atual.
+- Atualize a documentação pública quando comandos ou comportamento mudarem.
+- Descreva como a mudança foi validada.
+
+## Dados sensíveis
+
+Nunca inclua PATs, tokens do Supabase, itens do armazenamento nativo, dumps de credenciais ou dumps completos de ambiente em issues, pull requests, testes, logs ou documentação. Use somente dados fictícios que não tenham formato de credencial real.