Metadata-Version: 2.4
Name: pdr-project72
Version: 0.1.0
Summary: PDR Bridge — Thin-client local do PDR Project72 SaaS
Author-email: Araken13 <contato@appneia.com.br>
License: MIT
Project-URL: Homepage, https://mcp.appneia.com.br
Project-URL: Repository, https://github.com/Araken13/sovereign-pdr-cloud
Project-URL: Bug Tracker, https://github.com/Araken13/sovereign-pdr-cloud/issues
Keywords: mcp,ai,bridge,context,developer-tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"

# 🌉 pdr-bridge — PDR Project72 Thin-Client

> Ponte local que conecta o **PDR Engine** rodando no EC2 ao seu filesystem local.
> Instale, autorize uma pasta e o Claude Desktop passa a poder ler/escrever arquivos no seu PC — sem que nenhum código do motor proprietário rode localmente.

## Instalação

```bash
pip install pdr-project72
```

## Uso rápido

```bash
# 1. Inicie o bridge autorizando uma pasta
pdr-bridge start --allow "D:\meus_projetos"

# 2. Configure o Claude Desktop automaticamente
pdr-bridge install-claude --cf-id SEU_CF_ID --cf-secret SEU_CF_SECRET

# 3. Reinicie o Claude Desktop
```

## Segurança

- ✅ Validação de caminhos com canonicalização (`os.path.realpath`) — imune a path traversal
- ✅ Audit log local em JSON Lines (nunca loga conteúdo, apenas metadados)
- ✅ Rate limit: 60 req/min por sessão
- ✅ Limites físicos: leitura máx 512 KB, escrita máx 1 MB
- ✅ Delete requer confirmação explícita em cada requisição
- ✅ Permissões por pasta: `read` / `write` / `delete` configuráveis

## Arquitetura

```
Claude Desktop
     ↓  MCP (stdio/SSE)
mcp-remote (npx)
     ↓  HTTPS/SSE  
EC2 — PDR Engine (Rust, código fechado)
     ↕  WebSocket TLS (wss://)
pdr-bridge (este pacote — código aberto)
     ↕  syscalls locais
D:\meus_projetos\  (pastas autorizadas por você)
```

## Licença

MIT © Araken13
