specimba commited on
Commit
0fc0df6
·
verified ·
1 Parent(s): dc6756e

docs: add space log api workflow

Browse files
Files changed (1) hide show
  1. docs/HANDOFF_FINAL_HACKATHON.md +21 -0
docs/HANDOFF_FINAL_HACKATHON.md CHANGED
@@ -36,6 +36,27 @@ hf spaces info build-small-hackathon/NEXUS_Visual_Weaver --format json
36
 
37
  Avoid pytest `--basetemp=C:\tmp` in this Windows sandbox if `tmp_path` fixtures fail with `PermissionError`. The current tests avoid `tmp_path`.
38
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
39
  ## Runtime Flow
40
 
41
  1. `run_active_weave` builds the Raven Chronicle run packet.
 
36
 
37
  Avoid pytest `--basetemp=C:\tmp` in this Windows sandbox if `tmp_path` fixtures fail with `PermissionError`. The current tests avoid `tmp_path`.
38
 
39
+ ## HF Space Log Observation
40
+
41
+ Use the authenticated Hugging Face SSE log APIs for final runtime/build evidence. Do not paste tokens into chat or files; use a local environment variable or the local `huggingface_hub` token cache.
42
+
43
+ ```powershell
44
+ # Container logs
45
+ curl.exe -N -H "Authorization: Bearer $env:HF_TOKEN" `
46
+ "https://huggingface.co/api/spaces/build-small-hackathon/NEXUS_Visual_Weaver/logs/run"
47
+
48
+ # Build logs
49
+ curl.exe -N -H "Authorization: Bearer $env:HF_TOKEN" `
50
+ "https://huggingface.co/api/spaces/build-small-hackathon/NEXUS_Visual_Weaver/logs/build"
51
+ ```
52
+
53
+ If local proxy/TLS settings break PowerShell or `curl`, use a bounded Python/httpx stream with `trust_env=False`, loaded from the local HF token cache. Redact the token from any printed output.
54
+
55
+ Current evidence from the SSE API:
56
+
57
+ - `logs/run` returns HTTP 200 and shows the Gradio/MCP startup stream.
58
+ - `logs/build` returns HTTP 200 and shows Build Queued for Space commit `dc6756e`.
59
+
60
  ## Runtime Flow
61
 
62
  1. `run_active_weave` builds the Raven Chronicle run packet.