[P1][bugfix][ux] post3: help mostra `data-boar` + caminho concreto por-OS (não `uv run main.py` nem `~`)

[FabioLeitao]

Problema (1º usuário non-techie, 02/jul)

TODO o help user-facing usa a forma DEV (uv run python main.py / python main.py) — mas o usuário instalado (pipx) tem o entry point data-boar, sem repo/uv/main.py. E onde há caminho, ~ é cryptic pro leigo (mesma classe do */>>>/"navegador" que confundiram o 1º usuário — 2 fotos de tela).

Locais (verificados):

• main.py:291, 297 — help do CLI (--validate-config/--export-dsar).
• api/templates/help.html — help do dashBOARd (o que o usuário VÊ).
• Dev-facing CONTRIBUTING.md/QUICKSTART.md seguem python main.py (guardrail — NÃO mexer).

Fix (2 detecções em runtime)

1. Comando: prog dinâmico. parser.prog/argv[0] → instalado vê data-boar ..., dev vê python main.py .... Um código, cada um vê o que TEM.
2. Caminho: concreto OS-aware. Onde o help ilustra path, mostrar Path.home() real (C:\Users\<user> Win / /home/<user> Linux) — NÃO ~ (leigo não entende token). Detecta OS em runtime (o servidor roda na máquina do user → os.name = OS dele).

AC

• main.py:291,297: prog dinâmico + Path.home() concreto onde ilustrar path.
• api/templates/help.html: route passa prog + home_example (Path.home()) no contexto; template renderiza por-OS.
• Dev-docs permanecem python main.py.
  Liga: [docs][ux] guia Windows: explicar o PORQUÊ da versão Python (não só o como) — non-techie instalou 3.14 #1126 · post3. (O config sample INTERNO usa ~ portável — issue-A; aqui é o HELP lido por humano.)

[FabioLeitao]

Sugestao de fix (R.O. auditor) — 2 deteccoes em runtime

1. Prog dinamico (data-boar instalado vs dev):

def _display_prog():
    argv0 = Path(sys.argv[0]).name
    return "data-boar" if argv0 in ("data-boar","data-boar.exe") else "python main.py"

2. Caminho concreto por-OS (nao ~, cryptic pro leigo):

def _display_home_path(subpath=""):
    home = Path.home()
    return str(home / subpath if subpath else home)  # absoluto, nativo do SO

Aplicar em main.py:291,297 + api/templates/help.html (o que o usuario VE). NAO mexer em CONTRIBUTING/QUICKSTART (dev-facing, guardrail). Conecta com a filosofia de material-de-treino pro leigo: ~/*/>>> travaram o 1o usuario real. Testes no pacote PATCH_PACK_security_ux_2026-07-05.md. P1 de UX porque afeta TODO usuario instalado.

— claude.ai · Auditor R.O. externo (steering/altitude) · Sonnet 5 · A.I.I.D.C.O.B.P.P. v1.4