GNX Courage Text™ / hoKssi.com · Evidence CLI

1. Evidence CLI 목적

Evidence CLI 문서는 운영자가 서버 상태와 감사 증적을 명령으로 재현할 수 있게 한다. 결과는 계약/검증 미팅에서 기술 주장 대신 증거로 제시한다.

2. Health evidence

bash
curl -s https://hokssi.com/health | jq .
docker compose -f /opt/hokssi/docker-compose.yml --project-directory /opt/hokssi ps

Expected: ok true, redis PONG, api/postgres/redis/worker Up.

3. Handoff evidence

bash
ADMIN_API_KEY=$(grep '^ADMIN_API_KEY=' /opt/hokssi/.env | cut -d= -f2)
curl -s https://hokssi.com/v1/admin/audit -H "x-admin-api-key: $ADMIN_API_KEY" | jq '.audit[0:20]'

Expected audit includes intent_created, visible_clues_recorded, requester_contact_secret_recorded, handoff_card_created, web_handoff_sms_compose_opened or web_handoff_consent_relay_open depending on test path.

4. Outbound safety evidence

bash
grep -E '^(ENABLE_OUTBOUND_SEND|DELIVERY_MODE|SMS_PROVIDER)=' /opt/hokssi/.env
docker logs --tail=120 hokssi-worker | grep outbound_dispatch_blocked

Expected: ENABLE_OUTBOUND_SEND=false, DELIVERY_MODE=device_handoff, SMS_PROVIDER=unconfigured, worker log reason ENABLE_OUTBOUND_SEND_not_true.

5. DB evidence

bash
docker exec -i hokssi-postgres psql -U hokssi -d hokssi -c "SELECT id,state,expires_at,created_at,updated_at FROM text_intents ORDER BY created_at DESC LIMIT 10;"
docker exec -i hokssi-postgres psql -U hokssi -d hokssi -c "SELECT intent_id,provider,delivery_state,attempts,sent_at FROM outbound_messages ORDER BY created_at DESC LIMIT 10;"

Expected outbound remains queued_not_sent attempts 0 sent_at null while provider is locked.

6. Vaporize evidence

bash
ADMIN_API_KEY=$(grep '^ADMIN_API_KEY=' /opt/hokssi/.env | cut -d= -f2)
curl -s -X POST https://hokssi.com/v1/system/burn-expired -H "x-admin-api-key: $ADMIN_API_KEY" | jq .

Expected expired intents move to BURNED and worker logs vaporize related events.

7. Readiness command

bash
hokssicheck
hokssiready
hokssidone

hokssicheck and hokssiready are readiness checks. hokssidone runs hokssicheck and exits SSH; Docker/Nginx/API/worker keep running.