@boxes-dev/dvb-runtime 1.0.1097 → 1.0.1099
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/flow.md +31 -4
- package/dist/agent-init-guides/git-ssh.md +2 -2
- package/dist/agent-init-guides/manifest.md +10 -2
- package/dist/agent-init-guides/running.md +8 -3
- package/dist/agent-init-guides/untracked.md +29 -4
- package/dist/bin/dvb.mjs +108 -27
- package/dist/bin/dvbd.mjs +10 -9
- package/dist/product-docs/references/agent-tools.md +6 -7
- package/dist/product-docs/references/automations.md +4 -4
- package/dist/product-docs/references/aws.md +17 -11
- package/dist/product-docs/references/billing-and-limits.md +23 -11
- package/dist/product-docs/references/cli.md +14 -15
- package/dist/product-docs/references/core-concepts.md +35 -30
- package/dist/product-docs/references/desktop-workbench.md +26 -25
- package/dist/product-docs/references/files-git-and-review.md +20 -17
- package/dist/product-docs/references/fork-workflows.md +44 -31
- package/dist/product-docs/references/getting-started.md +7 -8
- package/dist/product-docs/references/glossary.md +46 -22
- package/dist/product-docs/references/google-cloud.md +13 -8
- package/dist/product-docs/references/index.md +18 -16
- package/dist/product-docs/references/linear.md +2 -2
- package/dist/product-docs/references/managed-environment-files.md +1 -1
- package/dist/product-docs/references/member-managed-files.md +4 -4
- package/dist/product-docs/references/mobile.md +23 -18
- package/dist/product-docs/references/onbox-agent-tools.md +25 -26
- package/dist/product-docs/references/ports-terminal-and-runtime.md +27 -28
- package/dist/product-docs/references/project-setup.md +36 -16
- package/dist/product-docs/references/security-and-data.md +10 -10
- package/dist/product-docs/references/slack.md +3 -3
- package/dist/product-docs/references/tailscale.md +2 -2
- package/dist/product-docs/references/team-template.md +22 -22
- package/dist/product-docs/references/template-box-environment.md +7 -3
- package/dist/product-docs/references/threads-and-agents.md +79 -31
- package/dist/product-docs/references/troubleshooting.md +24 -25
- package/package.json +2 -2
|
@@ -144,6 +144,32 @@ Use `github cli enable` or `github cli disable` only after the user chooses
|
|
|
144
144
|
to change it. This changes their existing account setting across projects;
|
|
145
145
|
it is separate from repository pull/push access and is not a manifest field.
|
|
146
146
|
|
|
147
|
+
Ask which branch new devboxes should start on; Template setup will run on that
|
|
148
|
+
same branch. Recommend each repository's actual remote default (often `main`
|
|
149
|
+
or `master`), even when the local checkout is already there. For multiple
|
|
150
|
+
repositories, record one choice per path. Use that choice in the generated
|
|
151
|
+
`devboxLifecycle.startupScript` Git block and any Template maintenance script.
|
|
152
|
+
|
|
153
|
+
As part of the existing dirty/untracked-file review in `guide untracked`, compare
|
|
154
|
+
the local checkout with the selected branch and ask which unfinished work to
|
|
155
|
+
save on boxes.dev for later. Reuse answers already given; do not add a second file
|
|
156
|
+
review. Included work will be saved separately on the Template box before setup
|
|
157
|
+
runs on the selected branch. It will not become the active starting state of
|
|
158
|
+
Template setup or new devboxes, even when the edits are already on that branch.
|
|
159
|
+
Leave the local checkout, index, and files alone.
|
|
160
|
+
|
|
161
|
+
Record the selected branch, current branch/commit, work-copy choices, and
|
|
162
|
+
preservation instructions per repository in `setupNotes`. Distinguish
|
|
163
|
+
unfinished work from env/config/fixtures needed for setup. For example: start
|
|
164
|
+
on `main`, retain the imported `feature-123` branch, save its dirty files in a
|
|
165
|
+
named stash on the Template box, and keep the approved `.env.local` available
|
|
166
|
+
for setup. Saving this work in the Template snapshot does not involve a Git push.
|
|
167
|
+
When the selected branch has no remote counterpart, explain that fetching it
|
|
168
|
+
for new devboxes is unavailable. Ask whether to choose an available remote
|
|
169
|
+
branch or use a clean local branch from the Template snapshot for both setup
|
|
170
|
+
and new devboxes; omit the generated remote Git block only for that latter
|
|
171
|
+
choice. Do not invent a remote branch or publish one.
|
|
172
|
+
|
|
147
173
|
Review `devboxLifecycle` even when its seeded Git refresh is correct. Add a
|
|
148
174
|
teardown script only for cleanup that must happen before a devbox is removed.
|
|
149
175
|
The generated Git block declares each selected repository's starting branch,
|
|
@@ -157,7 +183,7 @@ block; do not add another Git reset or branch switch there.
|
|
|
157
183
|
Recommend Template maintenance when the project has dependencies, generated
|
|
158
184
|
code, or tooling that change over time; most projects do. New devboxes start
|
|
159
185
|
from the Template box's latest snapshot. Maintenance keeps that snapshot
|
|
160
|
-
current: it updates the Template box
|
|
186
|
+
current: it updates the Template box on the selected starting branch, installs
|
|
161
187
|
locked dependencies, and refreshes tooling, then boxes.dev saves a new snapshot.
|
|
162
188
|
Design `templateMaintenance.script` and its exact GitHub watch paths together.
|
|
163
189
|
Watch the lockfiles, toolchain version files, and generated-code inputs that
|
|
@@ -199,9 +225,10 @@ destination paths and get the user's choice before selecting outside files.
|
|
|
199
225
|
Record unresolved requirements in `setupNotes` for remote setup and validation.
|
|
200
226
|
|
|
201
227
|
Do not silently choose approval-sensitive options. Before `check`, explicitly
|
|
202
|
-
confirm the repositories in a multi-repository project,
|
|
203
|
-
|
|
204
|
-
|
|
228
|
+
confirm the repositories in a multi-repository project, the shared starting
|
|
229
|
+
branch for Template setup and new devboxes, runtime agents and imported agent
|
|
230
|
+
config/history, local-work preservation and dirty/untracked-file selections,
|
|
231
|
+
databases, instance type, GitHub access, Git SSH/signing, devbox lifecycle or Template
|
|
205
232
|
maintenance configuration (including watch paths), and any instruction that
|
|
206
233
|
lets the remote setup agent change tracked project files. It is fine to
|
|
207
234
|
recommend defaults, but the user must make the choice.
|
|
@@ -41,14 +41,14 @@ Run `dvb agent-init github connect` to grant any missing GitHub App access, then
|
|
|
41
41
|
dependency before setup. If remote setup is already blocked, grant any missing
|
|
42
42
|
GitHub access, continue that setup thread, and retry the package fetch. Keep the
|
|
43
43
|
dependency URLs and checkout layout unchanged. Dependencies can be read-only or
|
|
44
|
-
archived; project checkouts still need write access during setup. In an
|
|
44
|
+
archived; project checkouts still need write access during setup. In an independent
|
|
45
45
|
project, Git can access any repository that the connected credential can read;
|
|
46
46
|
GitHub enforces write permission when pushing. The dependency list does not
|
|
47
47
|
grant or restrict access.
|
|
48
48
|
|
|
49
49
|
Omit `githubDependencies` or use an empty list to skip dependency preflight.
|
|
50
50
|
Manage repository access through GitHub. This flow applies to
|
|
51
|
-
|
|
51
|
+
independent projects with managed GitHub HTTPS access, not managed
|
|
52
52
|
projects. If Cargo's built-in Git client cannot use the configured authentication,
|
|
53
53
|
set `CARGO_NET_GIT_FETCH_WITH_CLI=true` during remote setup to make Cargo use Git
|
|
54
54
|
for fetching. See [Cargo's Git authentication guide](https://doc.rust-lang.org/cargo/appendix/git-authentication.html).
|
|
@@ -118,7 +118,8 @@ watches always require current boxes.dev GitHub App read access, even when
|
|
|
118
118
|
|
|
119
119
|
A maintenance script must:
|
|
120
120
|
|
|
121
|
-
- Fetch and fast-forward each repository
|
|
121
|
+
- Fetch and fast-forward each repository on the branch selected for Template
|
|
122
|
+
setup and new devboxes,
|
|
122
123
|
then install locked dependencies and refresh generated files or tooling
|
|
123
124
|
without prompts.
|
|
124
125
|
- Exit nonzero with a clear message when a checkout has uncommitted changes or
|
|
@@ -164,7 +165,14 @@ Use a nonempty teardown script only when devbox removal genuinely needs cleanup;
|
|
|
164
165
|
it is not a second maintenance hook.
|
|
165
166
|
|
|
166
167
|
`setupNotes` is worth writing well: it goes verbatim to the agent that
|
|
167
|
-
finishes setup on the Template box.
|
|
168
|
+
finishes setup on the Template box. For each repository, record the shared
|
|
169
|
+
starting branch for Template setup and new devboxes, the imported branch/commit,
|
|
170
|
+
and which local work to preserve separately in a named stash. Identify approved
|
|
171
|
+
env/config/fixtures that must remain available for setup. The remote agent will
|
|
172
|
+
save the imported work and prepare the selected branch before installing
|
|
173
|
+
dependencies; the local checkout must stay intact. See `guide untracked` for
|
|
174
|
+
the combined branch and local-file review.
|
|
175
|
+
Include install steps that aren't obvious
|
|
168
176
|
from the repo, known gotchas, and a verification command ("`npm run dev`
|
|
169
177
|
should serve on :5173"). By default the remote agent preserves tracked project
|
|
170
178
|
files: if a build or test exposes a code, dependency-manifest, lockfile, or
|
|
@@ -33,9 +33,14 @@ Progress streams as timestamped lines — relay the meaningful ones
|
|
|
33
33
|
(phase changes, the completion message). A full run typically takes several
|
|
34
34
|
minutes; remote setup is the long part.
|
|
35
35
|
|
|
36
|
-
The remote setup agent
|
|
37
|
-
|
|
38
|
-
|
|
36
|
+
The remote setup agent first saves approved imported work separately, then
|
|
37
|
+
prepares the same starting branch as new devboxes, as recorded in `setupNotes`.
|
|
38
|
+
It will reuse the reviewed choices and ask only about a missing choice or work
|
|
39
|
+
it cannot safely preserve. The handoff will name the saved branch/commit and
|
|
40
|
+
stash, with instructions for resuming that work in a devbox. It then installs
|
|
41
|
+
tools and dependencies, places approved config, and verifies the app. Beyond
|
|
42
|
+
the approved branch checkout, it preserves tracked project files unless `setupNotes`
|
|
43
|
+
contains exact, user-approved edits. A project build/test failure is an
|
|
39
44
|
honest setup result, not permission to rewrite dependencies, source, or tests.
|
|
40
45
|
|
|
41
46
|
Guards to expect:
|
|
@@ -1,12 +1,36 @@
|
|
|
1
1
|
# Untracked files and local changes (`untracked`, `localChanges`)
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
Review local work together with the starting branch chosen in `guide flow`.
|
|
4
|
+
Inspect the current branch/commit, local-only commits, staged and unstaged
|
|
5
|
+
changes, and the untracked-file list. If the checkout differs from the selected
|
|
6
|
+
branch, ask whether to save that work on boxes.dev for later. This includes a
|
|
7
|
+
clean feature branch, detached HEAD, and edits or local-only commits on the
|
|
8
|
+
selected branch itself. Reuse the user's existing answers and file selections.
|
|
9
|
+
|
|
10
|
+
Explain that Template setup and new devboxes will start on the selected branch.
|
|
11
|
+
Approved work will be preserved on the Template box at its original commit, with
|
|
12
|
+
a named Git stash for staged, unstaged, and selected untracked work. The remote
|
|
13
|
+
agent will provide restore instructions. Saving it in the Template snapshot
|
|
14
|
+
does not involve pushing to a Git remote or applying it onto the setup branch.
|
|
15
|
+
Keep environment/configuration files and fixtures needed for
|
|
16
|
+
setup selected separately, so they remain available in the active checkout.
|
|
17
|
+
Do not stash, switch, or clean the user's local checkout.
|
|
18
|
+
|
|
19
|
+
The repository upload includes Git history and local branch refs, including
|
|
20
|
+
local-only commits. The choices below control uncommitted files, not which
|
|
21
|
+
commits are uploaded. Explain this during review when local-only work exists;
|
|
22
|
+
do not promise to exclude those commits. If the user requires that exclusion,
|
|
23
|
+
resolve the upload scope before launch; these toggles cannot provide it.
|
|
24
|
+
|
|
25
|
+
Use the existing two controls to record the reviewed file choices:
|
|
5
26
|
|
|
6
27
|
## `localChanges.copyDirty`
|
|
7
28
|
|
|
8
29
|
Whether staged and unstaged edits to tracked files will be copied. The default
|
|
9
30
|
is true. Set false if the user wants the committed versions of those files.
|
|
31
|
+
This does not select a branch or remove local-only commits. Setting it to false
|
|
32
|
+
does not exclude untracked work; review `untracked.copy` and its rules together
|
|
33
|
+
with this choice. Record the result in `setupNotes` as described in `guide flow`.
|
|
10
34
|
|
|
11
35
|
## `untracked`
|
|
12
36
|
|
|
@@ -51,5 +75,6 @@ big folders you propose excluding or force-including. This is a
|
|
|
51
75
|
collaboration point — the user may want to edit the globs in the manifest
|
|
52
76
|
directly.
|
|
53
77
|
|
|
54
|
-
Done means: the user has seen the numbers
|
|
55
|
-
|
|
78
|
+
Done means: the user has seen the numbers, the toggles and rules reflect their
|
|
79
|
+
choices, and `setupNotes` tells the remote agent which work to save separately
|
|
80
|
+
and which approved files to keep available for setup.
|
package/dist/bin/dvb.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="
|
|
3
|
+
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="56dec66e-dfc5-5fd7-ab6c-6ec0b589ff12")}catch(e){}}();
|
|
4
4
|
import { createRequire as __dvbCreateRequire } from "node:module";
|
|
5
5
|
import { dirname as __dvbDirname } from "node:path";
|
|
6
6
|
import { fileURLToPath as __dvbFileURLToPath } from "node:url";
|
|
@@ -70396,9 +70396,9 @@ var init_sentry = __esm({
|
|
|
70396
70396
|
uncaughtExceptionMonitorInstalled = false;
|
|
70397
70397
|
currentDevboxSentryUser = null;
|
|
70398
70398
|
readBuildMetadata = () => {
|
|
70399
|
-
const rawPackageVersion = "1.0.
|
|
70400
|
-
const rawGitSha = "
|
|
70401
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
70399
|
+
const rawPackageVersion = "1.0.1099";
|
|
70400
|
+
const rawGitSha = "5f95fd277d454c1af877aac60a1e8b6cb84e7655";
|
|
70401
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1099+5f95fd277d454c1af877aac60a1e8b6cb84e7655";
|
|
70402
70402
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
70403
70403
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
70404
70404
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -74898,12 +74898,13 @@ var init_desktopInitContracts = __esm({
|
|
|
74898
74898
|
});
|
|
74899
74899
|
|
|
74900
74900
|
// ../../../../shared/devboxCore/dist/desktopObjectTransfers.js
|
|
74901
|
-
var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
|
|
74901
|
+
var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
|
|
74902
74902
|
var init_desktopObjectTransfers = __esm({
|
|
74903
74903
|
"../../../../shared/devboxCore/dist/desktopObjectTransfers.js"() {
|
|
74904
74904
|
"use strict";
|
|
74905
|
-
DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES =
|
|
74906
|
-
DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES =
|
|
74905
|
+
DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES = 5 * 1024 * 1024 * 1024;
|
|
74906
|
+
DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES = 10 * 1024 * 1024 * 1024;
|
|
74907
|
+
DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS = 5 * 60 * 1e3;
|
|
74907
74908
|
DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES = 100 * 1024 * 1024;
|
|
74908
74909
|
DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES = 64 * 1024 * 1024;
|
|
74909
74910
|
DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS = 15 * 60;
|
|
@@ -75048,7 +75049,7 @@ so future devboxes will inherit those changes.
|
|
|
75048
75049
|
});
|
|
75049
75050
|
|
|
75050
75051
|
// ../../../../shared/devboxCore/dist/remoteSetupPrompt.js
|
|
75051
|
-
var REMOTE_SETUP_APPLY_E2B_TEMPLATE, renderTemplate, LEGACY_AGENT_SETUP_BLOCK, ORDINARY_AGENT_SETUP_BLOCK, joinPosixPath, buildRemoteSetupEntrypointsBlock, buildRemoteSetupCompletionBlock, buildRemoteSetupGitConfigReviewBlock, buildRemoteSetupDatabaseRestoreBlock, quotePosixShellArgument, buildTemplateMaintenanceValidationCommand, buildRemoteSetupTemplateMaintenanceBlock, getSurfacePromptValues, renderRemoteSetupApplyPrompt;
|
|
75052
|
+
var REMOTE_SETUP_APPLY_E2B_TEMPLATE, renderTemplate, LEGACY_AGENT_SETUP_BLOCK, ORDINARY_AGENT_SETUP_BLOCK, REPOSITORY_SETUP_BLOCK, joinPosixPath, buildRemoteSetupEntrypointsBlock, buildRemoteSetupCompletionBlock, buildRemoteSetupGitConfigReviewBlock, buildRemoteSetupDatabaseRestoreBlock, quotePosixShellArgument, buildTemplateMaintenanceValidationCommand, buildRemoteSetupTemplateMaintenanceBlock, getSurfacePromptValues, renderRemoteSetupApplyPrompt;
|
|
75052
75053
|
var init_remoteSetupPrompt = __esm({
|
|
75053
75054
|
"../../../../shared/devboxCore/dist/remoteSetupPrompt.js"() {
|
|
75054
75055
|
"use strict";
|
|
@@ -75195,6 +75196,7 @@ Then apply the setup plan in \`{{setup_path}}\`:
|
|
|
75195
75196
|
- Read the whole setup plan before changing the machine. If it has a non-empty
|
|
75196
75197
|
\`agentInstructions\` field, treat that as user-provided setup guidance and
|
|
75197
75198
|
follow it unless it conflicts with these safety instructions.
|
|
75199
|
+
{{repository_setup_block}}
|
|
75198
75200
|
- Install required tools/runtimes that are listed.
|
|
75199
75201
|
- Prefer project-local installs (e.g., package manager installs in the project or the relevant indexed repo) over global installs.
|
|
75200
75202
|
- Run setup commands in the project root unless the plan specifies another path. If a command targets a child repo, run it from that repo's relative path.
|
|
@@ -75263,6 +75265,50 @@ assistant response in this thread. Do not put this user-facing response in
|
|
|
75263
75265
|
- This is a regular Codex or Claude Code thread using the user's connected account.
|
|
75264
75266
|
- Configure Codex MCP servers in the normal Codex home at \`/home/boxes/.codex\` and Claude MCP servers in Claude's normal user configuration.
|
|
75265
75267
|
- Newly configured MCP tools may require a fresh or restarted agent process.`;
|
|
75268
|
+
REPOSITORY_SETUP_BLOCK = `- Before installing dependencies or running project commands, read the branch
|
|
75269
|
+
and local-work choices in \`agentInstructions\` and inspect each imported
|
|
75270
|
+
repository. One selected starting branch governs both Template setup and new
|
|
75271
|
+
devboxes. Saving imported work is a separate choice; it must not change that
|
|
75272
|
+
starting branch or leave unfinished work active during setup.
|
|
75273
|
+
- Reuse choices already recorded in the plan or thread, including the reviewed
|
|
75274
|
+
dirty/untracked-file selections. Ask only for missing decisions: which
|
|
75275
|
+
starting branch to use, recommending the actual remote default (often
|
|
75276
|
+
\`main\` or \`master\`), and which imported work to save separately. Differences
|
|
75277
|
+
include another branch, detached HEAD, local-only commits, and staged,
|
|
75278
|
+
unstaged, or untracked changes, even on the selected branch itself.
|
|
75279
|
+
Choosing the imported feature branch still requires saving its unfinished
|
|
75280
|
+
files separately. Do not offer to leave unstashed work active during setup.
|
|
75281
|
+
- Before switching branches, preserve approved imported work on this Template
|
|
75282
|
+
box for inclusion in its snapshot. This is what saving work on boxes.dev
|
|
75283
|
+
means; do not push it to a Git remote or ask for publication as part of setup.
|
|
75284
|
+
Keep its original commit reachable through a branch; create a clearly
|
|
75285
|
+
named saved-work branch if HEAD is detached or the selected branch name must
|
|
75286
|
+
move away from local commits. Save staged, unstaged, and selected untracked
|
|
75287
|
+
work in a clearly named Git stash, preserving the index. Keep approved
|
|
75288
|
+
environment/configuration files, fixtures, and setup artifacts available for
|
|
75289
|
+
setup; do not sweep them into the stash with unfinished work. Record the
|
|
75290
|
+
original commit, saved branch, and stash commit for the handoff. Do not create
|
|
75291
|
+
an empty stash when there are no unfinished files.
|
|
75292
|
+
- Then prepare the selected starting branch. For a remote branch, fetch it and
|
|
75293
|
+
verify that the checkout is on that branch at the fetched commit, with the
|
|
75294
|
+
imported work saved separately. For an explicitly approved local-only branch,
|
|
75295
|
+
use its clean committed state and the matching snapshot-based new-devbox
|
|
75296
|
+
choice; do not invent or publish a remote branch. Keep maintenance on the
|
|
75297
|
+
same selected branch. Branch preparation is part of setup, not permission to
|
|
75298
|
+
edit source or dependencies to make tests pass.
|
|
75299
|
+
- Do not discard unpreserved changes or commits, apply saved work onto the
|
|
75300
|
+
setup branch, or modify the source computer's checkout. If preservation or
|
|
75301
|
+
checkout cannot follow the reviewed plan, explain the specific conflict and
|
|
75302
|
+
ask about it. Saving included work as approved does not need another review.
|
|
75303
|
+
- Checking out the branch here does not configure new-devbox defaults. Verify
|
|
75304
|
+
both against the reviewed plan. If a choice is missing or changes remotely,
|
|
75305
|
+
reconcile the saved default through the documented setup controls before
|
|
75306
|
+
completing setup; if unavailable, report the required change and wait.
|
|
75307
|
+
- Report the shared starting branch and any saved work in the setup summary.
|
|
75308
|
+
Give the saved branch/original commit and stash commit, with instructions to
|
|
75309
|
+
resume in a devbox from that original commit and apply the stash with
|
|
75310
|
+
\`git stash apply --index\`. Leave the Template checkout on the selected
|
|
75311
|
+
branch; never restore the saved work there just to demonstrate recovery.`;
|
|
75266
75312
|
joinPosixPath = (base, relative2) => `${base.replace(/\/+$/u, "")}/${relative2.replace(/^\/+/u, "")}`;
|
|
75267
75313
|
buildRemoteSetupEntrypointsBlock = (entrypoints) => {
|
|
75268
75314
|
if (entrypoints.length === 0)
|
|
@@ -75447,6 +75493,7 @@ below.`;
|
|
|
75447
75493
|
final_response_block: renderSetupFinalResponsePrompt("automatic"),
|
|
75448
75494
|
git_config_review_block: buildRemoteSetupGitConfigReviewBlock(gitConfigReviewPath),
|
|
75449
75495
|
agent_setup_block: agentRuntime === "ordinary" ? ORDINARY_AGENT_SETUP_BLOCK : LEGACY_AGENT_SETUP_BLOCK,
|
|
75496
|
+
repository_setup_block: agentRuntime === "ordinary" ? REPOSITORY_SETUP_BLOCK : "",
|
|
75450
75497
|
interaction_guidance: agentRuntime === "ordinary" ? "- Ask the user in this thread when setup needs their input." : "- This run is non-interactive; do not rely on Ctrl-C.",
|
|
75451
75498
|
setup_completion_block: buildRemoteSetupCompletionBlock(completionMode, setupTodoPath),
|
|
75452
75499
|
database_restore_block: buildRemoteSetupDatabaseRestoreBlock({
|
|
@@ -75907,7 +75954,7 @@ var init_packageVersion = __esm({
|
|
|
75907
75954
|
return path18.join(process.cwd(), "dvb");
|
|
75908
75955
|
};
|
|
75909
75956
|
readEmbeddedPackageVersion = () => {
|
|
75910
|
-
const raw = "1.0.
|
|
75957
|
+
const raw = "1.0.1099";
|
|
75911
75958
|
return trimVersion(raw);
|
|
75912
75959
|
};
|
|
75913
75960
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -139785,7 +139832,7 @@ var init_checkpoint = __esm({
|
|
|
139785
139832
|
}) => {
|
|
139786
139833
|
const trimmedTarget = target.trim();
|
|
139787
139834
|
if (!trimmedTarget) {
|
|
139788
|
-
throw new Error("
|
|
139835
|
+
throw new Error("Template box name is required.");
|
|
139789
139836
|
}
|
|
139790
139837
|
return instances2.find((entry) => entry.alias === trimmedTarget) ?? instances2.find((entry) => entry.providerInstanceId === trimmedTarget) ?? null;
|
|
139791
139838
|
};
|
|
@@ -139821,18 +139868,18 @@ var init_checkpoint = __esm({
|
|
|
139821
139868
|
const { controlPlaneToken } = await resolveE2bCommandContext({
|
|
139822
139869
|
stage: (message) => status.stage(message)
|
|
139823
139870
|
});
|
|
139824
|
-
status.stage("
|
|
139871
|
+
status.stage("Finding Template box");
|
|
139825
139872
|
const instances2 = await listViewerInstances(controlPlaneToken);
|
|
139826
139873
|
const resolved = resolveTargetInstance({ instances: instances2, target });
|
|
139827
139874
|
if (!resolved) {
|
|
139828
|
-
throw new Error(`Unknown
|
|
139875
|
+
throw new Error(`Unknown box: ${target}`);
|
|
139829
139876
|
}
|
|
139830
139877
|
if (resolved.provider !== "e2b") {
|
|
139831
139878
|
throw new Error(
|
|
139832
|
-
"`dvb checkpoint`
|
|
139879
|
+
"Use `dvb checkpoint` with your project's Template box to take a snapshot."
|
|
139833
139880
|
);
|
|
139834
139881
|
}
|
|
139835
|
-
status.stage(`
|
|
139882
|
+
status.stage(`Taking snapshot of ${resolved.alias}`);
|
|
139836
139883
|
const result = await createManagedCheckpoint(
|
|
139837
139884
|
controlPlaneToken,
|
|
139838
139885
|
resolved.alias
|
|
@@ -139840,7 +139887,7 @@ var init_checkpoint = __esm({
|
|
|
139840
139887
|
const record3 = result[0];
|
|
139841
139888
|
const checkpointId = record3 ? extractCheckpointId(record3) : null;
|
|
139842
139889
|
if (!record3 || !checkpointId) {
|
|
139843
|
-
throw new Error("
|
|
139890
|
+
throw new Error("The snapshot response did not include an ID.");
|
|
139844
139891
|
}
|
|
139845
139892
|
status.stop();
|
|
139846
139893
|
if (parsed.json) {
|
|
@@ -139859,7 +139906,7 @@ var init_checkpoint = __esm({
|
|
|
139859
139906
|
);
|
|
139860
139907
|
return;
|
|
139861
139908
|
}
|
|
139862
|
-
console.log(`
|
|
139909
|
+
console.log(`Snapshot created: ${resolved.alias} (${checkpointId})`);
|
|
139863
139910
|
};
|
|
139864
139911
|
try {
|
|
139865
139912
|
await run2();
|
|
@@ -141851,6 +141898,7 @@ var init_threadInventoryBuilder = __esm({
|
|
|
141851
141898
|
forkOperationId: null,
|
|
141852
141899
|
isFork: false,
|
|
141853
141900
|
forkState: null,
|
|
141901
|
+
forkPlacementArchived: false,
|
|
141854
141902
|
forkProgressStage: null,
|
|
141855
141903
|
forkExecutionStatusTone: null,
|
|
141856
141904
|
forkBaseCommitSha: null,
|
|
@@ -141879,6 +141927,7 @@ var init_threadInventoryBuilder = __esm({
|
|
|
141879
141927
|
cwd: null,
|
|
141880
141928
|
path: normalizeText2(thread.sessionPath),
|
|
141881
141929
|
isArchived: thread.archivedAt !== null,
|
|
141930
|
+
archivedDevbox: thread.archivedDevbox ?? null,
|
|
141882
141931
|
notificationsMuted: thread.notificationsMuted,
|
|
141883
141932
|
storageState: resolveThreadStorageState(thread.storageState),
|
|
141884
141933
|
nativeBundleStatus: resolveThreadNativeBundleStatus(
|
|
@@ -141981,6 +142030,7 @@ var init_threadInventoryBuilder = __esm({
|
|
|
141981
142030
|
row.forkOperationId = placement.operationId;
|
|
141982
142031
|
row.isFork = true;
|
|
141983
142032
|
row.forkState = placement.state;
|
|
142033
|
+
row.forkPlacementArchived = placement.archivedAt !== null;
|
|
141984
142034
|
row.forkProgressStage = placement.progressStage;
|
|
141985
142035
|
row.forkMode = placement.mode;
|
|
141986
142036
|
row.forkBaseCommitSha = normalizeText2(placement.forkBaseCommitSha);
|
|
@@ -142306,7 +142356,8 @@ var init_forkThreadGroups = __esm({
|
|
|
142306
142356
|
resolveMinimumGroupSize = (anchorRow) => anchorRow.devboxName === null ? 2 : 1;
|
|
142307
142357
|
buildForkThreadGroupMap = ({
|
|
142308
142358
|
rows,
|
|
142309
|
-
resolveTitle
|
|
142359
|
+
resolveTitle,
|
|
142360
|
+
archiveLayout = null
|
|
142310
142361
|
}) => {
|
|
142311
142362
|
const childrenByPlacementId = /* @__PURE__ */ new Map();
|
|
142312
142363
|
for (const row of rows) {
|
|
@@ -142325,9 +142376,10 @@ var init_forkThreadGroups = __esm({
|
|
|
142325
142376
|
if (!anchorRow || anchorRow.forkAnchorClientThreadId === null) {
|
|
142326
142377
|
continue;
|
|
142327
142378
|
}
|
|
142328
|
-
const section = resolveGroupSection(anchorRow);
|
|
142329
|
-
const sectionChildren = resolveGroupChildrenForSection(children, section);
|
|
142330
|
-
|
|
142379
|
+
const section = archiveLayout ? anchorRow.isPinned ? "pinned" : "recent" : resolveGroupSection(anchorRow);
|
|
142380
|
+
const sectionChildren = archiveLayout ? children.filter((row) => !row.isArchived) : resolveGroupChildrenForSection(children, section);
|
|
142381
|
+
const minimumGroupSize = archiveLayout && (anchorRow.isArchived || archiveLayout.hasArchivedThreads(anchorRow.executionInstanceId)) ? 0 : resolveMinimumGroupSize(anchorRow);
|
|
142382
|
+
if (sectionChildren.length < minimumGroupSize) {
|
|
142331
142383
|
continue;
|
|
142332
142384
|
}
|
|
142333
142385
|
const sortedChildren = sortGroupChildren(sectionChildren, anchorRow);
|
|
@@ -142340,8 +142392,8 @@ var init_forkThreadGroups = __esm({
|
|
|
142340
142392
|
devboxName: anchorRow.devboxName,
|
|
142341
142393
|
anchorRow,
|
|
142342
142394
|
children: sortedChildren,
|
|
142343
|
-
additionalThreadCount: sortedChildren.length - 1,
|
|
142344
|
-
updatedAtMs: Math.max(...sortedChildren.map((row) => row.updatedAtMs)),
|
|
142395
|
+
additionalThreadCount: Math.max(sortedChildren.length - 1, 0),
|
|
142396
|
+
updatedAtMs: sortedChildren.length > 0 ? Math.max(...sortedChildren.map((row) => row.updatedAtMs)) : anchorRow.updatedAtMs,
|
|
142345
142397
|
isPinned: anchorRow.isPinned,
|
|
142346
142398
|
pinOrder: anchorRow.pinOrder,
|
|
142347
142399
|
isArchived: section === "archived",
|
|
@@ -142358,11 +142410,13 @@ var init_forkThreadGroups = __esm({
|
|
|
142358
142410
|
allRows,
|
|
142359
142411
|
sectionRows,
|
|
142360
142412
|
section,
|
|
142361
|
-
resolveTitle
|
|
142413
|
+
resolveTitle,
|
|
142414
|
+
archiveLayout = null
|
|
142362
142415
|
}) => {
|
|
142363
142416
|
const groupsByPlacementId = buildForkThreadGroupMap({
|
|
142364
142417
|
rows: allRows,
|
|
142365
|
-
resolveTitle
|
|
142418
|
+
resolveTitle,
|
|
142419
|
+
archiveLayout
|
|
142366
142420
|
});
|
|
142367
142421
|
const emittedPlacementIds = /* @__PURE__ */ new Set();
|
|
142368
142422
|
const entries = [];
|
|
@@ -142419,6 +142473,14 @@ var init_threadArchiveEligibility = __esm({
|
|
|
142419
142473
|
}
|
|
142420
142474
|
});
|
|
142421
142475
|
|
|
142476
|
+
// ../../../../shared/threadRuntime/threadArchiveGroups.ts
|
|
142477
|
+
var init_threadArchiveGroups = __esm({
|
|
142478
|
+
"../../../../shared/threadRuntime/threadArchiveGroups.ts"() {
|
|
142479
|
+
"use strict";
|
|
142480
|
+
init_threadColdStorage();
|
|
142481
|
+
}
|
|
142482
|
+
});
|
|
142483
|
+
|
|
142422
142484
|
// ../../../../shared/threadRuntime/cliAgentViewContract.ts
|
|
142423
142485
|
var CLI_AGENT_VIEW_CONTRACT_VERSION, CLI_AGENT_VIEW_PROJECT_CONTRACT_VERSION, CLI_AGENT_VIEW_WINDOW_CONTRACT_VERSION, CLI_AGENT_VIEW_PEEK_CONTRACT_VERSION, CLI_AGENT_VIEW_PRESENCE_SHARD_SIZE, CLI_AGENT_VIEW_PROMPT_MAX_UTF8_BYTES, CLI_AGENT_VIEW_NO_SNAPSHOT_MESSAGE, adaptCliAgentViewProjectSummaryV2;
|
|
142424
142486
|
var init_cliAgentViewContract = __esm({
|
|
@@ -143755,6 +143817,7 @@ var init_threadInventory = __esm({
|
|
|
143755
143817
|
init_threadInventoryBuilder();
|
|
143756
143818
|
init_forkThreadGroups();
|
|
143757
143819
|
init_threadArchiveEligibility();
|
|
143820
|
+
init_threadArchiveGroups();
|
|
143758
143821
|
init_cliAgentViewContract();
|
|
143759
143822
|
init_cliAgentViewImages();
|
|
143760
143823
|
init_storageUploadTargets();
|
|
@@ -222039,7 +222102,7 @@ var init_creationPresentation = __esm({
|
|
|
222039
222102
|
"use strict";
|
|
222040
222103
|
init_threadInventory();
|
|
222041
222104
|
FAILURE_COPY = {
|
|
222042
|
-
machine_unavailable: "The selected
|
|
222105
|
+
machine_unavailable: "The selected box is unavailable. Review its status and try again.",
|
|
222043
222106
|
unsupported_machine: "This machine needs a boxes.dev service update before it can start threads.",
|
|
222044
222107
|
machine_creation_failed: "The devbox could not be created. Review its status and try again.",
|
|
222045
222108
|
billing_attention: "Billing activation is required before this devbox can be created.",
|
|
@@ -266264,6 +266327,19 @@ var init_seed = __esm({
|
|
|
266264
266327
|
push(
|
|
266265
266328
|
"# Copy uncommitted local changes (dirty worktree) to the Template box?"
|
|
266266
266329
|
);
|
|
266330
|
+
push("# TODO(agent): ask for one starting branch for Template setup and new");
|
|
266331
|
+
push(
|
|
266332
|
+
"# devboxes, recommending the remote default (guide: flow). Review local"
|
|
266333
|
+
);
|
|
266334
|
+
push(
|
|
266335
|
+
"# work with untracked files below (guide: untracked); included work will"
|
|
266336
|
+
);
|
|
266337
|
+
push("# be saved separately before setup. Record the choices in setupNotes,");
|
|
266338
|
+
push("# align lifecycle/maintenance branches, then remove this marker.");
|
|
266339
|
+
push(
|
|
266340
|
+
"# Keep the local checkout intact; branch preparation happens remotely."
|
|
266341
|
+
);
|
|
266342
|
+
push("# copyDirty does not choose a branch or exclude local-only commits.");
|
|
266267
266343
|
push(
|
|
266268
266344
|
`localChanges: # ${formatSizeNote(dirtyFileCount)} changed file(s) detected`
|
|
266269
266345
|
);
|
|
@@ -266421,7 +266497,9 @@ var init_seed = __esm({
|
|
|
266421
266497
|
push("");
|
|
266422
266498
|
push("# Template box maintenance, recommended for most projects. Design the");
|
|
266423
266499
|
push("# script and GitHub watch paths together: watch lockfiles and tooling");
|
|
266424
|
-
push(
|
|
266500
|
+
push(
|
|
266501
|
+
"# files, not application source. The script fast-forwards the selected"
|
|
266502
|
+
);
|
|
266425
266503
|
push(
|
|
266426
266504
|
"# branch, installs without prompts, and fails clearly on local changes"
|
|
266427
266505
|
);
|
|
@@ -266441,6 +266519,9 @@ var init_seed = __esm({
|
|
|
266441
266519
|
push(
|
|
266442
266520
|
"# on the Template box (install steps, gotchas, verification commands)."
|
|
266443
266521
|
);
|
|
266522
|
+
push(
|
|
266523
|
+
"# Include each starting branch and which local work to save separately."
|
|
266524
|
+
);
|
|
266444
266525
|
push("# Tracked project files stay unchanged unless exact edits are written");
|
|
266445
266526
|
push("# here and explicitly approved by the user during review.");
|
|
266446
266527
|
push("# TODO(agent): write brief setup guidance once investigation is done.");
|
|
@@ -301252,4 +301333,4 @@ react/cjs/react-jsx-runtime.development.js:
|
|
|
301252
301333
|
*)
|
|
301253
301334
|
*/
|
|
301254
301335
|
|
|
301255
|
-
//# debugId=
|
|
301336
|
+
//# debugId=56dec66e-dfc5-5fd7-ab6c-6ec0b589ff12
|
package/dist/bin/dvbd.mjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
|
-
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="
|
|
3
|
+
!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="421b351a-0bea-571c-97d8-cc0f726016b9")}catch(e){}}();
|
|
4
4
|
import { createRequire as __dvbCreateRequire } from "node:module";
|
|
5
5
|
import { dirname as __dvbDirname } from "node:path";
|
|
6
6
|
import { fileURLToPath as __dvbFileURLToPath } from "node:url";
|
|
@@ -64675,9 +64675,9 @@ var init_sentry = __esm({
|
|
|
64675
64675
|
uncaughtExceptionMonitorInstalled = false;
|
|
64676
64676
|
currentDevboxSentryUser = null;
|
|
64677
64677
|
readBuildMetadata = () => {
|
|
64678
|
-
const rawPackageVersion = "1.0.
|
|
64679
|
-
const rawGitSha = "
|
|
64680
|
-
const rawSentryRelease = "boxes-dev-dvb@1.0.
|
|
64678
|
+
const rawPackageVersion = "1.0.1099";
|
|
64679
|
+
const rawGitSha = "5f95fd277d454c1af877aac60a1e8b6cb84e7655";
|
|
64680
|
+
const rawSentryRelease = "boxes-dev-dvb@1.0.1099+5f95fd277d454c1af877aac60a1e8b6cb84e7655";
|
|
64681
64681
|
const packageVersion = typeof rawPackageVersion === "string" ? rawPackageVersion : void 0;
|
|
64682
64682
|
const gitSha = typeof rawGitSha === "string" ? rawGitSha : void 0;
|
|
64683
64683
|
const sentryRelease = typeof rawSentryRelease === "string" ? rawSentryRelease : void 0;
|
|
@@ -66773,12 +66773,13 @@ var init_desktopInitContracts = __esm({
|
|
|
66773
66773
|
});
|
|
66774
66774
|
|
|
66775
66775
|
// ../../../../shared/devboxCore/dist/desktopObjectTransfers.js
|
|
66776
|
-
var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
|
|
66776
|
+
var DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES, DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES, DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS, DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES, DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES, DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS, DESKTOP_OBJECT_TRANSFER_DOWNLOAD_URL_TTL_SECONDS;
|
|
66777
66777
|
var init_desktopObjectTransfers = __esm({
|
|
66778
66778
|
"../../../../shared/devboxCore/dist/desktopObjectTransfers.js"() {
|
|
66779
66779
|
"use strict";
|
|
66780
|
-
DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES =
|
|
66781
|
-
DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES =
|
|
66780
|
+
DESKTOP_OBJECT_TRANSFER_MAX_FILE_BYTES = 5 * 1024 * 1024 * 1024;
|
|
66781
|
+
DESKTOP_OBJECT_TRANSFER_MAX_BATCH_BYTES = 10 * 1024 * 1024 * 1024;
|
|
66782
|
+
DESKTOP_OBJECT_TRANSFER_IMPORT_TIMEOUT_MS = 5 * 60 * 1e3;
|
|
66782
66783
|
DESKTOP_OBJECT_TRANSFER_MULTIPART_THRESHOLD_BYTES = 100 * 1024 * 1024;
|
|
66783
66784
|
DESKTOP_OBJECT_TRANSFER_MULTIPART_PART_SIZE_BYTES = 64 * 1024 * 1024;
|
|
66784
66785
|
DESKTOP_OBJECT_TRANSFER_UPLOAD_URL_TTL_SECONDS = 15 * 60;
|
|
@@ -66894,7 +66895,7 @@ var init_packageVersion = __esm({
|
|
|
66894
66895
|
return path8.join(process.cwd(), "dvb");
|
|
66895
66896
|
};
|
|
66896
66897
|
readEmbeddedPackageVersion = () => {
|
|
66897
|
-
const raw = "1.0.
|
|
66898
|
+
const raw = "1.0.1099";
|
|
66898
66899
|
return trimVersion(raw);
|
|
66899
66900
|
};
|
|
66900
66901
|
readNearestPackageMetadata = (basePath) => {
|
|
@@ -80047,4 +80048,4 @@ smol-toml/dist/index.js:
|
|
|
80047
80048
|
*)
|
|
80048
80049
|
*/
|
|
80049
80050
|
|
|
80050
|
-
//# debugId=
|
|
80051
|
+
//# debugId=421b351a-0bea-571c-97d8-cc0f726016b9
|
|
@@ -50,8 +50,7 @@ returned `nextActions` when they apply.
|
|
|
50
50
|
|
|
51
51
|
Public data is intentionally compact. Project rows contain `name`,
|
|
52
52
|
`fingerprint`, `canonicalWorkdir`, an optional project `kind`, and an optional
|
|
53
|
-
setup warning with its recovery action. Older CLI releases safely omit
|
|
54
|
-
Template member projects. Template-box/devbox rows contain
|
|
53
|
+
setup warning with its recovery action. Older CLI releases safely omit managed projects. Template-box/devbox rows contain
|
|
55
54
|
`instanceId`, server-generated `name`, `kind`, coarse `status`,
|
|
56
55
|
`canonicalWorkdir`, and `lastActivityAt`. Thread rows contain
|
|
57
56
|
`clientThreadId`, `agent`, `executionInstanceId`, title, action-oriented
|
|
@@ -71,12 +70,12 @@ dvb projects lifecycle set --project <project-fingerprint> \
|
|
|
71
70
|
```
|
|
72
71
|
|
|
73
72
|
Script inputs come from local files. Startup and teardown timeouts accept
|
|
74
|
-
1–120 seconds, and clear flags remove either script. A
|
|
73
|
+
1–120 seconds, and clear flags remove either script. A managed
|
|
75
74
|
project supports these project-owned lifecycle defaults. After
|
|
76
75
|
`configuration_conflict`, read and reconcile the newer state; never overwrite
|
|
77
76
|
it with the stale revision.
|
|
78
77
|
|
|
79
|
-
For an
|
|
78
|
+
For an independent project with a personal Template box, configure the maintenance
|
|
80
79
|
script and complete GitHub watch set as one unit:
|
|
81
80
|
|
|
82
81
|
```bash
|
|
@@ -92,7 +91,7 @@ exact repository-relative file or directory paths, not globs. Omitted editable
|
|
|
92
91
|
watches are removals and need explicit confirmation; read-only watches remain
|
|
93
92
|
unchanged. The write preserves the current repeating schedule. New, changed,
|
|
94
93
|
or re-enabled watches receive a fresh default-branch baseline and do not start
|
|
95
|
-
a run.
|
|
94
|
+
a run. Managed projects return
|
|
96
95
|
`template_maintenance_unavailable` rather than changing their shared Team
|
|
97
96
|
Template.
|
|
98
97
|
|
|
@@ -141,7 +140,7 @@ same failed operation.
|
|
|
141
140
|
|
|
142
141
|
This workflow creates a devbox from the project's current reusable source
|
|
143
142
|
without creating a draft, conversation, or agent thread. That source is an
|
|
144
|
-
|
|
143
|
+
independent project's Template-box snapshot or a managed project's
|
|
145
144
|
current saved version. It is CLI/agent-only for now.
|
|
146
145
|
|
|
147
146
|
## Run One-Off Work
|
|
@@ -201,7 +200,7 @@ flow; it is different from `devboxes create`, which creates a devbox without
|
|
|
201
200
|
starting an agent thread. Starting the first thread on a devbox from
|
|
202
201
|
`devboxes create` will adopt that devbox: the thread becomes its anchor thread
|
|
203
202
|
and the devbox then appears and behaves like any other devbox in the desktop
|
|
204
|
-
and mobile apps. A
|
|
203
|
+
and mobile apps. A managed project accepts `new-devbox`
|
|
205
204
|
and exact existing devboxes but rejects `template` because it has no personal
|
|
206
205
|
Template box.
|
|
207
206
|
Use exactly one of `--prompt`, `--prompt-file`, or `--stdin`. Thread start
|
|
@@ -25,8 +25,8 @@ An automation has:
|
|
|
25
25
|
- run history.
|
|
26
26
|
|
|
27
27
|
By default, automation runs start new devboxes from the same reusable source as ordinary
|
|
28
|
-
threads. For an
|
|
29
|
-
a
|
|
28
|
+
threads. For an independent project, that is the latest Template-box snapshot. For
|
|
29
|
+
a managed project, it is the Team Template's current saved
|
|
30
30
|
version. Keep the source current when future automation runs need new
|
|
31
31
|
dependencies, generated files, or shared setup changes.
|
|
32
32
|
|
|
@@ -310,8 +310,8 @@ number of inactive days, or after a chosen number of newer eligible runs have
|
|
|
310
310
|
finished. Cleanup preserves the run thread directly in cold storage and
|
|
311
311
|
destroys its devbox; the automation run remains in run history and its archived
|
|
312
312
|
thread can still be opened without waking a machine. Restore the thread
|
|
313
|
-
explicitly if it needs to continue.
|
|
314
|
-
devbox or the Template box;
|
|
313
|
+
explicitly if it needs to continue. Independent projects can restore it to a new
|
|
314
|
+
devbox or the Template box; managed projects restore it only to a
|
|
315
315
|
new devbox.
|
|
316
316
|
|
|
317
317
|
If boxes.dev must wake a sleeping devbox only to inspect or archive it for
|