[E2E] Relatório de usabilidade Procyon 0.1.1 no template my-app (counter + my_app_token)

[Dione-b]

Relatório E2E + Usabilidade Procyon 0.1.1 — template my-app (counter + my_app_token)

Data: 2026-08-23
Procyon: 0.1.1 (/home/dionebastos/.cargo/bin/procyon) — procyon --knowledge 50+ skills, provider=ollama qwen3:4b-instruct-2507-q4_K_M max_tokens=4096 allow_mainnet=false
Workspace: /home/dionebastos/Documentos/PROJETOS/my-app (Caatinga caatinga.config.ts:1) + nested my-app/.procyon/project.toml:1
Método: procyon --exec "prompt" (headless, mesmas tools do TUI) + verificação manual cargo test / ctg doctor / stellar keys ls

Issues vinculadas: #4 #5 #6 #7 #8

---

1) Saúde E2E do projeto (ground-truth)

Camada	Status	Evidência
Counter contracts/counter/src/lib.rs:1	✅ 4/4	cargo test --manifest-path contracts/counter/Cargo.toml → ok. 4 passed (get_returns_zero_before_increment, increments_counter, repeated_increments_preserve_state, increment_returns_overflow_error)
MyAppToken my-app/contracts/my_app_token/src/lib.rs:1	✅ 5/5	cargo test → ok. 5 passed em 35s (mint/transfer/initialize)
Frontend src/App.tsx:1, src/caatinga.ts:1	❌ bloqueado	src/contracts/generated/counter/src/index.ts:1 placeholder __caatingaPlaceholder=true → PLACEHOLDER_BINDING. caatinga.artifacts.json:1 = contracts:{} vazio. npm ls → UNMET DEPENDENCY, npx tsc/npm run build → tsc: not found. vite.config.ts:1 aliases walletStubViteAliases ok mas sem node_modules
Caatinga Doctor	❌ blocked	npx ctg doctor → ✓ Node 22.22.0, stellar 27.0.0, rustc 1.97.1, wasm32v1-none mas ✗ Project dependencies not installed → Status: blocked
Deploy	❌ sem contrato	stellar keys ls → alice,deployer,e2e-tester existem, mas sem contractId em artifacts → caatinga_read/caatinga_invoke recusariam
WASM	⚠️ divergente	caatinga.config.ts:8 → wasm: ./contracts/counter/target/wasm32v1-none/release/counter.wasm mas inner my_app_token não declarado em contracts

Conclusão: contratos Rust sadios, dApp quebrado em npm install → ctg build → ctg generate. Procyon diagnosticou corretamente a causa raiz.

---

2) Matriz Procyon --exec (10 prompts)

Prompt	Tool esperado	Observado	Latência
How many contracts...	glob/list_dir	✅ counter	~8s
caatinga doctor	caatinga_doctor	✅ dependencies not installed + npm install	~12s
run_tests / Use the run_tests tool	run_tests	❌ hallucina I don't have run_tests (qwen3:4b) — tool existe em src/tools/test.rs	~6s
caatinga_build counter	caatinga_build	❌ This is not a Caatinga project: no caatinga.config.ts mesmo com caatinga.config.ts:1 presente (quando nested .procyon/ existe)	~5s
list_dir + read_file caatinga.config.ts	list_dir+read_file	✅ OK (read-only sem --allow-changes)	~7s
write_file procyon-e2e-write-test.txt sem --allow-changes	write_file	✅ gate correto: declined … Use --allow-changes sem escrever	~4s
write_file ... com --allow-changes	write_file	✅ cria teste123	~6s
project_info no outer	project_info	❌ No .procyon/project.toml — outer usa Caatinga, não Procyon	~4s
caatinga_doctor no inner my-app/	caatinga_doctor	❌ no caatinga.config.ts — inner é Procyon puro	~4s
grep/glob genérico	grep	❌ timeout/alucina com qwen3 mas funciona no repo procyon fonte (56 matches Ollama)	—

Taxa sucesso leitura/diagnóstico ~60%, build/test ~0% com qwen3:4b.

Evidências: ~/.local/share/procyon/sessions/home-dionebastos-Documentos-PROJETOS-my-app/*.jsonl (50+ sessões), procyon --knowledge, procyon --sessions.

---

3) Usabilidade

Fortes:

• Confinamento src/tools/paths.rs:resolve_in_workspace bloqueia ../ e symlink escape — testado
• Gate confirm/deny centralizado src/tools/mainnet.rs — --allow-changes só libera confirm, deny (mainnet/secret) permanece. Secret S... rejeitado sem eco
• Sessões JSONL persistentes ~/.local/share/procyon/sessions/ + procyon --sessions/--resume + compactação 80% budget.rs:26 (OLLAMA_CONTEXT_WINDOW=4096)
• --exec fiel ao TUI, útil CI
• procyon --knowledge com digest por skill versionado

Fricções: ver #4, #5, #6, #7, #8

Recomendação imediata ao usuário: npm install && npx ctg build counter && npx ctg generate counter --network testnet && npm run dev antes de testar invoke. Considerar trocar ~/.config/procyon/config.toml:4 para llama3.1:8b disponível em ollama list.

Checklist de correção está nas issues vinculadas.

[Dione-b]

Issues vinculadas criadas nesta bateria E2E:

• Bug: caatinga_build/caatinga_doctor falso-negativo com .procyon aninhado #4 Bug caatinga_build/caatinga_doctor falso-negativo com .procyon aninhado
• Bug: run_tests alucinado como inexistente com Ollama qwen3:4b (OLLAMA_CORE_TOOLS filtra test) #5 Bug run_tests alucinado com Ollama qwen3:4b (OLLAMA_CORE_TOOLS)
• Enhancement: dual-scaffold Caatinga vs Procyon confuso (project_info vs caatinga_doctor) #6 Enhancement dual-scaffold Caatinga vs Procyon
• Enhancement: Ollama 4096 ctx cap via /v1/chat/completions trunca E2E + OLLAMA_CORE_TOOLS #7 Enhancement Ollama 4096 ctx cap
• Bug: placeholder bindings + npm install deadlock bloqueia E2E (template my-app) #8 Bug placeholder bindings + npm deadlock

Todas anotadas via gh issue create com logs procyon --exec e cargo test.