@boxes-dev/dvb-runtime 1.0.1052 → 1.0.1054

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -23,9 +23,11 @@ Ground rules:
23
23
  - Answer questions about boxes.dev product behavior from the bundled product
24
24
  docs, not memory. Run `dvb agent-docs` for the index, then
25
25
  `dvb agent-docs <topic>` for the smallest relevant reference.
26
- - If you spot a boxes.dev bug while working, report it with
26
+ - If you spot a boxes.dev bug while working, or a command or guide's
27
+ instructions don't match what actually happened, report it with
27
28
  `dvb report-bug "<description>"` or pipe a longer report to
28
29
  `dvb report-bug --stdin`. Submissions from coding agents are welcome.
30
+ `dvb agent-init guide recovery` says what a useful report includes.
29
31
 
30
32
  ## Phase 1: Prerequisites
31
33
 
@@ -32,3 +32,25 @@ completed — `destroy --yes` and re-run is the honest repair.
32
32
 
33
33
  `dvb agent-init diagnostics` prints a redacted state dump (local + remote)
34
34
  for debugging when something looks wrong.
35
+
36
+ ## Reporting a boxes.dev bug
37
+
38
+ Report a bug with `dvb report-bug --stdin` when a `dvb agent-init` command
39
+ fails in a way this guide doesn't explain, when its output contradicts these
40
+ guides, or when setup otherwise misbehaves. A failed setup command prints a
41
+ reminder about this just before its error.
42
+
43
+ Include the command you ran, what happened, the error text, and what you
44
+ expected. Leave out secret values and the contents of the user's files. For
45
+ example:
46
+
47
+ ```sh
48
+ dvb report-bug --stdin <<'EOF'
49
+ Command: dvb agent-init check
50
+ What happened: check reported a missing env file that exists.
51
+ Error: files.env[0]: The source file does not exist.
52
+ Expected: check to pass, because .env.local is in the project folder.
53
+ EOF
54
+ ```
55
+
56
+ After you submit the report, tell the user what you reported.
@@ -54,3 +54,6 @@ Guards to expect:
54
54
  If the command is interrupted, nothing is lost: `dvb agent-init status`
55
55
  shows where things stand and `dvb agent-init watch` re-attaches (see
56
56
  `guide recovery`).
57
+
58
+ If `run` fails and `dvb agent-init retry` doesn't fix it, report the failure
59
+ with `dvb report-bug --stdin` (see `guide recovery`).