@boxes-dev/dvb-runtime 1.0.1103 → 1.0.1104
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.
- package/dist/agent-init-guides/agent-config.md +34 -0
- package/dist/agent-init-guides/flow.md +36 -0
- package/dist/agent-init-guides/manifest.md +6 -0
- package/dist/agent-init-guides/recovery.md +22 -0
- package/dist/agent-init-guides/running.md +12 -0
- package/dist/bin/dvb.mjs +1348 -1265
- package/dist/bin/dvbd.mjs +4 -4
- package/dist/product-docs/references/automations.md +18 -3
- package/dist/product-docs/references/desktop-workbench.md +6 -0
- package/dist/product-docs/references/files-git-and-review.md +3 -2
- package/dist/product-docs/references/fork-workflows.md +3 -1
- package/dist/product-docs/references/member-managed-files.md +2 -1
- package/dist/product-docs/references/mobile.md +58 -17
- package/dist/product-docs/references/onbox-agent-tools.md +3 -5
- package/dist/product-docs/references/project-setup.md +34 -0
- package/dist/product-docs/references/slack.md +8 -5
- package/dist/product-docs/references/threads-and-agents.md +8 -4
- package/dist/product-docs/references/unattended-work.md +5 -0
- package/package.json +2 -2
|
@@ -19,6 +19,40 @@ selection with a label comment per item, and lists what was left out.
|
|
|
19
19
|
are restored as config and re-authenticated on the Template box after setup
|
|
20
20
|
(the user completes that from the desktop app).
|
|
21
21
|
|
|
22
|
+
`dvb agent-init detect agent-config` lists names, selection ids, and sizes;
|
|
23
|
+
add `--json` for source paths and exact byte counts. Sizes include linked
|
|
24
|
+
support files. Use the detected individual ids, such as `claude:skill:review`
|
|
25
|
+
or `codex:skill:.system/writer`, to choose a subset in `agentConfig.include`.
|
|
26
|
+
These examples illustrate the format; use the actual ids from detection.
|
|
27
|
+
Remove `claude:skills` or `codex:skills` for an agent whose skills you are
|
|
28
|
+
selecting individually. Those whole-folder ids remain supported and will
|
|
29
|
+
include the entire folder if retained, regardless of individual selections.
|
|
30
|
+
Selected skills retain their support files; the local originals are unchanged.
|
|
31
|
+
Whole-folder selections in saved manifests keep their existing meaning.
|
|
32
|
+
|
|
33
|
+
Review the detected configuration and recommend what will help with this
|
|
34
|
+
project and the user's development workflow. Skills for testing, browser
|
|
35
|
+
automation, or code review can be useful even when the app itself does not
|
|
36
|
+
depend on them. Read relevant skill descriptions and consider the tools they
|
|
37
|
+
need on the Template box; neither detection nor optional status alone decides
|
|
38
|
+
whether something belongs in the import.
|
|
39
|
+
|
|
40
|
+
Consider size alongside usefulness. A skill collection can include supporting
|
|
41
|
+
tools, dependencies, browser files, and caches, including linked contents;
|
|
42
|
+
its upload size is not just its Markdown instructions. Inspect relevant skill
|
|
43
|
+
descriptions read-only. Explain any large collection's value and upload cost
|
|
44
|
+
so the user can decide; size alone
|
|
45
|
+
is not a reason to exclude useful configuration or strip required support
|
|
46
|
+
files out of a skill.
|
|
47
|
+
|
|
48
|
+
Propose a reasonable selection, explain notable inclusions and exclusions in
|
|
49
|
+
the existing grouped review, and confirm large or uncertain choices with the
|
|
50
|
+
user. Reuse earlier answers. Do not clear the import merely to minimize bytes.
|
|
51
|
+
|
|
52
|
+
Do not modify the user's installed skills or remove required support files
|
|
53
|
+
to reduce upload size. Review whole-folder selections with the user before
|
|
54
|
+
narrowing the import.
|
|
55
|
+
|
|
22
56
|
Present to the user as a grouped list (per agent: MCP servers, skills,
|
|
23
57
|
settings, memory) and confirm anything credential-bearing. Mention skipped
|
|
24
58
|
Claude hooks during review: their commands may need scripts or tools that are
|
|
@@ -17,6 +17,11 @@ Ground rules:
|
|
|
17
17
|
- Keep discovery focused. Start with tracked manifests and project docs, prune
|
|
18
18
|
dependency/build/vendor/generated directories, and do not open minified or
|
|
19
19
|
unusually large assets just because a recursive search found them.
|
|
20
|
+
- Choose imports for their usefulness to this project and the user's
|
|
21
|
+
development workflow, considering their size. Explain large imports during
|
|
22
|
+
review. Reuse the user's answers and group routine choices
|
|
23
|
+
with your recommendations in one review instead of asking one question per
|
|
24
|
+
empty section.
|
|
20
25
|
- You never need to keep these guides in context: re-print any of them with
|
|
21
26
|
`dvb agent-init guide <topic>`, and re-orient anytime with
|
|
22
27
|
`dvb agent-init status` (it always names the exact next action).
|
|
@@ -201,6 +206,28 @@ ask the user which one they want, record that key, and remove its marker. The
|
|
|
201
206
|
choice applies to the Template box and all of the project's devboxes and
|
|
202
207
|
cannot be changed after initialization.
|
|
203
208
|
|
|
209
|
+
Recommend the smallest available size that fits the actual workload. Normally
|
|
210
|
+
size for one coding agent and one running instance of the app, plus its
|
|
211
|
+
required services. Separate devboxes do not share one box's CPU or memory;
|
|
212
|
+
do not add their requirements together. The agent's model runs through its
|
|
213
|
+
connected account, so a larger model does not by itself require a larger box.
|
|
214
|
+
|
|
215
|
+
For a marketing site or a modest app, start the recommendation at 4 vCPU /
|
|
216
|
+
8 GB when available. Recommend more memory for evidence such as a required
|
|
217
|
+
local database, browser workload, or build that exceeds that capacity; choose
|
|
218
|
+
more CPUs for work that can use them. Use project docs, relevant local
|
|
219
|
+
measurements, or known service requirements. The user's laptop size, the
|
|
220
|
+
number of repositories, and vague future headroom are not reasons to recommend
|
|
221
|
+
the largest option. Explain uncertainty rather than treating it as a need for
|
|
222
|
+
maximum resources, and explain a team's larger default before recommending it.
|
|
223
|
+
|
|
224
|
+
Read `dvb agent-docs billing-and-limits` for the current box-hour multipliers.
|
|
225
|
+
Show the relative usage cost alongside the size options and explain the
|
|
226
|
+
recommendation in the same review. Larger sizes will consume included
|
|
227
|
+
box-hours and prepaid credits faster for every awake hour, even when the
|
|
228
|
+
extra resources are idle; the choice also applies to future devboxes. Do not
|
|
229
|
+
promise an in-place resize later.
|
|
230
|
+
|
|
204
231
|
If your harness supports parallel subagents, fan out one investigator per
|
|
205
232
|
section (each should read its section guide first). Otherwise investigate
|
|
206
233
|
serially — the order above works well.
|
|
@@ -217,6 +244,15 @@ databases will be dumped, how the app runs, what is excluded. Concise tables
|
|
|
217
244
|
work well. The user can reply in chat or edit the manifest file directly —
|
|
218
245
|
mention its path so they can open it.
|
|
219
246
|
|
|
247
|
+
Include the estimated upload size and the largest selected categories, noting
|
|
248
|
+
any sizes you have not measured. Follow `guide agent-config` to assess skills
|
|
249
|
+
and their linked contents for usefulness and size, then recommend a selection.
|
|
250
|
+
Explain large imports and confirm uncertain choices with the user. A multi-GB
|
|
251
|
+
upload for a small site deserves investigation before launch, even below the
|
|
252
|
+
bundle limit; useful workflow tools may still justify it. Keep local
|
|
253
|
+
configuration, assets, and unfinished work according to the user's choices;
|
|
254
|
+
do not delete local files to reduce the upload.
|
|
255
|
+
|
|
220
256
|
For a worktree, call out missing expected configuration and any files or symlink
|
|
221
257
|
targets outside it. If a needed file exists in the main checkout, offer to use
|
|
222
258
|
that file through an explicit `from:` entry, obtain the configuration another
|
|
@@ -97,6 +97,12 @@ validate that key against the current server catalog. Once remote setup starts,
|
|
|
97
97
|
the project is pinned to it; changing the manifest cannot resize an in-progress
|
|
98
98
|
or initialized project.
|
|
99
99
|
|
|
100
|
+
Follow the workload and cost guidance in `guide flow` before recommending a
|
|
101
|
+
size. The seeded team default is a starting value, not evidence that this app
|
|
102
|
+
needs it. Explain the smallest suitable option, the reason for any larger
|
|
103
|
+
recommendation, and its box-hour multiplier from
|
|
104
|
+
`dvb agent-docs billing-and-limits` before recording the user's choice.
|
|
105
|
+
|
|
100
106
|
`githubAccess` is one project-level Git transport choice. Keep `managed` for the
|
|
101
107
|
recommended connected-GitHub HTTPS path, choose `ssh` for the existing key
|
|
102
108
|
flow, choose `skip` for intentionally absent GitHub push/pull, or use null only
|
|
@@ -33,6 +33,28 @@ completed — `destroy --yes` and re-run is the honest repair.
|
|
|
33
33
|
`dvb agent-init diagnostics` prints a redacted state dump (local + remote)
|
|
34
34
|
for debugging when something looks wrong.
|
|
35
35
|
|
|
36
|
+
## Restart with a smaller import or box size
|
|
37
|
+
|
|
38
|
+
Inspect `status --json` first. If setup is already complete, keep the project
|
|
39
|
+
and explain that changing its box size requires recreating the project;
|
|
40
|
+
do not apply the incomplete-setup reset to it.
|
|
41
|
+
|
|
42
|
+
For an incomplete setup, stop and await only its existing local
|
|
43
|
+
`dvb agent-init run` process before resetting, so it cannot keep driving the
|
|
44
|
+
same setup during the reset. Preserve the manifest and local project files. Explain
|
|
45
|
+
that `dvb agent-init destroy --yes` will remove the incomplete Template box and
|
|
46
|
+
setup progress, and use it only with the user's approval. An explicit request
|
|
47
|
+
to reset that incomplete setup supplies approval; do not ask again.
|
|
48
|
+
|
|
49
|
+
Reuse the saved manifest and earlier answers. Review global skills using
|
|
50
|
+
`guide agent-config`, retain the files needed to run the app and preserve
|
|
51
|
+
approved local work, and choose the smallest suitable box using `guide flow`.
|
|
52
|
+
Once an upload has started, a fresh `check` can be blocked by the frozen Git
|
|
53
|
+
access choice, even when only import selections changed. Use the supported
|
|
54
|
+
reset rather than deleting state files or editing them by hand. After reset,
|
|
55
|
+
edit the retained manifest, run `dvb agent-init check`, show the revised size
|
|
56
|
+
and cost summary, and obtain launch approval before `dvb agent-init run`.
|
|
57
|
+
|
|
36
58
|
## Reporting a boxes.dev bug
|
|
37
59
|
|
|
38
60
|
Report a bug with `dvb report-bug --stdin` when a `dvb agent-init` command
|
|
@@ -10,6 +10,15 @@ user-facing language — and records the manifest's content hash.
|
|
|
10
10
|
Errors are structured (`ERROR at <location>: <message> / Fix: ...`) —
|
|
11
11
|
address each and re-run. `--json` gives the machine form.
|
|
12
12
|
|
|
13
|
+
Alongside the launch summary, explain the recommended box size and its
|
|
14
|
+
box-hour multiplier, plus the estimated upload size and largest included
|
|
15
|
+
categories. Use measured sizes where available and label estimates; `check`
|
|
16
|
+
does not prepare the full bundle or establish its final compressed size.
|
|
17
|
+
Explain substantial size surprises and the useful contents behind them, then
|
|
18
|
+
review alternatives with the user. A large import can be reasonable when it
|
|
19
|
+
supports the app or the user's workflow; neither minimizing bytes nor staying
|
|
20
|
+
under the 15GB limit establishes that the selection is appropriate.
|
|
21
|
+
|
|
13
22
|
## User approval (required)
|
|
14
23
|
|
|
15
24
|
Relay the launch summary to the user verbatim or lightly formatted, and get
|
|
@@ -60,5 +69,8 @@ If the command is interrupted, nothing is lost: `dvb agent-init status`
|
|
|
60
69
|
shows where things stand and `dvb agent-init watch` re-attaches (see
|
|
61
70
|
`guide recovery`).
|
|
62
71
|
|
|
72
|
+
Use `run` to resume an unfinished upload; `watch` only follows remote setup
|
|
73
|
+
after the upload has committed and will not upload the missing data.
|
|
74
|
+
|
|
63
75
|
If `run` fails and `dvb agent-init retry` doesn't fix it, report the failure
|
|
64
76
|
with `dvb report-bug --stdin` (see `guide recovery`).
|